man/shutdown.8

   1 '\" t
   2 .TH "SHUTDOWN" "8" "" "systemd 218" "shutdown"
   3 .\" -----------------------------------------------------------------
   4 .\" * Define some portability stuff
   5 .\" -----------------------------------------------------------------
   6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   7 .\" http://bugs.debian.org/507673
   8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
   9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  10 .ie \n(.g .ds Aq \(aq
  11 .el       .ds Aq '
  12 .\" -----------------------------------------------------------------
  13 .\" * set default formatting
  14 .\" -----------------------------------------------------------------
  15 .\" disable hyphenation
  16 .nh
  17 .\" disable justification (adjust text to left margin only)
  18 .ad l
  19 .\" -----------------------------------------------------------------
  20 .\" * MAIN CONTENT STARTS HERE *
  21 .\" -----------------------------------------------------------------
  22 .SH "NAME"
  23 shutdown \- Halt, power\-off or reboot the machine
  24 .SH "SYNOPSIS"
  25 .HP \w'\fBshutdown\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB[TIME]\fR\fB\ \fR\fB[WALL...]\fR\ 'u
  26 \fBshutdown \fR\fB[OPTIONS...]\fR\fB \fR\fB[TIME]\fR\fB \fR\fB[WALL...]\fR
  27 .SH "DESCRIPTION"
  28 .PP
  29 \fBshutdown\fR
  30 may be used to halt, power\-off or reboot the machine\&.
  31 .PP
  32 The first argument may be a time string (which is usually
  33 "now")\&. Optionally, this may be followed by a wall message to be sent to all logged\-in users before going down\&.
  34 .PP
  35 The time string may either be in the format
  36 "hh:mm"
  37 for hour/minutes specifying the time to execute the shutdown at, specified in 24h clock format\&. Alternatively it may be in the syntax
  38 "+m"
  39 referring to the specified number of minutes m from now\&.
  40 "now"
  41 is an alias for
  42 "+0", i\&.e\&. for triggering an immediate shutdown\&. If no time argument is specified,
  43 "+1"
  44 is implied\&.
  45 .PP
  46 Note that to specify a wall message you must specify a time argument, too\&.
  47 .PP
  48 If the time argument is used, 5 minutes before the system goes down the
  49 /run/nologin
  50 file is created to ensure that further logins shall not be allowed\&.
  51 .SH "OPTIONS"
  52 .PP
  53 The following options are understood:
  54 .PP
  55 \fB\-\-help\fR
  56 .RS 4
  57 Print a short help text and exit\&.
  58 .RE
  59 .PP
  60 \fB\-H\fR, \fB\-\-halt\fR
  61 .RS 4
  62 Halt the machine\&.
  63 .RE
  64 .PP
  65 \fB\-P\fR, \fB\-\-poweroff\fR
  66 .RS 4
  67 Power\-off the machine (the default)\&.
  68 .RE
  69 .PP
  70 \fB\-r\fR, \fB\-\-reboot\fR
  71 .RS 4
  72 Reboot the machine\&.
  73 .RE
  74 .PP
  75 \fB\-h\fR
  76 .RS 4
  77 Equivalent to
  78 \fB\-\-poweroff\fR, unless
  79 \fB\-\-halt\fR
  80 is specified\&.
  81 .RE
  82 .PP
  83 \fB\-k\fR
  84 .RS 4
  85 Do not halt, power\-off, reboot, just write wall message\&.
  86 .RE
  87 .PP
  88 \fB\-\-no\-wall\fR
  89 .RS 4
  90 Do not send wall message before halt, power\-off, reboot\&.
  91 .RE
  92 .PP
  93 \fB\-c\fR
  94 .RS 4
  95 Cancel a pending shutdown\&. This may be used cancel the effect of an invocation of
  96 \fBshutdown\fR
  97 with a time argument that is not
  98 "+0"
  99 or
 100 "now"\&.
 101 .RE
 102 .SH "EXIT STATUS"
 103 .PP
 104 On success, 0 is returned, a non\-zero failure code otherwise\&.
 105 .SH "SEE ALSO"
 106 .PP
 107 \fBsystemd\fR(1),
 108 \fBsystemctl\fR(1),
 109 \fBhalt\fR(8),
 110 \fBwall\fR(1)