Skip to contentSkip to conversation

mount.cifs: document 'fsc' mount option

PATCH In review Suresh Jayaraman 2 participants 2 messages Jul 27, 2010 1 message not in the archive

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 mount.cifs: document 'fsc' mount option

Changes since last post:
- added the information about the kernel CONFIG option
- also added the information that caching is currently enabled for files opened as read-only

Document the newly added local caching feature using FS-Cache. This patch could be queued and considered once the local caching patches gets merged upstream.

---

 doc/mount.cifs.8.xml |   20 ++++++++++++++++++++
 1 files changed, 20 insertions(+), 0 deletions(-)
doc/mount.cifs.8.xml +20 -0
index 4937550..af20c10 100644
@@ -534,6 +534,26 @@ permissions in memory that can't be stored on the server. This information can d
                 maximum wsize currently allowed by CIFS is 57344 (fourteen
                 4096 byte pages)</para></listitem>
 	</varlistentry>
+	<varlistentry>
+		<term>fsc</term>
+
+		<listitem><para>Enable local disk caching using FS-Cache
+		for cifs. This option could be useful to improve performance
+		on a slow link, heavily loaded server and/or network
+		where reading from the disk is faster than reading from the
+		server (over the network). This could also impact the
+		scalability positively as the number of calls to the server
+		are reduced. But, be warned that local caching is not suitable
+		for all workloads, for e.g., read-once type workloads. So
+		you need to consider carefully the situation/workload before
+		using this option. Currently, local disk caching is enabled
+		for CIFS files opened as read-only.
+		NOTE: This feature is available only in the recent kernels
+		that have been built with the kernel config option
+		CONFIG_CIFS_FSCACHE. You also need to have cachefilesd daemon
+		installed and running to make the cache operational.
+                </para></listitem>
+	</varlistentry>
 	 <varlistentry>
                 <term>--verbose</term>
                 <listitem><para>Print additional debugging information for the mount. Note that this parameter must be specified before the -o. For example:</para><para>mount -t cifs //server/share /mnt --verbose -o user=username</para></listitem>

A message that is not in the archive (sent off-list or not yet received): [email protected]

#2 lore raw
Quoted 47 lines · On Tue, 27 Jul 2010 22:18:10 +0530 Suresh Jayaraman…

Changes since last post:
- added the information about the kernel CONFIG option
- also added the information that caching is currently enabled for files opened as read-only

Document the newly added local caching feature using FS-Cache. This patch could be queued and considered once the local caching patches gets merged upstream.

---

 doc/mount.cifs.8.xml |   20 ++++++++++++++++++++
 1 files changed, 20 insertions(+), 0 deletions(-)
doc/mount.cifs.8.xml +20 -1
index 4937550..af20c10 100644
@@ -534,6 +534,26 @@ permissions in memory that can't be stored on the server. This information can d
                 maximum wsize currently allowed by CIFS is 57344 (fourteen
                 4096 byte pages)</para></listitem>
 	</varlistentry>
+	<varlistentry>
+		<term>fsc</term>
+
+		<listitem><para>Enable local disk caching using FS-Cache
+		for cifs. This option could be useful to improve performance
+		on a slow link, heavily loaded server and/or network
+		where reading from the disk is faster than reading from the
+		server (over the network). This could also impact the
+		scalability positively as the number of calls to the server
+		are reduced. But, be warned that local caching is not suitable
+		for all workloads, for e.g., read-once type workloads. So
+		you need to consider carefully the situation/workload before
+		using this option. Currently, local disk caching is enabled
+		for CIFS files opened as read-only.
+		NOTE: This feature is available only in the recent kernels
+		that have been built with the kernel config option
+		CONFIG_CIFS_FSCACHE. You also need to have cachefilesd daemon
+		installed and running to make the cache operational.
+                </para></listitem>
+	</varlistentry>
 	 <varlistentry>
                 <term>--verbose</term>
                 <listitem><para>Print additional debugging information for the mount. Note that this parameter must be specified before the -o. For example:</para><para>mount -t cifs //server/share /mnt --verbose -o user=username</para></listitem>
 
--
Quoted 4 lines

To unsubscribe from this list: send the line "unsubscribe linux-cifs" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html

I had already merged the original patch, so I've merged this one as a delta on top of that.

Thanks,

Signature · 1 line
Jeff Layton <[email protected]>