smbfs(7fs) [opensolaris man page]
smbfs(7FS) 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 reconnected. 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 EINVAL. 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.) 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. Nor- mally, permissions on smbfs mount points should be 0700 to prevent Unix users from using each others' Windows credentials. See the diperms option to mount_smbfs(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 automount maps are only useful in cases where access control is not a concern, such as for public read-only resources. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-------------------------+---------------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-------------------------+---------------------------------+ |Availability | SUNWsmbfsu | +-------------------------+---------------------------------+ |Interface Stability | Uncommitted | +-------------------------+---------------------------------+ SEE ALSO
smbutil(1), mount_smbfs(1M), nsmbrc(4), attributes(5) SunOS 5.11 3 Feb 2009 smbfs(7FS)
Check Out this Related Man Page
MOUNT_SMBFS(8) BSD System Manager's Manual MOUNT_SMBFS(8) NAME
mount_smbfs -- mount a shared resource from an SMB file server SYNOPSIS
mount_smbfs [-E cs1:cs2] [-I host] [-L locale] [-M crights:srights] [-N] [-O cowner:cgroup/sowner:sgroup] [-R retrycount] [-T timeout] [-U username] [-W workgroup] [-c case] [-d mode] [-f mode] [-g gid] [-n opt] [-u uid] //user@server[:port1[:port2]]/share node DESCRIPTION
The mount_smbfs command mounts a share from a remote server using SMB/CIFS protocol. The options are as follows: -E cs1:cs2 Specifies local (cs1) and server's (cs2) character sets. -I host Do not use NetBIOS name resolver and connect directly to host, which can be either a valid DNS name or an IP address. -L locale Use locale for lower/upper case conversion routines. Set the locale for case conversion. By default, mount_smbfs tries to use an environment variable LC_* to determine it. -M crights:srights Assign access rights to the newly created connection. -N Do not ask for a password. At run time, mount_smbfs reads the ~/.nsmbrc file for additional configuration parameters and a password. If no password is found, mount_smbfs prompts for it. -O cowner:cgroup/sowner:sgroup Assign owner/group attributes to the newly created connection. -R retrycount How many retries should be done before the SMB requester decides to drop the connection. Default is 4. -T timeout Timeout in seconds for each request. Default is 15. -U username Username to authenticate with. -W workgroup This option specifies the workgroup to be used in the authentication request. -c case Set a case option which affects name representation. case can be one of the following: Value Meaning l All existing file names are converted to lower case. Newly created file gets a lower case. u All existing file names are converted to upper case. Newly created file gets an upper case. -f mode, -d mode Specify permissions that should be assigned to files and directories. 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. -u uid, -g gid User ID and group ID assigned to files. The default are owner and group IDs from the directory where the volume is mounted. //user@server[:port1[:port2]]/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. Optional port1 and port2 arguments can be used to override default values of port numbers used by communication protocols. For SMB over NetBIOS default value for port1 are 139, and port2 are 137. node Path to mount point. FILES
~/.nsmbrc Keeps static parameters for connections and other information. See /usr/share/examples/smbfs/dot.nsmbrc for details. EXAMPLES
The following example illustrates how to connect to SMB server SAMBA as user GUEST, and mount shares PUBLIC and TMP: mount_smbfs -I samba.mydomain.com //guest@samba/public /smb/public mount_smbfs -I 192.168.20.3 -E koi8-r:cp866 //guest@samba/tmp /smb/tmp It is also possible to use fstab(5) for smbfs mounts (the example below doesn't prompt for a password): //guest@samba/public /smb/public smbfs rw,noauto,-N 0 0 AUTHORS
Boris Popov <bp@butya.kz>, <bp@FreeBSD.org> BUGS
Please report bugs to the author. BSD
September 17, 2011 BSD