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

72 lines
2.0 KiB
ReStructuredText

:orphan:
====================================================
mount.fuse.ceph -- mount ceph-fuse from /etc/fstab.
====================================================
.. program:: mount.fuse.ceph
Synopsis
========
| **mount.fuse.ceph** [-h] [-o OPTIONS [*OPTIONS* ...]]
device [*device* ...]
mountpoint [*mountpoint* ...]
Description
===========
**mount.fuse.ceph** is a helper for mounting ceph-fuse from
``/etc/fstab``.
To use mount.fuse.ceph, add an entry in ``/etc/fstab`` like::
DEVICE PATH TYPE OPTIONS
none /mnt/ceph fuse.ceph ceph.id=admin,_netdev,defaults 0 0
none /mnt/ceph fuse.ceph ceph.name=client.admin,_netdev,defaults 0 0
none /mnt/ceph fuse.ceph ceph.id=myuser,ceph.conf=/etc/ceph/foo.conf,_netdev,defaults 0 0
ceph-fuse options are specified in the ``OPTIONS`` column and must begin
with '``ceph.``' prefix. This way ceph related fs options will be passed to
ceph-fuse and others will be ignored by ceph-fuse.
Options
=======
.. option:: ceph.id=<username>
Specify that the ceph-fuse will authenticate as the given user.
.. option:: ceph.name=client.admin
Specify that the ceph-fuse will authenticate as client.admin
.. option:: ceph.conf=/etc/ceph/foo.conf
Sets 'conf' option to /etc/ceph/foo.conf via ceph-fuse command line.
Any valid ceph-fuse options can be passed this way.
Additional Info
===============
The old format /etc/fstab entries are also supported::
DEVICE PATH TYPE OPTIONS
id=admin /mnt/ceph fuse.ceph defaults 0 0
id=myuser,conf=/etc/ceph/foo.conf /mnt/ceph fuse.ceph defaults 0 0
Availability
============
**mount.fuse.ceph** is part of Ceph, a massively scalable, open-source, distributed storage system. Please
refer to the Ceph documentation at https://docs.ceph.com for more
information.
See also
========
:doc:`ceph-fuse <ceph-fuse>`\(8),
:doc:`ceph <ceph>`\(8)