NAME

       procd_ctl - HTCondor Manual

       command line interface to the condor_procd

SYNOPSIS

       procd_ctl -h

       procd_ctl -A address-file [command ]

DESCRIPTION

       This  is a programmatic interface to the condor_procd daemon. It may be used to cause the condor_procd to
       do anything that the condor_procd is capable of doing, such as tracking and managing process families.

       This is a program only available for the Linux ports of HTCondor.

       The -h option prints out usage information and  exits.  The  address-file  specification  within  the  -A
       argument  specifies  the  path and file name of the address file which the named pipe clients must use to
       speak with the condor_procd.

       One command is given to the condor_procd. The choices for the command are defined by the Options.

OPTIONS

          TRACK_BY_ASSOCIATED_GID GID [PID ]
                 Use the specified GID to track the specified family rooted at PID. If the optional PID  is  not
                 specified, then the PID used is the one given or assumed by condor_procd.

          GET_USAGE [PID ]
                 Get  the  total  usage  information  about  the  PID  family at PID. If the optional PID is not
                 specified, then the PID used is the one given or assumed by condor_procd.

          DUMP [PID ]
                 Print out information about both the root PID being watched and the  tree  of  processes  under
                 this  root  PID.  If  the  optional PID is not specified, then the PID used is the one given or
                 assumed by condor_procd.

          LIST [PID ]
                 With no PID given, print out information about all the watched processes. If the  optional  PID
                 is  specified,  print  out  information  about  the  process specified by PID and all its child
                 processes.

          SIGNAL_PROCESS signal [PID ]
                 Send the signal to the process specified by PID. If the optional PID is not specified, then the
                 PID used is the one given or assumed by condor_procd.

          SUSPEND_FAMILY PID
                 Suspend the process family rooted at PID.

          CONTINUE_FAMILY PID
                 Continue execution of the process family rooted at PID.

          KILL_FAMILY PID
                 Kill the process family rooted at PID.

          UNREGISTER_FAMILY PID
                 Stop tracking the process family rooted at PID.

          SNAPSHOT
                 Perform a snapshot of the tracked family tree.

          QUIT   Disconnect from the condor_procd and exit.

GENERAL REMARKS

       This program may be used in a standalone mode, independent of HTCondor, to track  process  families.  The
       programs  procd_ctl and gidd_alloc are used with the condor_procd in standalone mode to interact with the
       daemon and inquire about certain state of running processes on the machine, respectively.

EXIT STATUS

       procd_ctl will exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one)
       upon failure.

AUTHOR

       HTCondor Team

COPYRIGHT

       1990-2024, Center for High Throughput Computing, Computer Sciences Department, University  of  Wisconsin-
       Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.

                                                  Aug 25, 2024                                      PROCD_CTL(1)