Name¶
condor_who Display - information about owners of jobs and jobs running on an
execute machine
Synopsis¶
condor_who [help options] [address options] [display options]
Description¶
condor_who queries and displays information about the user that owns the jobs
running on a machine. It is intended to be run on an execute machine.
The options that may be supplied to condor_whobelong to three groups:
-
- * Help optionsprovide information about the condor_who tool.
-
- * Address optionsallow destination specification for query.
-
- * Display optionscontrol the formatting and which of the queried
information to display.
At any time, only one help optionand one address optionmay be specified. Any
number of display optionsmay be specified.
condor_whoobtains its information about jobs by talking to one or more
condor_startddaemons. So, condor_whomust identify the command port of any
condor_startddaemons. An address optionprovides this information. If noaddress
optionis given on the command line, then condor_whosearches using this
ordering:
-
- 1. A defined value of the environment variable CONDOR_CONFIG specifies the
directory where log and address files are to be scanned for needed
information.
-
- 2. With the aim of finding all condor_startddaemons, condor_who utilizes
the same algorithm it would using the -allpidsoption. The Linux psor the
Windows tasklistprogram obtains all PIDs. As Linux root or Windows
administrator , the Linux lsofor the Windows netstatidentifies open
sockets and from there the PIDs of listen sockets. Correlating the two
lists of PIDs results in identifying the command ports of all
condor_startddaemons.
Options¶
-help
-
- (help option) Display usage information
-
-daemons
-
- (help option) Display information about the daemons running on the
specified machine, including the daemon's PID, IP address and command
port
-
-diagnostic
-
- (help option) Display extra information helpful for debugging
-
-verbose
-
- (help option) Display PIDs and addresses of daemons
-
-address hostaddress
-
- (address option) Identify the condor_startdhost address to query
-
-allpids
-
- (address option) Query all local condor_startddaemons
-
-logdir directoryname
-
- (address option) Specifies the directory containing log and address files
that condor_who will scan to search for command ports of
condor_startdaemons to query
-
-pid PID
-
- (address option) Use the given PIDto identify the condor_startddaemon to
query
-
-long
-
- (display option) Display entire ClassAds
-
-wide
-
- (display option) Displays fields without truncating them in order to fit
screen width
-
-format fmt attr
-
- (display option) Display attribute attrin format fmt. To display the
attribute or expression the format must contain a single printf(3) -style
conversion specifier. Attributes must be from the resource ClassAd.
Expressions are ClassAd expressions and may refer to attributes in the
resource ClassAd. If the attribute is not present in a given ClassAd and
cannot be parsed as an expression, then the format option will be silently
skipped. The conversion specifier must match the type of the attribute or
expression. %s is suitable for strings such as Name , %d for integers such
as LastHeardFrom , and %f for floating point numbers such as LoadAvg . %v
identifies the type of the attribute, and then prints the value in an
appropriate format. %V identifies the type of the attribute, and then
prints the value in an appropriate format as it would appear in the
-longformat. As an example, strings used with %V will have quote marks. An
incorrect format will result in undefined behavior. Do not use more than
one conversion specifier in a given format. More than one conversion
specifier will result in undefined behavior. To output multiple attributes
repeat the -formatoption once for each desired attribute. Like printf(3)
-style formats, one may include other text that will be reproduced
directly. A format without any conversion specifiers may be specified, but
an attribute is still required. Include n to specify a line break.
-
-autoformat[:tn,lVh] attr1 [attr2 ...]
-
- (display option) Display machine ClassAd attribute values formatted in a
default way according to their attribute types. This option takes an
arbitrary number of attribute names as arguments, and prints out their
values. It is like the -formatoption, but no format strings are required.
It is assumed that no attribute names begin with a dash character, so that
the next word that begins with dash is the start of the next option. The
autoformatoption may be followed by a colon character and formatting
qualifiers:
-
- tadd a tab character before each field instead of the default space
character,
-
- nadd a newline character after each field,
-
- ,add a comma character after each field,
-
- llabel each field,
-
- Vuse %V rather than %v for formatting,
-
- hprint headings before the first line of output.
-
- The newline and comma characters may notbe used together.
-
Examples¶
Example 1Sample output from the local machine, which is running a single
HTCondor job. Note that the output of the PROGRAM field will be truncated to
fit the display, similar to the artificial truncation shown in this example
output.
% condor_who
OWNER CLIENT SLOT JOB RUNTIME PID PROGRAM
smith1@crane.cs.wisc.edu crane.cs.wisc.edu 2 320.0 0+00:00:08 7776
D:\scratch\condor\execut
Example 2Verbose sample output.
% condor_who -verbose
LOG directory "D:\scratch\condor\master\test/log"
Daemon PID Exit Addr Log, Log.Old
------ --- ---- ---- ---, -------
Collector 6788 <128.105.136.32:7977> CollectorLog, CollectorLog.old
Credd 8148 <128.105.136.32:9620> CredLog, CredLog.old
Master 5976 <128.105.136.32:64980> MasterLog,
Match MatchLog, MatchLog.old
Negotiator 6600 NegotiatorLog, NegotiatorLog.old
Schedd 6336 <128.105.136.32:64985> SchedLog, SchedLog.old
Shadow ShadowLog,
Slot1 StarterLog.slot1,
Slot2 7272 <128.105.136.32:65026> StarterLog.slot2,
Slot3 StarterLog.slot3,
Slot4 StarterLog.slot4,
SoftKill SoftKillLog,
Startd 7416 <128.105.136.32:64984> StartLog, StartLog.old
Starter StarterLog,
TOOL TOOLLog,
OWNER CLIENT SLOT JOB RUNTIME PID PROGRAM
smith1@crane.cs.wisc.edu crane.cs.wisc.edu 2 320.0 0+00:01:28 7776
D:\scratch\condor\execut
Exit Status¶
condor_whowill 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-Madison
Copyright¶
Copyright (C) 1990-2014 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.