ceph/doc/man/8/ceph-post-file.rst
Sage Weil d08e05e463 ceph-post-file: single command to upload a file to cephdrop
Use sftp to upload to a directory that only this user and ceph devs can
access.

Distribute an ssh key to connect to the account.  This will let us revoke
the key in the future if we feel the need.  Also distribute a known_hosts
file so that users have some confidence that they are connecting to the
real ceph drop account and not some third party.

Signed-off-by: Sage Weil <sage@inktank.com>
Reviewed-by: Dan Mick <dan.mick@inktank.com>
2013-08-16 17:59:11 -07:00

70 lines
1.7 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),