mirror of https://github.com/ceph/ceph
128 lines
2.9 KiB
Groff
128 lines
2.9 KiB
Groff
.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.
|
|
.\"
|
|
.
|