sys/man/4/tftpfs

   1 .TH TFTPFS 4
   2 .SH NAME
   3 tftpfs \- trivial file transfer protocol (TFTP) file system
   4 .SH SYNOPSIS
   5 .B ip/tftpfs
   6 [
   7 .B -D
   8 ] [
   9 .B -s
  10 .I srvname
  11 ] [
  12 .B -m
  13 .I mtpt
  14 ] [
  15 .B -x
  16 .I net
  17 ] [
  18 .I ipaddr
  19 ]
  20 .SH DESCRIPTION
  21 .I Tftpfs
  22 serves files from a TFTP server as a filesystem. TFTP
  23 is mostly used by bootloaders to download kernel images for
  24 network bootstrap (see
  25 .IR dhcpd (8)).
  26 As the protocol has no way of distinguishing files from
  27 directories, the final path segment needs to conain a dot
  28 (.) character to be recognized as a file. To access files that
  29 have no dot in the filename, a trailing dot has to be added
  30 and will be stripped before it is passed to the server.
  31 .PP
  32 The
  33 .B -D
  34 option enables 9P debugging messages.
  35 .PP
  36 The
  37 .B -s
  38 option causes
  39 .I tftpfs
  40 to post the 9P service as
  41 .BI /srv/ srvname
  42 and disables the default mount.
  43 .PP
  44 The default mountpoint
  45 .BR /n/tftp
  46 can be changed with the
  47 .B -B
  48 .I mtpt
  49 option.
  50 .PP
  51 The
  52 .B -x
  53 option specifies an alternate network directory
  54 .RI ( e.g.,
  55 .BR /net.alt ).
  56 .PP
  57 The ip address of the server can be passed in
  58 as the last program argument,
  59 .I ipaddr,
  60  or in the mount spec (see
  61 .IR bind (1))
  62 on a per mount basis.
  63 .SH EXAMPLE
  64 Boot a kernel from a tftp server (note the final
  65 dot in the kernel path).
  66 .IP
  67 .EX
  68 ip/tftpfs 10.192.254.53
  69 echo reboot /n/tftp/386/9pc. >/dev/reboot
  70 .EE
  71 .SH SOURCE
  72 .B /sys/src/cmd/ip/tftpfs.c
  73 .SH "SEE ALSO"
  74 .IR dhcpd (8).