From: Greg Farnum <greg@inktank.com>
Date: Wed, 20 Feb 2013 02:00:44 +0000 (-0800)
Subject: doc: make the cephfs man page marginally more truthful
X-Git-Tag: v0.59~165
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=3692ccd696cd10fae9c2b28774dd7cb0d0ad3d2c;p=ceph.git

doc: make the cephfs man page marginally more truthful

Put it in the right place this time.

Signed-off-by: Greg Farnum <greg@inktank.com>
---

diff --git a/doc/man/8/cephfs.rst b/doc/man/8/cephfs.rst
index 42eff15833ab..f4d173d166c7 100644
--- a/doc/man/8/cephfs.rst
+++ b/doc/man/8/cephfs.rst
@@ -46,7 +46,7 @@ Setting options:
 
 .. option:: -c --stripe_count
 
-   Set the number of stripes per object
+   Set the number of objects to stripe across
 
 .. option:: -s --object_size
 
@@ -64,8 +64,8 @@ Setting options:
 Limitations
 ===========
 
-When setting layout data, the specified stripe unit and stripe count
-must multiply to the size of an object. Any parameters you don't set
+When setting layout data, the specified object size must evenly divide
+by the specified stripe unit. Any parameters you don't set
 explicitly are left at the system defaults.
 
 Obviously setting the layout of a file and a directory means different
@@ -79,9 +79,8 @@ directory (or any subdirectory).  Pre-existing files do not have their
 layouts changed.
 
 You'll notice that the layout information allows you to specify a
-preferred OSD for placement. This is allowed but is not recommended
-since it can dramatically unbalance your storage cluster's space
-utilization.
+preferred OSD for placement. This feature is unsupported and ignored
+in modern versions of the Ceph servers; do not use it.
 
 
 Availability