1condor_who(1) General Commands Manual condor_who(1)
2
6 condor_whoDisplay information about owners of jobs and jobs running on
7 an execute machine
8
10 condor_who[help options] [address options] [display options]
11
13 condor_whoqueries and displays information about the user that owns the
14 jobs running on a machine. It is intended to be run on an execute
15 machine.
16 The options that may be supplied to condor_whobelong to three groups:
18 * Help optionsprovide information about the condor_whotool.
20 * Address optionsallow destination specification for query.
22 * Display optionscontrol the formatting and which of the queried
24 information to display.
25 At any time, only one help optionand one address optionmay be speci‐
27 fied. Any number of display optionsmay be specified.
28 condor_whoobtains its information about jobs by talking to one or more
30 condor_startddaemons. So, condor_whomust identify the command port of
31 any condor_startddaemons. An address optionprovides this information.
32 If noaddress optionis given on the command line, then con‐
33 dor_whosearches using this ordering:
34 1. A defined value of the environment variable CONDOR_CONFIGspeci‐
36 fies the directory where log and address files are to be scanned for
37 needed information.
38 2. With the aim of finding all condor_startddaemons, condor_whouti‐
40 lizes the same algorithm it would using the -allpidsoption. The
41 Linux psor the Windows tasklistprogram obtains all PIDs. As Linux
42 rootor Windows administrator, the Linux lsofor the Windows netstati‐
43 dentifies open sockets and from there the PIDs of listen sockets.
44 Correlating the two lists of PIDs results in identifying the command
45 ports of all condor_startddaemons.
46
48 -help
49 (help option) Display usage information
51 -daemons
55 (help option) Display information about the daemons running on the
57 specified machine, including the daemon's PID, IP address and com‐
58 mand port
59 -diagnostic
63 (help option) Display extra information helpful for debugging
65 -verbose
69 (help option) Display PIDs and addresses of daemons
71 -address hostaddress
75 (address option) Identify the condor_startdhost address to query
77 -allpids
81 (address option) Query all local condor_startddaemons
83 -logdir directoryname
87 (address option) Specifies the directory containing log and address
89 files that condor_whowill scan to search for command ports of con‐
90 dor_startdaemons to query
91 -pid PID
95 (address option) Use the given PIDto identify the condor_startddae‐
97 mon to query
98 -long
102 (display option) Display entire ClassAds
104 -wide
108 (display option) Displays fields without truncating them in order to
110 fit screen width
111 -format fmt attr
115 (display option) Display attribute attrin format fmt. To display the
117 attribute or expression the format must contain a single
118 printf(3)-style conversion specifier. Attributes must be from the
119 resource ClassAd. Expressions are ClassAd expressions and may refer
120 to attributes in the resource ClassAd. If the attribute is not
121 present in a given ClassAd and cannot be parsed as an expression,
122 then the format option will be silently skipped. %r prints the
123 unevaluated, or raw values. The conversion specifier must match the
124 type of the attribute or expression. %s is suitable for strings such
125 as Name, %d for integers such as LastHeardFrom, and %f for floating
126 point numbers such as LoadAvg. %v identifies the type of the
127 attribute, and then prints the value in an appropriate format. %V
128 identifies the type of the attribute, and then prints the value in
129 an appropriate format as it would appear in the -longformat. As an
130 example, strings used with %V will have quote marks. An incorrect
131 format will result in undefined behavior. Do not use more than one
132 conversion specifier in a given format. More than one conversion
133 specifier will result in undefined behavior. To output multiple
134 attributes repeat the -formatoption once for each desired attribute.
135 Like printf(3)-style formats, one may include other text that will
136 be reproduced directly. A format without any conversion specifiers
137 may be specified, but an attribute is still required. Include a
138 backslash followed by an `n' to specify a line break.
139 -autoformat[:lhVr,tng] attr1 [attr2 ...]or -af[:lhVr,tng] attr1 [attr2
143 ...]
144 (display option) Display attribute(s) or expression(s) formatted in
146 a default way according to attribute types. This option takes an
147 arbitrary number of attribute names as arguments, and prints out
148 their values, with a space between each value and a newline charac‐
149 ter after the last value. It is like the -formatoption without for‐
150 mat strings.
151 It is assumed that no attribute names begin with a dash character,
153 so that the next word that begins with dash is the start of the next
154 option. The autoformatoption may be followed by a colon character
155 and formatting qualifiers to deviate the output formatting from the
156 default:
157 llabel each field,
159 hprint column headings before the first line of output,
161 Vuse %V rather than %v for formatting (string values are quoted),
163 rprint "raw", or unevaluated values,
165 ,add a comma character after each field,
167 tadd a tab character before each field instead of the default space
169 character,
170 nadd a newline character after each field,
172 gadd a newline character between ClassAds, and suppress spaces
174 before each field.
175 Use -af:hto get tabular values with headings.
177 Use -af:lrngto get -long equivalent format.
179 The newline and comma characters may notbe used together. The land
181 hcharacters may notbe used together.
182
186 Example 1Sample output from the local machine, which is running a sin‐
187 gle HTCondor job. Note that the output of the PROGRAMfield will be
188 truncated to fit the display, similar to the artificial truncation
189 shown in this example output.
190 % condor_who
192 OWNER CLIENT SLOT JOB RUNTIME PID
194 PROGRAM
195 smith1@crane.cs.wisc.edu crane.cs.wisc.edu 2 320.0 0+00:00:08 7776
196 D:\scratch\condor\execut
197 Example 2Verbose sample output.
199 % condor_who -verbose
201 LOG directory "D:\scratch\condor\master\test/log"
203 Daemon PID Exit Addr Log, Log.Old
205 ------ --- ---- ---- ---, -------
206 Collector 6788 <128.105.136.32:7977> CollectorLog,
207 CollectorLog.old
208 Credd 8148 <128.105.136.32:9620> CredLog, Cred‐
209 Log.old
210 Master 5976 <128.105.136.32:64980> MasterLog,
211 Match MatchLog, MatchLog.old
212 Negotiator 6600 NegotiatorLog, NegotiatorLog.old
213 Schedd 6336 <128.105.136.32:64985> SchedLog,
214 SchedLog.old
215 Shadow ShadowLog,
216 Slot1 StarterLog.slot1,
217 Slot2 7272 <128.105.136.32:65026> Starter‐
218 Log.slot2,
219 Slot3 StarterLog.slot3,
220 Slot4 StarterLog.slot4,
221 SoftKill SoftKillLog,
222 Startd 7416 <128.105.136.32:64984> StartLog,
223 StartLog.old
224 Starter StarterLog,
225 TOOL TOOLLog,
226 OWNER CLIENT SLOT JOB RUNTIME PID
228 PROGRAM
229 smith1@crane.cs.wisc.edu crane.cs.wisc.edu 2 320.0 0+00:01:28 7776
230 D:\scratch\condor\execut
231
233 condor_whowill exit with a status value of 0 (zero) upon success, and
234 it will exit with the value 1 (one) upon failure.
235
237 Center for High Throughput Computing, University of Wisconsin-Madison
238
240 Copyright (C) 1990-2019 Center for High Throughput Computing, Computer
241 Sciences Department, University of Wisconsin-Madison, Madison, WI. All
242 Rights Reserved. Licensed under the Apache License, Version 2.0.
243 date condor_who(1)