From mboxrd@z Thu Jan 1 00:00:00 1970 From: lhh@sourceware.org Date: 26 Jan 2007 22:18:27 -0000 Subject: [Cluster-devel] cluster/magma/man magma_tool.8 Message-ID: <20070126221827.22971.qmail@sourceware.org> List-Id: To: cluster-devel.redhat.com MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit CVSROOT: /cvs/cluster Module name: cluster Branch: RHEL4 Changes by: lhh at sourceware.org 2007-01-26 22:18:23 Modified files: magma/man : magma_tool.8 Log message: Fix markup for magma_tool man page; fix from Eric S. Raymond Patches: http://sourceware.org/cgi-bin/cvsweb.cgi/cluster/magma/man/magma_tool.8.diff?cvsroot=cluster&only_with_tag=RHEL4&r1=1.1.2.1&r2=1.1.2.2 --- cluster/magma/man/Attic/magma_tool.8 2005/01/28 19:36:18 1.1.2.1 +++ cluster/magma/man/Attic/magma_tool.8 2007/01/26 22:18:13 1.1.2.2 @@ -3,166 +3,96 @@ .\" 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 'magma_tool(8)''magma_tool(8)' -'\" View with 'groff -t -e -mandoc -Tlatin1 ccs_tool.8 | less' - -\fBNAME\fP -.in +7 +.TH magma_tool 8 +.SH NAME magma_tool - Magma API test program -.in -\fBSYNOPSIS\fP -.in +7 -\fBmagma_tool\fP <\fBcommand\fP> -.sp -.in -\fBDESCRIPTION\fP -.in +7 +.SH SYNOPSIS\fP +\fBmagma_tool\fP \fIcommand\fP + +.SH DESCRIPTION\fP \fBmagma_tool\fP is part of the Magma cluster API abstraction library. Its primary purpose is for API debugging and tweaking; it does not control anything and has no configuration information to speak of. -.sp -.in -\fBOPTIONS\fP -.in +7 +.SH OPTIONS +.TP \fB-h\fP -.in +7 Help. Print out the usage. -.sp -.in -.in -7 -\fBPLUGIN COMMANDS\fP -.in +7 +.SH PLUGIN COMMANDS +.TP \fBlist\fP -.in +7 This command is used to list plugins and other files in Magma's plugin directory and whether or not they are legal plugins. This will list all non-directory files in Magma's plugin directory, whether or not they are legal plugins, and why. - -.sp -.in +.TP \fBenable\fP \fI\fP -.in +7 This command is used to enable a plugin in Magma's plugin directory. It is synonymous with "chmod u+r ". Files without in the plugin directory without the user-readable bit set (S_IRUSR) are ignored. - -.sp -.in +.TP \fBdisable\fP \fI\fP -.in +7 This command is used to disable a plugin in Magma's plugin directory. It is synonymous with "chmod u+r ". Files without in the plugin directory without the user-readable bit set (S_IRUSR) are ignored. -.sp -.in - -.in -7 -\fBAPI TEST COMMANDS\fP -.in +7 +.SH API TEST COMMANDS\fP These commands may all be preceded by the option \fIlogin\fP. If specified, magma_tool will log in to the service/node group on cluster infrastructures where this notion is supported. - -.sp +.TP \fBlock\fP \fI[resource]\fP -.in +7 This causes magma_tool to connect to the underlying cluster infrastructure and/or lock manager and acquire a clusterlock. If \fI[resource]\fP is not specified, then the name "Something" is used. - -.sp -.in +.TP \fBlisten\fP \fI[group]\fP -.in +7 This causes magma_tool to connect to the underlying cluster infrastructure and/or lock manager and listen for events in the group \fI[group]\fP. This is only useful with the \fIlogin\fP flag. - -.sp -.in +.TP \fBlocalname\fP \fI[group]\fP -.in +7 This causes magma_tool to connect to the underlying cluster infrastructure and/or lock manager and request the local node name, which it then displays. - -.sp -.in +.TP \fBlocalid\fP \fI[group]\fP -.in +7 This causes magma_tool to connect to the underlying cluster infrastructure and/or lock manager and request the local node ID, which it then displays. - -.sp -.in +.TP \fBmembers\fP \fI[group]\fP -.in +7 This causes magma_tool to connect to the underlying cluster infrastructure and/or lock manager and request the list of members, which it then displays. If \fI[group]\fP is specified, then only the members of the given service or node group are listed. - -.sp -.in +.TP \fBquorum\fP \fI[group]\fP -.in +7 This causes magma_tool to connect to the underlying cluster infrastructure and/or lock manager and request the local node's quorum status as well as whether or not it is a member of \fI[group]\fP. - - -.sp -.in +.TP \fBconfig\fP \fI\fP -.in +7 This displays compile-time information; see below. -.sp -.in - -.in -7 -\fBCONFIGURATION\fP -.in +7 +.SH CONFIGURATION +.TP \fBconfig cflags\fP -.in +7 Displays the compiler flags needed to build applications against Magma. - -.sp -.in +.TP \fBconfig libs\fP -.in +7 Displays the compiler linker flags needed to build applications against Magma. - -.sp -.in +.TP \fBconfig libs-nt\fP -.in +7 Displays the compiler linker flags needed to build applications against -Magma's lightweight, mostly-reentrant library.. - -.sp -.in +Magma's lightweight, mostly-reentrant library. +.TP \fBconfig plugindir\fP -.in +7 Displays directory Magma uses for plugins. - -.sp -.in +.TP \fBconfig libdir\fP -.in +7 Displays where Magma's dynamic libraries reside. - -.sp -.in +.TP \fBconfig slibdir\fP -.in +7 Displays where Magma's static libraries reside. - -.sp -.in