1.\" $OpenBSD: rpc.bootparamd.8,v 1.21 2022/09/27 13:30:36 kn Exp $ 2.\" @(#)bootparamd.8 3.\" 4.\" This code is not copyright, and is placed in the public domain. 5.\" Feel free to use and modify. Please send modifications and/or 6.\" suggestions + bug fixes to Klas Heggemann <klas@nada.kth.se> 7.\" 8.\" Various small changes by Theo de Raadt <deraadt@fsa.ca> 9.\" Parser rewritten (adding YP support) by Roland McGrath <roland@frob.com> 10.\" 11.Dd $Mdocdate: September 27 2022 $ 12.Dt RPC.BOOTPARAMD 8 13.Os 14.Sh NAME 15.Nm rpc.bootparamd 16.Nd boot parameter server 17.Sh SYNOPSIS 18.Nm rpc.bootparamd 19.Op Fl ds 20.Op Fl f Ar file 21.Op Fl r Ar router 22.Sh DESCRIPTION 23.Nm 24is a server process that provides information to diskless clients 25necessary for booting. 26It consults the file 27.Pa /etc/bootparams . 28It should normally be started from 29.Pa /etc/rc . 30.Pp 31This version will allow the use of aliases on the hostname in the 32.Pa /etc/bootparams 33file. 34The hostname returned in response to the booting client's whoami request 35will be the name that appears in the config file, not the canonical name. 36In this way you can keep the answer short enough 37so that machines that cannot handle long hostnames won't fail during boot. 38.Pp 39While parsing, if a line containing just 40.Dq \&+ 41is found, and the YP subsystem is active, the YP map 42.Pa bootparams 43will be searched immediately. 44.Pp 45The options are as follows: 46.Bl -tag -width Ds 47.It Fl d 48Display the debugging information. 49The daemon does not fork in this case. 50.It Fl f Ar file 51Specify the 52.Ar file 53to read boot parameters from. 54Defaults to 55.Pa /etc/bootparams . 56.It Fl r Ar router 57Set the default 58.Ar router 59(a hostname or IP address). 60This defaults to the machine running the server. 61.It Fl s 62Log the debugging information with syslog. 63.El 64.Sh FILES 65.Bl -tag -width /etc/bootparams -compact 66.It Pa /etc/bootparams 67default configuration file 68.El 69.Sh SEE ALSO 70.Xr bootparams 5 , 71.Xr diskless 8 72.Sh AUTHORS 73Originally written by 74.An Klas Heggemann Aq Mt klas@nada.kth.se . 75.Sh BUGS 76You may find the syslog loggings too verbose. 77.Pp 78It's not clear if the non-canonical hack mentioned above is a good idea. 79.Sh WARNING 80If 81.Nm rpc.bootparamd 82is run on a system which is also running YP, your YP 83domainname will be made public information. 84