freebsd-dev/sbin/mount_nwfs/mount_nwfs.8

193 lines
5.0 KiB
Groff

.\" $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 omitted, 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 static parameters for connections and other information. See
.Pa /usr/share/examples/nwclient/dot.nwfsrc
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, the following sources were used:
.Pp
Documentation from NetWare NDK.
.Pp
ncpfs for Linux - written by Volker Lendecke (lendecke@math.uni-goettingen.de).
He granted 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