.\"Man page for condor_procd .\"Generated by makeman on Tue May 29 00:38:53 2018 .TH condor_procd 1 "May 2018" .SH Name .P condor_procd Track \- and manage process families .P .SH Synopsis condor_procd -h .P condor_procd-A address-file[options] .P .SH Description .P 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 .IP "" 3 * registering new families or new members of existing families .IP "" 3 * getting usage information .IP "" 3 * signaling families for operations such as suspension, continuing, or killing the family .IP "" 3 * 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. .P 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. .P .SH Options .P .B -h .IP "" 3 Print out usage information and exit. .IP "" 3 .IP "" 3 .P .B -D .IP "" 3 Wait for the debugger. Initially sleep 30 seconds before beginning normal function. .IP "" 3 .IP "" 3 .P .B -C principal .IP "" 3 The principalis the UID of the owner of the named pipe that clients must use to speak to the condor_procd . .IP "" 3 .IP "" 3 .P .B -L log-file .IP "" 3 A file the condor_procd will use to write logging information. .IP "" 3 .IP "" 3 .P .B -E .IP "" 3 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. .IP "" 3 .IP "" 3 .P .B -P PID .IP "" 3 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. .IP "" 3 .IP "" 3 .P .B -S seconds .IP "" 3 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. .IP "" 3 .IP "" 3 .P .B -G min-gid max-gid .IP "" 3 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. .IP "" 3 .IP "" 3 .P .B -K windows-softkill-binary .IP "" 3 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. .IP "" 3 .IP "" 3 .P .B -I glexec-kill-path glexec-path .IP "" 3 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. .IP "" 3 .IP "" 3 .P .SH General Remarks .P 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. .P .SH Exit Status .P condor_procdwill exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure. .P .SH Author Center for High Throughput Computing, University of Wisconsin-Madison .SH Copyright Copyright (C) 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.