← Back to branch summary

~ubuntu-branches/ubuntu/precise/ceph/precise

« back to all changes in this revision

Viewing changes to man/cephfs.8

  • Committer: Bazaar Package Importer
  • Author(s): Clint Byrum, Clint Byrum, Micah Gersten
  • Date: 2011-02-12 22:50:26 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20110212225026-yyyw4tk0msgql3ul
Tags: 0.24.2-0ubuntu1
https://launchpad.net/bugs/658670
https://launchpad.net/bugs/684011
[ Clint Byrum <clint@ubuntu.com> ]
* New upstream release. (LP: #658670, LP: #684011)
* debian/patches/fix-mkcephfs.patch: dropped (applied upstream)
* Removed .la files from libceph1-dev, libcrush1-dev and 
  librados1-dev (per Debian policy v3.9.1 10.2).
* debian/control: adding pkg-config as a build dependency
* debian/control: depend on libcrypto++-dev instead of libssl-dev
* debian/watch: added watch file

[ Micah Gersten <micahg@ubuntu.com> ]
* debian/control: add Homepage

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/cephfs.8
 
1
.TH CEPHFS 8
 
2
.SH NAME
 
3
cephfs \- ceph file system options utility
 
4
.SH SYNOPSIS
 
5
.B cephfs
 
6
[ \fIpath \fIcommand \fBoptions]
 
7
.SH DESCRIPTION
 
8
.B cephfs
 
9
is a control utility for accessing and manipulating file layout
 
10
and location data in the Ceph distributed file system.
 
11
 
 
12
Choose one of the following three commands:
 
13
.TP
 
14
\fBshow_layout \fPView the layout information on a file or directory
 
15
.TP
 
16
\fBset_layout  \fPSet the layout information on a file or directory.
 
17
.TP
 
18
\fBshow_location \fPView the location information on a file
 
19
 
 
20
.SH OPTIONS
 
21
Your applicable options differ depending on whether you are setting
 
22
or viewing layout/location.
 
23
.TP
 
24
\fBViewing options:
 
25
.IP
 
26
\fB\-l \--offset
 
27
\fPSpecify an offset for which to retrieve location data
 
28
 
 
29
.TP
 
30
\fBSetting options:
 
31
.IP
 
32
\fB\-u
 
33
\--stripe_unit \fP
 
34
Set the size of each stripe
 
35
.IP
 
36
\fB\-c
 
37
\--stripe_count \fP
 
38
Set the number of stripes per object
 
39
.IP
 
40
\fB\-s
 
41
\--object_size \fP
 
42
Set the size of the objects to stripe across
 
43
.IP
 
44
\fB\-p
 
45
\--pool \fP
 
46
Set the pool (by numeric value, not name!) to use
 
47
.IP
 
48
\fB\-o
 
49
\--osd \fP
 
50
Set the preferred OSD to use as the primary
 
51
 
 
52
.SH LIMITATIONS
 
53
When setting layout data, the specified stripe unit and stripe count
 
54
must multiply to the size of an object. Any parameters you don't set explicitly are left at the system defaults.
 
55
 
 
56
Obviously setting the layout of a file and a directory means different things.
 
57
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.
 
58
 
 
59
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.
 
60
 
 
61
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.
 
62
 
 
63
.SH AVAILABILITY
 
64
.B cephfs
 
65
is part of the Ceph distributed file system.  Please refer to the Ceph wiki at
 
66
http://ceph.newdream.net/wiki for more information.
 
67
.SH SEE ALSO
 
68
.BR ceph (8)