Mauro Carvalho Chehab | f139291 | 2019-07-31 17:08:51 -0300 | [diff] [blame] | 1 | ============ |
| 2 | Introduction |
| 3 | ============ |
| 4 | |
Steve French | ec11653b | 2017-09-14 14:51:20 -0500 | [diff] [blame] | 5 | This is the client VFS module for the SMB3 NAS protocol as well |
Steve French | 6552580 | 2019-03-13 18:21:38 -0500 | [diff] [blame] | 6 | as for older dialects such as the Common Internet File System (CIFS) |
Steve French | ec11653b | 2017-09-14 14:51:20 -0500 | [diff] [blame] | 7 | protocol which was the successor to the Server Message Block |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 8 | (SMB) protocol, the native file sharing mechanism for most early |
Björn Jacke | 81b6622 | 2013-09-10 10:28:38 +0200 | [diff] [blame] | 9 | PC operating systems. New and improved versions of CIFS are now |
Steve French | 731ddc0 | 2021-02-15 23:56:40 -0600 | [diff] [blame] | 10 | called SMB2 and SMB3. Use of SMB3 (and later, including SMB3.1.1 |
| 11 | the most current dialect) is strongly preferred over using older |
| 12 | dialects like CIFS due to security reasons. All modern dialects, |
| 13 | including the most recent, SMB3.1.1, are supported by the CIFS VFS |
| 14 | module. The SMB3 protocol is implemented and supported by all major |
| 15 | file servers such as Windows (including Windows 2019 Server), as |
| 16 | well as by Samba (which provides excellent CIFS/SMB2/SMB3 server |
| 17 | support and tools for Linux and many other operating systems). |
| 18 | Apple systems also support SMB3 well, as do most Network Attached |
| 19 | Storage vendors, so this network filesystem client can mount to a |
| 20 | wide variety of systems. It also supports mounting to the cloud |
| 21 | (for example Microsoft Azure), including the necessary security |
| 22 | features. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 23 | |
| 24 | The intent of this module is to provide the most advanced network |
Steve French | ec11653b | 2017-09-14 14:51:20 -0500 | [diff] [blame] | 25 | file system function for SMB3 compliant servers, including advanced |
| 26 | security features, excellent parallelized high performance i/o, better |
| 27 | POSIX compliance, secure per-user session establishment, encryption, |
| 28 | high performance safe distributed caching (leases/oplocks), optional packet |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 29 | signing, large files, Unicode support and other internationalization |
Steve French | 731ddc0 | 2021-02-15 23:56:40 -0600 | [diff] [blame] | 30 | improvements. Since both Samba server and this filesystem client support the |
| 31 | CIFS Unix extensions, and the Linux client also suppors SMB3 POSIX extensions, |
Steve French | ec11653b | 2017-09-14 14:51:20 -0500 | [diff] [blame] | 32 | the combination can provide a reasonable alternative to other network and |
| 33 | cluster file systems for fileserving in some Linux to Linux environments, |
| 34 | not just in Linux to Windows (or Linux to Mac) environments. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 35 | |
Steve French | 6552580 | 2019-03-13 18:21:38 -0500 | [diff] [blame] | 36 | This filesystem has a mount utility (mount.cifs) and various user space |
| 37 | tools (including smbinfo and setcifsacl) that can be obtained from |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 38 | |
Steve French | 6552580 | 2019-03-13 18:21:38 -0500 | [diff] [blame] | 39 | https://git.samba.org/?p=cifs-utils.git |
Mauro Carvalho Chehab | f139291 | 2019-07-31 17:08:51 -0300 | [diff] [blame] | 40 | |
Steve French | 6552580 | 2019-03-13 18:21:38 -0500 | [diff] [blame] | 41 | or |
Mauro Carvalho Chehab | f139291 | 2019-07-31 17:08:51 -0300 | [diff] [blame] | 42 | |
Steve French | 6552580 | 2019-03-13 18:21:38 -0500 | [diff] [blame] | 43 | git://git.samba.org/cifs-utils.git |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 44 | |
Steve French | 6552580 | 2019-03-13 18:21:38 -0500 | [diff] [blame] | 45 | mount.cifs should be installed in the directory with the other mount helpers. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 46 | |
Björn Jacke | 81b6622 | 2013-09-10 10:28:38 +0200 | [diff] [blame] | 47 | For more information on the module see the project wiki page at |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 48 | |
Steve French | 6552580 | 2019-03-13 18:21:38 -0500 | [diff] [blame] | 49 | https://wiki.samba.org/index.php/LinuxCIFS |
Mauro Carvalho Chehab | f139291 | 2019-07-31 17:08:51 -0300 | [diff] [blame] | 50 | |
Steve French | 6552580 | 2019-03-13 18:21:38 -0500 | [diff] [blame] | 51 | and |
Mauro Carvalho Chehab | f139291 | 2019-07-31 17:08:51 -0300 | [diff] [blame] | 52 | |
Björn Jacke | 81b6622 | 2013-09-10 10:28:38 +0200 | [diff] [blame] | 53 | https://wiki.samba.org/index.php/LinuxCIFS_utils |