1just-man-pages/procd_ctl(1) General Commands Manualjust-man-pages/procd_ctl(1)
2
3
4

Name

6       procd_ctl command line interface to the condor_procd
7

Synopsis

9       procd_ctl -h
10
11       procd_ctl -A address-file [ command ]
12

Description

14       This  is a programmatic interface to the condor_procd daemon. It may be
15       used to cause the condor_procd to do anything that the condor_procd  is
16       capable of doing, such as tracking and managing process families.
17
18       This is a program only available for the Linux ports of HTCondor.
19
20       The  -h option prints out usage information and exits. The address-file
21       specification within the -A argument specifies the path and  file  name
22       of the address file which the named pipe clients must use to speak with
23       the condor_procd .
24
25       One command is given to the condor_procd . The choices for the  command
26       are defined by the Options.
27

Options

29       TRACK_BY_ASSOCIATED_GID GID [ PID ]
30
31          Use  the specified GID to track the specified family rooted at PID .
32          If the optional PID is not specified, then the PID used is  the  one
33          given or assumed by condor_procd .
34
35
36
37
38
39       GET_USAGE [ PID ]
40
41          Get the total usage information about the PID family at PID . If the
42          optional PID is not specified, then the PID used is the one given or
43          assumed by condor_procd .
44
45
46
47
48
49       DUMP [ PID ]
50
51          Print  out information about both the root PID being watched and the
52          tree of processes under this root PID . If the optional PID  is  not
53          specified,  then  the  PID  used is the one given or assumed by con‐
54          dor_procd .
55
56
57
58
59
60       LIST [ PID ]
61
62          With no PID given, print out information about all the watched  pro‐
63          cesses.  If  the  optional  PID  is specified, print out information
64          about the process specified by PID and all its child processes.
65
66
67
68
69
70       SIGNAL_PROCESS signal [ PID ]
71
72          Send the signal to the process specified by PID .  If  the  optional
73          PID  is not specified, then the PID used is the one given or assumed
74          by condor_procd .
75
76
77
78
79
80       SUSPEND_FAMILY PID
81
82          Suspend the process family rooted at PID .
83
84
85
86
87
88       CONTINUE_FAMILY PID
89
90          Continue execution of the process family rooted at PID .
91
92
93
94
95
96       KILL_FAMILY PID
97
98          Kill the process family rooted at PID .
99
100
101
102
103
104       UNREGISTER_FAMILY PID
105
106          Stop tracking the process family rooted at PID .
107
108
109
110
111
112       SNAPSHOT
113
114          Perform a snapshot of the tracked family tree.
115
116
117
118
119
120       QUIT
121
122          Disconnect from the condor_procd and exit.
123
124
125
126
127

General Remarks

129       This program may be used in a standalone mode, independent of HTCondor,
130       to  track  process  families. The programs procd_ctl and gidd_alloc are
131       used with the condor_procd in standalone mode to interact with the dae‐
132       mon  and  inquire  about  certain  state  of  running  processes on the
133       machine, respectively.
134

Exit Status

136       procd_ctl will exit with a status value of 0 (zero) upon  success,  and
137       it will exit with the value 1 (one) upon failure.
138

Author

140       Center for High Throughput Computing, University of Wisconsin-Madison
141

143       Copyright  (C) 1990-2018 Center for High Throughput Computing, Computer
144       Sciences Department, University of Wisconsin-Madison, Madison, WI.  All
145       Rights Reserved. Licensed under the Apache License, Version 2.0.
146
147                                     date          just-man-pages/procd_ctl(1)
Impressum