From 71a86057622a54a671a1fbfc8e1c28ed130492de Mon Sep 17 00:00:00 2001 From: Greg Farnum Date: Wed, 2 Jan 2019 15:00:25 -0800 Subject: [PATCH] doc: warn about how 'rados put' works in the manpage Signed-off-by: Greg Farnum --- doc/man/8/rados.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/doc/man/8/rados.rst b/doc/man/8/rados.rst index 4357fbf545483..63fdc23f97202 100644 --- 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.