arm64: Add the introduction of multiboot/module command in docs/grub.texi

Signed-off-by: Fu Wei fu.wei@linaro.org --- docs/grub.texi | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+)

diff --git a/docs/grub.texi b/docs/grub.texi index 46b9e7f..084b40e 100644 --- a/docs/grub.texi +++ b/docs/grub.texi @@ -4512,6 +4512,29 @@ Alias for @code{hashsum --hash md5 arg @dots{}}. See command @command{hashsum} @deffn Command module [--nounzip] file [arguments] Load a module for multiboot kernel image. The rest of the line is passed verbatim as the module command line. + +Note that on ARM64 machine, there is not [--nounzip] support. +Each module will be given a default compatibility property based on the order + in which the modules are added: + +The first module will be: compatible = "multiboot,kernel", "multiboot,module" + +The second module will be: compatible = "multiboot,ramdisk", "multiboot,module" + +All subsequent modules will be: compatible = "multiboot,module" + +There is a [--type <compatible stream in FDT>] option to +override default compatible string for the current module. May be given multiple +times, the strings will be listed in the compatible property in the order given. +Note that this means that the generic "multiboot,module" would need to be specified +separately if desired. Modules which are given an explicit compatibility do not +"consume" a default. In addition even if --type is used to specify something +which is also a default it will not be consumed. For now, the available strings +could be : +"multiboot,kernel", "multiboot,ramdisk", "multiboot,module", "xen,xsm-policy" +or the custom compatible stream. +See @uref{http://wiki.xen.org/wiki/Xen_ARM_with_Virtualization_Extensions/Multiboot%7D, + to obtain more information. @end deffn

@node multiboot @@ -4523,6 +4546,8 @@ line is passed verbatim as the @dfn{kernel command-line}. Any module must be reloaded after using this command (@pxref{module}).

Some kernels have known problems. You need to specify --quirk-* for those. +There is not --quirk-* support on ARM64 machine. + --quirk-bad-kludge is a problem seen in several products that they include loading kludge information with invalid data in ELF file. GRUB prior to 0.97 and some custom builds prefered ELF information while 0.97 and GRUB 2