From 2d1e3f8d013c6f37ff96d87faef0c1e29f12f574 Mon Sep 17 00:00:00 2001
From: Karsten Merker <merker@debian.org>
Date: Sat, 13 Sep 2014 07:22:51 +0000
Subject: Add a "Making the system bootable with flash-kernel" subsection to
 the "Making Your System Bootable" section for arm platforms.

---
 en/using-d-i/components.xml                        |  1 +
 .../modules/arm/flash-kernel-installer.xml         | 34 ++++++++++++++++++++++
 2 files changed, 35 insertions(+)
 create mode 100644 en/using-d-i/modules/arm/flash-kernel-installer.xml

(limited to 'en')

diff --git a/en/using-d-i/components.xml b/en/using-d-i/components.xml
index 828b6a11e..4420a01da 100644
--- a/en/using-d-i/components.xml
+++ b/en/using-d-i/components.xml
@@ -155,6 +155,7 @@ linkend="boot-dev-select-sun"/>.</phrase>
 &module-powerpc-quik-installer.xml;
 &module-s390-zipl-installer.xml;
 &module-sparc-silo-installer.xml;
+&module-arm-flash-kernel-installer.xml;
 &module-nobootloader.xml;
   </sect2>
 
diff --git a/en/using-d-i/modules/arm/flash-kernel-installer.xml b/en/using-d-i/modules/arm/flash-kernel-installer.xml
new file mode 100644
index 000000000..715957c02
--- /dev/null
+++ b/en/using-d-i/modules/arm/flash-kernel-installer.xml
@@ -0,0 +1,34 @@
+
+  <sect3 arch="arm">
+  <title>Making the system bootable with flash-kernel</title>
+<para>
+  
+As there is no common firmware interface on all ARM platforms, the
+steps required to make the system bootable on ARM devices are
+highly device-dependent. &debian; uses a tool called
+<command>flash-kernel </command> to take care of this.  Flash-kernel
+contains a database which describes the particular operations that are
+required to make the system bootable on various devices.  It detects
+whether the current device is supported, and if yes, performs the
+necessary operations.
+
+</para><para>
+
+On devices which boot from internal NOR- or NAND-flash memory,
+flash-kernel writes the kernel and the initial ramdisk to this internal
+memory.  This method is particularly common on older armel devices. 
+Please note that most of these devices do not allow having multiple
+kernels and ramdisks in their internal flash memory, i.e. running
+flash-kernel on them usually overwrites the previous contents of the flash
+memory!
+
+</para><para>
+
+For ARM systems that use u-boot as their system firmware and boot the
+kernel and the initial ramdisk from external storage media (such as
+MMC/SD-cards, USB mass storage devices or IDE/SATA harddisks),
+flash-kernel generates an appropriate boot script to allow autobooting
+without user interaction.
+
+</para>
+  </sect3>
-- 
cgit v1.2.3