RHEL Engineering is moving the tracking of its product development work on RHEL 6 through RHEL 9 to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "RHEL project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs in the statuses "NEW", "ASSIGNED", and "POST" are being migrated throughout September 2023. Bugs of Red Hat partners with an assigned Engineering Partner Manager (EPM) are migrated in late September as per pre-agreed dates. Bugs against components "kernel", "kernel-rt", and "kpatch" are only migrated if still in "NEW" or "ASSIGNED". If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "RHEL project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/RHEL-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.
Bug 1020522 - Update sub-man man page for new list options
Summary: Update sub-man man page for new list options
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Linux 7
Classification: Red Hat
Component: subscription-manager
Version: 7.0
Hardware: Unspecified
OS: Unspecified
medium
unspecified
Target Milestone: rc
: 7.0
Assignee: Bryan Kearney
QA Contact: John Sefler
URL:
Whiteboard:
Depends On:
Blocks: rhsm-rhel70
TreeView+ depends on / blocked
 
Reported: 2013-10-17 20:03 UTC by Sharath Dwaral
Modified: 2015-03-23 01:14 UTC (History)
8 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2014-06-13 12:56:24 UTC
Target Upstream Version:
Embargoed:

Attachments (Terms of Use)

Description Sharath Dwaral 2013-10-17 20:03:24 UTC 
Description of problem:
Ypdate sub-man man page for new option --no-overlap and --match-installed which are used to filter subscriptions along with subscription-manager list --available

Version-Release number of selected component (if applicable):
# subscription-manager version
server type: Red Hat Subscription Management
subscription management server: 0.8.29-1
subscription-manager: 1.10.4-1.el7
python-rhsm: 1.10.3-1.el7


Need man page for subscription-manager to be updated for the below options.

# subscription-manager list --available --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-10-17)
  --consumed            show the subscriptions being consumed by this system
  --servicelevel=SERVICE_LEVEL
                        shows only subscriptions matching the specified
                        service level; only used with --available and
                        --consumed
  --no-overlap          shows pools which provide products that are not
  ^^^^^^^^^^^^^         already covered; only used with --available
  --match-installed     shows only subscriptions matching products that are
  ^^^^^^^^^^^^^^^^^^    currently installed; only used with --available


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


Additional Information:

The above highlighted options can 'only' be used in conjunction with subscription-manager list --available.
Comment 2 Bryan Kearney 2014-01-29 18:42:51 UTC 
https://github.com/candlepin/subscription-manager/pull/878
Comment 3 Bryan Kearney 2014-01-30 17:35:07 UTC 
commit 647eb03da043cdc7086f45224fb12be44aea1ae1
Author: Bryan Kearney <bkearney>
Date:   Wed Jan 29 13:36:27 2014 -0500

    1020522: Update the man page for subscription-manager with new list options
Comment 5 Rehana 2014-02-06 07:47:50 UTC 
Now these new list options --no-overlap,--match-installed are added to Man page

[root@hp-ml350egen8-01 ~]# man subscription-manager

<snip>

LIST OPTIONS
       The  list  command lists all of the subscriptions that are compatible with a system. The options allow the list to be filtered by subscriptions that are used by the system or unused subscriptions that are available to the system.

<snip>

  --no-overlap
              Shows pools which provide products that are notalready covered; only used with --available option.

  --match-installed
              Shows only subscriptions matching products that are currently installed; only used with --available option.


[root@hp-ml350egen8-01 ~]# 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: 2014-02-06)
  --consumed            show the subscriptions being consumed by this system
  --servicelevel=SERVICE_LEVEL
                        shows only subscriptions matching the specified
                        service level; only used with --available and
                        --consumed
  --no-overlap          shows pools which provide products that are not
                        already covered; only used with --available
  --match-installed     shows only subscriptions matching products that are
                        currently installed; only used with --available

Hence, moving the bug to Verified

verified on,

subscription-manager version 
server type: Red Hat Subscription Management
subscription management server: 0.9.2-1
subscription-manager: 1.10.13-1.el7
python-rhsm: 1.10.12-1.el7

man -P cat subscription-manager | tail -1
version 2.8  January 29, 2014  subscription-manager(8)
Comment 6 Ludek Smid 2014-06-13 12:56:24 UTC 
This request was resolved in Red Hat Enterprise Linux 7.0.

Contact your manager or support representative in case you have further questions about the request.
Note You need to log in before you can comment on or make changes to this bug.