.TH SW-COLLECTOR 1 "2017-07-15" "@PACKAGE_VERSION@" "strongSwan"
.
.SH "NAME"
.
sw-collector \- Extracts software installation events from dpkg history log
.
.SH "SYNOPSIS"
.
.SY "sw-collector"
.OP \-\-debug level
.OP \-\-quiet
.OP \-\-count event-count
.YS
.
.SY "sw-collector"
.OP \-\-debug level
.OP \-\-quiet
.BR \-\-list |\fB\-\-unregistered\fR|\fB\-\-generate\fR|\fB\-\-migrate
.YS
.
.SY "sw-collector"
.B \-h
|
.B \-\-help
.YS
.
.SH "DESCRIPTION"
.
.B sw-collector
extracts information about software package installation, update or removal
events from the apt history log and stores the software events in an SQLite
database. The retrieved history information is then merged and made consistent
with the actual list of installed software packages obtained with dpkg-query.
.
.SH "OPTIONS"
.
.TP
.B "\-h, \-\-help"
Prints usage information and a short summary of the available commands.
.TP
.BI "\-v, \-\-debug " level
Set debug level, default: 2.
.TP
.B "\-q, \-\-quiet
Disable debug output to stderr.
.TP
.B "\-l, \-\-list
Lists all software packages stored in the collector database showing their
installation status.
.TP
.B "\-u, \-\-unregistered
Lists all software packages residing in the local collector database but for
which no SWID tags exist yet in a central collector database reachable via a
REST interface. 
.TP
.B "\-g, \-\-generate
Generates minimal SWID tags for all deleted software packages residing in the
local collector database but for which no SWID tags exist in a central collector
database reachable via a REST interface.
.TP
.B "\-m, \-\-migrate
Can be used to migrate collector database versions. Currently all architecture
suffixes are removed from dpkg package names.
.
.SH "CONFIGURATION"
.
The following parameters can be configured in strongswan.conf:
.P
 sw-collector {
    database = sqlite:///etc/pts/collector.db
    history = /var/log/apt/history.log
    first_time = 2016-04-22T20:55:14Z
    rest_api {
       uri = https://admin-user:ietf99hackathon@tnc.strongswan.org/api/
       timeout = 120
    }
    tag_creator {
       name = strongSwan Project
       regid = strongswan.org
    }
 }
.
.SH "FILES"
.
@PKGDATADIR@/templates/database/sw-collector/sw_collector_tables.sql
.
.SH "SEE ALSO"
.
.BR strongswan.conf (5)