CIFSLICENSE(1)             Sharity User's Manual

NAME
    cifslicense - Set the registration key or query license properties.

LOCATION
    %globaldir%/bin/cifslicense

SYNOPSIS
    cifslicense <registration-key>
    cifslicense <options>

DESCRIPTION
    The first invocation sets the license key while the second one is
    used to query various topics related to licensing. For the second
    invocation, the following options are valid:

    -h   Print short help and exit
    -p   Print license identifier and features
    -l   Print current license loads and limits in terms of servers and
         clients
    -ll  Print verbose listing of license utilization. For each active
         client, the a list of mounted servers is printed. If you reach
         the license limit and don't know why it's already used up, this
         command tells you who holds which resources.

    The options -l and -ll display only those other clients which use the
    same license key.

INTERPRETING REGISTRATION KEYS
    Registration keys are in the following format (hex digits):
    
        PP-EEEEMM-LCCCCCCC-VVVVVVVV
        
        PP......... package index
        EEEE....... expiry
        MM......... max. network users (encoded)
        L.......... license type
        CCCCCCC.... license identification code
        VVVVVVVV... license verifier

    The registration key without the verifier part is called the
    "license identifier". It uniquely identifies the license but can
    not be used to register a copy of Sharity.

    Package Index: Defines for which software package the key is valid.
    Sharity 2 can only use licenses with package index = 02. The special
    Home-User / Hobbyist license available for certain binaries has
    package index 10.

    Expiry: The expiry is a 16 bit number containing the number of days
    from 1990-01-01 until the day of expiry.

    Max. Network Users: The first digit encodes the number of servers
    and the second the number of clients allowed by this license. The
    digits are interpreted as follows:
    
        value   hosts       value   hosts       value   hosts
            1       1           6      50           B       2
            2       2           7     100           C       5
            3       5           8     200           D      10
            4      10           9     500           E      20
            5      20           A       1           F     inf.


    Digit values from A to E are illegel for client counts, for server
    counts they indicate that the number of servers is counted for the
    local client only, not for the entire network as usual.

    License Type: This number is used to distinguish between the various
    types of licenses (educational institution, student, business etc.).

    License Identification Code: This number makes your license unique.
    It's a kind of hash-value over your personal data.

    License Verifier: This is a kind of signature over the license
    data.