1condor_procd(1)             General Commands Manual            condor_procd(1)
2
3
4

Name

6       condor_procdTrack and manage process families
7

Synopsis

9       condor_procd-h
10
11       condor_procd-A address-file[options]
12

Description

14       condor_procdtracks and manages process families on behalf of the HTCon‐
15       dor daemons. It may track families of PIDs via relationships  such  as:
16       direct  parent/child,  environment  variables,  UID,  and supplementary
17       group IDs. Management of the PID families include
18
19          * registering new families or new members of existing families
20
21          * getting usage information
22
23          * signaling families for operations such as suspension,  continuing,
24          or killing the family
25
26          *  getting  a snapshot of the tree of families In a regular HTCondor
27          installation, this program is not intended to be used or executed by
28          any human.
29
30       The  required  argument,  -A address-file, is the path and file name of
31       the address file which is the named pipe that clients must use to speak
32       with the condor_procd.
33

Options

35       -h
36
37          Print out usage information and exit.
38
39
40
41
42
43       -D
44
45          Wait  for  the debugger. Initially sleep 30 seconds before beginning
46          normal function.
47
48
49
50
51
52       -C principal
53
54          The principalis the UID of the owner of the named pipe that  clients
55          must use to speak to the condor_procd.
56
57
58
59
60
61       -L log-file
62
63          A file the condor_procdwill use to write logging information.
64
65
66
67
68
69       -E
70
71          When specified, another tool such as the procd_ctltool must allocate
72          the GID associated with a process. When this option is notspecified,
73          the condor_procdwill allocate the GID itself.
74
75
76
77
78
79       -P PID
80
81          If  not  specified, the condor_procdwill use the condor_procd's par‐
82          ent, which may not be PID 1 on Unix,  as  the  parent  of  the  con‐
83          dor_procdand the root of the tracking family. When not specified, if
84          the condor_procd's parent  PID  dies,  the  condor_procdexits.  When
85          specified, the condor_procdwill track this PIDfamily in question and
86          not also exit if the PID exits.
87
88
89
90
91
92       -S seconds
93
94          The maximum number of seconds the condor_procdwill wait between tak‐
95          ing snapshots of the tree of families. Different clients to the con‐
96          dor_procdcan specify different snapshot times. The quickest snapshot
97          time  is  the one performed by the condor_procd. When this option is
98          not specified, a default value of 60 seconds is used.
99
100
101
102
103
104       -G min-gid max-gid
105
106          If the -Eoption is notspecified, then track process families using a
107          self-allocated,  free  GID  out  of the inclusive range specified by
108          min-gidand max-gid. This means that if a new process shows up  using
109          a previously known GID, the new process will automatically associate
110          into the process family assigned that GID. If the -Eoption  isspeci‐
111          fied,  then  instead  of  self-allocating the GID, the procd_ctltool
112          must be used to associate the GID with the PID root of  the  family.
113          The  associated  GID must still be in the range specified. This is a
114          Linux-only feature.
115
116
117
118
119
120       -K windows-softkill-binary
121
122          This is the path and executable name of  the  condor_softkill.exebi‐
123          nary.  It is used to send softkill signals to process families. This
124          is a Windows-only feature.
125
126
127
128
129
130       -I glexec-kill-path glexec-path
131
132          Specifies, with glexec-kill-path, the path and executable name of  a
133          binary  used  to send a signal to a PID. The glexecbinary, specified
134          by glexec-path, executes the  program  specified  with  glexec-kill-
135          pathunder the right privileges to send the signal.
136
137
138
139
140

General Remarks

142       This  program  may be used in a stand alone mode, independent of HTCon‐
143       dor, to track process families. The programs procd_ctland gidd_allocare
144       used with the condor_procdin stand alone mode to interact with the dae‐
145       mon and to inquire about certain state  of  running  processes  on  the
146       machine, respectively.
147

Exit Status

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

Author

153       Center  for  High   Throughput   Computing,   University   of   Wiscon‐
154       sin–Madison
155

157       Copyright  ©  1990-2019  Center for High Throughput Computing, Computer
158       Sciences Department, University of Wisconsin-Madison, Madison, WI.  All
159       Rights Reserved. Licensed under the Apache License, Version 2.0.
160
161
162
163                                     date                      condor_procd(1)
Impressum