CONDOR_USERPRIO(1)

📦
version 25.14.1 · 12 versions
, in fedora 43

🌸 condor_userprio — the HTCondor Manual, bestie edition 💅

okay so picture this: it's CONDOR_USERPRIO(1), straight out of the HTCondor Manual, and it's here to let you poke at submitter priorities. yes queen. let's go 🫶

✨ NAME ✨

condor_userprio — manage submitter priorities 💖

🦋 SYNOPSIS 🦋

condor_userprio [-help]

condor_userprio [-name negotiatorname] [-inputfile filename] [-pool hostname[:port]] [Edit Option | Display Options [submitter]]

🌈 DESCRIPTION 🌈

So basically, condor_userprio is your girl for modifying or displaying priority info for submitters and/or groups, pulling straight from HTCondor's accounting. And by default? It only shows you the active submitters — meaning the ones whose usage got recorded in the last 24 hours. lowkey efficient. ✨

NOTE: 🌸 For the purposes of accounting and fair share, HTCondor "charges" usage to a submitter. A submitter, by default, is the same as the operating system user. This means one user of HTCondor, such as Taylor, may have multiple submitter accounts on different Access Points — i.e. taylor@ap1.chtc.wisc.edu and taylor@ap2.chtc.wisc.edu.

it's giving "one girly, many accounts" and honestly? iconic.

💅 OPTIONS 💅

🌟 General 🌟

  • -debug[:level] — sends debugging info to stderr, based on whatever the config variable TOOL_DEBUG says. you can toss in optional debug levels if you're feeling extra. 🔥
  • -help — shows you the tool usage info. the "help me help you" moment, periodt.
  • -inputfile filename — reads priority information from filename. 📂
  • -name negotiatorname — sends the command to a machine identified by negotiatorname. 🎀
  • -pool hostname[:port] — specify a pool by handing over the central manager's host name plus an optional port number. 🌐

🧚 Edit Options 🧚

  • -delete submitter — removes the specified submitter from HTCondor's accounting. bye boo 👋
  • -resetall — resets the accumulated usage of all the submitters to zero. clean slate energy.
  • -resetusage submitter — resets the accumulated usage of the submitter you name to zero.
  • -setaccum submitter value — sets the accumulated usage of the specified submitter to the floating point value you give it.
  • -setbegin submitter value — sets the begin usage time of the specified submitter to value.
  • -setlast submitter value — sets the last usage time of the specified submitter to value.
  • -setfactor submitter value — sets the priority factor of the specified submitter to value. and when you pair it with -duration, the priority factor becomes a temporary lease: at the next negotiation cycle on or after seconds have elapsed, the priority factor is automatically restored to its prior value. the lease state is persistent across a condor_negotiator restart. ⚠️ and it is an error to set a lease while one is already in effect for the same submitter — cancel the existing lease first with -cancelfactorlease.
  • -setprio submitter value — sets the real priority of the specified submitter to value.
  • -setceiling submitter value — sets the ceiling for the specified submitter to value. where value is the sum of the SlotWeight of all running jobs (See SLOT_WEIGHT). setting the ceiling to -1 clears any previously set ceiling, and sets the effective ceiling to unlimited. ♾️ when combined with -duration, the ceiling becomes a temporary lease: at the next negotiation cycle on or after seconds have elapsed, the ceiling is automatically restored to its prior value. lease state is persistent, so it survives a condor_negotiator restart. and again — it is an error to set a lease while one is already in effect for the same submitter; cancel the existing lease first with -cancelceilinglease.
  • -duration seconds — only valid with -setceiling, -setfloor, or -setfactor. makes the corresponding value a lease that expires after seconds seconds, at which point the prior value is restored. ⏳
  • -cancelceilinglease submitter — cancels an in-effect ceiling lease for submitter, immediately restoring the ceiling value that was in effect before the lease was set. it is an error if no lease is in effect. 🚫
  • -cancelfloorlease submitter — cancels an in-effect floor lease for submitter, immediately restoring the floor value that was in effect before the lease was set. it is an error if no lease is in effect. 🚫
  • -cancelfactorlease submitter — cancels an in-effect priority-factor lease for submitter, immediately restoring the priority factor that was in effect before the lease was set. it is an error if no lease is in effect. 🚫
  • -setfloor submitter value — sets the floor for the specified submitter to value. where value is the sum of the SlotWeight of all running jobs (See SLOT_WEIGHT). setting the floor to 0 clears any previously set floor. when combined with -duration, the floor becomes a temporary lease: at the next negotiation cycle on or after seconds have elapsed, the floor is automatically restored to its prior value. lease state is persistent across a condor_negotiator restart. and yep, you guessed it — it is an error to set a lease while one is already in effect for the same submitter; cancel the existing lease first with -cancelfloorlease.

🎀 Display Options 🎀

  • -activefrom month day year — displays info for submitters who have some recorded accumulated usage since the date you specify. 📅
  • -all — displays all available fields about each group or submitters (active). the "give me everything" option.
  • -allusers — displays information for all the submitters (active and inactive) who have some recorded accumulated usage. everyone's invited to the party 🎉
  • -collector — forces the query to come from the collector.
  • -negotiator — forces the query to come from the negotiator instead of the collector.
  • -af / -autoformat[:jlhVr,tng] Attribute [Attribute ...] — displays attribute(s) or expression(s) formatted in a default way, depending on the type of each Attribute you list after the option. it's assumed that no Attributes begin with a dash character, so the next word that begins with a dash is treated as another option. you can follow this option with a colon and formatting qualifiers to deviate the output formatting from the default:
    • j — prints the ClassAds associated JobID as the first field.
    • l — labels each field.
    • h — prints column headings before the first line of output.
    • V — uses %V rather than %v for formatting (string values are quoted).
    • r — prints "raw", or unevaluated values.
    • , — adds a comma character after each field.
    • t — adds a tab character before each field instead of the default space character.
    • n — adds a newline character after each field.
    • g — adds a newline character between ClassAds, and suppresses spaces before each field.
WARNING: ⚠️ The n and , qualifiers may not be used together. Also, the l and h qualifiers may not be used together.
  • -constraint expr — displays submitters and groups that satisfy the expression. 🧐
  • -flat — displays information such that submitters within hierarchical groups are not listed with their group.
  • -groupid — displays group ID.
  • -getreslist submitter — displays all the resources currently allocated to the submitter you specify. 🖥️
  • -grouporder — displays submitter information with accounting group entries at the top of the list, and in breadth-first order within the group hierarchy tree. 🌳
  • -grouprollup — for hierarchical groups, the display shows sums as computed for groups, and these sums include sub groups.
  • -hierarchical — displays information such that submitters within hierarchical groups are listed with their group.
  • -legacy — for use with the -long option, displays attribute names and values as a single ClassAd.
  • -long — displays ClassAds in long format.
  • -modular — modifies the display when using the -long option, such that attribute names and values are shown as distinct ClassAds.
  • -order — displays group order.
  • -priority — displays fields with submitter priority information.
  • -most — displays fields considered to be the most useful. this is the default set of fields displayed. ✨
  • -quotas — displays fields relevant to hierarchical group quotas.
  • -sortkey — displays group sort key.
  • -surplus — displays usage surplus.
  • -usage — displays usage information for each group or submitter.
  • submitter — displays information only for the specified submitter. 🎯

💅 GENERAL REMARKS 💅

okay so bestie, here's what the default tool output is gonna show you for each active submitter. Every field, every vibe, no skipping ✨

  • Effective Priority — the effective priority value of the submitter, which is used to calculate the submitter's share when allocating resources. A lower value means a higher priority (yes fr, it's backwards like that 😭), and the minimum value (highest priority) is 0.5. It's calculated by multiplying the real priority by the priority factor.
  • Priority Factor — the system administrator can set this value for each submitter, which controls a submitter's effective priority relative to other submitters. This can be used to create different classes of submitters 👑
  • Weighted In Use — the number of resources currently used.
  • Total Usage (Weighted hours) — the accumulated number of resource-hours used by the submitter since the usage start time.
  • Time Since Last Usage — elapsed time since the specific submitter last had claimed resources.
  • Submitter Floor — the minimum guaranteed number of CPU cores assigned to the specific submitter.
  • Submitter Ceiling — maximum number of CPU cores assigned to the specific submitter.

when you run it with the -all option, you get these bonus columns too 🎀

  • Real Priority — the value of the real priority of the submitter. This value follows the submitter's resource usage.
  • Usage Start Time — the time since when usage has been recorded for the submitter. This time is set when a submitter job runs for the first time. It gets reset to the present time when the usage for the submitter is reset.
  • Last Usage Time — the most recent time a resource usage has been recorded for the submitter.
🔒 for security purposes of authentication and authorization, specifying an Edit Option requires the ADMINISTRATOR level of access. no sneaky edits unless you've got the clearance, bestie 💅

🌈 EXIT STATUS 🌈

  • 0 — success, we ate 💖
  • 1 — failure has occurred 😭

✨ EXAMPLES ✨

display default info about active submitters

$ condor_userprio

display all the info about active submitters

$ condor_userprio -all

display default info for active submitters Bill and Ted associated with Access Point excellent.host.machine

$ condor_userprio bill@excellent.host.machine ted@excellent.host.machine

display default info for every submitter

$ condor_userprio -allusers

display usage info for all active submitters

$ condor_userprio -usage

remove submitter taylor@ap2.chtc.wisc.edu from HTCondor's accounting (bye bestie 🫶)

$ condor_userprio -delete taylor@ap2.chtc.wisc.edu

reset accumulated usages for all submitters to zero

$ condor_userprio -resetall

reset accumulated usage for submitter jfk@white.house.gov to zero

$ condor_userprio -resetusage jfk@white.house.gov

set submitter frodo@mount.doom.mordor accumulated usage to 6.0

$ condor_userprio -setaccum frodo@mount.doom.mordor 6.0

set submitter taylor@ap1.cthc.wisc.edu priority to 100

$ condor_userprio -setprio taylor@ap1.cthc.wisc.edu 100

set submitter taylor@ap1.cthc.wisc.edu usage ceiling to 50

$ condor_userprio -setceiling taylor@ap1.cthc.wisc.edu 50

set submitter taylor@ap1.cthc.wisc.edu usage floor floor to 5

$ condor_userprio -setfloor taylor@ap1.cthc.wisc.edu 5

👀 SEE ALSO 👀

None. literally nothing else to link, that's the whole squad 💀

🦋 AVAILABILITY 🦋

Linux, MacOS, Windows — it's giving multi-platform icon behavior ✨

💖 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 the CONDOR_USERPRIO(1) manual, dated Oct 16, 2026, from the HTCondor crew 💅 go forth and prioritize, you've totally got this 🫶💜

📦 where this page comes from