GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  FS_CSCPOLICY (1)

.ds Aq ’

NAME

fs_cscpolicy - Change client side caching policy for AFS shares [Windows only]

CONTENTS

SYNOPSIS

fs cscpolicy [-share sharename [-manual|-programs|-documents|-disable] ]

DESCRIPTION

The fs cscpolicy command sets the client side caching policy for a particular AFS share, or displays a list of policies.

This command can change the policy of only one share at a time.

Only one of the policy options -manual, -programs, -documents, or -disable, may be selected. The default policy is -manual.

After changing the policy for a share, you must close all applications that accessed files on this share, or restart AFS Client, for the change to take effect.

CAUTIONS

This command is only available on Windows.

Use of this functionality is not recommended. Windows Offline Folders do not work well with AFS since the AFS server is always present. When this functionality was contributed and incorporated, it was believed to be safe for the AFS cache manager to return BADNETPATH errors when a single file server or volume was inaccessible. It is now known that returning such errors causes the Microsoft SMB redirector to drop the connection to the AFS server resulting in serious side effects.

This functionality is specific to use with the Microsoft SMB redirector. Client Side Caching (Offline Folders) is built into that driver and will not be present in the native AFS redirector, so this functionality will be removed at a future date.

OPTIONS

-share sharename The name of the share whose policy is to be changed. (If omitted, no share policy is changed.)
-manual Specifies manual caching of documents.
-programs Specifies automatic caching of programs and documents.
-documents Specifies automatic caching of documents.
-disable Disables caching.

OUTPUT

When changing the policy of a share, the output is:



   CSC policy on share "share" changed to "policy".
   Close all applications that accessed files on this share or restart AFS Client for the change to take effect.



When displaying policies, the output is:



   policyname = policy



EXAMPLES

The following command disables all caching on the share AFS1:



   % fs cscpolicy -share AFS1 -disable



The following command displays all policies currently in effect:



   % fs cscpolicy



PRIVILEGE REQUIRED

The issuer must be have AFS Client Administrator access, either to display or to set policies.

In addition, to change policies, the issuer must be a Windows Administrator, since policy information is stored in a protected area of the Windows Registry.

COPYRIGHT

This document was written by Mike Robinson, and is released under the IBM Public License Version 1.0. Jeffrey Altman made several corrections, clarifications, and additions.
Search for    or go to Top of page |  Section 1 |  Main Index


OpenAFS FS_CSCPOLICY (1) 2015-10-28

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.