shutdown(3)           LPC Library Functions           shutdown(3)

NAME
     shutdown() - shutdown the driver

SYNOPSIS
     void shutdown( int how );

DESCRIPTION
     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 that 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(4)  up  (in  master.c)  to  protect   against
     efun::shutdown().

SEE ALSO
     crash(4), slow_shutdown(4)

MudOS                Last change: 5 Sep 1994                    1