aboutsummaryrefslogtreecommitdiff
path: root/sbin/mount_nwfs/mount_nwfs.8
blob: fa1855b7eab94cc801a86f73c3b574c2e903e4d0 (plain) (blame)
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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
.\" $FreeBSD$
.Dd October 14, 1999
.Dt MOUNT_NWFS 8
.Os
.Sh NAME
.Nm mount_nwfs
.Nd mount NetWare volume from a NetWare file server
.Sh SYNOPSIS
.Nm
.Op Fl Chv
.Fl S Ar server
.Fl U Ar user
.Op Fl connection\ options
.Fl V Ar volume
.Op Fl M Ar mode
.Op Fl c Ar case
.Op Fl d Ar mode
.Op Fl f Ar mode
.Op Fl g Ar gid
.Op Fl l Ar locale
.Op Fl n Ar os2
.Op Fl u Ar uid
.Op Fl w Ar scheme
.Ar node
.Nm
.Op Fl options
.Ar /server:user/volume[/path]
.Ar node
.Sh DESCRIPTION
The
.Nm
command allows to mount volume from a NetWare server.
It may use either
existing connection or create new: if no usable connection was found
it will try to establish a new one.
Connection has count of references to it,
so when last mount will be dismounted connection will be closed.
It is
possible to create connection without any mounts (but use it for them) with
.Xr ncplogin 1 .
.Pp
Note two forms of command line.
In the first form, server and user specified
via
.Fl S
and
.Fl U
options respectively.
In the second form server and user specified in
.Ar special
part of
.Xr mount 8
command line arguments (the
.Fl S ,
.Fl U
and
.Fl V
options aren't used in this case).
This allows use of
.Xr fstab 5
file (see
.Sx EXAMPLES
below).
.Pp
The options are:
.Bl -tag -width indent
.It Fl S Ar server
Name of NetWare server to connect.
For native IP you will need also
.Fl A
option.
.It Fl U Ar user
Name of user used in login sequence.
.It Fl connection\ options
See
.Xr ncplogin 1
for details.
.It Fl V Ar volume
Volume name to mount.
Volume name can also be specified after all options and
before
.Ar mount-point .
.It Ar node
Path to mount volume.
.It Fl c Ar case
Select a
.Ar case
option which affects on name representation.
.Ar Case
can be one of the following:
.Bl -tag -width "ValueXX"
.It Em Value
.Em Meaning
.It l
All existing file names converted to lower case.
Newly created file gets a lower case under OS2 name space.
This is the default when mounting volumes with DOS name space.
.It L
Same as 'l' but file system tries to be case insensitive.
May not work well.
.It n
No case conversion is performed.
.Em Warning !
Use this option with DOS name space only as a last resort,
because creating a lower case name in the DOS name space
can lead to unpredictable results.
This is the default when mounting volumes with OS2 name space.
.It u
All existing file names converted to upper case.
Newly created file gets an upper case under OS2 name space.
.It U
Same as 'u' but file system tries to be case insensitive.
May not work well.
.El
.It Fl f Ar mode , Fl d Ar mode
Specify permissions that should be assigned to files and directories.
The values must be specified as octal numbers.
Default value for the file mode
is taken from mount point, default value for the dir mode adds execute
permission where the file mode gives read permission.
.Pp
Note that these permissions can differ from the rights granted by NetWare
server.
.It Fl n Ar namespace
Don't use
.Ar namespace .
Currently only
.Ar OS2
can be here.
.It Fl v
Print version number.
.It Fl u Ar uid , Fl g Ar gid
User id and group id assigned to files.
The default is owner and group id from
directory where volume is mounted.
.It Fl l Ar locale
Set the locale for case conversion.
By default
.Nm
tries to use an environment variable
.Ev LC_* .
.It Fl w Ar scheme
Select a
.Ar scheme
used to convert file names between NetWare and
.Fx .
Currently only
.Ar koi2cp866
and
.Ar asis
can be here.
Please note, that scheme should be enabled at compile
time in
.Pa config.mk
file.
.It Fl M Ar mode
See
.Xr ncplogin 1
for details.
If this option is omitted, connection permissions
assumed the same as directory mode
.Pq Fl d
option.
.El
.Sh FILES
.Bl -tag -width /var/log/wtmp -compact
.It Pa ~/.nwfsrc
keeps static parameters for connections and other information.
See
.Pa /usr/share/examples/nwclient/dot.nwfsrc
for details.
.El
.Sh NOTES
Before any NCP connection can be established kernel must be configured
for IPX support, IPXrouted and KLD nwfs.ko should be loaded.
.Sh EXAMPLES
Next examples illustrates how to connect to NetWare server
.Em nwserv
as user
.Em GUEST
and mount volumes
.Em SYS
and
.Em VOL1 :
.Bd -literal -offset indent
mount_nwfs -S nwserv -U guest -V sys /nw/s1/sys
mount_nwfs /nwserv:guest/sys /nw/s1/sys
mount -t nwfs /nwserv:guest/vol1 /nw/s1/vol1
mount -t nwfs /nwserv:boris/sys/home/boris /home/boris/nw/home
.Ed
.Pp
The last example mounts only subdirectory on a volume and equivalent
to NetWare 'map root' command.
.Pp
It is possible to use
.Xr fstab 5
for nwfs mounts:
.Bd -literal -offset indent
/nwserv:guest/sys       /nw/s1/sys     nwfs  rw,noauto 0   0
/nwserv:guest/vol1      /nw/s1/vol2    nwfs  rw,noauto 0   0
.Ed
.Sh HISTORY
The
.Nm
utility first appeared in
.Fx 4.0 .
.Sh BUGS
to number a few
.Sh CREDITS
In development of NetWare client for
.Fx ,
the following sources were used:
.Pp
Documentation from NetWare NDK.
.Pp
Ncpfs for Linux - written by
.An Volker Lendecke Aq lendecke@math.uni\-goettingen.de .
He granted me permission to publish parts of his code under BSD-style license,
.Pp
"Interrupt List" from
.An Ralf Brown ,
.Pp
Many files from
.Pa /sys
directory.
.Sh AUTHORS
.An Boris Popov Aq bp@butya.kz ,
.Aq rbp@chat.ru