term% ls -F
term% cat index.txt
CIFS(4)                    Kernel Interfaces Manual                    CIFS(4)

       cifs - Microsoft⢠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  ar‐
       guments are:

       -a auth-method
              Cifs  authenticates using by default, but alternative strategies
              may be selected using this option.  Cifs eschews  cleartext  au‐
              thentication,  however  it  may be enabled with the 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 configured to be more flexible.

       -b     Enable file ownership resolution in  stat(2)  calls.   This  re‐
              quires  an  open and close per file and thus will slow cifs con‐
              siderably; 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 assumption 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
                          user=MY-USERNAME !password=XYZZY

       -m mntpnt
              set the mount point for the remote filesystem;  the  default  is

       -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

       -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.

              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 ca‐
              pabilities offered by the server which is mainly of use for  de‐
              bugging 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.

              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.

              One  line  per  domain  giving the domain name and a descriptive

              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.

              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


       factotum(4), aquarela(8)

       NetApp  Filer  compatibility  has not yet been tested; there may not be

       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.