MOUNT_NWFS(8) MidnightBSD System Manager’s Manual MOUNT_NWFS(8)


mount_nwfs — mount NetWare volume from a NetWare file server


mount_nwfs [−Chv] −S server −U user [−connection options] −V volume [−M mode] [−c case] [−d mode] [−f mode] [−g gid] [−l locale] [−n os2] [−u uid] [−w scheme] node
[−options] /server:user/volume[/path] node


The mount_nwfs utility 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 ncplogin(1).

Note two forms of command line. In the first form, server and user specified via −S and −U options respectively. In the second form server and user specified in special part of mount(8) command line arguments (the −S, −U and −V options are not used in this case). This allows use of fstab(5) file (see EXAMPLES below).

The options are:

−S server

Name of NetWare server to connect. For native IP you will need also −A option.

−U user

Name of user used in login sequence.

−connection options

See ncplogin(1) for details.

−V volume

Volume name to mount. Volume name can also be specified after all options and before mount-point.


Path to mount volume.

−c case

Select a case option which affects on name representation. Case can be one of the following:




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.


Same as ’l’ but file system tries to be case insensitive. May not work well.


No case conversion is performed. 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.


All existing file names converted to upper case. Newly created file gets an upper case under OS2 name space.


Same as ’u’ but file system tries to be case insensitive. May not work well.

−f mode, −d 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.

Note that these permissions can differ from the rights granted by NetWare server.

−n namespace

Do not use namespace. Currently only OS2 can be here.


Print version number.

−u uid, −g gid

User id and group id assigned to files. The default is owner and group id from directory where volume is mounted.

−l locale

Set the locale for case conversion. By default mount_nwfs tries to use an environment variable LC_*.

−w scheme

Select a scheme used to convert file names between NetWare and FreeBSD. Supported conversion schemes are:


Characters passed as is without any alteration.


koi8-r <-> CP866


Suits for setups used in Sweden.

−M mode

See ncplogin(1) for details. If this option is omitted, connection permissions assumed the same as directory mode (−d) option.


keeps static parameters for connections and other information. See /usr/share/examples/nwclient/dot.nwfsrc for details.


Before any NCP connection can be established kernel must be configured for IPX support, IPXrouted and KLD nwfs.ko should be loaded.


Next examples illustrates how to connect to NetWare server nwserv as user GUEST and mount volumes SYS and VOL1:

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

The last example mounts only subdirectory on a volume and equivalent to NetWare ’map root’ command.

It is possible to use fstab(5) for nwfs mounts:

/nwserv:guest/sys /nw/s1/sys nwfs rw,noauto 0 0
/nwserv:guest/vol1 /nw/s1/vol2 nwfs rw,noauto 0 0


The mount_nwfs utility first appeared in FreeBSD 4.0.


In development of NetWare client for FreeBSD, the following sources were used:

Documentation from NetWare NDK.

Ncpfs for Linux - written by Volker Lendecke 〈lendecke@math.uni−〉. He granted me permission to publish parts of his code under BSD-style license,

"Interrupt List" from Ralf Brown,

Many files from /sys directory.


Boris Popov 〈〉, 〈〉


to number a few

MidnightBSD 0.3 October 14, 1999 MidnightBSD 0.3