Bug 907468 - "ip addr show up" not documented
Summary: "ip addr show up" not documented
Keywords:
Status: CLOSED WONTFIX
Alias: None
Product: Fedora
Classification: Fedora
Component: iproute
Version: 18
Hardware: All
OS: Linux
unspecified
low
Target Milestone: ---
Assignee: Petr Šabata
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-02-04 13:46 UTC by Jiri Popelka
Modified: 2014-02-05 23:19 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2014-02-05 23:19:31 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)
Mention the 'up' argument in documentation (2.45 KB, patch)
2013-03-12 15:56 UTC, Petr Šabata
no flags Details | Diff

Description Jiri Popelka 2013-02-04 13:46:39 UTC
Description of problem:

I was trying to figure out what's the 'ip' equivalent to ifconfig, which by default (without '-a' switch) shows only active (UP) intefaces.
Because 'ip addr show' lists all (even those that are DOWN) interfaces I tried various other switches like:
ip addr show UP
ip addr show state UP
ip addr show label UP
ip addr show scope UP
non of them worked and neither 'ip addr show help' nor ip-address(8) helped.

After a lot of googling I found 'ip addr show up' which works like a charm.
Why is that not mentioned in help or man page ?

It's similar with 'ip link show up' which is fortunately described in ip-link(8) as:
ip link show - display device attributes
    up     only display running interfaces.

Version-Release number of selected component (if applicable):
iproute-3.6.0-5.fc18.x86_64

Steps to Reproduce:
1. ip addr show help
2. ip link show help
3. man ip-address
  
Actual results:
non of them mentions the 'up'

Expected results:
$ ip addr show help
       ip addr {show|save|flush} [ dev STRING ] [ scope SCOPE-ID ]
                            [ to PREFIX ] [ FLAG-LIST ] [ label PATTERN ] [up]

$ ip link show help
       ip link show [ DEVICE | group GROUP ] [up]

$ man ip-address
   ip address show - look at protocol addresses
       up     only display running interfaces.

Comment 1 Petr Šabata 2013-02-04 16:14:44 UTC
You're right, this would be nice.

Comment 2 Petr Šabata 2013-03-12 15:56:49 UTC
Created attachment 709048 [details]
Mention the 'up' argument in documentation

Submitted upstream.

Comment 3 Fedora Update System 2013-03-15 11:55:54 UTC
iproute-3.6.0-8.fc18 has been submitted as an update for Fedora 18.
https://admin.fedoraproject.org/updates/iproute-3.6.0-8.fc18

Comment 4 Fedora Update System 2013-03-25 22:57:15 UTC
iproute-3.6.0-8.fc18 has been pushed to the Fedora 18 stable repository.  If problems still persist, please make note of it in this bug report.

Comment 5 Fedora End Of Life 2013-12-21 15:44:26 UTC
This message is a reminder that Fedora 18 is nearing its end of life.
Approximately 4 (four) weeks from now Fedora will stop maintaining
and issuing updates for Fedora 18. It is Fedora's policy to close all
bug reports from releases that are no longer maintained. At that time
this bug will be closed as WONTFIX if it remains open with a Fedora 
'version' of '18'.

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, simply change the 'version' 
to a later Fedora version prior to Fedora 18's end of life.

Thank you for reporting this issue and we are sorry that we may not be 
able to fix it before Fedora 18 is end of life. If you would still like 
to see this bug fixed and are able to reproduce it against a later version 
of Fedora, you are encouraged  change the 'version' to a later Fedora 
version prior to Fedora 18's end of life.

Although we aim to fix as many bugs as possible during every release's 
lifetime, sometimes those efforts are overtaken by events. Often a 
more recent Fedora release includes newer upstream software that fixes 
bugs or makes them obsolete.

Comment 6 Fedora End Of Life 2014-02-05 23:19:31 UTC
Fedora 18 changed to end-of-life (EOL) status on 2014-01-14. Fedora 18 is
no longer maintained, which means that it will not receive any further
security or bug fix updates. As a result we are closing this bug.

If you can reproduce this bug against a currently maintained version of
Fedora please feel free to reopen this bug against that version. If you
are unable to reopen this bug, please file a new report against the
current release. If you experience problems, please add a comment to this
bug.

Thank you for reporting this bug and we are sorry it could not be fixed.


Note You need to log in before you can comment on or make changes to this bug.