condor_procd(1)                                               General Commands Manual                                              condor_procd(1)

Name
       condor_procd Track - and manage process families

Synopsis
       condor_procd -h

       condor_procd-A address-file[options]

Description
       condor_procdtracks  and  manages process families on behalf of the Condor daemons. It may track families of PIDs via relationships such as:
       direct parent/child, environment variables, UID, and supplementary group IDs. Management of the PID families include

          * registering new families or new members of existing families

          * getting usage information

          * signaling families for operations such as suspension, continuing, or killing the family

          * getting a snapshot of the tree of families In a regular Condor installation, this program is not intended to be used  or  executed  by
          any human.

       The  required  argument,  -A  address-file,  is the path and file name of the address file which is the named pipe that clients must use to
       speak with the condor_procd.

Options
       -h

          Print out usage information and exit.

       -D

          Wait for the debugger. Initially sleep 30 seconds before beginning normal function.

       -C principal

          The principalis the UID of the owner of the named pipe that clients must use to speak to the condor_procd .

       -L log-file

          A file the condor_procd will use to write logging information.

       -E

          When specified, another tool such as the procd_ctltool must allocate the GID associated with a process. When this  option  is  notspeci-
          fied, the condor_procd will allocate the GID itself.

       -P PID

          If  not  specified,  the  condor_procd  will  use  the condor_procd 's parent, which may not be PID 1 on Unix, as the parent of the con-
          dor_procd and the root of the tracking family. When not specified, if the condor_procd 's parent PID dies, the condor_procd exits.  When
          specified, the condor_procd will track this PIDfamily in question and not also exit if the PID exits.

       -S seconds

          The maximum number of seconds the condor_procd will wait between taking snapshots of the tree of families. Different clients to the con-
          dor_procd can specify different snapshot times. The quickest snapshot time is the one performed by the condor_procd . When  this  option
          is not specified, a default value of 60 seconds is used.

       -G min-gid max-gid

          If  the  -Eoption  is notspecified, then track process families using a self-allocated, free GID out of the inclusive range specified by
          min-gidand max-gid. This means that if a new process shows up using a previously known GID, the new process will automatically associate
          into  the process family assigned that GID. If the -Eoption isspecified, then instead of self-allocating the GID, the procd_ctltool must
          be used to associate the GID with the PID root of the family. The associated GID must still be in the range specified. This is a  Linux-
          only feature.

       -K windows-softkill-binary

          This  is the path and executable name of the condor_softkill.exebinary. It is used to send softkill signals to process families. This is
          a Windows-only feature.

       -I glexec-kill-path glexec-path

          Specifies, with glexec-kill-path, the path and executable name of a binary used to send a signal to a PID. The  glexecbinary,  specified
          by glexec-path, executes the program specified with glexec-kill-pathunder the right privileges to send the signal.

General Remarks
       This  program  may be used in a stand alone mode, independent of Condor, to track process families. The programs procd_ctland gidd_allocare
       used with the condor_procdin stand alone mode to interact with the daemon and to inquire about certain state of running  processes  on  the
       machine, respectively.

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

Author
       Condor Team, University of Wisconsin-Madison

Copyright
       Copyright  (C)  1990-2012  Condor  Team,  Computer  Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved.
       Licensed under the Apache License, Version 2.0.

       See the Condor Version 7.8.2 Manualor http://www.condorproject.org/licensefor additional notices. condor-admin@cs.wisc.edu

                                                                  September 2012                                                   condor_procd(1)