Documentation/filesystems/9p.rst

1 .. SPDX-License-Identifier: GPL-2.0
4 v9fs: Plan 9 Resource Sharing for Linux
10 v9fs is a Unix implementation of the Plan 9 9p remote filesystem protocol.
19 the 9p client is available in the form of a USENIX paper:
26 	  http://xcpu.org/papers/xcpu-talk.pdf
30 	  http://xcpu.org/papers/cellfs-talk.pdf
31 	* PROSE I/O: Using 9p to enable Application Partitions
33 	* VirtFS: A Virtualization Aware File System pass-through
41 	mount -t 9p 10.10.1.2 /mnt/9
43 For Plan 9 From User Space applications (http://swtch.com/plan9)::
45 	mount -t 9p `namespace`/acme /mnt/9 -o trans=unix,uname=$USER
49 	mount -t 9p -o trans=virtio <mount_tag> /mnt/9
52 mount points. Each 9P export is seen by the client as a virtio device with an
54 seen by reading /sys/bus/virtio/drivers/9pnet_virtio/virtio<n>/mount_tag files.
87                                 intended for exclusive, read-only mounts
89 				use FS-Cache for a persistent, read-only
92 				minimal cache that is only used for read-write
98 			0x01    display verbose error messages
99 			0x02    developer debug (DEBUG_CURRENT)
100 			0x04    display 9p trace
101 			0x08    display VFS trace
102 			0x10    display Marshalling debug
103 			0x20    display RPC debug
104 			0x40    display transport debug
105 			0x80    display allocation debug
106 			0x100   display protocol message debug
107 			0x200   display Fid debug
108 			0x400   display packet debug
109 			0x800   display fscache tracing debug
116   msize=n	the number of bytes to use for 9p packet payload
120   noextend	force legacy mode (no 9p2000.u or 9p2000.L semantics)
122   version=name	Select 9P protocol version. Valid options are:
125 			9p2000          Legacy mode (same as noextend)
126 			9p2000.u        Use 9P2000.u protocol
127 			9p2000.L        Use 9P2000.L protocol
134   afid		security channel - used by Plan 9 authentication protocols
136   nodevmap	do not map special files - represent them as normal files.
153 				 ACL based access check on the 9p client
158 		/sys/fs/9p/caches. (applies only to cache=fscache)
164 This section aims at describing 9p 'quirks' that can be different
167  - Setting O_NONBLOCK on a file will make client reads return as early
175 http://ericvh.github.com/9p-rfc/
177 9p client and server implementations are listed on
178 http://9p.cat-v.org/implementations
180 A 9p2000.L server is being developed by LLNL and can be found
191 For more information on the Plan 9 Operating System check out
192 http://plan9.bell-labs.com/plan9
194 For information on Plan 9 from User Space (Plan 9 applications and libraries
195 ported to Linux/BSD/OSX/etc) check out https://9fans.github.io/plan9port/