Skip to content

Latest commit

 

History

History
252 lines (166 loc) · 9.39 KB

README.md

File metadata and controls

252 lines (166 loc) · 9.39 KB

Snoopy Logger

Snoopy is a tiny library that logs all executed commands (+ arguments) on your system. [Flattr Snoopy Logger project](https://flattr.com/submit/auto?user_id=a2o&url=https://github.com/a2o/snoopy&title=Snoopy Logger)

Master: Build Status - Master Coverity Scan

Stable: Build Status - Stable

0. News

2015-08-28: Snoopy 2.4.4 released! Mainly maintenance release, with new filter: only_tty, which should cut down noise from non-tty processes considerably.

2015-06-18: Snoopy 2.4.0 released! Many changes, see the ChangeLog. Experimental thread safety added. All users are encouraged to upgrade to Snoopy version 2.4.0+ immediately.

2015-05-12: Snoopy 2.3.0 released! This Snoopy version contains many improvements, bugfixes, new features and quite improved build process. All users are encouraged to upgrade to Snoopy version 2.3.0+ as soon as possible.

1. Installation

The easiest way to start using Snoopy is to execute one of the following commands (as root).

To install the latest STABLE version of Snoopy, use this command:

rm -f snoopy-install.sh &&
wget -q -O snoopy-install.sh https://github.com/a2o/snoopy/raw/install/doc/install/bin/snoopy-install.sh &&
chmod 755 snoopy-install.sh &&
./snoopy-install.sh stable

To install the latest DEVELOPMENT version of Snoopy, use this:

rm -f snoopy-install.sh &&
wget -q -O snoopy-install.sh https://github.com/a2o/snoopy/raw/install/doc/install/bin/snoopy-install.sh &&
chmod 755 snoopy-install.sh &&
./snoopy-install.sh git-master

That is it. Detailed installation instructions are available here: doc/INSTALL.md

1.1 Version information and download links

Version Download URI
Latest stable release http://source.a2o.si/download/snoopy/snoopy-2.4.4.tar.gz
Latest development release (N/A, clone this git repo, use master branch)
All releases http://source.a2o.si/download/snoopy/

2. Output

This is what typical Snoopy output looks like:

2015-02-11T19:05:10+00:00 labrat-1 snoopy[896]: [uid:0 sid:11679 tty:/dev/pts/2 cwd:/root filename:/usr/bin/cat]: cat /etc/fstab.BAK
2015-02-11T19:05:15+00:00 labrat-1 snoopy[896]: [uid:0 sid:11679 tty:/dev/pts/2 cwd:/root filename:/usr/bin/rm]: rm -f /etc/fstab.BAK
2015-02-11T19:05:19+00:00 labrat-1 snoopy[896]: [uid:0 sid:11679 tty:/dev/pts/2 cwd:/root filename:/usr/bin/tail]: tail -f /var/log/messages

These are default output locations on various Linux distributions:

  • CentOS: /var/log/secure
  • Debian: /var/log/auth.log
  • Ubuntu: /var/log/auth.log
  • others: /var/log/messages (potentially, not necessarily)

For actual output destination check your syslog configuration.

3. Configuration

Most parts of Snoopy are/can be/should be configured at build time.

However, since version 2.0.0 Snoopy supports optional configuration file. Snoopy's automated installation procedure enables configuration file support by default. Configuration file path is /etc/snoopy.ini.

For additional information consult comments in default configuration file etc/snoopy.ini and read appropriate sections of doc/INSTALL.md.

4. Support

4.1 Keep all communication public

Due to the fact that you need support, there is a good chance someone else will stumble upon the same issue soon. For this reason it is crucial that all communication is kept public. Search engines can then pick this content up, index it, and hopefully present it to the next soul with the same problem.

GitHub is currently the meeting point for all Snoopy-related content. Therefore you should use GitHub issues for any kind of communication about Snoopy, with the sole exception of commercial support - that should be the only reason for contacting maintainer directly via email.

4.2 Supported Snoopy versions

Only latest released version of Snoopy is "supported"! Any version that is not the latest (stable or development) is not supported. Please do not submit any bugfix/feature/change requests related to old and thus unsupported Snoopy versions.

4.3 Reporting bugs

If you encounter an issue with Snoopy, proceed with the following steps:

  1. make sure you are using the latest version of Snoopy!
  2. this DOES NOT mean the last version 'apt-get install snoopy' provides,
  3. this means the latest version available at https://github.com/a2o/snoopy/
  4. consult FAQ first: doc/FAQ.md,
  5. search the internets (using Google for example),
  6. search the Snoopy issue tracker: https://github.com/a2o/snoopy/issues/,
  7. if the problem still persist, create a new issue on GitHub, but you must:
  8. make sure your issue is reproducible using the latest version of Snoopy,
  9. provide the following data: 1. Snoopy version used and how did you install it? 2. Linux distribution you are using? 3. Which software is crashing because of Snoopy (whole system, one program)? 4. Trace of your program that crashes.
  10. if possible, provide a patch (by creating a pull request on GitHub) that fixes (or at least tries to fix) the reported issue.

4.4 Feature requests

"I need Snoopy to do this and that!"

Heard too many times. This is Open Source software. It is created, maintained and contributed to by people who donate their time and expertise to the project. Therefore donated time is primarily spent on topics of their interest, so naturally Snoopy is subjected to FOSS toilet paradox: designing a futuristic toilet is fun, but fixing it when it gets clogged is something no one is willing to do for free. You can read the extensive explanation of this analogy here: http://blog.enfranchisedmind.com/2009/07/fyi-my-open-source-users/

If you need a specific feature that is currently not implemented, you have three options:

  1. Implement it yourself. Once done, you can:
  2. contribute it back to Snoopy by creating a pull request - you are welcome to do so;
  3. keep your code private, no one is stopping you (but make sure you comply with license restrictions).
  4. Ask someone (who has required expertise) to do it. Payment may be expected.
  5. Commercial support.

However, if you think you have came up with a very nice feature, but you do not know how to implement it, yet you think other people might find use for it, do not hesitate and open an Issue on GitHub: https://github.com/a2o/snoopy/issues That way the idea will be kept around and maybe someone will pick it up and implement it.

4.5 Free support

Use GitHub Issues: https://github.com/a2o/snoopy/issues Do not send email to maintainers for free support.

4.6 Commercial support

Commercial support for Snoopy is available. Contact current maintainer via email for details.

5. How does Snoopy actually work?

See doc/internals/README.md

6. Contributing to Snoopy development

See CONTRIBUTING.md

7. License

Snoopy is released under GNU General Public License version 2.

Snoopy was originally released under GNU GPLv2 license, and during the course of it's life various people contributed code to it under the same license. Therefore Snoopy continues to be released under GNU GPLv2 license, as this is the only license all contributors agreed to, up to this point.

Should some entity (individual or corporation) desire to obtain Snoopy under a different license (commercial, for example), a consent from all contributors will be required.

8. Credits

Snoopy development is currently located at the following URI: http://github.com/a2o/snoopy/

Additional git mirrors (read-only) are available here: https://gitlab.com/a2o/snoopy/ https://bitbucket.org/bostjan/snoopy/ https://git.teon.si/a2o/snoopy/

Snoopy Logger was originally created and maintained by: Marius Aamodt Eriksen marius@umich.edu Mike Baker mbm@linux.com

List of contributors is available at the following locations:

  • in the Snoopy's ChangeLog file;
  • in the list of pull requests on GitHub.

Snoopy is currently maintained by: Bostjan Skufca bostjan@a2o.si