|
|
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.