[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[MULTIBOOT2 DOC PATCH 02/10] multiboot2: Clarify meaning of information
From: |
Daniel Kiper |
Subject: |
[MULTIBOOT2 DOC PATCH 02/10] multiboot2: Clarify meaning of information request header tag |
Date: |
Thu, 9 Jun 2016 22:30:36 +0200 |
Signed-off-by: Daniel Kiper <address@hidden>
---
doc/multiboot.texi | 20 ++++++++++++--------
1 file changed, 12 insertions(+), 8 deletions(-)
diff --git a/doc/multiboot.texi b/doc/multiboot.texi
index 27e5a2f..a7e3584 100644
--- a/doc/multiboot.texi
+++ b/doc/multiboot.texi
@@ -443,15 +443,19 @@ u32[n] | mbi_tag_types |
@end group
@end example
address@hidden is an array of u32 each one representing an information
-request
-If this tag is present and @samp{optional} is set to @samp{0} information
-conveyed by requested tag types must be present. If bootloader is unable
-to supply this information it must fail with an error
address@hidden is an array of u32 each one representing an information request.
-Note: it doesn't garantee that any tags of type @samp{mbi_tag_types} will
-actually be present. E.g. on a videoless system even if you requested tag
address@hidden no tags of type @samp{8} will be present in mbi.
+If this tag is present and @samp{optional} is set to @samp{0} bootloader must
+support (understand meaning of) requested tag(s) and be able to provide
relevant
+information to image if it is available. If bootloader do not understand
meaning
+of requested tag(s) it must fail with an error. However, if it support a given
+tag(s) but information conveyed by it/them is not available bootloader can do
not
+provide requested tag(s) in Multiboot information structure and proceed
further.
+
+Note: Above means that there is not guarantee that any tags of type
@samp{mbi_tag_types}
+will actually be present. E.g. on a videoless system even if you requested tag
@samp{8}
+and bootloader support it no tags of type @samp{8} will be present in Multiboot
+information structure.
@node Address header tag
--
1.7.10.4
- [MULTIBOOT2 DOC PATCH 00/10] multiboot2: Update documentation, Daniel Kiper, 2016/06/09
- [MULTIBOOT2 DOC PATCH 01/10] multiboot2: Remove redundant if, Daniel Kiper, 2016/06/09
- [MULTIBOOT2 DOC PATCH 02/10] multiboot2: Clarify meaning of information request header tag,
Daniel Kiper <=
- [MULTIBOOT2 DOC PATCH 03/10] multiboot2: Fix description of EFI boot services tag, Daniel Kiper, 2016/06/09
- [MULTIBOOT2 DOC PATCH 05/10] multiboot2: Add description of EFI image handle tags, Daniel Kiper, 2016/06/09
- [MULTIBOOT2 DOC PATCH 04/10] multiboot2: Add description of support for EFI boot services, Daniel Kiper, 2016/06/09
- [MULTIBOOT2 DOC PATCH 06/10] multiboot2: Add description of support for relocatable images, Daniel Kiper, 2016/06/09
- [MULTIBOOT2 DOC PATCH 09/10] multiboot2: Add me to authors, Daniel Kiper, 2016/06/09
- [MULTIBOOT2 DOC PATCH 08/10] multiboot2: Add C structure alignment and padding consideration section, Daniel Kiper, 2016/06/09