man/man8/shutdown.8

   1 .TH SHUTDOWN 8
   2 .SH NAME
   3 shutdown \- graciously close the system down
   4 .SH SYNOPSIS
   5 .B shutdown
   6 .RB [ \-hrRmk ]
   7 .RB [ \-x
   8 .IR code ]
   9 .RI [ time-specification
  10 .RI [ message ]]
  11 .SH DESCRIPTION
  12 .B Shutdown
  13 is a program which allows a system operator to close down the system
  14 in an nice way.
  15 .B Shutdown
  16 informs the users why and when the system is going down.  This warning
  17 is issued 10 minutes before shutdown time and every minute in the last
  18 5 minutes.  At this time (5 minutes),
  19 .B shutdown
  20 creates a file
  21 .B /etc/nologin
  22 to prevent new users from logging in.
  23 .PP
  24 .B Shutdown
  25 keeps a logfile of shutdowns.  Every shutdown is registered in
  26 .BR /usr/adm/wtmp ,
  27 if this file exists, and by
  28 .BR syslog (3)
  29 (level
  30 .BR auth . notice ).
  31 After these actions, a call is done to
  32 .BR reboot (2)
  33 which actually brings the system down.
  34 .PP
  35 .I Time-specification
  36 may be something like
  37 .BR 15:00 ,
  38 .BR 15.00 ,
  39 .BR +15 ,
  40 or
  41 .B now
  42 for a shutdown at 3pm (twice), 15 minutes from now, or immediately.
  43 .PP
  44 The message may be used to describe why the system is going down, it may
  45 also be typed on standard input with the
  46 .B \-m
  47 option.
  48 .SH OPTIONS
  49 .TP
  50 .B \-h
  51 This flag prevents the system from rebooting after the shutdown.  The
  52 system can now be powered off.  This is the default.
  53 .TP
  54 .B \-r
  55 This flag indicates that the system should reboot after shutting down.
  56 .TP
  57 .B \-R
  58 Reboot the system by resetting it.  Normally the kernel will try to return
  59 to the Boot Monitor.  With
  60 .B \-R
  61 the system will receive a hardware reset.
  62 .TP
  63 .BI \-x " code"
  64 Halt the system and let the Monitor execute the given code as if typed at
  65 the monitor prompt.  You can for instance use
  66 .B "\-x 'boot hd0'"
  67 as a very fast way to reboot "from the top."
  68 .TP
  69 .B \-m
  70 Allows the operator to type a shutdown message on standard input, that will
  71 be added to the messages displayed on all terminals.
  72 .TP
  73 .B \-k
  74 This option gives the possibility of terminating an already started
  75 shutdown.  This is only possible if shutdown time has not yet arrived.
  76 .TP
  77 .B \-C
  78 Check if the system crashed.  This option is not used at shutdown time,
  79 but at reboot time.  It tells if the file systems should be checked by
  80 testing if the last entry in the wtmp file is a shutdown entry.  (A
  81 crude replacement for a file system clean flag.)
  82 .SH "SEE ALSO"
  83 .BR reboot (2),
  84 .BR syslog (3),
  85 .BR halt (8),
  86 .BR boot (8).
  87 .SH AUTHOR
  88 Edvard Tuinder (v892231@si.hhs.NL)