NAME    [Toc]    [Back]

     mount_nwfs -- mount NetWare volume from a NetWare file server

SYNOPSIS    [Toc]    [Back]

     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
     mount_nwfs [-options] /server:user/volume[/path] node

DESCRIPTION    [Toc]    [Back]

     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 aren't 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.

     node    Path to mount volume.

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

	     Value    Meaning

	     l	      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.

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

	     n	      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.

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

	     U	      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
	     Don't use namespace.  Currently only OS2 can be here.

     -v      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:

	     asis	Characters passed as is without any alteration.

	     koi2cp866	koi8-r <-> CP866

	     se 	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.

FILES    [Toc]    [Back]

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

NOTES    [Toc]    [Back]

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

EXAMPLES    [Toc]    [Back]

     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

HISTORY    [Toc]    [Back]

     The mount_nwfs utility first appeared in FreeBSD 4.0.

BUGS    [Toc]    [Back]

     to number a few

CREDITS    [Toc]    [Back]

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

     Documentation from NetWare NDK.

     Ncpfs for Linux - written by Volker Lendecke
     <[email protected]>.  He granted me permission to publish
     parts of his code under BSD-style license,

     "Interrupt List" from Ralf Brown,

     Many files from /sys directory.

AUTHORS    [Toc]    [Back]

     Boris Popov <[email protected]>, <[email protected]>


FreeBSD 5.2.1		       October 14, 1999 		 FreeBSD 5.2.1