1PROCD_CTL(1)                    HTCondor Manual                   PROCD_CTL(1)
2
3
4

NAME

6       procd_ctl - HTCondor Manual
7
8       command line interface to the condor_procd
9
10

SYNOPSIS

12       procd_ctl -h
13
14       procd_ctl -A address-file [command ]
15

DESCRIPTION

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

OPTIONS

32          TRACK_BY_ASSOCIATED_GID GID [PID ]
33                 Use the specified GID to track the specified family rooted at
34                 PID. If the optional PID is not specified, then the PID  used
35                 is the one given or assumed by condor_procd.
36
37          GET_USAGE [PID ]
38                 Get  the total usage information about the PID family at PID.
39                 If the optional PID is not specified, then the  PID  used  is
40                 the one given or assumed by condor_procd.
41
42          DUMP [PID ]
43                 Print  out  information about both the root PID being watched
44                 and the tree of processes under this root  PID.  If  the  op‐
45                 tional  PID  is  not  specified, then the PID used is the one
46                 given or assumed by condor_procd.
47
48          LIST [PID ]
49                 With no PID  given,  print  out  information  about  all  the
50                 watched  processes.  If  the optional PID is specified, print
51                 out information about the process specified by  PID  and  all
52                 its child processes.
53
54          SIGNAL_PROCESS signal [PID ]
55                 Send  the  signal to the process specified by PID. If the op‐
56                 tional PID is not specified, then the PID  used  is  the  one
57                 given or assumed by condor_procd.
58
59          SUSPEND_FAMILY PID
60                 Suspend the process family rooted at PID.
61
62          CONTINUE_FAMILY PID
63                 Continue execution of the process family rooted at PID.
64
65          KILL_FAMILY PID
66                 Kill the process family rooted at PID.
67
68          UNREGISTER_FAMILY PID
69                 Stop tracking the process family rooted at PID.
70
71          SNAPSHOT
72                 Perform a snapshot of the tracked family tree.
73
74          QUIT   Disconnect from the condor_procd and exit.
75

GENERAL REMARKS

77       This program may be used in a standalone mode, independent of HTCondor,
78       to track process families. The programs procd_ctl  and  gidd_alloc  are
79       used with the condor_procd in standalone mode to interact with the dae‐
80       mon and inquire about certain state of running  processes  on  the  ma‐
81       chine, respectively.
82

EXIT STATUS

84       procd_ctl  will  exit with a status value of 0 (zero) upon success, and
85       it will exit with the value 1 (one) upon failure.
86

AUTHOR

88       HTCondor Team
89
91       1990-2023, Center for High Throughput Computing, Computer Sciences  De‐
92       partment,  University  of  Wisconsin-Madison, Madison, WI, US. Licensed
93       under the Apache License, Version 2.0.
94
95
96
97
98                                 Oct 02, 2023                     PROCD_CTL(1)
Impressum