DragonFly On-Line Manual Pages

Search: Section:  

PIDSTAT(1)            User Contributed Perl Documentation           PIDSTAT(1)


NAME

       pidstat - Check the existence of a process on a remote machine


SYNOPSIS

       pidstat [ --help ] [ --host=host ] [ --port=port ] [ --silent ] [
       --version ] [ --debug ] [ exists remotepids ]


DESCRIPTION

       Pidstat will contact the PID stat daemon (pidstatd, in the IPC::Locker
       distribution on CPAN) and perform the requested command(s).


COMMANDS

       exists remotepids
           Check the existence of a set of process IDs (potentially) on remote
           hosts.

           Takes a list of remote process IDs.  These process IDs are
           understood to be on the host specified by "--host" (default is
           "localhost").  Alternatively, the host may be overridden by
           specifying the process IDs in the form <hostname>:<pid>.

           The exit value is 0 if all the requested process IDs exist.  The
           exit value is 1 if any of the requested process IDs did not exist,
           or 2 if any hosts did not have a running daemon.  This is roughly
           the same as "kill -0 <pid>".

           The following works well for shell scripts.

            if pidstat exists 3459 host1:4220 host2:9821
            then
               print "All processes are up"
            else
               print "One of the processes is down"
            fi


ARGUMENTS

       --help
           Displays this message and program version and exits.

       --host
           Specifies host name to check for a process.

       --port
           Specifies the port number to contact the "pidstatd" on.  (default
           1752)

       --silent
           Do not print out a line per process checked.

       --debug
           Turns on the debug flag for diagnostic output.

       --version
           Displays program version and exits.


DISTRIBUTION

       The latest version is available from CPAN and from
       <http://www.veripool.org/>.

       Copyright 2002-2013 by Wilson Snyder.  This package is free software;
       you can redistribute it and/or modify it under the terms of either the
       GNU Lesser General Public License Version 3 or the Perl Artistic
       License Version 2.0.


AUTHORS

       Wilson Snyder <wsnyder@wsnyder.org>, Stephen Adkins
       <stephen.adkins@officevision.com>


SEE ALSO

       IPC::Locker, IPC::PidStat, pidstatd, pidwatch

perl v5.20.2                      2013-01-31                        PIDSTAT(1)

Search: Section: