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

FreeBSD Manual Pages


home | help
just-man-pages/condor_who(1)General Commands Manuajust-man-pages/condor_who(1)

       condor_who Display information about owners of jobs and jobs running on
       an execute machine

       condor_who [ help options ] [ address options ] [ display options ]

       condor_who queries and displays information about the  user  that  owns
       the  jobs  running on a machine.	It is intended to be run on an execute

       The options that	may be supplied	to condor_who belong to	three groups:

	  * Help options provide information about the condor_who tool.

	  * Address options allow destination specification for	query.

	  * Display options control the	formatting and which  of  the  queried
	  information to display.

       At  any time, only one help option and one address option may be	speci-
       fied. Any number	of display options may be specified.

       condor_who obtains its information about	jobs by	talking	to one or more
       condor_startd daemons. So, condor_who must identify the command port of
       any condor_startd daemons. An address option provides this information.
       If  no  address	option	is  given on the command line, then condor_who
       searches	using this ordering:

	  1. A defined value of	the environment	variable  CONDOR_CONFIG	speci-
	  fies the directory where log and address files are to	be scanned for
	  needed information.

	  2. With the aim of finding  all  condor_startd  daemons,  condor_who
	  utilizes  the	same algorithm it would	using the -allpids option. The
	  Linux	ps or the Windows tasklist program obtains all PIDs. As	 Linux
	  root	or Windows  administrator , the	Linux lsof or the Windows net-
	  stat identifies open sockets and from	there the PIDs of listen sock-
	  ets.	Correlating  the  two lists of PIDs results in identifying the
	  command ports	of all condor_startd daemons.


	  (help	option)	Display	usage information


	  (help	option)	Display	information about the daemons running  on  the
	  specified  machine,  including the daemon's PID, IP address and com-
	  mand port


	  (help	option)	Display	extra information helpful for debugging


	  (help	option)	Display	PIDs and addresses of daemons

       -address	hostaddress

	  (address option) Identify the	condor_startd host address to query


	  (address option) Query all local condor_startd daemons

       -logdir directoryname

	  (address option) Specifies the directory containing log and  address
	  files	 that condor_who will scan to search for command ports of con-
	  dor_start daemons to query

       -pid PID

	  (address option) Use the given PID  to  identify  the	 condor_startd
	  daemon to query


	  (display option) Display entire ClassAds


	  (display option) Displays fields without truncating them in order to
	  fit screen width

       -format fmt attr

	  (display option) Display attribute 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. %r prints  the  un-
	  evaluated,  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 ...]

	  (display  option) Display attribute(s) or expression(s) formatted in
	  a default way	according to attribute types. This option takes	an ar-
	  bitrary 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

	  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.

       Example 1 Sample	output from the	local machine, which is	running	a sin-
       gle HTCondor job. Note that the output of the  PROGRAM  field  will  be
       truncated  to  fit  the	display,  similar to the artificial truncation
       shown in	this example output.

       % condor_who

       PROGRAM     2 320.0 0+00:00:08 7776

       Example 2 Verbose sample	output.

       % condor_who -verbose

       LOG directory "D:\scratch\condor\master\test/log"

       Daemon	    PID	     Exit	Addr			 Log, Log.Old
       ------	    ---	     ----	----			 ---, -------
       Collector     6788		  <>	 CollectorLog,
       Credd	     8148		  <>	CredLog, Cred-
       Master	    5976		<> MasterLog,
       Match MatchLog, MatchLog.old
       Negotiator   6600 NegotiatorLog,	NegotiatorLog.old
       Schedd	      6336		    <>   SchedLog,
       Shadow ShadowLog,
       Slot1 StarterLog.slot1,
       Slot2	       7272		     <>   Starter-
       Slot3 StarterLog.slot3,
       Slot4 StarterLog.slot4,
       SoftKill	SoftKillLog,
       Startd	      7416		    <>   StartLog,
       Starter StarterLog,
       TOOL							 TOOLLog,

       PROGRAM    2 320.0  0+00:01:28  7776

Exit Status
       condor_who  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_who(1)

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

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

home | help