I am sponsoring the following fasttrack for Alan Wright. Requested binding
is minor. Timeout is 9/2/2009.
Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
1.1. Project/Component Working Name:
Offline attribute
1.2. Name of Document Author/Supplier:
Author: Alan Wright
1.3 Date of This Document:
26 August, 2009
4. Technical Description
4.1. Details:
This case proposes a new system attribute to support offline
files as a generic solution to the proposal in PSARC/2009/381
Support off-line files on SAM-QFS for Samba in Solaris.
PSARC/2009/381 provides a specific solution for the use of
Samba with SAM-FS that depends on libsamfs, which is delivered
by the SUNWsamfsr and SUNWsamfsu packages.
The system attribute interface is described in:
PSARC/2007/315 Extensible Attribute Interfaces.
Associated changes to chmod(1) and ls(1) are described in:
PSARC/2007410 Add system attribute to chmod
PSARC/2007394 ls(1) '-/' and '-%' options for system attributes
The offline attribute (XAT_OFFLINE) will be added to the read-
write system attributes view defined in PSARC/2007/315 and will be
generally available to file systems and applications to indicate
the offline/online status of objects: boolean value of true
indicates the object is offline. In order to set or clear the
offline attribute the consumer must have the ACE_WRITE_ATTRIBUTES
permission or the PRIV_FILE_OWNER privilege. In the kernel, it
will be accessible via VOP_GETATTR() and VOP_SETATTR(). In user
space, it will be accessible via chmod(1), ls(1) and fgetattr(3C).
No changes are required to the VOP or fgetattr(3C) function
prototypes.
4.6. Doc Impact:
Modifications to the chmod(1) man page:
Table 1: Attribute Names and Abbreviation Characters
Attribute Name Attribute Abbreviation Character
-------------- --------------------------------
+ offline O
Modifications to the ls(1) man page:
-/ c | v
+ offline - Attribute to indicate that a file is offline.
The display characters used in compact mode (-/ c) are as follows:
Attribute Name Display
+ offline O
The display positions are as follows:
! {|||||||||||}
+ ||||||||||+- O (offline)
! |||||||||+-- u (nounlink)
! ||||||||+--- q (av_quarantined)
! |||||||+---- m (av_modified)
! ||||||+----- i (immutable)
! |||||+------ d (nodump)
! ||||+------- a (appendonly)
! |||+-------- S (system)
! ||+--------- R (readonly)
! |+---------- H (hidden)
! +----------- A (archive)
Modifications to the fgetattr(3C) man page:
View Attribute Data type
_______________________________________________________________
XATTR_VIEW_READWRITE ...
+ A_OFFLINE boolean_value
5. Exported Interface Table
|Proposed |Specified |
|Stability |in what |
Interface Name |Classification |Document? | Comments
===============================================================================
|Consolidation |This |
|Private |Document |
| | |
A_OFFLINE | | | Added to read-write
| | | view of extended
| | | attribute namespace
| | |
| | |
XAT_OFFLINE | | | Value for offline
| | | system attribute
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
