CONDOR_VACATE_JOB(1)

📦
version 25.14.1 · 12 versions
, in fedora 43

💅 condor_vacate_job — bestie's guide to HTCondor

okay so real talk, this is a page from the HTCondor Manual, and it's all about condor_vacate_job. 🦋

✨ NAME ✨

condor_vacate_job — the HTCondor Manual's own little diva of a command. She stops running job(s) and hands the resources back to the host machine(s) that were executing them. it's giving "you're done here, thank u next" 💖

✨ SYNOPSIS ✨

condor_vacate_job [-help | -version]

condor_vacate_job [OPTIONS] [cluster... | cluster.proc... | user...]

condor_vacate_job [-debug] [-long] [-totals] [-all] [-constraint
expression] [-pool hostname[:portnumber] | -name scheddname | -addr
"<a.b.c.d:port>"] [-fast]

no cap, that's literally the whole shape of it 💫

✨ DESCRIPTION ✨

So what she does: she vacates job(s) off the host machine(s) where they're currently running 🏃♀️. Resources go back to the host machine(s), and the job(s) go right back to idle so that resource matchmaking and execution can happen somewhere else. iconic behavior honestly.

And here's the cute part — vacating the job makes the condor accountant stop charging the user in terms of priority. your budget said "not today" 💸✨

But listen 👀 for any given job, only these people can vacate it:

  • the owner of the job, or
  • one of the queue super users — defined by the QUEUE_SUPER_USERS macro.

periodt. that's the whole guest list 🎀

✨ OPTIONS ✨

  • -help — Display usage information. a little "how do u do, fellow kids" moment 🫶
  • -version — Display version information. she'll tell u who she is 💁♀️
  • -long — Display result ClassAd. the full lore 📜
  • -totals — Display success/failure totals. receipts! 🧾
  • -fast — Perform a fast vacate and hard kill the jobs. no soft launch, we're going straight to the hard kill 💀🔥
  • -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>". straight to the address, iykyk 🏠
  • -constraint expression` — Vacate all jobs which match the job ClassAd expression constraint. filtering? we love to see it 🎯
  • -all — Vacate all the jobs in the queue. everyone. all of them. the whole group chat 💅
  • cluster — Vacate all jobs in the specified cluster. the whole clique 🎀
  • cluster.process — Vacate the specific job in the cluster. just the one bestie 🦋
  • user — Vacate jobs belonging to specified user. it's giving targeted 👑

🌸 GENERAL REMARKS 🌸

okay important stuff, listen up bestie 🫶

If the -name option is specified, the named condor_schedd is targeted for processing. Otherwise, the local condor_schedd is targeted. lowkey simple.

Vacated jobs will be sent a soft kill signal (SIGTERM by default, or the value of KillSig in the job's ClassAd) — unless -fast is used, in which case, yeah, hard kill, no softness 😭

Using condor_vacate_job on jobs which are not currently running has no effect. nothing. zero. the silence 💀

Jobs running in the local or scheduler universe can be vacated. And since these types of jobs run directly on the Access Point, they will always restart on the same resources and may begin executing again immediately if there is a low load or number of jobs submitted to the Access Point. so like… she might just come right back 🙈

DAGMan can also be vacated, and it will enter recovery mode upon restarting. BUT — and this is the big but — all jobs submitted and managed by DAGMan will continue running uninterrupted. 🔥

WARNING: Do not confuse this tool with condor_vacate. condor_vacate is intended for use by the owners/administrators of an Execution Point to evict jobs from their host machine. different girl, different job, do not mix them up bestie 😤

✨ EXIT STATUS ✨

  • 0 — Success 🎉
  • 1 — Failure has occurred 😭

💖 EXAMPLES 💖

To vacate a specific job:

$ condor_vacate_job 23.0

To vacate a job fast:

$ condor_vacate_job -fast 23.0

To vacate all jobs owned by user Mary:

# condor_vacate_job mary

To vacate all vanilla universe jobs owned by Mary:

# condor_vacate_job -constraint 'JobUniverse == 5 && Owner == "mary"'

look at her go 🌈

🦋 SEE ALSO 🦋

condor_vacate, condor_rm, condor_continue, condor_suspend, condor_hold, condor_release

the whole friend group honestly 🫶

✨ AVAILABILITY ✨

Linux, MacOS, Windows — she's everywhere, multi-platform queen 👑

🌈 AUTHOR 🌈

HTCondor Team 💜

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.

and that's the whole page bestie ✨ this was CONDOR_VACATE_JOB(1) from the HTCondor Manual, dated Oct 16, 2026 — go forth, vacate responsibly, and remember: never confuse her with condor_vacate 💅🫶💖

📦 where this page comes from