On Wed, 27 May, at 12:30:37PM, Ard Biesheuvel wrote:
> 
> OK. Then I guess we should at least document in
> Documentation/ABI/stable/sysfs-firmware-efi-systab that the order in
> which the entries are enumerated is part of the ABI.

Makes perfect sense to me. How about this?

---

>From ccb5f08bb71ae4199c75668c6beacd6b47fa186c Mon Sep 17 00:00:00 2001
From: Matt Fleming <[email protected]>
Date: Wed, 27 May 2015 14:14:22 +0100
Subject: [PATCH] efi: Add 'systab' information to Documentation/ABI

It's not clear right now that the order in which entries are displayed
in /sys/firmware/efi/systab actually forms an ABI that userspace tools
rely upon.

Document the ABI along with the userspace tool that cares.

Suggested-by: Ard Biesheuvel <[email protected]>
Cc: Jean Delvare <[email protected]>
Cc: Leif Lindholm <[email protected]>
Cc: Ivan Khoronzhuk <[email protected]>
Signed-off-by: Matt Fleming <[email protected]>
---
 Documentation/ABI/testing/sysfs-firmware-efi | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/Documentation/ABI/testing/sysfs-firmware-efi 
b/Documentation/ABI/testing/sysfs-firmware-efi
index 05874da7ce80..e794eac32a90 100644
--- a/Documentation/ABI/testing/sysfs-firmware-efi
+++ b/Documentation/ABI/testing/sysfs-firmware-efi
@@ -18,3 +18,13 @@ Contact:     Dave Young <[email protected]>
 Description:   It shows the physical address of config table entry in the EFI
                system table.
 Users:         Kexec
+
+What:          /sys/firmware/efi/systab
+Date:          April 2005
+Contact:       [email protected]
+Description:   Displays the physical addresses of all EFI Configuration
+               Tables found via the EFI System Table. The order in
+               which the tables are printed forms an ABI and newer
+               versions are always printed first, i.e. ACPI20 comes
+               before ACPI.
+Users:         dmidecode
-- 
2.1.0

-- 
Matt Fleming, Intel Open Source Technology Center
--
To unsubscribe from this list: send the line "unsubscribe linux-efi" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to