---
name: "condor_set_shutdown"
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_set_shutdown"
---

# condor\_set\_shutdown(1)

HTCondor Manual Set a program to execute upon condor\_master shut down

## NAME

condor\_set\_shutdown - HTCondor Manual

Set a program to execute upon *condor\_master* shut down

## SYNOPSIS

**condor\_set\_shutdown** \[**-help \| -version** \]

**condor\_set\_shutdown** **-exec** *programname* \[**-debug** \] \[**-pool** *centralmanagerhostname\[:portnumber\]*\] \[ **-name** *hostname* \| *hostname* \| **-addr** *"\<a.b.c.d:port\>"* \| *"\<a.b.c.d:port\>"* \| **-constraint** *expression* \| **-all** \]

## DESCRIPTION

*condor\_set\_shutdown* sets a program (typically a script) to execute when the *condor\_master* daemon shuts down. The **-exec** *programname* argument is required, and specifies the program to run. The string *programname* must match the string that defines **Name** in the configuration variable *MASTER\_SHUTDOWN\_\<Name\>* in the *condor\_master* daemon's configuration. If it does not match, the *condor\_master* will log an error and ignore the request.

For security reasons of authentication and authorization, this command requires ADMINISTRATOR level of access.

## OPTIONS

- **-help**

  Display usage information

- **-version**

  Display version information

- **-exec** *name*

  Select the program the master should exec the next time it shuts down. The master will run the program configured as **MASTER\_SHUTDOWN\_\<name\>** from the configuration of the *condor\_master*.

- **-debug**

  Causes debugging information to be sent to **stderr**, based on the value of the configuration variable *TOOL\_DEBUG*.

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

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

- **-name** *hostname*

  Send the command to a machine identified by *hostname*

- ***hostname***

  Send the command to a machine identified by *hostname*

- **-addr** *"\<a.b.c.d:port\>"*

  Send the command to a machine's master located at *"\<a.b.c.d:port\>"*

- ***"\<a.b.c.d:port\>"***

  Send the command to a machine located at *"\<a.b.c.d:port\>"*

- **-constraint** *expression*

  Apply this command only to machines matching the given ClassAd *expression*

- **-all**

  Send the command to all machines in the pool

## EXIT STATUS

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

## EXAMPLES

To have all *condor\_master* daemons run the program */bin/reboot* upon shut down, configure the *condor\_master* to contain a definition similar to:

```
MASTER_SHUTDOWN_REBOOT = /sbin/reboot
```

where **REBOOT** is an invented name for this program that the *condor\_master* will execute. On the command line, run

```
$ condor_set_shutdown -exec reboot -all
$ condor_off -graceful -all
```

where the string reboot matches the invented name.

## 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.