commit | 806073fe1db2e9a2e58c112e3d7f545c1358033d | [log] [tgz] |
---|---|---|
author | Jonathan Amsterdam <jba@google.com> | Wed Dec 01 17:07:00 2021 -0500 |
committer | Jonathan Amsterdam <jba@google.com> | Thu Dec 02 19:41:04 2021 +0000 |
tree | b7ff6433a2ce682272916e1d026e9a88712046ea | |
parent | 3b187675b2c3aa7e78a7cd84b9bc9926304b1441 [diff] |
cmd/worker: support command-line mode; add list-updates If the worker command is given arguments, it acts like a command-line tool instead of starting a server. Define a list-updates command to list the commit update records in the DB. Change-Id: I9827cf3f8949409dae9e77ce429bafafc6e43129 Reviewed-on: https://go-review.googlesource.com/c/vuln/+/368494 Trust: Jonathan Amsterdam <jba@google.com> Run-TryBot: Jonathan Amsterdam <jba@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Julie Qiu <julie@golang.org>
This repository contains code for hosting the Go Vulnerability Database. The actual reports can be found at x/vulndb.
Neither the code, nor the data, nor the existence of this repository is to be considered stable. See the Draft Design for details on this project.
The Go vulnerability database is rooted at https://storage.googleapis.com/go-vulndb
and provides data as JSON. We recommend using client.Client to read data from the Go vulnerability database.
Do not rely on the contents of the x/vulndb repository. The YAML files in that repository are maintained using an internal format that is subject to change without warning.
The endpoints the table below are supported. For each path:
https://storage.googleapis.com/go-vulndb
).GO-2021-1234
)Path | Description |
---|---|
$base/index.json | List of module paths in the database mapped to its last modified timestamp (link). |
$base/$module.json | List of vulnerability entries for that module (example). |
$base/ID/index.json | List of all the vulnerability entries in the database |
$base/ID/$vuln.json | An individual Go vulnerability report |
Note that these paths and format are provisional and likely to change until an approved proposal.
Some of these packages can probably be coalesced, but for now are easier to work on in a more segmented fashion.
osv
provides a package for generating OSV-style JSON vulnerability entries from a report.Report
client
contains a client for accessing HTTP/fs based vulnerability databases, as well as a minimal caching implementationcmd/dbdiff
provides a tool for comparing two different versions of the vulnerability databasecmd/gendb
provides a tool for converting YAML reports into JSON databasecmd/linter
provides a tool for linting individual reportscmd/report2cve
provides a tool for converting YAML reports into JSON CVEsUnless otherwise noted, the Go source files are distributed under the BSD-style license found in the LICENSE file.
Database entries available at https://storage.googleapis.com/go-vulndb/ are distributed under the terms of the CC-BY 4.0 license.