From nobody Tue Sep 26 13:46:12 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Rw1H91B7cz4v9tZ for ; Tue, 26 Sep 2023 13:46:13 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Rw1H90R5Qz4G75; Tue, 26 Sep 2023 13:46:13 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1695735973; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=4Tli7YkT1fx3ljPDgvhMvXWMMtUw7kvvHI2Ind6t+nA=; b=nW7FqQB9A8mXCQ4nxbBjXyKE26jmNqKr4jJBa0Ltq3ShirCoR/kbxz2xzeixb4aO6zRERa 9IFA+FkWPv2enDYo/M8bcU3Fqq46G5ZO7kBQ1yEyEkezS4icMPDypO708CH03hLOjewxsL uQMauNCQNEX/XZs/aHeHJqSUjkBSVAvxN49S45EXBc1l3e/Htd7Sd8OsGhjBVxixAzG/a+ dxmgyDw72++yqyw5iTRQHCMZ68SMqjtEezgmqDde4GVAUeQWMbT/rR5l7XTdbKiy34i/OP tp3y2PbdjzHdtYHWkF7R/Lzlkclh3TKMvlrPsszLUYvcCyn0g7EjbvQnCNs82w== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1695735973; a=rsa-sha256; cv=none; b=rledUpgR7g2+133fvdV/mulWH9OxEQsAdacZ1k+y/vGnctLBLcIjFLfg/RUIrLmc+wpApQ z3JPyvGvgs4EXynf/BDbEi9Te7/o0et38gwrtGt8pyHabaKw5Y0zwHOveyaT1PiyfIPMaT /jEBsrC/GWDvcyPM43eCHZ8zIETwT3BuLIXTnHgUVA22YLmAXqOKlM3BEoR22NMDBrZx1O z/WabxzpJza4tbAL1qzX4tT05jCoykkGSeCdkreBPJ3ELpL6WIWtFwy4VU6Y+av23PiKE+ 3VtzkyEFErS5YkkJC9eJP6UViCZvGSZVrRYqO+XvW3ieEnZJ43KXkJX2C54CJQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1695735973; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=4Tli7YkT1fx3ljPDgvhMvXWMMtUw7kvvHI2Ind6t+nA=; b=nErJlHrJRDIsItTok2F+uXea39qgxsLmPdE1A1k9cL5oc3Dn55jnWUTQcdYKA/HRn39k55 D1Rf8w0lsvQCyYsmYOHbPTUL8oVKmoJSu38/Lt569ZoNTbHWyCo0hnmqmX6q4xwO4T/vL+ ZY03yxqF22XGLUj68wDy5IOQalP1TURgPnf1wylvtD1jaKPkGIg/emvFNyCq/URIyHoA48 W0OQ8xhQ3sj7Hqwox/m2uY5k9vAgMssMz1XFFrF01Bk1IwxwWWAUinlwtv+A/nO17EkCZC yoHq4QjPwKtZl4KQ1uvo6r1/UvXjTl1oJV8kvdzz4PyXacVMr0Eh1L5IalbpZA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Rw1H86cQzzyPS; Tue, 26 Sep 2023 13:46:12 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 38QDkCbU018754; Tue, 26 Sep 2023 13:46:12 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 38QDkC6L018751; Tue, 26 Sep 2023 13:46:12 GMT (envelope-from git) Date: Tue, 26 Sep 2023 13:46:12 GMT Message-Id: <202309261346.38QDkC6L018751@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Fernando =?utf-8?Q?Apestegu=C3=ADa?= Subject: git: 6984b0bf8e - main - [phb]: Document make newentry SA_ID List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 6984b0bf8ee29466f6787e8247c0162fe81764b1 Auto-Submitted: auto-generated The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=6984b0bf8ee29466f6787e8247c0162fe81764b1 commit 6984b0bf8ee29466f6787e8247c0162fe81764b1 Author: Fernando Apesteguía AuthorDate: 2023-09-26 13:45:07 +0000 Commit: Fernando Apesteguía CommitDate: 2023-09-26 13:45:07 +0000 [phb]: Document make newentry SA_ID Document helper for registering FreeBSD Security Advisories. --- .../content/en/books/porters-handbook/security/_index.adoc | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/documentation/content/en/books/porters-handbook/security/_index.adoc b/documentation/content/en/books/porters-handbook/security/_index.adoc index d5fc9c9aec..7843b770d7 100644 --- a/documentation/content/en/books/porters-handbook/security/_index.adoc +++ b/documentation/content/en/books/porters-handbook/security/_index.adoc @@ -267,6 +267,17 @@ following command can be used instead: where `CVE-YYYYY-XXXX` is a valid CVE identifier. +If the vulnerability is a FreeBSD Security Advisory, the +following command can be used instead: + +[source,shell] +.... +% cd ${PORTSDIR}/security/vuxml +% make newentry SA_ID=FreeBSD-SA-YY-XXXXXX.asc +.... + +where `FreeBSD-SA-YY-XXXXXX.asc` is a published https://www.freebsd.org/security/advisories/[FreeBSD Security Advisory]. + Verify its syntax and formatting: [source,shell]