plan9fox/sys/man/4/tftpfs

.TH TFTPFS 4
.SH NAME
tftpfs \- trivial file transfer protocol (TFTP) file system
.SH SYNOPSIS
.B ip/tftpfs
[
.B -D
] [
.B -s
.I srvname
] [
.B -m
.I mtpt
] [
.B -x
.I net
] [
.I ipaddr
]
.SH DESCRIPTION
.I Tftpfs
serves files from a TFTP server as a filesystem. TFTP
is mostly used by bootloaders to download kernel images for
network bootstrap (see
.IR dhcpd (8)).
As the protocol has no way of distinguishing files from
directories, the final path segment needs to conain a dot
(.) character to be recognized as a file. To access files that
have no dot in the filename, a trailing dot has to be added
and will be stripped before it is passed to the server.
.PP
The
.B -D
option enables 9P debugging messages.
.PP
The
.B -s
option causes 
.I tftpfs
to post the 9P service as
.BI /srv/ srvname
and disables the default mount.
.PP
The default mountpoint
.BR /n/tftp
can be changed with the
.B -B
.I mtpt
option.
.PP
The
.B -x
option specifies an alternate network directory
.RI ( e.g., 
.BR /net.alt ).
.PP
The ip address of the server can be passed in
as the last program argument,
.I ipaddr,
 or in the mount spec (see
.IR bind (1))
on a per mount basis.
.SH EXAMPLE
Boot a kernel from a tftp server (note the final
dot in the kernel path).
.IP
.EX
ip/tftpfs 10.192.254.53
echo reboot /n/tftp/386/9pc. >/dev/reboot
.EE
.SH SOURCE
.B /sys/src/cmd/ip/tftpfs.c
.SH "SEE ALSO"
.IR dhcpd (8).
tftpfs: add manpage, add -x option 2012-10-06 02:14:48 +00:00			`.TH TFTPFS 4`
			`.SH NAME`
			`tftpfs \- trivial file transfer protocol (TFTP) file system`
			`.SH SYNOPSIS`
			`.B ip/tftpfs`
			`[`
			`.B -D`
			`] [`
			`.B -s`
			`.I srvname`
			`] [`
			`.B -m`
			`.I mtpt`
			`] [`
			`.B -x`
			`.I net`
			`] [`
			`.I ipaddr`
			`]`
			`.SH DESCRIPTION`
			`.I Tftpfs`
			`serves files from a TFTP server as a filesystem. TFTP`
			`is mostly used by bootloaders to download kernel images for`
			`network bootstrap (see`
tftpfs(8): fix manpage reference dhcp(8) -> dhcpd(8) 2015-01-29 12:21:12 +00:00			`.IR dhcpd (8)).`
tftpfs: add manpage, add -x option 2012-10-06 02:14:48 +00:00			`As the protocol has no way of distinguishing files from`
tftpfs(4): minor corrections 2012-10-06 02:25:55 +00:00			`directories, the final path segment needs to conain a dot`
tftpfs: add manpage, add -x option 2012-10-06 02:14:48 +00:00			`(.) character to be recognized as a file. To access files that`
			`have no dot in the filename, a trailing dot has to be added`
tftpfs(4): minor corrections 2012-10-06 02:25:55 +00:00			`and will be stripped before it is passed to the server.`
tftpfs: add manpage, add -x option 2012-10-06 02:14:48 +00:00			`.PP`
			`The`
			`.B -D`
			`option enables 9P debugging messages.`
			`.PP`
			`The`
			`.B -s`
			`option causes`
			`.I tftpfs`
			`to post the 9P service as`
			`.BI /srv/ srvname`
			`and disables the default mount.`
			`.PP`
			`The default mountpoint`
			`.BR /n/tftp`
			`can be changed with the`
			`.B -B`
			`.I mtpt`
			`option.`
			`.PP`
			`The`
			`.B -x`
			`option specifies an alternate network directory`
			`.RI ( e.g.,`
			`.BR /net.alt ).`
			`.PP`
			`The ip address of the server can be passed in`
tftpfs(4): minor corrections 2012-10-06 02:25:55 +00:00			`as the last program argument,`
			`.I ipaddr,`
			`or in the mount spec (see`
tftpfs: add manpage, add -x option 2012-10-06 02:14:48 +00:00			`.IR bind (1))`
			`on a per mount basis.`
			`.SH EXAMPLE`
tftpfs(4): minor corrections 2012-10-06 02:25:55 +00:00			`Boot a kernel from a tftp server (note the final`
tftpfs: add manpage, add -x option 2012-10-06 02:14:48 +00:00			`dot in the kernel path).`
			`.IP`
			`.EX`
tftpfs(4) example typo 2012-10-06 03:14:46 +00:00			`ip/tftpfs 10.192.254.53`
rename pcf kernel to pc, remove pcf, pccpuf, pccpu64 kernels, update documentation there isnt much of a point in keep maintaining separate kernel configurations for terminal and cpu kernels as the role can be switched with service=cpu boot parameter. to make stuff cosistent, we will just have one "pc" kernel and one "pc64" kernel configuration now. 2017-09-10 20:35:23 +00:00			`echo reboot /n/tftp/386/9pc. >/dev/reboot`
tftpfs: add manpage, add -x option 2012-10-06 02:14:48 +00:00			`.EE`
			`.SH SOURCE`
			`.B /sys/src/cmd/ip/tftpfs.c`
			`.SH "SEE ALSO"`
			`.IR dhcpd (8).`