ncpmount (8)
NAME
ncpmount, mount.ncp - mount volume(s) from a specified NetWare file-
server.
SYNOPSIS
ncpmount [ -h ] [ -S server ] [ -U user name ] [ -P password | -n ] [
-C ] [ -c client name ] [ -u uid ] [ -g gid ] [ -f file mode ] [ -d dir
mode ] [ -V volume ] [ -t time_out ] [ -r retry_count ] [ -b ] [ -i
level ] [ -v ] [ -m ] [ -y iocharset ] [ -p codepage ] [ -N ignored
namespace ] [ -2 | -3 | -4 ] [ -s ] [ -A dns name ] mount-point
mount.ncp remote-server-and-user mount-point [ -n ] [ -v ] [ -o
mount_options ]
DESCRIPTION
This program is used to mount volumes of the specified NetWare File-
server under the specified mount point.
ncpfs is a linux filesystem which understands the NCP protocol. This is
the protocol Novell NetWare clients use to talk to NetWare servers.
ncpfs was inspired by lwared, a free NetWare emulator for Linux written
by Ales Dryak. See ftp://klokan.sh.cvut.cz/pub/linux for this very
interesting program.
ncpmount, when invoked with all appropriate arguments, attaches and
logs into specified server and mounts all volumes (or one volume or
subtree) from server under the specified mount point. ncpmount when
invoked without any arguments specifying the fileserver, user id and
password checks the file $HOME/.nwclient to find a file server, a user
name and possibly a password to use for the specified mount point. See
nwclient(5) for more information. Please note that the access permis-
sions of .nwclient MUST be 600, for security reasons.
OPTIONS
mount-point
mount-point is the directory you want to mount the filesystem over.
Its function is the the same as for a normal mount command.
If the real uid of the caller is not root, ncpmount checks whether
the user is allowed to mount a filesystem on the mount-point. So it
should be safe to make ncpmount setuid root. The filesystem stores
the uid of the user who called ncpmount. So ncpumount can check
whether the caller is allowed to unmount the filesystem.
-S server (mount option server= or part before / in remote-server-and-
user)
server is the name of the server you want to use.
-h
-h is used to print out a short help text.
-C (mount option noupcasepasswd)
passwdfile=file (only mount option)
If you want specify password and you do not want store it into world
readable /etc/fstab, you can use this option. file then contains
lines in form SERVER/USER:PASSWORD:other_data (other_data are cur-
rently unused)
pass-fd=fd (only mount option)
If you want to pass password in secure way to ncpmount, you can pass
it through specified fd.
-P password (mount option passwd=)
specifies the password to use for the Netware user id.
If neither -n nor the -P nor the passwdfile= nor the pass-fd= argu-
ments are specified ncpmount will prompt for a password. This makes
it difficult to use in scripts such as /etc/rc. If you want to have
ncpmount work automatically from a script you must include the
appropriate option and be very careful to ensure that appopriate
file permissions are set for the script that includes your password
to ensure that others can not read it.
-U user name (mount option user= or rest of remote-server-and-user
after /)
Specifies the Netware user id to use when logging in to the file-
server. If this option is not specified then ncpmount will attempt
to login to the fileserver using the Linux login id of the user
invoking ncpmount.
-m (mount option multiple)
Normally, ncpmount limits number of connections from client to
server to one per unique user name. If you want mount more than one
connection with same username and server, you must specify -m.
-u uid, -g gid (mount option uid= and gid=)
ncpmount does not yet implement a scheme for mapping NetWare
users/groups to Linux users/groups. Linux requires that each file
has an owner and group id. With -u and -g you can tell ncpmount
which id's it should assign to the files in the mounted directory.
The defaults for these values are the current uid and gid.
-c user name (mount option owner=)
-c names the user who is the owner of the connection, where owner
does not refer to file ownership (that "owner" is set by the -u
argument), but the owner of the mount, ie: who is allowed to call
ncpumount on this mount. The default owner of the connection and the
mount is the user who called ncpmount. This option allows you to
specify that some other user should be set as the owner.
In this this way it is possible to mount a public read-only direc-
tory, but to allow the lp daemon to print on NetWare queues. This is
possible because only users who have write permissions on a direc-
tory may issue ncp requests over a connection. The exception to this
rule is the 'mount owner', who is also granted 'request permission'.
-f file mode, -d dir mode (mount option mode= (or filemode=) and
gives to us. If you do not have write permissions on the server, you
can very well choose a file mode that tells that you have. This cer-
tainly cannot override the restrictions imposed by the server.
-V volume (mount option volume=)
There are 2 general ways you can mount a NetWare server's disk
space: Either you can mount all volumes under one directory, or you
can mount only a single volume.
When you choose to mount the complete disk space at once, you have
the advantage that only one Linux mount point and only one NetWare
connection is used for all the volumes of this server. Both of these
are limited resources. (Although raising the number of Linux mount
points is significantly cheaper than raising the number of available
NetWare connections ;-))
When you specify to mount a single volume by using the option -V
volume, you have the big advantage that nfsd is able to re-export
this mounted directory. You must invoke nfsd and mountd with the
option --re-export to make nfsd re-export ncpfs mounted directories.
This uses one Linux mount point and one NetWare connection per
mounted volume. Maybe sometime in the future I will make it possible
to mount all volumes on different mount points, using only one con-
nection.
-t time_out (mount option timeo= or timeout=)
With -t you can adjust the time ncpfs waits for the server to answer
a request it sent. Use the option to raise the timeout value when
your ncpfs connections seem to be unstable although your servers are
well up. This can happen when you have very busy servers, or servers
that are very far away.
time_out is specified in 1/100s, the current default value is 60.
-r retry_count (mount option retry=)
As -t, -r can be used to tune the ncpfs connection to the server.
With retry_count you can specify how many times ncpfs will attempt
to send a packet to the server before it decides the connection is
dead. The current default value is 5.
Currently ncpfs is not too clever when trying to find out that con-
nections are dead. If anybody knows how to do that correctly, as it
is done by commercial workstations, please tell me.
-y iocharset (mount option iocharset=)
You can specify character translation rules for converting names
from unicode to your desktop (it works together with -p). iocharset
is charset name, for example iso-8859-1.
-p codepage (mount option codepage=)
You can specify character translation rules for converting names
from Netware encoding to unicode (it works together with -y). code-
page is codepage name, for example cp437.
-b (mount option bindery)
If you are connecting to NetWare 4 or NetWare 5 through bindery emu-
lation instead of NDS, you must specify this option.
ncpmount -v without another options.
-A dns name (mount option ipserver=dns name)
When you are mounting volumes from NetWare 5 server over UDP, you
must specify dns name of server here and logical server name in -S
(or in server=). This name is used to switch ncpmount into UDP mode
and to specify server to connect. Currently, DNS is only supported
IP name resolution protocol. There is currently no support for SLP.
-N ignored namespace (mount option nonfs and nolong)
ncpfs supports NFS, LONG (OS/2) and DOS namespace on NetWare vol-
umes. If you do not want to use NFS or LONG namespace (because of
bugs in (server) code or for backward compatibility), you must spec-
ify these ignored namespaces in mount parameters.
-2
If you have unusual ncpfs code in kernel and ncpmount is not able to
autodetect it, use this option. It switches ncpmount to ncpfs inter-
face version 2. This interface was used in 2.0.x kernels, does not
support NCP/UDP, does not have NDS authentication info storage and
uses only 16bit uid/gid.
-3
If you have unusual ncpfs code in kernel and ncpmount is not able to
autodetect it, use this option. It switches ncpmount to ncpfs inter-
face version 3. This interface was used in kernels from 2.1.30 to
2.3.40 (laters 2.3.x and 2.4.x still supports this interface to make
transition easier). This interface supports NCP/UDP, does have NDS
authentication info storage (if you uncomment it in kernel sources)
and uses 16bit uid/gid.
-4
If you have unusual ncpfs code in kernel and ncpmount is not able to
autodetect it, use this option. It switches ncpmount to ncpfs inter-
face version 4. This interface is used in kernels after 2.3.40. This
interface supports NCP/UDP, does have NDS authentication info stor-
age and uses 32bit uid/gid.
-s (mount option strong)
Normally, files marked read-only cannot be removed from NetWare vol-
ume because of they are marked Delete Inhibit and Rename Inhibit. If
you want to remove these files by simple unlink, you should mount
volume with this option.
mount option nostrong
Refuse to remove read-only files. If you want remove such file, you
must first remove read-only attribute. It is standard behavior of
ncpfs.
mount option symlinks
Use special, normally unused, attributes combinations to express
symlinks, executable attributes and files readable by world.
mount option nosymlinks
Do not allow special meaning of 'shareable' attribute. This is a
default.
Use TCP for connection to server. Available only with 2.4.0 and
later kernels.
mount option nfsextras
Use the meta-data provided by the NFS namespace to allow files'
modes to be changed, and to allow the creation of symlinks and named
pipes. This adds significant overhead to fetching file information.
mount option nonfsextras
Do not make use of meta-data provided by the NFS namespace. This is
the default.
ENVIRONMENT VARIABLES
USER / LOGNAME
The variables USER or LOGNAME may contain the username of the person
using the client. USER is tried first. If it's empty, LOGNAME is
tried.
DIAGNOSTICS
Most diagnostics issued by ncpfs are logged by syslogd. Normally noth-
ing is printed, only error situations are logged there.
EXAMPLES
If you want to mount volume SYS as user DOWNLOAD from server MIRROR
into directory /home/pub/mirror, with files owner mirror.mirror and
file mode -rw-r--r--, you can add
MIRROR/DOWNLOAD /home/pub/mirror ncp defaults,mode=644,uid=mir-
ror,gid=mirror,owner=root,volume=SYS,nopasswd,multiple
into /etc/fstab. You should always specify multiple in mount options,
otherwise there can be only one connection to server with same name.
NOTES
IPX
You must configure the IPX subsystem before ncpmount will work. It
is especially important that there is a route to the internal net-
work of your server.
IP
You must specify both -S logical_name and -A dns_name. logical_name
is used for searching .nwclient, other configuration files and is
logged into /etc/mtab, dns_name is used for connecting to server. In
future, logical_name will be read from server.
/etc/fstab
You must specify filesystem type ncp and not ncpfs although it is
reported as ncpfs in /etc/mtab and /proc/mounts.
SEE ALSO
syslogd(8), ncpumount(8), nfsd(8), mountd(8), mount(8)
(lendecke@math.uni-goettingen.de). smbfs was put together by Paal-Kr.
Engstad (pke@engstad.ingok.hitos.no) and later polished by Volker.
Code is currently maintained by Petr Vandrovec (vandrove@vc.cvut.cz).
ncpmount 12/04/1998 ncpmount(8)