doc: warn about how 'rados put' works in the manpage

Signed-off-by: Greg Farnum <gfarnum@redhat.com>

diff --git a/doc/man/8/rados.rst b/doc/man/8/rados.rst
index 4357fbf54548313782666b68e103bbb5f4503503..63fdc23f97202ee78f958406bc59b1d24a1ab4e0 100644 (file)
--- a/doc/man/8/rados.rst
+++ b/doc/man/8/rados.rst
@@ -90,6 +90,9 @@ Pool specific commands
 
 :command:`put` *name* *infile* [--offset offset]
   Write object name with start offset (default:0) to the cluster with contents from infile.
+  **Warning:** The put command creates a single RADOS object, sized just as
+  large as your input file. Unless your objects are of reasonable and consistent sizes, that
+  is probably not what you want -- consider using RGW/S3, CephFS, or RBD instead.
 
 :command:`append` *name* *infile*
   Append object name to the cluster with contents from infile.