annotate Documentation/filesystems/cifs.txt @ 524:7f8b544237bf

netfront: Allow netfront in domain 0.

This is useful if your physical network device is in a utility domain.

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