1NCPMOUNT(8) ncpmount NCPMOUNT(8)
2
3
4
6 ncpmount, mount.ncp, mount.ncpfs - mount volume(s) from a specified
7 NetWare fileserver.
8
10 ncpmount [ -h ] [ -S server ] [ -U user name ] [ -P password | -n ] [
11 -C ] [ -c client name ] [ -u uid ] [ -g gid ] [ -f file mode ] [ -d dir
12 mode ] [ -V volume ] [ -t time_out ] [ -r retry_count ] [ -b ] [ -i
13 level ] [ -v ] [ -m ] [ -y iocharset ] [ -p codepage ] [ -N ignored
14 namespace ] [ -2 | -3 | -4 ] [ -s ] [ -A dns name ] mount-point
15
16 mount.ncp remote-server-and-user mount-point [ -n ] [ -v ] [ -o
17 mount_options ]
18
19
20
22 This program is used to mount volumes of the specified NetWare File‐
23 server under the specified mount point.
24
25 ncpfs is a linux filesystem which understands the NCP protocol. This is
26 the protocol Novell NetWare clients use to talk to NetWare servers.
27 ncpfs was inspired by lwared, a free NetWare emulator for Linux written
28 by Ales Dryak. See ftp://klokan.sh.cvut.cz/pub/linux for this very
29 interesting program.
30
31 ncpmount, when invoked with all appropriate arguments, attaches and
32 logs into specified server and mounts all volumes (or one volume or
33 subtree) from server under the specified mount point. ncpmount when
34 invoked without any arguments specifying the fileserver, user id and
35 password checks the file $HOME/.nwclient to find a file server, a user
36 name and possibly a password to use for the specified mount point. See
37 nwclient(5) for more information. Please note that the access permis‐
38 sions of .nwclient MUST be 600, for security reasons.
39
40
42 mount-point
43 mount-point is the directory you want to mount the filesystem over.
44 Its function is the the same as for a normal mount command.
45
46 If the real uid of the caller is not root, ncpmount checks whether
47 the user is allowed to mount a filesystem on the mount-point. So it
48 should be safe to make ncpmount setuid root. The filesystem stores
49 the uid of the user who called ncpmount. So ncpumount can check
50 whether the caller is allowed to unmount the filesystem.
51
52 -S server (mount option server= or part before / in remote-server-and-
53 user)
54 server is the name of the server you want to use.
55
56 -h
57 -h is used to print out a short help text.
58
59 -C (mount option noupcasepasswd)
60 By default passwords are converted to uppercase before they are sent
61 to the server because most servers require this. This option dis‐
62 ables this feature ensuring that passwords are sent without any case
63 conversion.
64
65 -n (mount option nopasswd)
66 -n must be specified for logins that do not have a password config‐
67 ured. This option means do not update /etc/mtab if there is option
68 -o on command line. You must use -o nopasswd in this case.
69
70 passwdfile=file (only mount option)
71 If you want specify password and you do not want store it into world
72 readable /etc/fstab, you can use this option. file then contains
73 lines in form SERVER/USER:PASSWORD:other_data (other_data are cur‐
74 rently unused)
75
76 pass-fd=fd (only mount option)
77 If you want to pass password in secure way to ncpmount, you can pass
78 it through specified fd.
79
80 -P password (mount option passwd=)
81 specifies the password to use for the Netware user id.
82
83 If neither -n nor the -P nor the passwdfile= nor the pass-fd= argu‐
84 ments are specified ncpmount will prompt for a password. This makes
85 it difficult to use in scripts such as /etc/rc. If you want to have
86 ncpmount work automatically from a script you must include the
87 appropriate option and be very careful to ensure that appopriate
88 file permissions are set for the script that includes your password
89 to ensure that others can not read it.
90
91 -U user name (mount option user= or rest of remote-server-and-user
92 after /)
93 Specifies the Netware user id to use when logging in to the file‐
94 server. If this option is not specified then ncpmount will attempt
95 to login to the fileserver using the Linux login id of the user
96 invoking ncpmount.
97
98 -m (mount option multiple)
99 Normally, ncpmount limits number of connections from client to
100 server to one per unique user name. If you want mount more than one
101 connection with same username and server, you must specify -m.
102
103 -u uid, -g gid (mount option uid= and gid=)
104 ncpmount does not yet implement a scheme for mapping NetWare
105 users/groups to Linux users/groups. Linux requires that each file
106 has an owner and group id. With -u and -g you can tell ncpmount
107 which id's it should assign to the files in the mounted directory.
108
109 The defaults for these values are the current uid and gid.
110
111 -c user name (mount option owner=)
112 -c names the user who is the owner of the connection, where owner
113 does not refer to file ownership (that "owner" is set by the -u
114 argument), but the owner of the mount, ie: who is allowed to call
115 ncpumount on this mount. The default owner of the connection and the
116 mount is the user who called ncpmount. This option allows you to
117 specify that some other user should be set as the owner.
118
119 In this this way it is possible to mount a public read-only direc‐
120 tory, but to allow the lp daemon to print on NetWare queues. This is
121 possible because only users who have write permissions on a direc‐
122 tory may issue ncp requests over a connection. The exception to this
123 rule is the 'mount owner', who is also granted 'request permission'.
124
125 -f file mode, -d dir mode (mount option mode= (or filemode=) and
126 dirmode=)
127 Like -u and -g, these options are used to determine what permissions
128 should be assigned files and directories of the mounted volumes. The
129 values must be specified as octal numbers. The default values are
130 taken from the current umask, where the file mode is the current
131 umask, and the dir mode adds execute permissions where the file mode
132 gives read permissions.
133
134 Note that these permissions can differ from the rights the server
135 gives to us. If you do not have write permissions on the server, you
136 can very well choose a file mode that tells that you have. This cer‐
137 tainly cannot override the restrictions imposed by the server.
138
139 -V volume (mount option volume=)
140 There are 2 general ways you can mount a NetWare server's disk
141 space: Either you can mount all volumes under one directory, or you
142 can mount only a single volume.
143
144 When you choose to mount the complete disk space at once, you have
145 the advantage that only one Linux mount point and only one NetWare
146 connection is used for all the volumes of this server. Both of these
147 are limited resources. (Although raising the number of Linux mount
148 points is significantly cheaper than raising the number of available
149 NetWare connections ;-))
150
151 When you specify to mount a single volume by using the option -V
152 volume, you have the big advantage that nfsd is able to re-export
153 this mounted directory. You must invoke nfsd and mountd with the
154 option --re-export to make nfsd re-export ncpfs mounted directories.
155 This uses one Linux mount point and one NetWare connection per
156 mounted volume. Maybe sometime in the future I will make it possible
157 to mount all volumes on different mount points, using only one con‐
158 nection.
159
160 -t time_out (mount option timeo= or timeout=)
161 With -t you can adjust the time ncpfs waits for the server to answer
162 a request it sent. Use the option to raise the timeout value when
163 your ncpfs connections seem to be unstable although your servers are
164 well up. This can happen when you have very busy servers, or servers
165 that are very far away.
166
167 time_out is specified in 1/100s, the current default value is 60.
168
169 -r retry_count (mount option retry=)
170 As -t, -r can be used to tune the ncpfs connection to the server.
171 With retry_count you can specify how many times ncpfs will attempt
172 to send a packet to the server before it decides the connection is
173 dead. The current default value is 5.
174
175 Currently ncpfs is not too clever when trying to find out that con‐
176 nections are dead. If anybody knows how to do that correctly, as it
177 is done by commercial workstations, please tell me.
178
179 -y iocharset (mount option iocharset=)
180 You can specify character translation rules for converting names
181 from unicode to your desktop (it works together with -p). iocharset
182 is charset name, for example iso-8859-1.
183
184 -p codepage (mount option codepage=)
185 You can specify character translation rules for converting names
186 from Netware encoding to unicode (it works together with -y). code‐
187 page is codepage name, for example cp437.
188
189 -b (mount option bindery)
190 If you are connecting to NetWare 4 or NetWare 5 through bindery emu‐
191 lation instead of NDS, you must specify this option.
192
193 -i level (mount option signature=level)
194 Enables packet signing. level is from 0 to 3: 0 means disable, 1
195 means sign if server needs it, 2 means sign if server allows it and
196 3 means sign packets always.
197
198 -v
199 Print ncpfs version number. It has another meaning (verbose) if you
200 specify -o on command line. If you are interested in version, type
201 ncpmount -v without another options.
202
203 -A dns name (mount option ipserver=dns name)
204 When you are mounting volumes from NetWare 5 server over UDP, you
205 must specify dns name of server here and logical server name in -S
206 (or in server=). This name is used to switch ncpmount into UDP mode
207 and to specify server to connect. Currently, DNS is only supported
208 IP name resolution protocol. There is currently no support for SLP.
209
210 -N ignored namespace (mount option nonfs and nolong)
211 ncpfs supports NFS, LONG (OS/2) and DOS namespace on NetWare vol‐
212 umes. If you do not want to use NFS or LONG namespace (because of
213 bugs in (server) code or for backward compatibility), you must spec‐
214 ify these ignored namespaces in mount parameters.
215
216 -2
217 If you have unusual ncpfs code in kernel and ncpmount is not able to
218 autodetect it, use this option. It switches ncpmount to ncpfs inter‐
219 face version 2. This interface was used in 2.0.x kernels, does not
220 support NCP/UDP, does not have NDS authentication info storage and
221 uses only 16bit uid/gid.
222
223 -3
224 If you have unusual ncpfs code in kernel and ncpmount is not able to
225 autodetect it, use this option. It switches ncpmount to ncpfs inter‐
226 face version 3. This interface was used in kernels from 2.1.30 to
227 2.3.40 (laters 2.3.x and 2.4.x still supports this interface to make
228 transition easier). This interface supports NCP/UDP, does have NDS
229 authentication info storage (if you uncomment it in kernel sources)
230 and uses 16bit uid/gid.
231
232 -4
233 If you have unusual ncpfs code in kernel and ncpmount is not able to
234 autodetect it, use this option. It switches ncpmount to ncpfs inter‐
235 face version 4. This interface is used in kernels after 2.3.40. This
236 interface supports NCP/UDP, does have NDS authentication info stor‐
237 age and uses 32bit uid/gid.
238
239 -s (mount option strong)
240 Normally, files marked read-only cannot be removed from NetWare vol‐
241 ume because of they are marked Delete Inhibit and Rename Inhibit. If
242 you want to remove these files by simple unlink, you should mount
243 volume with this option.
244
245 mount option nostrong
246 Refuse to remove read-only files. If you want remove such file, you
247 must first remove read-only attribute. It is standard behavior of
248 ncpfs.
249
250 mount option symlinks
251 Use special, normally unused, attributes combinations to express
252 symlinks, executable attributes and files readable by world.
253
254 mount option nosymlinks
255 Do not allow special meaning of 'shareable' attribute. This is a
256 default.
257
258 mount option ipx
259 Use IPX for connection to server. Default if no ipserver option
260 specified on cmdline.
261
262 mount option udp
263 Use UDP for connection to server. Not available in 2.0.x kernels.
264 Default if ipserver is used.
265
266 mount option tcp
267 Use TCP for connection to server. Available only with 2.4.0 and
268 later kernels.
269
270 mount option nfsextras
271 Use the meta-data provided by the NFS namespace to allow files'
272 modes to be changed, and to allow the creation of symlinks and named
273 pipes. This adds significant overhead to fetching file information.
274
275 mount option nonfsextras
276 Do not make use of meta-data provided by the NFS namespace. This is
277 the default.
278
279
281 USER / LOGNAME
282 The variables USER or LOGNAME may contain the username of the person
283 using the client. USER is tried first. If it's empty, LOGNAME is
284 tried.
285
286
288 Most diagnostics issued by ncpfs are logged by syslogd. Normally noth‐
289 ing is printed, only error situations are logged there.
290
291
293 If you want to mount volume SYS as user DOWNLOAD from server MIRROR
294 into directory /home/pub/mirror, with files owner mirror.mirror and
295 file mode -rw-r--r--, you can add
296
297 MIRROR/DOWNLOAD /home/pub/mirror ncp defaults,mode=644,uid=mir‐
298 ror,gid=mirror,owner=root,volume=SYS,nopasswd,multiple
299
300 into /etc/fstab. You should always specify multiple in mount options,
301 otherwise there can be only one connection to server with same name.
302
303
305 IPX
306 You must configure the IPX subsystem before ncpmount will work. It
307 is especially important that there is a route to the internal net‐
308 work of your server.
309
310 IP
311 You must specify both -S logical_name and -A dns_name. logical_name
312 is used for searching .nwclient, other configuration files and is
313 logged into /etc/mtab, dns_name is used for connecting to server. In
314 future, logical_name will be read from server.
315
316
318 syslogd(8), ncpumount(8), nfsd(8), mountd(8), mount(8)
319
320
322 ncpfs would not have been possible without lwared, written by Ales
323 Dryak (A.Dryak@sh.cvut.cz).
324
325 The encryption code was taken from Dr. Dobbs's Journal 11/93. There
326 Pawel Szczerbina described it in an article on NCP.
327
328 The ncpfs code was initially hacked from smbfs by Volker Lendecke
329 (lendecke@math.uni-goettingen.de). smbfs was put together by Paal-Kr.
330 Engstad (pke@engstad.ingok.hitos.no) and later polished by Volker.
331
332 Code is currently maintained by Petr Vandrovec (vandrove@vc.cvut.cz).
333
334
335
336ncpmount 12/04/1998 NCPMOUNT(8)