From patchwork Wed Mar 13 23:23:12 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Steve French X-Patchwork-Id: 10851915 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 286F117DF for ; Wed, 13 Mar 2019 23:23:27 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 0FE1229FAE for ; Wed, 13 Mar 2019 23:23:27 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 040352A003; Wed, 13 Mar 2019 23:23:27 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.0 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 48E1629FAE for ; Wed, 13 Mar 2019 23:23:26 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726328AbfCMXXZ (ORCPT ); Wed, 13 Mar 2019 19:23:25 -0400 Received: from mail-pg1-f181.google.com ([209.85.215.181]:44230 "EHLO mail-pg1-f181.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726264AbfCMXXZ (ORCPT ); Wed, 13 Mar 2019 19:23:25 -0400 Received: by mail-pg1-f181.google.com with SMTP id h34so2586424pgh.11 for ; Wed, 13 Mar 2019 16:23:24 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=YgHbngrAz7dR4Ch3N10t4rW12VI1CbXxsv40xovnrZk=; b=JkcVaKxTQgdN9MxRZsWbxIlXsdtRaIbe7JvCVWo2rlgL7bW9FA8SfNVaacOR6Hz4Ni SnyE8sVoZ8hkPJR6Jczmz+kYIElzaiowryVyjhjm2cgsXri4gf9l1qHcNZ/BIF2Vl4vJ 2t/umVblqXGUmFH8ygEGb9qv6DjccYGsWOq8RNSOErJ4Lc7gk4Qx3YsJXRzDR5CKJrT1 1aUaGS7gz/rgpRU1XSFWqrPOq+xzdrDyg6eJBVdws+AffYkDJ1PtiXTGsN1WA+FOmQPc dJfg2Agf/LaCY1BHJ1MFnEzHtnkyuKyQ8pFeG7PB7INLxY8k4KR0uBoJU6A+GfndtF5K qvZA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=YgHbngrAz7dR4Ch3N10t4rW12VI1CbXxsv40xovnrZk=; b=DXfMbR5A99HVVxRSFNI6RGv1le0TT4FSZZ5XT2yL+u/PH+HRQlPy6vekbbuL4tBPsx esu4OixzZptHE+XqQEs3GVYg+IcXiditvw3DpsPiwhTLFhiPVxunrKwM4rYjE46e1fU3 z5wKKAEfOzHV0+esxRa/shEDZdlDFck8ziqP1BOZjjmv2WXLCPcnn3x9rmcqDWp4rpOd AdfFPsM1iG0HNly1TFGCeiapMa1ktfPzod2NsjGlZh6R7h2Eb0+iu7DeZOoYtIk1GrCP M0/IM057cp46tBSUCsvFpEm6JeDk08LPPly65ZN4uviFy+rrAGZ2jyjfsHVz0NDzTD0y pIZQ== X-Gm-Message-State: APjAAAUTii9yWgpEZYCI6pq3CYICyMNGOkh5SIGXkYhj/I/V9PZueyc2 XHt6S0mn13vHYyLUYbcqHsBYY1B0a2rVAfCTJX5FCQ== X-Google-Smtp-Source: APXvYqw84Rwzmn43ZwnArXvc6DSUymcJvWfua59BIjCx4eZvxB1W15GFcLqHtHt24xefDabspD+ErLxdkWgXHptNn3U= X-Received: by 2002:a17:902:822:: with SMTP id 31mr48162288plk.290.1552519403879; Wed, 13 Mar 2019 16:23:23 -0700 (PDT) MIME-Version: 1.0 From: Steve French Date: Wed, 13 Mar 2019 18:23:12 -0500 Message-ID: Subject: [PATCH][CIFS] Trivial updates to various documentation files To: CIFS Sender: linux-cifs-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-cifs@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP From de260e4e28faa31da7222f2bb92adc2d4bdf499e Mon Sep 17 00:00:00 2001 From: Steve French Date: Wed, 13 Mar 2019 18:21:38 -0500 Subject: [PATCH] cifs: minor documentation updates Also updated a comment describing use of the GlobalMid_Lock Signed-off-by: Steve French --- Documentation/filesystems/cifs/TODO | 3 ++- Documentation/filesystems/cifs/cifs.txt | 34 ++++++++++++++++--------- fs/cifs/cifsglob.h | 1 + 3 files changed, 25 insertions(+), 13 deletions(-) diff --git a/Documentation/filesystems/cifs/TODO b/Documentation/filesystems/cifs/TODO index 66b3f54aa6dc..9267f3fb131f 100644 --- a/Documentation/filesystems/cifs/TODO +++ b/Documentation/filesystems/cifs/TODO @@ -111,7 +111,8 @@ negotiated size) and send larger write sizes to modern servers. 5) Continue to extend the smb3 "buildbot" which does automated xfstesting against Windows, Samba and Azure currently - to add additional tests and -to allow the buildbot to execute the tests faster. +to allow the buildbot to execute the tests faster. The URL for the +buildbot is: http://smb3-test-rhel-75.southcentralus.cloudapp.azure.com 6) Address various coverity warnings (most are not bugs per-se, but the more warnings are addressed, the easier it is to spot real diff --git a/Documentation/filesystems/cifs/cifs.txt b/Documentation/filesystems/cifs/cifs.txt index 67756607246e..1be3d21c286e 100644 --- a/Documentation/filesystems/cifs/cifs.txt +++ b/Documentation/filesystems/cifs/cifs.txt @@ -1,16 +1,21 @@ This is the client VFS module for the SMB3 NAS protocol as well - older dialects such as the Common Internet File System (CIFS) + as for older dialects such as the Common Internet File System (CIFS) protocol which was the successor to the Server Message Block (SMB) protocol, the native file sharing mechanism for most early PC operating systems. New and improved versions of CIFS are now - called SMB2 and SMB3. These dialects are also supported by the - CIFS VFS module. CIFS is fully supported by network - file servers such as Windows 2000, 2003, 2008, 2012 and 2016 - as well by Samba (which provides excellent CIFS - server support for Linux and many other operating systems), Apple - systems, as well as most Network Attached Storage vendors, so - this network filesystem client can mount to a wide variety of - servers. + called SMB2 and SMB3. Use of SMB3 (and later, including SMB3.1.1) + is strongly preferred over using older dialects like CIFS due to + security reaasons. All modern dialects, including the most recent, + SMB3.1.1 are supported by the CIFS VFS module. The SMB3 protocol + is implemented and supported by all major file servers + such as all modern versions of Windows (including Windows 2016 + Server), as well as by Samba (which provides excellent + CIFS/SMB2/SMB3 server support and tools for Linux and many other + operating systems). Apple systems also support SMB3 well, as + do most Network Attached Storage vendors, so this network + filesystem client can mount to a wide variety of systems. + It also supports mounting to the cloud (for example + Microsoft Azure), including the necessary security features. The intent of this module is to provide the most advanced network file system function for SMB3 compliant servers, including advanced @@ -24,12 +29,17 @@ cluster file systems for fileserving in some Linux to Linux environments, not just in Linux to Windows (or Linux to Mac) environments. - This filesystem has an mount utility (mount.cifs) that can be obtained from + This filesystem has a mount utility (mount.cifs) and various user space + tools (including smbinfo and setcifsacl) that can be obtained from - https://ftp.samba.org/pub/linux-cifs/cifs-utils/ + https://git.samba.org/?p=cifs-utils.git + or + git://git.samba.org/cifs-utils.git - It must be installed in the directory with the other mount helpers. + mount.cifs should be installed in the directory with the other mount helpers. For more information on the module see the project wiki page at + https://wiki.samba.org/index.php/LinuxCIFS + and https://wiki.samba.org/index.php/LinuxCIFS_utils diff --git a/fs/cifs/cifsglob.h b/fs/cifs/cifsglob.h index 8b9ecf8c2986..c4f0f4e4bc6d 100644 --- a/fs/cifs/cifsglob.h +++ b/fs/cifs/cifsglob.h @@ -1738,6 +1738,7 @@ require use of the stronger protocol */ * GlobalMid_Lock protects: * list operations on pending_mid_q and oplockQ * updates to XID counters, multiplex id and SMB sequence numbers + * list operations on global DnotifyReqList * tcp_ses_lock protects: * list operations on tcp and SMB session lists * tcon->open_file_lock protects the list of open files hanging off the tcon -- 2.17.1