From patchwork Fri Jan 19 03:03:58 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Steve French X-Patchwork-Id: 13523284 Received: from mail-lf1-f48.google.com (mail-lf1-f48.google.com [209.85.167.48]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id A0E9F184E for ; Fri, 19 Jan 2024 03:04:12 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.167.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705633454; cv=none; b=cw2El0iVPzXylf7T1gLTM3R+T5RDYYhk4mSeqX0i1ssouxUvEMvWFYnOt3H7hm4X7vEHqFFCun5x8J/IrEgKhE3Wm3Da9viS9FoVgizzMa5Re1ks3gsIu382X0YeXg+nlVZXmaeFhC0hS1KampKhw73QvHnBz/mE7e6Apc0LKuA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705633454; c=relaxed/simple; bh=bu7Sc0ItTPdofCiFK1zcdmcumCxh81q369SQHXfILhk=; h=MIME-Version:References:In-Reply-To:From:Date:Message-ID:Subject: To:Content-Type; b=ubjhLu5zLE+rObgFjORIv5WVPLfOwf92a2Prd+n40DApSMBw0mRrWQpJspSU3q0ywYC4nsNddgsJrEH7+Vo9H3GITX6CPRpgNlXafhIiVo542Tb1AZmUCb3xIgdw5V3AyZHXSySkXwFzIXRCby4OBjw2e1mesrSGOZg5GGgYZk0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=e4OoxOC4; arc=none smtp.client-ip=209.85.167.48 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="e4OoxOC4" Received: by mail-lf1-f48.google.com with SMTP id 2adb3069b0e04-50e7c6f0487so297439e87.3 for ; Thu, 18 Jan 2024 19:04:12 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1705633450; x=1706238250; darn=vger.kernel.org; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :from:to:cc:subject:date:message-id:reply-to; bh=aUCXTG9uWSQReWhL7/oWYGouMSURFDuOiKy+eREFTfs=; b=e4OoxOC405Qc2I8pqsFl15KzAmzo6oMSkV2UG5IyquKGUO1fRH0bQx0JeMhy0hLDie x712pc5CXQk8yTu0HpdwEbGs1SHkDFTIsBK421NVxKAF2QmgmNEUXl/LuFIeVGnmE3IU Ngpap6CISRfdie7eGlCv91Coqd4RuZXxZWFsKzk5HCrhWrEYSwAoLFWyMTKSM7t5lHtj NJBmLSsZyYEFQSCDUUDtkEU2yxT+0Dsa0Es1jYAkt5xUHbE4t3r00VvuvdyFJtCaQCze 01/aJPSc2KUXvuAq0u+3lwc4tLeeqzJosTszNOnGHgiTYxb/iwjmC3swQX/my3efSgG5 SG8A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1705633450; x=1706238250; h=to:subject:message-id:date:from:in-reply-to:references:mime-version :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=aUCXTG9uWSQReWhL7/oWYGouMSURFDuOiKy+eREFTfs=; b=tplX2gtb75lY31Zgt7QOpE8nPkxzyDRoMS3wOnAEvtzm2muU2/uSeZDOkNSQ5R2KfM vgWauUrfxdql89OFIQ+PaY2LSFUCioq7ox+sfyRpRpYGAzEPaSk4MBqSFKB9OweauYTG gJRR15Mt9urqvcSvMYdDlN/nndfCrF4fZkAANP5S5QrP+yDvReX8AKyiinAWD2Viw6dR h6EhjIGSn+HC9gweDRZqADhafRgz/Z3jg6RNa+c/MoQQfOCLkfuss4EtnVJu+QsrHitp Z9GVKvd/w7xFRUMnVwcw8y5E4s6W+cpv9grqnfpo//9+FJi9arz5uRlGW/1ieVrE5BX8 OEag== X-Gm-Message-State: AOJu0YxjhCNoKSCBmDb52SF0SC7eBKVghHgQvvet8BUbUARdWmEpCGvI jFAHyrN317qwZbZkNB1u3esKkSWZJEAF89ChRl+spmZIasthaLzGWTYVHeiYMb7tZorBESP/ZPU Qg6sxyCe9x9RkNbrGJR3iu7dtlpkkv5a5KNk= X-Google-Smtp-Source: AGHT+IE5jt59ZnD1Sq1kgpsCp57PGnvmV03z3iCKhip3hYqUQnYMJgC8uAdefUsW+Ix+u/z4IwdL1nlu6wjCuzKwYI4= X-Received: by 2002:a19:6447:0:b0:50e:532a:2c0d with SMTP id b7-20020a196447000000b0050e532a2c0dmr187818lfj.177.1705633450007; Thu, 18 Jan 2024 19:04:10 -0800 (PST) Precedence: bulk X-Mailing-List: linux-cifs@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 References: <20240119124715.7be9a3d7@canb.auug.org.au> In-Reply-To: <20240119124715.7be9a3d7@canb.auug.org.au> From: Steve French Date: Thu, 18 Jan 2024 21:03:58 -0600 Message-ID: Subject: Fwd: linux-next: build warning after merge of the cifs tree To: CIFS updated patch attached (corrected a few other minor things in the cifs documentation) ---------- Forwarded message --------- From: Stephen Rothwell Date: Thu, Jan 18, 2024 at 7:47 PM Subject: linux-next: build warning after merge of the cifs tree To: Steve French Cc: CIFS , Steve French , Linux Kernel Mailing List , Linux Next Mailing List Hi all, After merging the cifs tree, today's linux-next build (htmldocs) produced this warning: Documentation/admin-guide/cifs/todo.rst:7: WARNING: Definition list ends without a blank line; unexpected unindent. Documentation/admin-guide/cifs/todo.rst:20: ERROR: Unexpected indentation. Documentation/admin-guide/cifs/todo.rst:21: WARNING: Block quote ends without a blank line; unexpected unindent. Introduced by commit e7dccb219fde ("smb3: minor documentation updates") --- Cheers, Stephen Rothwell From 9fa08af7c92719d1f5ef07abfdc6b1d99159fde0 Mon Sep 17 00:00:00 2001 From: Steve French Date: Wed, 17 Jan 2024 17:59:59 -0600 Subject: [PATCH] smb3: minor documentation updates Update the usage documentation to include some missing configuration options. Update the todo list documentation for cifs.ko Reviewed-by: Bharath SM Signed-off-by: Steve French --- Documentation/admin-guide/cifs/todo.rst | 36 +++++++++++++----------- Documentation/admin-guide/cifs/usage.rst | 8 +++++- 2 files changed, 27 insertions(+), 17 deletions(-) diff --git a/Documentation/admin-guide/cifs/todo.rst b/Documentation/admin-guide/cifs/todo.rst index 2646ed2e2d3e..e46c36001394 100644 --- a/Documentation/admin-guide/cifs/todo.rst +++ b/Documentation/admin-guide/cifs/todo.rst @@ -2,7 +2,8 @@ TODO ==== -Version 2.14 December 21, 2018 +As of 6.7 kernel. See https://wiki.samba.org/index.php/LinuxCIFSKernel +for list of features added by release A Partial List of Missing Features ================================== @@ -12,22 +13,22 @@ for visible, important contributions to this module. Here is a partial list of the known problems and missing features: a) SMB3 (and SMB3.1.1) missing optional features: + multichannel performance optimizations, algorithmic channel selection, + directory leases optimizations, + support for faster packet signing (GMAC), + support for compression over the network, + T10 copy offload ie "ODX" (copy chunk, and "Duplicate Extents" ioctl + are currently the only two server side copy mechanisms supported) - - multichannel (partially integrated), integration of multichannel with RDMA - - directory leases (improved metadata caching). Currently only implemented for root dir - - T10 copy offload ie "ODX" (copy chunk, and "Duplicate Extents" ioctl - currently the only two server side copy mechanisms supported) +b) Better optimized compounding and error handling for sparse file support, + perhaps addition of new optional SMB3.1.1 fsctls to make collapse range + and insert range more atomic -b) improved sparse file support (fiemap and SEEK_HOLE are implemented - but additional features would be supportable by the protocol such - as FALLOC_FL_COLLAPSE_RANGE and FALLOC_FL_INSERT_RANGE) - -c) Directory entry caching relies on a 1 second timer, rather than - using Directory Leases, currently only the root file handle is cached longer - by leveraging Directory Leases +c) Support for SMB3.1.1 over QUIC (and perhaps other socket based protocols + like SCTP) d) quota support (needs minor kernel change since quota calls otherwise - won't make it to network filesystems or deviceless filesystems). + won't make it to network filesystems or deviceless filesystems). e) Additional use cases can be optimized to use "compounding" (e.g. open/query/close and open/setinfo/close) to reduce the number of @@ -92,10 +93,13 @@ t) split cifs and smb3 support into separate modules so legacy (and less v) Additional testing of POSIX Extensions for SMB3.1.1 -w) Add support for additional strong encryption types, and additional spnego - authentication mechanisms (see MS-SMB2). GCM-256 is now partially implemented. +w) Support for the Mac SMB3.1.1 extensions to improve interop with Apple servers + +x) Support for additional authentication options (e.g. IAKERB, peer-to-peer + Kerberos, SCRAM and others supported by existing servers) -x) Finish support for SMB3.1.1 compression +y) Improved tracing, more eBPF trace points, better scripts for performance + analysis Known Bugs ========== diff --git a/Documentation/admin-guide/cifs/usage.rst b/Documentation/admin-guide/cifs/usage.rst index 5f936b4b6018..aa8290a29dc8 100644 --- a/Documentation/admin-guide/cifs/usage.rst +++ b/Documentation/admin-guide/cifs/usage.rst @@ -81,7 +81,7 @@ much older and less secure than the default dialect SMB3 which includes many advanced security features such as downgrade attack detection and encrypted shares and stronger signing and authentication algorithms. There are additional mount options that may be helpful for SMB3 to get -improved POSIX behavior (NB: can use vers=3.0 to force only SMB3, never 2.1): +improved POSIX behavior (NB: can use vers=3 to force SMB3 or later, never 2.1): ``mfsymlinks`` and either ``cifsacl`` or ``modefromsid`` (usually with ``idsfromsid``) @@ -715,6 +715,7 @@ DebugData Displays information about active CIFS sessions and Stats Lists summary resource usage information as well as per share statistics. open_files List all the open file handles on all active SMB sessions. +mount_params List of all mount parameters available for the module ======================= ======================================================= Configuration pseudo-files: @@ -864,6 +865,11 @@ i.e.:: echo "value" > /sys/module/cifs/parameters/ +More detailed descriptions of the available module parameters and their values +can be seen by doing: + + modinfo cifs (or modinfo smb3) + ================= ========================================================== 1. enable_oplocks Enable or disable oplocks. Oplocks are enabled by default. [Y/y/1]. To disable use any of [N/n/0]. -- 2.40.1