lrc(1)

NAME
lrc - Check licenses listed in a DEP-5 debian/copyright file against licenses reported by licensecheck.

SYNOPSIS
lrc

DESCRIPTION
lrc parses a valid DEP-5 copyright file and notes the licenses of all files in the source tree. Licensecheck is then run, and the results compared. Differences between licenses in debian/copyright and the output of licensecheck are reported.

It should be run in the top level of a cleaned Debian source tree, with a valid DEP-5 copyright file. The source tree should be clean, otherwise results may be contaminated by spurious reports on the build's generated files. It is advisable to run lintian first to ensure correct syntax of debian/copyright.

The results are indicative only, and not a substitute for manual checking. It is intended to report obvious errors. The design intends to minimise false positives as much as is practical. However, false positives will occur if the spelling of the license short-string is not identical between the file and debian/copyright. This is quite likely with complex licensing such as 'and'/'or' constructs and specific exceptions.

Only files with a copyright header are checked. False negatives may occur if licensecheck cannot determine a file's license. Files named copyright, copying, readme etc. are not checked as they often specify the licenses of other files rather than their own.

EXIT CODES
0: No differences found
1: Failure to run (no debian/copyright etc)
3: License differences found

SAMPLE OUTPUT
Sample output invoking lrc.

 SUCCESS:
        Parsing Source Tree ....
        Running licensecheck ....
        No differences found
 DIFFERENCES:
        Parsing Source Tree ....
        Running licensecheck ....
        d/copyright | licensecheck

        LGPL-2.1+   | GPL-2+       test/src/config/chan.c
        GPL-2+      | public-domain share/lua/int/dummy.lua
        GPL-2+      | LGPL-2.1+    modules/access/sr_common.h

AUTHOR
Peter Blackman <peter@pblackman.plus.com>

SEE ALSO
licensecheck (1)