ceph/doc/man/8/ceph-post-file.rst
John Wilkins 4c5b3c7bee doc: Syntax fix to suppress gitbuilder errors.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-09-09 15:30:19 -07:00

70 lines
1.8 KiB
ReStructuredText

==================================================
ceph-post-file -- post files for ceph developers
==================================================
.. program:: ceph-post-file
Synopsis
========
| **ceph-post-file** [-d *description] [-u *user*] *file or dir* ...
Description
===========
**ceph-post-file** will upload files or directories to ceph.com for
later analysis by Ceph developers.
Each invocation uploads files or directories to a separate directory
with a unique tag. That tag can be passed to a developer or
referenced in a bug report (http://tracker.ceph.com/). Once the
upload completes, the directory is marked non-readable and
non-writeable to prevent access or modification by other users.
Warning
=======
Basic measures are taken to make posted data be visible only to
developers with access to ceph.com infrastructure. However, users
should think twice and/or take appropriate precautions before
posting potentially sensitive data (for example, logs or data
directories that contain Ceph secrets).
Options
=======
.. option:: -d *description*, --description *description*
Add a short description for the upload. This is a good opportunity
to reference a bug number. There is no default value.
.. option:: -u *user*
Set the user metadata for the upload. This defaults to `whoami`@`hostname -f`.
Examples
========
To upload a single log::
ceph-post-file /var/log/ceph/ceph-mon.`hostname`.log
To upload several directories::
ceph-post-file -d 'mon data directories' /var/log/ceph/mon/*
Availability
============
**ceph-post-file** is part of the Ceph distributed file system. Please refer to
the Ceph documentation at http://ceph.com/docs for more information.
See also
========
:doc:`ceph <ceph>`\(8),
:doc:`ceph-debugpack <ceph-debugpack>`\(8),