From: Glenn Washburn <development@efficientek.com>
To: grub-devel@gnu.org, Daniel Kiper <dkiper@net-space.pl>
Cc: Glenn Washburn <development@efficientek.com>
Subject: [PATCH] docs: Add fuller accounting of make check prerequisites
Date: Tue, 28 Sep 2021 18:52:55 -0500 [thread overview]
Message-ID: <20210928235255.688975-1-development@efficientek.com> (raw)
Many of the prerequisites for exercising the full `make check' test suite
have not been documented. This adds them along with a note that some tests
require elevated privileges to run.
Signed-off-by: Glenn Washburn <development@efficientek.com>
---
INSTALL | 24 ++++++++++++++++++++++--
1 file changed, 22 insertions(+), 2 deletions(-)
diff --git a/INSTALL b/INSTALL
index 5e152b71f..25e3740ff 100644
--- a/INSTALL
+++ b/INSTALL
@@ -48,8 +48,27 @@ need the following.
Prerequisites for make-check:
-* qemu, specifically the binary 'qemu-system-i386'
+* qemu, specifically the binary 'qemu-system-ARCH' where ARCH is the
+ architecture GRUB has been built for
+* OVMF, for EFI platforms
+* OpenBIOS, for ieee1275 platforms
* xorriso 1.2.9 or later, for grub-mkrescue and grub-shell
+* wamerican, for grub-fs-tester
+* mtools, FAT tools for EFI platforms
+
+* If running a Linux kernel the following modules must be loaded:
+ - minix, hfs, mac-roman, hfsplus, exfat, reiserfs, xfs, f2fs, btrfs,
+ nilfs2, jfs, fat, ext4, udf, romfs, isofs, squashfs
+* The following are debian named packages required mostly for the full
+ suite of filesystem testing (but some are needed by other tests as well
+ - tar, cpio, gzip, lzop, xz-utils, parted, util-linux, squashfs-tools,
+ zfs-fuse, dosfstools, exfat-utils, ntfs-3g, e2fsprogs, btrfs-progs,
+ xfsprogs, hfsprogs, recode, jfsutils, reiserfsprogs, udftools,
+ nilfs-tools, f2fs-tools, genromfs, attr
+
+Note that `make check' will run and many tests may complete successfully
+with only a subset of these prerequisites. However, some tests may be
+skipped or fail due to missing prerequisites.
Configuring the GRUB
====================
@@ -101,7 +120,8 @@ The simplest way to compile this package is:
6. Type `make' to compile the package.
7. Optionally, type `make check' to run any self-tests that come with
- the package.
+ the package. Note that many of the tests require root privileges in
+ order to run.
8. Type `make install' to install the programs and any data files and
documentation.
--
2.27.0
reply other threads:[~2021-09-28 23:53 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20210928235255.688975-1-development@efficientek.com \
--to=development@efficientek.com \
--cc=dkiper@net-space.pl \
--cc=grub-devel@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.