1condor_who(1)               General Commands Manual              condor_who(1)
2
3
4

Name

6       condor_whoDisplay  information about owners of jobs and jobs running on
7       an execute machine
8

Synopsis

10       condor_who[help options] [address options] [display options]
11

Description

13       condor_whoqueries and displays information about the user that owns the
14       jobs  running  on  a  machine.  It  is intended to be run on an execute
15       machine.
16
17       The options that may be supplied to condor_whobelong to three groups:
18
19          * Help optionsprovide information about the condor_whotool.
20
21          * Address optionsallow destination specification for query.
22
23          * Display optionscontrol the formatting and  which  of  the  queried
24          information to display.
25
26       At  any  time,  only one help optionand one address optionmay be speci‐
27       fied. Any number of display optionsmay be specified.
28
29       condor_whoobtains its information about jobs by talking to one or  more
30       condor_startddaemons.  So,  condor_whomust identify the command port of
31       any condor_startddaemons. An address optionprovides  this  information.
32       If   noaddress   optionis   given   on  the  command  line,  then  con‐
33       dor_whosearches using this ordering:
34
35          1. A defined value of the environment  variable  CONDOR_CONFIGspeci‐
36          fies the directory where log and address files are to be scanned for
37          needed information.
38
39          2. With the aim of finding all condor_startddaemons,  condor_whouti‐
40          lizes  the  same  algorithm  it  would using the -allpidsoption. The
41          Linux psor the Windows tasklistprogram obtains all  PIDs.  As  Linux
42          rootor Windows administrator, the Linux lsofor the Windows netstati‐
43          dentifies open sockets and from there the PIDs  of  listen  sockets.
44          Correlating the two lists of PIDs results in identifying the command
45          ports of all condor_startddaemons.
46

Options

48       -help
49
50          (help option) Display usage information
51
52
53
54       -daemons
55
56          (help option) Display information about the daemons running  on  the
57          specified  machine,  including the daemon's PID, IP address and com‐
58          mand port
59
60
61
62       -diagnostic
63
64          (help option) Display extra information helpful for debugging
65
66
67
68       -verbose
69
70          (help option) Display PIDs and addresses of daemons
71
72
73
74       -address hostaddress
75
76          (address option) Identify the condor_startdhost address to query
77
78
79
80       -allpids
81
82          (address option) Query all local condor_startddaemons
83
84
85
86       -logdir directoryname
87
88          (address option) Specifies the directory containing log and  address
89          files  that  condor_whowill scan to search for command ports of con‐
90          dor_startdaemons to query
91
92
93
94       -pid PID
95
96          (address option) Use the given PIDto identify the  condor_startddae‐
97          mon to query
98
99
100
101       -long
102
103          (display option) Display entire ClassAds
104
105
106
107       -wide
108
109          (display option) Displays fields without truncating them in order to
110          fit screen width
111
112
113
114       -format fmt attr
115
116          (display option) Display attribute attrin format fmt. To display the
117          attribute   or   expression   the   format  must  contain  a  single
118          printf(3)-style conversion specifier. Attributes must  be  from  the
119          resource  ClassAd. Expressions are ClassAd expressions and may refer
120          to attributes in the resource  ClassAd.  If  the  attribute  is  not
121          present  in  a  given ClassAd and cannot be parsed as an expression,
122          then the format option will  be  silently  skipped.  %r  prints  the
123          unevaluated,  or raw values. The conversion specifier must match the
124          type of the attribute or expression. %s is suitable for strings such
125          as  Name, %d for integers such as LastHeardFrom, and %f for floating
126          point numbers such  as  LoadAvg.  %v  identifies  the  type  of  the
127          attribute,  and  then  prints the value in an appropriate format. %V
128          identifies the type of the attribute, and then prints the  value  in
129          an  appropriate  format as it would appear in the -longformat. As an
130          example, strings used with %V will have quote  marks.  An  incorrect
131          format  will  result in undefined behavior. Do not use more than one
132          conversion specifier in a given format.  More  than  one  conversion
133          specifier  will  result  in  undefined  behavior. To output multiple
134          attributes repeat the -formatoption once for each desired attribute.
135          Like  printf(3)-style  formats, one may include other text that will
136          be reproduced directly. A format without any  conversion  specifiers
137          may  be  specified,  but  an  attribute is still required. Include a
138          backslash followed by an `n' to specify a line break.
139
140
141
142       -autoformat[:lhVr,tng] attr1 [attr2 ...]or -af[:lhVr,tng] attr1  [attr2
143       ...]
144
145          (display  option) Display attribute(s) or expression(s) formatted in
146          a default way according to attribute types.  This  option  takes  an
147          arbitrary  number  of  attribute  names as arguments, and prints out
148          their values, with a space between each value and a newline  charac‐
149          ter  after the last value. It is like the -formatoption without for‐
150          mat strings.
151
152          It is assumed that no attribute names begin with a  dash  character,
153          so that the next word that begins with dash is the start of the next
154          option. The autoformatoption may be followed by  a  colon  character
155          and  formatting qualifiers to deviate the output formatting from the
156          default:
157
158          llabel each field,
159
160          hprint column headings before the first line of output,
161
162          Vuse %V rather than %v for formatting (string values are quoted),
163
164          rprint "raw", or unevaluated values,
165
166          ,add a comma character after each field,
167
168          tadd a tab character before each field instead of the default  space
169          character,
170
171          nadd a newline character after each field,
172
173          gadd  a  newline  character  between  ClassAds,  and suppress spaces
174          before each field.
175
176          Use -af:hto get tabular values with headings.
177
178          Use -af:lrngto get -long equivalent format.
179
180          The newline and comma characters may notbe used together.  The  land
181          hcharacters may notbe used together.
182
183
184

Examples

186       Example  1Sample output from the local machine, which is running a sin‐
187       gle HTCondor job. Note that the output  of  the  PROGRAMfield  will  be
188       truncated  to  fit  the  display,  similar to the artificial truncation
189       shown in this example output.
190
191       % condor_who
192
193       OWNER                     CLIENT             SLOT  JOB  RUNTIME     PID
194       PROGRAM
195       smith1@crane.cs.wisc.edu  crane.cs.wisc.edu     2 320.0 0+00:00:08 7776
196       D:\scratch\condor\execut
197
198       Example 2Verbose sample output.
199
200       % condor_who -verbose
201
202       LOG directory "D:\scratch\condor\master\test/log"
203
204       Daemon       PID      Exit       Addr                     Log, Log.Old
205       ------       ---      ----       ----                     ---, -------
206       Collector     6788                 <128.105.136.32:7977>  CollectorLog,
207       CollectorLog.old
208       Credd         8148                 <128.105.136.32:9620> CredLog, Cred‐
209       Log.old
210       Master       5976                <128.105.136.32:64980> MasterLog,
211       Match MatchLog, MatchLog.old
212       Negotiator   6600 NegotiatorLog, NegotiatorLog.old
213       Schedd         6336                  <128.105.136.32:64985>   SchedLog,
214       SchedLog.old
215       Shadow ShadowLog,
216       Slot1 StarterLog.slot1,
217       Slot2           7272                  <128.105.136.32:65026>   Starter‐
218       Log.slot2,
219       Slot3 StarterLog.slot3,
220       Slot4 StarterLog.slot4,
221       SoftKill SoftKillLog,
222       Startd         7416                  <128.105.136.32:64984>   StartLog,
223       StartLog.old
224       Starter StarterLog,
225       TOOL                                                      TOOLLog,
226
227       OWNER                     CLIENT             SLOT  JOB  RUNTIME     PID
228       PROGRAM
229       smith1@crane.cs.wisc.edu crane.cs.wisc.edu    2 320.0  0+00:01:28  7776
230       D:\scratch\condor\execut
231

Exit Status

233       condor_whowill  exit  with a status value of 0 (zero) upon success, and
234       it will exit with the value 1 (one) upon failure.
235

Author

237       Center for High Throughput Computing, University of Wisconsin-Madison
238
240       Copyright (C) 1990-2019 Center for High Throughput Computing,  Computer
241       Sciences  Department, University of Wisconsin-Madison, Madison, WI. All
242       Rights Reserved. Licensed under the Apache License, Version 2.0.
243
244
245
246                                     date                        condor_who(1)
Impressum