contrib/smbfs/mount_smbfs/mount_smbfs.8

   1 .\" $Id: mount_smbfs.8,v 1.10 2002/04/16 02:47:41 bp Exp $
   2 .\" $FreeBSD$
   3 .Dd March 10, 2000
   4 .Dt MOUNT_SMBFS 8
   5 .Os
   6 .Sh NAME
   7 .Nm mount_smbfs
   8 .Nd "mount a shared resource from an SMB file server"
   9 .Sh SYNOPSIS
  10 .Nm
  11 .Op Fl E Ar cs1 : Ns Ar cs2
  12 .Op Fl I Ar host
  13 .Op Fl L Ar locale
  14 .Op Fl M Ar crights : Ns Ar srights
  15 .Op Fl N
  16 .Op Fl O Ar cowner : Ns Ar cgroup Ns / Ns Ar sowner : Ns Ar sgroup
  17 .Op Fl R Ar retrycount
  18 .Op Fl T Ar timeout
  19 .Op Fl W Ar workgroup
  20 .Op Fl c Ar case
  21 .Op Fl d Ar mode
  22 .Op Fl f Ar mode
  23 .Op Fl g Ar gid
  24 .Op Fl n Ar opt
  25 .Op Fl u Ar uid
  26 .Sm off
  27 .No // Ar user No @ Ar server
  28 .Op Ar :port1 Op Ar :port2
  29 .No / Ar share
  30 .Sm on
  31 .Ar node
  32 .Sh DESCRIPTION
  33 The
  34 .Nm
  35 command mounts a share from a remote server using SMB/CIFS protocol.
  36 .Pp
  37 The options are as follows:
  38 .Bl -tag -width indent
  39 .It Fl E Ar cs1 : Ns Ar cs2
  40 Specifies local
  41 .Pq Ar cs1
  42 and server's
  43 .Pq Ar cs2
  44 character sets.
  45 .It Fl I Ar host
  46 Do not use NetBIOS name resolver and connect directly to
  47 .Ar host ,
  48 which can be either a valid DNS name or an IP address.
  49 .It Fl L Ar locale
  50 Use
  51 .Ar locale
  52 for lower/upper case conversion routines.
  53 Set the locale for case conversion.
  54 By default,
  55 .Nm
  56 tries to use an environment variable
  57 .Ev LC_*
  58 to determine it.
  59 .It Fl M Ar crights : Ns Ar srights
  60 Assign access rights to the newly created connection.
  61 .It Fl N
  62 Do not ask for a password.
  63 At run time,
  64 .Nm
  65 reads the
  66 .Pa ~/.nsmbrc
  67 file for additional configuration parameters and a password.
  68 If no password is found,
  69 .Nm
  70 prompts for it.
  71 .It Fl O Ar cowner : Ns Ar cgroup Ns / Ns Ar sowner : Ns Ar sgroup
  72 Assign owner/group attributes to the newly created connection.
  73 .It Fl R Ar retrycount
  74 How many retries should be done before the SMB requester decides to drop
  75 the connection.
  76 .It Fl T Ar timeout
  77 Timeout in seconds for each request.
  78 .It Fl W Ar workgroup
  79 This option specifies the workgroup to be used in the authentication request.
  80 .It Fl c Ar case
  81 Set a
  82 .Ar case
  83 option which affects name representation.
  84 .Ar case
  85 can be one of the following:
  86 .Bl -tag -width ".Em Value"
  87 .It Em Value
  88 .Em Meaning
  89 .It Cm l
  90 All existing file names are converted to lower case.
  91 Newly created file gets a lower case.
  92 .It Cm u
  93 All existing file names are converted to upper case.
  94 Newly created file gets an upper case.
  95 .El
  96 .It Fl f Ar mode , Fl d Ar mode
  97 Specify permissions that should be assigned to files and directories.
  98 The values must be specified as octal numbers.
  99 Default value for the file mode
 100 is taken from mount point, default value for the directory mode adds execute
 101 permission where the file mode gives read permission.
 102 .Pp
 103 Note that these permissions can differ from the rights granted by SMB
 104 server.
 105 .It Fl u Ar uid , Fl g Ar gid
 106 User ID and group ID assigned to files.
 107 The default are owner and group IDs from
 108 the directory where the volume is mounted.
 109 .It No // Ns Ar user Ns @ Ns Ar server Ns Oo Ar :port1 Ns Oo Ar :port2 Oc Oc Ns No / Ns Ar share
 110 The
 111 .Nm
 112 command will use
 113 .Ar server
 114 as the NetBIOS name of remote computer,
 115 .Ar user
 116 as the remote user name and
 117 .Ar share
 118 as the resource name on a remote server.
 119 Optional
 120 .Ar port1
 121 and
 122 .Ar port2
 123 arguments can be used to override default values of port numbers used
 124 by communication protocols.
 125 For SMB over NetBIOS default value for
 126 .Ar port1
 127 are 139, and
 128 .Ar port2
 129 are 137.
 130 .It Ar node
 131 Path to mount point.
 132 .El
 133 .Sh FILES
 134 .Bl -tag -width ".Pa ~/.nsmbrc" -compact
 135 .It Pa ~/.nsmbrc
 136 Keeps static parameters for connections and other information.
 137 See
 138 .Pa /usr/share/examples/smbfs/dot.nsmbrc
 139 for details.
 140 .El
 141 .Sh EXAMPLES
 142 The following example illustrates how to connect to SMB server
 143 .Em SAMBA
 144 as user
 145 .Em GUEST ,
 146 and mount shares
 147 .Em PUBLIC
 148 and
 149 .Em TMP :
 150 .Bd -literal -offset indent
 151 mount_smbfs -I samba.mydomain.com //guest@samba/public /smb/public
 152 mount_smbfs -I 192.168.20.3 -E koi8-r:cp866 //guest@samba/tmp /smb/tmp
 153 .Ed
 154 .Pp
 155 It is possible to use
 156 .Xr fstab 5
 157 for smbfs mounts:
 158 .Pp
 159 .Dl "//guest@samba/public    /smb/public     smbfs  rw,noauto 0   0"
 160 .Sh AUTHORS
 161 .An Boris Popov Aq bp@butya.kz ,
 162 .Aq bp@FreeBSD.org
 163 .Sh BUGS
 164 Please report bugs to the author.