|
|
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.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.