GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PIDSTAT (1)

.ds Aq ’

NAME

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

CONTENTS

SYNOPSIS

<B>pidstatB> [ <B>--helpB> ] [ <B>--host=B>host ] [ <B>--port=B>port ] [ <B>--silentB> ] [ <B>--versionB> ] [ <B>--debugB> ] [ exists <B>remotepidsB> ]

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
Search for    or go to Top of page |  Section 1 |  Main Index


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

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.