CIFS man page on Plan9

Man page or keyword search:  
man Server   549 pages
apropos Keyword Search (all sections)
Output format
Plan9 logo
[printable version]

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 by default, but alternative strategies
	      may be selected  using  this  option.   Cifs  eschews  cleartext
	      authentication,  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
	      requires 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/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

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

								       CIFS(4)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Plan9

List of man pages available for Plan9

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net