| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 |   This is the client VFS module for the Common Internet File System | 
 | 2 |   (CIFS) protocol which is the successor to the Server Message Block  | 
 | 3 |   (SMB) protocol, the native file sharing mechanism for most early | 
 | 4 |   PC operating systems.  CIFS is fully supported by current network | 
 | 5 |   file servers such as Windows 2000, Windows 2003 (including   | 
 | 6 |   Windows XP) as well by Samba (which provides excellent CIFS | 
 | 7 |   server support for Linux and many other operating systems), so | 
 | 8 |   this network filesystem client can mount to a wide variety of | 
 | 9 |   servers.  The smbfs module should be used instead of this cifs module | 
 | 10 |   for mounting to older SMB servers such as OS/2.  The smbfs and cifs | 
 | 11 |   modules can coexist and do not conflict.  The CIFS VFS filesystem | 
 | 12 |   module is designed to work well with servers that implement the | 
 | 13 |   newer versions (dialects) of the SMB/CIFS protocol such as Samba,  | 
 | 14 |   the program written by Andrew Tridgell that turns any Unix host  | 
 | 15 |   into a SMB/CIFS file server. | 
 | 16 |  | 
 | 17 |   The intent of this module is to provide the most advanced network | 
 | 18 |   file system function for CIFS compliant servers, including better | 
 | 19 |   POSIX compliance, secure per-user session establishment, high | 
 | 20 |   performance safe distributed caching (oplock), optional packet | 
 | 21 |   signing, large files, Unicode support and other internationalization | 
 | 22 |   improvements. Since both Samba server and this filesystem client support | 
 | 23 |   the CIFS Unix extensions, the combination can provide a reasonable  | 
 | 24 |   alternative to NFSv4 for fileserving in some Linux to Linux environments, | 
 | 25 |   not just in Linux to Windows environments. | 
 | 26 |  | 
 | 27 |   This filesystem has an optional mount utility (mount.cifs) that can | 
 | 28 |   be obtained from the project page and installed in the path in the same | 
 | 29 |   directory with the other mount helpers (such as mount.smbfs).  | 
 | 30 |   Mounting using the cifs filesystem without installing the mount helper | 
 | 31 |   requires specifying the server's ip address. | 
 | 32 |  | 
 | 33 |   For Linux 2.4: | 
 | 34 |     mount //anything/here /mnt_target -o | 
 | 35 |             user=username,pass=password,unc=//ip_address_of_server/sharename | 
 | 36 |  | 
 | 37 |   For Linux 2.5:  | 
 | 38 |     mount //ip_address_of_server/sharename /mnt_target -o user=username, pass=password | 
 | 39 |  | 
 | 40 |  | 
 | 41 |   For more information on the module see the project page at | 
 | 42 |  | 
 | 43 |       http://us1.samba.org/samba/Linux_CIFS_client.html  | 
 | 44 |  | 
 | 45 |   For more information on CIFS see: | 
 | 46 |  | 
 | 47 |       http://www.snia.org/tech_activities/CIFS | 
 | 48 |  | 
 | 49 |   or the Samba site: | 
 | 50 |       | 
 | 51 |       http://www.samba.org |