Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
9P(1)			    General Commands Manual			 9P(1)

       9p - read and write files on a 9P server

       9p [ options ] read path
       9p [ options ] readfd path

       9p [ options ] write [ -l ] path
       9p [ options ] writefd path

       9p [ options ] stat path

       9p [ options ] rdwr path

       9p [ options ] ls [ -dl ] path...

       9p is a trivial 9P client that can access a single file on a 9P server.
       It can be useful	for manual interaction with a 9P server	or for access-
       ing  simple  9P services	from within shell scripts.  The	common options

       -a addr
	      dial the server at addr

       -A aname
	      attach to	the file system	named aname

       -n     mount without authentication

       The first argument is a command,	one of:

       read   print the	contents of path to standard output

       write  write data on standard input to path; the	-l option causes write
	      to write one line	at a time

       readfd, writefd
	      like  read  and  write  but use openfd(9p) instead of open; this
	      masks errors and is mainly useful	for debugging the  implementa-
	      tion of openfd

       stat   execute stat (9p)	on path	and print the result

       rdwr   Open  path  for  reading and writing.  Then repeat until end-of-
	      file on standard input: copy a line from the  file  to  standard
	      output,  copy a line from	standard input to the file.  Print er-
	      rors, but	don't give up.	Rdwr is	useful	for  interacting  with
	      servers like

       ls     Print  a	directory listing in the format	of The -d and -l flags
	      have the same meaning as in ls.

       9p dials	address	to connect to the 9P server.  If the -a	option is  not
       given,  9p requires the path to be of the form service/subpath; it con-
       nects to	the Unix domain	socket service in  the	name  space  directory
       (see and	then accesses subpath.

       To update copy of your plumbing rules after editing $HOME/lib/plumbing:

	      cat $HOME/lib/plumbing | 9p write	plumb/rules

       To display the contents of the current window:

	      9p read acme/$winid/body





Want to link to this manual page? Use this URL:

home | help