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 3/28/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 3/28/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 3/28/24)