mirror of https://github.com/ceph/ceph
62 lines
2.0 KiB
Groff
62 lines
2.0 KiB
Groff
.TH CEPH 8
|
|
.SH NAME
|
|
ceph \- ceph file system control utility
|
|
.SH SYNOPSIS
|
|
.B ceph
|
|
[ \fB\-m\fI monaddr\fR ]
|
|
[ \fB\-w\fP | \fIcommand ...\fR ]
|
|
.SH DESCRIPTION
|
|
.B ceph
|
|
is a control utility for communicating with the monitor cluster of a running
|
|
Ceph distributed file system.
|
|
.PP
|
|
There are three basic modes of operation.
|
|
.SH INTERACTIVE MODE
|
|
To start in interactive
|
|
mode, no arguments are necessary. Control-d or 'quit' will exit.
|
|
.SH WATCH MODE
|
|
To watch cluster state changes in real time,
|
|
starting in \fB\-w\fP (watch) mode will print updates to stdout as they occur. For example,
|
|
to keep an eye on cluster state,
|
|
.IP
|
|
ceph -C cluster.conf -w
|
|
.SH COMMAND LINE MODE
|
|
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
|
|
.TP
|
|
\fB\-i \fIinfile\fP
|
|
will specify an input file to be passed along as a payload with the \fIcommand\fP to the
|
|
monitor cluster. This is only used for specific monitor commands.
|
|
.TP
|
|
\fB\-o \fIoutfile\fP
|
|
will write any payload returned by the monitor cluster with its reply to \fIoutfile\fP.
|
|
Only specific monitor commands (e.g. \fIosd getmap\fP) return a payload.
|
|
.TP
|
|
\fB\-C\fI cluster.conf\fR, \fB\-\-cluster-conf=\fIcluster.conf\fR
|
|
Use \fIcluster.conf\fP cluster configuration file instead of the default \fI/etc/ceph/cluster.conf\fP
|
|
to determine monitor addresses during startup.
|
|
.TP
|
|
\fB\-m\fI monaddress[:port]\fR
|
|
Connect to specified monitor (instead of looking through \fIcluster.conf\fR).
|
|
.SH EXAMPLES
|
|
To grab a copy of the current OSD map:
|
|
.IP
|
|
ceph -m 1.2.3.4:6789 osd getmap -o osdmap
|
|
.PP
|
|
To get a dump of placement group (PG) state:
|
|
.IP
|
|
ceph pg dump -o pg.txt
|
|
.SH MONITOR COMMANDS
|
|
A more complete summary of commands understood by the monitor cluster can be found
|
|
in the wiki, at
|
|
.IP
|
|
http://ceph.newdream.net/wiki/Monitor_commands
|
|
.SH AVAILABILITY
|
|
.B ceph
|
|
is part of the Ceph distributed file system. Please refer to the Ceph wiki at
|
|
http://ceph.newdream.net/wiki for more information.
|
|
.SH SEE ALSO
|
|
.BR ceph (8),
|
|
.BR mkcephfs (8)
|