.\"shutdown the driver .DT shutdown $MUDNAME$ driver help shutdown .SH Name .SI 5 shutdown() - shutdown the driver .EI .SH Synopsis .SI 5 void shutdown( int how ); .EI .SH Description .SP 5 5 This function shuts down the driver in a controlled fashion (as opposed to how a crash would shut it down). The `how' argument specifes what integer value the driver should pass to exit(). The convention is to pass `how' as -1 when the script that restarts the driver should die as well. Thus a reboot command would use shutdown() while a halt command would use shutdown(-1). The script must explicitly check the return value to see if it is -1 if you wish to use this convention. Obviously, shutdown() is a sensitive function and should be secured. As with exec(), the way to make it secure is to add a simul_efun of the same name which does the appropriate security checks. Be sure to set valid_override() up (in master.c) to protect against efun::shutdown(). .EP .SH See also .SI 5 crash(), slow_shutdown(), valid_override() .EI