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 https://www.veripool.org/ipc-locker.
Copyright 2002-2022 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>