155580Sbostic.\" Copyright (c) 1988, 1992 The University of Utah and the Center 255580Sbostic.\" for Software Science (CSS). 361443Sbostic.\" Copyright (c) 1992, 1993 461443Sbostic.\" The Regents of the University of California. All rights reserved. 555565Sbostic.\" 655580Sbostic.\" This code is derived from software contributed to Berkeley by 755580Sbostic.\" the Center for Software Science of the University of Utah Computer 855580Sbostic.\" Science Department. CSS requests users of this software to return 955580Sbostic.\" to css-dist@cs.utah.edu any improvements that they make and grant 1055580Sbostic.\" CSS redistribution rights. 1155565Sbostic.\" 1255580Sbostic.\" %sccs.include.redist.roff% 1355565Sbostic.\" 14*65103Smckusick.\" @(#)rbootd.8 8.2 (Berkeley) 12/11/93 1555565Sbostic.\" 1655580Sbostic.\" Utah $Hdr: rbootd.man 3.1 92/07/06$ 1755580Sbostic.\" Author: Jeff Forys, University of Utah CSS 1855565Sbostic.\" 1955574Sbostic.Dd "" 2055574Sbostic.Dt RBOOTD 8 2155574Sbostic.Os 2255574Sbostic.Sh NAME 2355574Sbostic.Nm rbootd 2455574Sbostic.Nd HP remote boot server 2555574Sbostic.Sh SYNOPSIS 2655574Sbostic.Nm rbootd 2755574Sbostic.Op Fl ad 2855574Sbostic.Op Fl i Ar interface 2955574Sbostic.Op config_file 3055574Sbostic.Sh DESCRIPTION 3155574SbosticThe 3255574Sbostic.Nm rbootd 3355574Sbosticutility services boot requests from Hewlett-Packard workstations over a 3455565Sbosticlocal area network. 3555565SbosticAll boot files must reside in the boot file directory; further, if a 3655574Sbosticclient supplies path information in its boot request, it will be silently 3755574Sbosticstripped away before processing. 3855565SbosticBy default, 3955574Sbostic.Nm rbootd 4055574Sbosticonly responds to requests from machines listed in its configuration file. 4155574Sbostic.Pp 4255574SbosticThe options are as follows: 4355574Sbostic.Bl -tag -width Fl 4455574Sbostic.It Fl a 4555574SbosticRespond to boot requests from any machine. 4655574SbosticThe configuration file is ignored if this option is specified. 4755574Sbostic.It Fl d 4855574SbosticRun 4955574Sbostic.Nm rbootd 5055574Sbosticin debug mode. 5155574SbosticPackets sent and received are displayed to the terminal. 5255574Sbostic.It Fl i Ar interface 5355574SbosticService boot requests on specified interface. 5455574SbosticIf unspecified, 5555574Sbostic.Nm rbootd 5655574Sbosticsearches the system interface list for the lowest numbered, configured 5755574Sbostic``up'' interface (excluding loopback). 5855574SbosticTies are broken by choosing the earliest match. 5955574Sbostic.El 6055574Sbostic.Pp 6155574SbosticSpecifying 6255574Sbostic.Ar config_file 6355574Sbosticon the command line causes 6455574Sbostic.Nm rbootd 6555574Sbosticto use a different configuration file from the default. 6655574Sbostic.Pp 6755574SbosticThe configuration file is a text file where each line describes a particular 6855574Sbosticmachine. 6955574SbosticA line must start with a machine's Ethernet address followed by an optional 7055574Sbosticlist of boot file names. 71*65103SmckusickAn Ethernet address is specified in hexadecimal with each of its six octets 7255574Sbosticseparated by a colon. 7355574SbosticThe boot file names come from the boot file directory. 7455574SbosticThe ethernet address and boot file(s) must be separated by white-space 7555574Sbosticand/or comma characters. 7655574SbosticA pound sign causes the remainder of a line to be ignored. 7755574Sbostic.Pp 7855574SbosticHere is a sample configuration file: 7955574Sbostic.Bl -column 08:00:09:0:66:ad SYSHPBSD,SYSHPUX "# vandy (anything)" 8055574Sbostic.It # 8155574Sbostic.It # ethernet addr boot file(s) comments 8255574Sbostic.It # 8355574Sbostic.It 08:00:09:0:66:ad SYSHPBSD # snake (4.3BSD) 8455574Sbostic.It 08:00:09:0:59:5b # vandy (anything) 8555574Sbostic.It 8::9:1:C6:75 SYSHPBSD,SYSHPUX # jaguar (either) 8655574Sbostic.El 8755574Sbostic.Pp 8855574Sbostic.Nm Rbootd 8955565Sbosticlogs status and error messages via 9055574Sbostic.Xr syslog 3 . 9155574SbosticA startup message is always logged, and in the case of fatal errors (or 9255574Sbosticdeadly signals) a message is logged announcing the server's termination. 9355574SbosticIn general, a non-fatal error is handled by ignoring the event that caused 9455574Sbosticit (e.g. an invalid Ethernet address in the config file causes that line 9555574Sbosticto be invalidated). 9655574Sbostic.Pp 9755574SbosticThe following signals have the specified effect when sent to the server 9855574Sbosticprocess using the 9955574Sbostic.Xr kill 1 10055574Sbosticcommand: 10155574Sbostic.Bl -tag -width SIGUSR1 -offset -compact 10255574Sbostic.It SIGHUP 10355565SbosticDrop all active connections and reconfigure. 10455574Sbostic.It SIGUSR1 10555574SbosticTurn on debugging, do nothing if already on. 10655574Sbostic.It SIGUSR2 10755574SbosticTurn off debugging, do nothing if already off. 10855574Sbostic.El 10955574Sbostic.Sh "FILES" 11055574Sbostic.Bl -tag -width /usr/libexec/rbootd -compact 11155574Sbostic.It /dev/bpf# 11255574Sbosticpacket-filter device 11355574Sbostic.It /etc/rbootd.conf 11455565Sbosticconfiguration file 11555574Sbostic.It /tmp/rbootd.dbg 11655574Sbosticdebug output 11755574Sbostic.It /usr/mdec/rbootd 11855565Sbosticdirectory containing boot files 11955574Sbostic.It /var/run/rbootd.pid 12055565Sbosticprocess id 12155574Sbostic.El 12255574Sbostic.Sh SEE ALSO 12355574Sbostic.Xr kill 1 , 12455574Sbostic.Xr socket 2 , 12555574Sbostic.Xr signal 3 , 12655574Sbostic.Xr syslog 3 , 12755574Sbostic.Xr rmp 4 12855574Sbostic.Sh BUGS 12955565SbosticIf multiple servers are started on the same interface, each will receive 13055565Sbosticand respond to the same boot packets. 131