1NCPMOUNT(8) ncpmount NCPMOUNT(8)
2
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 mount.ncp remote-server-and-user mount-point [ -n ] [ -v ] [ -o
17 mount_options ]
18
22 This program is used to mount volumes of the specified NetWare File‐
23 server under the specified mount point.
24 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 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
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 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 -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 -h
57 -h is used to print out a short help text.
58 -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 -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 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 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 -P password (mount option passwd=)
81 specifies the password to use for the Netware user id.
82 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 -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 -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 -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 The defaults for these values are the current uid and gid.
110 -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 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 -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 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 -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 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 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 -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 time_out is specified in 1/100s, the current default value is 60.
168 -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 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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 -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 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 mount option symlinks
251 Use special, normally unused, attributes combinations to express
252 symlinks, executable attributes and files readable by world.
253 mount option nosymlinks
255 Do not allow special meaning of 'shareable' attribute. This is a
256 default.
257 mount option ipx
259 Use IPX for connection to server. Default if no ipserver option
260 specified on cmdline.
261 mount option udp
263 Use UDP for connection to server. Not available in 2.0.x kernels.
264 Default if ipserver is used.
265 mount option tcp
267 Use TCP for connection to server. Available only with 2.4.0 and
268 later kernels.
269 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 mount option nonfsextras
276 Do not make use of meta-data provided by the NFS namespace. This is
277 the default.
278
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
288 Most diagnostics issued by ncpfs are logged by syslogd. Normally noth‐
289 ing is printed, only error situations are logged there.
290
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 MIRROR/DOWNLOAD /home/pub/mirror ncp defaults,mode=644,uid=mir‐
298 ror,gid=mirror,owner=root,volume=SYS,nopasswd,multiple
299 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
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 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
318 syslogd(8), ncpumount(8), nfsd(8), mountd(8), mount(8)
319
322 ncpfs would not have been possible without lwared, written by Ales
323 Dryak (A.Dryak@sh.cvut.cz).
324 The encryption code was taken from Dr. Dobbs's Journal 11/93. There
326 Pawel Szczerbina described it in an article on NCP.
327 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 Code is currently maintained by Petr Vandrovec (vandrove@vc.cvut.cz).
333ncpmount 12/04/1998 NCPMOUNT(8)