{"id":13409263,"url":"https://github.com/a2o/snoopy","last_synced_at":"2025-05-14T15:06:57.032Z","repository":{"id":6024849,"uuid":"7248772","full_name":"a2o/snoopy","owner":"a2o","description":"Snoopy Command Logger is a small library that logs all program executions on your Linux/BSD system.","archived":false,"fork":false,"pushed_at":"2024-10-24T22:51:39.000Z","size":2286,"stargazers_count":1245,"open_issues_count":7,"forks_count":158,"subscribers_count":58,"default_branch":"master","last_synced_at":"2025-04-12T02:56:13.857Z","etag":null,"topics":["bsd","command-line-logger","linux","logger","logging","program-execution-logger","snoopy","snoopy-logger"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/a2o.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://flattr.com/@bostjan"]}},"created_at":"2012-12-19T22:52:06.000Z","updated_at":"2025-04-11T04:33:01.000Z","dependencies_parsed_at":"2024-11-20T23:42:49.395Z","dependency_job_id":"ab89e41b-fe6f-48f6-b27c-9bf26c094703","html_url":"https://github.com/a2o/snoopy","commit_stats":{"total_commits":1065,"total_committers":36,"mean_commits":"29.583333333333332","dds":"0.39061032863849765","last_synced_commit":"402f46438bcb133285f6ee55fe53b54c4ff09359"},"previous_names":[],"tags_count":68,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a2o%2Fsnoopy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a2o%2Fsnoopy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a2o%2Fsnoopy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a2o%2Fsnoopy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/a2o","download_url":"https://codeload.github.com/a2o/snoopy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254169288,"owners_count":22026209,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bsd","command-line-logger","linux","logger","logging","program-execution-logger","snoopy","snoopy-logger"],"created_at":"2024-07-30T20:00:59.321Z","updated_at":"2025-05-14T15:06:57.003Z","avatar_url":"https://github.com/a2o.png","language":"C","readme":"# Snoopy Command Logger\n\n\n\n## Table of contents\n\n* [What is Snoopy?](#what-is-snoopy)\n* [News](#news)\n* [Latest version](#latest-version)\n* [Installation](#installation)\n* [Output](#output)\n* [Configuration](#configuration)\n* [FAQ - Frequently asked questions](#faq-frequently-asked-questions)\n* [Security disclaimer](#security-disclaimer)\n* [Contributing to Snoopy development](#contributing-to-snoopy-development)\n* [Getting support](#getting-support)\n* [License](#license)\n* [Online resources](#online-resources)\n* [Credits](#credits)\n\n\n\n## What is Snoopy?\n\nSnoopy is a small library that logs all program executions on your Linux/BSD system.\n\n[Developer documentation](doc/HACKING-INTERNALS.md) outlines how it actually does that (a fairly technical read).\nAnd don't miss the [security disclaimer](#security-disclaimer) about it.\n\n\n\n## News\n\n| Date         | What?                     | Details   |\n| ------------ | ------------------------- | --------- |\n| 2024-10-24   | Snoopy 2.5.2 released.    | Bugfix release + created Ubuntu 24.04 packaging. |\n| 2022-09-28   | Snoopy 2.5.1 released.    | Bugfix release - fixed 32-bit builds. |\n| 2022-08-19   | Snoopy 2.5.0 released.    | Thread safety by default \u0026 binary distribution packages are finally here! :) |\n\nConsult [ChangeLog](ChangeLog) for more information.\n\n\n\n## Latest version\n\n| Latest release | Version  | Status | Download location |\n| -------------- | -------- | ------ | ----------------- |\n| Stable         | 2.5.2    | [![Build QA - OS Matrix (Large) / stable](https://github.com/a2o/snoopy/workflows/Build%20QA%20-%20OS%20Matrix%20(Large)/badge.svg?branch=snoopy-2.5.2)](https://github.com/a2o/snoopy/actions?query=workflow%3A%22Build+QA+-+OS+Matrix%20(Large)%22+branch%3Asnoopy-%2A) \u003cbr/\u003e [![Build QA - Config Matrix (Large) / stable](https://github.com/a2o/snoopy/workflows/Build%20QA%20-%20Config%20Matrix%20(Large)/badge.svg?branch=snoopy-2.5.2)](https://github.com/a2o/snoopy/actions?query=workflow%3A%22Build+QA+-+Config+Matrix+%28Large%29%22+branch%3Asnoopy-%2A) \u003cbr/\u003e [![Code QA - Autoscan / stable](https://github.com/a2o/snoopy/workflows/Code%20QA%20-%20Autoscan/badge.svg?branch=snoopy-2.5.2)](https://github.com/a2o/snoopy/actions?query=workflow%3A%22Code+QA+-+Autoscan%22+branch%3Asnoopy-%2A) \u003cbr/\u003e [![Code QA - Valgrind / stable](https://github.com/a2o/snoopy/workflows/Code%20QA%20-%20Valgrind/badge.svg?branch=snoopy-2.5.2)](https://github.com/a2o/snoopy/actions?query=workflow%3A%22Code+QA+-+Valgrind%22+branch%3Asnoopy-%2A) | All release packages can be found over there :point_right: in the [Releases](https://github.com/a2o/snoopy/releases) section. |\n| Development    | `master` | [![Build QA - OS Matrix (Large) / master](https://github.com/a2o/snoopy/workflows/Build%20QA%20-%20OS%20Matrix%20(Large)/badge.svg?branch=master)](https://github.com/a2o/snoopy/actions?query=workflow%3A%22Build+QA+-+OS+Matrix+%28Large%29%22+branch%3Amaster) \u003cbr/\u003e [![Build QA - Config Matrix / master](https://github.com/a2o/snoopy/workflows/Build%20QA%20-%20Config%20Matrix%20(Large)/badge.svg?branch=master)](https://github.com/a2o/snoopy/actions?query=workflow%3A%22Build+QA+-+Config+Matrix+%28Large%29%22+branch%3Amaster) \u003cbr/\u003e [![Code QA - Autoscan / master](https://github.com/a2o/snoopy/workflows/Code%20QA%20-%20Autoscan/badge.svg?branch=master)](https://github.com/a2o/snoopy/actions?query=workflow%3A%22Code+QA+-+Autoscan%22+branch%3Amaster) \u003cbr/\u003e [![Code QA - Valgrind / master](https://github.com/a2o/snoopy/workflows/Code%20QA%20-%20Valgrind/badge.svg?branch=master)](https://github.com/a2o/snoopy/actions?query=workflow%3A%22Code+QA+-+Valgrind%22+branch%3Amaster) \u003cbr/\u003e [![Coverity Scan](https://scan.coverity.com/projects/4973/badge.svg?flat=1)](https://scan.coverity.com/projects/4973) \u003cbr/\u003e SonarCloud: \u003cbr/\u003e [![SonarCloud - Bugs](https://sonarcloud.io/api/project_badges/measure?project=snoopy\u0026metric=bugs)](https://sonarcloud.io/dashboard?id=snoopy) \u003cbr/\u003e [![SonarCloud - Code Smells](https://sonarcloud.io/api/project_badges/measure?project=snoopy\u0026metric=code_smells)](https://sonarcloud.io/dashboard?id=snoopy) \u003cbr/\u003e [![SonarCloud - Coverage](https://sonarcloud.io/api/project_badges/measure?project=snoopy\u0026metric=coverage)](https://sonarcloud.io/dashboard?id=snoopy) \u003cbr/\u003e [![SonarCloud - Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=snoopy\u0026metric=duplicated_lines_density)](https://sonarcloud.io/dashboard?id=snoopy) \u003cbr/\u003e [![SonarCloud - Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=snoopy\u0026metric=sqale_rating)](https://sonarcloud.io/dashboard?id=snoopy) \u003cbr/\u003e [![SonarCloud - Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=snoopy\u0026metric=alert_status)](https://sonarcloud.io/dashboard?id=snoopy) \u003cbr/\u003e [![SonarCloud - Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=snoopy\u0026metric=reliability_rating)](https://sonarcloud.io/dashboard?id=snoopy) \u003cbr/\u003e [![SonarCloud - Security Rating](https://sonarcloud.io/api/project_badges/measure?project=snoopy\u0026metric=security_rating)](https://sonarcloud.io/dashboard?id=snoopy) \u003cbr/\u003e [![SonarCloud - Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=snoopy\u0026metric=sqale_index)](https://sonarcloud.io/dashboard?id=snoopy) \u003cbr/\u003e [![SonarCloud - Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=snoopy\u0026metric=vulnerabilities)](https://sonarcloud.io/dashboard?id=snoopy) | `git clone git@github.com:a2o/snoopy` |\n\n\n\n## Installation\n\n[![Install QA - README.md / master](https://github.com/a2o/snoopy/workflows/Install%20QA%20-%20README.md/badge.svg?branch=master)](https://github.com/a2o/snoopy/actions?query=workflow%3A%22Install+QA+-+README.md%22+branch%3Amaster)\n[![Install QA - install-snoopy.sh / install](https://github.com/a2o/snoopy/workflows/Install%20QA%20-%20install-snoopy.sh/badge.svg?branch=install)](https://github.com/a2o/snoopy/actions?query=workflow%3A%22Install+QA+-+install-snoopy.sh%22+branch%3Ainstall)\n[![Install QA - OS Matrix - Install from git](https://github.com/a2o/snoopy/workflows/Install%20QA%20-%20OS%20Matrix/badge.svg?branch=install)](https://github.com/a2o/snoopy/actions?query=workflow%3A%22Install+QA+-+OS+Matrix%22+branch%3Ainstall)\n[![Release QA - OS Matrix - Install from source](https://github.com/a2o/snoopy/workflows/Release%20QA%20-%20OS%20Matrix%20-%20Install%20from%20source/badge.svg)](https://github.com/a2o/snoopy/actions?query=workflow%3A%22Release+QA+-+OS+Matrix+-+Install+from+source%22)\n\nStarting with version 2.5.0, repositories with binary packages are provided for major Linux distributions.\nHere is a [guide to installing Snoopy from package repositories](doc/install-from-repo.md).\n\n*WARNING:* If you've installed Snoopy from source (i.e. using the `install-snoopy.sh` script method below) before, it's best to remove it before installing it from a package repository.\n[This guide](doc/install-from-source.md) contains steps to remove \"manually\" installed Snoopy from your system.\n\nAlternatively, the original method of installing Snoopy from source is still available:\n```shell\nwget -O install-snoopy.sh https://github.com/a2o/snoopy/raw/install/install/install-snoopy.sh \u0026\u0026\nchmod 755 install-snoopy.sh \u0026\u0026\nsudo ./install-snoopy.sh stable\n```\n\nMore information is available in the [doc/INSTALL.md](doc/INSTALL.md) document.\n\n\n\n## Output\n\nThis is what typical Snoopy output looks like:\n\n    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\n    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\n    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\n\nThese are default output locations on various Linux distributions:\n\n| Distribution | Snoopy output location | Notes                             |\n| ------------ | ---------------------- |---------------------------------- |\n| CentOS       | `/var/log/secure`      |                                   |\n| Debian       | `/var/log/auth.log`    |                                   |\n| Ubuntu       | `/var/log/auth.log`    |                                   |\n| (others)     | `/var/log/messages`    | (potentially, could be elsewhere) |\n\nFor actual output format and destination, check your Snoopy and syslog configuration.\n\n\n\n## Configuration\n\nIf the configuration file support is available in your Snoopy build (it probably is),\nSnoopy can be reconfigured on-the-fly.\n\nThe configuration file is (most likely, but depending on the build) located at `/etc/snoopy.ini`.\n\nSupported configuration directives are explained in the [default configuration file](etc/snoopy.ini.in).\n\n\n\n## FAQ - Frequently asked questions\n\nFrequently asked questions and answers are collected in the [doc/FAQ.md](https://github.com/a2o/snoopy/blob/master/doc/FAQ.md) file in this repository.\n\n\n\n## Security disclaimer\n\n**WARNING: Snoopy is not a reliable auditing solution.**\n\nRogue users can easily manipulate environment to avoid their actions being logged by Snoopy.\nConsult [this FAQ entry](https://github.com/a2o/snoopy/blob/master/doc/FAQ.md#5-i-see-no-snoopy-output-after-initial-user-login) for more information.\n\n\n\n## Contributing to Snoopy development\n\nConsult the following documents for information related to Snoopy development:\n\n- [CONTRIBUTING.md](.github/CONTRIBUTING.md)\n- [HACKING-OVERVIEW.md](doc/HACKING-OVERVIEW.md)\n- [HACKING-INTERNALS.md](doc/HACKING-INTERNALS.md)\n- [HACKING-QA.md](doc/HACKING-QA.md) (Autoscan, Travis-CI and Valgrind-related sections)\n\n\n\n## Getting support\n\nInformation is available in a [dedicated document about getting support](https://github.com/a2o/snoopy/blob/master/doc/GETTING-SUPPORT.md).\n\n\n\n## License\n\nSnoopy is released under [GNU General Public License version 2](https://github.com/a2o/snoopy/blob/master/COPYING).\n\n\n\n## Online resources\n\nSnoopy development is located at the following URI:\n- https://github.com/a2o/snoopy/\n\nAdditional git repository mirrors (read-only) are available here:\n- https://gitlab.com/a2o/snoopy/\n- https://bitbucket.org/snoopylogger/snoopy/\n\n\n\n## Credits\n\nSnoopy Command Logger was originally created and maintained by:\n- Marius Aamodt Eriksen \u003cmarius@umich.edu\u003e\n- Mike Baker \u003cmbm@linux.com\u003e\n\nContribution acknowledgements are available at the following locations:\n- In the [ChangeLog](ChangeLog),\n- In [pull requests](https://github.com/a2o/snoopy/pulls),\n- In [git history](https://github.com/a2o/snoopy/commits/master).\n\nSnoopy is currently maintained by [Bostjan Skufca Jese](https://github.com/bostjan).\n","funding_links":["https://flattr.com/@bostjan"],"categories":["C","C (286)","DevOps Utilities"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa2o%2Fsnoopy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa2o%2Fsnoopy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa2o%2Fsnoopy/lists"}