Return to reboot.2 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / sys

Annotation of 43BSDReno/lib/libc/sys/reboot.2, revision 1.1

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.