[Linux-cluster] fence - convert manpages to the man macro package
Bastian Blank
bastian at waldi.eu.org
Sun Feb 13 21:56:30 UTC 2005
Hi folks
The current manpages are written in plain nroff which is not parsable by
many scripts.
The attached patch converts the manpages in the fence package to the man
macro package.
Bastian
--
Schshschshchsch.
-- The Gorn, "Arena", stardate 3046.2
-------------- next part --------------
=== man/fence.8
==================================================================
--- man/fence.8 (revision 317)
+++ man/fence.8 (local)
@@ -5,45 +5,66 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence(8)''fence(8)'
+.TH fence 8
-\fBNAME\fP
-.in +7
+.SH NAME
I/O Fencing reference guide
-.in
-\fBSYNOPSIS\fP
-.in +7
+.SH SYNOPSIS
Overview of related manual pages
-.sp
-.in
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
The I/O Fencing documentation has been split into a number of sections. Please
refer to the table below to determine which man page coincides with the
command/feature you are looking for.
-.sp
- fence I/O Fencing overview (this man page)
- fenced I/O Fencing daemon
-I/O Fencing agents
+.TP 10
+fence
+I/O Fencing overview (this man page)
+.TP
+fenced
+I/O Fencing daemon
- fence_apc for APC MasterSwitch and APC 79xx models
- fence_bladecenter for IBM Bladecenters w/ telnet interface
- fence_brocade for Brocade fibre channel switches (PortDisable)
- fence_egenera for Egenera blades
- fence_gnbd for GNBD-based GFS clusters
- fence_ilo for HP ILO interfaces (formerly fence_rib)
- fence_manual for manual intervention
- fence_mcdata for McData fibre channel switches
- fence_ack_manual for manual intervention
- fence_sanbox2 for Qlogic SAN Box fibre channel switches
- fence_vixel for Vixel switches (PortDisable)
- fence_wti for WTI Network Power Switch
- fence_node for use by lock_gulmd
+.SS I/O Fencing agents
-.sp
-.in
-\fBSEE ALSO\fP
-.in +7
+.TP 20
+fence_apc
+for APC MasterSwitch and APC 79xx models
+.TP
+fence_bladecenter
+for IBM Bladecenters w/ telnet interface
+.TP
+fence_brocade
+for Brocade fibre channel switches (PortDisable)
+.TP
+fence_egenera
+for Egenera blades
+.TP
+fence_gnbd
+for GNBD-based GFS clusters
+.TP
+fence_ilo
+for HP ILO interfaces (formerly fence_rib)
+.TP
+fence_manual
+for manual intervention
+.TP
+fence_mcdata
+for McData fibre channel switches
+.TP
+fence_ack_manual
+for manual intervention
+.TP
+fence_sanbox2
+for Qlogic SAN Box fibre channel switches
+.TP
+fence_vixel
+for Vixel switches (PortDisable)
+.TP
+fence_wti
+for WTI Network Power Switch
+.TP
+fence_node
+for use by lock_gulmd
+
+.SH SEE ALSO
gnbd(8), gfs(8)
=== man/fence_ack_manual.8
==================================================================
--- man/fence_ack_manual.8 (revision 317)
+++ man/fence_ack_manual.8 (local)
@@ -5,57 +5,39 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_ack_manual(8)''fence_ack_manual(8)'
+.TH fence_ack_manual 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_ack_manual - program run by an operator as a part of manual I/O Fencing
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_ack_manual -n\fP \fInodename\fP
+.SH SYNOPSIS
+.B
+fence_ack_manual
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_ack_manual is run by an operator on the same node that fence_manual(8)
was run after the operator has reset a node which required fencing. A message
in the system log indicates to the operator that they must reset a machine and
then run fence_ack_manual. Running fence_ack_manual allows the cluster to
continue with recovery of the fenced machine. The victim may be disconnected
from storage rather than resetting it.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-O\fP
-.in +7
Run without prompting for user confirmation.
-.sp
-.in
+.TP
\fB-n\fP \fInodename\fP
-.in +7
Name of node that has been reset or disconnected from storage.
-.sp
-.in
+.TP
\fB-s\fP \fIIPaddress\fP
-.in +7
IP address of the machine which has been reset or disconnected from storage. (Deprecated; use -n instead.)
-.sp
-.in
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.sp
-.in
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8)
=== man/fence_apc.8
==================================================================
--- man/fence_apc.8 (revision 317)
+++ man/fence_apc.8 (local)
@@ -5,132 +5,85 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_apc(8)''fence_apc(8)'
+.TH fence_apc 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_apc - I/O Fencing agent for APC MasterSwitch
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_apc -a\fP \fIIPaddress\fR \fB-l\fP \fIlogin\fR \fB-p\fP \fIpassword\fR \fB-n\fP \fIoutlet\fR
-[\fB-o\fP action] [\fB-T\fP] [\fB-v\fP]
+.SH SYNOPSIS
+.B
+Bfence_apc
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_apc is an I/O Fencing agent which can be used with the APC MasterSwitch
network power switch. It logs into a MasterSwitch via telnet and reboots
a specified outlet. Lengthy telnet connections to the MasterSwitch should
be avoided while a GFS cluster is running because the connection will
block any necessary fencing actions.
-.sp
+
fence_apc accepts options on the command line as well as from stdin.
Fenced sends parameters through stdin when it execs the agent. fence_apc
can be run by itself with command line options. This is useful for testing
and for turning outlets on or off from scripts.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-a\fP \fIIPaddress\fR
-.in +7
IP address or hostname of the switch.
-.sp
-.in
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-l\fP \fIlogin\fR
-.in +7
Login name.
-.sp
-.in
+.TP
\fB-n\fP \fI[<switch>:]outlet\fR
-.in +7
The outlet number to act upon.
-.sp
-.in
+.TP
\fB-o\fP \fIaction\fR
-.in +7
The action required. Reboot (default), Off or On.
-.in
-.sp
+.TP
\fB-p\fP \fIpassword\fR
-.in +7
Password for login.
-.sp
-.in
+.TP
\fB-T\fP
-.in +7
Test only. Answer NO to the confirmation prompt instead of YES.
-.in
-.sp
+.TP
\fB-v\fP
-.in +7
Verbose. Record telnet session in /tmp/apclog.
-.in
-.sp
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.in
-.sp
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
-\fI agent = < param >\fR
-.sp
+.SH STDIN PARAMETERS
+.TP
+\fIagent = < param >\fR
This option is used by fence_node(8) and is ignored by fence_apc.
-.sp
-
+.TP
\fIipaddr = < hostname | ip >\fR
-.sp
IP address or hostname of the switch.
-.sp
-
-\fI login = < param >\fR
-.sp
+.TP
+\fIlogin = < param >\fR
Login name.
-.sp
-
-\fI option = < param >\fR
-.sp
+.TP
+\fIoption = < param >\fR
The action required. Reboot (default), Off or On.
-.sp
-
-\fI passwd = < param >\fR
-.sp
+.TP
+\fIpasswd = < param >\fR
Password for login.
-.sp
-
-\fI port = < param >\fR
-.sp
+.TP
+\fIport = < param >\fR
The outlet number to act upon.
-.sp
-
-\fI switch = < param >\fR
-.sp
+.TP
+\fIswitch = < param >\fR
The switch to operate on. Defaults to "1" if not specified.
-.sp
-
-\fI test = < param >\fR
-.sp
+.TP
+\fItest = < param >\fR
Test only. Answer NO to the confirmation prompt instead of YES.
-.sp
-
-\fI verbose = < param >\fR
-.sp
+.TP
+\fIverbose = < param >\fR
Verbose. Record telnet session in /tmp/apclog.
-.sp
-
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8)
=== man/fence_baytech.8
==================================================================
--- man/fence_baytech.8 (revision 317)
+++ man/fence_baytech.8 (local)
@@ -5,21 +5,17 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_baytech(8)''fence_baytech(8)'
+.TH fence_baytech 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_baytech - I/O Fencing agent for Baytech RPC switches in combination with a Cyclades Terminal Server
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_baytech -a\fP \fIhost\fR \fB-l\fP \fIlogin\fR \fB-p\fP \fIpassword\fR \fB-n\fP \fIoutletname\fR \fB-o\fP \fIaction\fR
+.SH SYNOPSIS
+.B
+fence_baytech
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
This fencing agent is written for the Baytech RPC27-20nc in combination with
a Cyclades terminal server. The Cyclades TS exports the RPC's serial port
@@ -27,95 +23,61 @@
However, this script relys upon the assumption that Telnet is used. Future
features to this agent would allow the agent to work with a mulitude of
different communication protocols such as Telnet, SSH or Kermit.
-.sp
+
The other assumption that is made is that Outlet names do not end in space.
The name "Foo" and "Foo " are identical when the RPC prints them with
the status command.
-.sp
+
fence_baytech accepts options on the command line as well as from stdin.
fenced sends parameters through stdin when it execs the agent. fence_baytech
can be run by itself with command line options which is useful for testing.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-a\fP \fIhost\fP
-.in +7
IP address or hostname to connect to.
-.sp
-.in
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-l\fP \fIlogin\fP
-.in +7
Username name for the switch.
-.sp
-.in
+.TP
\fB-n\fP \fIport\fP
-.in +7
The name of the outlet to act upon.
-.in
-.sp
+.TP
\fB-o\fP \fIaction\fP
-.in +7
The action required. disable (default) or enable.
-.in
-.sp
+.TP
\fB-p\fP \fIpassword\fP
-.in +7
Password for login.
-.sp
-.in
+.TP
\fB-q\fP
-.in +7
Quiet mode: print only error messages.
-.sp
-.in
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.sp
-.in
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
+.SH STDIN PARAMETERS
-\fI agent = < param >\fR
-.sp
+.TP
+\fIagent = < param >\fR
This option is used by fence_node(8) and is ignored by fence_baytech.
-.sp
-
-\fI host = < hostname | ip >\fR
-.sp
+.TP
+\fIhost = < hostname | ip >\fR
IP address or hostname to connect to.
-.sp
-
-\fI login = < param >\fR
-.sp
+.TP
+\fIlogin = < param >\fR
Login name.
-.sp
-
-\fI action = < param >\fR
-.sp
+.TP
+\fIaction = < param >\fR
The action required. On, Off, Status or Reboot (default)
-.sp
-
-\fI passwd = < param >\fR
-.sp
+.TP
+\fIpasswd = < param >\fR
Password for login.
-.sp
-
-\fI outlet = < param >\fR
-.sp
+.TP
+\fIoutlet = < param >\fR
The name of the outlet to act upon.
-.sp
-
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8)
=== man/fence_bladecenter.8
==================================================================
--- man/fence_bladecenter.8 (revision 317)
+++ man/fence_bladecenter.8 (local)
@@ -5,115 +5,73 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_bladecenter(8)''fence_bladecenter(8)'
+.TH fence_bladecenter 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_brocade - I/O Fencing agent for IBM Bladecenter
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_bladecenter-a\fP \fIIPaddress\fR \fB-l\fP \fIlogin\fR \fB-p\fP \fIpassword\fR \fB-n\fP \fIblade\fR \fB-o\fP \fIaction\fR
+.SH SYNOPSIS
+.B
+fence_bladecenter
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_bladecenter is an I/O Fencing agent which can be used with IBM Bladecenters
with recent enough firmware that includes telnet support. It logs into a Brocade
chasis via telnet and uses the command line interface to power on and off blades.
fence_bladecenter accepts options on the command line or from stdin.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-a\fP \fIIPaddress\fP
-.in +7
IP address of the Bladecenter.
-.sp
-.in
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-l\fP \fIlogin\fP
-.in +7
Login name for the Bladecenter.
-.sp
-.in
+.TP
\fB-n\fP \fIblade\fP
-.in +7
The blade to operate on.
-.in
-.sp
+.TP
\fB-o\fP \fIaction\fP
-.in +7
The action required. Valid actions are on, off, reboot (default) and status.
-.in
-.sp
+.TP
\fB-p\fP \fIpassword\fP
-.in +7
Password for login.
-.sp
-.in
+.TP
\fB-q\fP
-.in +7
Quiet mode: print only error messages.
-.sp
-.in
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.sp
-.in
+.TP
\fB-v\fP \fIdebuglog\fP
-.in +7
Log the telnet session to \fIdebuglog\fP for debugging purposes.
-.sp
-.in
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
-
-\fI agent = < param >\fR
-.sp
-This option is used by fence_node(8) and is ignored by fence_brocade.
-.sp
-
+.SH STDIN PARAMETERS
+.TP
+\fIagent = < param >\fR
+This option is used by fence_node(8) and is ignored by fence_bladecenter.
+.TP
\fIipaddr = < hostname | ip >\fR
-.sp
IP address or hostname of the switch.
-.sp
-
-\fI login = < param >\fR
-.sp
+.TP
+\fIlogin = < param >\fR
Login name.
-.sp
-
-\fI option = < param >\fR
-.sp
+.TP
+\fIoption = < param >\fR
The action required. disable (default) or enable.
-.sp
-
-\fI passwd = < param >\fR
-.sp
+.TP
+\fIpasswd = < param >\fR
Password for login.
-.sp
-
-\fI blade = < param >\fR
-.sp
+.TP
+\fIblade = < param >\fR
The blade to operate on.
-.sp
-
-\fI debuglog = < param>\fR
-.sp
+.TP
+\fIdebuglog = < param>\fR
Optional parameter to send debug transcript of the telnet session to a log file
-.sp
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8)
=== man/fence_brocade.8
==================================================================
--- man/fence_brocade.8 (revision 317)
+++ man/fence_brocade.8 (local)
@@ -5,118 +5,79 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_brocade(8)''fence_brocade(8)'
+.TH fence_brocade 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_brocade - I/O Fencing agent for Brocade FC switches
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_brocade -a\fP \fIIPaddress\fR \fB-l\fP \fIlogin\fR \fB-p\fP \fIpassword\fR \fB-n\fP \fIport\fR \fB-o\fP \fIaction\fR
+.SH SYNOPSIS
+.B
+fence_brocade
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_brocade is an I/O Fencing agent which can be used with Brocade FC
switches. It logs into a Brocade switch via telnet and disables a specified
port. Disabling the port which a machine is connected to effectively fences
that machine. Lengthy telnet connections to the switch should be avoided
while a GFS cluster is running because the connection will block any necessary
fencing actions.
-.sp
+
fence_brocade accepts options on the command line as well as from stdin.
fenced sends parameters through stdin when it execs the agent. fence_brocade
can be run by itself with command line options which is useful for testing.
-.sp
+
After a fence operation has taken place the fenced machine can no longer connect
to the Brocade FC switch. When the fenced machine is ready to be brought back
into the GFS cluster (after reboot) the port on the Brocade FC switch needs to
be enabled. This can be done by running fence_brocade and specifying the
enable action.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-a\fP \fIIPaddress\fP
-.in +7
IP address of the switch.
-.sp
-.in
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-l\fP \fIlogin\fP
-.in +7
Login name for the switch.
-.sp
-.in
+.TP
\fB-n\fP \fIport\fP
-.in +7
The port number to disable on the switch.
-.in
-.sp
+.TP
\fB-o\fP \fIaction\fP
-.in +7
The action required. disable (default) or enable.
-.in
-.sp
+.TP
\fB-p\fP \fIpassword\fP
-.in +7
Password for login.
-.sp
-.in
+.TP
\fB-q\fP
-.in +7
Quiet mode: print only error messages.
-.sp
-.in
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.sp
-.in
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
-
-\fI agent = < param >\fR
-.sp
+.SH STDIN PARAMETERS
+.TP
+\fIagent = < param >\fR
This option is used by fence_node(8) and is ignored by fence_brocade.
-.sp
-
+.TP
\fIipaddr = < hostname | ip >\fR
-.sp
IP address or hostname of the switch.
-.sp
-
-\fI login = < param >\fR
-.sp
+.TP
+\fIlogin = < param >\fR
Login name.
-.sp
-
-\fI option = < param >\fR
-.sp
+.TP
+\fIoption = < param >\fR
The action required. disable (default) or enable.
-.sp
-
-\fI passwd = < param >\fR
-.sp
+.TP
+\fIpasswd = < param >\fR
Password for login.
-.sp
-
-\fI port = < param >\fR
-.sp
+.TP
+\fIport = < param >\fR
The port number to disable on the switch.
-.sp
-
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8)
=== man/fence_cpint.8
==================================================================
--- man/fence_cpint.8 (revision 317)
+++ man/fence_cpint.8 (local)
@@ -5,21 +5,17 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_cpint(8)''fence_cpint(8)'
+.TH fence_cpint 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_cpint - I/O Fencing agent for GFS on s390 and zSeries VM clusters
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_cpint -u\fP \fIuserid\fP
+.SH SYNOPSIS
+.B
+fence_cpint
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_cpint is an I/O Fencing agent used on a virtual machine running GFS in a
s390 or zSeries VM cluster.
It uses the cpint package to send a CP LOGOFF command to the specified virtual
@@ -31,55 +27,33 @@
the secondary user of the virtual machine to be fenced. This means that unless
all of you gulm server nodes are privilege class C, fence_cpint can only be
used with SLM.
-.sp
fence_cpint accepts options on the command line as well as from stdin.
fence_node sends the options through stdin when it execs the agent.
fence_cpint can be run by itself with command line options which is useful for
testing.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+.SH OPTIONS
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-
-.in
+.TP
\fB-u\fP \fIuserid\fP
-.in +7
userid of the virtual machine to fence (required).
-.sp
-
-.in
+.TP
\fB-q\fP
-.in +7
quiet mode, no output.
-.sp
-
-.in
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.sp
-.in
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
+.SH STDIN PARAMETERS
+.TP
\fIagent = < param >\fR
-.sp
This option is used by fence_node(8) and is ignored by fence_cpint.
-.sp
-
+.TP
\fIuserid = < parm >\fP
-.sp
userid of the virtual machine to fence (required).
-.sp
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8)
=== man/fence_egenera.8
==================================================================
--- man/fence_egenera.8 (revision 317)
+++ man/fence_egenera.8 (local)
@@ -5,22 +5,17 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_egenera(8)''fence_egenera(8)'
+.TH fence_egenera 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_egenera - I/O Fencing agent for the Egenera BladeFrame
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_egenera -c\fP \fIcserver\fR \fB-l\fP \fIlpan\fR \fB-p\fP \fIpserver\fR [\fB-o\fP action]
-[\fB-q\fP]
+.SH SYNOPSIS
+.B
+fence_egenera
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_egenera is an I/O Fencing agent which can be used with the Egenera
BladeFrame. It logs into a control blade (cserver) via ssh and operates
on a processing blade (pserver) identified by the pserver name and the
@@ -28,87 +23,55 @@
that ssh keys have been setup so that the fence_egenera does not require
a password to authenticate. Refer to ssh(8) for more information on setting
up ssh keys.
-.sp
+
fence_egenera accepts options on the command line as well as from stdin.
Fenced sends parameters through stdin when it execs the agent. fence_egenera
can also be run by itself with command line options.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-c\fP \fIcserver\fR
-.in +7
The cserver to ssh to. cserver can be in the form user at hostname to
specify a different user to login as.
-.sp
-.in
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-l\fP \fIlpan\fR
-.in +7
the lpan to operate on
-.sp
-.in
+.TP
\fB-o\fP \fIaction\fR
-.in +7
The action required. reboot (default), off, on or status.
-.in
-.sp
+.TP
\fB-p\fP \fIpserver\fR
-.in +7
the pserver to operate on
-.sp
-.in
+.TP
\fB-q\fP
-.in +7
quite mode. supress output.
-.sp
-.in
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.in
-.sp
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
-\fI action = < param >\fR
-.sp
+.SH STDIN PARAMETERS
+.TP
+\fIaction = < param >\fR
The action required. reboot (default), off, on or status.
-.sp
-
-\fI agent = < param >\fR
-.sp
+.TP
+\fIagent = < param >\fR
This option is used by fence_node(8) and is ignored by fence_apc.
-.sp
-
-\fI cserver = < param >\fR
-.sp
+.TP
+\fIcserver = < param >\fR
The cserver to ssh to. cserver can be in the form user at hostname to
specify a different user to login as.
-.sp
-
-\fI lpan = < param >\fR
-.sp
+.TP
+\fIlpan = < param >\fR
The lpan to operate on
-.sp
-
-\fI pserver = < param >\fR
-.sp
+.TP
+\fIpserver = < param >\fR
The pserver to operate on
-.sp
+.TP
+\fIesh = < param >\fR
+The path to the esh command on the cserver (default is /opt/panmgr/bin/esh)
-\fI esh = < param >\fR
-.sp
-The path to the esh command on the cserver (default is /opt/panmgr/bin/esh )
-.sp
-
-
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8), ssh(8)
=== man/fence_ibmblade.8
==================================================================
--- man/fence_ibmblade.8 (revision 317)
+++ man/fence_ibmblade.8 (local)
@@ -5,99 +5,64 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_ibmblade(8)''fence_ibmblade(8)'
+.TH fence_ibmblade 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_ibmblade - I/O Fencing agent for IBM BladeCenter
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_ibmblade -a\fP \fIIPaddress\fR \fB-c\fP \fIcommunity\fR \fB-n\fP \fIport\fR \fB-o\fP \fIaction\fR
+.SH SYNOPSIS
+.B
+fence_ibmblade
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_ibmblade is an I/O Fencing agent which can be used with IBM BladeCenter
chassis. It issues SNMP Set request to BladeCenter chassins, rebooting, powering
up or down the specified Blade Server.
-.sp
+
fence_ibmblade accepts options on the command line as well as from stdin.
fenced sends parameters through stdin when it execs the agent. fence_ibmblade
can be run by itself with command line options which is useful for testing.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-a\fP \fIIPaddress\fP
-.in +7
IP address of the BladeCenter chassis.
-.sp
-.in
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-c\fP \fIcommunity\fP
-.in +7
SNMP community string to use.
-.sp
-.in
+.TP
\fB-n\fP \fIport\fP
-.in +7
The Blade port number to disable.
-.in
-.sp
+.TP
\fB-o\fP \fIaction\fP
-.in +7
The action required. Reboot (default), On or off.
-.in
-.sp
+.TP
\fB-q\fP
-.in +7
Quiet mode: print only error messages.
-.sp
-.in
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.sp
-.in
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
-
-\fI agent = < param >\fR
-.sp
+.SH STDIN PARAMETERS
+.TP
+\fIagent = < param >\fR
This option is used by fence_node(8) and is ignored by fence_ibmblade.
-.sp
-
+.TP
\fIipaddr = < hostname | ip >\fR
-.sp
IP address or hostname of the switch.
-.sp
-
-\fI community = < param >\fR
-.sp
+.TP
+\fIcommunity = < param >\fR
SNMP community.
-.sp
-
-\fI option = < param >\fR
-.sp
+.TP
+\fIoption = < param >\fR
The action required. reboot (default), on or off.
-.sp
-
-\fI port = < param >\fR
-.sp
+.TP
+\fIport = < param >\fR
The Blade port number to disable.
-.sp
-
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8)
=== man/fence_ilo.8
==================================================================
--- man/fence_ilo.8 (revision 317)
+++ man/fence_ilo.8 (local)
@@ -5,110 +5,72 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_ilo(8)''fence_ilo(8)'
+.TH fence_ilo 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_ilo - I/O Fencing agent for HP Integrated Lights Out card
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_ilo -a\fP \fIIPaddress[:SSLport]\fR \fB-l\fP \fIlogin\fR \fB-p\fP \fIpassword\fR
-[\fB-o\fP action] [\fB-vqVh\fP]
+.SH SYNOPSIS
+.B
+fence_ilo
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_ilo is an I/O Fencing agent used for HP servers with the Integrated Light
Out (iLO) PCI card. The agent opens an SSL connection to the iLO card. Once the
SSL connection is established, the agent is able to communicate with the iLO
card through an XML stream.
-.sp
+
fence_ilo depends on the Net::SSLeay or Net::SSL perl module in order to establish
the SSL connection to the iLO card. Net::SSL is available in the perl-Crypt-SSLeay package
on RHN (http://rhn.redhat.com). Net::SSLeay is available at http://www.cpan.org.
-.sp
+
NOTE: fence_ilo deprecates fence_rib.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-a\fP \fIIPaddress[:port]\fR
-.in +7
IP address or hostname of the iLO card. If the SSL server of the card is
not running on the default SSL port, 443, then [:port] will also need to be
specified.
-.sp
-.in
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-l\fP \fIlogin\fR
-.in +7
Login name.
-.sp
-.in
+.TP
\fB-o\fP \fIaction\fR
-.in +7
The action required. reboot (default), off, on or status.
-.in
-.sp
+.TP
\fB-p\fP \fIpassword\fR
-.in +7
Password for login.
-.sp
-.in
+.TP
\fB-v\fP
-.in +7
Verbose.
-.in
-.sp
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.in
-.sp
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
-
+.SH STDIN PARAMETERS
+.TP
\fIaction = < param >\fR
-.sp
The action required. reboot (default), off, on or status.
-.sp
-
+.TP
\fIagent = < param >\fR
-.sp
This option is used by fence_node(8) and is ignored by fence_ilo.
-.sp
-
+.TP
\fIhostname = < hostname | ip >\fR
-.sp
IP address or hostname of the iLO card.
-.sp
-
+.TP
\fIlogin = < param >\fR
-.sp
Login name.
-.sp
-
+.TP
\fIpasswd = < param >\fR
-.sp
Password for login.
-.sp
-
+.TP
\fIverbose = < param >\fR
-.sp
Verbose mode.
-.sp
-
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8), fence_rib(8)
=== man/fence_manual.8
==================================================================
--- man/fence_manual.8 (revision 317)
+++ man/fence_manual.8 (local)
@@ -5,76 +5,52 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_manual(8)''fence_manual(8)'
+.TH fence_manual 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_manual - program run by fenced as a part of manual I/O Fencing
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_manual -n\fP \fInodename\fP
+.SH SYNOPSIS
+.B
+fence_manual
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_manual is run by fenced. It creates a fifo and waits for
its counter-part fence_ack_manual(8) to acknowledge that a failed node
has been reset. fence_ack_manual(8) should only be run after the operator
has reset the faulty node. While waiting for the manual acknowledgement,
fence_manual also watches for the faulty node to rejoin the cluster;
if it does, it's taken as an acknowledgement and completes.
-.sp
+
Note: fence_manual is provided for use during testing and evaluation
only. Sites should not use fence_manual as the primary fencing method
on a production cluster.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-q\fP
-.in +7
quiet mode, no output.
-.sp
-.in
+.TP
\fB-n\fP \fInodename\fP
-.in +7
The node name (usually hostname) of the machine that needs to be reset or disconnected from shared storage.
-.in
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.sp
-.in
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
-
-\fI agent = < param >\fR
-.sp
+.SH STDIN PARAMETERS
+.TP
+\fIagent = < param >\fR
This option is used by fence_node(8) and is ignored by fence_manual.
-.sp
-
-\fI nodename = < param >\fR
-.sp
+.TP
+\fInodename = < param >\fR
The node name (usually hostname) of the machine that needs to be reset or disconnected from storage.
-.sp
-
-\fI ipaddr = < param >\fR
-.sp
+.TP
+\fIipaddr = < param >\fR
IP address or hostname of the machine that needs to be reset or disconnected from storage. (Deprecated; use nodename instead.)
-.in -7
-
-
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8), fence_ack_manual(8)
=== man/fence_mcdata.8
==================================================================
--- man/fence_mcdata.8 (revision 317)
+++ man/fence_mcdata.8 (local)
@@ -5,118 +5,79 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_mcdata(8)''fence_mcdata(8)'
+.TH fence_mcdata 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_mcdata - I/O Fencing agent for McData FC switches
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_mcdata -a\fP \fIIPaddress\fR \fB-l\fP \fIlogin\fR \fB-p\fP \fIpassword\fR \fB-n\fP \fIport\fR \fB-o\fP \fIaction\fR
+.SH SYNOPSIS
+.B
+fence_mcdata
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_mcdata is an I/O Fencing agent which can be used with McData FC
switches. It logs into a McData switch via telnet and disables a specified
port. Disabling the port which a machine is connected to effectively fences
that machine. Lengthy telnet connections to the switch should be avoided
while a GFS cluster is running because the connection will block any necessary
fencing actions.
-.sp
+
fence_mcdata accepts options on the command line as well as from stdin.
fenced sends parameters through stdin when it execs the agent. fence_mcdata
can be run by itself with command line options which is useful for testing.
-.sp
+
After a fence operation has taken place the fenced machine can no longer connect
to the McData FC switch. When the fenced machine is ready to be brought back
into the GFS cluster (after reboot) the port on the McData FC switch needs to
be enabled. This can be done by running fence_mcdata and specifying the
enable action.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-a\fP \fIIPaddress\fP
-.in +7
IP address of the switch.
-.sp
-.in
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-l\fP \fIlogin\fP
-.in +7
Username name for the switch.
-.sp
-.in
+.TP
\fB-n\fP \fIport\fP
-.in +7
The port number to disable on the switch.
-.in
-.sp
+.TP
\fB-o\fP \fIaction\fP
-.in +7
The action required. disable (default) or enable.
-.in
-.sp
+.TP
\fB-p\fP \fIpassword\fP
-.in +7
Password for login.
-.sp
-.in
+.TP
\fB-q\fP
-.in +7
Quiet mode: print only error messages.
-.sp
-.in
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.sp
-.in
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
-
-\fI agent = < param >\fR
-.sp
+.SH STDIN PARAMETERS
+.TP
+\fIagent = < param >\fR
This option is used by fence_node(8) and is ignored by fence_mcdata.
-.sp
-
+.TP
\fIipaddr = < hostname | ip >\fR
-.sp
IP address or hostname of the switch.
-.sp
-
-\fI login = < param >\fR
-.sp
+.TP
+\fIlogin = < param >\fR
Login name.
-.sp
-
-\fI option = < param >\fR
-.sp
+.TP
+\fIoption = < param >\fR
The action required. disable (default) or enable.
-.sp
-
-\fI passwd = < param >\fR
-.sp
+.TP
+\fIpasswd = < param >\fR
Password for login.
-.sp
-
-\fI port = < param >\fR
-.sp
+.TP
+\fIport = < param >\fR
The port number to disable on the switch.
-.sp
-
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8)
=== man/fence_node.8
==================================================================
--- man/fence_node.8 (revision 317)
+++ man/fence_node.8 (local)
@@ -4,50 +4,35 @@
.\" This copyrighted material is made available to anyone wishing to use,
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_node(8)''fence_node(8)'
-'\" View with 'groff -t -e -mandoc -Tlatin1 fence_node.8 | less'
-\fBNAME\fP
-.in +7
+.TH fence_node 8
+
+.SH NAME
fence_node - A program which performs I/O fencing on a single node.
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_node\fP [\fBoptions\fP] <\fBnode\fP>
-.sp
-.in
-\fBDESCRIPTION\fP
-.in +7
+.SH SYNOPSIS
+.B
+fence_node
+[\fIOPTION\fR]...
+
+.SH DESCRIPTION
\fBfence_node\fP is a program which accumulates all the necessary information
for I/O fencing a particular node and then performs the fencing action by
issuing a call to the proper fencing agent. \fBfence_node\fP gets the
necessary information from the Cluster Configuration System (CCS). CCS must
be running and properly configured for \fBfence_node\fP to work properly.
-.in
-\fBOPTIONS\fP
-.in +7
+.SH OPTIONS
+.TP
\fB-h\fP
-.in +7
Help. Print out the usage syntax.
-.sp
-.in
-
+.TP
\fB-V\fP
-.in +7
Print version information.
-.sp
-.in -7
-.in -7
-\fBEXAMPLES\fP
-.in +7
+
+.SH EXAMPLES
To fence a node called ``bellerophon'':
-.in +7
prompt> fence_node bellerophon
-.in -7
-.sp
-.in -7
-\fBSEE ALSO\fP
-.in +7
+
+.SH SEE ALSO
fence(8), ccs(7)
=== man/fence_rackswitch.8
==================================================================
--- man/fence_rackswitch.8 (revision 317)
+++ man/fence_rackswitch.8 (local)
@@ -5,102 +5,65 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_rackswitch(8)''fence_rackswitch(8)'
+.TH fence_rackswitch 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_rackswitch - I/O Fencing agent for RackSaver RackSwitch
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_rackswitch -a\fP \fIIPaddress\fR \fB-p\fP \fIpassword\fR \fB-l\fP \fIusername\fR \fB-n\fP \fIplug\fR
+.SH SYNOPSIS
+.B
+fence_rackswitch
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_rackswitch is an I/O Fencing agent which can be used with the RackSaver
RackSwitch. It logs into the RackSwitch and boots a specified plug.
Using the http interface to the RackSwitch should be avoided while a GFS cluster is
running because the connection may interfere with the operation of this agent.
-.sp
+
fence_rackswitch accepts options on the command line as well as from stdin.
fenced sends the options through stdin when it execs the agent. fence_rackswitch
can be run by itself with command line options which is useful for testing.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-a\fP \fIIPaddress\fP
-.in +7
IP address of the switch.
-.sp
-.in
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.in
-.sp
+.TP
\fB-n\fP \fIplug\fP
-.in +7
The plug number to power cycle.
-.in
-.sp
+.TP
\fB-p\fP \fIpassword\fP
-.in +7
Password for login.
-.sp
-.in
-.sp
+.TP
\fB-l\fP \fIusername\fP
-.in +7
Username for login.
-.in
-.sp
+.TP
\fB-q\fP
-.in +7
Quiet operation. Only print out error messages.
-.in
-.sp
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.in
-.sp
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
-
-\fI agent = < param >\fR
-.sp
+.SH STDIN PARAMETERS
+.TP
+\fIagent = < param >\fR
This option is used by fence_node(8) and is ignored by fence_rackswitch.
-.sp
-
+.TP
\fIipaddr = < ip >\fR
-.sp
IP address of the switch.
-.sp
-
-\fI username = < param >\fR
-.sp
+.TP
+\fIusername = < param >\fR
Username for login.
-.sp
-
-\fI password = < param >\fR
-.sp
+.TP
+\fIpassword = < param >\fR
Password for login.
-.sp
-
-\fI port = < param >\fR
-.sp
+.TP
+\fIport = < param >\fR
The port (outlet) number to act upon.
-.sp
-.in
-.sp
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8)
=== man/fence_rib.8
==================================================================
--- man/fence_rib.8 (revision 317)
+++ man/fence_rib.8 (local)
@@ -5,21 +5,13 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_rib(8)''fence_rib(8)'
+.TH fence_rib 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_rib - I/O Fencing agent for Compaq Remote Insight Lights Out card
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
-.sp
+.SH DESCRIPTION
fence_rib is deprecated. fence_ilo should be used instead
-.sp
-.in
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence_ilo(8)
=== man/fence_sanbox2.8
==================================================================
--- man/fence_sanbox2.8 (revision 317)
+++ man/fence_sanbox2.8 (local)
@@ -5,118 +5,79 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_sanbox2(8)''fence_sanbox2(8)'
+.TH fence_sanbox2 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_sanbox2 - I/O Fencing agent for QLogic SANBox2 FC switches
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_sanbox2 -a\fP \fIIPaddress\fR \fB-l\fP \fIlogin\fR \fB-p\fP \fIpassword\fR \fB-n\fP \fIport\fR \fB-o\fP \fIaction\fR
+.SH SYNOPSIS
+.B
+fence_sanbox2
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_sanbox2 is an I/O Fencing agent which can be used with QLogic SANBox2 FC
switches. It logs into a SANBox2 switch via telnet and disables a specified
port. Disabling the port which a machine is connected to effectively fences
that machine. Lengthy telnet connections to the switch should be avoided
while a GFS cluster is running because the connection will block any necessary
fencing actions.
-.sp
+
fence_sanbox2 accepts options on the command line as well as from stdin.
fenced sends parameters through stdin when it execs the agent. fence_sanbox2
can be run by itself with command line options which is useful for testing.
-.sp
+
After a fence operation has taken place the fenced machine can no longer connect
to the switch. When the fenced machine is ready to be brought back
into the GFS cluster (after reboot) the port on the FC switch needs to
be enabled. This can be done by running fence_sanbox2 and specifying the
enable action.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-a\fP \fIIPaddress\fP
-.in +7
IP address of the switch.
-.sp
-.in
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-l\fP \fIlogin\fP
-.in +7
Login name for the switch.
-.sp
-.in
+.TP
\fB-n\fP \fIport\fP
-.in +7
The port number to disable on the switch.
-.in
-.sp
+.TP
\fB-o\fP \fIaction\fP
-.in +7
The action required. disable (default) or enable.
-.in
-.sp
+.TP
\fB-p\fP \fIpassword\fP
-.in +7
Password for login.
-.sp
-.in
+.TP
\fB-q\fP
-.in +7
Quiet mode: print only error messages.
-.sp
-.in
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.sp
-.in
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
-
-\fI agent = < param >\fR
-.sp
+.SH STDIN PARAMETERS
+.TP
+\fIagent = < param >\fR
This option is used by fence_node(8) and is ignored by fence_sanbox2.
-.sp
-
+.TP
\fIipaddr = < hostname | ip >\fR
-.sp
IP address or hostname of the switch.
-.sp
-
-\fI login = < param >\fR
-.sp
+.TP
+\fIlogin = < param >\fR
Login name.
-.sp
-
-\fI option = < param >\fR
-.sp
+.TP
+\fIoption = < param >\fR
The action required. disable (default) or enable.
-.sp
-
-\fI passwd = < param >\fR
-.sp
+.TP
+\fIpasswd = < param >\fR
Password for login.
-.sp
-
-\fI port = < param >\fR
-.sp
+.TP
+\fIport = < param >\fR
The port number to disable on the switch.
-.sp
-
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8)
=== man/fence_tool.8
==================================================================
--- man/fence_tool.8 (revision 317)
+++ man/fence_tool.8 (local)
@@ -4,21 +4,19 @@
.\" This copyrighted material is made available to anyone wishing to use,
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_tool(8)''fence_tool(8)'
-'\" View with 'groff -t -e -mandoc -Tlatin1 fence_tool.8 | less'
-\fBNAME\fP
-.in +7
+.TH fence_tool 8
+
+.SH NAME
fence_tool - A program to join and leave the fence domain
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_tool\fP <\fBjoin | leave\fP> [\fBoptions\fP]
-.sp
-.in
-\fBDESCRIPTION\fP
-.in +7
+.SH SYNOPSIS
+.B
+fence_tool
+<\fBjoin | leave\fP>
+[\fIOPTION\fR]...
+
+.SH DESCRIPTION
\fBfence_tool\fP is a program used to join or leave the default fence
domain. Specifically, it starts the fence daemon (fenced) to join the
domain and kills fenced to leave the domain. Fenced can be started
@@ -42,54 +40,29 @@
A node must not leave the fence domain (fenced must not be terminated)
while CLVM or GFS are in use.
-.in
-\fBOPTIONS\fP
-
-.in +7
-
+.SH OPTIONS
+.TP
\fB-h\fP
-.in +7
Help. Print out the usage syntax.
-.sp
-.in
-
+.TP
\fB-V\fP
-.in +7
Print version information.
-.sp
-.in
-
+.TP
\fB-S\fP
-.in +7
Skip self unfencing before joining.
-.sp
-.in
-
+.TP
\fB-D\fP
-.in +7
Enable debugging output and don't fork (also passed to fenced)
-.sp
-.in
-
+.TP
\fB-j\fP \fIsecs\fP
-.in +7
Post-join fencing delay (passed to fenced)
-.sp
-.in
-
+.TP
\fB-f\fP \fIsecs\fP
-.in +7
Post-fail fencing delay (passed to fenced)
-.sp
-.in
-
+.TP
\fB-c\fP
-.in +7
All nodes are in a clean state to start (passed to fenced)
-.sp
-.in -7
-.in -7
-\fBSEE ALSO\fP
-.in +7
+
+.SH SEE ALSO
fenced(8), fence(8), fence_node(8)
=== man/fence_vixel.8
==================================================================
--- man/fence_vixel.8 (revision 317)
+++ man/fence_vixel.8 (local)
@@ -5,97 +5,67 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_vixel(8)''fence_vixel(8)'
+.TH fence_vixel 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_vixel - I/O Fencing agent for Vixel FC switches
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_vixel [-hV] -a\fP \fIIPaddress\fR \fB-p\fP \fIpassword\fR \fB-n\fP \fIport\fR
+.SH SYNOPSIS
+.B
+fence_vixel
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_vixel is an I/O Fencing agent which can be used with Vixel FC switches.
It logs into a Vixel switch via telnet and removes the specified port from the
zone. Removing the zone access from the port disables the port from being able
to access the storage.
-.sp
+
fence_vixel accepts options on the command line as well as from stdin.
fenced sends parameters through stdin when it execs the agent. fence_vixel
can be run by itself with command line options which is useful for testing.
-.sp
+
After a fence operation has taken place the fenced machine can no longer
connect to the Vixel FC switch. When the fenced machine is ready to be brought
back into the GFS cluster (after reboot) the port on the Vixel FC switch needs
to be enabled. In order to do this, log into the Vixel FC switch. Then go to:
-.in
-.in +7
+
config->zones->config <port> <comma-separated-list-of-ports-in-the-zone>
-.in
-.in +7
+
Then apply
-.sp
+
Consult the Vixel manual for details
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-a\fP \fIIPaddress\fP
-.in +7
IP address of the switch.
-.sp
-.in
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-n\fP \fIport\fP
-.in +7
The port number to remove zoning from on the switch.
-.in
-.sp
+.TP
\fB-p\fP \fIpassword\fP
-.in +7
Password for login.
-.sp
-.in
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.sp
-.in
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
-
+.SH STDIN PARAMETERS
+.TP
\fIagent = < param >\fR
-.sp
This option is used by fence_node(8) and is ignored by fence_vixel.
-.sp
-
+.TP
\fIipaddr = < hostname | ip >\fR
-.sp
IP address or hostname of the switch.
-.sp
-
+.TP
\fIpasswd = < param >\fR
-.sp
Password for login.
-.sp
-
+.TP
\fIport = < param >\fR
-.sp
The port number to remove zoning from on the switch.
-.sp
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH BSEE ALSO
fence(8), fence_node(8)
=== man/fence_wti.8
==================================================================
--- man/fence_wti.8 (revision 317)
+++ man/fence_wti.8 (local)
@@ -5,99 +5,65 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_wti(8)''fence_wti(8)'
+.TH fence_wti 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_wti - I/O Fencing agent for WTI Network Power Switch
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_wti -a\fP \fIIPaddress\fR \fB-p\fP \fIpassword\fR \fB-n\fP \fIplug\fR [\fB-T\fP]
+.SH SYNOPSIS
+.B
+fence_wti
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_wti is an I/O Fencing agent which can be used with the WTI Network
Power Switch (NPS). It logs into an NPS via telnet and boots a specified plug.
Lengthy telnet connections to the NPS should be avoided while a GFS cluster is
running because the connection will block any necessary fencing actions.
-.sp
+
fence_wti accepts options on the command line as well as from stdin.
fenced sends the options through stdin when it execs the agent. fence_wti
can be run by itself with command line options which is useful for testing.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-a\fP \fIIPaddress\fP
-.in +7
IP address of the switch.
-.sp
-.in
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.in
-.sp
+.TP
\fB-n\fP \fIplug\fP
-.in +7
The plug number to power cycle.
-.in
-.sp
+.TP
\fB-p\fP \fIpassword\fP
-.in +7
Password for login.
-.sp
-.in
+.TP
\fB-T\fP
-.in +7
Test only. Do not power cycle. Reports state of the plug.
-.in
-.sp
+.TP
\fB-q\fP
-.in +7
Quiet operation. Only print out error messages.
-.in
-.sp
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.in
-.sp
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
-
-\fI agent = < param >\fR
-.sp
+.SH STDIN PARAMETERS
+.TP
+\fIagent = < param >\fR
This option is used by fence_node(8) and is ignored by fence_wti.
-.sp
-
+.TP
\fIipaddr = < hostname | ip >\fR
-.sp
IP address or hostname of the switch.
-.sp
-
-\fI passwd = < param >\fR
-.sp
+.TP
+\fIpasswd = < param >\fR
Password for login.
-.sp
-
-\fI port = < param >\fR
-.sp
+.TP
+\fIport = < param >\fR
The outlet number to act upon.
-.sp
-
-\fI test = < param >\fR
-.sp
+.TP
+\fItest = < param >\fR
Test only. Answer NO to the confirmation prompt instead of YES.
-.sp
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8)
=== man/fence_xcat.8
==================================================================
--- man/fence_xcat.8 (revision 317)
+++ man/fence_xcat.8 (local)
@@ -1,94 +1,63 @@
.\" Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved.
-.tl 'fence_xcat(8)''fence_xcat(8)'
+.TH fence_xcat 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_xcat - I/O Fencing agent for xcat environments
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_xcat -n\fP \fInodename\fR \fB -o\fP \fIaction\fR \fB -r\fP \fIrpower\fR
+.SH SYNOPSIS
+.B
+fence_xcat
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_xcat is a wrapper to the rpower(1) command that is distributed
with the xCAT project available at http://www.xcat.org. Use of
fence_xcat requires that xcat has already been properlly configfured
for your environment. Refer to xCAT(1) for more information on
configuring xCAT.
-.sp
+
fence_xcat accepts options on the command line as well as from stdin.
fenced sends parameters through stdin when it execs the agent. fence_xcat
can be run by itself with command line options which is useful for testing.
-.sp
+
NOTE: It is recommended that fence_bladecenter(8) is used instead of fence_xcat if
the bladecenter firmware supports telnet. This interface is much cleaner and
easier to setup.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-n\fP \fInodename\fP
-.in +7
The nodename as defined in nodelist.tab of the xCAT setup.
-.in
-.sp
+.TP
\fB-o\fP \fIaction\fP
-.in +7
The action required. on, off, reset (default) or stat.
-.in
-.sp
+.TP
\fB-r\fP \fIrpower\fP
-.in +7
The path to the rpower binary.
-.sp
-.in
+.TP
\fB-q\fP
-.in +7
Quiet mode: print only error messages.
-.sp
-.in
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.sp
-.in
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
-
-\fI agent = < param >\fR
-.sp
+.SH STDIN PARAMETERS
+.TP
+\fIagent = < param >\fR
This option is used by fence_node(8) and is ignored by fence_xcat.
-.sp
-
-\fI nodename = < param >\fR
-.sp
+.TP
+\fInodename = < param >\fR
The nodename as defined in nodelist.tab of the xCAT setup.
-.sp
-
-\fI action = < param >\fR
-.sp
+.TP
+\fIaction = < param >\fR
The action required. on, off, reset (default) or stat.
-.sp
-
-\fI rpower = < param >\fR
-.sp
+.TP
+\fIrpower = < param >\fR
The path to the rpower binary.
-.sp
-
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fence_node(8), fence_bladecenter(8), nodelist.tab(8), rpower(1), xCAT(1)
=== man/fence_zvm.8
==================================================================
--- man/fence_zvm.8 (revision 317)
+++ man/fence_zvm.8 (local)
@@ -5,89 +5,59 @@
.\" modify, copy, or redistribute it subject to the terms and conditions
.\" of the GNU General Public License v.2.
-.tl 'fence_zvm(8)''fence_zvm(8)'
+.TH fence_zvm 8
-\fBNAME\fP
-.in +7
+.SH NAME
fence_zvm - I/O Fencing agent for GFS on s390 and zSeries VM clusters
-.in
-\fBSYNOPSIS\fP
-.in +7
-\fBfence_zvm -a\fP \fIIPaddress\fP \fB-u\fP \fIuserid\fP \fB-p\fP \fIpassword\fP
+.SH SYNOPSIS
+.B
+fence_zvm
+[\fIOPTION\fR]...
-.in
-.sp
-\fBDESCRIPTION\fP
-.in +7
+.SH DESCRIPTION
fence_zvm is an I/O Fencing agent used on a GFS virtual machine in a s390 or zSeries VM cluster.
It uses the s3270 program to log the specified virtual machine out of VM.
For fence_zvm to execute correctly, you must have s3270 in your PATH.
-.sp
fence_zvm accepts options on the command line as well as from stdin.
fence_node sends the options through stdin when it execs the agent.
fence_zvm can be run by itself with command line options which is useful
for testing.
-.sp
-.in
-\fBOPTIONS\fP
-.in
+
+.SH OPTIONS
+.TP
\fB-a\fP \fIIPaddress\fP
-.in +7
IP address or hostname of the Physical machine (required).
-.sp
-.in
+.TP
\fB-h\fP
-.in +7
Print out a help message describing available options, then exit.
-.sp
-.in
+.TP
\fB-u\fP \fIuserid\fP
-.in +7
userid of the virtual machine to fence (required).
-.sp
-.in
+.TP
\fB-p\fP \fIpassword\fP
-.in +7
password of the virtual machine to fence (required).
-.sp
-.in
+.TP
\fB-q\fP
-.in +7
quiet mode, no output.
-.sp
-.in
+.TP
\fB-V\fP
-.in +7
Print out a version message, then exit.
-.sp
-.in
-.in -7
-\fBSTDIN PARAMETERS\fP
-.in
+.SH STDIN PARAMETERS
+.TP
\fIagent = < param >\fP
-.sp
This option is used by fence_node(8) and is ignored by fence_zvm.
-.sp
-
+.TP
\fIipaddr = < hostname | ip >\fP
-.sp
IP address or hostname of the Physical machine (required).
-.sp
-
+.TP
\fIpasswd = < param >\fP
-.sp
password of the virtual machine to fence (required).
-.sp
-
+.TP
\fIuserid = < param >\fP
-.sp
userid of the virtual machine to fence (required).
-.sp
-.in -7
-\fBSEE ALSO\fP
-.in +7
+.SH SEE ALSO
fence(8), fenced(8), fence_node(8)
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 197 bytes
Desc: Digital signature
URL: <http://listman.redhat.com/archives/linux-cluster/attachments/20050213/a4f003b5/attachment.sig>
More information about the Linux-cluster
mailing list