Documentation/filesystems/9p.rst

1 .. SPDX-License-Identifier: GPL-2.0
26 	  http://xcpu.org/papers/xcpu-talk.pdf
30 	  http://xcpu.org/papers/cellfs-talk.pdf
33 	* VirtFS: A Virtualization Aware File System pass-through
34 	  https://kernel.org/doc/ols/2010/ols2010-pages-109-120.pdf
41 	mount -t 9p 10.10.1.2 /mnt/9
45 	mount -t 9p `namespace`/acme /mnt/9 -o trans=unix,uname=$USER
49 	mount -t 9p -o trans=virtio <mount_tag> /mnt/9
59 To mount a 9p FS on a USB Host accessible via the gadget at runtime::
61 	mount -t 9p -o trans=usbg,aname=/path/to/fs <device> /mnt/9
63 To mount a 9p FS on a USB Host accessible via the gadget as root filesystem::
67 where <device> is the tag associated by the usb gadget transport.
73 The USB host exports a filesystem, while the gadget on the USB device
79 on the USB bus and start forwarding requests.
82 host. The reason is that USB device ports are normally not available on
85 When using the usbg transport, for now there is no native usb host
87 this we have to use the extra python tool p9_fwd.py from tools/usb.
89 Just start the 9pfs capable network server like diod/nfs-ganesha e.g.::
91         $ diod -f -n -d 0 -S -l 0.0.0.0:9999 -e $PWD
95         $ python $kernel_dir/tools/usb/p9_fwd.py list
98         --- | ---- | ---------------- | ---------------- | --------- | ----
99           2 |   67 | unknown          | unknown          | 1d6b:0109 | 2-1.1.2
100           2 |   68 | unknown          | unknown          | 1d6b:0109 | 2-1.1.3
104         $ python $kernel_dir/tools/usb/p9_fwd.py --path 2-1.1.2 connect -p 9999
108 One use-case is to use it as an alternative to NFS root booting during
126 			usbg	  connect to a specified usb gadget channel
144 			0b00000010  meta-data caches enabled
154 			readahead   0b00000001 (only read-ahead file caching)
155 			mmap        0b00000101 (read-ahead + writeback file cache)
156 			loose       0b00001111 (non-coherent file and meta-data caches)
161 		moment, so using other combinations of bit-patterns is not
210   afid		security channel - used by Plan 9 authentication protocols
212   nodevmap	do not map special files - represent them as normal files.
226 			        attach command (Tattach) for that user.
232 				v9fs does single attach and performs all
249  - Setting O_NONBLOCK on a file will make client reads return as early
257 http://ericvh.github.com/9p-rfc/
260 http://9p.cat-v.org/implementations
274 http://plan9.bell-labs.com/plan9