[AFS3-std] AFSVol Tag-Length-Value extensions I-D

Tom Keiser tkeiser@sinenomine.net
Fri, 2 Jul 2010 18:49:02 -0400


This is a second call for reviewers on -02.  If I don't hear anything
within the next week, I'm going to move forward with publishing -03,
which will incorporate the changes I outlined at the bottom of my
previous email, sometime around July 12th.

Cheers,

-Tom


On Tue, Jun 15, 2010 at 12:26 PM, Tom Keiser <tkeiser@sinenomine.net> wrote=
:
> Greetings,
>
> I've published draft-tkeiser-afs3-volser-tlv-02; this new draft can be
> accessed via the following URLs and AFS paths:
>
> http://tools.ietf.org/html/draft-tkeiser-afs3-volser-tlv-02
> http://openafs.sinenomine.net/~tkeiser/i-d/draft-tkeiser-afs3-volser-tlv-=
02.html
> http://openafs.sinenomine.net/~tkeiser/i-d/draft-tkeiser-afs3-volser-tlv-=
02.xml
> http://openafs.sinenomine.net/~tkeiser/i-d/draft-tkeiser-afs3-volser-tlv-=
01-02.xml.diff
>
> /afs/sinenomine.net/user/tkeiser/public_html/i-d/draft-tkeiser-afs3-volse=
r-tlv-02.txt
> /afs/sinenomine.net/user/tkeiser/public_html/i-d/draft-tkeiser-afs3-volse=
r-tlv-02.html
> /afs/sinenomine.net/user/tkeiser/public_html/i-d/draft-tkeiser-afs3-volse=
r-tlv-02.xml
> /afs/sinenomine.net/user/tkeiser/public_html/i-d/draft-tkeiser-afs3-volse=
r-tlv-01-02.xml.diff
>
>
> Here is the change log for this revision:
>
> =A0- ERRATA: AFSCAPABILITIESMAX is actually defined to be 196, not 192
> =A0- add section re: cache coherence to the tag enumeration RPC
> =A0- add section re: day-of-week usage following discussion with mmeffie
> =A0- s/AFSVOL_TLV_TAG_VOL_DAY_USE/AFSVOL_TLV_TAG_VOL_STAT_USE_TODAY/
> =A0 =A0following discussion with mmeffie
> =A0- add AFSVOL_TLV_TAG_VOL_STAT_USE_TODAY_DATE following discussion with
> =A0 =A0mmeffie
> =A0- add section re: definition of each tlv payload type
> =A0- add section re: definition of each tlv flag
> =A0- add note soliciting comments to afs3-stds list
> =A0- s/GCO Registrar/AFS Assigned Numbers Registrar/
> =A0- s/afsint/AFSVol/ so that we keep our options open with respect to
> =A0 =A0wider standardization of TLV semantics
> =A0- add AFSVOL_TLV_TYPE_UINT64_VEC payload type
> =A0- convert various tags from AFSVOL_TLV_TYPE_OPAQUE to
> =A0 =A0AFSVOL_TLV_TYPE_UINT64_VEC
> =A0- add AFSVOL_TLV_FLAG_QUALIFIER_NO_MATCH flag
> =A0- write AFSVol TLV Payloads registry definition
> =A0- write AFSVol TLV Tags registry definition
> =A0- add registry for AFSVol_TLV.tlv_flags
> =A0- add registry for AFSVol_stat_use_per_dow.stat_flags
> =A0- write AFSVol Vol State Expls registry definition
> =A0- write AFSVol Program Types registry definition
> =A0- add numeric value assignments for newly created registries
> =A0- add RFC section references to new allocations
> =A0- add reference to Simon's AFS-STDS charter
> =A0- add an appendix with sample XDR for AFSVol Capabilities
> =A0- add an appendix with sample XDR for AFSVol TLV
> =A0- various cosmetic improvements (e.g. adding vspace tags)
>
>
> Moving forward, I propose making one change in -03. =A0Namely, I want to =
split
> type AFSVOL_TLV_TYPE_UINT64 up into a few types that embed some limited
> semantic knowledge into the TLV layer. =A0Specifically, I'm thinking of
> splitting AFSVOL_TLV_TYPE_UINT64 into the following six types:
>
> =A0* AFSVOL_TLV_TYPE_UINT64 =A0 =A0[generic unit-less type, as before]
> =A0* AFSVOL_TLV_TYPE_TIME_ABS =A0[Simon's rpc refresh 100ns unit; absolut=
e]
> =A0* AFSVOL_TLV_TYPE_TIME_REL =A0[Simon's rpc refresh 100ns unit; relativ=
e]
> =A0* AFSVOL_TLV_TYPE_BLOCKS =A0 =A0[storage in 1KiB units]
> =A0* AFSVOL_TLV_TYPE_VOLUME_ID
> =A0* AFSVOL_TLV_TYPE_PARTITION_ID
>
> All six would be backed by afs_uint64 in the AFSVol_TLV_value union. Whil=
e
> this change isn't strictly necessary, it's relatively straightforward to
> implement, and makes the resulting volume TLV data considerably more
> self-describing.
>
> As always, comments and feedback are invited.
>
> Cheers,
>
> -Tom
>
> _______________________________________________
> AFS3-standardization mailing list
> AFS3-standardization@openafs.org
> http://michigan-openafs-lists.central.org/mailman/listinfo/afs3-standardi=
zation
>



--=20
Tom Keiser
tkeiser@gmail.com