Gitweb: http://git.fedorahosted.org/git/cluster.git?p=cluster.git;a=commitdiff;h=ae7... Commit: ae7be075867909d08ec2bfbae8a7847a1a838580 Parent: 56b618c99947d457579c6bc9f0a1de4aae329595 Author: Marek 'marx' Grac mgrac@redhat.com AuthorDate: Wed Feb 16 17:04:51 2011 +0100 Committer: Marek 'marx' Grac mgrac@redhat.com CommitterDate: Fri Feb 25 10:04:19 2011 +0100
fence-agents: Automatic generation of manual pages
Change build system to create manual pages directly from fence agents.
Resolves: rhbz#488959 --- fence/agents/apc/Makefile | 10 +- fence/agents/apc_snmp/Makefile | 10 +- fence/agents/bladecenter/Makefile | 10 +- fence/agents/cisco_mds/Makefile | 10 +- fence/agents/cisco_ucs/Makefile | 10 +- fence/agents/drac/Makefile | 10 +- fence/agents/eps/Makefile | 10 +- fence/agents/ibmblade/Makefile | 18 ++- fence/agents/ifmib/Makefile | 10 +- fence/agents/ilo/Makefile | 10 +- fence/agents/ilo_mp/Makefile | 10 +- fence/agents/ipmilan/Makefile | 15 ++- fence/agents/lpar/Makefile | 11 +- fence/agents/rhevm/Makefile | 10 +- fence/agents/rsa/Makefile | 10 +- fence/agents/sanbox2/Makefile | 10 +- fence/agents/virsh/Makefile | 10 +- fence/agents/vmware/Makefile | 10 +- fence/agents/wti/Makefile | 10 +- fence/make/defines.mk.input | 7 + fence/man/Makefile | 14 -- fence/man/fence_apc.8 | 99 ----------- fence/man/fence_bladecenter.8 | 96 ----------- fence/man/fence_cisco_mds.8 | 132 --------------- fence/man/fence_cisco_ucs.8 | 251 ---------------------------- fence/man/fence_eps.8 | 106 ------------ fence/man/fence_ibmblade.8 | 68 -------- fence/man/fence_ifmib.8 | 323 ------------------------------------- fence/man/fence_ilo.8 | 95 ----------- fence/man/fence_ipmilan.8 | 111 ------------- fence/man/fence_lpar.8 | 116 ------------- fence/man/fence_rsa.8 | 69 -------- fence/man/fence_sanbox2.8 | 83 ---------- fence/man/fence_vmware.8 | 137 ---------------- fence/man/fence_wti.8 | 84 ---------- 35 files changed, 168 insertions(+), 1827 deletions(-)
diff --git a/fence/agents/apc/Makefile b/fence/agents/apc/Makefile index c33350a..a1f1570 100644 --- a/fence/agents/apc/Makefile +++ b/fence/agents/apc/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_apc.py TARGET= fence_apc +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
fence_apc: fence_apc.py : > $(TARGET) @@ -34,5 +35,10 @@ install: all fi install -m755 ${TARGET} ${sbindir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8 + clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET) diff --git a/fence/agents/apc_snmp/Makefile b/fence/agents/apc_snmp/Makefile index 29a0df7..b10a9ab 100644 --- a/fence/agents/apc_snmp/Makefile +++ b/fence/agents/apc_snmp/Makefile @@ -14,11 +14,12 @@ SOURCE= fence_apc_snmp.py TARGET= fence_apc_snmp RESOURCE= powernet369.mib +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
fence_apc_snmp: fence_apc_snmp.py : > $(TARGET) @@ -40,5 +41,10 @@ install: all fi install -m755 ${RESOURCE} ${mibdir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8 + clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET) diff --git a/fence/agents/bladecenter/Makefile b/fence/agents/bladecenter/Makefile index 34dd24d..55f0164 100644 --- a/fence/agents/bladecenter/Makefile +++ b/fence/agents/bladecenter/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_bladecenter.py TARGET= fence_bladecenter +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
fence_bladecenter: fence_bladecenter.py : > $(TARGET) @@ -33,6 +34,11 @@ install: all install -d ${sbindir}; \ fi install -m755 ${TARGET} ${sbindir} + + if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8
clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET) diff --git a/fence/agents/cisco_mds/Makefile b/fence/agents/cisco_mds/Makefile index f61b83b..d53bbe4 100644 --- a/fence/agents/cisco_mds/Makefile +++ b/fence/agents/cisco_mds/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_cisco_mds.py TARGET= fence_cisco_mds +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
fence_cisco_mds: fence_cisco_mds.py : > $(TARGET) @@ -34,5 +35,10 @@ install: all fi install -m755 ${TARGET} ${sbindir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8 + clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET) diff --git a/fence/agents/cisco_ucs/Makefile b/fence/agents/cisco_ucs/Makefile index 5875ba0..016a009 100644 --- a/fence/agents/cisco_ucs/Makefile +++ b/fence/agents/cisco_ucs/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_cisco_ucs.py TARGET= fence_cisco_ucs +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
fence_cisco_ucs: fence_cisco_ucs.py : > $(TARGET) @@ -34,5 +35,10 @@ install: all fi install -m755 ${TARGET} ${sbindir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8 + clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET) diff --git a/fence/agents/drac/Makefile b/fence/agents/drac/Makefile index ce84f20..208748c 100644 --- a/fence/agents/drac/Makefile +++ b/fence/agents/drac/Makefile @@ -16,11 +16,12 @@ TARGET1= fence_drac
SOURCE2= fence_drac5.py TARGET2= fence_drac5 +MANTARGET= $(TARGET2).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET1) $(TARGET2) +all: $(TARGET1) $(TARGET2) $(MANTARGET)
fence_drac: fence_drac.pl : > $(TARGET1) @@ -46,5 +47,10 @@ install: all fi install -m755 ${TARGET1} ${TARGET2} ${sbindir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8 + clean: - rm -f $(TARGET1) $(TARGET2) + rm -f $(TARGET1) $(TARGET2) $(MANTARGET) diff --git a/fence/agents/eps/Makefile b/fence/agents/eps/Makefile index 3e086c9..244f24c 100644 --- a/fence/agents/eps/Makefile +++ b/fence/agents/eps/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_eps.py TARGET= fence_eps +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
fence_eps: fence_eps.py : > $(TARGET) @@ -34,5 +35,10 @@ install: all fi install -m755 ${TARGET} ${sbindir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8 + clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET) diff --git a/fence/agents/ibmblade/Makefile b/fence/agents/ibmblade/Makefile index ec8e62b..1f8b3de 100644 --- a/fence/agents/ibmblade/Makefile +++ b/fence/agents/ibmblade/Makefile @@ -13,18 +13,19 @@
SOURCE= fence_ibmblade.py TARGET= fence_ibmblade +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
$(TARGET): $(SOURCE) : > $(TARGET) awk "{print}($$1 ~ /#BEGIN_VERSION_GENERATION/){exit 0}" $(SOURCE) >> $(TARGET) - echo "$$FENCE_RELEASE_NAME="${RELEASE}";" >> $(TARGET) - ${top_srcdir}/scripts/define2var ${top_srcdir}/config/copyright.cf perl REDHAT_COPYRIGHT >> $(TARGET) - echo "$$BUILD_DATE="(built `date`)";" >> $(TARGET) + echo "FENCE_RELEASE_NAME="${RELEASE}";" >> $(TARGET) + ${top_srcdir}/scripts/define2var ${top_srcdir}/config/copyright.cf sh REDHAT_COPYRIGHT >> $(TARGET) + echo "BUILD_DATE="(built `date`)";" >> $(TARGET) awk -v p=0 "($$1 ~ /#END_VERSION_GENERATION/){p = 1} {if(p==1)print}" $(SOURCE) >> $(TARGET) chmod +x $(TARGET)
@@ -33,8 +34,11 @@ install: all install -d ${sbindir}; \ fi install -m755 ${TARGET} ${sbindir} + + if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8
clean: - rm -f $(TARGET) - - + rm -f $(TARGET) $(MANTARGET) diff --git a/fence/agents/ifmib/Makefile b/fence/agents/ifmib/Makefile index e564689..7a6a643 100644 --- a/fence/agents/ifmib/Makefile +++ b/fence/agents/ifmib/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_ifmib.py TARGET= fence_ifmib +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
fence_ifmib: $(SOURCE) : > $(TARGET) @@ -34,5 +35,10 @@ install: all fi install -m755 ${TARGET} ${sbindir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8 + clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET) diff --git a/fence/agents/ilo/Makefile b/fence/agents/ilo/Makefile index 089266e..4e2f408 100644 --- a/fence/agents/ilo/Makefile +++ b/fence/agents/ilo/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_ilo.py TARGET= fence_ilo +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
fence_ilo: $(SOURCE) : > $(TARGET) @@ -33,6 +34,11 @@ install: all install -d ${sbindir}; \ fi install -m755 ${TARGET} ${sbindir} + + if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8
clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET) diff --git a/fence/agents/ilo_mp/Makefile b/fence/agents/ilo_mp/Makefile index f6e1ddf..aadf954 100644 --- a/fence/agents/ilo_mp/Makefile +++ b/fence/agents/ilo_mp/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_ilo_mp.py TARGET= fence_ilo_mp +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
fence_ilo_mp: $(SOURCE) : > $(TARGET) @@ -34,5 +35,10 @@ install: all fi install -m755 ${TARGET} ${sbindir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8 + clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET) diff --git a/fence/agents/ipmilan/Makefile b/fence/agents/ipmilan/Makefile index 70b9f84..1c84ea3 100644 --- a/fence/agents/ipmilan/Makefile +++ b/fence/agents/ipmilan/Makefile @@ -12,6 +12,7 @@ ###############################################################################
TARGET= fence_ipmilan +MANTARGETX= $(TARGET).8
fence_ipmilan_SOURCE= expect.c ipmilan.c
@@ -25,16 +26,26 @@ include ${top_srcdir}/make/defines.mk
CFLAGS+= -DFENCE_RELEASE_NAME="${RELEASE}" -DFENCE
-all: ${TARGET} +all: ${TARGET} $(MANTARGETX)
fence_ipmilan: ${fence_ipmilan_SOURCE:.c=.o} ${CC} ${CFLAGS} ${LDFLAGS} ${fence_ipmilan_SOURCE:.c=.o} -o $@
+$(MANTARGETX): $(MANTARGETX:.8=) $(top_srcdir)/agents/lib/fence2man.xsl + set -e && \ + ./fence_ipmilan -o metadata > .$@.tmp && \ + xsltproc $(top_srcdir)/agents/lib/fence2man.xsl .$@.tmp > $@ + install: all if [ ! -d ${sbindir} ]; then \ install -d ${sbindir}; \ fi install -m755 ${TARGET} ${sbindir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGETX} ${mandir}/man8 + clean: - rm -f *.o ${TARGET} + rm -f *.o ${TARGET} $(MANTARGETX) diff --git a/fence/agents/lpar/Makefile b/fence/agents/lpar/Makefile index 142582a..059cb12 100644 --- a/fence/agents/lpar/Makefile +++ b/fence/agents/lpar/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_lpar.py TARGET= fence_lpar +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
fence_lpar: fence_lpar.py : > $(TARGET) @@ -34,5 +35,11 @@ install: all fi install -m755 ${TARGET} ${sbindir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8 + + clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET) diff --git a/fence/agents/rhevm/Makefile b/fence/agents/rhevm/Makefile index 4315a91..d870c16 100644 --- a/fence/agents/rhevm/Makefile +++ b/fence/agents/rhevm/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_rhevm.py TARGET= fence_rhevm +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
fence_rhevm: $(SOURCE) : > $(TARGET) @@ -34,5 +35,10 @@ install: all fi install -m755 ${TARGET} ${sbindir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8 + clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET) diff --git a/fence/agents/rsa/Makefile b/fence/agents/rsa/Makefile index 0b948cc..2288891 100644 --- a/fence/agents/rsa/Makefile +++ b/fence/agents/rsa/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_rsa.py TARGET= fence_rsa +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
fence_rsa: fence_rsa.py : > $(TARGET) @@ -34,5 +35,10 @@ install: all fi install -m755 ${TARGET} ${sbindir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8 + clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET) diff --git a/fence/agents/sanbox2/Makefile b/fence/agents/sanbox2/Makefile index f6d84bb..cb5515f 100644 --- a/fence/agents/sanbox2/Makefile +++ b/fence/agents/sanbox2/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_sanbox2.py TARGET= fence_sanbox2 +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
$(TARGET): $(SOURCE) : > $(TARGET) @@ -34,7 +35,12 @@ install: all fi install -m755 ${TARGET} ${sbindir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8 + clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET)
diff --git a/fence/agents/virsh/Makefile b/fence/agents/virsh/Makefile index 45ca6bf..9e972aa 100644 --- a/fence/agents/virsh/Makefile +++ b/fence/agents/virsh/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_virsh.py TARGET= fence_virsh +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
fence_virsh: fence_virsh.py : > $(TARGET) @@ -34,6 +35,11 @@ install: all fi install -m755 ${TARGET} ${sbindir}
+ if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8 + clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET)
diff --git a/fence/agents/vmware/Makefile b/fence/agents/vmware/Makefile index 1795e63..c893406 100644 --- a/fence/agents/vmware/Makefile +++ b/fence/agents/vmware/Makefile @@ -13,6 +13,7 @@
SOURCE= fence_vmware.py TARGET= fence_vmware +MANTARGET= $(TARGET).8
SOURCE2= fence_vmware_helper.pl TARGET2= fence_vmware_helper @@ -20,7 +21,7 @@ TARGET2= fence_vmware_helper top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) $(TARGET2) +all: $(TARGET) $(TARGET2) $(MANTARGET)
$(TARGET): $(SOURCE) : > $(TARGET) @@ -46,7 +47,12 @@ install: all fi install -m755 ${TARGET} ${sbindir} install -m755 ${TARGET2} ${sbindir} + + if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8
clean: - rm -f $(TARGET) $(TARGET2) + rm -f $(TARGET) $(TARGET2) $(MANTARGET)
diff --git a/fence/agents/wti/Makefile b/fence/agents/wti/Makefile index 73f42a4..ff8ca35 100644 --- a/fence/agents/wti/Makefile +++ b/fence/agents/wti/Makefile @@ -13,11 +13,12 @@
SOURCE= fence_wti.py TARGET= fence_wti +MANTARGET= $(TARGET).8
top_srcdir=../.. include ${top_srcdir}/make/defines.mk
-all: $(TARGET) +all: $(TARGET) $(MANTARGET)
$(TARGET): $(SOURCE) : > $(TARGET) @@ -33,7 +34,12 @@ install: all install -d ${sbindir}; \ fi install -m755 ${TARGET} ${sbindir} + + if [ ! -d ${mandir}/man8 ]; then \ + install -d ${mandir}/man8; \ + fi + install -m644 ${MANTARGET} ${mandir}/man8
clean: - rm -f $(TARGET) + rm -f $(TARGET) $(MANTARGET)
diff --git a/fence/make/defines.mk.input b/fence/make/defines.mk.input index b270dea..4c5b40f 100644 --- a/fence/make/defines.mk.input +++ b/fence/make/defines.mk.input @@ -40,3 +40,10 @@ RANLIB = ranlib
# Default CFLAGS CFLAGS += -Wall ${INCLUDE} + +$(MANTARGET): $(MANTARGET:.8=) $(top_srcdir)/agents/lib/fence2man.xsl + set -e && \ + PYTHONPATH=$(top_srcdir)/agents/lib \ + python $^ -o metadata > .$@.tmp && \ + xsltproc $(top_srcdir)/agents/lib/fence2man.xsl .$@.tmp > $@ + diff --git a/fence/man/Makefile b/fence/man/Makefile index ad64c0c..3ccc8e6 100644 --- a/fence/man/Makefile +++ b/fence/man/Makefile @@ -14,34 +14,20 @@ TARGET8= \ fence.8 \ fence_ack_manual.8 \ - fence_apc.8 \ - fence_rsa.8 \ - fence_bladecenter.8 \ fence_brocade.8 \ - fence_cisco_mds.8 \ fence_drac.8 \ fence_egenera.8 \ - fence_eps.8 \ - fence_ilo.8 \ - fence_lpar.8 \ fence_manual.8 \ fence_mcdata.8 \ fence_node.8 \ fence_rib.8 \ - fence_sanbox2.8 \ fence_scsi.8 \ fence_scsi_test.8 \ fence_tool.8 \ fence_vixel.8 \ - fence_wti.8 \ fence_bullpap.8 \ - fence_ipmilan.8 \ - fence_vmware.8 \ fence_xvm.8 \ fence_xvmd.8 \ - fence_cisco_ucs.8 \ - fence_ifmib.8 \ - fence_rhevm.8 \ fenced.8
UNINSTALL=${top_srcdir}/scripts/uninstall.pl diff --git a/fence/man/fence_apc.8 b/fence/man/fence_apc.8 deleted file mode 100644 index 45825dc..0000000 --- a/fence/man/fence_apc.8 +++ /dev/null @@ -1,99 +0,0 @@ -." Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved. -." Copyright (C) 2004 Red Hat, Inc. All rights reserved. -." -." 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. - -.TH fence_apc 8 - -.SH NAME -fence_apc - I/O Fencing agent for APC MasterSwitch - -.SH SYNOPSIS -.B -fence_apc -[\fIOPTION\fR]... - -.SH DESCRIPTION -fence_apc is an I/O Fencing agent which can be used with the APC network -power switch. It logs into device via telnet/ssh and reboots a specified -outlet. Lengthy telnet/ssh connections should be avoided while a GFS -cluster is running because the connection will block any necessary -fencing actions. - -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. - -.SH OPTIONS -.TP -\fB-a\fP \fIIPaddress\fR -IP address or hostname of the switch. -.TP -\fB-h\fP -Print out a help message describing available options, then exit. -.TP -\fB-l\fP \fIlogin\fR -Login name. -.TP -\fB-n\fP \fI[<switch>:]outlet\fR -The outlet number to act upon. -.TP -\fB-o\fP \fIaction\fR -The action required. Reboot (default), Status, Off or On. -.TP -\fB-p\fP \fIpassword\fR -Password for login or for passphrase. -.TP -\fB-S\fP \fIscript\fR -Script to run to retrieve password. -.TP -\fB-x\fP -Use secure connection over ssh (using version 1, cipher blowfish). -.TP -\fB-T\fP -Test only. Answer NO to the confirmation prompt instead of YES. -.TP -\fB-v\fP -Verbose. Record telnet session in /tmp/apclog. -.TP -\fB-V\fP -Print out a version message, then exit. - -.SH STDIN PARAMETERS -.TP -\fIagent = < param >\fR -This option is used by fence_node(8) and is ignored by fence_apc. -.TP -\fIipaddr = < hostname | ip >\fR -IP address or hostname of the switch. -.TP -\fIlogin = < param >\fR -Login name. -.TP -\fIoption = < param >\fR -The action required. Reboot (default), Off or On. -.TP -\fIpasswd = < param >\fR -Password for login or for passphrase. -\fIpasswd_script = < param >\fR -Script to run to retrieve password. -\fIsecure = < param >\fR -Use secure connection over ssh. -.TP -\fIport = < param >\fR -The outlet number to act upon. -.TP -\fIswitch = < param >\fR -The switch to operate on. Defaults to "1" if not specified. -.TP -\fItest = < param >\fR -Test only. Answer NO to the confirmation prompt instead of YES. -.TP -\fIverbose = < param >\fR -Verbose. Record telnet session in /tmp/apclog. - -.SH SEE ALSO -fence(8), fence_node(8) diff --git a/fence/man/fence_bladecenter.8 b/fence/man/fence_bladecenter.8 deleted file mode 100644 index 70c0b00..0000000 --- a/fence/man/fence_bladecenter.8 +++ /dev/null @@ -1,96 +0,0 @@ -." Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved. -." Copyright (C) 2004 Red Hat, Inc. All rights reserved. -." -." 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. - -.TH fence_bladecenter 8 - -.SH NAME -fence_bladecenter - I/O Fencing agent for IBM Bladecenter - -.SH SYNOPSIS -.B -fence_bladecenter -[\fIOPTION\fR]... - -.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 or ssh and uses the command line -interface to power on and off blades. fence_bladecenter accepts options on -the command line or from stdin. - -.SH OPTIONS -.TP -\fB-a\fP \fIIPaddress\fP -IP address of the Bladecenter. -.TP -\fB-h\fP -Print out a help message describing available options, then exit. -.TP -\fB-l\fP \fIlogin\fP -Login name for the Bladecenter. -.TP -\fB-n\fP \fIblade\fP -The blade to operate on. -.TP -\fB-o\fP \fIaction\fP -The action required. Valid actions are on, off, reboot (default) and status. -.TP -\fB-p\fP \fIpassword\fP -Password for login or for passphrase. -.TP -\fB-S\fP \fIscript\fR -Script to run to retrieve password. -.TP -\fB-k\fP \fIidentity\fR -Identity file (private key) for ssh connection. -.TP -\fB-x\fP -Use secure connection over ssh. -.TP -\fB-q\fP -Quiet mode: print only error messages. -.TP -\fB-V\fP -Print out a version message, then exit. -.TP -\fB-v\fP \fIdebuglog\fP -Log the telnet session to \fIdebuglog\fP for debugging purposes. - -.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 -IP address or hostname of the switch. -.TP -\fIlogin = < param >\fR -Login name. -.TP -\fIoption = < param >\fR -The action required. disable (default) or enable. -.TP -\fIpasswd = < param >\fR -Password for login or for passphrase. -.TP -\fIpasswd_script = < param >\fR -Script to run to retrieve password. -.TP -\fIidentity_file = < param > \fR -Identity file (private key) for ssh. -.TP -\fIsecure = < param >\fR -Use secure connection over ssh. -.TP -\fIblade = < param >\fR -The blade to operate on. -.TP -\fIdebuglog = < param>\fR -Optional parameter to send debug transcript of the telnet session to a log file - -.SH SEE ALSO -fence(8), fence_node(8) diff --git a/fence/man/fence_cisco_mds.8 b/fence/man/fence_cisco_mds.8 deleted file mode 100644 index 8c58d63..0000000 --- a/fence/man/fence_cisco_mds.8 +++ /dev/null @@ -1,132 +0,0 @@ -.TH fence_cisco_mds 8 - -.SH NAME -fence_cisco_mds - I/O Fencing agent for Cisco MDS 9000 series SNMP devices - -.SH SYNOPSIS -.B -fence_cisco_mds -[\fIOPTION\fR]... - -.SH DESCRIPTION -fence_cisco_mds is an I/O Fencing agent which can be used with any Cisco MDS -9000 series with SNMP enabled device. Agent internally uses snmpget, snmpset -and snmpwalk command. - -fence_cisco_mds accepts options on the command line as well as from stdin. -Fenced sends parameters through stdin when it execs the agent. fence_cisco_mds -can be run by itself with command line options. This is useful for testing. - -.SH OPTIONS -.TP -\fB-a\fP \fIIPaddress\fR -IP address or hostname of the Cisco device. Can be used any syntax supported by snmpget. -.TP -\fB-h\fP -Print out a help message describing available options, then exit. -.TP -\fB-c\fP \fIcommunity\fR -The read/write community string to be used in the request. -.TP -\fB-n\fP \fIname\fR -Name of port to fence (fc1/1) -.TP -\fB-p\fP \fIpassword\fR -Password for login for SNMP v3 (authentication protocol pass phrase). -.TP -\fB-P\fP \fIpassword\fR -Password for privacy for SNMP v3 (privacy protocol password). -.TP -\fB-S\fP \fIscript\fR -Script to run to retrieve password for login for SNMP v3 (authentication protocol pass phrase). -.TP -\fB-R\fP \fIscript\fR -Script to run to retrieve privacy for SNMP v3 (privacy protocol password). -.TP -\fB-l\fP \fIlogin\fR -Login name for SNMP v3 (security name). -.TP -\fB-d\fP \fIversion\fR -SNMP version (1,2c,3). -.TP -\fB-b\fP \fIauth_protocol\fR -SNMP authentication protocol (MD5|SHA). -.TP -\fB-E\fP \fIsec_level\fR -SNMP security level (noAuthNoPriv|authNoPriv|authPriv). -.TP -\fB-B\fP \fIpriv_protocol\fR -SNMP privacy protocol (DES|AES). -.TP -\fB-u\fP \fIudp_port\fR -UDP/TCP port to use. -.TP -\fB-o\fP \fIaction\fR -The action required. off (default), on, status, list or monitor. Deprecated -options (enable -> on and disable -> off) can be used too. -.TP -\fB-v\fP -Verbose. Record session to stdout, or debug file if specified (see -D). -.TP -\fB-D\fP -Specifies file, where will be written debug messages from session. -.TP -\fB-V\fP -Print out a version message, then exit. - -.SH STDIN PARAMETERS -.TP -\fIagent = < param >\fR -This option is used by fence_node(8) and is ignored by fence_cisco_mds. -.TP -\fIipaddr = < param >\fR -IP address or hostname of the Cisco device. Can be used any syntax supported by snmpget. -.TP -\fIcommunity = < param >\fR -The read/write community string to be used in the request. -.TP -\fIport = < param >\fR -Name of port to fence (fc1/1) -.TP -\fIpasswd = < param >\fR -Password for login for SNMP v3 (authentication protocol pass phrase). -.TP -\fIsnmp_priv_passwd\fR -Password for privacy for SNMP v3 (privacy protocol password). -.TP -\fIpasswd_script = < param >\fR -Script to run to retrieve password for login for SNMP v3 (authentication protocol pass phrase). -.TP -\fIsnmp_priv_passwd_script = < param>\fR -Password for privacy for SNMP v3 (privacy protocol password). -.TP -\fIlogin = < param >\fR -Login name for SNMP v3 (security name). -.TP -\fIsnmp_version = < param >\fR -SNMP version (1,2c,3). -.TP -\fIsnmp_auth_prot = < param >\fR -SNMP authentication protocol (MD5|SHA). -.TP -\fIsnmp_sec_level = < param >\fR -SNMP security level (noAuthNoPriv|authNoPriv|authPriv). -.TP -\fIsnmp_priv_prot = < param >\fR -SNMP privacy protocol (DES|AES). -.TP -\fIudpport = < param >\fR -UDP/TCP port to use. -.TP -\fIaction = < param >\fR -The action required. off (default), on, status, list or monitor. Deprecated -options (enable -> on and disable -> off) can be used too. -.TP -\fIverbose = < param >\fR -Verbose. Record session to stdout, or debug file if specified (see debug). -.TP -\fIdebug = < param >\fR -Specifies file, where will be written debug messages from session. - -.SH SEE ALSO -fence(8), fence_node(8) diff --git a/fence/man/fence_cisco_ucs.8 b/fence/man/fence_cisco_ucs.8 deleted file mode 100644 index 6afa32b..0000000 --- a/fence/man/fence_cisco_ucs.8 +++ /dev/null @@ -1,251 +0,0 @@ - -.TH FENCE_AGENT 8 2009-10-20 "fence_cisco_ucs (Fence Agent)" -.SH NAME -fence_cisco_ucs - Fence agent for Cisco UCS -.SH DESCRIPTION -.P -fence_cisco_ucs is an I/O Fencing agent which can be used with Cisco UCS to fence machines. -.P -fence_cisco_ucs accepts options on the command line as well -as from stdin. Fenced sends parameters through stdin when it execs the -agent. fence_cisco_ucs can be run by itself with command -line options. This is useful for testing and for turning outlets on or off -from scripts. - -Vendor URL: http://www.cisco.com -.SH PARAMETERS - - -.TP -.B -o, --action=<action> -. -Fencing Action (Default Value: reboot) - -.TP -.B -a, --ip=<ip> -. -IP Address or Hostname This parameter is always required. - -.TP -.B -l, --username=<name> -. -Login Name This parameter is always required. - -.TP -.B -p, --password=<password> -. -Login password or passphrase - -.TP -.B -S, --password-script=<script> -. -Script to retrieve password - -.TP -.B -z, --ssl -. -SSL connection - -.TP -.B -4, --inet4-only -. -Forces agent to use IPv4 addresses only - -.TP -.B -6, --inet6-only -. -Forces agent to use IPv6 addresses only - -.TP -.B -u, --ipport=<port> -. -TCP port to use for connection with device - -.TP -.B -n, --plug=<id> -. -Physical plug number or name of virtual machine This parameter is always required. - -.TP -.B -v, --verbose -. -Verbose mode - -.TP -.B -D, --debug-file=<debugfile> -. -Write debug information to given file - -.TP -.B -V, --version -. -Display version information and exit - -.TP -.B -h, --help -. -Display help and exit - -.TP -.B -C, --separator=<char> -. -Separator for CSV created by operation list (Default Value: ,) - -.TP -.B --power-wait -. -Wait X seconds after issuing ON/OFF (Default Value: 0) - -.TP -.B --power-timeout -. -Test X seconds for status change after ON/OFF (Default Value: 20) - -.TP -.B --shell-timeout -. -Wait X seconds for cmd prompt after issuing command (Default Value: 3) - -.TP -.B --retry-on -. -Count of attempts to retry power on (Default Value: 1) - -.TP -.B --delay -. -Wait X seconds before fencing is started (Default Value: 0) - -.SH ACTIONS - - -.TP -\fBon \fP -Power on machine. - -.TP -\fBoff \fP -Power off machine. - -.TP -\fBreboot \fP -Reboot machine. - -.TP -\fBstatus \fP -This returns the status of the plug/virtual machine. - -.TP -\fBlist \fP -List available plugs with aliases/virtual machines if there is support for more then one device. Returns N/A otherwise. - -.TP -\fBmonitor \fP -Check if fencing device is running. List available plugs/virtual machines or get status of machine (if it does not support more). - -.TP -\fBmetadata \fP - The operational behavior of this is not known. - -.SH STDIN PARAMETERS - - -.TP -.B action -. -Fencing Action (Default Value: reboot) - -.TP -.B ipaddr -. -IP Address or Hostname This parameter is always required. - -.TP -.B login -. -Login Name This parameter is always required. - -.TP -.B passwd -. -Login password or passphrase - -.TP -.B passwd_script -. -Script to retrieve password - -.TP -.B ssl -. -SSL connection - -.TP -.B inet4_only -. -Forces agent to use IPv4 addresses only - -.TP -.B inet6_only -. -Forces agent to use IPv6 addresses only - -.TP -.B ipport -. -TCP port to use for connection with device - -.TP -.B port -. -Physical plug number or name of virtual machine This parameter is always required. - -.TP -.B verbose -. -Verbose mode - -.TP -.B debug -. -Write debug information to given file - -.TP -.B version -. -Display version information and exit - -.TP -.B help -. -Display help and exit - -.TP -.B separator -. -Separator for CSV created by operation list (Default Value: ,) - -.TP -.B power_wait -. -Wait X seconds after issuing ON/OFF (Default Value: 0) - -.TP -.B power_timeout -. -Test X seconds for status change after ON/OFF (Default Value: 20) - -.TP -.B shell_timeout -. -Wait X seconds for cmd prompt after issuing command (Default Value: 3) - -.TP -.B retry_on -. -Count of attempts to retry power on (Default Value: 1) - -.TP -.B delay -. -Wait X seconds before fencing is started (Default Value: 0) diff --git a/fence/man/fence_eps.8 b/fence/man/fence_eps.8 deleted file mode 100644 index 3685837..0000000 --- a/fence/man/fence_eps.8 +++ /dev/null @@ -1,106 +0,0 @@ -.TH fence_eps 8 - -.SH NAME -fence_eps - I/O Fencing agent for ePowerSwitch 8M+ power switch - -.SH SYNOPSIS -.B -fence_eps -[\fIOPTION\fR]... - -.SH DESCRIPTION -fence_eps is an I/O Fencing agent which can be used with the ePowerSwitch 8M+ power -switch to fence connected machines. Fence agent works (in 2008/10/21) ONLY on 8M+ -device, because this is only one, which has support for hidden page feature. - -Agent basically works by connecting to hidden page and pass appropriate arguments -to GET request. This means, that hidden page feature must be enabled and properly -configured. - -fence_eps accepts options on the command line as well as from stdin. -Fenced sends parameters through stdin when it execs the agent. fence_eps -can be run by itself with command line options. This is useful for testin -and for turning outlets on or off from scripts. - -.SH OPTIONS -.TP -\fB-a\fP \fIIPaddress\fR -IP address or hostname of ePowerSwitch 8M+ device. If device is configured -to listen on nonstandard port (other than 80), it's possible to use :port syntax -(ex. psip:8080). -.TP -\fB-h\fP -Print out a help message describing available options, then exit. -.TP -\fB-l\fP \fIlogin\fR -Login name. -.TP -\fB-o\fP \fIaction\fR -The action required. This can be reboot (default), status, off or on. -.TP -\fB-p\fP \fIpassword\fR -Password for login. -.TP -\fB-S\fP \fIscript\fR -Script to run to retrieve password. -.TP -\fB-n\fP \fIname\fR -Physical plug number. Entered without P and with preceding zero (where is needed). -.TP -\fB-c\fP \fIname\fR -Name of hidden page. Default is (hidden.htm) -.TP -\fB-T\fP -Test only. Answer NO to the confirmation prompt instead of YES. -.TP -\fB-q\fP -Quiet mode. -.TP -\fB-v\fP -Verbose. Record session to stdout, or debug file if specified (see -D). -.TP -\fB-D\fP -Specifies file, where will be written debug messages from session. -.TP -\fB-V\fP -Print out a version message, then exit. - -.SH STDIN PARAMETERS -.TP -\fIagent = < param >\fR -This option is used by fence_node(8) and is ignored by fence_eps. -.TP -\fIipaddr = < hostname | ip >\fR -IP address or hostname of ePowerSwitch 8M+ device. If device is configured -to listen on nonstandard port (other than 80), it's possible to use :port syntax -(ex. psip:8080). -.TP -\fIlogin = < param >\fR -Login name. -.TP -\fIoption = < param >\fR -The action required. This can be reboot (default), status, off or on. -.TP -\fIpasswd = < param >\fR -Password for login. -.TP -\fIpasswd_script = < param >\fR -Script to run to retrieve password. -.TP -\fIport = < param >\fR -Physical plug number. Entered without P and with preceding zero (where is needed) -.TP -\fIhidden_page = < param >\fR -Name of hidden page. Default is (hidden.htm) -.TP -\fItest = < param >\fR -Test only. Answer NO to the confirmation prompt instead of YES. -.TP -\fIverbose = < param >\fR -Verbose. Record session to stdout, or debug file if specified (see debug). -.TP -\fIdebug = < param >\fR -Specifies file, where will be written debug messages from session. - -.SH SEE ALSO -fence(8), fence_node(8) diff --git a/fence/man/fence_ibmblade.8 b/fence/man/fence_ibmblade.8 deleted file mode 100644 index 5d1b1ba..0000000 --- a/fence/man/fence_ibmblade.8 +++ /dev/null @@ -1,68 +0,0 @@ -." Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved. -." Copyright (C) 2004 Red Hat, Inc. All rights reserved. -." -." 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. - -.TH fence_ibmblade 8 - -.SH NAME -fence_ibmblade - I/O Fencing agent for IBM BladeCenter - -.SH SYNOPSIS -.B -fence_ibmblade -[\fIOPTION\fR]... - -.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. - -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. - -.SH OPTIONS -.TP -\fB-a\fP \fIIPaddress\fP -IP address of the BladeCenter chassis. -.TP -\fB-h\fP -Print out a help message describing available options, then exit. -.TP -\fB-c\fP \fIcommunity\fP -SNMP community string to use. -.TP -\fB-n\fP \fIport\fP -The Blade port number to disable. -.TP -\fB-o\fP \fIaction\fP -The action required. Reboot (default), On or off. -.TP -\fB-q\fP -Quiet mode: print only error messages. -.TP -\fB-V\fP -Print out a version message, then exit. - -.SH STDIN PARAMETERS -.TP -\fIagent = < param >\fR -This option is used by fence_node(8) and is ignored by fence_ibmblade. -.TP -\fIipaddr = < hostname | ip >\fR -IP address or hostname of the switch. -.TP -\fIcommunity = < param >\fR -SNMP community. -.TP -\fIoption = < param >\fR -The action required. reboot (default), on or off. -.TP -\fIport = < param >\fR -The Blade port number to disable. - -.SH SEE ALSO -fence(8), fence_node(8) diff --git a/fence/man/fence_ifmib.8 b/fence/man/fence_ifmib.8 deleted file mode 100644 index 914d43a..0000000 --- a/fence/man/fence_ifmib.8 +++ /dev/null @@ -1,323 +0,0 @@ - -.TH FENCE_AGENT 8 2009-10-20 "fence_ifmib (Fence Agent)" -.SH NAME -fence_ifmib - Fence agent for IF MIB -.SH DESCRIPTION -.P -fence_ifmib is an I/O Fencing agent which can be used with any SNMP IF-MIB capable device. -.P -It was written with managed ethernet switches in mind, in order to fence iSCSI SAN connections. However, there are many devices that support the IF-MIB interface. The agent uses IF-MIB::ifAdminStatus to control the state of an interface. -.P -fence_ifmib accepts options on the command line as well -as from stdin. Fenced sends parameters through stdin when it execs the -agent. fence_ifmib can be run by itself with command -line options. This is useful for testing and for turning outlets on or off -from scripts. - -Vendor URL: http://www.ietf.org/wg/concluded/ifmib.html -.SH PARAMETERS - - -.TP -.B -o, --action=<action> -. -Fencing Action (Default Value: reboot) - -.TP -.B -a, --ip=<ip> -. -IP Address or Hostname This parameter is always required. - -.TP -.B -l, --username=<name> -. -Login Name - -.TP -.B -p, --password=<password> -. -Login password or passphrase - -.TP -.B -S, --password-script=<script> -. -Script to retrieve password - -.TP -.B -n, --plug=<id> -. -Physical plug number or name of virtual machine This parameter is always required. - -.TP -.B -d, --snmp-version=<ver> -. -Specifies SNMP version to use (1,2c,3) - -.TP -.B -c, --community=<community> -. -Set the community string - -.TP -.B -b, --snmp-auth-prot=<prot> -. -Set authentication protocol (MD5|SHA) - -.TP -.B -E, --snmp-sec-level=<level> -. -Set security level (noAuthNoPriv|authNoPriv|authPriv) - -.TP -.B -B, --snmp-priv-prot=<prot> -. -Set privacy protocol (DES|AES) - -.TP -.B -P, --snmp-priv-passwd=<pass> -. -Set privacy protocol password - -.TP -.B -R, --snmp-priv-passwd-script -. -Script to run to retrieve privacy password - -.TP -.B -u, --udpport -. -UDP/TCP port to use for connection with device (Default Value: 161) - -.TP -.B -4, --inet4-only -. -Forces agent to use IPv4 addresses only - -.TP -.B -6, --inet6-only -. -Forces agent to use IPv6 addresses only - -.TP -.B -v, --verbose -. -Verbose mode - -.TP -.B -D, --debug-file=<debugfile> -. -Write debug information to given file - -.TP -.B -V, --version -. -Display version information and exit - -.TP -.B -h, --help -. -Display help and exit - -.TP -.B -C, --separator=<char> -. -Separator for CSV created by operation list (Default Value: ,) - -.TP -.B --power-timeout -. -Test X seconds for status change after ON/OFF (Default Value: 20) - -.TP -.B --shell-timeout -. -Wait X seconds for cmd prompt after issuing command (Default Value: 3) - -.TP -.B --login-timeout -. -Wait X seconds for cmd prompt after login (Default Value: 5) - -.TP -.B --power-wait -. -Wait X seconds after issuing ON/OFF (Default Value: 0) - -.TP -.B --retry-on -. -Count of attempts to retry power on (Default Value: 1) - -.TP -.B --delay -. -Wait X seconds before fencing is started (Default Value: 0) - -.SH ACTIONS - - -.TP -\fBon \fP -Power on machine. - -.TP -\fBoff \fP -Power off machine. - -.TP -\fBreboot \fP -Reboot machine. - -.TP -\fBstatus \fP -This returns the status of the plug/virtual machine. - -.TP -\fBlist \fP -List available plugs with aliases/virtual machines if there is support for more then one device. Returns N/A otherwise. - -.TP -\fBmonitor \fP -Check if fencing device is running. List available plugs/virtual machines or get status of machine (if it does not support more). - -.TP -\fBmetadata \fP - The operational behavior of this is not known. - -.SH STDIN PARAMETERS - - -.TP -.B action -. -Fencing Action (Default Value: reboot) - -.TP -.B ipaddr -. -IP Address or Hostname This parameter is always required. - -.TP -.B login -. -Login Name - -.TP -.B passwd -. -Login password or passphrase - -.TP -.B passwd_script -. -Script to retrieve password - -.TP -.B port -. -Physical plug number or name of virtual machine This parameter is always required. - -.TP -.B snmp_version -. -Specifies SNMP version to use (1,2c,3) - -.TP -.B community -. -Set the community string - -.TP -.B snmp_auth_prot -. -Set authentication protocol (MD5|SHA) - -.TP -.B snmp_sec_level -. -Set security level (noAuthNoPriv|authNoPriv|authPriv) - -.TP -.B snmp_priv_prot -. -Set privacy protocol (DES|AES) - -.TP -.B snmp_priv_passwd -. -Set privacy protocol password - -.TP -.B snmp_priv_passwd_script -. -Script to run to retrieve privacy password - -.TP -.B udpport -. -UDP/TCP port to use for connection with device (Default Value: 161) - -.TP -.B inet4_only -. -Forces agent to use IPv4 addresses only - -.TP -.B inet6_only -. -Forces agent to use IPv6 addresses only - -.TP -.B verbose -. -Verbose mode - -.TP -.B debug -. -Write debug information to given file - -.TP -.B version -. -Display version information and exit - -.TP -.B help -. -Display help and exit - -.TP -.B separator -. -Separator for CSV created by operation list (Default Value: ,) - -.TP -.B power_timeout -. -Test X seconds for status change after ON/OFF (Default Value: 20) - -.TP -.B shell_timeout -. -Wait X seconds for cmd prompt after issuing command (Default Value: 3) - -.TP -.B login_timeout -. -Wait X seconds for cmd prompt after login (Default Value: 5) - -.TP -.B power_wait -. -Wait X seconds after issuing ON/OFF (Default Value: 0) - -.TP -.B retry_on -. -Count of attempts to retry power on (Default Value: 1) - -.TP -.B delay -. -Wait X seconds before fencing is started (Default Value: 0) diff --git a/fence/man/fence_ilo.8 b/fence/man/fence_ilo.8 deleted file mode 100644 index a2dd038..0000000 --- a/fence/man/fence_ilo.8 +++ /dev/null @@ -1,95 +0,0 @@ -." Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved. -." Copyright (C) 2004 Red Hat, Inc. All rights reserved. -." -." 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. - -.TH fence_ilo 8 - -.SH NAME -fence_ilo - I/O Fencing agent for HP Integrated Lights Out card - -.SH SYNOPSIS -.B -fence_ilo -[\fIOPTION\fR]... - -.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. - -fence_ilo depends on the pyOpenSSL available in your distribution or -downloadable from http://pyopenssl.sourceforge.net - -NOTE: fence_ilo deprecates fence_rib. - -.SH OPTIONS -.TP -\fB-a\fP \fIIPaddress[:port]\fR -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. -.TP -\fB-h\fP -Print out a help message describing available options, then exit. -.TP -\fB-l\fP \fIlogin\fR -Login name. -.TP -\fB-o\fP \fIaction\fR -The action required. reboot (default), off, on or status. -.TP -\fB-p\fP \fIpassword\fR -Password for login or for passphrase. -.TP -\fB-S\fP \fIscript\fR -Script to run to retrieve password. -\fB-z\fP -Use secure connection over SSL (default). -.TP -\fB-r\fP \fIprotocol\fR -RIBCL protocol to use. Default is to autodetect. -.TP -\fB-v\fP -Verbose. -.TP -\fB-V\fP -Print out a version message, then exit. - -.SH STDIN PARAMETERS -.TP -\fIaction = < param >\fR -The action required. reboot (default), off, on or status. -.TP -\fIagent = < param >\fR -This option is used by fence_node(8) and is ignored by fence_ilo. -.TP -\fIhostname = < hostname | ip >\fR -IP address or hostname of the iLO card. -.TP -\fIlogin = < param >\fR -Login name. -.TP -\fIpasswd = < param >\fR -Password for login or for passphrase. -.TP -\fIpasswd_script = < param >\fR -Script to run to retrieve password. -.TP -\fIssl = < param >\fR -Use secure connection over SSL. -.TP -\fIpasswd = < param >\fR -Password for login. -.TP -\fIribcl = < param >\fR -RIBCL protocol to use. Default is to autodetect. -.TP -\fIverbose = < param >\fR -Verbose mode. - -.SH SEE ALSO -fence(8), fence_node(8), fence_rib(8) diff --git a/fence/man/fence_ipmilan.8 b/fence/man/fence_ipmilan.8 deleted file mode 100644 index 9b10198..0000000 --- a/fence/man/fence_ipmilan.8 +++ /dev/null @@ -1,111 +0,0 @@ -." Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved. -." Copyright (C) 2004 Red Hat, Inc. All rights reserved. -." -." 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. - -.TH fence_ipmilan 8 - -.SH NAME -fence_ipmilan - I/O Fencing agent for machines controlled by IPMI over -LAN. - -.SH SYNOPSIS -.B -fence_ipmilan -[\fIOPTION\fR]... - -.SH DESCRIPTION -fence_ipmilan is an I/O Fencing agent which can be used with -machines controlled by IPMI. This agent calls support software -using ipmitool (http://ipmitool.sf.net/). - -fence_ipmilan accepts options on the command line as well as from stdin. -fenced sends the options through stdin when it execs the agent. fence_ipmilan -can be run by itself with command line options which is useful for testing. - -.SH OPTIONS -.TP -\fB-a\fP \fIIPaddress\fP -IP address or hostname of the IPMI controller. -.TP -\fB-h\fP -Print out a help message describing available options, then exit. -.TP -\fB-l\fP \fIlogin\fP -Login (if required) with administrative privileges. -.TP -\fB-o\fP \fIoption\fP -Action to perform (on, off, reboot). -.TP -\fB-p\fP \fIpassword\fP -Password (if required) for login. -.TP -\fB-P\fP -Use the lanplus option if this is a lanplus capable interface (for example iLo2) -.TP -\fB-A\fP \fIAuthentication Type\fP -Can be set to none, password, md2, or md5. -.TP -\fB-C\fP \fICiphersuite Type\fP -If you are using lanplus, this option avails you to define type of ciphersuite to -use. Standard is 3 (defined if you just use lanplus). For more information please -refer ipmitool man page (option -C). -.TP -\fB-M\fP \fImethod\fP -Method to fence (onoff or cycle). Default is onoff. Use cycle in case your management -card will power off with default method so there will be no chance to power machine -on by IPMI. -.TP -\fB-t\fP \fItimeout\fP -Timeout in seconds for IPMI operation. Default is 10, but in some cases it -must be set to higher value (anything above 30 is not recommended and may -cause strange problems). -.TP -\fB-q\fP -Quiet operation. Only print out error messages. -.TP -\fB-V\fP -Print out a version message, then exit. -.TP -\fB-v\fP -Verbose mode. - -.SH STDIN PARAMETERS -.TP -\fIipaddr = < hostname | ip >\fR -IP address or hostname of the IPMI controller. -.TP -\fIlogin= < param >\fR -Login (if required) with administrative privileges. -.TP -\fIoption = < param >\fR -Action to perform (on, off, reboot). -.TP -\fIpasswd = < param >\fR -Password (if required) for login. -.TP -\fIauth = < param >\fR -Authentication type (none, password, md2, md5). -.TP -\fItimeout = < param >\fR -Timeout in seconds for IPMI operation. Default is 10, but in some cases it -must be set to higher value (anything above 30 is not recommended and may -cause strange problems). -.TP -\fIcipher = < param >\fR -If you are using lanplus, this option avails you to define type of ciphersuite to -use. Standard is 3 (defined if you just use lanplus). For more information please -refer ipmitool man page (option -C). -.TP -\fImethod = < param >\fR -Method to fence (onoff or cycle). Default is onoff. Use cycle in case your management -card will power off with default method so there will be no chance to power machine -on by IPMI. -.TP -\fIlanplus\fR -If we are using the lanplus option for ipmitool - -.SH SEE ALSO -fence(8), fence_node(8), ipmitool(1) diff --git a/fence/man/fence_lpar.8 b/fence/man/fence_lpar.8 deleted file mode 100644 index b4de871..0000000 --- a/fence/man/fence_lpar.8 +++ /dev/null @@ -1,116 +0,0 @@ -." Copyright (C) 2009 Red Hat, Inc. All rights reserved. -." -." 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. - -.TH fence_lpar 8 - -.SH NAME -fence_lpar - I/O Fencing agent for IBM Power Systems - -.SH SYNOPSIS -.B -fence_lpar -[\fIOPTION\fR]... - -.SH DESCRIPTION -fence_lpar is an I/O Fencing agent which can be used with IBM Power Systems. -It logs into the HMC via ssh and uses the command line interface to operate -LPARs. - -fence_lpar accepts options on the command line as well as from stdin. Fenced -sends parameters through stdin when it execs the agent. fence_lpar can be run -by itself with command line options. This is useful for testing and for -stopping and starting LPARs from scripts. - -.SH OPTIONS -.TP -\fB-a\fP \fIIPaddress\fR -IP address or hostname of the HMC. -.TP -\fB-c\fP \fIprompt\fR -Select command prompt. Default: :~>, ] -.TP -\fB-D\fP \fIdebugfile\fR -Write debug information to given file. -.TP -\fB-h\fP -Print out a help message describing available options, then exit. -.TP -\fB-H\fP \fIversion\fR -Select an HMC version to use: 3 or 4 (default). -.TP -\fB-l\fP \fIlogin\fR -Login name. -.TP -\fB-n\fP \fIname\fR -Partition name. -.TP -\fB-o\fP \fIaction\fR -The action required. Reboot (default), Status, Off or On. -.TP -\fB-p\fP \fIpassword\fR -Password for login. -.TP -\fB-s\fP \fIname\fR -Managed system name. -.TP -\fB-S\fP \fIscript\fR -Script to run to retrieve password. -.TP -\fB-x\fP -Use secure connection over ssh. -.TP -\fB-v\fP -Verbose mode. -.TP -\fB-V\fP -Print out a version message, then exit. - -.SH STDIN PARAMETERS -.TP -\fIaction = < param >\fR -The fencing action requested: reboot (default), on, off or status. -.TP -\fIcmd_prompt = < param >\fR -Force command prompt. Default: :~>, ] -.TP -\fIdebug = < param >\fR -Write debug information to given file. -.TP -\fIhelp = < param >\fR -Display help and exit. -.TP -\fIhmc_version = < param >\fR -HMC version to use: 3 or 4 (default). -.TP -\fIipaddr = < hostname | ip >\fR -IP address or hostname of the HMC. -.TP -\fIlogin = < param >\fR -Login name. -.TP -\fImanaged = < param >\fR -Managed system name. -.TP -\fIpartition = < param >\fR -Partition name. -.TP -\fIpasswd = < param >\fR -Password for login. -.TP -\fIpasswd_script = < param >\fR -Script to run to retrieve password. -.TP -\fIsecure\fR -Use secure connection over ssh. -.TP -\fIverbose\fR -Verbose mode. -.TP -\fIversion\fR -Display version information and exit. - -.SH SEE ALSO -fence(8), fence_node(8) diff --git a/fence/man/fence_rsa.8 b/fence/man/fence_rsa.8 deleted file mode 100644 index 0ba1744..0000000 --- a/fence/man/fence_rsa.8 +++ /dev/null @@ -1,69 +0,0 @@ -." Copyright (C) 2006 Red Hat, Inc. All rights reserved. -." -." 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. - -.TH fence_rsa 8 - -.SH NAME -fence_rsa - I/O Fencing agent for IBM RSA II - -.SH SYNOPSIS -.B -fence_rsa -[\fIOPTION\fR]... - -.SH DESCRIPTION -fence_rsa is an I/O Fencing agent which can be used with the IBM RSA II -management interface. It logs into an RSA II device via telnet and reboots -the associated machine. Lengthy telnet connections to the RSA II device -should be avoided while a GFS cluster is running because the connection -will block any necessary fencing actions. - -fence_rsa accepts options on the command line as well as from stdin. -Fenced sends parameters through stdin when it execs the agent. fence_rsa -can be run by itself with command line options. This is useful for testing. - -.SH OPTIONS -.TP -\fB-a\fP \fIIPaddress\fR -IP address or hostname of the RSA II device. -.TP -\fB-h\fP -Print out a help message describing available options, then exit. -.TP -\fB-l\fP \fIlogin\fR -Login name. -.TP -\fB-o\fP \fIaction\fR -The action required. Reboot (default), Off, On, or Status. -.TP -\fB-p\fP \fIpassword\fR -Password for login. -.TP -\fB-v\fP -Verbose. Print informational messages to standard out. -.TP -\fB-V\fP -Print out a version message, then exit. - -.SH STDIN PARAMETERS -.TP -\fIagent = < param >\fR -This option is used by fence_node(8) and is ignored by fence_rsa. -.TP -\fIipaddr = < hostname | ip >\fR -IP address or hostname of the device. -.TP -\fIlogin = < param >\fR -Login name. -.TP -\fIoption = < param >\fR -The action required. Reboot (default), Off, On or Status. -.TP -\fIpasswd = < param >\fR -Password for login. - -.SH SEE ALSO -fence(8), fence_node(8) diff --git a/fence/man/fence_sanbox2.8 b/fence/man/fence_sanbox2.8 deleted file mode 100644 index 46209f8..0000000 --- a/fence/man/fence_sanbox2.8 +++ /dev/null @@ -1,83 +0,0 @@ -." Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved. -." Copyright (C) 2004 Red Hat, Inc. All rights reserved. -." -." 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. - -.TH fence_sanbox2 8 - -.SH NAME -fence_sanbox2 - I/O Fencing agent for QLogic SANBox2 FC switches - -.SH SYNOPSIS -.B -fence_sanbox2 -[\fIOPTION\fR]... - -.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. - -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. - -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. - -.SH OPTIONS -.TP -\fB-a\fP \fIIPaddress\fP -IP address of the switch. -.TP -\fB-h\fP -Print out a help message describing available options, then exit. -.TP -\fB-l\fP \fIlogin\fP -Login name for the switch. -.TP -\fB-n\fP \fIport\fP -The port number to disable on the switch. -.TP -\fB-o\fP \fIaction\fP -The action required. disable (default) or enable. -.TP -\fB-p\fP \fIpassword\fP -Password for login. -.TP -\fB-q\fP -Quiet mode: print only error messages. -.TP -\fB-V\fP -Print out a version message, then exit. - -.SH STDIN PARAMETERS -.TP -\fIagent = < param >\fR -This option is used by fence_node(8) and is ignored by fence_sanbox2. -.TP -\fIipaddr = < hostname | ip >\fR -IP address or hostname of the switch. -.TP -\fIlogin = < param >\fR -Login name. -.TP -\fIoption = < param >\fR -The action required. disable (default) or enable. -.TP -\fIpasswd = < param >\fR -Password for login. -.TP -\fIport = < param >\fR -The port number to disable on the switch. - -.SH SEE ALSO -fence(8), fence_node(8) diff --git a/fence/man/fence_vmware.8 b/fence/man/fence_vmware.8 deleted file mode 100644 index 31ea5f8..0000000 --- a/fence/man/fence_vmware.8 +++ /dev/null @@ -1,137 +0,0 @@ -." Copyright (C) 2008 Red Hat, Inc. All rights reserved. -." -." 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. - -.TH fence_vmware 8 - -.SH NAME -fence_vmware - I/O Fencing agent for VMware virtual machines - -.SH SYNOPSIS -.B -fence_vmware -[\fIOPTION\fR]... - -.SH DESCRIPTION -fence_vmware is an I/O Fencing agent which can be used with the VMware ESX or -VMware Server to fence virtual machines. It logs via ssh to a VMware ESX (or Server) -physical machine and there run vmware-cmd, which does all work. - -By default, VMware ESX has disabled root account so you must create annother user -account with limited permissions on VMWare ESX machine. - -Better idea is install right version of vmware-cmd (with same API) to any other machine -in network and use it for fencing. - -fence_vmware accepts options on the command line as well as from stdin. -Fenced sends parameters through stdin when it execs the agent. fence_vmware -can be run by itself with command line options. This is useful for testing -and for turning outlets on or off from scripts. - -.SH OPTIONS -.TP -\fB-a\fP \fIIPaddress\fR -IP address or hostname of machine where is vmware-cmd. -.TP -\fB-A\fP \fIIPAdress\fR -IP adress or hostname of machine where is runing vmware. Default is localhost. -.TP -\fB-h\fP -Print out a help message describing available options, then exit. -.TP -\fB-l\fP \fIlogin\fR -Login name of machine with vmware-cmd. -.TP -\fB-L\fP \fIlogin\fR -Login name to VMware administration interface. -.TP -\fB-o\fP \fIaction\fR -The action required. Reboot (default), Status, Off or On. -.TP -\fB-p\fP \fIpassword\fR -Password for login or for passphrase for machine with vmware-cmd. -.TP -\fB-P\fP \fIpassword\fR -Password for login to VMware administration interface. -.TP -\fB-B\fP \fIscript\fR -Script to run to retrieve password for machine with vmware-cmd. -.TP -\fB-R\fP \fIscript\fR -Script to run to retrieve password for VMware administration interface. -.TP -\fB-n\fP \fIname\fR -Name of virtual machine to fence (ie. /vmfs/volumes/48bfcbd1-4624461c-8250-0015c5f3ef0f/Rhel/Rhel.vmx) -.TP -\fB-x\fP -Use secure connection over ssh (this is default, and can't be disabled) -.TP -\fB-k\fP \fIfilename\fR -Identity file (private key) for ssh -.TP -\fB-T\fP -Test only. Answer NO to the confirmation prompt instead of YES. -.TP -\fB-v\fP -Verbose. Record session to stdout, or debug file if specified (see -D). -.TP -\fB-D\fP -Specifies file, where will be written debug messages from session. -.TP -\fB-V\fP -Print out a version message, then exit. - -.SH STDIN PARAMETERS -.TP -\fIagent = < param >\fR -This option is used by fence_node(8) and is ignored by fence_vmware. -.TP -\fIipaddr = < hostname | ip >\fR -IP address or hostname of machine where is vmware-cmd. -.TP -\fIvmipaddr = < hostname | ip >\fR -IP adress or hostname of machine where is runing vmware. Default is localhost. -.TP -\fIlogin = < param >\fR -Login name of machine with vmware-cmd. -.TP -\fIvmlogin = < param >\fR -Login name to VMware administration interface. -.TP -\fIoption = < param >\fR -The action required. Reboot (default), Off or On. -.TP -\fIpasswd = < param >\fR -Password for login or for passphrase for machine with vmware-cmd. -.TP -\fIvmpasswd = < param >\fR -Password for login to VMware administration interface. -.TP -\fIpasswd_script = < param >\fR -Script to run to retrieve password for machine with vmware-cmd. -.TP -\fIvmpasswd_script = < param >\fR -Script to run to retrieve password for VMware administration interface. -.TP -\fIport = < param >\fR -Name of virtual machine to fence (ie. /vmfs/volumes/48bfcbd1-4624461c-8250-0015c5f3ef0f/Rhel/Rhel.vmx) -.TP -\fIsecure = < param >\fR -Use secure connection over ssh (this is default, and can't be disabled) -.TP -\fIidentity_file = < param >\fR -Identity file (private key) for ssh -.TP -\fItest = < param >\fR -Test only. Answer NO to the confirmation prompt instead of YES. -.TP -\fIverbose = < param >\fR -Verbose. Record session to stdout, or debug file if specified (see debug). -.TP -\fIdebug = < param >\fR -Specifies file, where will be written debug messages from session. - -.SH SEE ALSO -fence(8), fence_node(8) diff --git a/fence/man/fence_wti.8 b/fence/man/fence_wti.8 deleted file mode 100644 index 1b1d231..0000000 --- a/fence/man/fence_wti.8 +++ /dev/null @@ -1,84 +0,0 @@ -." Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved. -." Copyright (C) 2004 Red Hat, Inc. All rights reserved. -." -." 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. - -.TH fence_wti 8 - -.SH NAME -fence_wti - I/O Fencing agent for WTI Network Power Switch - -.SH SYNOPSIS -.B -fence_wti -[\fIOPTION\fR]... - -.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 or ssh 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. - -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. - -.SH OPTIONS -.TP -\fB-a\fP \fIIPaddress\fP -IP address of the switch. -.TP -\fB-h\fP -Print out a help message describing available options, then exit. -.TP -\fB-n\fP \fIplug\fP -The plug number to power cycle. -.TP -\fB-p\fP \fIpassword\fP -Password for login or for passphrase. -.TP -\fB-S\fP \fIscript\fR -Script to run to retrieve password. -.TP -\fB-x\fP -Use secure connection over ssh. -.TP -\fB-T\fP -Test only. Do not power cycle. Reports state of the plug. -.TP -\fB-q\fP -Quiet operation. Only print out error messages. -.TP -\fB-V\fP -Print out a version message, then exit. - -.SH STDIN PARAMETERS -.TP -\fIagent = < param >\fR -This option is used by fence_node(8) and is ignored by fence_wti. -.TP -\fIipaddr = < hostname | ip >\fR -IP address or hostname of the switch. -.TP -\fIpasswd = < param >\fR -Password for login or for passphrase. -.TP -\fIpasswd_script = < param >\fR -Script to run to retrieve password. -.TP -\fIidentity_file = < param > \fR -Identity file (private key) for ssh. -.TP -\fIsecure = < param >\fR -Use secure connection over ssh. -.TP -\fIport = < param >\fR -The outlet number to act upon. -.TP -\fItest = < param >\fR -Test only. Answer NO to the confirmation prompt instead of YES. - -.SH SEE ALSO -fence(8), fence_node(8)