![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to reboot.2 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / sys|
Return to reboot.2 CVS log | Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / sys |
1.1 root 1: .\" Copyright (c) 1980 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)reboot.2 6.4 (Berkeley) 6/30/90
19: .\"
20: .TH REBOOT 2 "June 30, 1990"
21: .UC 4
22: .SH NAME
23: reboot \- reboot system or halt processor
24: .SH SYNOPSIS
25: .nf
26: .B #include <sys/reboot.h>
27: .PP
28: .B reboot(howto)
29: .B int howto;
30: .fi
31: .SH DESCRIPTION
32: .I Reboot
33: reboots the system.
34: Only the super-user may reboot a machine on demand.
35: However, a reboot is invoked
36: automatically in the event of unrecoverable system failures.
37: .PP
38: .I Howto
39: is a mask of options; the system call interface passes the following
40: options, defined in the include file ``<sys/reboot.h>'', to be passed
41: to the new kernel or the new bootstrap and init programs.
42: .TP
43: RB_AUTOBOOT
44: The default, causing the system to reboot in its usual fashion.
45: .TP
46: RB_ASKNAME
47: Interpreted by the bootstrap program itself, causing it to
48: prompt on the console as to what file should be booted.
49: Normally, the system is booted from the file ``\fIxx\fP(0,0)vmunix'',
50: where \fIxx\fP is the default disk name,
51: without prompting for the file name.
52: .TP
53: RB_DFLTROOT
54: Use the compiled in root device.
55: Normally, the system uses the device from which it was booted
56: as the root device if possible.
57: (The default behavior is dependent on the ability of the bootstrap program
58: to determine the drive from which it was loaded, which is not possible
59: on all systems.)
60: .TP
61: RB_DUMP
62: Dump kernel memory before rebooting; see
63: .IR savecore (8)
64: for more information.
65: .TP
66: RB_HALT
67: the processor is simply halted; no reboot takes place.
68: This option should be used with caution.
69: .TP
70: RB_INITNAME
71: An option allowing the specification of an init program (see
72: .IR init (8)
73: other than ``/sbin/init'' to be run when the system reboots.
74: This switch is not currently available.
75: .TP
76: RB_KDB
77: Load the symbol table and enable a built-in debugger in the system.
78: This option will have no useful function if the kernel is not configured
79: for debugging.
80: Several other options have different meaning if combined
81: with this option, although their use may not be possible
82: via the
83: .I reboot
84: call.
85: See
86: .IR kadb (4)
87: for more information.
88: .TP
89: RB_NOSYNC
90: Normally, the disks are sync'd (see
91: .IR sync (8))
92: before the processor is halted or rebooted.
93: This option may be useful if file system changes have been made manually
94: or if the processor is on fire.
95: .TP
96: RB_RDONLY
97: Initially mount the root file system read-only.
98: This is currently the default, and this option has been deprecated as
99: a no-op.
100: .TP
101: RB_SINGLE
102: Normally, the reboot procedure involves an automatic disk consistency
103: check and then multi-user operations.
104: RB_SINGLE prevents this, booting the system with a single-user shell
105: on the console.
106: RB_SINGLE is actually interpreted by the
107: .IR init (8)
108: program in the newly booted system.
109: .PP
110: When no options are given (i.e., RB_AUTOBOOT is used), the system is
111: rebooted from file ``vmunix'' in the root file system of unit 0
112: of a disk chosen in a processor specific way.
113: An automatic consistency check of the disks is then normally performed
114: (see
115: .IR fsck (8)).
116: .SH "RETURN VALUES"
117: If successful, this call never returns.
118: Otherwise, a \-1 is returned and an error is returned in the global
119: variable
120: .IR errno .
121: .SH ERRORS
122: .TP 15
123: [EPERM]
124: The caller is not the super-user.
125: .SH "SEE ALSO"
126: kadb(4), crash(8), halt(8), init(8), reboot(8), savecore(8)
127: .SH BUGS
128: The HP300 implementation supports neither RB_DFLTROOT or RB_KDB.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.