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
45                 optional  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
56                 optional 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
81       machine, 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-2020, Center for  High  Throughput  Computing,  Computer  Sciences
92       Department,  University of Wisconsin-Madison, Madison, WI, US. Licensed
93       under the Apache License, Version 2.0.
94
95
96
97
988.8                              Aug 06, 2020                     PROCD_CTL(1)
Impressum