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-2017 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, uriexec
perl v5.24.1 2017-04-26 PIDSTAT(1)
permalink to the pidstat command:
https://manpage.me/?pidstat
link by Name, Section, and OS version of this man page:
/?q=pidstat&sektion=1&manpath=FreeBSD+11.1-RELEASE+and+Ports