procd_ctl(1)

Name

procd_ctl command line interface to the condor_procd

Synopsis
procd_ctl-h

procd_ctl-A address-file[command]

Description

This is a programmatic interface to the condor_procddaemon. It may be used to cause the condor_procdto do anything that the condor_procdis capable of doing, such as tracking and managing process families.

This is a program only available for the Linux ports of HTCondor.

The -hoption prints out usage information and exits. The address-filespecification within the -Aargument 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_GIDGID[PID]

    Use the specified GIDto track the specified family rooted at PID. If the optional PIDis 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 PIDis not specified, then the PID used is the one given or assumed by condor_procd.

DUMP[PID]

    Print out information about both the root PIDbeing watched and the tree of processes under this root PID. If the optional PIDis not specified, then the PID used is the one given or assumed by condor_procd.

LIST[PID]

    With no PIDgiven, print out information about all the watched processes. If the optional PIDis specified, print out information about the process specified by PIDand all its child processes.

SIGNAL_PROCESSsignal[PID]

    Send the signalto the process specified by PID. If the optional PIDis not specified, then the PID used is the one given or assumed by condor_procd.

SUSPEND_FAMILYPID

    Suspend the process family rooted at PID.

CONTINUE_FAMILYPID

    Continue execution of the process family rooted at PID.

KILL_FAMILYPID

    Kill the process family rooted at PID.

UNREGISTER_FAMILYPID

    Stop tracking the process family rooted at PID.

SNAPSHOT

    Perform a snapshot of the tracked family tree.

QUIT

    Disconnect from the condor_procdand exit.

General Remarks

This program may be used in a standalone mode, independent of HTCondor, to track process families. The programs procd_ctland gidd_allocare used with the condor_procdin standalone mode to interact with the daemon and inquire about certain state of running processes on the machine, respectively.

Exit Status

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

Author
Center for High Throughput Computing, University of Wisconsin&ndash;Madison

Copyright
Copyright © 1990-2019 Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed under the Apache License, Version 2.0.