linux-kernel - Re: [PATCH] Documentation: ACPI: Update links and references to DSD related docs

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <CAHp75VdFNir18Q-mLVd_87Sxd1Dz0Hg2B4XQfm5XzagO8sZQrg@mail.gmail.com>
Date:   Wed, 22 Jun 2022 13:30:28 +0200
From:   Andy Shevchenko <andy.shevchenko@...il.com>
To:     Sudeep Holla <sudeep.holla@....com>
Cc:     ACPI Devel Maling List <linux-acpi@...r.kernel.org>,
        Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
        "Rafael J . Wysocki" <rafael@...nel.org>,
        Andy Shevchenko <andriy.shevchenko@...ux.intel.com>,
        Samer El-Haj-Mahmoud <Samer.El-Haj-Mahmoud@....com>
Subject: Re: [PATCH] Documentation: ACPI: Update links and references to DSD
 related docs

On Tue, Jun 21, 2022 at 5:12 PM Sudeep Holla <sudeep.holla@....com> wrote:
>
> The existing references to DSD are stale and outdated. The new process
> and guidance is maintained @https://github.com/UEFI/DSD-Guide
>
> Update the existing documents to reflect the same.

Taking Rafael's comment into account,
Reviewed-by: Andy Shevchenko <andy.shevchenko@...il.com>
Thanks!

> Signed-off-by: Sudeep Holla <sudeep.holla@....com>
> ---
>  .../firmware-guide/acpi/DSD-properties-rules.rst      | 11 +++++++----
>  1 file changed, 7 insertions(+), 4 deletions(-)
>
> diff --git a/Documentation/firmware-guide/acpi/DSD-properties-rules.rst b/Documentation/firmware-guide/acpi/DSD-properties-rules.rst
> index 8b2d8d0864c2..70442bc2521e 100644
> --- a/Documentation/firmware-guide/acpi/DSD-properties-rules.rst
> +++ b/Documentation/firmware-guide/acpi/DSD-properties-rules.rst
> @@ -21,7 +21,9 @@ specific type) associated with it.
>
>  In the ACPI _DSD context it is an element of the sub-package following the
>  generic Device Properties UUID in the _DSD return package as specified in the
> -Device Properties UUID definition document [1]_.
> +section titled "Well-Known _DSD UUIDs and Data Structure Formats" sub-section
> +"Device Properties UUID" in _DSD (Device Specific Data) Implementation Guide
> +document [1]_.
>
>  It also may be regarded as the definition of a key and the associated data type
>  that can be returned by _DSD in the Device Properties UUID sub-package for a
> @@ -36,7 +38,9 @@ Property subsets are nested collections of properties.  Each of them is
>  associated with an additional key (name) allowing the subset to be referred
>  to as a whole (and to be treated as a separate entity).  The canonical
>  representation of property subsets is via the mechanism specified in the
> -Hierarchical Properties Extension UUID definition document [2]_.
> +section titled "Well-Known _DSD UUIDs and Data Structure Formats" sub-section
> +"Hierarchical Data Extension UUID" in _DSD (Device Specific Data)
> +Implementation Guide document [1]_.
>
>  Property sets may be hierarchical.  That is, a property set may contain
>  multiple property subsets that each may contain property subsets of its
> @@ -96,5 +100,4 @@ contents.
>  References
>  ==========
>
> -.. [1] https://www.uefi.org/sites/default/files/resources/_DSD-device-properties-UUID.pdf
> -.. [2] https://www.uefi.org/sites/default/files/resources/_DSD-hierarchical-data-extension-UUID-v1.1.pdf
> +.. [1] https://github.com/UEFI/DSD-Guide
> --
> 2.36.1
>


-- 
With Best Regards,
Andy Shevchenko