]> git.lizzy.rs Git - plan9front.git/blob - sys/man/4/oexportfs
exportfs, oexportfs, iostats: make -d log to stderr
[plan9front.git] / sys / man / 4 / oexportfs
1 .TH OEXPORTFS 4
2 .SH NAME
3 oexportfs \- legacy exportfs for cpu and import
4 .SH SYNOPSIS
5 .PP
6 .B oexportfs
7 [
8 .I options
9 ]
10 .SH DESCRIPTION
11 .I Oexportfs
12 is older version of the
13 .IR exportfs (4)
14 program that handles an initial protocol to establish a root directory
15 for the exported name space.
16 It also provides authentication and encryption using
17 the
18 .IR ssl (3)
19 device.
20 .PP
21 It is used exclusively by the deprecated
22 .IR cpu (1)
23 and
24 .IR import (4)
25 services.
26 .PP
27 The options are:
28 .TP
29 .B -d
30 Log all 9P traffic to standard error.
31 .TP
32 .B -P \fIpatternfile
33 Restrict the set of exported files.
34 .I Patternfile
35 contains one regular expression per line,
36 to be matched against path names
37 relative to the current working directory
38 and starting with
39 .BR / .
40 For a file to be exported, all lines with a prefix
41 .B +
42 must match and all those with prefix
43 .B -
44 must not match.
45 .TP
46 .B -R
47 Make the served name space read only.
48 .TP
49 .B -r \fIroot
50 Serve the name space rooted at
51 .IR root .
52 .TP
53 .B -S \fIservice
54 Serve the result of mounting
55 .IR service .
56 A separate mount is used for each
57 .IR attach (5)
58 message,
59 to correctly handle servers in which each mount
60 corresponds to a different client
61 .IR e.g. , (
62 .IR rio (4)).
63 .TP
64 .B -s
65 equivalent to
66 .B -r
67 .BR / ;
68 kept for compatibility.
69 .TP
70 .B -m \fImsize
71 Set the maximum message size that 
72 .I oexportfs
73 should offer to send (see
74 .IR version (5));
75 this helps tunneled
76 9P connections to avoid unnecessary fragmentation.
77 .TP
78 .B -A \fIaddress
79 Use the network
80 .I address
81 to announce
82 .IR aan (8)
83 connections,
84 if requested by the initial protocol.
85 .TP
86 .B -a
87 Authenticate the user with the
88 .I p9any
89 protocol before running the regular
90 .I oexportfs
91 session; used when 
92 .I oexportfs
93 is invoked to handle an incoming network connection.
94 .I Exportfs
95 creates a new name space for each connection, using
96 .B /lib/namespace
97 by default (see
98 .IR namespace (6)).
99 .TP
100 .B -B \fIaddress
101 Dial
102 .IR address ,
103 authenticate as a
104 .I p9any
105 client, and then
106 serve that network connection.
107 Requires setting the root of the name space with 
108 .B -r
109 or
110 .BR -s .
111 The remote system should run
112 .B import
113 .B -B
114 to handle the call.
115 See
116 .IR import (4)
117 for an example.
118 .TP
119 .B -e '\fIenc auth\fL'
120 Set the encryption and authentication algorithms to use for
121 encrypting the wire traffic (see
122 .IR ssl (3)).
123 The defaults are
124 .B rc4_256
125 and
126 .BR sha1 .
127 .TP
128 .B -N \fInsfile
129 Serve the name space described by
130 .IR nsfile .
131 .TP
132 .B -n
133 Disallow mounts by user
134 .BR none .
135 .EE
136 .SH SOURCE
137 .B /sys/src/cmd/exportfs/oexportfs.c
138 .SH SEE ALSO
139 .IR dial (2),
140 .IR exportfs (4),
141 .IR import (4),
142 .IR aan (8),
143 .IR listen (8)