1CONDOR_PROCD(1) HTCondor Manual CONDOR_PROCD(1)
2
3
4
6 condor_procd - HTCondor Manual
7
8 Track and manage process families
9
10
12 condor_procd -h
13
14 condor_procd -A address-file [options ]
15
17 condor_procd tracks and manages process families on behalf of the HT‐
18 Condor daemons. It may track families of PIDs via relationships such
19 as: direct parent/child, environment variables, UID, and supplementary
20 group IDs. Management of the PID families include
21
22 • registering new families or new members of existing families
23
24 • getting usage information
25
26 • signaling families for operations such as suspension, continuing, or
27 killing the family
28
29 • getting a snapshot of the tree of families
30
31 In a regular HTCondor installation, this program is not intended to be
32 used or executed by any human.
33
34 The required argument, -A address-file, is the path and file name of
35 the address file which is the named pipe that clients must use to speak
36 with the condor_procd.
37
39 -h Print out usage information and exit.
40
41 -D Wait for the debugger. Initially sleep 30 seconds before be‐
42 ginning normal function.
43
44 -C principal
45 The principal is the UID of the owner of the named pipe that
46 clients must use to speak to the condor_procd.
47
48 -L log-file
49 A file the condor_procd will use to write logging informa‐
50 tion.
51
52 -E When specified, another tool such as the procd_ctl tool must
53 allocate the GID associated with a process. When this option
54 is not specified, the condor_procd will allocate the GID it‐
55 self.
56
57 -P PID If not specified, the condor_procd will use the condor_procd
58 's parent, which may not be PID 1 on Unix, as the parent of
59 the condor_procd and the root of the tracking family. When
60 not specified, if the condor_procd 's parent PID dies, the
61 condor_procd exits. When specified, the condor_procd will
62 track this PID family in question and not also exit if the
63 PID exits.
64
65 -S seconds
66 The maximum number of seconds the condor_procd will wait be‐
67 tween taking snapshots of the tree of families. Different
68 clients to the condor_procd can specify different snapshot
69 times. The quickest snapshot time is the one performed by the
70 condor_procd. When this option is not specified, a default
71 value of 60 seconds is used.
72
73 -G min-gid max-gid
74 If the -E option is not specified, then track process fami‐
75 lies using a self-allocated, free GID out of the inclusive
76 range specified by min-gid and max-gid. This means that if a
77 new process shows up using a previously known GID, the new
78 process will automatically associate into the process family
79 assigned that GID. If the -E option is specified, then in‐
80 stead of self-allocating the GID, the procd_ctl tool must be
81 used to associate the GID with the PID root of the family.
82 The associated GID must still be in the range specified. This
83 is a Linux-only feature.
84
85 -K windows-softkill-binary
86 This is the path and executable name of the condor_soft‐
87 kill.exe binary. It is used to send softkill signals to
88 process families. This is a Windows-only feature.
89
90 -I glexec-kill-path glexec-path
91 Specifies, with glexec-kill-path, the path and executable
92 name of a binary used to send a signal to a PID. The glexec
93 binary, specified by glexec-path, executes the program speci‐
94 fied with glexec-kill-path under the right privileges to send
95 the signal.
96
98 This program may be used in a stand alone mode, independent of HTCon‐
99 dor, to track process families. The programs procd_ctl and gidd_alloc
100 are used with the condor_procd in stand alone mode to interact with the
101 daemon and to inquire about certain state of running processes on the
102 machine, respectively.
103
105 condor_procd will exit with a status value of 0 (zero) upon success,
106 and it will exit with the value 1 (one) upon failure.
107
109 HTCondor Team
110
112 1990-2021, Center for High Throughput Computing, Computer Sciences De‐
113 partment, University of Wisconsin-Madison, Madison, WI, US. Licensed
114 under the Apache License, Version 2.0.
115
116
117
118
1198.8 Jan 26, 2021 CONDOR_PROCD(1)