Page MenuHomeFreeBSD
Files F144551087

D48872.1775387727.diff
No OneTemporary
Actions

Size
2 KB
Referenced Files
None
Subscribers
None

D48872.1775387727.diff
View Options

diff --git a/usr.sbin/bootparamd/callbootd/callbootd.8 b/usr.sbin/bootparamd/callbootd/callbootd.8
new file mode 100644
--- /dev/null
+++ b/usr.sbin/bootparamd/callbootd/callbootd.8
@@ -0,0 +1,96 @@
+.\"
+.\" Copyright (c) 2025 Felix Johnson
+.\"
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
+.Dd June 23, 2025
+.Dt CALLBOOTD 8
+.Os
+.Sh NAME
+.Nm callbootd
+.Nd Contact boot parameter server for boot parameters
+.Sh SYNOPSIS
+.Nm
+.Ar server
+.Ar client
+.Op file_id
+.Sh DESCRIPTION
+The
+.Nm
+utility is a client application that provides information to
+.Xr diskless 8
+clients necessary for booting.
+.Nm
+runs after the kernel initializes networking
+but before mounting the root filesystem.
+It retrieves hostname, domain, router, and
+NFS boot file information from
+.Xr bootparamd 8 .
+This information is used to configure networking
+and mount NFS filesystems.
+.Pp
+If
+.Ar file_id
+is not specified,
+.Nm
+will contact
+.Ar server
+and request the client name, domain name,
+and default router associated with
+.Ar client .
+.Pp
+If
+.Ar file_id
+is specified,
+.Nm
+will contact
+.Ar server
+to request the boot server name, boot server address,
+and NFS path associated with
+.Ar client
+and
+.Ar file_id .
+.Sh OPTIONS
+.Bl -tag -width "file_id"
+.It Ar server
+Contact
+.Ar server
+to request boot parameters.
+If server is "all", a broadcast message is sent
+to all hosts on the local network.
+.It Ar client
+The IP address or hostname of the client.
+.It Op file_id
+The NFS export path associated with
+.Ar client
+and
+.Ar file_id .
+.El
+.Sh EXAMPLES
+To request information from server 192.168.0.3
+for client 192.168.0.20:
+.Pp
+.Dl callbootd 192.168.0.3 192.168.0.20
+.Pp
+To request information from anyone on the local network:
+.Pp
+.Dl callbootd all 192.168.0.20
+.Pp
+To request the NFS path for the "root" export from
+server 192.168.0.3 for client "rusty":
+.Pp
+.Dl callbootd 192.168.0.3 rusty root
+.Sh SEE ALSO
+.Xr bootparams 5 ,
+.Xr bootparamd 8 ,
+.Xr diskless 8
+.Sh AUTHORS
+.Nm
+was written by
+.An Klas Heggemann Aq Mt klas@nada.kth.se .
+.Pp
+This manual page was written by Felix Johnson
+.Aq Mt felix.the.red@gmail.com .
+.Sh BUGS
+.Nm
+only supports IPv4.
diff --git a/usr.sbin/bootparamd/callbootd/callbootd.c b/usr.sbin/bootparamd/callbootd/callbootd.c
--- a/usr.sbin/bootparamd/callbootd/callbootd.c
+++ b/usr.sbin/bootparamd/callbootd/callbootd.c
@@ -149,8 +149,7 @@
static void
usage(void)
{
- fprintf(stderr,
- "usage: callbootd server procnum (IP-addr | host fileid)\n");
+ errx(stderr, "usage: callbootd server client [file_id]\n");
exit(1);
}

File Metadata

Mime Type
text/plain
Expires
Sun, Apr 5, 11:15 AM (19 h, 40 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
28266497
Default Alt Text
D48872.1775387727.diff (2 KB)

Event Timeline