summaryrefslogtreecommitdiffstats
path: root/done/GlusterFS 3.5/gfid access.md
diff options
context:
space:
mode:
authorraghavendra talur <raghavendra.talur@gmail.com>2015-08-20 15:09:31 +0530
committerHumble Devassy Chirammal <humble.devassy@gmail.com>2015-08-31 02:27:22 -0700
commit9e9e3c5620882d2f769694996ff4d7e0cf36cc2b (patch)
tree3a00cbd0cc24eb7df3de9b2eeeb8d42ee9175f88 /done/GlusterFS 3.5/gfid access.md
parentf6055cdb4dedde576ed8ec55a13814a69dceefdc (diff)
Create basic directory structure
All new features specs go into in_progress directory. Once signed off, it should be moved to done directory. For now, This change moves all the Gluster 4.0 feature specs to in_progress. All other specs are under done/release-version. More cleanup required will be done incrementally. Change-Id: Id272d301ba8c434cbf7a9a966ceba05fe63b230d BUG: 1206539 Signed-off-by: Raghavendra Talur <rtalur@redhat.com> Reviewed-on: http://review.gluster.org/11969 Reviewed-by: Humble Devassy Chirammal <humble.devassy@gmail.com> Reviewed-by: Prashanth Pai <ppai@redhat.com> Tested-by: Humble Devassy Chirammal <humble.devassy@gmail.com>
Diffstat (limited to 'done/GlusterFS 3.5/gfid access.md')
-rw-r--r--done/GlusterFS 3.5/gfid access.md89
1 files changed, 89 insertions, 0 deletions
diff --git a/done/GlusterFS 3.5/gfid access.md b/done/GlusterFS 3.5/gfid access.md
new file mode 100644
index 0000000..db64076
--- /dev/null
+++ b/done/GlusterFS 3.5/gfid access.md
@@ -0,0 +1,89 @@
+### Instructions
+
+**Feature**
+
+'gfid-access' translator to provide access to data in glusterfs using a virtual path.
+
+**1 Summary**
+
+This particular Translator is designed to provide direct access to files in glusterfs using its gfid.'GFID' is glusterfs's inode numbers for a file to identify it uniquely.
+
+**2 Owners**
+
+Amar Tumballi <atumball@redhat.com>
+Raghavendra G <rgowdapp@redhat.com>
+Anand Avati <aavati@redhat.com>
+
+**3 Current status**
+
+With glusterfs-3.4.0, glusterfs provides only path based access.A feature is added in 'fuse' layer in the current master branch,
+but its desirable to have it as a separate translator for long time
+maintenance.
+
+**4 Detailed Description**
+
+With this method, we can consume the data in changelog translator
+(which is logging 'gfid' internally) very efficiently.
+
+**5 Benefit to GlusterFS**
+
+Provides a way to access files quickly with direct gfid.
+
+​**6. Scope**
+
+6.1. Nature of proposed change
+
+* A new translator.
+* Fixes in 'glusterfsd.c' to add this translator automatically based
+on mount time option.
+* change to mount.glusterfs to parse this new option 
+(single digit number or lines changed)
+
+6.2. Implications on manageability
+
+* No CLI required.
+* mount.glusterfs script gets a new option.
+
+6.3. Implications on presentation layer
+
+* A new virtual access path is made available. But all access protocols work seemlessly, as the complexities are handled internally.
+
+6.4. Implications on persistence layer
+
+* None
+
+6.5. Implications on 'GlusterFS' backend
+
+* None
+
+6.6. Modification to GlusterFS metadata
+
+* None
+
+6.7. Implications on 'glusterd'
+
+* None
+
+7 How To Test
+
+* Mount glusterfs client with '-o aux-gfid-mount' and access files using '/mount/point/.gfid/ <actual-canonical-gfid-of-the-file>'.
+
+8 User Experience
+
+* A new virtual path available for users.
+
+9 Dependencies
+
+* None
+
+10 Documentation
+
+This wiki.
+
+11 Status
+
+Patch sent upstream. More review comments required. (http://review.gluster.org/5497)
+
+12 Comments and Discussion
+
+Please do give comments :-) \ No newline at end of file