File Systems                                           smbfs(7FS)



NAME
     smbfs - CIFS/SMB file system

DESCRIPTION
     The smbfs file system allows you to mount CIFS  shares  that
     are  exported from Windows or compatible systems. SMB is the
     historical name for the  CIFS  protocol,  which  stands  for
     Server  Message Block and is more commonly used in technical
     contexts.


     The smbfs file system permits ordinary UNIX applications  to
     change directory into an smbfs mount and perform simple file
     and directory operations. Supported operations include open,
     close, read, write, rename, delete, mkdir, rmdir and ls.

  Limitations
     Some local UNIX file systems (for example UFS) have features
     that are not supported by smbfs. These include:

         o    A server disconnect  is  not  automatically  recon-
              nected.

         o    No  mapped-file  access  because  mmap(2)   returns
              ENOSYS.

         o    Locking is local  only  and  is  not  sent  to  the
              server.


     The following are limitations in the CIFS protocol:

         o    unlink() or rename() of open files returns EBUSY.

         o    rename() of extended attribute files  returns  EIN-
              VAL.

         o    Creation of files with any of the following illegal
              characters  returns  EINVAL:  colon  (:), backslash
              (\), slash (/), asterisk (*),  question  mark  (?),
              double  quote ("), less than (<), greater than (>),
              and vertical bar ().

         o    chmod and chown settings are silently discarded.

         o    Links are not supported.

         o    Symbolic links are not supported.

         o    mknod is not supported. (Only  file  and  directory
              objects are supported.)




SunOS 5.11           Last change: 3 Feb 2009                    1






File Systems                                           smbfs(7FS)



     The current smbfs implementation does not support multi-user
     mounts.  Instead,  each  Unix  user  needs to make their own
     private mount points.


     Currently, all access through an smbfs mount point uses  the
     Windows  credentials  established  by  the user that ran the
     mount command. Normally, permissions on smbfs  mount  points
     should be 0700 to prevent Unix users from using each others'
     Windows   credentials.   See   the   diperms    option    to
     mountsmbfs(1M)  for  details regarding how to control smbfs
     mount point permissions.


     An important implication of this limitation is that  system-
     wide  mounts,  such as those made using /etc/vfstab or auto-
     mount maps are only useful in cases where access control  is
     not a concern, such as for public read-only resources.

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



     
          ATRIBUTE TYPE               ATRIBUTE VALUE        
    
     Availability              SUNWsmbfsu                     
    
     Interface Stability       Uncommitted                    
    


SEE ALSO
     smbutil(1), mountsmbfs(1M), nsmbrc(4), attributes(5)



















SunOS 5.11           Last change: 3 Feb 2009                    2