X-Git-Url: https://gerrit.opnfv.org/gerrit/gitweb?a=blobdiff_plain;f=src%2Fceph%2Fsrc%2Fdoc%2Frgw.txt;fp=src%2Fceph%2Fsrc%2Fdoc%2Frgw.txt;h=3b55ade1dec75535d934f044f31f1cb3cfac5d68;hb=812ff6ca9fcd3e629e49d4328905f33eee8ca3f5;hp=0000000000000000000000000000000000000000;hpb=15280273faafb77777eab341909a3f495cf248d9;p=stor4nfv.git

diff --git a/src/ceph/src/doc/rgw.txt b/src/ceph/src/doc/rgw.txt
new file mode 100644
index 0000000..3b55ade
--- /dev/null
+++ b/src/ceph/src/doc/rgw.txt
@@ -0,0 +1,28 @@
+rgw_main: contains the web server interface and checks user access keys.
+rgw_user: defines the RGWUserBuckets class and contains global functions
+to get/store user info, get the anon user, and get UIDs from email.
+rgw_user: defines the RGWUID class with some basic bookkeeping operations
+rgw_common: houses data types and functions
+rgw_access: abstract class providing interface for storage mechanisms
+rgw_acl.h: Many different classes, some decoding XML, some encoding XML, some doing checks for owner and permissions.
+rgw_fs: rgw_access based on the local fs.
+rgw_rados:  rgw_access based on an actual RADOS cluster.
+rgw_admin: Administer the cluster -- create users, look at the state, etc.
+rgw_op: Define the different operations as objects for easy tracking.
+rgw_REST: extend the classes in rgw_op for a REST interface
+
+user IDs are strings, as with S3.
+
+buckets:
+ui_email_bucket: hold objects named by email and containing encoded RGWUIDs
+ui_bucket: holds objects named by user_id and containing encoded RGWUserInfos
+root_bucket: holds objects corresponding to the other buckets, with ACLs in their attrs.
+
+Observed schema:
+buckets:
+.rgw -- contains: .users -- empty
+     		  .users.email -- empty
+		  johnny1 -- bucket name -- empty
+.users -- contains: anonymous -- empty
+       	  	    bucket for each user id -- contains binary, key, binary, secret key, binary, user name, binary, user email
+.users.email -- contains bucket for each user email -- contains binary, then user id