doc: Update documentation of guix lint

* doc/guix.texi (Invoking guix lint): Add cpe-version to example.
(Invoking guix lint): Add example for lint-hidden-cve.

Co-authored-by: Ludovic Courtès <ludo@gnu.org>
master
Björn Höfling 2018-05-13 01:40:00 +02:00 committed by Ludovic Courtès
parent 320344055a
commit 5ac7bf56d0
No known key found for this signature in database
GPG Key ID: 090B11993D9AEBB5
1 changed files with 21 additions and 3 deletions

View File

@ -6835,15 +6835,33 @@ where @code{CVE-YYYY-ABCD} is the CVE identifier---e.g.,
Package developers can specify in package recipes the Package developers can specify in package recipes the
@uref{https://nvd.nist.gov/cpe.cfm,Common Platform Enumeration (CPE)} @uref{https://nvd.nist.gov/cpe.cfm,Common Platform Enumeration (CPE)}
name and version of the package when they differ from the name that Guix name and version of the package when they differ from the name or version
uses, as in this example: that Guix uses, as in this example:
@example @example
(package (package
(name "grub") (name "grub")
;; @dots{} ;; @dots{}
;; CPE calls this package "grub2". ;; CPE calls this package "grub2".
(properties '((cpe-name . "grub2")))) (properties '((cpe-name . "grub2")
(cpe-version . "2.3")))
@end example
@c See <http://www.openwall.com/lists/oss-security/2017/03/15/3>.
Some entries in the CVE database do not specify which version of a
package they apply to, and would thus ``stick around'' forever. Package
developers who found CVE alerts and verified they can be ignored can
declare them as in this example:
@example
(package
(name "t1lib")
;; @dots{}
;; These CVEs no longer apply and can be safely ignored.
(properties `((lint-hidden-cve . ("CVE-2011-0433"
"CVE-2011-1553"
"CVE-2011-1554"
"CVE-2011-5244")))))
@end example @end example
@item formatting @item formatting