sbin/reboot/reboot.8

   1 .\" Copyright (c) 1990, 1991, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. All advertising materials mentioning features or use of this software
  13 .\"    must display the following acknowledgement:
  14 .\"     This product includes software developed by the University of
  15 .\"     California, Berkeley and its contributors.
  16 .\" 4. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     @(#)reboot.8    8.1 (Berkeley) 6/9/93
  33 .\" $FreeBSD: src/sbin/reboot/reboot.8,v 1.10.2.7 2003/02/23 22:42:10 trhodes Exp $
  34 .\"
  35 .Dd June 9, 1993
  36 .Dt REBOOT 8
  37 .Os
  38 .Sh NAME
  39 .Nm reboot ,
  40 .Nm halt ,
  41 .Nm fastboot ,
  42 .Nm fasthalt
  43 .Nd stopping and restarting the system
  44 .Sh SYNOPSIS
  45 .Nm halt
  46 .Op Fl lnqp
  47 .Op Fl k Ar kernel
  48 .Nm
  49 .Op Fl dlnqp
  50 .Op Fl k Ar kernel
  51 .Nm fasthalt
  52 .Op Fl lnqp
  53 .Op Fl k Ar kernel
  54 .Nm fastboot
  55 .Op Fl dlnqp
  56 .Op Fl k Ar kernel
  57 .Sh DESCRIPTION
  58 The
  59 .Nm halt
  60 and
  61 .Nm
  62 utilities flush the file system cache to disk, send all running processes
  63 a
  64 .Dv SIGTERM
  65 (and subsequently a
  66 .Dv SIGKILL )
  67 and, respectively, halt or restart the system.
  68 The action is logged, including entering a shutdown record into the
  69 .Xr wtmp 5
  70 file.
  71 .Pp
  72 The options are as follows:
  73 .Bl -tag -width indent
  74 .It Fl d
  75 The system is requested to create a crash dump.
  76 This option is
  77 supported only when rebooting, and it has no effect unless a dump
  78 device has previously been specified with
  79 .Xr dumpon 8 .
  80 .It Fl k Ar kernel
  81 Boot the specified
  82 .Ar kernel
  83 on the next system boot.
  84 If the kernel boots successfully, the
  85 .Em default
  86 kernel will be booted on successive boots, this is a one-shot option.
  87 If the boot fails, the system will continue attempting to boot
  88 .Ar kernel
  89 until the boot process is interrupted and a valid kernel booted.
  90 This may change in the future.
  91 .It Fl l
  92 The halt or reboot is
  93 .Em not
  94 logged to the system log.
  95 This option is intended for applications such as
  96 .Xr shutdown 8 ,
  97 that call
  98 .Nm
  99 or
 100 .Nm halt
 101 and log this themselves.
 102 .It Fl n
 103 The file system cache is not flushed.
 104 This option should probably not be used.
 105 .It Fl q
 106 The system is halted or restarted quickly and ungracefully, and only
 107 the flushing of the file system cache is performed (if the
 108 .Fl n
 109 is not specified).
 110 This option should probably not be used.
 111 .It Fl p
 112 The system will turn off the power
 113 if it can.
 114 This is of course likely to make
 115 .Nm
 116 rather similar to
 117 .Nm halt .
 118 .El
 119 .Pp
 120 The
 121 .Nm fasthalt
 122 and
 123 .Nm fastboot
 124 utilities are nothing more than aliases for the
 125 .Nm halt
 126 and
 127 .Nm
 128 utilities.
 129 .Pp
 130 Normally, the
 131 .Xr shutdown 8
 132 utility is used when the system needs to be halted or restarted, giving
 133 users advance warning of their impending doom and cleanly terminating
 134 specific programs.
 135 .Sh SEE ALSO
 136 .Xr wtmp 5 ,
 137 .Xr boot 8 ,
 138 .Xr dumpon 8 ,
 139 .Xr savecore 8 ,
 140 .Xr shutdown 8 ,
 141 .Xr sync 8
 142 .Sh HISTORY
 143 A
 144 .Nm
 145 command appeared in
 146 .At v6 .