1CONDOR_STATUS(1) HTCondor Manual CONDOR_STATUS(1)
2
6 condor_status - HTCondor Manual
7 Display status of the HTCondor pool
9
12 condor_status [-debug ] [help options ] [query options ] [display op‐
13 tions ] [custom options ] [name ... ]
14
16 condor_status is a versatile tool that may be used to monitor and query
17 the HTCondor pool. The condor_status tool can be used to query resource
18 information, submitter information, checkpoint server information, and
19 daemon master information. The specific query sent and the resulting
20 information display is controlled by the query options supplied.
21 Queries and display formats can also be customized.
22 The options that may be supplied to condor_status belong to five
24 groups:
25 • Help options provide information about the condor_status tool.
27 • Query options control the content and presentation of status informa‐
29 tion.
30 • Display options control the display of the queried information.
32 • Custom options allow the user to customize query and display informa‐
34 tion.
35 • Host options specify specific machines to be queried
37 At any time, only one help option, one query option and one display op‐
39 tion may be specified. Any number of custom options and host options
40 may be specified.
41
43 -debug Causes debugging information to be sent to stderr, based on
44 the value of the configuration variable TOOL_DEBUG.
45 -help (Help option) Display usage information.
47 -diagnose
49 (Help option) Print out ClassAd query without performing the
50 query.
51 -absent
53 (Query option) Query for and display only absent resources.
54 -ads filename
56 (Query option) Read the set of ClassAds in the file specified
57 by filename, instead of querying the condor_collector.
58 -annex name
60 (Query option) Query for and display only resources in the
61 named annex.
62 -any (Query option) Query all ClassAds and display their type,
64 target type, and name.
65 -avail (Query option) Query condor_startd ClassAds and identify re‐
67 sources which are available.
68 -ckptsrvr
70 (Query option) Query condor_ckpt_server ClassAds and display
71 checkpoint server attributes.
72 -claimed
74 (Query option) Query condor_startd ClassAds and print infor‐
75 mation about claimed resources.
76 -cod (Query option) Display only machine ClassAds that have COD
78 claims. Information displayed includes the claim ID, the
79 owner of the claim, and the state of the COD claim.
80 -collector
82 (Query option) Query condor_collector ClassAds and display
83 attributes.
84 -defrag
86 (Query option) Query condor_defrag ClassAds.
87 -direct hostname
89 (Query option) Go directly to the given host name to get the
90 ClassAds to display. By default, returns the condor_startd
91 ClassAd. If -schedd is also given, return the condor_schedd
92 ClassAd on that host.
93 -java (Query option) Display only Java-capable resources.
95 -license
97 (Query option) Display license attributes.
98 -master
100 (Query option) Query condor_master ClassAds and display dae‐
101 mon master attributes.
102 -negotiator
104 (Query option) Query condor_negotiator ClassAds and display
105 attributes.
106 -pool centralmanagerhostname[:portnumber]
108 (Query option) Query the specified central manager using an
109 optional port number. condor_status queries the machine spec‐
110 ified by the configuration variable COLLECTOR_HOST by de‐
111 fault.
112 -run (Query option) Display information about machines currently
114 running jobs.
115 -schedd
117 (Query option) Query condor_schedd ClassAds and display at‐
118 tributes.
119 -server
121 (Query option) Query condor_startd ClassAds and display re‐
122 source attributes.
123 -startd
125 (Query option) Query condor_startd ClassAds.
126 -state (Query option) Query condor_startd ClassAds and display re‐
128 source state information.
129 -statistics WhichStatistics
131 (Query option) Can only be used if the -direct option has
132 been specified. Identifies which Statistics attributes to in‐
133 clude in the ClassAd. WhichStatistics is specified using the
134 same syntax as defined for STATISTICS_TO_PUBLISH. A defini‐
135 tion is in the HTCondor Administrator's manual section on
136 configuration (HTCondor-wide Configuration File Entries).
137 -storage
139 (Query option) Display attributes of machines with network
140 storage resources.
141 -submitters
143 (Query option) Query ClassAds sent by submitters and display
144 important submitter attributes.
145 -subsystem type
147 (Query option) If type is one of collector, negotiator, mas‐
148 ter, schedd, or startd, then behavior is the same as the
149 query option without the -subsystem option. For example,
150 -subsystem collector is the same as -collector. A value of
151 type of CkptServer, Machine, DaemonMaster, or Scheduler tar‐
152 gets that type of ClassAd.
153 -vm (Query option) Query condor_startd ClassAds, and display only
155 VM-enabled machines. Information displayed includes the ma‐
156 chine name, the virtual machine software version, the state
157 of machine, the virtual machine memory, and the type of net‐
158 working.
159 -offline
161 (Query option) Query condor_startd ClassAds, and display, for
162 each machine with at least one offline universe, which uni‐
163 verses are offline for it.
164 -attributes Attr1[,Attr2 ...]
166 (Display option) Explicitly list the attributes in a comma
167 separated list which should be displayed when using the -xml,
168 -json or -long options. Limiting the number of attributes in‐
169 creases the efficiency of the query.
170 -expert
172 (Display option) Display shortened error messages.
173 -long (Display option) Display entire ClassAds. Implies that totals
175 will not be displayed.
176 -limit num
178 (Query option) At most num results should be displayed.
179 -sort expr
181 (Display option) Change the display order to be based on as‐
182 cending values of an evaluated expression given by expr.
183 Evaluated expressions of a string type are in a case insensi‐
184 tive alphabetical order. If multiple -sort arguments appear
185 on the command line, the primary sort will be on the leftmost
186 one within the command line, and it is numbered 0. A sec‐
187 ondary sort will be based on the second expression, and it is
188 numbered 1. For informational or debugging purposes, the
189 ClassAd output to be displayed will appear as if the ClassAd
190 had two additional attributes. CondorStatusSortKeyExpr<N> is
191 the expression, where <N> is replaced by the number of the
192 sort. CondorStatusSortKey<N> gives the result of evaluating
193 the sort expression that is numbered <N>.
194 -total (Display option) Display totals only.
196 -xml (Display option) Display entire ClassAds, in XML format. The
198 XML format is fully defined in the reference manual, obtained
199 from the ClassAds web page, with a link at
200 http://htcondor.org/classad/classad.html.
201 -json (Display option) Display entire ClassAds in JSON format.
203 -constraint const
205 (Custom option) Add constraint expression.
206 -compact
208 (Custom option) Show compact form, rolling up slots into a
209 single line.
210 -format fmt attr
212 (Custom option) Display attribute or expression attr in for‐
213 mat fmt. To display the attribute or expression the format
214 must contain a single printf(3)-style conversion specifier.
215 Attributes must be from the resource ClassAd. Expressions are
216 ClassAd expressions and may refer to attributes in the re‐
217 source ClassAd. If the attribute is not present in a given
218 ClassAd and cannot be parsed as an expression, then the for‐
219 mat option will be silently skipped. %r prints the unevalu‐
220 ated, or raw values. The conversion specifier must match the
221 type of the attribute or expression. %s is suitable for
222 strings such as Name, %d for integers such as LastHeardFrom,
223 and %f for floating point numbers such as LoadAvg. %v identi‐
224 fies the type of the attribute, and then prints the value in
225 an appropriate format. %V identifies the type of the attri‐
226 bute, and then prints the value in an appropriate format as
227 it would appear in the -long format. As an example, strings
228 used with %V will have quote marks. An incorrect format will
229 result in undefined behavior. Do not use more than one con‐
230 version specifier in a given format. More than one conversion
231 specifier will result in undefined behavior. To output multi‐
232 ple attributes repeat the -format option once for each de‐
233 sired attribute. Like printf(3)-style formats, one may in‐
234 clude other text that will be reproduced directly. A format
235 without any conversion specifiers may be specified, but an
236 attribute is still required. Include a backslash followed by
237 an 'n' to specify a line break.
238 -autoformat[:lhVr,tng] attr1 [attr2 ...] or -af[:lhVr,tng] attr1
240 [attr2 ...]
241 (Output option) Display attribute(s) or expression(s) format‐
242 ted in a default way according to attribute types. This op‐
243 tion takes an arbitrary number of attribute names as argu‐
244 ments, and prints out their values, with a space between each
245 value and a newline character after the last value. It is
246 like the -format option without format strings. This output
247 option does not work in conjunction with the -run option.
248 It is assumed that no attribute names begin with a dash char‐
250 acter, so that the next word that begins with dash is the
251 start of the next option. The autoformat option may be fol‐
252 lowed by a colon character and formatting qualifiers to devi‐
253 ate the output formatting from the default:
254 l label each field,
256 h print column headings before the first line of output,
258 V use %V rather than %v for formatting (string values are
260 quoted),
261 r print "raw", or unevaluated values,
263 , add a comma character after each field,
265 t add a tab character before each field instead of the de‐
267 fault space character,
268 n add a newline character after each field,
270 g add a newline character between ClassAds, and suppress spa‐
272 ces before each field.
273 Use -af:h to get tabular values with headings.
275 Use -af:lrng to get -long equivalent format.
277 The newline and comma characters may not be used together.
279 The l and h characters may not be used together.
280 -target filename
282 (Custom option) Where evaluation requires a target ClassAd to
283 evaluate against, file filename contains the target ClassAd.
284 -merge filename
286 (Custom option) Ads will be read from filename, which may be
287 - to indicate standard in, and compared to the ads selected
288 by the query specified by the remainder of the command line.
289 Ads will be considered the same if their sort keys match;
290 sort keys may be specified with [-sort <key>]. This option
291 will cause up to three tables to print, in the following or‐
292 der, depending on where a given ad appeared: first, the ads
293 which appeared in the query but not in filename; second, the
294 ads which appeared in both the query and in filename; third,
295 the ads which appeared in filename but not in the query.
296 By default, banners will label each table. If -xml is also
298 given, the same banners will separate three valid XML docu‐
299 ments, one for each table. If -json is also given, a single
300 JSON object will be produced, with the usual JSON output for
301 each table labeled as an element in the object.
302 The -annex option changes this default so that the banners
304 are not printed and the tables are formatted differently. In
305 this case, the ads in filename are expected to have different
306 contents from the ads in the query, so many others will be‐
307 have strangely.
308
310 • The default output from condor_status is formatted to be human read‐
311 able, not script readable. In an effort to make the output fit within
312 80 characters, values in some fields might be truncated. Further‐
313 more, the HTCondor Project can (and does) change the formatting of
314 this default output as we see fit. Therefore, any script that is at‐
315 tempting to parse data from condor_status is strongly encouraged to
316 use the -format option (described above).
317 • The information obtained from condor_startd and condor_schedd daemons
319 may sometimes appear to be inconsistent. This is normal since con‐
320 dor_startd and condor_schedd daemons update the HTCondor manager at
321 different rates, and since there is a delay as information propagates
322 through the network and the system.
323 • Note that the ActivityTime in the Idle state is not the amount of
325 time that the machine has been idle. See the section on condor_startd
326 states in the Administrator's Manual for more information (‐
327 Installation, Start Up, Shut Down, and Reconfiguration).
328 • When using condor_status on a pool with SMP machines, you can either
330 provide the host name, in which case you will get back information
331 about all slots that are represented on that host, or you can list
332 specific slots by name. See the examples below for details.
333 • If you specify host names, without domains, HTCondor will automati‐
335 cally try to resolve those host names into fully qualified host names
336 for you. This also works when specifying specific nodes of an SMP ma‐
337 chine. In this case, everything after the "@" sign is treated as a
338 host name and that is what is resolved.
339 • You can use the -direct option in conjunction with almost any other
341 set of options. However, at this time, the only daemon that will al‐
342 low direct queries for its ad(s) is the condor_startd. So, the only
343 options currently not supported with -direct are -schedd and -master.
344 Most other options use startd ads for their information, so they work
345 seamlessly with -direct. The only other restriction on -direct is
346 that you may only use 1 -direct option at a time. If you want to
347 query information directly from multiple hosts, you must run con‐
348 dor_status multiple times.
349 • Unless you use the local host name with -direct, condor_status will
351 still have to contact a collector to find the address where the spec‐
352 ified daemon is listening. So, using a -pool option in conjunction
353 with -direct just tells condor_status which collector to query to
354 find the address of the daemon you want. The information actually
355 displayed will still be retrieved directly from the daemon you speci‐
356 fied as the argument to -direct.
357
359 Example 1 To view information from all nodes of an SMP machine, use
360 only the host name. For example, if you had a 4-CPU machine, named vul‐
361 ture.cs.wisc.edu, you might see
362 % condor_status vulture
364 Name OpSys Arch State Activity LoadAv Mem ActvtyTime
366 slot1@vulture.cs.w LINUX INTEL Claimed Busy 1.050 512 0+01:47:42
368 slot2@vulture.cs.w LINUX INTEL Claimed Busy 1.000 512 0+01:48:19
369 slot3@vulture.cs.w LINUX INTEL Unclaimed Idle 0.070 512 1+11:05:32
370 slot4@vulture.cs.w LINUX INTEL Unclaimed Idle 0.000 512 1+11:05:34
371 Total Owner Claimed Unclaimed Matched Preempting Backfill
373 INTEL/LINUX 4 0 2 2 0 0 0
375 Total 4 0 2 2 0 0 0
377 Example 2 To view information from a specific nodes of an SMP machine,
379 specify the node directly. You do this by providing the name of the
380 slot. This has the form slot#@hostname. For example:
381 % condor_status slot3@vulture
383 Name OpSys Arch State Activity LoadAv Mem ActvtyTime
385 slot3@vulture.cs.w LINUX INTEL Unclaimed Idle 0.070 512 1+11:10:32
387 Total Owner Claimed Unclaimed Matched Preempting Backfill
389 INTEL/LINUX 1 0 0 1 0 0 0
391 Total 1 0 0 1 0 0 0
393 Constraint option examples
395 The Unix command to use the constraint option to see all machines with
397 the OpSys of "LINUX":
398 % condor_status -constraint OpSys==\"LINUX\"
400 Note that quotation marks must be escaped with the backslash characters
402 for most shells.
403 The Windows command to do the same thing:
405 >condor_status -constraint " OpSys==""LINUX"" "
407 Note that quotation marks are used to delimit the single argument which
409 is the expression, and the quotation marks that identify the string
410 must be escaped by using a set of two double quote marks without any
411 intervening spaces.
412 To see all machines that are currently in the Idle state, the Unix com‐
414 mand is
415 % condor_status -constraint State==\"Idle\"
417 To see all machines that are bench marked to have a MIPS rating of more
419 than 750, the Unix command is
420 % condor_status -constraint 'Mips>750'
422 -cod option example
424 The -cod option displays the status of COD claims within a given HTCon‐
426 dor pool.
427 Name ID ClaimState TimeInState RemoteUser JobId Keyword
429 astro.cs.wi COD1 Idle 0+00:00:04 wright
430 chopin.cs.w COD1 Running 0+00:02:05 wright 3.0 fractgen
431 chopin.cs.w COD2 Suspended 0+00:10:21 wright 4.0 fractgen
432 Total Idle Running Suspended Vacating Killing
434 INTEL/LINUX 3 1 1 1 0 0
435 Total 3 1 1 1 0 0
436 -format option example To display the name and memory attributes of
438 each job ClassAd in a format that is easily parsable by other tools:
439 % condor_status -format "%s " Name -format "%d\n" Memory
441 To do the same with the autoformat option, run
443 % condor_status -autoformat Name Memory
445
447 condor_status will exit with a status value of 0 (zero) upon success,
448 and it will exit with the value 1 (one) upon failure.
449
451 HTCondor Team
452
454 1990-2022, Center for High Throughput Computing, Computer Sciences De‐
455 partment, University of Wisconsin-Madison, Madison, WI, US. Licensed
456 under the Apache License, Version 2.0.
4578.8 Jun 13, 2022 CONDOR_STATUS(1)