CIFS(4) CIFS(4)
NAME
cifs - Microsoft™ Windows network filesystem client
SYNOPSIS
cifs [ -bdDiv ] [ -a auth-method ] [ -s srvname ] [ -n
called-name ] [ -k keyparam ] [ -m mntpnt ] host [ share ...
]
DESCRIPTION
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:
-a auth-method Cifs authenticates using `BNTLM' by default,
but alternative strategies may be selected
using this option. Cifs eschews cleartext
authentication, however it may be enabled
with the `plain' auth method. The list of
currently-supported methods is printed if no
method name is supplied.
Windows server 2003 requires the BNTLMv2
method by default, though it can be config-
ured to be more flexible.
-b Enable file ownership resolution in stat(2)
calls. This requires an open and close per
file and thus will slow cifs considerably;
its use is not recommended.
-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 assump-
tion that all servers in a Windows domain
share an authentication domain; thus cifs
expects keys in factotum of the form:
key proto=pass dom=THEIR-DOMAIN service=cifs
Page 1 Plan 9 (printed 12/21/24)
CIFS(4) CIFS(4)
user=MY-USERNAME !password=XYZZY
-m mntpnt set the mount point for the remote filesys-
tem; the default is /n/host.
-n called-name The 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.
Synthetic Files
Several synthetic files appear in the root of the mounted
filesystem:
Shares Contains a list of the currently attached
shares, with fields giving the share name,
disk free space / capacity, the share type,
and a descriptive comment from the server.
Connection Contains the username used for authentication,
server's called name, server's domain,
server's OS, the time slip between the local
host and the server, the Maximum Transfer Unit
(MTU) the server requested, and optionally a
flag indicating only guest access has been
granted. The second line contains a list of
capabilities offered by the server which is
mainly of use for debugging cifs.
Users Each line contains a user's name, the user's
full name, and a descriptive comment.
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
Page 2 Plan 9 (printed 12/21/24)
CIFS(4) CIFS(4)
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.
DNS paths are usually assigned dynamicially as
a form of load balancing.
SOURCE
/sys/src/cmd/cifs
SEE ALSO
factotum(4), aquarela(8)
BUGS
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 4.0.
Page 3 Plan 9 (printed 12/21/24)