.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "CONDOR_FETCHLOG" "1" "Apr 01, 2024" "" "HTCondor Manual"
.SH NAME
condor_fetchlog \- HTCondor Manual
.sp
Retrieve a daemon\(aqs log file that is located on another computer
 
 
.SH SYNOPSIS
.sp
\fBcondor_fetchlog\fP [\fB\-help | \-version\fP ]
.sp
\fBcondor_fetchlog\fP
[\fB\-pool\fP \fIcentralmanagerhostname[:portnumber]\fP] [\fB\-master |
\-startd | \-schedd | \-collector | \-negotiator | \-kbdd\fP ]
\fImachine\-name\fP \fIsubsystem[.extension]\fP
.SH DESCRIPTION
.sp
\fIcondor_fetchlog\fP contacts HTCondor running on the machine specified by
\fImachine\-name\fP, and asks it to return a log file from that machine.
Which log file is determined from the \fIsubsystem[.extension]\fP argument.
The log file is printed to standard output. This command eliminates the
need to remotely log in to a machine in order to retrieve a daemon\(aqs log
file.
.sp
For security purposes of authentication and authorization, this command
requires \fBADMINISTRATOR\fP level of access.
.sp
The \fIsubsystem[.extension]\fP argument is utilized to construct the log
file\(aqs name. Without an optional \fI\&.extension\fP, the value of the
configuration variable named \fIsubsystem\fP _LOG defines the log file\(aqs
name. When specified, the \fI\&.extension\fP is appended to this value.
.sp
The \fIsubsystem\fP argument is any value \fB$(SUBSYSTEM)\fP that has a
defined configuration variable of \fB$(SUBSYSTEM)_LOG\fP, or any of
.INDENT 0.0
.IP \(bu 2
\fBNEGOTIATOR_MATCH\fP
.IP \(bu 2
\fI\%HISTORY\fP
.IP \(bu 2
\fI\%STARTD_HISTORY\fP
.UNINDENT
.sp
A value for the optional \fI\&.extension\fP to the \fIsubsystem\fP argument is
typically one of the three strings:
.INDENT 0.0
.IP 1. 3
\fB\&.old\fP
.IP 2. 3
\fB\&.slot<X>\fP
.IP 3. 3
\fB\&.slot<X>.old\fP
.UNINDENT
.sp
Within these strings, <X> is substituted with the slot number.
.sp
A \fIsubsystem\fP argument of \fI\%STARTD_HISTORY\fP fetches all
\fIcondor_startd\fP history by concatenating all instances of log files
resulting from rotation.
.SH OPTIONS
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
\fB\-help\fP
Display usage information
.TP
\fB\-version\fP
Display version information
.TP
\fB\-pool\fP \fIcentralmanagerhostname[:portnumber]\fP
Specify a pool by giving the central manager\(aqs host name and an
optional port number
.TP
\fB\-master\fP
Send the command to the \fIcondor_master\fP daemon (default)
.TP
\fB\-startd\fP
Send the command to the \fIcondor_startd\fP daemon
.TP
\fB\-schedd\fP
Send the command to the \fIcondor_schedd\fP daemon
.TP
\fB\-collector\fP
Send the command to the \fIcondor_collector\fP daemon
.TP
\fB\-kbdd\fP
Send the command to the \fIcondor_kbdd\fP daemon
.UNINDENT
.UNINDENT
.UNINDENT
.SH EXAMPLES
.sp
To get the \fIcondor_negotiator\fP daemon\(aqs log from a host named
\fBhead.example.com\fP from within the current pool:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ condor_fetchlog head.example.com NEGOTIATOR
.EE
.UNINDENT
.UNINDENT
.sp
To get the \fIcondor_startd\fP daemon\(aqs log from a host named
\fBexecute.example.com\fP from within the current pool:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ condor_fetchlog execute.example.com STARTD
.EE
.UNINDENT
.UNINDENT
.sp
This command requested the \fIcondor_startd\fP daemon\(aqs log from the
\fIcondor_master\fP\&. If the \fIcondor_master\fP has crashed or is
unresponsive, ask another daemon running on that computer to return the
log. For example, ask the \fIcondor_startd\fP daemon to return the
\fIcondor_master\fP \(aqs log:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ condor_fetchlog \-startd execute.example.com MASTER
.EE
.UNINDENT
.UNINDENT
.SH EXIT STATUS
.sp
\fIcondor_fetchlog\fP will exit with a status value of 0 (zero) upon
success, and it will exit with the value 1 (one) upon failure.
.SH AUTHOR
HTCondor Team
.SH COPYRIGHT
1990-2024, Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.
.\" Generated by docutils manpage writer.
.