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 HTCondor 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 HTCondor 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 notspecified, 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 condor_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 condor_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 HTCondor, 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

       Center for High Throughput Computing, University of Wisconsin–Madison

Copyright

       Copyright © 1990-2016 Center for High Throughput Computing, Computer Sciences Department,  University  of
       Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed under the Apache License, Version 2.0.

                                                  January 2020                                   condor_procd(1)