1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
procd_ctl
==========
command line interface to the *condor_procd*
:index:`procd_ctl<single: procd_ctl; HTCondor commands>`\ :index:`procd_ctl command`
Synopsis
--------
**procd_ctl** **-h**
**procd_ctl** **-A** *address-file* [**command** ]
Description
-----------
This is a programmatic interface to the *condor_procd* daemon. It may
be used to cause the *condor_procd* to do anything that the
*condor_procd* is capable of doing, such as tracking and managing
process families.
This is a program only available for the Linux ports of HTCondor.
The **-h** option prints out usage information and exits. The
*address-file* specification within the **-A** argument specifies the
path and file name of the address file which the named pipe clients must
use to speak with the *condor_procd*.
One command is given to the *condor_procd*. The choices for the command
are defined by the Options.
Options
-------
**TRACK_BY_ASSOCIATED_GID** *GID* [*PID* ]
Use the specified *GID* to track the specified family rooted at
*PID*. If the optional *PID* is not specified, then the PID used is
the one given or assumed by *condor_procd*.
**GET_USAGE** [*PID* ]
Get the total usage information about the PID family at *PID*. If
the optional *PID* is not specified, then the PID used is the one
given or assumed by *condor_procd*.
**DUMP** [*PID* ]
Print out information about both the root *PID* being watched and
the tree of processes under this root *PID*. If the optional *PID*
is not specified, then the PID used is the one given or assumed by
*condor_procd*.
**LIST** [*PID* ]
With no *PID* given, print out information about all the watched
processes. If the optional *PID* is specified, print out information
about the process specified by *PID* and all its child processes.
**SIGNAL_PROCESS** *signal* [*PID* ]
Send the *signal* to the process specified by *PID*. If the optional
*PID* is not specified, then the PID used is the one given or
assumed by *condor_procd*.
**SUSPEND_FAMILY** *PID*
Suspend the process family rooted at *PID*.
**CONTINUE_FAMILY** *PID*
Continue execution of the process family rooted at *PID*.
**KILL_FAMILY** *PID*
Kill the process family rooted at *PID*.
**UNREGISTER_FAMILY** *PID*
Stop tracking the process family rooted at *PID*.
**SNAPSHOT**
Perform a snapshot of the tracked family tree.
**QUIT**
Disconnect from the *condor_procd* and exit.
General Remarks
---------------
This program may be used in a standalone mode, independent of HTCondor,
to track process families. The programs *procd_ctl* and *gidd_alloc*
are used with the *condor_procd* in standalone mode to interact with
the daemon and inquire about certain state of running processes on the
machine, respectively.
Exit Status
-----------
*procd_ctl* will exit with a status value of 0 (zero) upon success, and
it will exit with the value 1 (one) upon failure.
|
