CONDOR_QUSERS(1)

📦
version 25.14.1 · 6 versions
, in fedora 43

👑 CONDOR_QUSERS(1) — the HTCondor Manual glow-up 💖

okay bestie, sit down, hydrate, because we're talking about condor_qusers — your little backstage pass to the AP's User and Project records. it's giving admin-girlboss. 🎀

✨ NAME ✨

condor_qusers — the HTCondor Manual's own tool for adding, enabling and disabling or showing Users in the AP 🦋

🌸 SYNOPSIS 🌸

condor_qusers [-help] [-version] [-debug ] [-name schedd-name] [-pool
pool-name] [-long | -af {attrs} | -format fmt attr | -usage]
[-projects[:also] ] [-user username | -constraint expression] [-add |
-remove | -enable | -disable [-reason reason-string]] {names} [-edit
{edits}]

💅 DESCRIPTION 💅

condor_qusers adds, removes, edits, enables, disables or shows User or Project records in the AP. no cap. 🫶

which records get touched is decided by name or by constraint — you pick.

⚠️ the tool will do only one of these things at a time. one. not two. it's not a multitasker, it's a specialist, periodt. 💀

and if you run it with no options at all? it just prints User records. lowkey iconic behaviour honestly. ✨

🎀 OPTIONS 🎀

  • -help — prints the usage, then exits. bye bestie 👋
  • -version — prints the version, then exits. identity reveal 💫
  • -debug — sends debugging information to stderr, and how much you get depends on the value of the configuration variable TOOL_DEBUG. 🐛
  • -name schedd-name — modify job attributes in the queue of the schedd you named.
  • -pool pool-name — modify job attributes in the queue of the schedd specified in the pool you named. 🌊
  • -user username — operate on or query the given User ClassAd.
  • -projects[:also] — operate on or query Project ClassAds. the optional :also makes it query both User and Project ClassAds. both! greedy in a slay way 💅
  • -constraint expression — operate on or query all User or Project ClassAds matching the given constraint expression. filter queen 🔍
  • -long[:json|jsonl|new|newl|xml|long] — print ClassAds in the specified form. if you don't specify a form, long form is what you get.
  • -format fmt attr — print selected attribute of the User or Project ClassAds using the given format.
  • -autoformat[:lhVrTY,tng] attr1 [attr2 ...] or -af[:lhVrTY,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's like the -format option without format strings.
🚨 this output option does not work in conjunction with any of the options -add, -enable, or -disable. pick a lane bestie.

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:

  • 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. them's the rules.
  • -aaf[:VrTY] attr1 [attr2 ...] — (output option) like -autoformat, but instead of replacing the standard output columns, it appends the specified attribute(s) as additional columns after whatever standard format or -print-format* file is in effect. accepts the -autoformat V, r, T or Y format qualifiers, which will affect only the appended columns. this option lets you add extra information to the default condor_status output without losing the standard columns. appended columns will use the column separator and row terminator characters from the format that is appended to. ➕✨
  • -usage — display CPU and Slot usage. the Completed and Removed columns as well as the CpuTime and SlotTime columns only count jobs that have left the Schedd. jobs that have completed or been removed but have not yet left the Schedd are counted as Pending. 🧮
  • -add name1 [name2 ...] — add User or Project ClassAds with the given names.
  • -remove name1 [name2 ...] — remove User or Project ClassAds with the given names. 🗑️
  • -edit attr=expr [attr2=expr2] — add custom attributes to User or Project ClassAds. use with a -constraint or name argument to select which records to edit. 📝
  • -enable name1 [name2 ...] — enable the given users, adding them if necessary. enabling a project currently has no effect. 🟢
  • -disable name1 [name2 ...] — disable the given users. disabled users cannot submit jobs. disabling a project currently has no effect. 🔴
😭 "cannot submit jobs" is not a drill, bestie.
  • -reason reason-string — provide a reason for disabling when used with -disable. the disable reason will be included in the error message when submit fails because a user is disabled. 💬

🌈 EXAMPLES 🌈

$ condor_qusers -name north.cs.wisc.edu -pool condor.cs.wisc.edu
Print users from AP north.cs.wisc.edu in the condor.cs.wisc.edu pool
$ condor_qusers -name perdita
Print users from AP perdita in the local pool
% condor_qusers -add bob
Add user bob to the local AP
% condor_qusers -disable bob -reason "talk to admin"
Disable user bob in the local AP with the reason "talk to admin"
% condor_qusers -user bob -edit 'Department="Math"'
Add a Department attribute that has the value "Math" to user bob

like. look at that. bob is literally getting a whole Department glow-up. we love to see it. 💖

🦋 GENERAL REMARKS 🦋

an AP's User ClassAds have attributes that count the number of jobs in the queue submitted by that user. the full set of attributes can be viewed with

$ condor_qusers -long

an AP's Project ClassAds also have attributes that count the number of jobs in the queue associated with that project. the full set of attributes can be viewed with

$ condor_qusers -projects -long

✨ knowledge is power, bestie. ✨

⭐ EXIT STATUS ⭐

condor_qusers will exit with a status value of 0 (zero) upon success, and it will exit with a non-zero value upon failure.

slay = 0. not slay = non-zero. iykyk. 💅

🌸 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 manual, bestie!! 🎀 this page came straight out of the HTCondor Manual, dated Oct 16, 2026 — mwah, no notes, go add some users. 💖✨🦋

📦 where this page comes from