1just-man-pages/condor_who(1)General Commands Manualjust-man-pages/condor_who(1)
2
6 condor_who Display 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_who queries and displays information about the user that owns
14 the 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_who belong to three groups:
18 * Help options provide information about the condor_who tool.
20 * Address options allow destination specification for query.
22 * Display options control the formatting and which of the queried
24 information to display.
25 At any time, only one help option and one address option may be speci‐
27 fied. Any number of display options may be specified.
28 condor_who obtains its information about jobs by talking to one or more
30 condor_startd daemons. So, condor_who must identify the command port of
31 any condor_startd daemons. An address option provides this information.
32 If no address option is given on the command line, then condor_who
33 searches using this ordering:
34 1. A defined value of the environment variable CONDOR_CONFIG speci‐
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_startd daemons, condor_who
40 utilizes the same algorithm it would using the -allpids option. The
41 Linux ps or the Windows tasklist program obtains all PIDs. As Linux
42 root or Windows administrator , the Linux lsof or the Windows net‐
43 stat identifies open sockets and from there the PIDs of listen sock‐
44 ets. Correlating the two lists of PIDs results in identifying the
45 command ports of all condor_startd daemons.
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_startd host address to query
77 -allpids
81 (address option) Query all local condor_startd daemons
83 -logdir directoryname
87 (address option) Specifies the directory containing log and address
89 files that condor_who will scan to search for command ports of con‐
90 dor_start daemons to query
91 -pid PID
95 (address option) Use the given PID to identify the condor_startd
97 daemon 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 attr in format fmt . To display
117 the 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
126 floating point numbers such as LoadAvg . %v identifies the type of
127 the attribute, and then prints the value in an appropriate format.
128 %V identifies the type of the attribute, and then prints the value
129 in an appropriate format as it would appear in the -long format. As
130 an 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 -format option once for each desired
135 attribute. Like printf(3) -style formats, one may include other
136 text that will be reproduced directly. A format without any conver‐
137 sion specifiers may be specified, but an attribute is still
138 required. Include n to specify a line break.
139 -autoformat[:lhVr,tng] attr1 [attr2 ...] or -af[:lhVr,tng] attr1
143 [attr2 ...]
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 -format option 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 autoformat option may be followed by a colon character
155 and formatting qualifiers to deviate the output formatting from the
156 default:
157 l label each field,
159 h print column headings before the first line of output,
161 V use %V rather than %v for formatting (string values are quoted),
163 r print "raw", or unevaluated values,
165 , add a comma character after each field,
167 t add a tab character before each field instead of the default space
169 character,
170 n add a newline character after each field,
172 g add a newline character between ClassAds, and suppress spaces
174 before each field.
175 Use -af:h to get tabular values with headings.
177 Use -af:lrng to get -long equivalent format.
179 The newline and comma characters may not be used together. The l and
181 h characters may not be used together.
182
186 Example 1 Sample output from the local machine, which is running a sin‐
187 gle HTCondor job. Note that the output of the PROGRAM field 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 2 Verbose 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_who will 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-2018 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 just-man-pages/condor_who(1)