NAME

	cifs – Microsoft Windows filesystem client

SYNOPSIS

	cifs [ –dDiv ] [ –s srvname ] [ –n called–name ] [ –k keyparam ] [ –m mntpnt ] host [ share... ]

This is beta software and still

DESCRIPTION

Cifs translates between the Microsoft's file sharing protocol, (known by the acronyms 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 aditional server, session, share, and user information. The options are: –D    9P request debug. –d    CIFS packet debug. –i    Cifs enshews cleartext authentication, however may be enabled with the –i (insecure) option. –s srvname post the service as /srv/srvname; the default is /srv/host. – n called–name The CIFS protocol requires clients to know the NetBios name of the server they are attaching to, the called–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 as the called–name, finally it will try the name *SMBSERVER. – k    keyparam lists extra parameters to be given to factotum to remove key ambiguity; by the remote servers's domain is always included in the keyspec. This assumes that all servers in a Windows domain share a Windows authentication domain. – m mntpnt set the mntpnt for the remote filesystem; the default is /n/host. host   The address of the remote server to connect to. shareA list of share names to attach to on the remote server, if none are given cifs will attempt to attach all shares published by the remote host.

VIRTUAL FILES

Several virtual files appear in the root of the mounted filesystem: Shares Contains a list of the cunnectly attached shares, one line per share, with fields giving the share name, share type, disk label, disk serial number, disk free space / disk disk capacity, disk creation datestamp. Session Consists of the username, 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) negioated, and an optionally a flag indicating only guest access has been granted.

BUGS

Keepalives are not fully implemented (yet), so connections will time out. The NetApp Filer support has not been tested and is probably broken. No DFS support – though this is invisiged as a seperate 9p server which provides access to several envocations of cifs behind it. Cryptographic packet signatures are not yet supported, these are beleived to be nescessary to connect to Windows server 2003. Full NetBios name resolution is not supported though is is believed to depricated even by Microsoft. Cifs has only been tested to Windows 95, NT4.0 sp6, WinXP pro, Samba 3.0, and Samba 2.0 (Pluto VideoSpace). No support is attempted for servers predating NT4.0. Kerboros authentication is not supported Active directory is not supported.

HISTORY

	Cifs is based on an earlier implmentation by rsc and wkj.

Copyright © 2008 Lucent Technologies. All rights reserved.