-.TH "CEPH-AUTHTOOL" "8" "December 29, 2012" "dev" "Ceph"
+.TH "CEPH-AUTHTOOL" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
ceph-authtool \- ceph keyring manipulation tool
.
superuser permissions for the given subsystem.
.sp
For example:
-.INDENT 0.0
-.INDENT 3.5
.sp
.nf
.ft C
mon = "allow rwx"
.ft P
.fi
-.UNINDENT
-.UNINDENT
.sp
A librados user restricted to a single pool might look like:
-.INDENT 0.0
-.INDENT 3.5
.sp
.nf
.ft C
osd = "allow rw pool foo"
.ft P
.fi
-.UNINDENT
-.UNINDENT
.sp
A client using rbd with read access to one pool and read/write access to another:
-.INDENT 0.0
-.INDENT 3.5
.sp
.nf
.ft C
osd = "allow class\-read object_prefix rbd_children, allow pool templates r class\-read, allow pool vms rwx"
.ft P
.fi
-.UNINDENT
-.UNINDENT
.sp
A client mounting the file system with minimal permissions would need caps like:
-.INDENT 0.0
-.INDENT 3.5
.sp
.nf
.ft C
mon = "allow r"
.ft P
.fi
-.UNINDENT
-.UNINDENT
.SH OSD CAPABILITIES
.sp
In general, an osd capability follows the grammar:
-.INDENT 0.0
-.INDENT 3.5
.sp
.nf
.ft C
capspec := * | [r][w][x] [class\-read] [class\-write]
.ft P
.fi
-.UNINDENT
-.UNINDENT
.sp
The capspec determines what kind of operations the entity can perform:
-.INDENT 0.0
-.INDENT 3.5
.sp
.nf
.ft C
i.e. ceph osd tell ...
.ft P
.fi
-.UNINDENT
-.UNINDENT
.sp
The match criteria restrict a grant based on the pool being accessed.
Grants are additive if the client fulfills the match condition. For
.SH EXAMPLE
.sp
To create a new keyring containing a key for client.foo:
-.INDENT 0.0
-.INDENT 3.5
.sp
.nf
.ft C
ceph\-authtool \-C \-n client.foo \-\-gen\-key keyring
.ft P
.fi
-.UNINDENT
-.UNINDENT
.sp
To associate some capabilities with the key (namely, the ability to
mount a Ceph filesystem):
-.INDENT 0.0
-.INDENT 3.5
.sp
.nf
.ft C
ceph\-authtool \-n client.foo \-\-cap mds \(aqallow\(aq \-\-cap osd \(aqallow rw pool=data\(aq \-\-cap mon \(aqallow r\(aq keyring
.ft P
.fi
-.UNINDENT
-.UNINDENT
.sp
To display the contents of the keyring:
-.INDENT 0.0
-.INDENT 3.5
.sp
.nf
.ft C
ceph\-authtool \-l keyring
.ft P
.fi
-.UNINDENT
-.UNINDENT
.sp
When mount a Ceph file system, you can grab the appropriately encoded secret key with:
-.INDENT 0.0
-.INDENT 3.5
.sp
.nf
.ft C
mount \-t ceph serverhost:/ mountpoint \-o name=foo,secret=\(gaceph\-authtool \-p \-n client.foo keyring\(ga
.ft P
.fi
-.UNINDENT
-.UNINDENT
.SH AVAILABILITY
.sp
\fBceph\-authtool\fP is part of the Ceph distributed file system. Please
.sp
\fBceph\fP(8)
.SH COPYRIGHT
-2010-2012, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "CEPH-CLSINFO" "8" "September 27, 2012" "dev" "Ceph"
+.TH "CEPH-CLSINFO" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
ceph-clsinfo \- show class object information
.
.sp
\fBceph\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "CEPH-CONF" "8" "September 27, 2012" "dev" "Ceph"
+.TH "CEPH-CONF" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
ceph-conf \- ceph conf file tool
.
\fBceph\fP(8),
\fBmkcephfs\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "CEPH-DEBUGPACK" "8" "October 19, 2012" "dev" "Ceph"
+.TH "CEPH-DEBUGPACK" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
ceph-debugpack \- ceph debug packer utility
.
.sp
\fBceph\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "CEPH-DENCODER" "8" "September 27, 2012" "dev" "Ceph"
+.TH "CEPH-DENCODER" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
ceph-dencoder \- ceph encoder/decoder utility
.
.sp
\fBceph\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "CEPH-FUSE" "8" "September 27, 2012" "dev" "Ceph"
+.TH "CEPH-FUSE" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
ceph-fuse \- FUSE-based client for ceph
.
fusermount(8),
\fBceph\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "CEPH-MDS" "8" "September 27, 2012" "dev" "Ceph"
+.TH "CEPH-MDS" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
ceph-mds \- ceph metadata server daemon
.
\fBceph\-mon\fP(8),
\fBceph\-osd\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "CEPH-MON" "8" "September 27, 2012" "dev" "Ceph"
+.TH "CEPH-MON" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
ceph-mon \- ceph monitor daemon
.
\fBceph\-mds\fP(8),
\fBceph\-osd\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "CEPH-OSD" "8" "September 27, 2012" "dev" "Ceph"
+.TH "CEPH-OSD" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
ceph-osd \- ceph object storage daemon
.
\fBceph\-mon\fP(8),
\fBceph\-authtool\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "CEPH-RBDNAMER" "8" "September 27, 2012" "dev" "Ceph"
+.TH "CEPH-RBDNAMER" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
ceph-rbdnamer \- udev helper to name RBD devices
.
\fBrbd\fP(8),
\fBceph\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "CEPH-RUN" "8" "September 27, 2012" "dev" "Ceph"
+.TH "CEPH-RUN" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
ceph-run \- restart daemon on core dump
.
\fBceph\-mds\fP(8),
\fBceph\-osd\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "CEPH-SYN" "8" "September 27, 2012" "dev" "Ceph"
+.TH "CEPH-SYN" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
ceph-syn \- ceph synthetic workload generator
.
\fBceph\fP(8),
\fBceph\-fuse\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "CEPH" "8" "October 19, 2012" "dev" "Ceph"
+.TH "CEPH" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
ceph \- ceph file system control utility
.
\fBceph\fP(8),
\fBmkcephfs\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "CEPHFS" "8" "September 27, 2012" "dev" "Ceph"
+.TH "CEPHFS" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
cephfs \- ceph file system options utility
.
You\(aqll notice that the layout information allows you to specify a
preferred OSD for placement. This feature is unsupported and ignored
in modern versions of the Ceph servers; do not use it.
-
.SH AVAILABILITY
.sp
\fBcephfs\fP is part of the Ceph distributed file system. Please refer
.sp
\fBceph\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "LIBRADOS-CONFIG" "8" "September 27, 2012" "dev" "Ceph"
+.TH "LIBRADOS-CONFIG" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
librados-config \- display information about librados
.
\fBceph\fP(8),
\fBrados\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "MONMAPTOOL" "8" "September 27, 2012" "dev" "Ceph"
+.TH "MONMAPTOOL" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
monmaptool \- ceph monitor cluster map manipulation tool
.
\fBcrushtool\fP(8),
\fBmkcephfs\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "MOUNT.CEPH" "8" "September 27, 2012" "dev" "Ceph"
+.TH "MOUNT.CEPH" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
mount.ceph \- mount a ceph file system
.
\fBceph\-fuse\fP(8),
\fBceph\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "OSDMAPTOOL" "8" "September 27, 2012" "dev" "Ceph"
+.TH "OSDMAPTOOL" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
osdmaptool \- ceph osd cluster map manipulation tool
.
\fBcrushtool\fP(8),
\fBmkcephfs\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "RADOSGW-ADMIN" "8" "October 15, 2012" "dev" "Ceph"
+.TH "RADOSGW-ADMIN" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
radosgw-admin \- rados REST gateway user administration utility
.
.sp
\fBceph\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "RADOSGW" "8" "September 27, 2012" "dev" "Ceph"
+.TH "RADOSGW" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
radosgw \- rados REST gateway
.
\fBceph\fP(8)
\fBradosgw\-admin\fP(8)
.SH COPYRIGHT
-2012, Inktank Storage, Inc.
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.
-.TH "RBD-FUSE" "8" "January 31, 2013" "dev" "Ceph"
+.TH "RBD-FUSE" "8" "April 29, 2013" "dev" "Ceph"
.SH NAME
rbd-fuse \- expose rbd images as files
.
fusermount(8),
\fBrbd\fP(8)
.SH COPYRIGHT
-2010-2012, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
+2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
.\" Generated by docutils manpage writer.
.