log4sh runs along the same lines as the other excellent logging services from the Apache Software Foundation. It adds to that list the ability to integrate powerful logging capabilities into a shell script.
log4sh was originally developed to solve a logging problem I had in some of the production environments I have worked in where I either had too much logging, or not enough. Cron jobs in particular caused me the most headaches with their constant and annoying emails telling me that everything worked, or that nothing worked but not a detailed reason why. I now use log4sh in environments where logging from shell scripts is critical, but where I need more than just a simple "Hello, fix me!" type of logging message. If you like what you see, or have any suggestions on improvements, please feel free to drop me an email. If there is enough interest in the project, I will develop it further.
log4sh has been developed under the Bourne Again Shell (/bin/bash) on Linux, but great care has been taken to make sure it works under the default Bourne Shell of Solaris (/bin/sh) as this happens to be the primary production platform used by myself.
Tested Operating Systems
There are two current release series of log4sh available. The 1.4 series is the stable release, and it contains only bugfixes. It is considered stable enough for production use. The 1.5 series is meant for new features and is still under development. Generally, the 1.5 series should be stable enough to use in a production environment as it is run through unit testing before being released, but there are no guarantees that everything works so it would be best to test it out first.
If you would like to verify the MD5 fingerprint (in case someone mistakenly modifies the values below) or verify the GPG signatures of the releases, they can be found in the releases directory. The files are signed with the firstname.lastname@example.org public key, and more information can be found on our GnuPG Info page.
Previous versions are available from our old releases page.
HTML documentation for the various log4sh releases.
Documentation is also included with the distribution in the doc directory.
Examples and workarounds for log4sh
A list of contributors is provided with each release (found as doc/contributors.txt). Many thanks go out to each of these individuals for finding bugs and/or providing patches.
Resources are gracefully provided by SourceForge.