mirror of
https://github.com/ceph/ceph
synced 2024-12-25 04:43:17 +00:00
92fa2ff8fc
Keeping the generated files in version control lets us support builds from scratch without requiring the full documentation toolchain to be installed. The files were just copied over from build-doc/output/man, after a ./admin/build-doc call. When redoing this, also take care to remove any roff output if a file was removed from doc/man, and update Makefile.am. Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>
128 lines
2.9 KiB
Groff
128 lines
2.9 KiB
Groff
.TH "CEPH" "8" "September 09, 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.
|
|
.\"
|
|
.
|