7 .Nd mount NetWare volume from a NetWare file server
13 .Op Fl connection\ options
27 .Ar /server:user/volume[/path]
32 utility allows to mount volume from a NetWare server.
34 existing connection or create new: if no usable connection was found
35 it will try to establish a new one.
36 Connection has count of references to it,
37 so when last mount will be dismounted connection will be closed.
39 possible to create connection without any mounts (but use it for them) with
42 Note two forms of command line.
43 In the first form, server and user specified
49 In the second form server and user specified in
53 command line arguments (the
58 options are not used in this case).
66 .Bl -tag -width indent
68 Name of NetWare server to connect.
69 For native IP you will need also
73 Name of user used in login sequence.
74 .It Fl connection\ options
80 Volume name can also be specified after all options and
88 option which affects on name representation.
90 can be one of the following:
91 .Bl -tag -width "ValueXX"
95 All existing file names converted to lower case.
96 Newly created file gets a lower case under OS2 name space.
97 This is the default when mounting volumes with DOS name space.
99 Same as 'l' but file system tries to be case insensitive.
102 No case conversion is performed.
104 Use this option with DOS name space only as a last resort,
105 because creating a lower case name in the DOS name space
106 can lead to unpredictable results.
107 This is the default when mounting volumes with OS2 name space.
109 All existing file names converted to upper case.
110 Newly created file gets an upper case under OS2 name space.
112 Same as 'u' but file system tries to be case insensitive.
115 .It Fl f Ar mode , Fl d Ar mode
116 Specify permissions that should be assigned to files and directories.
117 The values must be specified as octal numbers.
118 Default value for the file mode
119 is taken from mount point, default value for the dir mode adds execute
120 permission where the file mode gives read permission.
122 Note that these permissions can differ from the rights granted by NetWare
124 .It Fl n Ar namespace
131 Print version number.
132 .It Fl u Ar uid , Fl g Ar gid
133 User id and group id assigned to files.
134 The default is owner and group id from
135 directory where volume is mounted.
137 Set the locale for case conversion.
140 tries to use an environment variable
145 used to convert file names between NetWare and
147 Supported conversion schemes are:
148 .Bl -tag -width ".Cm koi2cp866"
150 Characters passed as is without any alteration.
154 Suits for setups used in Sweden.
160 If this option is omitted, connection permissions
161 assumed the same as directory mode
166 .Bl -tag -width /var/log/wtmp -compact
168 keeps static parameters for connections and other information.
170 .Pa /usr/share/examples/nwclient/dot.nwfsrc
174 Before any NCP connection can be established kernel must be configured
175 for IPX support, IPXrouted and KLD nwfs.ko should be loaded.
177 Next examples illustrates how to connect to NetWare server
185 .Bd -literal -offset indent
186 mount_nwfs -S nwserv -U guest -V sys /nw/s1/sys
187 mount_nwfs /nwserv:guest/sys /nw/s1/sys
188 mount -t nwfs /nwserv:guest/vol1 /nw/s1/vol1
189 mount -t nwfs /nwserv:boris/sys/home/boris /home/boris/nw/home
192 The last example mounts only subdirectory on a volume and equivalent
193 to NetWare 'map root' command.
195 It is possible to use
198 .Bd -literal -offset indent
199 /nwserv:guest/sys /nw/s1/sys nwfs rw,noauto 0 0
200 /nwserv:guest/vol1 /nw/s1/vol2 nwfs rw,noauto 0 0
205 utility first appeared in
208 In development of NetWare client for
210 the following sources were used:
212 Documentation from NetWare NDK.
214 Ncpfs for Linux - written by
215 .An Volker Lendecke Aq lendecke@math.uni\-goettingen.de .
216 He granted me permission to publish parts of his code under
220 "Interrupt List" from
227 .An Boris Popov Aq bp@butya.kz ,