.\"Man page for condor_set_shutdown 
.\"Generated by makeman on Tue May 29 00:38:53 2018
.TH condor_set_shutdown  1 "May 2018"
.SH Name
.P
condor_set_shutdown Set \- a program to execute upon condor_mastershut down 
.P

.SH Synopsis
condor_set_shutdown [-help -version] 
.P
condor_set_shutdown-exec programname[-debug] [-pool centralmanagerhostname[:portnumber]] [-name hostnamehostname-addr "<a.b.c.d:port>""<a.b.c.d:port>"-constraint expression-all] 
.P
.SH Description
.P
condor_set_shutdownsets a program (typically a script) to execute when the condor_masterdaemon shuts down. The -exec programnameargument is required, and specifies the program to run. The string programnamemust match the string that defines  Name in the configuration variable  MASTER_SHUTDOWN_<Name> in the condor_masterdaemon's configuration. If it does not match, the condor_masterwill log an error and ignore the request. 
.P
For security reasons of authentication and authorization, this command requires ADMINISTRATOR level of access. 
.P
.SH Options
.P

.B -help
.IP "" 3
Display usage information 
.IP "" 3
.P
.B -version
.IP "" 3
Display version information 
.IP "" 3
.P
.B -debug
.IP "" 3
Causes debugging information to be sent to  stderr , based on the value of the configuration variable  TOOL_DEBUG . 
.IP "" 3
.P
.B -pool centralmanagerhostname[:portnumber]
.IP "" 3
Specify a pool by giving the central manager's host name and an optional port number 
.IP "" 3
.P
.B -name hostname
.IP "" 3
Send the command to a machine identified by hostname
.IP "" 3
.P
.B hostname
.IP "" 3
Send the command to a machine identified by hostname
.IP "" 3
.P
.B -addr "<a.b.c.d:port>"
.IP "" 3
Send the command to a machine's master located at "<a.b.c.d:port>"
.IP "" 3
.P
.B "<a.b.c.d:port>"
.IP "" 3
Send the command to a machine located at "<a.b.c.d:port>"
.IP "" 3
.P
.B -constraint expression
.IP "" 3
Apply this command only to machines matching the given ClassAd expression
.IP "" 3
.P
.B -all
.IP "" 3
Send the command to all machines in the pool 
.IP "" 3
.P

.SH 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. 
.P
.SH Examples
To have all condor_masterdaemons run the program /bin/rebootupon shut down, configure the condor_masterto contain a definition similar to: 
.P

.br
MASTER_SHUTDOWN_REBOOT = /sbin/reboot
.P
where  REBOOT is an invented name for this program that the condor_masterwill execute. On the command line, run 
.P

.br
% condor_set_shutdown  -exec reboot -all
.br
% condor_off -graceful -all
.P
where the string  reboot matches the invented name. 
.P
.SH Author
Center for High Throughput Computing, University of Wisconsin-Madison 
.SH Copyright
Copyright (C) 1990-2016 Center for High Throughput Computing, Computer Sciences Department, University of Wisconsin-Madison, Madison, WI. All Rights Reserved. Licensed under the Apache License, Version 2.0.