Provided by: htcondor_8.0.5~dfsg.1-1ubuntu1_amd64 bug


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


       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 machine.

       The options that may be supplied to condor_whobelong to three groups:

          * Help optionsprovide information about the condor_who tool.

          * Address optionsallow destination specification for query.

          *  Display  optionscontrol  the  formatting  and  which  of  the queried information to

       At any time, only one help optionand one address optionmay be  specified.  Any  number  of
       display optionsmay be specified.

       condor_whoobtains   its   information   about   jobs   by   talking   to   one   or   more
       condor_startddaemons.   So,   condor_whomust   identify   the   command   port   of    any
       condor_startddaemons.  An  address  optionprovides this information. If noaddress optionis
       given on the command line, then condor_whosearches using this ordering:

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

          2.  With  the  aim  of  finding  all condor_startddaemons, condor_who utilizes the same
          algorithm it would using the -allpidsoption. The Linux psor the Windows tasklistprogram
          obtains  all  PIDs.  As  Linux   root  or Windows  administrator , the Linux lsofor the
          Windows netstatidentifies open sockets and from  there  the  PIDs  of  listen  sockets.
          Correlating  the  two  lists  of  PIDs  results in identifying the command ports of all



          (help option) Display usage information


          (help option) Display extra information helpful for debugging


          (help option) Display PIDs and addresses of daemons

       -address hostaddress

          (address option) Identify the condor_startdhost address to query


          (address option) Query all local condor_startddaemons

       -logdir directoryname

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

       -pid PID

          (address option) Use the given PIDto identify the condor_startddaemon 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  attrin  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 . %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 -longformat. 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 attributes  repeat  the
          -formatoption  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[:tn,lVh] attr1 [attr2 ...]

          (display option) Display machine ClassAd attribute values formatted in  a  default  way
          according  to their attribute types. This option takes an arbitrary number of attribute
          names as arguments, and prints out their values. It is like the -formatoption,  but  no
          format  strings  are  required. 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 autoformatoption may be followed by a colon character and formatting qualifiers:

          tadd a tab character before each field instead of the default space character,

          nadd a newline character after each field,

          ,add a comma character after each field,

          llabel each field,

          Vuse %V rather than %v for formatting,

          hprint headings before the first line of output.

          The newline and comma characters may notbe used together.


       Example  1Sample output from the local machine, which is running a single Condor 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

       OWNER                    CLIENT            SLOT JOB RUNTIME    PID    PROGRAM        2     320.0     0+00:00:08     7776

       Example 2Verbose sample output.

       % condor_who  -verbose

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

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

       OWNER                    CLIENT            SLOT JOB RUNTIME    PID    PROGRAM        2     320.0     0+00:01:28      7776

Exit Status

       condor_whowill  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-2013  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.

                                           January 2014                             condor_who(1)