---
name: "condor_update_machine_ad"
section: "1"
platform: "linux"
package: "condor"
version: "23.9.6+dfsg-2.1+b10"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/condor_update_machine_ad"
---

# condor\_update\_machine\_ad(1)

HTCondor Manual update a machine ClassAd

## NAME

condor\_update\_machine\_ad - HTCondor Manual

update a machine ClassAd

## SYNOPSIS

**condor\_update\_machine\_ad** \[**-help \| -version** \]

**condor\_update\_machine\_ad** \[**-pool** *centralmanagerhostname\[:portnumber\]*\] \[**-name** *startdname*\] *path/to/update-ad*

## DESCRIPTION

*condor\_update\_machine\_ad* modifies the specified *condor\_startd* daemon's machine ClassAd. The ClassAd in the file given by **path/to/update-ad** represents the changed attributes. The changes persists until the *condor\_startd* restarts. If no file is specified on the command line, *condor\_update\_machine\_ad* reads the update ClassAd from **stdin**.

Contents of the file or **stdin** must contain a complete ClassAd. Each line must be terminated by a newline character, including the last line of the file. Lines are of the form

```
<attribute> = <value>
```

Changes to certain ClassAd attributes will cause the *condor\_startd* to regenerate values for other ClassAd attributes. An example of this is setting *HasVM*. This will cause *OfflineUniverses*, *VMOfflineTime*, and *VMOfflineReason* to change.

## OPTIONS

- **-help**

  Display usage information and exit

- **-version**

  Display the HTCondor version and exit

- **-pool** *centralmanagerhostname\[:portnumber\]*

  Specify a pool by giving the central manager's host name and an optional port number

- **-name** *startdname*

  Send the command to a machine identified by *startdname*

## GENERAL REMARKS

This tool is intended for the use of system administrators when dealing with offline universes.

## EXAMPLES

To re-enable matching with the VM universe jobs, place on **stdin** a complete ClassAd (including the ending newline character) to change the value of ClassAd attribute *HasVM*:

```
$ echo "HasVM = True
" | condor_update_machine_ad
```

To prevent vm universe jobs from matching with the machine:

```
$ echo "HasVM = False
" | condor_update_machine_ad
```

To prevent vm universe jobs from matching with the machine and specify a reason:

```
$ echo "HasVM = False
VMOfflineReason = \"Cosmic rays.\"
" | condor_update_machine_ad
```

Note that the quotes around the reason are required by ClassAds, and they must be escaped because of the shell. Using a file instead of **stdin** may be preferable in these situations, because neither quoting nor escape characters are needed.

## EXIT STATUS

*condor\_update\_machine\_ad* will exit with a status value of 0 (zero) upon success, and it will exit with the value 1 (one) upon failure.

## AUTHOR

HTCondor Team

## COPYRIGHT

1990-2024, Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI, US. Licensed under the Apache License, Version 2.0.