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