.. _bug_reporting-label:

How to report a bug in Lmod
===========================

Lmod has some built-in tools to make debugging possible on your site.
The first feature of Lmod is the configuration report::

   $ module --config

This reports how Lmod has been configured at build time as well as any
``LMOD_*`` environment variables set.  The second tool is the debug
output also built-in to Lmod::

  $ module -D load foo 2> load.log

The ``-D`` option turns on the debug printing and will report all the
steps that Lmod took to load a module called ``foo``.  Note that the
configuration report is at the top of every debug output.

Steps to report a bug
~~~~~~~~~~~~~~~~~~~~~

#. Test your bug against the latest release from github. Please pull
   the HEAD branch.
#. Try to reduce the problem to the fewest number of modules.  Shoot
   for 1 or 2 modulefiles if you can.
#. Run the command that fails.  i.e. ``module -D`` `cmd modulefile ...` 2> ``lmod.log``
#. Combine the lmod.log file, the modulefiles from step 2, and possibly
   the spider cache file into a tar file.
#. Send the tar file to mclay@tacc.utexas.edu
