mirror of https://github.com/ceph/ceph
99 lines
2.4 KiB
ReStructuredText
99 lines
2.4 KiB
ReStructuredText
============================================
|
|
cephfs -- ceph file system options utility
|
|
============================================
|
|
|
|
.. program:: cephfs
|
|
|
|
Synopsis
|
|
========
|
|
|
|
| **cephfs** [ *path* *command* *options* ]
|
|
|
|
|
|
Description
|
|
===========
|
|
|
|
**cephfs** is a control utility for accessing and manipulating file
|
|
layout and location data in the Ceph distributed file system.
|
|
|
|
.. TODO format this like a proper man page
|
|
|
|
Choose one of the following three commands:
|
|
|
|
- ``show_layout`` View the layout information on a file or directory
|
|
- ``set_layout`` Set the layout information on a file or directory
|
|
- ``show_location`` View the location information on a file
|
|
|
|
|
|
Options
|
|
=======
|
|
|
|
Your applicable options differ depending on whether you are setting or viewing layout/location.
|
|
|
|
Viewing options:
|
|
----------------
|
|
|
|
.. option:: -l --offset
|
|
|
|
Specify an offset for which to retrieve location data
|
|
|
|
Setting options:
|
|
----------------
|
|
|
|
.. option:: -u --stripe_unit
|
|
|
|
Set the size of each stripe
|
|
|
|
.. option:: -c --stripe_count
|
|
|
|
Set the number of stripes per object
|
|
|
|
.. option:: -s --object_size
|
|
|
|
Set the size of the objects to stripe across
|
|
|
|
.. option:: -p --pool
|
|
|
|
Set the pool (by numeric value, not name!) to use
|
|
|
|
.. option:: -o --osd
|
|
|
|
Set the preferred OSD to use as the primary
|
|
|
|
|
|
Limitations
|
|
===========
|
|
|
|
When setting layout data, the specified stripe unit and stripe count
|
|
must multiply to the size of an object. Any parameters you don't set
|
|
explicitly are left at the system defaults.
|
|
|
|
Obviously setting the layout of a file and a directory means different
|
|
things. Setting the layout of a file specifies exactly how to place
|
|
the individual file. This must be done before writing *any* data to
|
|
it. Truncating a file does not allow you to change the layout either.
|
|
|
|
Setting the layout of a directory sets the "default layout", which is
|
|
used to set the file layouts on any files subsequently created in the
|
|
directory (or any subdirectory). Pre-existing files do not have their
|
|
layouts changed.
|
|
|
|
You'll notice that the layout information allows you to specify a
|
|
preferred OSD for placement. This is allowed but is not recommended
|
|
since it can dramatically unbalance your storage cluster's space
|
|
utilization.
|
|
|
|
|
|
Availability
|
|
============
|
|
|
|
**cephfs** is part of the Ceph distributed file system. Please refer
|
|
to the Ceph documentation at http://ceph.com/docs for more
|
|
information.
|
|
|
|
|
|
See also
|
|
========
|
|
|
|
:doc:`ceph <ceph>`\(8)
|