-help Display usage information and exit.
-namename
Query the named condor_schedd daemon. If used with -startd, query the named condor_startd
daemon
-poolcentralmanagerhostname[:portnumber]
Use the centralmanagerhostname as the central manager to locate condor_schedd daemons. The
default is the COLLECTOR_HOST, as specified in the configuration.
-backwards
List jobs in reverse chronological order. The job most recently added to the history file is
first. This is the default ordering.
-forwards
List jobs in chronological order. The job most recently added to the history file is last. At
least 4 characters must be given to distinguish this option from the -file and -format options.
-constraintexpr
Display jobs that satisfy the expression.
-sincejobidorexpr
Stop scanning when the given jobid is found or when the expression becomes true.
-completedsincetime_expr
Scan until the first job that completed on or before the given unix timestamp. The argument
can be any expression that evaluates to a unix timestamp. This option is equivalent to -since'CompletionDate<=time_expr'.
-scanlimitNumber
Stop scanning when the given number of ads have been read.
-limitNumber
Limit the number of jobs displayed to Number. Same option as -match.
-matchNumber
Limit the number of jobs displayed to Number. Same option as -limit.
-local Read from local history files even if there is a SCHEDD_HOST configured.
-startd
Read from Startd history files rather than Schedd history files. If used with the -name
option, query is sent as a command to the given Startd which must be version 9.0 or later.
-epochs[:d]
Read per job run instance recording also known as job epochs instead of default history file.
The -epochs option may be followed by a colon character for extra functionality:
d Delete job epoch files after finished reading. This option only deletes epoch files store
within JOB_EPOCH_HISTORY_DIR, and can not be used with -match, -limit, or -scanlimit.
-filefilename
Use the specified file instead of the default history file.
-userlogfilename
Display jobs, with job information coming from a job event log, instead of from the default
history file. A job event log does not contain all of the job information, so some fields in
the normal output of condor_history will be blank.
-searchpath
Use the specified path to filename and all matching condor time rotated files
filename.YYYYMMDDTHHMMSS instead of the default history file. If used with -dir option then
condor_history will use the provided path as the directory to search for specific pattern
matching history files.
-dir or -directory
Search for files in a sources alternate directory configuration knob to read from instead of
default history file. Note: only applies to -epochs.
-formatformatString AttributeName
Display jobs with a custom format. See the condor_q man page -format option for details.
-autoformat[:jlhVr,tng]attr1[attr2...] or -af[:jlhVr,tng]attr1[attr2...]
(output option) Display attribute(s) or expression(s) formatted in a default way according to
attribute types. This option takes an arbitrary number of attribute names as arguments, and
prints out their values, with a space between each value and a newline character after the last
value. It is like the -format option without format strings.
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 default:
j print the job ID as the first field,
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 character,
n add a newline character after each field,
g add a newline character between ClassAds, and suppress spaces before 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.
-print-formatfile
Read output formatting information from the given custom print format file. see PrintFormats
for more information about custom print format files.
-l or -long
Display job ClassAds in long format.
-attributesattrs
Display only the given attributes when the -longo ption is used.
-xml Display job ClassAds in XML format. The XML format is fully defined in the reference manual,
obtained from the ClassAds web page, with a link at http://htcondor.org/classad/classad.html.
-json Display job ClassAds in JSON format.
-jsonl Display job ClassAds in JSON-Lines format: one job ad per line.
-wide[:number]
Restrict output to the given column width. Default width is 80 columns, if -wide is used
without the optional number argument, the width of the output is not restricted.
Install Now
PNG Icons
