CONDOR_ADVERTISE(1)

✨ NAME ✨

okay so bestie, welcome to condor_advertise 💖 — this is a page from the HTCondor Manual, and here's the whole vibe: it sends a ClassAd to the condor_collector daemon. that's it. that's the girl. 🎀

---

🌸 SYNOPSIS 🌸

condor_advertise [-help | -version ]

condor_advertise [-pool centralmanagerhostname[:portname]] [-debug ]
[-tcp ] [-udp ] [-multiple ] [update-command [classad-filename]]

---

💅 DESCRIPTION 💅

so condor_advertise sends one or more ClassAds to the condor_collector daemon living on the central manager machine. no cap. 👑

the optional argument update-command tells you what daemon type's ClassAd is getting updated. if it's not there, it's assumed to be the update command that corresponds to the type of the (first) ClassAd. main character energy tbh. ✨

the optional argument classad-filename is the file the ClassAd(s) get read from. if classad-filename is omitted, or if it's literally the dash character (-), then the ClassAd(s) get read from standard input. and bestie, listen — you must specify update-command if you don't want to read from standard input. that's the rule. periodt.

when -multiple is specified, multiple ClassAds may be published. publishing a whole bunch of ClassAds in a single invocation of condor_advertise is more efficient than running condor_advertise once per ClassAd, and honestly why would you do it the slow way 🦋. the ClassAds are expected to be separated by one or more blank lines. when -multiple is not specified, blank lines are just ignored (for backward compatibility). but ngl, it is best not to rely on blank lines being ignored, because that may change in the future. 🙈

the update-command may be one of these strings:

UPDATE_STARTD_AD UPDATE_SCHEDD_AD UPDATE_MASTER_AD UPDATE_GATEWAY_AD
UPDATE_CKPT_SRVR_AD UPDATE_NEGOTIATOR_AD UPDATE_HAD_AD
UPDATE_AD_GENERIC UPDATE_SUBMITTOR_AD UPDATE_COLLECTOR_AD
UPDATE_LICENSE_AD UPDATE_STORAGE_AD

condor_advertise can also be used to invalidate and delete ClassAds that the condor_collector daemon is currently holding. iconic, lowkey. in that case the update-command will be one of these strings:

INVALIDATE_STARTD_ADS INVALIDATE_SCHEDD_ADS INVALIDATE_MASTER_ADS
INVALIDATE_GATEWAY_ADS INVALIDATE_CKPT_SRVR_ADS
INVALIDATE_NEGOTIATOR_ADS INVALIDATE_HAD_ADS INVALIDATE_ADS_GENERIC
INVALIDATE_SUBMITTOR_ADS INVALIDATE_COLLECTOR_ADS
INVALIDATE_LICENSE_ADS INVALIDATE_STORAGE_ADS

for any of these INVALIDATE commands, the ClassAd in the required file will look like this:

MyType = "Query"
TargetType = "Machine"
Name = "condor.example.com"
Requirements = Name == "condor.example.com"

the definition for MyType is always Query. TargetType is set to the MyType of the ad to be deleted. this MyType is DaemonMaster for the condor_master ClassAd, Machine for the condor_startd ClassAd, Scheduler for the condor_schedd ClassAd, and Negotiator for the condor_negotiator ClassAd. slay, you know exactly which one you're deleting. 💜

Requirements is an expression evaluated within the context of ads of TargetType. when Requirements evaluates to True, the matching ad is invalidated. a full example is given below, bestie, don't worry. 🫶

---

👑 OPTIONS 👑

• -help — Display usage information ✨
• -version — Display version information 💫
• -debug — Print debugging information as the command executes. very "let me see what's happening" of it 🔍
• -multiple — Send more than one ClassAd, where the boundary between ClassAds is one or more blank lines. 🎀
• -pool centralmanagerhostname[:portname] — Specify a pool by giving the central manager's host name and an optional port number. the default is the COLLECTOR_HOST specified in the configuration file. 💖
• -tcp — Use TCP for communication. used by default if UPDATE_COLLECTOR_WITH_TCP is true. 🔥
• -udp — Use UDP for communication. 🌈

---

🦋 GENERAL REMARKS 🦋

the job and machine ClassAds are regularly updated. therefore, the result of condor_advertise is likely to be overwritten in a very short time. 😭 it is unlikely that either HTCondor users (the ones who submit jobs) or administrators will ever have a use for this command. if it is desired to update or set a ClassAd attribute, the condor_config_val command is the proper command to use. that's the one, bestie. not this one. 💅

attributes are defined in Appendix A of the HTCondor manual. 📖

for those administrators who do need condor_advertise, the following attributes may be included:

DaemonStartTime UpdateSequenceNumber

if both of the above are included, the condor_collector will automatically include the following attributes:

UpdatesTotal UpdatesLost UpdatesSequenced UpdatesHistory
    Affected by COLLECTOR_DAEMON_HISTORY_SIZE.

---

🍓 EXAMPLES 🍓

okay so imagine a machine called condor.example.com is turned off, yet its condor_startd ClassAd does not expire for another 20 minutes. 😬 to avoid this machine being matched, an administrator chooses to delete the machine's condor_startd ClassAd. create a file (called remove_file in this example) with the three required attributes:

MyType = "Query"
TargetType = "Machine"
Name = "condor.example.com"
Requirements = Name == "condor.example.com"

this file is used with the command:

$ condor_advertise INVALIDATE_STARTD_ADS remove_file

ate. no crumbs. 🔥

---

💀 EXIT STATUS 💀

condor_advertise will exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure. success means that all ClassAds were successfully sent to all condor_collector daemons. when there are multiple ClassAds or multiple condor_collector daemons, it is possible that some but not all publications succeed; in this case, the exit status is 1, indicating failure. it's giving "almost but not quite" 😭

---

💖 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. legal bestie behavior, we love to see it. ⭐

---

and that's the whole page, babe 💜 — this one's straight out of the HTCondor Manual, dated Oct 16, 2026, and it is, in fact, CONDOR_ADVERTISE(1). go forth and advertise responsibly. 👑✨