cifs – Microsoft(tm) Windows network filesystem client
cifs [ –bdDiv ] [ –a auth–method ] [ –s srvname ] [ –n called–name ]
[ –k keyparam ] [ –m mntpnt ] host [ share ... ]
Cifs translates between Microsoft's file–sharing protocol (a.k.a.
CIFS or SMB) and 9P, allowing Plan9 clients to mount file systems
(shares or trees in MS terminology) published by such servers.
The root of the mounted directory contains one subdirectory per
share, always named in lower case, and a few virtual files of
mixed case which give additional server, session, share, and user
information. The arguments are:
–d CIFS packet debug.
–D 9P request debug.
–k keyparam lists extra parameters which will be passed to factotum(4) to select a specific key. The remote servers's domain is always included in the keyspec, under the assumption that all servers in a Windows domain share an authentication domain; thus cifs expects keys in factotum of the form:
–n called–nameThe CIFS protocol requires clients to know the NetBios name of the server they are attaching to, the Icalled–name. If this is not specified on the command line, cifs attempts to discover this name from the remote server. If this fails it will then try host, and finally it will try the name *SMBSERVER. –s srvname post the service as /srv/srvname.
host The address of the remote server to connect to.
share A list of share names to attach on the remote server; if none is given, cifs will attempt to attach all shares published by the remote host.
Groups Each line gives a group's name, and a list of the names of the users who are members of that group.
Sessions Lists the users authenticated, the client machine's NetBios name or IP address, the time since the connection was established, and the time for which the connection has been idle.
Domains One line per domain giving the domain name and a descriptive comment.
Workstations One line per domain giving the domain name and a descriptive comment, the version number of the OS it is running, and comma–separated list of flags giving the features of that OS.
Dfsroot Top level DFS routing giving the DFS link type, time to live of the data, proximity of the server, the Netbios or DNS name and a physical path or a machine that this maps to.
NetApp Filer compatibility has not yet been tested; there may
not be any.
DFS support is unfinished.
Kerberos authentication is unfinished.
NetBios name resolution is not supported, though it is now rarely used.
Cifs has only been tested against aquarela(8), Windows 95, NT4.0sp6,
Windows server 2003, WinXP pro, Samba 3.0, and Samba 2.0 (Pluto
VideoSpace). No support is attempted for servers predating NT