Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
just-man-pages/condor_statusGeneral Commands Majust-man-pages/condor_status(1)

       condor_status Display status of the HTCondor pool

       condor_status  [	 -debug	] [ help options ] [ query options ] [ display
       options ] [ custom options ] [ name ...	]

       condor_status is	a versatile tool that may be used to monitor and query
       the HTCondor 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

	  * Help options provide information about the condor_status tool.

	  * Query options control the content and presentation of  status  in-

	  * Display options control the	display	of the queried information.

	  *  Custom  options allow the user to customize query and display in-

	  * Host options specify specific machines to be queried

       At any time, only one help option , one query option  and  one  display
       option  may be specified. Any number of custom options and host options
       may be specified.


	  Causes debugging information to be sent to  stderr ,	based  on  the
	  value	of the configuration variable  TOOL_DEBUG


	  (Help	option)	Display	usage information.


	  (Help	option)	Print out ClassAd query	without	performing the query.


	  (Query option) Query for and display only absent resources.

       -ads filename

	  (Query  option)  Read	 the  set of ClassAds in the file specified by
	  filename , instead of	querying the condor_collector .


	  (Query option) Query all ClassAds and	 display  their	 type,	target
	  type,	and name.


	  (Query  option)  Query condor_startd ClassAds	and identify resources
	  which	are available.


	  (Query option) Query condor_ckpt_server ClassAds and display	check-
	  point	server attributes.


	  (Query  option)  Query  condor_startd	ClassAds and print information
	  about	claimed	resources.


	  (Query option) Display only machine ClassAds that have  COD  claims.
	  Information displayed	includes the claim ID, the owner of the	claim,
	  and the state	of the COD claim.


	  (Query option)  Query	 condor_collector  ClassAds  and  display  at-


	  (Query option) Query condor_defrag ClassAds.

       -direct hostname

	  (Query  option)  Go directly to the given host name to get the Clas-
	  sAds to display. By default, returns the condor_startd  ClassAd.  If
	  -schedd  is  also  given,  return  the condor_schedd ClassAd on that


	  (Query option) Display only Java-capable resources.


	  (Query option) Display license attributes.


	  (Query option) Query condor_master ClassAds and display daemon  mas-
	  ter attributes.


	  (Query  option)  Query  condor_negotiator  ClassAds  and display at-

       -pool centralmanagerhostname[:portnumber]

	  (Query option) Query the specified central manager using an optional
	  port	number.	  condor_status	 queries  the machine specified	by the
	  configuration	variable  COLLECTOR_HOST by default.


	  (Query option) Display information about machines currently  running


	  (Query option) Query condor_schedd ClassAds and display attributes.


	  (Query option) Query condor_startd ClassAds and display resource at-


	  (Query option) Query condor_startd ClassAds.


	  (Query option) Query condor_startd  ClassAds	and  display  resource
	  state	information.

       -statistics WhichStatistics

	  (Query option) Can only be used if the -direct option	has been spec-
	  ified. Identifies which Statistics  attributes  to  include  in  the
	  ClassAd.   WhichStatistics is	specified using	the same syntax	as de-
	  fined	for  STATISTICS_TO_PUBLISH . A definition is in	 the  HTCondor
	  Administrator's manual section on configuration.


	  (Query  option)  Display attributes of machines with network storage


	  (Query option) Query ClassAds	sent by	submitters and display	impor-
	  tant submitter attributes.

       -subsystem type

	  (Query  option)  If type is one of collector , negotiator , master ,
	  schedd , startd , or quill , then behavior is	the same as the	 query
	  option  without  the -subsystem option. For example, -subsystem col-
	  lector is the	same as	-collector . A value of	type of	 CkptServer  ,
	  Machine , DaemonMaster , or Scheduler	targets	that type of ClassAd.


	  (Query option) Query condor_startd ClassAds, and display only	VM-en-
	  abled	machines. Information displayed	includes the machine name, the
	  virtual  machine software version, the state of machine, the virtual
	  machine memory, and the type of networking.


	  (Query option) Query condor_startd ClassAds, and display,  for  each
	  machine with at least	one offline universe, which universes are off-
	  line for it.

       -attributes 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


	  (Display option) Display shortened error messages.


	  (Display option) Display entire ClassAds (same as -verbose ).

       -sort expr

	  (Display  option)  Change the	display	order to be based on ascending
	  values of an evaluated expression given by expr . Evaluated  expres-
	  sions	of a string type are in	a case insensitive alphabetical	order.
	  If multiple -sort arguments appear on	the command line, the  primary
	  sort	will be	on the leftmost	one within the command line, and it is
	  numbered 0. A	secondary sort will be based on	the second expression,
	  and  it  is numbered 1. For informational or debugging purposes, the
	  ClassAd output to be displayed will appear as	if the ClassAd had two
	  additional  attributes.   CondorStatusSortKeyExpr<N>	is the expres-
	  sion,	where  <N> is replaced by the number of	the sort.   CondorSta-
	  tusSortKey<N>	 gives	the  result  of	evaluating the sort expression
	  that is numbered  <N>	.


	  (Display option) Display totals only.


	  (Display option) Display entire ClassAds. Implies that  totals  will
	  not be displayed.


	  (Display  option)  Display  entire  ClassAds,	in XML format. The XML
	  format is fully defined in the reference manual, obtained  from  the
	  ClassAds web page, with a link at

       -constraint const

	  (Custom option) Add constraint expression.

       -format 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 expres-
	  sion,	then the format	option will be silently	skipped. %r prints the
	  unevaluated,	or raw values. 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 -long format. 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 at-
	  tributes 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 n to
	  specify a line break.

       -autoformat[:lhVr,tng]  attr1  [attr2  ...]   or	 -af[:lhVr,tng]	 attr1
       [attr2 ...]

	  (Output option) Display attribute(s) or expression(s)	formatted in a
	  default way according	to attribute types. This option	takes an arbi-
	  trary	 number	 of attribute names as arguments, and prints out their
	  values, with a space between each value and a	newline	character  af-
	  ter  the  last  value.  It is	like the -format option	without	format
	  strings. This	output option does not work in	conjunction  with  the
	  -run option.

	  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	autoformat option may be followed by a colon character
	  and formatting qualifiers to deviate the output formatting from  the

	  l label each field,

	  h print column headings before the first line	of output,

	  V use	%V rather than %v for formatting (string values	are quoted),

	  r print "raw", or unevaluated	values,

	  , add	a comma	character after	each field,

	  t add	a tab character	before each field instead of the default space

	  n add	a newline character after each field,

	  g add	a newline character between ClassAds, and suppress spaces  be-
	  fore each field.

	  Use -af:h to get tabular values with headings.

	  Use -af:lrng to get -long equivalent format.

	  The newline and comma	characters may not be used together. The l and
	  h characters may not be used together.

       -target filename

	  (Custom option) Where	evaluation requires a target ClassAd to	evalu-
	  ate against, file filename contains the target ClassAd.

General	Remarks
	  *  The  default  output  from	condor_status is formatted to be human
	  readable, not	script readable. In an effort to make the  output  fit
	  within 80 characters,	values in some fields might be truncated. Fur-
	  thermore, the	HTCondor Project can (and does)	change the  formatting
	  of  this default output as we	see fit. Therefore, any	script that is
	  attempting to	parse data from	condor_status is  strongly  encouraged
	  to use the -format option (described above).

	  * The	information obtained from condor_startd	and condor_schedd dae-
	  mons may sometimes appear to be inconsistent.	This is	 normal	 since
	  condor_startd	 and condor_schedd daemons update the HTCondor manager
	  at different rates, and since	there is a delay as information	propa-
	  gates	through	the network and	the system.

	  *  Note  that	the  ActivityTime in the  Idle state is	not the	amount
	  of time that the machine has been idle.  See	the  section  on  con-
	  dor_startd  states  in  the Administrator's Manual for more informa-

	  * When using condor_status on	a pool with SMP	machines, you can  ei-
	  ther provide the host	name, in which case you	will get back informa-
	  tion about all slots that are	represented on that host, or  you  can
	  list specific	slots by name. See the examples	below for details.

	  * If you specify host	names, without domains,	HTCondor will automat-
	  ically try to	resolve	those host names  into	fully  qualified  host
	  names	 for you. This also works when specifying specific nodes of an
	  SMP machine. In this	case,  everything  after  the  ``@''  sign  is
	  treated as a host name and that is what is resolved.

	  *  You  can  use  the	 -direct option	in conjunction with almost any
	  other	set of options.	However, at this time, the  only  daemon  that
	  will	allow  direct queries for its ad(s) is the condor_startd . So,
	  the only options currently not supported with	 -direct  are  -schedd
	  and  -master	. Most other options use startd	ads for	their informa-
	  tion,	so they	work seamlessly	with -direct . The only	other restric-
	  tion on -direct is that you may only use 1 -direct option at a time.
	  If you want to query information directly from multiple  hosts,  you
	  must run condor_status multiple times.

	  *  Unless  you  use the local	host name with -direct , condor_status
	  will still have to contact a collector to find the address where the
	  specified  daemon is listening. So, using a -pool option in conjunc-
	  tion with -direct just tells condor_status which collector to	 query
	  to find the address of the daemon you	want. The information actually
	  displayed will still be retrieved directly from the daemon you spec-
	  ified	as the argument	to -direct .

       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 , you might see

       % condor_status vulture

       Name		   OpSys       Arch    State	  Activity  LoadAv Mem

       slot1@vulture.cs.w LINUX	     INTEL   Claimed	Busy	  1.050	   512
       slot2@vulture.cs.w  LINUX       INTEL   Claimed	  Busy	   1.000   512
       slot3@vulture.cs.w LINUX	     INTEL   Unclaimed	Idle	  0.070	   512
       slot4@vulture.cs.w  LINUX       INTEL   Unclaimed  Idle	   0.000   512

			    Total Owner	Claimed	Unclaimed  Matched  Preempting

		INTEL/LINUX	 4	0	2	  2	  0	     0

		      Total	4     0	      2		2	 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

       slot3@vulture.cs.w LINUX	     INTEL   Unclaimed	Idle	  0.070	   512

			    Total  Owner  Claimed Unclaimed Matched Preempting

		INTEL/LINUX	1     0	      0		1	 0	     0

		      Total	 1	0	0	  1	  0	     0

       Constraint option examples

       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 com-
       mand 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	HTCon-
       dor 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

       -format option example To display the name  and	memory	attributes  of
       each job	ClassAd	in a format that is easily parsable by other tools:

       % condor_status -format "%s " Name -format "%d\n" Memory

       To do the same with the autoformat option, run

       % condor_status -autoformat Name	Memory

Exit Status
       condor_status  will  exit with a	status value of	0 (zero) upon success,
       and it will exit	with the value 1 (one) upon failure.

       Center for High Throughput Computing, University	of Wisconsin-Madison

       Copyright (C) 1990-2015 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.

				     date      just-man-pages/condor_status(1)

Name | Synopsis | Description | Options | General Remarks | Examples | Exit Status | Author | Copyright

Want to link to this manual page? Use this URL:

home | help