Return to sw-collector.8.in CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / strongswan / src / sw-collector

Strongswan

    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: