xenial (1) condor_who.1.gz

Provided by: htcondor_8.4.2~dfsg.1-1build1_amd64 bug

Name

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

Synopsis

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

Description

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

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

Options

       -help

          (help option) Display usage information

       -daemons

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

       -diagnostic

          (help option) Display extra information helpful for debugging

       -verbose

          (help option) Display PIDs and addresses of daemons

       -address hostaddress

          (address option) Identify the condor_startdhost address to query

       -allpids

          (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

       -long

          (display option) Display entire ClassAds

       -wide

          (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.  %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 -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[:rtn,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:

          rprint unevaluated, or raw values,

          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.

Examples

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

       OWNER                    CLIENT            SLOT JOB RUNTIME    PID    PROGRAM
       smith1@crane.cs.wisc.edu crane.cs.wisc.edu    2 320.0 0+00:00:08 7776 D:\scratch\condor\execut

       Example 2Verbose sample output.

       % condor_who  -verbose

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

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

       OWNER                    CLIENT            SLOT JOB RUNTIME    PID    PROGRAM
       smith1@crane.cs.wisc.edu crane.cs.wisc.edu    2 320.0 0+00:01:28 7776 D:\scratch\condor\execut

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.

Author

       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.

                                                  February 2016                                    condor_who(1)