src/ceph/doc/man/8/ceph-post-file.rst

   1 :orphan:
   2
   3 ==================================================
   4  ceph-post-file -- post files for ceph developers
   5 ==================================================
   6
   7 .. program:: ceph-post-file
   8
   9 Synopsis
  10 ========
  11
  12 | **ceph-post-file** [-d *description] [-u *user*] *file or dir* ...
  13
  14
  15 Description
  16 ===========
  17
  18 **ceph-post-file** will upload files or directories to ceph.com for
  19 later analysis by Ceph developers.
  20
  21 Each invocation uploads files or directories to a separate directory
  22 with a unique tag.  That tag can be passed to a developer or
  23 referenced in a bug report (http://tracker.ceph.com/).  Once the
  24 upload completes, the directory is marked non-readable and
  25 non-writeable to prevent access or modification by other users.
  26
  27 Warning
  28 =======
  29
  30 Basic measures are taken to make posted data be visible only to
  31 developers with access to ceph.com infrastructure. However, users
  32 should think twice and/or take appropriate precautions before
  33 posting potentially sensitive data (for example, logs or data
  34 directories that contain Ceph secrets).
  35
  36
  37 Options
  38 =======
  39
  40 .. option:: -d *description*, --description *description*
  41
  42    Add a short description for the upload.  This is a good opportunity
  43    to reference a bug number.  There is no default value.
  44
  45 .. option:: -u *user*
  46
  47    Set the user metadata for the upload.  This defaults to `whoami`@`hostname -f`.
  48
  49 Examples
  50 ========
  51
  52 To upload a single log::
  53
  54    ceph-post-file /var/log/ceph/ceph-mon.`hostname`.log
  55
  56 To upload several directories::
  57
  58    ceph-post-file -d 'mon data directories' /var/log/ceph/mon/*
  59
  60
  61 Availability
  62 ============
  63
  64 **ceph-post-file** is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to
  65 the Ceph documentation at http://ceph.com/docs for more information.
  66
  67 See also
  68 ========
  69
  70 :doc:`ceph <ceph>`\(8),
  71 :doc:`ceph-debugpack <ceph-debugpack>`\(8),