CIFS Server: Client Side Caching Share Property [PSARC/2008/758 Self Review]

[Jordan Brown]

I am sponsoring the following proposal.  Because it supports a property
defined by the CIFS protocol, uses names defined by the CIFS documentation,
and required essentially no Solaris-side processing (only storing the value
and providing it to clients), I believe it qualifies for automatic approval.

This information is Copyright 2008 Sun Microsystems

1. Introduction
     1.1. Project/Component Working Name:
          Client-side caching share property
     1.2. Name of Document Author/Supplier:
          Author:  Alan Wright
     1.3  Date of This Document:
          8 December, 2008

4. Technical Description

	This fast-track proposes a new property for shares to provide per-
	share client-side caching (CSC) for offline files policy guidance
	to clients.  Note that client-side caching is a client feature and
	the offline or cached files are managed entirely by clients.
	The property value has no meaning to the server, does not affect
	server behavior and the server does not and cannot control the
	caching or offline file policy implemented by clients.

	This property may be set on Windows servers and is required for
	compatibility and interoperability with Windows.

	The proposed csc property can take one of values described below.
	The value names and definitions are those used in the client-side
	caching for offline files documentation, for example,
	http://msdn.microsoft.com/en-us/library/aa369575(VS.85).aspx
	http://msdn.microsoft.com/en-us/library/cc212363.aspx

	csc=manual|auto|vdo|disabled

	manual

	Clients are allowed to cache files from the specified share for
	offline use as requested by users but automatic file-by-file
	reintegration is not allowed.  This is the default setting.

	auto

	Clients are allowed to automatically cache files from the
	specified share for offline use and file-by-file reintegration
	is allowed.

	vdo

	Clients are allowed to automatically cache files from the specified
	share for offline use, file-by-file reintegration is allowed and
	clients are permitted to work from their local cache even while
	offline.

	disabled

	Client-side caching is not allowed for this share.


	Examples of setting the csc property using the sharemgr and zfs
	commands:

		sharemgr set -P smb -p csc=disabled -r zshare zgroup

		zfs sharesmb=csc=disabled tank/zvol

6. Resources and Schedule
     6.4. Steering Committee requested information
    	6.4.1. Consolidation C-team Name:
		ON
     6.5. ARC review type: FastTrack
     6.6. ARC Exposure: open


6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		ON
    6.5. ARC review type: Automatic
    6.6. ARC Exposure: open