sbin/mount_nwfs/mount_nwfs.8

   1 .\" $FreeBSD: src/sbin/mount_nwfs/mount_nwfs.8,v 1.7.2.8 2003/02/23 21:17:43 trhodes Exp $
   2 .Dd October 14, 1999
   3 .Dt MOUNT_NWFS 8
   4 .Os
   5 .Sh NAME
   6 .Nm mount_nwfs
   7 .Nd mount NetWare volume from a NetWare file server
   8 .Sh SYNOPSIS
   9 .Nm
  10 .Op Fl Chv
  11 .Fl S Ar server
  12 .Fl U Ar user
  13 .Op Fl connection\ options
  14 .Fl V Ar volume
  15 .Op Fl M Ar mode
  16 .Op Fl c Ar case
  17 .Op Fl d Ar mode
  18 .Op Fl f Ar mode
  19 .Op Fl g Ar gid
  20 .Op Fl l Ar locale
  21 .Op Fl n Ar os2
  22 .Op Fl u Ar uid
  23 .Op Fl w Ar scheme
  24 .Ar node
  25 .Nm
  26 .Op Fl options
  27 .Ar /server:user/volume[/path]
  28 .Ar node
  29 .Sh DESCRIPTION
  30 The
  31 .Nm
  32 utility allows to mount volume from a NetWare server.
  33 It may use either
  34 existing connection or create new: if no usable connection was found
  35 it will try to establish a new one.
  36 Connection has count of references to it,
  37 so when last mount will be dismounted connection will be closed.
  38 It is
  39 possible to create connection without any mounts (but use it for them) with
  40 .Xr ncplogin 1 .
  41 .Pp
  42 Note two forms of command line.
  43 In the first form, server and user specified
  44 via
  45 .Fl S
  46 and
  47 .Fl U
  48 options respectively.
  49 In the second form server and user specified in
  50 .Ar special
  51 part of
  52 .Xr mount 8
  53 command line arguments (the
  54 .Fl S ,
  55 .Fl U
  56 and
  57 .Fl V
  58 options aren't used in this case).
  59 This allows use of
  60 .Xr fstab 5
  61 file (see
  62 .Sx EXAMPLES
  63 below).
  64 .Pp
  65 The options are:
  66 .Bl -tag -width indent
  67 .It Fl S Ar server
  68 Name of NetWare server to connect.
  69 For native IP you will need also
  70 .Fl A
  71 option.
  72 .It Fl U Ar user
  73 Name of user used in login sequence.
  74 .It Fl connection\ options
  75 See
  76 .Xr ncplogin 1
  77 for details.
  78 .It Fl V Ar volume
  79 Volume name to mount.
  80 Volume name can also be specified after all options and
  81 before
  82 .Ar mount-point .
  83 .It Ar node
  84 Path to mount volume.
  85 .It Fl c Ar case
  86 Select a
  87 .Ar case
  88 option which affects on name representation.
  89 .Ar Case
  90 can be one of the following:
  91 .Bl -tag -width "ValueXX"
  92 .It Em Value
  93 .Em Meaning
  94 .It l
  95 All existing file names converted to lower case.
  96 Newly created file gets a lower case under OS2 name space.
  97 This is the default when mounting volumes with DOS name space.
  98 .It L
  99 Same as 'l' but file system tries to be case insensitive.
 100 May not work well.
 101 .It n
 102 No case conversion is performed.
 103 .Em Warning !
 104 Use this option with DOS name space only as a last resort,
 105 because creating a lower case name in the DOS name space
 106 can lead to unpredictable results.
 107 This is the default when mounting volumes with OS2 name space.
 108 .It u
 109 All existing file names converted to upper case.
 110 Newly created file gets an upper case under OS2 name space.
 111 .It U
 112 Same as 'u' but file system tries to be case insensitive.
 113 May not work well.
 114 .El
 115 .It Fl f Ar mode , Fl d Ar mode
 116 Specify permissions that should be assigned to files and directories.
 117 The values must be specified as octal numbers.
 118 Default value for the file mode
 119 is taken from mount point, default value for the dir mode adds execute
 120 permission where the file mode gives read permission.
 121 .Pp
 122 Note that these permissions can differ from the rights granted by NetWare
 123 server.
 124 .It Fl n Ar namespace
 125 Don't use
 126 .Ar namespace .
 127 Currently only
 128 .Ar OS2
 129 can be here.
 130 .It Fl v
 131 Print version number.
 132 .It Fl u Ar uid , Fl g Ar gid
 133 User id and group id assigned to files.
 134 The default is owner and group id from
 135 directory where volume is mounted.
 136 .It Fl l Ar locale
 137 Set the locale for case conversion.
 138 By default
 139 .Nm
 140 tries to use an environment variable
 141 .Ev LC_* .
 142 .It Fl w Ar scheme
 143 Select a
 144 .Ar scheme
 145 used to convert file names between NetWare and
 146 .Dx .
 147 Supported conversion schemes are:
 148 .Bl -tag -width ".Cm koi2cp866"
 149 .It Cm asis
 150 Characters passed as is without any alteration.
 151 .It Cm koi2cp866
 152 koi8-r <-> CP866
 153 .It Cm se
 154 Suits for setups used in Sweden.
 155 .El
 156 .It Fl M Ar mode
 157 See
 158 .Xr ncplogin 1
 159 for details.
 160 If this option is omitted, connection permissions
 161 assumed the same as directory mode
 162 .Pq Fl d
 163 option.
 164 .El
 165 .Sh FILES
 166 .Bl -tag -width /var/log/wtmp -compact
 167 .It Pa ~/.nwfsrc
 168 keeps static parameters for connections and other information.
 169 See
 170 .Pa /usr/share/examples/nwclient/dot.nwfsrc
 171 for details.
 172 .El
 173 .Sh NOTES
 174 Before any NCP connection can be established kernel must be configured
 175 for IPX support, IPXrouted and KLD nwfs.ko should be loaded.
 176 .Sh EXAMPLES
 177 Next examples illustrates how to connect to NetWare server
 178 .Em nwserv
 179 as user
 180 .Em GUEST
 181 and mount volumes
 182 .Em SYS
 183 and
 184 .Em VOL1 :
 185 .Bd -literal -offset indent
 186 mount_nwfs -S nwserv -U guest -V sys /nw/s1/sys
 187 mount_nwfs /nwserv:guest/sys /nw/s1/sys
 188 mount -t nwfs /nwserv:guest/vol1 /nw/s1/vol1
 189 mount -t nwfs /nwserv:boris/sys/home/boris /home/boris/nw/home
 190 .Ed
 191 .Pp
 192 The last example mounts only subdirectory on a volume and equivalent
 193 to NetWare 'map root' command.
 194 .Pp
 195 It is possible to use
 196 .Xr fstab 5
 197 for nwfs mounts:
 198 .Bd -literal -offset indent
 199 /nwserv:guest/sys       /nw/s1/sys     nwfs  rw,noauto 0   0
 200 /nwserv:guest/vol1      /nw/s1/vol2    nwfs  rw,noauto 0   0
 201 .Ed
 202 .Sh HISTORY
 203 The
 204 .Nm
 205 utility first appeared in
 206 .Fx 4.0 .
 207 .Sh CREDITS
 208 In development of NetWare client for
 209 .Fx ,
 210 the following sources were used:
 211 .Pp
 212 Documentation from NetWare NDK.
 213 .Pp
 214 Ncpfs for Linux - written by
 215 .An Volker Lendecke Aq Mt lendecke@math.uni-goettingen.de .
 216 He granted me permission to publish parts of his code under
 217 .Bx Ns -style
 218 license,
 219 .Pp
 220 "Interrupt List" from
 221 .An Ralf Brown ,
 222 .Pp
 223 Many files from
 224 .Pa /sys
 225 directory.
 226 .Sh AUTHORS
 227 .An -nosplit
 228 .An Boris Popov Aq Mt bp@butya.kz ,
 229 .Aq Mt rbp@chat.ru
 230 .Sh BUGS
 231 to number a few