xref: /netbsd-src/usr.sbin/isibootd/isibootd.8 (revision 413d532bcc3f62d122e56d92e13ac64825a40baf)
1.\"	$NetBSD: isibootd.8,v 1.4 2012/03/15 22:35:03 njoly Exp $
2.\"
3.\" Copyright (c) 2011 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE.
26.\"
27.Dd December 15, 2011
28.Dt ISIBOOTD 8
29.Os
30.Sh NAME
31.Nm isibootd
32.Nd TRFS based network boot server
33.Sh SYNOPSIS
34.Nm
35.Op Fl d Ar tracelevel
36.Op Fl i Ar interface
37.Op Fl s Ar directory
38.Sh DESCRIPTION
39The
40.Nm
41command is a server which supports OMRON LUNA's network boot protocol
42based on the Transparent Remote File System (TRFS) protocol.
43The TRFS protocol uses special Ethernet type packets and
44works within a local network.
45.Pp
46.Nm
47is a simple TRFS server that only supports client reads for booting
48and exports files in a specified directory.
49.Nm
50accepts requests only from clients listed in the
51.Pa /etc/ethers
52and have valid hostnames.
53.Pp
54The options are as follows:
55.Bl -tag -width Fl
56.It Fl d Ar tracelevel
57Run
58.Nm
59in debug mode with specified tracelevel.
60The tracelevel can be value 1, 2, or 3, and
61greater tracelevel provides more detailed trace output.
62The server will not fork in the debug mode.
63.It Fl i Ar interface
64Specify a network interface to service network boot.
65If not specified
66.Nm
67searches available network interfaces (excluding loopback)
68and use the first configured
69.Dq up
70one.
71.It Fl s Ar directory
72Specify a directory containing boot files to be served by
73.Nm .
74If not specified
75.Nm
76uses
77.Pa /tftpboot
78by default.
79.El
80.Sh FILES
81.Bl -tag -width Pa -compact
82.It Pa /etc/ethers
83.It Pa /etc/hosts
84.It Pa /tftpboot
85.It Pa /var/run/isibootd.pid
86.El
87.Sh SEE ALSO
88.Xr ethers 5 ,
89.Xr hosts 5 ,
90.Xr tftpd 8
91.Pp
92.Lk http://www.NetBSD.org/ports/luna68k/install.html "NetBSD/luna68k Installation Instructions"
93.Sh HISTORY
94.Nm
95is based on
96.Pa isiboot
97utility which was originally written by
98.An Tohru Nishimura
99for
100.Nx Ns /luna68k
101development, and first appeared in
102.Nx 6.0 .
103