forked from mischief/9pfs
-
Notifications
You must be signed in to change notification settings - Fork 3
/
9pfs.1
115 lines (115 loc) · 2.7 KB
/
9pfs.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
.Dd $Mdocdate: August 24 2015 $
.Dt 9PFS 1
.Os
.Sh NAME
.Nm 9pfs
.Nd mount 9P service via FUSE
.Sh SYNOPSIS
.Nm 9pfs
.Bk -words
.Op Fl anU
.Op Fl A Ar aname
.Op Fl p Ar port
.Op Fl u Ar user
.Ar service
.Ar mtpt
.Ek
.Sh DESCRIPTION
.Nm 9pfs
mounts the 9P service running at
.Ar service
onto
.Ar mtpt
using the FUSE user-level file system driver.
.Pp
The following options are available:
.Bl -tag -width Ds
.It Fl a
Negotiate authentication using a local factotum. See
.Sx ENVIRONMENT
and
.Sx EXAMPLES
for more details.
.It Fl n
Do not negotiate authentication. This is the
default.
.It Fl U
The 9P service is a UNIX-domain
socket.
.It Fl A Ar aname
The attach name to send to the 9P service.
.It Fl p Ar port
Specifies the connection port for the 9P service.
The default is 564.
.It Fl u Ar user
Specifies the username to use on authentication
and attach to the 9P service.
.It Fl d
Causes debug information for subsequent FUSE library calls to be
output to stderr. Implies -f.
.It Fl f
This flag indicates that the file system should not detach from the
controlling terminal and run in the foreground.
.It Fl o Ar option
Passes additional option to fuse_mount(3).
.El
.Pp
9pfs caches directories it reads which will cause
inconsistencies if a different 9P client is connected
to and making changes to the same 9P service. There
is a virtual control file
.Ql .fscache
in each directory served by 9pfs.
Reading or writing anything to that file will clear
the cache for that directory.
.Sh ENVIRONMENT
.Bl -tag -width FACTOTUM
.It Ev FACTOTUM
Authentication requires that the 9P service
provided by a factotum
.Po see
.Lk http://man.cat-v.org/9front/4/factotum
.Pc
is mounted at the path specified by the
.Ev FACTOTUM
environment variable. Plan 9 from User Space
.Po
.Lk https://swtch.com/plan9port/
.Pc
provides a port of factotum to
UNIX-like operating systems.
See the
.Sx EXAMPLES
section below for details.
.El
.Sh EXAMPLES
The following will mount a remote 9P service
with authentication, so long as plan9port is
installed.
.Pp
.Dl $ factotum -n
.Dl $ 9pfs -U `namespace`/factotum mnt/factotum
.Dl $ export FACTOTUM=`pwd`/mnt/factotum
.Dl $ 9pfs -a spew.net mnt/spew
.Dl !adding key: role=client proto=p9sk1 dom=spew
.Dl user[glenda]:
.Dl password:
.Dl !
.Pp
The dom for authentication will need
to assigned an IP address via /etc/hosts or your
plan9port $PLAN9/ndb/local file. The utilities
.Ar factotum
and
.Ar namespace
are from Russ Cox's
.Lk https://swtch.com/plan9port/ plan9port
.Sh BUGS
OpenBSD does not display all the files in a very large
directory.
.Pp
Moving a file to a different directory is not implemented.
To do so, copy the file and then remove it.
.Pp
You cannot access or create a file on the 9P server
named .fscache in any directory.