"Fossies" - the Fresh Open Source Software Archive

Member "tin-2.4.2/libcanlock/README" (14 Jul 2017, 2517 Bytes) of package /linux/misc/tin-2.4.2.tar.xz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "README": 2.4.1_vs_2.4.2.

    1 
    2 libcanlock
    3 ==========
    4 A library for creating and verifying RFC xxxx Netnews Cancel-Locks.
    5 
    6 
    7 1) General
    8 libcanlock is a standalone implementation without external dependencies.
    9 If your program already uses a library that contains functions for hash and
   10 base64 algorithms (e.g. OpenSSL), it is recommended that you use them instead
   11 (to avoid code duplication).
   12 
   13 
   14 2) System requirements
   15 - POSIX.1-2001 compliant operating system
   16 - C99 compiler with 'int' data type of at least 32 bit width
   17 
   18 Note:
   19 A POSIX style operating system is required only for the build system and the
   20 test-suite.
   21 The code of the library and CLI utility is intended to be portable C99 (with the
   22 exception that 16 bit platforms are not supported).
   23 
   24 
   25 3) API
   26 Since version 3 there is a new API available (hash algorithm independent).
   27 Man pages for this API are installed together with the library.
   28 
   29 Anything that is not documented should be considered as internal and not
   30 part of the API. There is no portable way to hide all the internal stuff
   31 completely, but expect that a future version may no longer export it without
   32 notice.
   33 
   34 
   35 4) Backward compatibility
   36 The old API from version 2 is still emulated, but it is now deprecated and
   37 undocumented.
   38 
   39 Including the header file from the new location, recompile and relink should
   40 be sufficient to port an existing application to version 3 of the library.
   41 It is also possible to install both version 2 and version 3 of the library
   42 in parallel.
   43 
   44 
   45 5) Versioning scheme
   46 With version 3 the release version scheme has changed.
   47 Now the release version contains 3 numbers "x.y.z":
   48 
   49 - Major (x)
   50   The major number is incremented for every API/ABI change that is not backward
   51   compatible.
   52 - Minor (y)
   53   The minor number is incremented for API/ABI extensions that are backward
   54   compatible.
   55 - Patch (z)
   56   The patch number is incremented for changes that don't change the API/ABI.
   57 
   58 In other words:
   59 Releases with the same major and minor numbers are drop-in replacements.
   60 Up- and downgrades between such versions are possible without touching
   61 programs that use the library.
   62 Releases with the same major, but different minor numbers are backward,
   63 but not forward compatible. Upgrades are possible, downgrades can break
   64 programs that use the library.
   65 Releases with different major numbers require changes in all programs that
   66 use the library.
   67 
   68 
   69 canlock
   70 =======
   71 Since version 3 the command line utility "canlock" is available as frontend.
   72 The utility and a man page for it are installed together with the library.
   73 
   74 
   75 EOF