ceph/doc/man/8/mount.fuse.ceph.rst

   1 :orphan:
   2
   3 ====================================================
   4  mount.fuse.ceph -- mount ceph-fuse from /etc/fstab.
   5 ====================================================
   6
   7 .. program:: mount.fuse.ceph
   8
   9 Synopsis
  10 ========
  11
  12 | **mount.fuse.ceph** [-h] [-o OPTIONS [*OPTIONS* ...]]
  13                       device [*device* ...]
  14                       mountpoint [*mountpoint* ...]
  15
  16 Description
  17 ===========
  18
  19 **mount.fuse.ceph** is a helper for mounting ceph-fuse from
  20 ``/etc/fstab``.
  21
  22 To use mount.fuse.ceph, add an entry in ``/etc/fstab`` like::
  23
  24   DEVICE    PATH        TYPE        OPTIONS
  25   none      /mnt/ceph   fuse.ceph   ceph.id=admin,_netdev,defaults  0 0
  26   none      /mnt/ceph   fuse.ceph   ceph.name=client.admin,_netdev,defaults  0 0
  27   none      /mnt/ceph   fuse.ceph   ceph.id=myuser,ceph.conf=/etc/ceph/foo.conf,_netdev,defaults  0 0
  28
  29 ceph-fuse options are specified in the ``OPTIONS`` column and must begin
  30 with ``ceph.`` prefix. This way ceph related fs options will be passed to
  31 ceph-fuse and others will be ignored by ceph-fuse.
  32
  33 Options
  34 =======
  35
  36 .. option:: ceph.id=<username>
  37
  38    Specify that the ceph-fuse will authenticate as the given user.
  39
  40 .. option:: ceph.name=client.admin
  41
  42    Specify that the ceph-fuse will authenticate as client.admin
  43
  44 .. option:: ceph.conf=/etc/ceph/foo.conf
  45
  46    Sets 'conf' option to /etc/ceph/foo.conf via ceph-fuse command line.
  47
  48
  49 Any valid ceph-fuse options can be passed this way.
  50
  51 Additional Info
  52 ===============
  53
  54 The old format /etc/fstab entries are also supported::
  55
  56   DEVICE                              PATH        TYPE        OPTIONS
  57   id=admin                            /mnt/ceph   fuse.ceph   defaults   0 0
  58   id=myuser,conf=/etc/ceph/foo.conf   /mnt/ceph   fuse.ceph   defaults   0 0
  59
  60 Availability
  61 ============
  62
  63 **mount.fuse.ceph** is part of Ceph, a massively scalable, open-source, distributed storage system. Please
  64 refer to the Ceph documentation at http://ceph.com/docs for more
  65 information.
  66
  67 See also
  68 ========
  69
  70 :doc:`ceph-fuse <ceph-fuse>`\(8),
  71 :doc:`ceph <ceph>`\(8)