mirror of https://github.com/ceph/ceph
207 lines
4.8 KiB
Groff
207 lines
4.8 KiB
Groff
.TH "MOUNT.CEPH" "8" "April 29, 2013" "dev" "Ceph"
|
|
.SH NAME
|
|
mount.ceph \- mount a ceph file system
|
|
.
|
|
.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 reStructuredText.
|
|
.
|
|
.SH SYNOPSIS
|
|
.nf
|
|
\fBmount.ceph\fP \fImonaddr1\fP[,\fImonaddr2\fP,...]:/[\fIsubdir\fP] \fIdir\fP [
|
|
\-o \fIoptions\fP ]
|
|
.fi
|
|
.sp
|
|
.SH DESCRIPTION
|
|
.sp
|
|
\fBmount.ceph\fP is a simple helper for mounting the Ceph file system on
|
|
a Linux host. It serves to resolve monitor hostname(s) into IP
|
|
addresses and read authentication keys from disk; the Linux kernel
|
|
client component does most of the real work. In fact, it is possible
|
|
to mount a non\-authenticated Ceph file system without mount.ceph by
|
|
specifying monitor address(es) by IP:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
mount \-t ceph 1.2.3.4:/ mountpoint
|
|
.ft P
|
|
.fi
|
|
.sp
|
|
Each monitor address monaddr takes the form host[:port]. If the port
|
|
is not specified, the Ceph default of 6789 is assumed.
|
|
.sp
|
|
Multiple monitor addresses can be separated by commas. Only one
|
|
responsible monitor is needed to successfully mount; the client will
|
|
learn about all monitors from any responsive monitor. However, it is a
|
|
good idea to specify more than one in case one happens to be down at
|
|
the time of mount.
|
|
.sp
|
|
A subdirectory subdir may be specified if a subset of the file system
|
|
is to be mounted.
|
|
.sp
|
|
Mount helper application conventions dictate that the first two
|
|
options are device to be mounted and destination path. Options must be
|
|
passed only after these fixed arguments.
|
|
.SH OPTIONS
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \fBwsize\fP
|
|
int, max write size. Default: none (writeback uses smaller of wsize
|
|
and stripe unit)
|
|
.TP
|
|
.B \fBrsize\fP
|
|
int (bytes), max readahead, multiple of 1024, Default: 524288
|
|
(512*1024)
|
|
.TP
|
|
.B \fBosdtimeout\fP
|
|
int (seconds), Default: 60
|
|
.TP
|
|
.B \fBosdkeepalivetimeout\fP
|
|
int, Default: 5
|
|
.TP
|
|
.B \fBmount_timeout\fP
|
|
int (seconds), Default: 60
|
|
.TP
|
|
.B \fBosd_idle_ttl\fP
|
|
int (seconds), Default: 60
|
|
.TP
|
|
.B \fBcaps_wanted_delay_min\fP
|
|
int, cap release delay, Default: 5
|
|
.TP
|
|
.B \fBcaps_wanted_delay_max\fP
|
|
int, cap release delay, Default: 60
|
|
.TP
|
|
.B \fBcap_release_safety\fP
|
|
int, Default: calculated
|
|
.TP
|
|
.B \fBreaddir_max_entries\fP
|
|
int, Default: 1024
|
|
.TP
|
|
.B \fBreaddir_max_bytes\fP
|
|
int, Default: 524288 (512*1024)
|
|
.TP
|
|
.B \fBwrite_congestion_kb\fP
|
|
int (kb), max writeback in flight. scale with available
|
|
memory. Default: calculated from available memory
|
|
.TP
|
|
.B \fBsnapdirname\fP
|
|
string, set the name of the hidden snapdir. Default: .snap
|
|
.TP
|
|
.B \fBname\fP
|
|
RADOS user to authenticate as when using cephx. Default: guest
|
|
.TP
|
|
.B \fBsecret\fP
|
|
secret key for use with cephx. This option is insecure because it exposes
|
|
the secret on the command line. To avoid this, use the secretfile option.
|
|
.TP
|
|
.B \fBsecretfile\fP
|
|
path to file containing the secret key to use with cephx
|
|
.TP
|
|
.B \fBip\fP
|
|
my ip
|
|
.TP
|
|
.B \fBnoshare\fP
|
|
create a new client instance, instead of sharing an existing
|
|
instance of a client mounting the same cluster
|
|
.TP
|
|
.B \fBdirstat\fP
|
|
funky \fIcat dirname\fP for stats, Default: off
|
|
.TP
|
|
.B \fBnodirstat\fP
|
|
no funky \fIcat dirname\fP for stats
|
|
.TP
|
|
.B \fBrbytes\fP
|
|
Report the recursive size of the directory contents for st_size on
|
|
directories. Default: on
|
|
.TP
|
|
.B \fBnorbytes\fP
|
|
Do not report the recursive size of the directory contents for
|
|
st_size on directories.
|
|
.TP
|
|
.B \fBnocrc\fP
|
|
no data crc on writes
|
|
.TP
|
|
.B \fBnoasyncreaddir\fP
|
|
no dcache readdir
|
|
.UNINDENT
|
|
.SH EXAMPLES
|
|
.sp
|
|
Mount the full file system:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
mount.ceph monhost:/ /mnt/foo
|
|
.ft P
|
|
.fi
|
|
.sp
|
|
If there are multiple monitors:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
mount.ceph monhost1,monhost2,monhost3:/ /mnt/foo
|
|
.ft P
|
|
.fi
|
|
.sp
|
|
If \fBceph\-mon\fP(8) is running on a non\-standard
|
|
port:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
mount.ceph monhost1:7000,monhost2:7000,monhost3:7000:/ /mnt/foo
|
|
.ft P
|
|
.fi
|
|
.sp
|
|
To mount only part of the namespace:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
mount.ceph monhost1:/some/small/thing /mnt/thing
|
|
.ft P
|
|
.fi
|
|
.sp
|
|
Assuming mount.ceph(8) is installed properly, it should be
|
|
automatically invoked by mount(8) like so:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
mount \-t ceph monhost:/ /mnt/foo
|
|
.ft P
|
|
.fi
|
|
.SH AVAILABILITY
|
|
.sp
|
|
\fBmount.ceph\fP is part of the Ceph distributed file system. Please
|
|
refer to the Ceph documentation at \fI\%http://ceph.com/docs\fP for more
|
|
information.
|
|
.SH SEE ALSO
|
|
.sp
|
|
\fBceph\-fuse\fP(8),
|
|
\fBceph\fP(8)
|
|
.SH COPYRIGHT
|
|
2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
|
|
.\" Generated by docutils manpage writer.
|
|
.
|