1*a4af05a5Slukem.\" $NetBSD: bootparams.5,v 1.11 2002/02/28 01:19:48 lukem Exp $ 2cd8e5bc1Sgwr.\" 3cd8e5bc1Sgwr.\" Copyright (c) 1994 Gordon W. Ross 4cd8e5bc1Sgwr.\" All rights reserved. 5cd8e5bc1Sgwr.\" 6cd8e5bc1Sgwr.\" Redistribution and use in source and binary forms, with or without 7cd8e5bc1Sgwr.\" modification, are permitted provided that the following conditions 8cd8e5bc1Sgwr.\" are met: 9cd8e5bc1Sgwr.\" 1. Redistributions of source code must retain the above copyright 10cd8e5bc1Sgwr.\" notice, this list of conditions and the following disclaimer. 11cd8e5bc1Sgwr.\" 2. Redistributions in binary form must reproduce the above copyright 12cd8e5bc1Sgwr.\" notice, this list of conditions and the following disclaimer in the 13cd8e5bc1Sgwr.\" documentation and/or other materials provided with the distribution. 14cd8e5bc1Sgwr.\" 3. The name of the author may not be used to endorse or promote products 15cd8e5bc1Sgwr.\" derived from this software without specific prior written permission. 16cd8e5bc1Sgwr.\" 17cd8e5bc1Sgwr.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 18cd8e5bc1Sgwr.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 19cd8e5bc1Sgwr.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 20cd8e5bc1Sgwr.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 21cd8e5bc1Sgwr.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 22cd8e5bc1Sgwr.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 23cd8e5bc1Sgwr.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 24cd8e5bc1Sgwr.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25cd8e5bc1Sgwr.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 26cd8e5bc1Sgwr.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27cd8e5bc1Sgwr.\" 28*a4af05a5Slukem.Dd February 28, 2002 29cd8e5bc1Sgwr.Dt BOOTPARAMS 5 30cd8e5bc1Sgwr.Os 31cd8e5bc1Sgwr.Sh NAME 32cd8e5bc1Sgwr.Nm bootparams 33cd8e5bc1Sgwr.Nd boot parameter database 34ae9da3f7Sgwr.Sh SYNOPSIS 35ae9da3f7Sgwr.Nm /etc/bootparams 36cd8e5bc1Sgwr.Sh DESCRIPTION 37cd8e5bc1SgwrThe 386d66b6beSlukem.Nm 39cd8e5bc1Sgwrfile specifies the boot parameters that 40aa3d785eSwiz.Xr diskless 8 41cd8e5bc1Sgwrclients may request when booting over the network. 42cd8e5bc1SgwrEach client supported by this server must have an entry in the 436d66b6beSlukem.Nm 44a64b21abSmrgfile containing the servers and pathnames for its 456d66b6beSlukem.Pa root , 46a64b21abSmrgarea. It may optionally contain 47c1b4b344Sthorpej.Pa swap , 48c1b4b344Sthorpej.Pa dump , 49c1b4b344Sthorpejand other entry types. 50cd8e5bc1Sgwr.Pp 51cd8e5bc1SgwrEach line in the file 52cd8e5bc1Sgwr(other than comment lines that begin with a #) 53cd8e5bc1Sgwrspecifies the client name followed by the pathnames that 54c1b4b344Sthorpejthe client may request by their logical names. Names 55c1b4b344Sthorpejare matched in a case-insensitive fashion, and may also 56c1b4b344Sthorpejbe wildcarded using shell-style globbing characters. 57c1b4b344Sthorpej.Pp 58cd8e5bc1SgwrThe components of the line are delimited with blank or tab, 59cd8e5bc1Sgwrand may be continued onto multiple lines with a backslash. 60cd8e5bc1Sgwr.Pp 61cd8e5bc1SgwrFor example: 62cd8e5bc1Sgwr.Bd -literal -offset indent 633a5ebfc1Sbriggsdummy root=server:/export/dummy/root \\ 643a5ebfc1Sbriggs swap=server:/export/dummy/swap \\ 65*a4af05a5Slukem dump=server:/export/dummy/swap \\ 66*a4af05a5Slukem gateway=router:255.255.255.0 67cd8e5bc1Sgwr.Ed 68cd8e5bc1Sgwr.Pp 69cd8e5bc1SgwrWhen the client named "dummy" requests the pathname for 7014cd82dbSbriggsits logical "root" it will be given server 7114cd82dbSbriggs.Dq Pa "server" 7214cd82dbSbriggsand pathname 73cd8e5bc1Sgwr.Dq Pa "/export/dummy/root" 74cd8e5bc1Sgwras the response to its 75cd8e5bc1Sgwr.Tn RPC 76cd8e5bc1Sgwrrequest. 77c1b4b344Sthorpej.Pp 78c1b4b344Sthorpej.Bd -literal -offset indent 79c1b4b344Sthorpejnetra[1-5]www* root=server:/export/jumpstart/netra_www 80c1b4b344Sthorpej.Ed 81c1b4b344Sthorpej.Pp 82c1b4b344SthorpejWhen any client with a name matching the pattern "netra[1-5]www*" 83c1b4b344Sthorpejrequests the pathname for its logical "root" it will be given server 84c1b4b344Sthorpej.Dq Pa "server" 85c1b4b344Sthorpejand pathname 86c1b4b344Sthorpej.Dq Pa "/export/jumpstart/netra_www" 87c1b4b344Sthorpejas the response to its 88c1b4b344Sthorpej.Tn RPC 89c1b4b344Sthorpejrequest. As this example implies, this is useful for setting up 90c1b4b344SthorpejJumpstart servers for Sun clients. 91a64b21abSmrg.Sh NOTES 92a64b21abSmrgThe server does not default to the localhost, and must be filled in. 93ae9da3f7Sgwr.Sh FILES 94ae9da3f7Sgwr.Bl -tag -width /etc/bootparams -compact 95ae9da3f7Sgwr.It Pa /etc/bootparams 96ae9da3f7Sgwrdefault configuration file 97ae9da3f7Sgwr.El 98b2275072Scgd.Sh SEE ALSO 99cd8e5bc1Sgwr.Xr diskless 8 , 100cd8e5bc1Sgwr.Xr rpc.bootparamd 8 101