Page MenuHomeFreeBSD
Files F163261699

D48872.id150651.diff
No OneTemporary
Actions

D48872.id150651.diff
View Options

diff --git a/usr.sbin/bootparamd/callbootd/Makefile b/usr.sbin/bootparamd/callbootd/Makefile
--- a/usr.sbin/bootparamd/callbootd/Makefile
+++ b/usr.sbin/bootparamd/callbootd/Makefile
@@ -1,5 +1,5 @@
PROG= callbootd
-MAN=
+MAN= callbootd.8
SRCS= callbootd.c ${GENSRCS}
GENSRCS=bootparam_prot.h bootparam_prot_clnt.c bootparam_prot_xdr.c
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,59 @@
+.Dd February 6, 2025
+.Dt CALLBOOTD 8
+.Os
+.Sh NAME
+.Nm callbootd
+.Nd Contact boot parameter server for boot parameters
+.Sh SYNOPSIS
+.\" callbootd server procnum (IP-addr | host fileid)
+.\" "usage: callbootd (all | server) [ip_addr | hostname]"
+.Nm
+.Ar server
+.Op ip_addr | hostname
+.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 bootparamd.
+This information is used to configure networking
+and determine the NFS root filesystem.
+.Sh OPTIONS
+.Bl -tag -width Fl
+.It Ar server
+Contact server to request boot parameters.
+If server is "all", then a broadcast message is sent
+to all hosts on the local network.
+Otherwise, if no client IP address or hostname is specified,
+.Nm
+sends a whoami request and prints the client hostname,
+domain_name, and router (default gateway) for each response received.
+.It Op ip_addr | hostname
+Contact
+.Ar server
+to request the boot server name, boot server address,
+and NFS path associated with the client IP address (ip_addr) or hostname.
+.El
+.Sh EXAMPLES
+To broadcast a request for whoami information:
+.Pp
+.Ql "callbootd all"
+.Pp
+To contact a server at 192.168.0.3 for whoami information:
+.Pp
+.Ql "callbootd 192.168.0.3"
+.Sh SEE ALSO
+.Xr bootparams 5 ,
+.Xr bootparamd 8
+.Xr diskless 8
+.Sh AUTHORS
+Written by
+.An Felix Johnson Aq Mt felix@felix-johnson.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,8 @@
static void
usage(void)
{
- fprintf(stderr,
- "usage: callbootd server procnum (IP-addr | host fileid)\n");
+ fprintf(stderr, "usage: callbootd server [ip_addr | hostname]\n");
+ fprintf(stderr, "callbootd all [ip_addr | hostname]\n");
exit(1);
}

File Metadata

Mime Type
text/plain
Expires
Wed, Jul 22, 1:19 PM (12 h, 17 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
35365250
Default Alt Text
D48872.id150651.diff (2 KB)

Event Timeline