xgridctl

NAME
     xgridctl -- Xgrid daemons control interface

SYNOPSIS
     xgridctl status target on|off|start|stop|restart

OPTIONS
     The available options are as follows:

     status                         print status of running daemons

     target                         affect c[ontroller] or a[gent] daemon

     on|off|start|stop|restart      turn on/off launching daemon at startup,
                                    or explicitly start/stop/restart daemon.
                                    Note that 'restart' will kill all
                                    instances of a given daemon, as will
                                    'stop' if none is specified in the pid
                                    file.

RETURN VALUES
     0 Completed succesfully.

     1 Target not recognized: use 'c' or 'a'.

     2 Action not recognized: use on|off|start|stop|restart

     10 Wrong number of arguments.

     20 Not run as root.

     30 Executables not found; may need to reinstall Xgrid.

     31 Process directory not found; may need to reinstall Mac OS X.

FILES
     /usr/libexec/xgrid/xgridagentd
             Xgrid agent daemon

     /usr/libexec/xgrid/xgridcontrollerd
             Xgrid controller daemon

     /var/run/xgridagentd.pid
             Xgrid agent process ID

     /var/run/xgridcontrollerd.pid
             Xgrid controller process ID

     /System/Library/LaunchDaemons/com.apple.xgridagentd.plist

     /System/Library/LaunchDaemons/com.apple.xgridcontrollerd.plist
             Launchd daemon control files

EXAMPLES
     status of xgrid agent daemon

           $ xgridctl agent status

     edit launchd configuration to launch controller on system startup

           $ xgridctl controller on

     kill current xgrid agent process

           $ xgridctl agent stop

DIAGNOSTICS
     Warning: Warning: ## copies of (controller|agent)d already running

     Trying to launch another daemon when one or more already running; will
            usually succeed, but may cause unpredictable behavior.
     See also RETURN VALUES, above.

ERRORS
     Error: failed to launch (executable)

     Tried to start/restart a give daemon, but failed.

     Error: process 'executable' not currently running

     Tried to kill a process which did not exist.

SEE ALSO
     xgrid(1) launchd(8)

HISTORY
     This program was first introduced in Mac OS X 10.4 "Tiger".  It was
     inspired by apachectl(8).

BUGS
     xgridctl(8) uses kill -TERM to allow the daemons a chance to die gracefully;
     there is currently no way to force a kill -KILL.

     Bug reports can be sent to bugreport.apple.com

     Feedback can be sent to xgrid@apple.com

Mac OS                        September 29, 2004                        Mac OS