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
|
|
|
|
|
.IR dhcp (8)).
|
|
|
|
|
As the protocol has no way of distinguishing files from
|
2012-10-06 02:25:55 +00:00
|
|
|
directories, the final path segment needs to conain a dot
|
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
|
2012-10-06 02:25:55 +00:00
|
|
|
and will be stripped before it is passed to the server.
|
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
|
2012-10-06 02:25:55 +00:00
|
|
|
as the last program argument,
|
|
|
|
|
.I ipaddr,
|
|
|
|
|
or in the mount spec (see
|
2012-10-06 02:14:48 +00:00
|
|
|
.IR bind (1))
|
|
|
|
|
on a per mount basis.
|
|
|
|
|
.SH EXAMPLE
|
2012-10-06 02:25:55 +00:00
|
|
|
Boot a kernel from a tftp server (note the final
|
2012-10-06 02:14:48 +00:00
|
|
|
dot in the kernel path).
|
|
|
|
|
.IP
|
|
|
|
|
.EX
|
|
|
|
|
ip/tftpd 10.192.254.53
|
|
|
|
|
echo reboot /n/tftp/386/9pcf. >/dev/reboot
|
|
|
|
|
.EE
|
|
|
|
|
.SH SOURCE
|
|
|
|
|
.B /sys/src/cmd/ip/tftpfs.c
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.IR dhcpd (8).
|
