Updated distribution specific README

README

@@ -1,4 +1,4 @@
-Install Memtest86+ by running:
+Install memtest86+ into your grub menu by the following command:
 
 # memtest-setup
 
@@ -9,3 +9,68 @@ into /etc/grub.d and you will also need to regenerate GRUB 2 config by running:
 
 This is not done automatically because it could overwrite any custom changes
 in /boot/grub2/grub.cfg.
+
+By default ELF version of memtest86+ is installed, which should work on most of
+the systems. In case it doesn't work for you, you can try the non-ELF version:
+
+- in your grub.conf (usually /etc/grub.conf) locate the line containing:
+  kernel --type=netbsd /elf-memtest86+-VERSION
+
+- edit it to contain:
+  kernel /memtest86+-VERSION
+
+The non-ELF version is known to cause various problems and it may not work on
+several systems. That's why the ELF version is installed by default.
+
+In case of problems you can also try to install the non-ELF version of
+memtest86+ on floppy disk or USB flash disk and boot the memtest86+ from it.
+The following command installs the memtest86+ on floppy disk
+(WARNING: all data previosly stored on the disk will be lost):
+
+# dd if=/boot/memtest86+-VERSION of=/dev/fd0
+
+For USB flash disk the command is the same, just change the 'of' device
+appropriately (usually USB flash disk is /dev/sdb, but double check that
+the device string matches your USB flash disk before you run the command,
+wrong device string may cause significat harm, e.g. it can destroy content
+of your system or data disks).
+
+The memtest86+ now supports some command line parameters:
+  console= - serial console can be used for memtest86+ control/display,
+             example of usage:
+               console=ttyS0
+               console=ttyS0,115200
+               console=ttyS1,115200n8
+             Only ttyS0 and ttyS1 are supported.
+
+  btrace   - enable boot trace.
+
+  maxcpus= - limit number of CPUs to use.
+
+  onepass  - run one pass and exit if there are no errors.
+
+  tstlist= - setup a list of tests to run.
+
+  cpumask= - set a CPU (hexadecimal) mask to select CPU's to use for testing.
+
+You can add memtest86+ command line parameters into grub like you are
+used with kernel command line parameters, e.g.:
+ kernel /memtest86+-VERSION console=ttyS0
+
+Unfortunately this is currently supported only with non-ELF memtest86+ image.
+You cannot use the command line parameters with the ELF image, because the
+command line handling is currently not supported by grub for ELF images.
+
+If you need to use serial console with ELF image, you need to recompile
+memtest86+ and explicitly enable/configure serial line. In such case
+edit the config.h in memtest86+ sources the following way:
+
+#define SERIAL_CONSOLE_DEFAULT 1
+#define SERIAL_TTY 0
+#define SERIAL_BAUD_RATE 9600
+
+and recompile memtest86+. This will explicitly enable serial console and
+set it to use ttyS0,9600.
+
+NOTE: explicitly enabled serial console may significantly slow down the memory
+testing.

memtest86+.spec

@@ -9,7 +9,7 @@
 
 Name:     memtest86+
 Version:  5.01
-Release:  12%{?dist}
+Release:  13%{?dist}
 License:  GPLv2
 Summary:  Stand-alone memory tester for x86 and x86-64 computers
 Group:    System Environment/Base
@@ -124,6 +124,9 @@ rm -rf %{buildroot}
 %{_mandir}/man8/*.8.gz
 
 %changelog
+* Fri Feb 12 2016 Jaroslav Škarvada <jskarvad@redhat.com> - 5.01-13
+- Updated distribution specific README
+
 * Thu Feb 04 2016 Fedora Release Engineering <releng@fedoraproject.org> - 5.01-12
 - Rebuilt for https://fedoraproject.org/wiki/Fedora_24_Mass_Rebuild