Bug 959563 - man page for subscription-manager needs an update to add new list --status option
Summary: man page for subscription-manager needs an update to add new list --status op...
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 5
Classification: Red Hat
Component: subscription-manager
Version: 5.10
Hardware: Unspecified
OS: Unspecified
unspecified
medium
Target Milestone: rc
: ---
Assignee: Deon Ballard
QA Contact: IDM QE LIST
URL:
Whiteboard:
Depends On:
Blocks: rhsm-rhel510
TreeView+ depends on / blocked
 
Reported: 2013-05-03 19:20 UTC by John Sefler
Modified: 2013-09-30 23:07 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
No description necessary
Clone Of:
Environment:
Last Closed: 2013-09-30 23:07:41 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2013:1332 0 normal SHIPPED_LIVE subscription-manager bug fix and enhancement update 2013-09-30 22:49:24 UTC

Description John Sefler 2013-05-03 19:20:37 UTC
Description of problem:
There is a new "subscription-manager list --status" option that needs to be added to the man page documentation for subscription-manager.

Version-Release number of selected component (if applicable):
[root@jsefler-5 ~]# rpm -q subscription-manager
subscription-manager-1.8.6-1.git.27.f8647f0.el5
[root@jsefler-5 ~]# man -P cat subscription-manager | tail -1
version 2.5                     April 30, 2013         subscription-manager(8)


How reproducible:


Steps to Reproduce:
[root@jsefler-5 ~]# subscription-manager list --help
Usage: subscription-manager list [OPTIONS]

List subscription and product information for this system

options:
  -h, --help            show this help message and exit
  --proxy=PROXY_URL     proxy URL in the form of proxy_hostname:proxy_port
  --proxyuser=PROXY_USER
                        user for HTTP proxy with basic authentication
  --proxypassword=PROXY_PASSWORD
                        password for HTTP proxy with basic authentication
  --installed           list shows those products which are installed
                        (default)
  --available           show those subscriptions which are available
  --all                 used with --available to ensure all subscriptions are
                        returned
  --ondate=ON_DATE      date to search on, defaults to today's date, only used
                        with --available (example: 2013-05-03)
  --consumed            show the subscriptions being consumed by this system
  --status              show the current status of the system and reasons it
                        is not fully compliant.   <=========== NEW LIST STATUS OPTION
  --servicelevel=SERVICE_LEVEL
                        shows only subscriptions matching the specified
                        service level; only used with --available and
                        --consumed

[root@jsefler-5 ~]# subscription-manager list --status
+-------------------------------------------+
   System Status Details
+-------------------------------------------+
Overall Status: Invalid

Red Hat Enterprise Linux Server: Not covered by a valid subscription.

Comment 1 RHEL Program Management 2013-05-03 19:27:38 UTC
This request was evaluated by Red Hat Product Management for inclusion
in a Red Hat Enterprise Linux release.  Product Management has
requested further review of this request by Red Hat Engineering, for
potential inclusion in a Red Hat Enterprise Linux release for currently
deployed products.  This request is not yet committed for inclusion in
a release.

Comment 3 John Sefler 2013-05-22 14:39:44 UTC
Sorry Deon, apologizes on behalf of mreid and ckozak who changed this behavior...
[root@jsefler-5 ~]# rpm -q subscription-manager
subscription-manager-1.8.8-1.git.0.2ca28df.el5


The "subscription-manager list --status" functionality has been moved out of the list module and into it's own module:

[root@jsefler-5 ~]# subscription-manager status --help
Usage: subscription-manager status [OPTIONS]

Show status information for this system's subscriptions and products

options:
  -h, --help  show this help message and exit


The man page needs a re-update.

Comment 5 Bryan Kearney 2013-06-05 12:36:18 UTC
Moving all modified bugs to ON_QA

Comment 6 Sharath Dwaral 2013-06-05 14:14:53 UTC
Ver# rpm -qa | egrep "subscription-manager|python-rhsm"
subscription-manager-migration-data-1.11.3.1-1.git.1.78afd75.el5
subscription-manager-migration-1.8.10-1.git.1.b44c4b1.el5
python-rhsm-1.8.12-1.git.0.d747a65.el5
subscription-manager-firstboot-1.8.10-1.git.1.b44c4b1.el5
subscription-manager-1.8.10-1.git.1.b44c4b1.el5
subscription-manager-gui-1.8.10-1.git.1.b44c4b1.el5sion:


>> man page extract

STATUS OPTIONS
       The status command shows the current status of the products and attached subscriptions for the system. If some products are not fully covered or subscriptions have expired, then  the
       status command shows why subscriptions are not current.

       [root@server ~]# subscription-manager status
       +-------------------------------------------+
           Installed Product Status
       +-------------------------------------------+
       Product Name: Red Hat Enterprise Linux
       Product ID: 69
       Version: 7
       Arch: x86_64
       Status: Subscribed
       Status Details:
       Starts: 01/01/2012
       Ends: 01/01/2022

       +-------------------------------------------+
            System Status Details
       +-------------------------------------------+
       Overall Status: Subscribed

       This command has no options.

# man -P cat subscription-manager | tail -1
version 2.7                      May 23, 2013          subscription-manager(8)


VERIFIED

Comment 8 errata-xmlrpc 2013-09-30 23:07:41 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHBA-2013-1332.html


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