aboutsummaryrefslogblamecommitdiffstats
path: root/docs/index.rst
blob: 60583c0b764377a3625652016c2f66ace575d156 (plain) (tree)























                                                                                                                                          
                                                                                                                                   








                                                                                                                                                                                                                                                                                                           
                                                                                       
 
                                                                                       
 
                                                                         















































                                                                                                                                                                                                                                 
SoS
===

Sos is an extensible, portable, support data collection tool primarily aimed at Linux distributions and other UNIX-like operating systems.

This project is hosted at:

http://github.com/sosreport/sos
For the latest version, to contribute, and for more information, please visit the project pages or join the mailing list.

To clone the current master (development) branch run:

.. code::

    git clone git://github.com/sosreport/sos.git

Reporting bugs
^^^^^^^^^^^^^^

Please report bugs via the mailing list or by opening an issue in the GitHub Issue Tracker

Mailing list
^^^^^^^^^^^^^

The [sos-devel][4] is the mailing list for any sos-related questions and discussion. Patch submissions and reviews are welcome too.

Developers
^^^^^^^^^^

Patches can be submitted via the mailing list or as GitHub pull requests. If using GitHub please make sure your branch applies to the current master as a 'fast forward' merge (i.e. without creating a merge commit). Use the git rebase command to update your branch to the current master if necessary.

Wiki documentation
^^^^^^^^^^^^^^^^^^

 `How to write a plugin <https://github.com/sosreport/sos/wiki/How-to-Write-a-Plugin>`_

 `How to write a policy <https://github.com/sosreport/sos/wiki/How-to-Write-a-Policy>`_

 `Plugin options <https://github.com/sosreport/sos/wiki/Plugin-options>`_

To help get your changes merged quickly with as few revisions as possible please refer to the `Contributor Guidelines <https://github.com/sosreport/sos/wiki/Contribution-Guidelines>`_ when submitting patches or pull requests.

Manual Installation
^^^^^^^^^^^^^^^^^^^

.. code::

    to install locally (as root) ==> make install
    to build an rpm ==> make rpm
    to build a deb ==> make deb

Pre-built Packaging
^^^^^^^^^^^^^^^^^^^

Fedora/RHEL users install via yum:

``yum install sos``

Debian(Sid) users install via apt:

``apt-get install sosreport``

Ubuntu(Saucy 13.10 and above) users install via apt:

``sudo apt-get install sosreport``

API
===

Plugin Reference
^^^^^^^^^^^^^^^^

.. toctree::
   :maxdepth: 2

   plugins


Core Reference
^^^^^^^^^^^^^^

.. toctree::
   :maxdepth: 2

   archive
   reporting
   utilities