NAME¶

wolfictl-advisory-list - List advisories for specific packages, vulnerabilities, or the entire data set

SYNOPSIS¶

wolfictl advisory list [flags]

DESCRIPTION¶

List advisories for specific packages, vulnerabilities, or the entire data set.

The 'list' (or 'ls') command prints a table of advisories based on the given selection criteria. By default, all advisories in the current advisory data set will be listed.

FILTERING

You can list advisories for a single package:

wolfictl adv ls -p glibc

You can list all advisories for a given vulnerability ID across all packages:

wolfictl adv ls -V CVE-2023-38545

You can filter advisories by the type of the latest event:

wolfictl adv ls -t detection

You can filter advisories by the detected component type:

wolfictl adv ls -c python

You can filter advisories by the date they were created or last updated:

wolfictl adv ls --created-since 2024-01-01
wolfictl adv ls --created-before 2023-12-31
wolfictl adv ls --updated-since 2024-06-01
wolfictl adv ls --updated-before 2024-06-01

You can show only advisories that are considered not to be "resolved":

wolfictl adv ls --unresolved

And you can combine the above flags as needed.

HISTORY

Using the --history flag, you can list advisory events instead of just advisories' latest states. This is useful for viewing a summary of an investigation over time for a given package/vulnerability match.'

OUTPUT FORMAT

Using the --output (-o) flag, you can select the output format used to render the results. By default, results are rendered as a "table"; however, you can also select "json".

COUNT

You get a count of the advisories that match the criteria by using the --count flag. This will report just the count, not the full list of advisories.

wolfictl adv ls <various filter flags> --count

OPTIONS¶

-a, --advisories-repo-dir=""
directory containing the advisories repository

--aliases[=true]
show other known vulnerability IDs for each advisory

-c, --component-type=""
filter advisories by detected component type

--count[=false]
show only the count of advisories that match the criteria

--created-before=""
filter advisories created before a given date

--created-since=""
filter advisories created since a given date

-h, --help[=false]
help for list

--history[=false]
show full history for advisories

-o, --output=""
output format (table|json), defaults to table

-p, --package=""
package name

-t, --type=""
filter advisories by event type

--unresolved[=false]
only show advisories considered to be unresolved

--updated-before=""
filter advisories updated before a given date

--updated-since=""
filter advisories updated since a given date

-V, --vuln=""
vulnerability ID for advisory

OPTIONS INHERITED FROM PARENT COMMANDS¶

--log-level="WARN"
log level (e.g. debug, info, warn, error)

SEE ALSO¶

wolfictl-advisory(1)