For Users

Your feedback on how you use SSHGuard, what you like, and what annoys you, helps us improve SSHGuard.

  • Subscribe to the users mailing list and contribute to discussions on issues you care about.
  • Vote for issues on the issue tracker.
  • Report log messages that should or should not be identified as attacks on the issue tracker.
  • Consider maintaining a package for SSHGuard on your operating system.

If there's any part of the code you'd like to dive into, post on the list and we'll show you where to get started.

For Committers

Commit Guidelines

  • Merge via fast-forward and rebase. Where possible, merge pull requests and branches by rebasing on top of master and fast-forwarding, without creating a separate merge commit. Linear history makes it possible for us to bisect regressions.
  • 50 character subject line, followed by a blank and more details in the body if needed, in the commit message.
  • Work in topic branches as needed. For changes big or small, feel free to use public topic branches in the SSHGuard repository. After review, they go in by rebasing master. Topic branches are usually deleted after merging. Force pushes are welcome in topic branches but not allowed in master.

Issue Tracker Workflow

An explanation of workflow states that aren't self-explanatory:

Open
Issue analyzed, fair game for someone to fix
On hold
Issue analyzed, fix deferred (e.g. due to coming architectural changes)
Resolved
Action taken, issue resolved
Invalid
Not an issue (e.g. external bugs, spam)
Wontfix
Intentional behavior or rejected feature requests
Closed
No action taken, issue resolved (e.g. already fixed in master)

Release Checklist

Before release, make sure that:

  • Building and installing work from source tarball: make distcheck
  • Change log and documentation are up-to-date
  • Version number is consistent in configure.ac and man pages

Then:

  1. Tag release: git tag -s -m "Tag <version> release" v<version>
  2. Build source tarball: autoreconf -i && ./configure && make dist
  3. Sign source tarball ./distsign <tarball>
  4. Push tags: git push --tags
  5. Upload release files to SourceForge.
  6. Send release announcement to mailing lists.
  7. Announce release on website.

Lates Releases View all»

  • Latest releases Latest releases are available from SourceForge. See 'News'.
  • sshguard 1.5 This is a milestone release, coming after 18 months ...
  • sshguard 1.5 Sshguard monitors services through their logging activity. It reacts ...

F.A.Q. View all»

  • What is sshguard?Sshguard is a small program that monitors services running on your machine from the log files. When it ...
  • Sshguard does not workYou have one of these problems: sshguard is not given logs correctly sshguard cannot run the commands for ...
  • What does sshguard do?The short version is: it receives log messages, it detects when a networked service has been abused based ...