From 20a845ba996f709a87dd879d55e1b662dd316144 Mon Sep 17 00:00:00 2001 From: Suresh Jayaraman Date: Tue, 27 Jul 2010 13:35:59 -0400 Subject: mount.cifs: document the '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. Signed-off-by: Suresh Jayaraman --- mount.cifs.8 | 7 +++++++ 1 file changed, 7 insertions(+) (limited to 'mount.cifs.8') diff --git a/mount.cifs.8 b/mount.cifs.8 index 71c7cb9..d01f2a3 100644 --- a/mount.cifs.8 +++ b/mount.cifs.8 @@ -389,6 +389,13 @@ wsize=\fIarg\fR default network write size (default 57344) maximum wsize currently allowed by CIFS is 57344 (fourteen 4096 byte pages) .RE .PP +fsc +.RS 4 +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\&. +.sp +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\&. +.RE +.PP \-\-verbose .RS 4 Print additional debugging information for the mount\&. Note that this parameter must be specified before the \-o\&. For example: -- cgit v1.2.3