summaryrefslogtreecommitdiff
path: root/en/boot-installer/s390.xml
diff options
context:
space:
mode:
authorPhilipp Kern <pkern@debian.org>2012-11-30 20:52:50 +0000
committerPhilipp Kern <pkern@debian.org>2012-11-30 20:52:50 +0000
commit1a006d7cc82e31074c686c8827cb8824c630e31c (patch)
tree69c2fd5121d4fe58568c99eba13c6faf0e710e4a /en/boot-installer/s390.xml
parent610589c72ebd35c4ee5a271ca25bcdb4be261944 (diff)
downloadinstallation-guide-1a006d7cc82e31074c686c8827cb8824c630e31c.zip
update parmfile format; add cio_ignore
Diffstat (limited to 'en/boot-installer/s390.xml')
-rw-r--r--en/boot-installer/s390.xml31
1 files changed, 28 insertions, 3 deletions
diff --git a/en/boot-installer/s390.xml b/en/boot-installer/s390.xml
index e72275b93..4301a83ec 100644
--- a/en/boot-installer/s390.xml
+++ b/en/boot-installer/s390.xml
@@ -22,9 +22,13 @@ standard installation system.
<para>
On S/390 you can append boot parameters in the parm file. This file can
-either be in ASCII or EBCDIC format.
-A sample parm file <filename>parmfile.debian</filename> is provided with
-the installation images.
+either be in ASCII or EBCDIC format. It needs to be fixed-width with
+80 characters per line. A sample parm file
+<filename>parmfile.debian</filename> is provided with the installation
+images. If a parameter is too long to fit into the 80 characters limit
+it can simply be continued in the first column of the next line. All
+the lines are concatenated without spaces when being passed to the
+kernel.
<!-- Link is bad; commented out for now
Please read
@@ -32,5 +36,26 @@ Please read
for more information about S/390-specific boot parameters.
-->
+</para><para>
+
+If you boot the installer in a logical partition (LPAR) or virtual
+machine (VM) where a lot of devices are visible, you might want to
+instruct the kernel to restrict the list to a fixed set of devices. This
+is advised for the installer's boot process if a lot of disks are
+visible. The "cio_ignore" option supports both a blacklist (to only
+disallow a few devices) and a whitelist (to only allow specific
+devices):
+
+<informalexample role="example"><screen>
+ # blacklist: just ignore the two devices 300 and 301
+ cio_ignore=0.0.0300-0.0.0301
+ # whitelist: ignore everything but 1150, FD00, FD01 and FD02
+ cio_ignore=all,!0.0.1150,!0.0.fd00-0.0.fd02
+</screen></informalexample>
+
+Please note that all devices numbers' hex digits need to be specified in
+lower case. To be considered during the installer's boot process the
+above option needs to be added to <filename>parmfile.debian</filename>.
+
</para>
</sect2>