Skip to contentSkip to conversation

mount.cifs: manpage: add entry for "actimeo" option

PATCH In review Suresh Jayaraman 2 participants 4 messages Dec 1, 2010 – Dec 9, 2010 2 messages not in the archive

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

PATCH 1/1 mount.cifs: manpage: add entry for "actimeo" option

---
 mount.cifs.8 |   18 ++++++++++++++++++
 1 files changed, 18 insertions(+), 0 deletions(-)
mount.cifs.8 +18 -0
index 7d2bf69..15dc2dc 100644
@@ -403,6 +403,24 @@ Map user accesses to individual credentials when accessing the server\&. By defa
 With this change, it's feasible for the server to handle permissions enforcement, so this option also implies "noperm"\&. Furthermore, when unix extensions aren't in use and the administrator has not overriden ownership using the uid= or gid= options, ownership of files is presented as the current user accessing the share\&.
 .RE
 .PP
+actimeo=\fIarg\fR
+.RS 4
+The time (in seconds) that the CIFS client caches attributes of a file or
+directory before it requests attribute information from a server. During this
+period the changes that occur on the server remain undetected until the client
+checks the server again.
+.sp
+By default, the attribute cache timeout is set to 1 second. This means more
+frequent on-the-wire calls to the server to check whether attributes have
+changed which could impact performance. With this option the users can make
+tradeoff between performance and cache metadata correctness depending on the
+workload needs. Shorter timeouts mean better the cache coherency, but frequent
+increased number of calls to the server. Longer timeouts mean reduced number
+of calls to the server at the expense of stricter cache coherency\&. The
+actimeo value is a positive integral that can hold values between 0 and a
+maximum value of 2^30 * HZ (frequency of timer interrupt) setting\&. 
+.RE
+.PP
 \-\-verbose
 .RS 4
 Print additional debugging information for the mount\&. Note that this parameter must be specified before the \-o\&. For example:

A message that is not in the archive (sent off-list or not yet received): 1291208436-12371-1-git-send-email-sjayaraman-l3A5Bk7waGM@public.gmane.org

#2 lore raw
Quoted 14 lines · On Wed, 1 Dec 2010 18:30:36 +0530 Suresh Jayaraman…
---
 mount.cifs.8 |   18 ++++++++++++++++++
 1 files changed, 18 insertions(+), 0 deletions(-)
mount.cifs.8 +0 -0
index 7d2bf69..15dc2dc 100644
@@ -403,6 +403,24 @@ Map user accesses to individual credentials when accessing the server\&. By defa
 With this change, it's feasible for the server to handle permissions enforcement, so this option also implies "noperm"\&. Furthermore, when unix extensions aren't in use and the administrator has not overriden ownership using the uid= or gid= options, ownership of files is presented as the current user accessing the share\&.
 .RE
 .PP

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 415

Quoted 10 lines
mount.cifs.8 +10 -0
+actimeo=\fIarg\fR
+.RS 4
+The time (in seconds) that the CIFS client caches attributes of a file or
+directory before it requests attribute information from a server. During this
+period the changes that occur on the server remain undetected until the client
+checks the server again.
+.sp
+By default, the attribute cache timeout is set to 1 second. This means more
+frequent on-the-wire calls to the server to check whether attributes have
+changed which could impact performance. With this option the users can make

"With this option, users can make a"

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 416

Quoted 1 line
mount.cifs.8 +1 -0
+tradeoff between performance and cache metadata correctness depending on the

"correctness, depending"

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 417

Quoted 1 line
mount.cifs.8 +1 -0
+workload needs. Shorter timeouts mean better the cache coherency, but frequent

"Shorter timeouts mean better cache coherency, but an"

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 419

Quoted 2 lines
mount.cifs.8 +2 -0
+increased number of calls to the server. Longer timeouts mean reduced number
+of calls to the server at the expense of stricter cache coherency\&. The

A little unclear...maybe "Longer timeouts mean a reduced number of calls to the server but looser cache coherency."

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 420

Quoted 1 line
mount.cifs.8 +1 -0
+actimeo value is a positive integral that can hold values between 0 and a

"integer"

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 426

Quoted 6 lines
mount.cifs.8 +3 -0
+maximum value of 2^30 * HZ (frequency of timer interrupt) setting\&. 
+.RE
+.PP
 \-\-verbose
 .RS 4
 Print additional debugging information for the mount\&. Note that this parameter must be specified before the \-o\&. For example:

If those edits look ok, I'll add them in when I merge the patch, which should be soon after Steve merges the kernel patch. No need to resend.

Thanks,

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

A message that is not in the archive (sent off-list or not yet received): 20101201080932.24f4386e-9yPaYZwiELC+kQycOl6kW4xkIHaj4LzF@public.gmane.org

#4 lore raw
Quoted 33 lines · Jeff Layton
Quoted 14 lines · On Wed, 1 Dec 2010 18:30:36 +0530 Suresh Jayaraman…
---
 mount.cifs.8 |   18 ++++++++++++++++++
 1 files changed, 18 insertions(+), 0 deletions(-)
mount.cifs.8 +0 -0
index 7d2bf69..15dc2dc 100644
@@ -403,6 +403,24 @@ Map user accesses to individual credentials when accessing the server\&. By defa
 With this change, it's feasible for the server to handle permissions enforcement, so this option also implies "noperm"\&. Furthermore, when unix extensions aren't in use and the administrator has not overriden ownership using the uid= or gid= options, ownership of files is presented as the current user accessing the share\&.
 .RE
 .PP

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 415

Quoted 10 lines
mount.cifs.8 +10 -0
+actimeo=\fIarg\fR
+.RS 4
+The time (in seconds) that the CIFS client caches attributes of a file or
+directory before it requests attribute information from a server. During this
+period the changes that occur on the server remain undetected until the client
+checks the server again.
+.sp
+By default, the attribute cache timeout is set to 1 second. This means more
+frequent on-the-wire calls to the server to check whether attributes have
+changed which could impact performance. With this option the users can make

"With this option, users can make a"

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 416

Quoted 1 line
mount.cifs.8 +1 -0
+tradeoff between performance and cache metadata correctness depending on the

"correctness, depending"

Quoted 10 lines

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 417

Quoted 1 line
mount.cifs.8 +1 -0
+workload needs. Shorter timeouts mean better the cache coherency, but frequent

"Shorter timeouts mean better cache coherency, but an"

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 419

Quoted 2 lines
mount.cifs.8 +2 -0
+increased number of calls to the server. Longer timeouts mean reduced number
+of calls to the server at the expense of stricter cache coherency\&. The

A little unclear...maybe "Longer timeouts mean a reduced number of calls to the server but looser cache coherency."

Quoted 1 line
mount.cifs.8 +1 -0
+actimeo value is a positive integral that can hold values between 0 and a

Doh, this word "integral" was borrowed from nfs man page. But, I agree "integer" is correct and the nfs man page perhaps needs to be fixed too.

Quoted 9 lines

"integer"

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 426

Quoted 6 lines
mount.cifs.8 +3 -0
+maximum value of 2^30 * HZ (frequency of timer interrupt) setting\&. 
+.RE
+.PP
 \-\-verbose
 .RS 4
 Print additional debugging information for the mount\&. Note that this parameter must be specified before the \-o\&. For example:
Quoted 3 lines

If those edits look ok, I'll add them in when I merge the patch, which should be soon after Steve merges the kernel patch. No need to resend.

All of them look fine. Thanks for getting those finer bits correct.

Signature · 1 line
Suresh Jayaraman
#5 lore raw
In reply to a message not in the archive
Quoted 53 lines · On Wed, 1 Dec 2010 08:09:32 -0500 Jeff Layton…
Quoted 14 lines · On Wed, 1 Dec 2010 18:30:36 +0530 Suresh Jayaraman…
---
 mount.cifs.8 |   18 ++++++++++++++++++
 1 files changed, 18 insertions(+), 0 deletions(-)
mount.cifs.8 +0 -0
index 7d2bf69..15dc2dc 100644
@@ -403,6 +403,24 @@ Map user accesses to individual credentials when accessing the server\&. By defa
 With this change, it's feasible for the server to handle permissions enforcement, so this option also implies "noperm"\&. Furthermore, when unix extensions aren't in use and the administrator has not overriden ownership using the uid= or gid= options, ownership of files is presented as the current user accessing the share\&.
 .RE
 .PP

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 415

Quoted 10 lines
mount.cifs.8 +10 -0
+actimeo=\fIarg\fR
+.RS 4
+The time (in seconds) that the CIFS client caches attributes of a file or
+directory before it requests attribute information from a server. During this
+period the changes that occur on the server remain undetected until the client
+checks the server again.
+.sp
+By default, the attribute cache timeout is set to 1 second. This means more
+frequent on-the-wire calls to the server to check whether attributes have
+changed which could impact performance. With this option the users can make

"With this option, users can make a"

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 416

Quoted 1 line
mount.cifs.8 +1 -0
+tradeoff between performance and cache metadata correctness depending on the

"correctness, depending"

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 417

Quoted 1 line
mount.cifs.8 +1 -0
+workload needs. Shorter timeouts mean better the cache coherency, but frequent

"Shorter timeouts mean better cache coherency, but an"

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 419

Quoted 2 lines
mount.cifs.8 +2 -0
+increased number of calls to the server. Longer timeouts mean reduced number
+of calls to the server at the expense of stricter cache coherency\&. The

A little unclear...maybe "Longer timeouts mean a reduced number of calls to the server but looser cache coherency."

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 420

Quoted 1 line
mount.cifs.8 +1 -0
+actimeo value is a positive integral that can hold values between 0 and a

"integer"

mount.cifs.8 Map user accesses to individual credentials when accessing the server\&. By defa · line 426

Quoted 6 lines
mount.cifs.8 +3 -0
+maximum value of 2^30 * HZ (frequency of timer interrupt) setting\&. 
+.RE
+.PP
 \-\-verbose
 .RS 4
 Print additional debugging information for the mount\&. Note that this parameter must be specified before the \-o\&. For example:
Quoted 10 lines

If those edits look ok, I'll add them in when I merge the patch, which should be soon after Steve merges the kernel patch. No need to resend.

Thanks,

Signature · 5 lines
Jeff Layton <[email protected]>
--
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

Modified patch pushed to cifs-utils repo.

Thanks,

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