Skip to content

Commit 01b32a2

Browse files
committed
Update auto_initramfs documentation
In the latest firmwares, the auto_initramfs selection logic has been changed to be based solely on the names of the files. This is simpler to understand and more flexible.
1 parent 3f440ff commit 01b32a2

File tree

1 file changed

+2
-1
lines changed
  • documentation/asciidoc/computers/config_txt

1 file changed

+2
-1
lines changed

documentation/asciidoc/computers/config_txt/boot.adoc

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,7 @@ NOTE: Newer firmware supports the loading of multiple `ramfs` files. You should
6464

6565
`ramfsaddr` is the memory address to which the `ramfsfile` should be loaded.
6666

67+
[[initramfs]]
6768
=== `initramfs`
6869

6970
The `initramfs` command specifies both the ramfs filename *and* the memory address to which to load it. It performs the actions of both `ramfsfile` and `ramfsaddr` in one parameter. The address can also be `followkernel` (or `0`) to place it in memory after the kernel image. Example values are: `initramfs initramf.gz 0x00800000` or `initramfs init.gz followkernel`. As with `ramfsfile`, newer firmwares allow the loading of multiple files by comma-separating their names.
@@ -73,7 +74,7 @@ NOTE: This option uses different syntax from all the other options, and you shou
7374
[[auto_initramfs]]
7475
=== `auto_initramfs`
7576

76-
If `auto_initramfs` is set to `1`, look for an `initramfs` file using the same rules as the kernel selection.
77+
If `auto_initramfs` is set to `1`, the firmware looks for an `initramfs` file to match the kernel. The file must be in the same location as the kernel image, and the name is derived from the name of the kernel by replacing the `kernel` prefix with `initramfs`, and removing any extension such as `.img`, e.g. `kernel8.img` requires `initramfs8`. You can make use of `auto_initramfs` with custom kernel names provided the names begin with `kernel` and `initramfs` respectively and everything else matches (except for the absence of the file extension on the initramfs). Otherwise, an explicit xref:config_txt.adoc#initramfs[`initramfs`] statement is required.
7778

7879
[[disable_poe_fan]]
7980
=== `disable_poe_fan`

0 commit comments

Comments
 (0)