On 27 May 2015 at 15:18, Matt Fleming <matt@xxxxxxxxxxxxxxxxxxx> wrote: > 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 <matt.fleming@xxxxxxxxx> > 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 <ard.biesheuvel@xxxxxxxxxx> > Cc: Jean Delvare <jdelvare@xxxxxxx> > Cc: Leif Lindholm <leif.lindholm@xxxxxxxxxx> > Cc: Ivan Khoronzhuk <ivan.khoronzhuk@xxxxxxxxxxxxxxx> > Signed-off-by: Matt Fleming <matt.fleming@xxxxxxxxx> Still not crazy about it but here it goes :-) Acked-by: Ard Biesheuvel <ard.biesheuvel@xxxxxxxxxx> > --- > 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 <dyoung@xxxxxxxxxx> > 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: linux-efi@xxxxxxxxxxxxxxx > +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 majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
