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 Default is 4.
  77 .It Fl T Ar timeout
  78 Timeout in seconds for each request.
  79 Default is 15.
  80 .It Fl W Ar workgroup
  81 This option specifies the workgroup to be used in the authentication request.
  82 .It Fl c Ar case
  83 Set a
  84 .Ar case
  85 option which affects name representation.
  86 .Ar case
  87 can be one of the following:
  88 .Bl -tag -width ".Em Value"
  89 .It Em Value
  90 .Em Meaning
  91 .It Cm l
  92 All existing file names are converted to lower case.
  93 Newly created file gets a lower case.
  94 .It Cm u
  95 All existing file names are converted to upper case.
  96 Newly created file gets an upper case.
  97 .El
  98 .It Fl f Ar mode , Fl d Ar mode
  99 Specify permissions that should be assigned to files and directories.
 100 The values must be specified as octal numbers.
 101 Default value for the file mode
 102 is taken from mount point, default value for the directory mode adds execute
 103 permission where the file mode gives read permission.
 104 .Pp
 105 Note that these permissions can differ from the rights granted by SMB
 106 server.
 107 .It Fl u Ar uid , Fl g Ar gid
 108 User ID and group ID assigned to files.
 109 The default are owner and group IDs from
 110 the directory where the volume is mounted.
 111 .It No // Ns Ar user Ns @ Ns Ar server Ns Oo Ar :port1 Ns Oo Ar :port2 Oc Oc Ns No / Ns Ar share
 112 The
 113 .Nm
 114 command will use
 115 .Ar server
 116 as the NetBIOS name of remote computer,
 117 .Ar user
 118 as the remote user name and
 119 .Ar share
 120 as the resource name on a remote server.
 121 Optional
 122 .Ar port1
 123 and
 124 .Ar port2
 125 arguments can be used to override default values of port numbers used
 126 by communication protocols.
 127 For SMB over NetBIOS default value for
 128 .Ar port1
 129 are 139, and
 130 .Ar port2
 131 are 137.
 132 .It Ar node
 133 Path to mount point.
 134 .El
 135 .Sh FILES
 136 .Bl -tag -width ".Pa ~/.nsmbrc" -compact
 137 .It Pa ~/.nsmbrc
 138 Keeps static parameters for connections and other information.
 139 See
 140 .Pa /usr/share/examples/smbfs/dot.nsmbrc
 141 for details.
 142 .El
 143 .Sh EXAMPLES
 144 The following example illustrates how to connect to SMB server
 145 .Em SAMBA
 146 as user
 147 .Em GUEST ,
 148 and mount shares
 149 .Em PUBLIC
 150 and
 151 .Em TMP :
 152 .Bd -literal -offset indent
 153 mount_smbfs -I samba.mydomain.com //guest@samba/public /smb/public
 154 mount_smbfs -I 192.168.20.3 -E koi8-r:cp866 //guest@samba/tmp /smb/tmp
 155 .Ed
 156 .Pp
 157 It is possible to use
 158 .Xr fstab 5
 159 for smbfs mounts:
 160 .Pp
 161 .Dl "//guest@samba/public    /smb/public     smbfs  rw,noauto 0   0"
 162 .Sh AUTHORS
 163 .An Boris Popov Aq bp@butya.kz ,
 164 .Aq bp@FreeBSD.org
 165 .Sh BUGS
 166 Please report bugs to the author.