summaryrefslogtreecommitdiffstats
path: root/src/ceph/doc/man/8/ceph-post-file.rst
blob: 7e4899f5a1ad970d0914061a8fcdb65521cff3af (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
:orphan:

==================================================
 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 Ceph, a massively scalable, open-source, distributed storage 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),