table of contents
| CONDOR_RELEASE(1) | HTCondor Manual | CONDOR_RELEASE(1) |
NAME¶
condor_release - HTCondor Manual
Change held jobs back to idle.
SYNOPSIS¶
condor_release [-help | -version]
condor_release [OPTIONS] [cluster... | cluster.proc... | user...]
condor_release [-debug] [-long] [-totals] [-all] [-reason message] [-constraint expression] [-pool hostname[:portnumber] | -name scheddname | -addr "<a.b.c.d:port>"]
DESCRIPTION¶
Releases job(s) from the held state back to idle in HTCondor to allow the job(s) to be matched to resources and executed. For any given job, only the owner of the job or one of the queue super users (defined by the QUEUE_SUPER_USERS <href="../admin-manual/configuration-macros.html#QUEUE_SUPER_USERS"> macro) can release the job.
OPTIONS¶
- -help
- Display usage information.
- -version
- Display version information.
- -long
- Display result ClassAd.
- -totals
- Display success/failure totals.
- -pool hostname[:portnumber]
- Specify a pool by giving the central manager's host name and an optional port number.
- -name scheddname
- Send the command to a machine identified by scheddname.
- -addr "<a.b.c.d:port>"
- Send the command to a machine located at "<a.b.c.d:port>".
- -debug
- Causes debugging information to be sent to stderr, based on the value of the configuration variable TOOL_DEBUG <href="../admin-manual/configuration-macros.html#TOOL_DEBUG">.
- -reason message
- Sets the ReleaseReason <href="../classad-attributes/job-classad-attributes.html#ReleaseReason"> attribute to the provided message in the job(s) ClassAd.
- -constraint expression
- Release all jobs which match the job ClassAd expression constraint.
- -all
- Release all the jobs in the queue.
- cluster
- Release all jobs in the specified cluster.
- cluster.process
- Release the specific job in the cluster.
- user
- Release jobs belonging to specified user.
GENERAL REMARKS¶
If the -name option is specified, the named condor_schedd is targeted for processing. Otherwise, the local condor_schedd is targeted.
A job can be put on hold by the user who submitted the job, the AP administrator(s), or by HTCondor when something went wrong during the job's attempt to run.
Attempts to release a job not in the held state will result in a failure and the job will be unchanged.
EXIT STATUS¶
0 - Success
1 - Failure has occurred
EXAMPLES¶
To release a specific held job:
$ condor_release 432.1
Release all held jobs for user Mary:
# condor_release mary
SEE ALSO¶
condor_hold <href="../man-pages/condor_hold.html">, condor_rm <href="../man-pages/condor_rm.html">, condor_continue <href="../man-pages/condor_continue.html">, condor_suspend <href="../man-pages/condor_suspend.html">, condor_vacate_job <href="../man-pages/condor_vacate_job.html">, condor_vacate <href="../man-pages/condor_vacate.html">
AVAILABILITY¶
Linux, MacOS, Windows
Author¶
HTCondor Team
Copyright¶
1990-2026, Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.
| February 25, 2026 |