3 ========================================
4 mount.ceph -- mount a ceph file system
5 ========================================
7 .. program:: mount.ceph
12 | **mount.ceph** *monaddr1*\ [,\ *monaddr2*\ ,...]:/[*subdir*] *dir* [
19 **mount.ceph** is a simple helper for mounting the Ceph file system on
20 a Linux host. It serves to resolve monitor hostname(s) into IP
21 addresses and read authentication keys from disk; the Linux kernel
22 client component does most of the real work. In fact, it is possible
23 to mount a non-authenticated Ceph file system without mount.ceph by
24 specifying monitor address(es) by IP::
26 mount -t ceph 1.2.3.4:/ mountpoint
28 Each monitor address monaddr takes the form host[:port]. If the port
29 is not specified, the Ceph default of 6789 is assumed.
31 Multiple monitor addresses can be separated by commas. Only one
32 responsible monitor is needed to successfully mount; the client will
33 learn about all monitors from any responsive monitor. However, it is a
34 good idea to specify more than one in case one happens to be down at
37 A subdirectory subdir may be specified if a subset of the file system
40 Mount helper application conventions dictate that the first two
41 options are device to be mounted and destination path. Options must be
42 passed only after these fixed arguments.
49 int (bytes), max write size. Default: none (writeback uses smaller of wsize
53 int (bytes), max read size. Default: none
56 int (bytes), max readahead, multiple of 1024, Default: 8388608
60 int (seconds), Default: 60
62 :command:`osdkeepalive`
65 :command:`mount_timeout`
66 int (seconds), Default: 60
68 :command:`osd_idle_ttl`
69 int (seconds), Default: 60
71 :command:`caps_wanted_delay_min`
72 int, cap release delay, Default: 5
74 :command:`caps_wanted_delay_max`
75 int, cap release delay, Default: 60
77 :command:`cap_release_safety`
78 int, Default: calculated
80 :command:`readdir_max_entries`
83 :command:`readdir_max_bytes`
84 int, Default: 524288 (512*1024)
86 :command:`write_congestion_kb`
87 int (kb), max writeback in flight. scale with available
88 memory. Default: calculated from available memory
90 :command:`snapdirname`
91 string, set the name of the hidden snapdir. Default: .snap
94 RADOS user to authenticate as when using cephx. Default: guest
97 secret key for use with cephx. This option is insecure because it exposes
98 the secret on the command line. To avoid this, use the secretfile option.
100 :command:`secretfile`
101 path to file containing the secret key to use with cephx
107 create a new client instance, instead of sharing an existing
108 instance of a client mounting the same cluster
111 funky `cat dirname` for stats, Default: off
114 no funky `cat dirname` for stats
117 Report the recursive size of the directory contents for st_size on
118 directories. Default: on
121 Do not report the recursive size of the directory contents for
122 st_size on directories.
125 no data crc on writes
127 :command:`noasyncreaddir`
134 Mount the full file system::
136 mount.ceph monhost:/ /mnt/foo
138 If there are multiple monitors::
140 mount.ceph monhost1,monhost2,monhost3:/ /mnt/foo
142 If :doc:`ceph-mon <ceph-mon>`\(8) is running on a non-standard
145 mount.ceph monhost1:7000,monhost2:7000,monhost3:7000:/ /mnt/foo
147 To mount only part of the namespace::
149 mount.ceph monhost1:/some/small/thing /mnt/thing
151 Assuming mount.ceph(8) is installed properly, it should be
152 automatically invoked by mount(8) like so::
154 mount -t ceph monhost:/ /mnt/foo
160 **mount.ceph** is part of Ceph, a massively scalable, open-source, distributed storage system. Please
161 refer to the Ceph documentation at http://ceph.com/docs for more
167 :doc:`ceph-fuse <ceph-fuse>`\(8),
168 :doc:`ceph <ceph>`\(8)