diff options
author | bp <bp@FreeBSD.org> | 1999-10-15 09:59:48 +0000 |
---|---|---|
committer | bp <bp@FreeBSD.org> | 1999-10-15 09:59:48 +0000 |
commit | 8b5d9028e2ee6ecb6046a21b4f7411da3c0819a0 (patch) | |
tree | 7fb571fc68137608ef4ac454a4a466b5851e34bc /usr.sbin/mount_nwfs/mount_nwfs.8 | |
parent | 7b2a02340bd764d4cf4cbd6b4f4a5a7c6c579af7 (diff) | |
download | FreeBSD-src-8b5d9028e2ee6ecb6046a21b4f7411da3c0819a0.zip FreeBSD-src-8b5d9028e2ee6ecb6046a21b4f7411da3c0819a0.tar.gz |
Add mount_nwfs program. Now -current can mount NetWare volumes.
Diffstat (limited to 'usr.sbin/mount_nwfs/mount_nwfs.8')
-rw-r--r-- | usr.sbin/mount_nwfs/mount_nwfs.8 | 191 |
1 files changed, 191 insertions, 0 deletions
diff --git a/usr.sbin/mount_nwfs/mount_nwfs.8 b/usr.sbin/mount_nwfs/mount_nwfs.8 new file mode 100644 index 0000000..83a880f --- /dev/null +++ b/usr.sbin/mount_nwfs/mount_nwfs.8 @@ -0,0 +1,191 @@ +.\" $FreeBSD$ +.Dd Oct 14, 1999 +.Dt MOUNT_NWFS 8 +.Os FreeBSD 4.0 +.Sh NAME +.Nm mount_nwfs +.Nd mount NetWare volume from a NetWare file server +.Sh SYNOPSIS +.Nm mount_nwfs +.Op Fl Chv +.Ar -S Ar server +.Ar -U Ar user +.Ar "[connection options]" +.Ar -V Ar volume +.Op Fl M Ar mode +.Op Fl c Ar case +.Op Fl d Ar mode +.Op Fl f Ar mode +.Op Fl g Ar gid +.Op Fl l Ar locale +.Op Fl n Ar os2 +.Op Fl u Ar uid +.Op Fl w Ar scheme +.Ar node +.Nm mount_nwfs +.Op Fl options +.Ar /server:user/volume/path +.Ar node +.Sh DESCRIPTION +The +.Nm +command allow 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 +.Xr ncplogin 1 . +.Pp +Note two forms of command line. In the first form, server and user specified +via +.Fl S +and +.Fl U +options respectively. In the second form server and user specified in +.Ar special +part of +.Xr mount 8 +command line arguments (the +.Fl S , +.Fl U +and +.Fl V +options aren't used in this case). This allows use of fstab file (see EXAMPLES below). +.Pp +The options are: +.Bl -tag -width indent +.It Fl S Ar server +name of NetWare server to connect. For native IP you will need also +.Fl A +option. +.It Fl U Ar user +name of user used in login sequence. +.It Fl "[connection options]" +See +.Xr ncplogin 1 +for details. +.It Fl V Ar volume +Volume name to mount. Volume name can also be specified after all options and +before +.Ar mount-point . +.It Ar node +Path to mount volume. +.It Fl c Ar case +Selects a +.Ar case +option which affects on name representation. +.Ar Case +can be one of the following: +.Bd -literal -offset indent +Value Meaning +l All existing file names converted to lower case. + Newly created file gets a lower case under OS2 name + space. This is 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! 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 an + unpredictable results. This is default when mounting + volume 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. +.Ed +.It Fl f Ar mode, Fl d Ar mode +specifies permissions that should be assigned to files and directories. +The values must be specified as octal numbers. Default value for the file mode +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. +.It Fl n Ar namespace +don't use +.Ar namespace . +Currently only +.Ar OS2 +can be here. +.It Fl v +prints version number. +.It Fl u Ar uid, Fl g Ar gid +User id and group id assigned to files. The default is owner and group id from +directory where volume is mounted. +.It Fl l Ar locale +Sets the locale for case conversion. By default +.Nm +tries to use an environment variable +.Ar LC_* . +.It Fl w Ar scheme +Selects a +.Ar scheme +used to convert file names between NetWare and FreeBSD. Currently only +.Ar koi2cp866 +and +.Ar asis +can be here. Please note, that scheme should be enabled at compile +time in config.mk file. +.It Fl M Ar mode +See +.Xr ncplogin 1 +for details. If this option is ommited, connection permissions +assumed the same as directory mode ( +.Ar -d ) +option. +.El +.Sh FILES +.Bl -tag -width /var/log/wtmp -compact +.It Pa ~/.nwfsrc +keeps description for each connection. See +.Xr nwfsrc 8 +for details. + +.Sh NOTES +Before any NCP connection can be established kernel must be configured +for IPX support, IPXrouted and KLD nwfs.ko should be loaded. +.Sh EXAMPLES +Next examples illustrates how to connect to NetWare server +.Ar nwserv +as user +.Ar GUEST +and mount volumes +.Ar SYS +and +.Ar VOL1 : +.Bd -literal -offset indent +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 +.Ed +.Pp +The last example mounts only subdirectory on a volume and equivalent +to NetWare 'map root' command. +.Pp +It is possible to use fstab for nwfs mounts: +.Bd -literal -offset indent +/nwserv:guest/sys /nw/s1/sys nwfs rw,noauto 0 0 +/nwserv:guest/vol1 /nw/s1/vol2 nwfs rw,noauto 0 0 +.Ed + +.Sh BUGS +to number a few + +.Sh CREDITS +In development of NetWare client for FreeBSD next sources was used: +.Pp +Documentation from NetWare NDK. +.Pp +ncpfs for Linux - written by Volker Lendecke (lendecke@math.uni-goettingen.de). +He grants me permission to publish parts of his code under BSD-style license, +.Pp +"Interrupt List" from Ralf Brown, +.Pp +Many files from /sys directory. + +.Sh AUTHOR +.An Boris Popov Aq bp@butya.kz , +.Aq rbp@chat.ru |