623266 – Metadata (man pages) generation does not take different sorts of action into account

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 623266 - Metadata (man pages) generation does not take different sorts of action into account

Summary: Metadata (man pages) generation does not take different sorts of action into ...

Keywords:
Status:	CLOSED ERRATA
Alias:	None
Product:	Red Hat Enterprise Linux 6
Classification:	Red Hat
Component:	fence-agents
Sub Component:
Version:	6.0
Hardware:	All
OS:	Linux
Priority:	low
Severity:	medium
Target Milestone:	rc
Target Release:	---
Assignee:	Marek Grac
QA Contact:	Cluster QE
Docs Contact:
URL:
Whiteboard:
Depends On:
Blocks:	671090
TreeView+	depends on / blocked

Reported:	2010-08-11 18:23 UTC by Jan Pokorný [poki]
Modified:	2016-04-26 15:06 UTC (History)
CC List:	5 users (show)
Fixed In Version:	fence-agents-3.0.12-12.el6
Doc Type:	Bug Fix
Doc Text:
Clone Of:
Clones:	671090 (view as bug list)
Environment:
Last Closed:	2011-05-19 14:21:29 UTC
Target Upstream Version:
Embargoed:

Attachments	(Terms of Use)

Links
System	ID	Private	Priority	Status	Summary	Last Updated
Red Hat Product Errata	RHBA-2011:0745	0	normal	SHIPPED_LIVE	fence-agents bug fix and enhancement update	2011-05-19 09:37:09 UTC

Description Jan Pokorný [poki] 2010-08-11 18:23:37 UTC

Description of problem:
Specifically, metadata function in fencing.py (agents/lib/fence.py.py) outputs a static block of actions without being aware of current fence.

Version-Release number of selected component (if applicable):
Tested both on current git version and updated RHEL 6.0 beta:
# rpm -q fence-agents
fence-agents-3.0.12-7.el6.x86_64

How reproducible:
Always.


Steps to Reproduce (this is only an example how to demonstrate it; there can be more similar cases):

1. # man fence_sanbox2
(...)
       -o, --action=<action>
              Fencing Action (Default Value: disable)
(...)
ACTIONS

       on     Power on machine.

       off    Power off machine.

       reboot Reboot machine.

       status This returns the status of the plug/virtual machine.

       list   List available plugs with aliases/virtual machines if there is support for more then one device. Returns N/A otherwise.

       monitor
              Check if fencing device is running. List available plugs/virtual machines or get status of machine (if it does not support more).

       metadata
               The operational behavior of this is not known.
(...)

2. # fence_sanbox2 -o on
Failed: Unrecognised action 'on'
Please use '-h' for usage


Actual results:
Bad information about possible actions provided by man page.

Expected results:
The information is correct.

Additional info:
Note that -h flag informs correctly:
(...)
   -o, --action=<action>          Action: status, enable or disable
(...)

Comment 2 RHEL Program Management 2010-08-11 18:58:40 UTC

This issue has been proposed when we are only considering blocker
issues in the current Red Hat Enterprise Linux release.

** If you would still like this issue considered for the current
release, ask your support representative to file as a blocker on
your behalf. Otherwise ask that it be considered for the next
Red Hat Enterprise Linux release. **

Comment 3 David Teigland 2010-08-12 19:32:08 UTC

We should standardize action values, I suggest on/off, and make all agents, docs, man pages, rng use and refer to on/off.

(Any agents that currently accept enable/disable need to continue accepting those values in addition to on/off.)

Comment 4 Marek Grac 2010-10-25 15:02:53 UTC

Fixed in upstream:

http://git.fedorahosted.org/git/?p=fence-agents.git;a=commit;h=c3491b707166d877037d0f65ce7117396398d6af

Comment 8 errata-xmlrpc 2011-05-19 14:21:29 UTC

An advisory has been issued which should help the problem
described in this bug report. This report is therefore being
closed with a resolution of ERRATA. For more information
on therefore solution and/or where to find the updated files,
please follow the link below. You may reopen this bug report
if the solution does not work for you.

http://rhn.redhat.com/errata/RHBA-2011-0745.html

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