Annotation of 43BSDReno/share/man/man8/man8.hp300/rbootd.8, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1990 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" This code is derived from software contributed to Berkeley by
                      5: .\" the Systems Programming Group of the University of Utah Computer
                      6: .\" Science Department.
                      7: .\"
                      8: .\" Redistribution and use in source and binary forms are permitted provided
                      9: .\" that: (1) source distributions retain this entire copyright notice and
                     10: .\" comment, and (2) distributions including binaries display the following
                     11: .\" acknowledgement:  ``This product includes software developed by the
                     12: .\" University of California, Berkeley and its contributors'' in the
                     13: .\" documentation or other materials provided with the distribution and in
                     14: .\" all advertising materials mentioning features or use of this software.
                     15: .\" Neither the name of the University nor the names of its contributors may
                     16: .\" be used to endorse or promote products derived from this software without
                     17: .\" specific prior written permission.
                     18: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     19: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     20: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     21: .\"
                     22: .\"    @(#)rbootd.8    5.1 (Berkeley) 6/29/90
                     23: .\"
                     24: .TH RBOOTD 8 "June 29, 1990"
                     25: .UC 7
                     26: .SH NAME
                     27: rbootd \- HP remote boot server
                     28: .SH SYNOPSIS
                     29: .B rbootd
                     30: [\-a] [\-d] [ConfigFile]
                     31: .SH DESCRIPTION
                     32: .I Rbootd
                     33: services boot requests from Hewlett-Packard workstations over a
                     34: local area network.
                     35: All boot files must reside in the boot file directory; further, if a
                     36: client supplies path information in its boot request, it will be
                     37: silently stripped away before processing.
                     38: By default,
                     39: .I rbootd
                     40: only responds to requests from machines listed in its configuration
                     41: file.
                     42: .PP
                     43: .I Rbootd
                     44: supports the following command line options:
                     45: .TP
                     46: .B \-a
                     47: Respond to boot requests from any machine.  With this option,
                     48: the configuration file is ignored.
                     49: .TP
                     50: .B \-d
                     51: Run server in debug mode.  Packets sent and
                     52: received are displayed to the terminal.
                     53: .TP
                     54: .B ConfigFile
                     55: Specify a different configuration file.
                     56: .PP
                     57: The configuration file consists of ascii text where each line describes
                     58: a particular machine.  A line must start with a machines'
                     59: .I ethernet address
                     60: followed by an optional list of
                     61: .I boot file names.
                     62: An ethernet address is specified in hexadecimal with each of its six
                     63: octets separated by a colon.  The boot file names come from the boot
                     64: file directory.
                     65: The ethernet address and boot file(s) must be separated
                     66: by white-space and/or commas.  A pound sign causes the remainder of
                     67: a line to be ignored.  Here is a sample configuration file:
                     68: .in +4
                     69: .nf
                     70: 
                     71: .ta \w'08:00:09:01:C6:75  'u +\w'SYSHPBSD,SYSHPUX  'u +\w'# jaguar (either)'u
                     72: #
                     73: # ethernet addr        boot file(s)    comments
                     74: #
                     75: 08:00:09:0:66:ad       SYSHPBSD        # snake (4.3BSD)
                     76: 08:00:09:0:59:5b               # vandy (anything)
                     77: 8::9:1:C6:75   SYSHPBSD,SYSHPUX        # jaguar (either)
                     78: .DT
                     79: .fi
                     80: .in
                     81: .PP
                     82: .I Rbootd
                     83: logs status and error messages via
                     84: .I syslog.
                     85: A startup message is always logged, and in the case of fatal
                     86: errors (or deadly signals) a message is logged announcing the
                     87: server's termination.  In general, a non-fatal error is handled
                     88: by ignoring the event that caused it (e.g. an invalid Ethernet
                     89: address in the config file causes that line to be invalidated).
                     90: .PP
                     91: The following signals have the specified effect when sent to
                     92: the server process using the kill(1) command.
                     93: .IP SIGHUP
                     94: Drop all active connections and reconfigure.
                     95: .IP SIGUSR1
                     96: Turn on debugging, do nothing if already on.  (SIGEMT on older systems
                     97: without SIGUSR1)
                     98: .IP SIGUSR2
                     99: Turn off debugging, do nothing if already off.  (SIGFPE on older systems
                    100: without SIGUSR2)
                    101: .SH "FILES"
                    102: .PD 0
                    103: .TP 22
                    104: /etc/rbootd.conf
                    105: configuration file
                    106: .TP
                    107: /usr/lib/rbootd
                    108: directory containing boot files
                    109: .TP
                    110: /etc/rbootd.pid
                    111: process id
                    112: .TP
                    113: /usr/tmp/rbootd.dbg
                    114: debug output
                    115: .PD
                    116: .SH "SEE ALSO"
                    117: kill(1), socket(2), signal(3C), syslog(3), rmp(4)
                    118: .SH "AUTHOR"
                    119: Jeff Forys, University of Utah
                    120: .SH "BUGS"
                    121: .TP 2
                    122: \-
                    123: If more than one server is started, both will receive and respond
                    124: to the same boot packets.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.