ceph/man/ceph.8

.TH "CEPH" "8" "September 22, 2011" "dev" "Ceph"
.SH NAME
ceph \- ceph file system control utility
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.\" Man page generated from reStructeredText.
.
.SH SYNOPSIS
.nf
\fBceph\fP [ \-m \fImonaddr\fP ] [ \-w | \fIcommand\fP ... ]
.fi
.sp
.SH DESCRIPTION
.sp
\fBceph\fP is a control utility for communicating with the monitor
cluster of a running Ceph distributed file system.
.sp
There are three basic modes of operation.
.SS Interactive mode
.sp
To start in interactive mode, no arguments are necessary. Control\-d or
\(aqquit\(aq will exit.
.SS Watch mode
.sp
To watch cluster state changes in real time, starting in \-w (watch)
mode will print updates to stdout as they occur. For example, to keep
an eye on cluster state, run:
.sp
.nf
.ft C
ceph \-C ceph.conf \-w
.ft P
.fi
.SS Command line mode
.sp
Finally, to send a single instruction to the monitor cluster (and wait
for a response), the command can be specified on the command line.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-i infile
will specify an input file to be passed along as a payload with the
command to the monitor cluster. This is only used for specific
monitor commands.
.UNINDENT
.INDENT 0.0
.TP
.B \-o outfile
will write any payload returned by the monitor cluster with its
reply to outfile.  Only specific monitor commands (e.g. osd getmap)
return a payload.
.UNINDENT
.INDENT 0.0
.TP
.B \-c ceph.conf, \-\-conf=ceph.conf
Use ceph.conf configuration file instead of the default
/etc/ceph/ceph.conf to determine monitor addresses during startup.
.UNINDENT
.INDENT 0.0
.TP
.B \-m monaddress[:port]
Connect to specified monitor (instead of looking through ceph.conf).
.UNINDENT
.SH EXAMPLES
.sp
To grab a copy of the current OSD map:
.sp
.nf
.ft C
ceph \-m 1.2.3.4:6789 osd getmap \-o osdmap
.ft P
.fi
.sp
To get a dump of placement group (PG) state:
.sp
.nf
.ft C
ceph pg dump \-o pg.txt
.ft P
.fi
.SH MONITOR COMMANDS
.sp
A more complete summary of commands understood by the monitor cluster can be found in the
wiki, at
.INDENT 0.0
.INDENT 3.5
\fI\%http://ceph.newdream.net/wiki/Monitor_commands\fP
.UNINDENT
.UNINDENT
.SH AVAILABILITY
.sp
\fBceph\fP is part of the Ceph distributed file system. Please refer to the Ceph wiki at
\fI\%http://ceph.newdream.net/wiki\fP for more information.
.SH SEE ALSO
.sp
\fBceph\fP(8),
\fBmkcephfs\fP(8)
.SH COPYRIGHT
2011, New Dream Network
.\" Generated by docutils manpage writer.
.\" 
.