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 696759 - upstart: [RFE] Improve "shutdown" manpage
Summary: upstart: [RFE] Improve "shutdown" manpage
Keywords:
Status: CLOSED NOTABUG
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: upstart
Version: 6.1
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: rc
: ---
Assignee: Petr Lautrbach
QA Contact: qe-baseos-daemons
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-04-14 19:30 UTC by J.H.M. Dassen (Ray)
Modified: 2018-11-14 14:08 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Enhancement
Doc Text:
Clone Of:
Environment:
Last Closed: 2011-07-08 09:05:48 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description J.H.M. Dassen (Ray) 2011-04-14 19:30:03 UTC
2. What is the nature and description of the request?

Request that the manpage of shutdown be changed to be less confusing.
Specifically, change details regarding "-H" and "-P" option. The man page says
that it sets the halt action to "halt" but it does not mention that it should
be called with "-h" option.

 3. Why does the customer need this? (List the business requirements here)

Client has two cases where users run 
shutdown -P now 
or 
shutdown -H now
to halt/poweroff the system. 
Is it possible to clarify on the man page that "-H" and "-P" should be called
with "-h" to actually shutdown

 4. How would the customer like to achieve this? (List the functional
requirements here)

Simple documentation (man page) change

 5. For each functional requirement listed in question 4, specify how Red Hat
and the customer can test to confirm the requirement is successfully
implemented.

N/A -- Documentation change

 6. Is there already an existing RFE upstream or in Red Hat bugzilla?

I did not see one.

 7. How quickly does this need resolved? (desired target release)

Minor release.

 8. Does this request meet the RHEL Inclusion criteria (please review)

Yes

 9. List the affected packages

upstart

10. Would the customer be able to assist in testing this functionality if
implemented?

Testing should not be required--this is a documentation change.

Comment 3 RHEL Program Management 2011-07-06 00:57:14 UTC
This request was evaluated by Red Hat Product Management for
inclusion in the current release of Red Hat Enterprise Linux.
Because the affected component is not scheduled to be updated
in the current release, Red Hat is unfortunately unable to
address this request at this time. Red Hat invites you to
ask your support representative to propose this request, if
appropriate and relevant, in the next release of Red Hat
Enterprise Linux. If you would like it considered as an
exception in the current release, please ask your support
representative.

Comment 5 Ivana Varekova 2011-07-07 07:52:19 UTC
Please, Petr do you have a patch against this issue? If yes can you put it here I can fix this issue using man-pages-overrides process in 6.2.

Comment 7 Petr Lautrbach 2011-07-07 09:13:08 UTC
Sorry for late response.

> The man page says that it sets the halt action to "halt" but it does 
> not mention that it should be called with "-h" option.

There is no need to use -h option with -H or -P, these options implies -h, 
see shutdown --help:

  -h                          halt or power off after shutdown
  -H                          halt after shutdown (implies -h)
  -P                          power off after shutdown (implies -h)

# rpm -q upstart
upstart-0.6.5-10.1.el6.x86_64

# shutdown -P now
...
Halting system...
Power down.

# shutdown -H now
...
Halting system...
System halted.


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