Next: Description Up: 9. Command Reference Manual Previous: Description Contents Index
Synopsis
condor_status
[-debug]
[help options]
[query options]
[display options]
[custom options]
[name $...$]
Description
condor_status is a versatile tool that may be used to monitor and query the
Condor pool. The condor_status tool can be used to query resource
information, submitter information, checkpoint server information, and daemon
master information. The specific query sent and the resulting information
display is controlled by the query options supplied. Queries and display
formats can also be customized.
The options that may be supplied to condor_status belong to five groups:
At any time, only one help option, one query option and one custom option may be specified. Any number of custom and host options may be specified.
[-attributes/SPAN>Attr1 [,Attr2 $...$]] (Display option)
Explicitly list the attributes in a comma separated list
which should be displayed when using the -xml or -long
options. Limiting the number of attributes increases the efficiency
of the query.
[-constraint/SPAN>const] (Custom option) Add constraint
expression. See section
[-expert] (Display option) Display shortened error messages
[-long] (Display option) Display entire ClassAds
(same as -verbose)
[-sort/SPAN>attr] (Display option) Display entries in
ascending order based on the value of the named attribute
[-total] (Display option) Display totals only
[-verbose] (Display option) Display entire ClassAds. Implies
that totals will not be displayed.
[-xml] (Display option) Display entire ClassAds,
in XML format. The XML format is fully defined at
http://www.cs.wisc.edu/condor/classad/refman/.
![[*]](crossref.png)
for
details on writing expressions.
[-format/SPAN>fmt attr] (Custom option) Display attribute
or expression attr in 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.
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 -format option 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 $<146268>>$n to specify a line break.
General Remarks
Example 1 To view information from all nodes of an SMP machine, use only the host name. For example, if you had a 4-CPU machine, named vulture.cs.wisc.edu, you might see
% condor_status vulture
Name OpSys Arch State Activity LoadAv Mem ActvtyTime
slot1@vulture.cs.w LINUX INTEL Claimed Busy 1.050 512 0+01:47:42
slot2@vulture.cs.w LINUX INTEL Claimed Busy 1.000 512 0+01:48:19
slot3@vulture.cs.w LINUX INTEL Unclaimed Idle 0.070 512 1+11:05:32
slot4@vulture.cs.w LINUX INTEL Unclaimed Idle 0.000 512 1+11:05:34
Total Owner Claimed Unclaimed Matched Preempting Backfill
INTEL/LINUX 4 0 2 2 0 0 0
Total 4 0 2 2 0 0 0
Example 2 To view information from a specific nodes of an SMP machine, specify the node directly. You do this by providing the name of the slot. This has the form slot#@hostname. For example:
% condor_status slot3@vulture
Name OpSys Arch State Activity LoadAv Mem ActvtyTime
slot3@vulture.cs.w LINUX INTEL Unclaimed Idle 0.070 512 1+11:10:32
Total Owner Claimed Unclaimed Matched Preempting Backfill
INTEL/LINUX 1 0 0 1 0 0 0
Total 1 0 0 1 0 0 0
Constraint option examples
Further explanation and examples are in section 4.1.4.
The Unix command to use the constraint option to see all machines with the OpSys of "LINUX":
% condor_status -constraint OpSys==\"LINUX\"Note that quotation marks must be escaped with the backslash characters for most shells.
The Windows command to do the same thing:
>condor_status -constraint " OpSys==""LINUX"" "Note that quotation marks are used to delimit the single argument which is the expression, and the quotation marks that identify the string must be escaped by using a set of two double quote marks without any intervening spaces.
To see all machines that are currently in the Idle state, the Unix command is
% condor_status -constraint State==\"Idle\"
To see all machines that are bench marked to have a MIPS rating of more than 750, the Unix command is
% condor_status -constraint 'Mips>750'
-cod option example
The -cod option displays the status of COD claims within a given Condor pool.
Name ID ClaimState TimeInState RemoteUser JobId Keyword
astro.cs.wi COD1 Idle 0+00:00:04 wright
chopin.cs.w COD1 Running 0+00:02:05 wright 3.0 fractgen
chopin.cs.w COD2 Suspended 0+00:10:21 wright 4.0 fractgen
Total Idle Running Suspended Vacating Killing
INTEL/LINUX 3 1 1 1 0 0
Total 3 1 1 1 0 0
condor_status will exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure.
See the Condor Version 7.5.6 or http://www.condorproject.org/license for additional notices.
condor-admin@cs.wisc.edu