libcanlock

A standalone RFC 8315 Netnews Cancel-Lock implementation for Unix.

• News
• General
• Authors
• Dependencies
• Documentation
• Source code
• Newsreader support and patches
• Binary packages

News

• 2022-08-06: Link to Arch Linux package page for patched slrn added (thanks to Klaus Alexander Seistrup)
• 2022-08-06: Section "Patches for newsreaders" updated
  Patches for slrn snapshot 1.0.4-6 added.
• 2021-12-01: libcanlock 3.3.0 is now available
  Feature release to make the package more useful for servers.
  Separate library libcanlock-hp added to execute the header parsers (for operating systems with POSIX API).
  New libcanlock-hp API function to unfold header fields added (Suggested by Julien Élie).
  New libcanlock API function cl_verify_multi() added to check multiple keys against multiple locks.
  Library API and ABI are backward compatible.
  canlock utility now supports the option "-m" to check multiple keys against multiple locks.
  Multiple bug fixes.
  The source tree now contains example programs and scripts.
  See ChangeLog for the complete list
• 2021-10-23: Link to Arch Linux package page added (thanks to Klaus Alexander Seistrup)
• 2021-02-14: Section "Patches for newsreaders" updated
  Patches for slrn snapshot 1.0.4-5 added.

General

libcanlock is a library for creating and verifying RFC 8315 Netnews Cancel-Locks.
This implementation uses the recommended algorithm from Section 4 with HMAC based on the same hash function as <scheme>.
See README for details.

A command line utility "canlock" is built together with the library. Additional header parsers are available in the package canlock-hp.
Note: canlock-hp was merged into version 3.1.0 (now part of libcanlock package).

Authors

The original author of libcanlock is G. J. Andruk.
The new (hash algorithm independent) API is written by Dennis Preiser.
The SHA and HMAC code is taken from RFC 6234.
The Base64 code is written by Kungliga Tekniska högskolan (Royal Institute of Technology, Stockholm, Sweden).
I (Michael Bäuerle) am the new maintainer since version 3 and have added the command lineutility and man pages.
See LICENSE for licence information.

Dependencies

• POSIX.1-2001 compliant operating system with C99 compiler
  (Code should be portable to other OS, POSIX is currently only required for the Build-System, Testsuite and canlock-hp)
  Read the INSTALL file in the source tree for details

Documentation

• Manual pages

Newsreader support and patches

• Gnus currently has no support for the libcanlock V3 API
  The libcanlock V2 API emulation can be used (no SHA2 support)
• slrn currently has no support for the libcanlock V3 API
  The libcanlock V2 API emulation can be used (no SHA2 support)
  V3 API patches for the slrn development snapshot 1.0.4-6
  V3 API patches for the slrn development snapshot 1.0.4-5
  Package for Arch Linux with a patched slrn (provided by Klaus Alexander Seistrup)
• tin supports the libcanlock V3 API out of the box
  At least version 2.4.2 is required

Binary packages

• Arch Linux
• Debian
• NetBSD
• openSUSE