[OpenAFS-Doc] submission of architecture documents

Steven Jenkins steven.jenkins@gmail.com
Mon, 10 Mar 2008 16:23:51 -0500


------=_Part_12723_19105412.1205184231084
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Content-Disposition: inline

There is an architecture documents for Demand Attach that I think
would be appropriate to place in, say, docs/arch (ie, instead of
classifying them by format, classify them by content).  Specifically,
I've attached a diagram of the state machine for Demand Attach, in Dot
format.

Does it make sense to put this document in doc/arch?  If not, what is
'the right' place?

Thanks,
Steven

------=_Part_12723_19105412.1205184231084
Content-Type: application/msword; name=dafs-fsa.dot
Content-Transfer-Encoding: base64
X-Attachment-Id: f_fdnjpj030
Content-Disposition: attachment; filename=dafs-fsa.dot

IwojIFRoaXMgaXMgYSBkb3QgKGh0dHA6Ly93d3cuZ3JhcGh2aXoub3JnKSBkZXNjcmlwdGlvbiBv
ZiB0aGUgdmFyaW91cwojIHN0YXRlcyB2b2x1bWVzIGNhbiBiZSBpbiBmb3IgREFGUyAoRGVtYW5k
IEF0dGFjaCBGaWxlIFNlcnZlcikuCiMKIyBBdXRob3I6IFN0ZXZlbiBKZW5raW5zCiMgRGF0ZTog
MjAwNy0wNS0yNAojCgpkaWdyYXBoIFZvbHVtZVN0YXRlcyB7CglzaXplPSIxMSwxNyIKCWdyYXBo
IFsKCQlyYW5rZGlyID0gIlRCIgoJXTsKCglzdWJncmFwaCBjbHVzdGVyS2V5IHsKCQlyYW5rZGly
PSJMUiI7CgkJc2hhcGUgPSAicmVjdGFuZ2xlIjsKCglzMSBbIHNoYXBlPXBsYWludGV4dCwgbGFi
ZWwgPSAiVlB1dCBhZnRlciBWRGV0YWNoIGluIGJyb3duIiwKCQkJZm9udGNvbG9yPSJicm93biIg
XTsKCXMyIFsgc2hhcGU9cGxhaW50ZXh0LCBsYWJlbCA9ICJWQXR0YWNoIGluIGJsdWUiLAoJCQlm
b250Y29sb3I9ImJsdWUiIF07CglzMyBbIHNoYXBlPXBsYWludGV4dCwgbGFiZWwgPSAiVkdldC9W
SG9sZCBpbiBwdXJwbGUiLAoJCQlmb250Y29sb3I9InB1cnBsZSIgXTsKCXM0IFsgc2hhcGU9cGxh
aW50ZXh0LCBsYWJlbCA9ICJFcnJvciBTdGF0ZXMgaW4gcmVkIiwKCQkJZm9udGNvbG9yPSJyZWQi
IF07CglzNSBbIHNoYXBlPXBsYWludGV4dCwgbGFiZWwgPSAiVlB1dCBhZnRlciBWT2ZmbGluZSBp
biBncmVlbiIsCgkJCWZvbnRjb2xvcj0iZ3JlZW4iIF07CglzNiBbIHNoYXBlPWVsbGlwc2UsIGxh
YmVsID0gInJlLWVudHJhbnQiIF07CglzNyBbIHNoYXBlPWVsbGlwc2UsIHBlcmlwaGVyaWVzPTIs
IGxhYmVsPSJub24gcmUtZW50cmFudCIgXTsKCXM4IFsgc2hhcGU9ZWxsaXBzZSwgY29sb3I9InJl
ZCIsIGxhYmVsPSJFcnJvciBTdGF0ZXMiIF07CgoJczYtPnM3LT5zOC0+czEtPnMyLT5zMy0+czQt
PnM1IFtzdHlsZT0iaW52aXMiXTsKCgl9CgoJbm9kZSBbIHBlcmlwaGVyaWVzID0gIjIiIF0gQVRU
QUNISU5HIFwKCQlMT0FESU5HX1ZOT0RFX0JJVE1BUFMgSERSX0xPQURJTkdfRlJPTV9ESVNLIFwK
CQlIRFJfQVRUQUNISU5HX0xSVV9QVUxMIFwKCQkiVVBEQVRJTkdcblNZTkNJTkdfVk9MX0hEUl9U
T19ESVNLIiBcCgkJT0ZGTElOSU5HIERFVEFDSElORzsKCW5vZGUgWyBzaGFwZSA9ICJlbGxpcHNl
IiwgcGVyaXBoZXJpZXMgPSAiMSIgXTsKCW5vZGUgWyBjb2xvciA9ICJyZWQiIF0gSEFSRF9FUlJP
UiBTQUxWQUdFX1JFUVVFU1RFRCBTQUxWQUdJTkc7CgoJbm9kZSBbIGNvbG9yID0gImJsYWNrIiBd
OyAvLyBkZWZhdWx0IGJhY2sgdG8gYmxhY2sKCglVTkFUVEFDSEVELT5FeGNsdXNpdmVfdm9sX29w
X2V4ZWN1dGluZyBbbGFiZWwgPSAiY29udHJvbGxlZCBieSBGU1NZTkMiIF07CglFeGNsdXNpdmVf
dm9sX29wX2V4ZWN1dGluZy0+VU5BVFRBQ0hFRCAgW2xhYmVsID0gImNvbnRyb2xsZWQgYnkgRlNT
WU5DIiBdOwoJVU5BVFRBQ0hFRC0+RlJFRUQgWyBsYWJlbCA9ICJWQ2FuY2VsUmVzZXJ2YXRpb25f
cigpIGFmdGVyIGFcblZEZXRhY2goKSBvciBGcmVlVm9sdW1lKCkgd2lsbFxuY2F1c2UgQ2hlY2tE
ZXRhY2goKSBvciBDaGVja0ZyZWUoKSB0byBmaXJlIiBdOwoJT0ZGTElOSU5HLT5VTkFUVEFDSEVE
OwoJVU5BVFRBQ0hFRC0+UFJFQVRUQUNIRUQgWyBjb2xvciA9ICJvcmFuZ2UiLCBsYWJlbCA9ICJQ
cmVBdHRhY2goKSIgXTsKCVBSRUFUVEFDSEVELT5VTkFUVEFDSEVEIFsgY29sb3IgPSAib3Jhbmdl
IiwgbGFiZWwgPSAiVk9mZmxpbmUoKSJdOwoJSEFSRF9FUlJPUi0+UFJFQVRUQUNIRUQgWyBjb2xv
ciA9ICJvcmFuZ2UiLCBsYWJlbCA9ICJvcGVyYXRvciBpbnRlcnZlbnRpb24gdmlhIEZTU1lOQyIg
XTsKCglQUkVBVFRBQ0hFRC0+RXhjbHVzaXZlX3ZvbF9vcF9leGVjdXRpbmcgW2NvbG9yID0gIm9y
YW5nZSIsIGxhYmVsID0gImNvbnRyb2xsZWQgYnkgRlNTWU5DIiBdOwoJRXhjbHVzaXZlX3ZvbF9v
cF9leGVjdXRpbmctPlBSRUFUVEFDSEVEIFtjb2xvciA9ICJvcmFuZ2UiLCBsYWJlbCA9ICJjb250
cm9sbGVkIGJ5IEZTU1lOQyIgXTsKCVBSRUFUVEFDSEVELT5GUkVFRCBbIGNvbG9yID0gIm9yYW5n
ZSIsIGxhYmVsID0gIlZDYW5jZWxSZXNlcnZhdGlvbl9yKCkgYWZ0ZXIgYVxuVkRldGFjaCgpIG9y
IEZyZWVWb2x1bWUoKSB3aWxsXG5jYXVzZSBDaGVja0RldGFjaCgpIG9yIENoZWNrRnJlZSgpIHRv
IGZpcmUiIF07CglQUkVBVFRBQ0hFRC0+QVRUQUNISU5HIFsgY29sb3IgPSAiYmx1ZSIsIHdlaWdo
dCA9ICI4IiBdOwoJU0FMVkFHSU5HLT5QUkVBVFRBQ0hFRCBbIGxhYmVsID0gImNvbnRyb2xsZWQg
dmlhIEZTU1lOQyIgXTsJCgoJREVUQUNISU5HLT5GUkVFRCA7CglTSFVUVElOR19ET1dOLT5ERVRB
Q0hJTkcgWyBjb2xvciA9ICJicm93biIgXTsKCUFUVEFDSEVEX25Vc2Vyc19HVF8wLT5TSFVUVElO
R19ET1dOIFsgY29sb3IgPSAib3JhbmdlIiwgbGFiZWwgPSAiVkRldGFjaCgpIiBdOwoKCURFVEFD
SElORy0+IlVQREFUSU5HXG5TWU5DSU5HX1ZPTF9IRFJfVE9fRElTSyIgWyBjb2xvciA9ICJicm93
biIgXTsKCSJVUERBVElOR1xuU1lOQ0lOR19WT0xfSERSX1RPX0RJU0siLT5ERVRBQ0hJTkcgWyBj
b2xvciA9ICJicm93biIgXTsKCU9GRkxJTklORy0+IlVQREFUSU5HXG5TWU5DSU5HX1ZPTF9IRFJf
VE9fRElTSyIgWyBjb2xvciA9ICJncmVlbiIgXTsKCSJVUERBVElOR1xuU1lOQ0lOR19WT0xfSERS
X1RPX0RJU0siLT5PRkZMSU5JTkcgWyBjb2xvciA9ICJncmVlbiIgXTsKCUdPSU5HX09GRkxJTkUt
Pk9GRkxJTklORyBbIGNvbG9yID0gImdyZWVuIiBdOwoKCSJVUERBVElOR1xuU1lOQ0lOR19WT0xf
SERSX1RPX0RJU0siLT5TQUxWQUdFX1JFUVVFU1RFRCBbIGNvbG9yID0gInJlZCIgXTsJCgkiVVBE
QVRJTkdcblNZTkNJTkdfVk9MX0hEUl9UT19ESVNLIi0+QVRUQUNISU5HIFsgY29sb3IgPSAiYmx1
ZSIgXTsJCglBVFRBQ0hJTkctPiJVUERBVElOR1xuU1lOQ0lOR19WT0xfSERSX1RPX0RJU0siIFsg
Y29sb3IgPSAiYmx1ZSIgXTsKCglBVFRBQ0hFRF9uVXNlcnNfR1RfMC0+R09JTkdfT0ZGTElORSBb
IGNvbG9yID0gIm9yYW5nZSIsIGxhYmVsID0gIlZPZmZsaW5lIiBdOwkKCUFUVEFDSEVEX25Vc2Vy
c19HVF8wLT5BVFRBQ0hFRF9uVXNlcnNfRVFfMCBbIGNvbG9yID0gIm9yYW5nZSIsIGxhYmVsID0g
IlZQdXQiIF07CQoKCUFUVEFDSEVEX25Vc2Vyc19HVF8wLT5TQUxWQUdFX1JFUVVFU1RFRCBbIGNv
bG9yID0gInJlZCIgXTsKCglMT0FESU5HX1ZOT0RFX0JJVE1BUFMtPkFUVEFDSElORyBbIGNvbG9y
ID0gImJsdWUiIF07CglBVFRBQ0hJTkctPkxPQURJTkdfVk5PREVfQklUTUFQUyBbIGNvbG9yID0g
ImJsdWUiIF0gOwoJTE9BRElOR19WTk9ERV9CSVRNQVBTLT5TQUxWQUdFX1JFUVVFU1RFRCBbIGNv
bG9yID0gInJlZCIgXTsKCUhEUl9MT0FESU5HX0ZST01fRElTSy0+U0FMVkFHRV9SRVFVRVNURUQg
WyBjb2xvciA9ICJyZWQiIF07CglIRFJfTE9BRElOR19GUk9NX0RJU0stPkFUVEFDSElORyBbIGNv
bG9yID0gImJsdWUiIF0gOwoJSERSX0xPQURJTkdfRlJPTV9ESVNLLT5BVFRBQ0hFRF9uVXNlcnNf
R1RfMCBbIGNvbG9yID0gInB1cnBsZSIgXTsKCglTQUxWQUdFX1JFUVVFU1RFRC0+U0FMVkFHSU5H
IFsgbGFiZWwgPSAiY29udHJvbGxlZCB2aWEgRlNTWU5DIiBdOwoJU0FMVkFHRV9SRVFVRVNURUQt
PkhBUkRfRVJST1IgWyBjb2xvciA9ICJyZWQiLCAKCQlsYWJlbCA9ICJBZnRlciBoYXJkIHNhbHZh
Z2UgbGltaXQgcmVhY2hlZCxcbiBoYXJkIGVycm9yIHN0YXRlIGlzIGluIGVmZmVjdFxudW50aWwg
dGhlcmUgaXMgb3BlcmF0b3IgaW50ZXJ2ZW50aW9uIiBdOwoJCglIRFJfQVRUQUNISU5HX0xSVV9Q
VUxMLT5IRFJfTE9BRElOR19GUk9NX0RJU0sgWyBjb2xvciA9ICJibHVlIiBdOwoJSERSX0FUVEFD
SElOR19MUlVfUFVMTC0+SERSX0xPQURJTkdfRlJPTV9ESVNLIFsgY29sb3IgPSAicHVycGxlIiBd
OwoJSERSX0FUVEFDSElOR19MUlVfUFVMTC0+QVRUQUNIRURfblVzZXJzX0dUXzAgWyBjb2xvciA9
ICJwdXJwbGUiLCBsYWJlbCA9ICJoZWFkZXIgY2FuIGJlIGluIExSVVxuYW5kIG5vdCBoYXZlIGJl
ZW4gcmVjbGFpbWVkXG50aHVzIHNraXBwaW5nIGRpc2sgSS9PIiBdOwoKCUFUVEFDSElORy0+SERS
X0FUVEFDSElOR19MUlVfUFVMTCBbIGNvbG9yID0gImJsdWUiIF07CglBVFRBQ0hJTkctPkFUVEFD
SEVEX25Vc2Vyc19FUV8wIFsgY29sb3IgPSAiYmx1ZSIgXTsKCglBVFRBQ0hJTkctPlNBTFZBR0Vf
UkVRVUVTVEVEIFsgY29sb3IgPSAicmVkIiBdOwoJQVRUQUNIRURfblVzZXJzX0VRXzAtPkhEUl9B
VFRBQ0hJTkdfTFJVX1BVTEwgWyBjb2xvciA9ICJwdXJwbGUiIF07CgkKCUFUVEFDSEVEX25Vc2Vy
c19FUV8wLT5TQUxWQUdFX1JFUVVFU1RFRCBbIGNvbG9yID0gInJlZCIgXTsKCgkvLyBWYXJpb3Vz
IGxvb3BiYWNrIHRyYW5zaXRpb25zCglHT0lOR19PRkZMSU5FLT5HT0lOR19PRkZMSU5FIFsgbGFi
ZWwgPSAiVlB1dCB3aGVuIChuVXNlcnMgPiAxKSIgXTsKCVNIVVRUSU5HX0RPV04tPlNIVVRUSU5H
X0RPV04gCgkJWyBsYWJlbCA9ICJWUHV0IHdoZW4gKChuVXNlcnMgPiAxKSB8fFxuKChuVXNlcnMg
PT0gMSkgJiYgKG5XYWl0ZXJzID4gMCkpKSIgXTsKCVNIVVRUSU5HX0RPV04tPlNIVVRUSU5HX0RP
V04KCQlbIGxhYmVsID0gIlZDYW5jZWxSZXNlcnZhdGlvbl9yIHdoZW4gKChuV2FpdGVycyA+IDEp
XG58fCAoKG5XYWl0ZXJzID09IDEpICYmIChuVXNlcnMgPiAwKSkpIl07CQp9IAo=
------=_Part_12723_19105412.1205184231084--