Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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
       <https://www.veripool.org/ipc-locker>.

       Copyright 2002-2019 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.32.1			  2019-10-26			    PIDSTAT(1)

NAME | SYNOPSIS | DESCRIPTION | COMMANDS | ARGUMENTS | DISTRIBUTION | AUTHORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pidstat&sektion=1&manpath=FreeBSD+13.1-RELEASE+and+Ports>

home | help