Provided by: magma_1.20060222-0ubuntu5_i386 bug

NAME

       magma_tool - Magma API test program

SYNOPSIS

       magma_tool <command>

DESCRIPTION

       magma_tool  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.

       OPTIONS
              -h
                     Help.  Print out the usage.

       PLUGIN COMMANDS
              list
                     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.

              enable <filename>
                     This command is used to enable a plugin in Magma’s plugin
                     directory.  It is synonymous with "chmod u+r <filename>".
                     Files  without  in the plugin directory without the user-
                     readable bit set (S_IRUSR) are ignored.

              disable <filename>
                     This command is used  to  disable  a  plugin  in  Magma’s
                     plugin  directory.   It  is  synonymous  with  "chmod u+r
                     <filename>".   Files  without  in  the  plugin  directory
                     without  the user-readable bit set (S_IRUSR) are ignored.

       API TEST COMMANDS
              These commands may all be preceded  by  the  option  login.   If
              specified,  magma_tool  will log in to the service/node group on
              cluster infrastructures where this notion is supported.

              lock [resource]
                     This causes  magma_tool  to  connect  to  the  underlying
                     cluster  infrastructure and/or lock manager and acquire a
                     clusterlock.  If [resource] is not  specified,  then  the
                     name "Something" is used.

              listen [group]
                     This  causes  magma_tool  to  connect  to  the underlying
                     cluster infrastructure and/or lock manager and listen for
                     events  in  the  group [group].  This is only useful with
                     the login flag.

              localname [group]
                     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.

              localid [group]
                     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.

              members [group]
                     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  [group]
                     is  specified, then only the members of the given service
                     or node group are listed.

              quorum [group]
                     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 [group].

              config <item>
                     This displays compile-time information; see below.

       CONFIGURATION
              config cflags
                     Displays  the compiler flags needed to build applications
                     against Magma.

              config libs
                     Displays  the  compiler  linker  flags  needed  to  build
                     applications against Magma.

              config libs-nt
                     Displays  the  compiler  linker  flags  needed  to  build
                     applications   against   Magma’s   lightweight,   mostly-
                     reentrant library..

              config plugindir
                     Displays directory Magma uses for plugins.

              config libdir
                     Displays where Magma’s dynamic libraries reside.

              config slibdir
                     Displays where Magma’s static libraries reside.

                                                                 magma_tool(8)