1procd_ctl(1)                General Commands Manual               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_procddaemon. It may be
15       used to cause the condor_procdto do anything  that  the  condor_procdis
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  -hoption prints out usage information and exits. The address-file‐
21       specification within the -Aargument specifies the path and file name of
22       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_GIDGID[PID]
30
31          Use the specified GIDto track the specified family rooted at PID. If
32          the optional PIDis not specified, then the PID used is the one given
33          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 PIDis 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 PIDbeing watched and the
52          tree of processes under this root PID. If  the  optional  PIDis  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 PIDgiven, print out information about all the  watched  pro‐
63          cesses. If the optional PIDis specified, print out information about
64          the process specified by PIDand all its child processes.
65
66
67
68
69
70       SIGNAL_PROCESSsignal[PID]
71
72          Send the signalto the process specified  by  PID.  If  the  optional
73          PIDis  not  specified, then the PID used is the one given or assumed
74          by condor_procd.
75
76
77
78
79
80       SUSPEND_FAMILYPID
81
82          Suspend the process family rooted at PID.
83
84
85
86
87
88       CONTINUE_FAMILYPID
89
90          Continue execution of the process family rooted at PID.
91
92
93
94
95
96       KILL_FAMILYPID
97
98          Kill the process family rooted at PID.
99
100
101
102
103
104       UNREGISTER_FAMILYPID
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_procdand 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_ctland gidd_allocare used
131       with the condor_procdin standalone mode to interact with the daemon and
132       inquire  about  certain  state  of  running  processes  on the machine,
133       respectively.
134

Exit Status

136       procd_ctlwill exit with a status value of 0 (zero) upon success, and it
137       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-2019 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                         procd_ctl(1)
Impressum