System Administration Commands                      mount_smbfs(1M)

NAME
     mount_smbfs - mount a shared resource from an SMB file server

SYNOPSIS
     mount [ -F  smbfs] [generic_options] [-o specific_options]  [-
     O] resource

     mount [ -F  smbfs] [generic_options] [-o specific_options]  [-
     O] mount_point

     mount [ -F  smbfs] [generic_options] [-o specific_options]  [-
     O] resource mount_point

DESCRIPTION
     The mount utility attaches a named resource to the file sys-
     tem  hierarchy  at  the pathname location mount_point, which
     must already exist. If mount_point has any contents prior to
     the  mount  operation,  the contents remain hidden until the
     resource is once again unmounted.  A mount may be done by any
     process with the SYS_MOUNT privilege.

     If the resource is listed in the /etc/vfstab file, the  com-
     mand  line  can  specify either resource or mount_point, and
     mount consults /etc/vfstab for more information. If  the  -F
     option  is  omitted,  mount  takes the file system type from
     /etc/vfstab.

     If the resource is not listed in the /etc/vfstab file,  then
     the  command  line  must  specify  both the resource and the
     mount_point.

     resource
         //[workgroup;][user[:password]@]server[/share]
         The mount_smbfs command will use server as the NetBIOS name of
         remote computer, user as the remote user name and share as the
         resource name on a remote server.  Workgroup and/or password may
         be specified here; if the password is not specified, the mount
	 will be done without a password, and 'smbutil login' may be
	 necessary to access the share.  If user is omitted the logged
	 in user id will be used.  Omitting share is an error when
	 mount_smbfs is run from the command line.

     mount_point

         The path to the location where the filesystem will be
         mounted.

     The mount command maintains a table of mounted file  systems
     in /etc/mnttab, described in mnttab(4).

OPTIONS
     See mount(1M) for the list of supported generic_options.

     -o specific_options

         Set file system specific options according to  a  comma-
         separated list with no intervening spaces.

     case=[upper,lower]
             Force mapping to lowercase or uppercase names

     fileperms=octaltriplet (eg: 477)
     dirperms=octaltriplet
             Specify permissions that should be assigned to files and directo-
             ries.  The values must be specified as octal numbers.  Default
             value for the file mode is taken from mount point, default value
             for the directory mode adds execute permission where the file
             mode gives read permission.

             Note that these permissions can differ from the rights granted by
             SMB server.

     lookup=opt
             Set opt option to affect file name lookups.  opt can be one of
             the following:

             Value    Meaning
             -----    -------

             nolong   No long names.  Server supports only "8.3" format.

	     The default will be to permit long names.

     uid=userid
     gid=groupid
             User ID and group ID assigned to files.  The defaults are the
             owner and group IDs from the directory where the volume is
             mounted.

     -O

         Overlay mount. Allow the file system to be mounted  over
         an existing mount point, making the underlying file sys-
         tem inaccessible. If a mount  is  attempted  on  a  pre-
         existing  mount  point  without  setting  this flag, the
         mount fails, producing the error "device busy."

EXAMPLES
     Example 1: Mounting an SMBFS File System


     example# mount -F smbfs //user@server/sharename /dir/mountdir

FILES
     /etc/mnttab             table of mounted file systems

     /etc/dfs/fstypes        default distributed file system type

     /etc/vfstab             table   of   automatically   mounted
                             resources

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWsmbfscu                 |
    |_____________________________|_____________________________|

SEE ALSO
     smbutil(1), mount(1M), mountall(1M), mount(2), umount(2),
     mnttab{4), vfstab(4), attributes(5)

NOTES
     If the directory on which a file system is to be mounted  is
     a symbolic link, the file system is mounted on the directory
     to which the symbolic link refers, rather than being mounted
     on top of the symbolic link itself.