]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc: Added fuse syntax to the fstab doc.
authorJohn Wilkins <john.wilkins@inktank.com>
Fri, 17 May 2013 06:10:32 +0000 (23:10 -0700)
committerJohn Wilkins <john.wilkins@inktank.com>
Fri, 17 May 2013 06:10:32 +0000 (23:10 -0700)
fixes: #3672

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
doc/cephfs/fstab.rst

index b61cd1fcadf21673f06cf52fb5e8e868047a827f..b16654cfec07f0736d9f503a015ede1e7aa823f4 100644 (file)
@@ -3,7 +3,12 @@
 ==========================================
 
 If you mount Ceph FS in your file systems table, the Ceph file system will mount 
-automatically on startup. To mount Ceph FS in your file systems table, add the 
+automatically on startup. 
+
+Kernel Driver
+=============
+
+To mount Ceph FS in your file systems table as a kernel driver, add the
 following to ``/etc/fstab``::
 
        {ipaddress}:{port}:/ {mount}/{mountpoint} {filesystem-name}     [name=username,secret=secretkey|secretfile=/path/to/secretfile],[{mount.options}]
@@ -13,7 +18,30 @@ For example::
        10.10.10.10:6789:/     /mnt/ceph    ceph    name=admin,secretfile=/etc/ceph/secret.key,noatime    0       2
        
 .. important:: The ``name`` and ``secret`` or ``secretfile`` options are 
-   mandatory when you have Ceph authentication running. See `Authentication`_
-   for details.
+   mandatory when you have Ceph authentication running. 
+See `Authentication`_ for details. 
+   
    
-   .. _Authentication: ../../rados/operations/authentication/
\ No newline at end of file
+FUSE
+====
+
+To mount Ceph FS in your file systems table as a filesystem in user space, add the
+following to ``/etc/fstab``::
+
+       #DEVICE                                  PATH         TYPE      OPTIONS
+       id={user-ID}[,conf={path/to/conf.conf}] /mount/path  fuse.ceph defaults 0 0
+
+For example::
+
+       id=admin  /mnt/ceph  fuse.ceph defaults 0 0 
+       id=myuser,conf=/etc/ceph/cluster.conf  /mnt/ceph2  fuse.ceph defaults 0 0 
+
+The ``DEVICE`` field is a comma-delimited list of options to pass to the command line.
+Ensure you use the ID (e.g., ``admin``, not ``client.admin``). You can pass any valid 
+``ceph-fuse`` option to the command line this way.
+
+See `Authentication`_ for details. 
+
+
+.. _Authentication: ../../rados/operations/authentication/