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