1: .TH SW-COLLECTOR 8 "2017-08-25" "@PACKAGE_VERSION@" "strongSwan"
2: .
3: .SH "NAME"
4: .
5: sw-collector \- Extracts software installation events from dpkg history log
6: .
7: .SH "SYNOPSIS"
8: .
9: .SY "sw-collector"
10: .OP \-\-debug level
11: .OP \-\-quiet
12: .OP \-\-count event-count
13: .YS
14: .
15: .SY "sw-collector"
16: .OP \-\-debug level
17: .OP \-\-quiet
18: .OP \-\-installed\fR|\fB\--removed
19: .BR \-\-list |\fB\-\-unregistered
20: .YS
21: .
22: .SY "sw-collector"
23: .OP \-\-debug level
24: .OP \-\-quiet
25: .OP \-\-installed\fR|\fB\--removed
26: .OP \-\-full
27: .BR \-\-generate
28: .YS
29: .
30: .SY "sw-collector"
31: .OP \-\-debug level
32: .OP \-\-quiet
33: .BR \-\-migrate
34: .YS
35: .
36: .SY "sw-collector"
37: .OP \-\-debug level
38: .OP \-\-quiet
39: .BR \-\-check
40: .YS
41: .
42: .SY "sw-collector"
43: .B \-h
44: |
45: .B \-\-help
46: .YS
47: .
48: .SH "DESCRIPTION"
49: .
50: .B sw-collector
51: extracts information about software package installation, update or removal
52: events from the apt history log and stores the software events in an SQLite
53: database. The retrieved history information is then merged and made consistent
54: with the actual list of installed software packages obtained with dpkg-query.
55: .
56: .SH "OPTIONS"
57: .
58: .TP
59: .B "\-h, \-\-help"
60: Prints usage information and a short summary of the available commands.
61: .TP
62: .BI "\-v, \-\-debug " level
63: Set debug level, default: 2.
64: .TP
65: .B "\-q, \-\-quiet"
66: Disable debug output to stderr.
67: .TP
68: .B "\-i, \-\-installed"
69: Apply command to installed software packages, only.
70: .TP
71: .B "\-r, \-\-removed"
72: Apply command to removed software packages, only.
73: .TP
74: .B "\-f, \-\-full"
75: Generate ISO 19770-2:2015 SWID tags with full file information (possible for
76: installed software packages, only).
77: .TP
78: .B "\-l, \-\-list"
79: Lists all software packages stored in the collector database showing their
80: installation status.
81: .TP
82: .B "\-u, \-\-unregistered"
83: Lists all software packages residing in the local collector database but for
84: which no SWID tags exist yet in a central collector database reachable via a
85: REST interface.
86: .TP
87: .B "\-g, \-\-generate"
88: Generates ISO 19770-2:2015 SWID tags for all software packages residing in the
89: local collector database but for which no SWID tags exist in a central collector
90: database reachable via a REST interface.
91: .TP
92: .B "\-m, \-\-migrate"
93: Can be used to migrate collector database versions. Currently all architecture
94: suffixes are removed from dpkg package names.
95: .TP
96: .B "\-C, \-\-check"
97: Checks the integrity of the collector database against the actual list of
98: installed packages obtained with dpkg-query.
99: .
100: .SH "CONFIGURATION"
101: .
102: The following parameters can be configured in strongswan.conf:
103: .P
104: sw-collector {
105: database = sqlite:///etc/pts/collector.db
106: history = /var/log/apt/history.log
107: first_time = 2016-04-22T20:55:14Z
108: rest_api {
109: uri = https://admin-user:ietf99hackathon@tnc.strongswan.org/api/
110: timeout = 120
111: }
112: }
113: .P
114: The parameters of the swid_generator used with the \-\-generate command can
115: be changed in the libimcv section of strongswan.conf:
116: .P
117: libimcv {
118: swid_gen {
119: command = /usr/local/bin/swid_generator
120: tag_creator {
121: name = strongSwan Project
122: regid = strongswan.org
123: }
124: }
125: }
126: .
127: .SH "FILES"
128: .
129: @PKGDATADIR@/templates/database/sw-collector/sw_collector_tables.sql
130: .
131: .SH "SEE ALSO"
132: .
133: .BR strongswan.conf (5)
134:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>