.\" 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_VACATE_JOB" "1" "Apr 01, 2024" "" "HTCondor Manual"
.SH NAME
condor_vacate_job \- HTCondor Manual
.sp
vacate jobs in the HTCondor queue from the hosts where they are running
  
.SH SYNOPSIS
.sp
\fBcondor_vacate_job\fP [\fB\-help | \-version\fP ]
.sp
\fBcondor_vacate_job\fP [
\fB\-pool\fP \fIcentralmanagerhostname[:portnumber]\fP |
\fB\-name\fP \fIscheddname\fP ] | [\fB\-addr\fP \fI\(dq<a.b.c.d:port>\(dq\fP]
[\fB\-fast\fP ] \fIcluster... | cluster.process... | user...\fP |
\fB\-constraint\fP \fIexpression\fP ...
.sp
\fBcondor_vacate_job\fP [
\fB\-pool\fP \fIcentralmanagerhostname[:portnumber]\fP |
\fB\-name\fP \fIscheddname\fP ] | [\fB\-addr\fP \fI\(dq<a.b.c.d:port>\(dq\fP]
[\fB\-fast\fP ] \fB\-all\fP
.SH DESCRIPTION
.sp
\fIcondor_vacate_job\fP finds one or more jobs from the HTCondor job queue
and vacates them from the host(s) where they are currently running. The
jobs remain in the job queue and return to the idle state.
.sp
A running job running will be sent a soft
kill signal (SIGTERM by default, or whatever is defined as the
\fBSoftKillSig\fP in the job ClassAd), and HTCondor will restart the job
from the beginning somewhere else.
.sp
If the \fB\-fast\fP option is used, the job(s) will be immediately killed.
.sp
If the \fB\-name\fP option is specified, the named \fIcondor_schedd\fP is
targeted for processing. If the \fB\-addr\fP option is used, the
\fIcondor_schedd\fP at the given address is targeted for processing.
Otherwise, the local \fIcondor_schedd\fP is targeted. The jobs to be
vacated are identified by one or more job identifiers, as described
below. For any given job, only the owner of the job or one of the queue
super users (defined by the \fI\%QUEUE_SUPER_USERS\fP macro) can vacate the
job.
.sp
Using \fIcondor_vacate_job\fP on jobs which are not currently running has
no effect.
.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\-name\fP \fIscheddname\fP
Send the command to a machine identified by \fIscheddname\fP
.TP
\fB\-addr\fP \fI\(dq<a.b.c.d:port>\(dq\fP
Send the command to a machine located at \fI\(dq<a.b.c.d:port>\(dq\fP
.TP
.B \fIcluster\fP
Vacate all jobs in the specified cluster
.TP
.B \fIcluster.process\fP
Vacate the specific job in the cluster
.TP
.B \fIuser\fP
Vacate jobs belonging to specified user
.TP
\fB\-constraint\fP \fIexpression\fP
Vacate all jobs which match the job ClassAd expression constraint
.TP
\fB\-all\fP
Vacate all the jobs in the queue
.TP
\fB\-fast\fP
Perform a fast vacate and hard kill the jobs
.UNINDENT
.UNINDENT
.UNINDENT
.SH GENERAL REMARKS
.sp
Do not confuse \fIcondor_vacate_job\fP with \fIcondor_vacate\fP\&.
\fIcondor_vacate\fP is given a list of hosts to vacate, regardless of what
jobs happen to be running on them. Only machine owners and
administrators have permission to use \fIcondor_vacate\fP to evict jobs
from a given host. \fIcondor_vacate_job\fP is given a list of job to
vacate, regardless of which hosts they happen to be running on. Only the
owner of the jobs or queue super users have permission to use
\fIcondor_vacate_job\fP\&.
.SH EXAMPLES
.sp
To vacate job 23.0:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ condor_vacate_job 23.0
.EE
.UNINDENT
.UNINDENT
.sp
To vacate all jobs of a user named Mary:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ condor_vacate_job mary
.EE
.UNINDENT
.UNINDENT
.sp
To vacate all vanilla universe jobs owned by Mary:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ condor_vacate_job \-constraint \(aqJobUniverse == 5 && Owner == \(dqmary\(dq\(aq
.EE
.UNINDENT
.UNINDENT
.sp
Note that the entire constraint, including the quotation marks, must be
enclosed in single quote marks for most shells.
.SH EXIT STATUS
.sp
\fIcondor_vacate_job\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.
.