taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

taler-auditor.1.rst (2729B)


      1 taler-auditor(1)
      2 ################
      3 
      4 .. only:: html
      5 
      6    Name
      7    ====
      8 
      9    **taler-auditor** - audit exchange
     10 
     11 Synopsis
     12 ========
     13 
     14 **taler-auditor**
     15 [**-c** *FILENAME* | **--config=**\ ‌\ *FILENAME*]
     16 [**-h** | **--help**]
     17 [**-i**_|_**--internal**]
     18 [**-I**_|_**--ignore-not-found**]
     19 [**-L** *LOGLEVEL* | **--loglevel=**\ ‌\ *LOGLEVEL*]
     20 [**-l** *FILENAME* | **--logfile=**\ ‌\ *FILENAME*]
     21 [**-m** *MASTER_KEY* | **--exchange-key=**\ ‌\ *MASTER_KEY*]
     22 [**-T** *USEC* | **--timetravel**\ \ *USEC*]
     23 [**-v** | **--version**]
     24 
     25 
     26 Description
     27 ===========
     28 
     29 **taler-auditor** is a command-line tool to be used by an auditor to
     30 audit an exchange’s database and calculate the current financial state
     31 of the exchange (including revenue, amount expected in escrow and risk
     32 exposure). The audit is incremental. The first audit must be performed
     33 with the **-r** option to initialize the tables. The tool reports
     34 inconsistencies in the balance or incorrect cryptographic signatures
     35 found in the database. It does NOT check with the bank to see that the
     36 incoming and outgoing wire transfers that the bank claims to have
     37 matches the exchange’s database. Its options are as follows.
     38 
     39 **-c** *FILENAME* \| **--config=**\ ‌\ *FILENAME*
     40    Use the configuration and other resources for the merchant to operate
     41    from *FILENAME*.
     42 
     43 **-h** \| **--help**
     44    Print short help on options.
     45 
     46 **-i** \| **--internal**
     47    Run additional checks that can only performed on the exchange-internal
     48    database and not the "safe" replicated database at the auditor.
     49 
     50 **-I** \| **--ignore-not-found**
     51    Do not fail if the bank says that the exchange bank account does not (yet) exist.
     52    Keep trying.
     53 
     54 **-L** *LOGLEVEL* \| **--loglevel=**\ ‌\ *LOGLEVEL*
     55    Specifies the log level to use. Accepted values are: ``DEBUG``, ``INFO``,
     56    ``WARNING``, ``ERROR``.
     57 
     58 **-l** *FILENAME* \| **--logfile=**\ ‌\ *FILENAME*
     59    Send logging output to *FILENAME*.
     60 
     61 **-m** *KEY* \| **--exchange-key=**\ ‌\ *KEY*
     62    Public master key of the exchange in Crockford base32 encoding, for
     63    example as generated by ``taler-auditor-offline setup``. If this option is missing,
     64    taler-auditor will use the MASTER_PUBLIC_KEY value from the
     65    “exchange” section of the configuration.
     66 
     67 **-T** *USEC* \| **--timetravel=**\ \ *USEC*
     68    Modify the system time by *USEC* microseconds.
     69    *USEC* may be prefixed with ``+`` or ``-`` (e.g. ``-T +300``).
     70    This option is intended for debugging/testing only.
     71 
     72 **-v** \| **--version**
     73    Print version information.
     74 
     75 
     76 See Also
     77 ========
     78 
     79 taler-auditor-offline(1), taler-auditor.conf(5), taler-auditor-dbinit(1)
     80 
     81 Bugs
     82 ====
     83 
     84 Report bugs by using https://bugs.taler.net or by sending electronic
     85 mail to <taler@gnu.org>.