From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.90_1) id 1mVMui-0000FV-EO for mharc-grub-devel@gnu.org; Tue, 28 Sep 2021 19:53:32 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:34908) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mVMug-0000FK-Rk for grub-devel@gnu.org; Tue, 28 Sep 2021 19:53:30 -0400 Received: from mail-qk1-x72d.google.com ([2607:f8b0:4864:20::72d]:36517) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mVMud-0005TS-JT for grub-devel@gnu.org; Tue, 28 Sep 2021 19:53:30 -0400 Received: by mail-qk1-x72d.google.com with SMTP id p4so604385qki.3 for ; Tue, 28 Sep 2021 16:53:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=efficientek-com.20210112.gappssmtp.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=6FMoQTYi22M50a6bpNFQLlIDcDebl7FJk51pGUhmKsg=; b=mSUSLR55n5NL24ndwZGFKC+uTt2rLo40PHjz4bUQpSa2S5UumOBn8GZUgB++025dM2 ZmacTqXdL2L/eRaBLhwkTqjKhmElyUwFKS5MOvw93tQnHF+ISPNv2tJxzI/EtNss156v Ys3esnel/fbGERF0NFVHu0G4FwHjQ7QTxj5RO5wUdQ2EQEr/zElUqbcvVZ+joiXg/uY7 fRaxYk4dAsngqY80aP/yl7ocpojQjX8CvOXY1nAYjP7vSkWq8oAaiFEZR9soroZmzsmC BgbB1Rl+gAscLcOcnzkbNVsLj4fSljp3lZv6terzwJcq8zVEio9p2rmFguNJaxk/lSKz lB7Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=6FMoQTYi22M50a6bpNFQLlIDcDebl7FJk51pGUhmKsg=; b=itf9MMf1GEriFXrUD0IpaGLOgXoiX5xDZ8OoOimeOcnJiPsou2YgchIvT74ou1Tvhg raRsDIEN3LCX9D+VeFm8eSMAD6SxYjfT/Tw96Vx7GCF6tQpTtTg07xDVjw9NX+NXUL6G BZAEXl9MDUq5leyd8GPOyvZbeXNggO63Vtj2dq1Qd+3OVmtMzbHii8GRlLbO05DNoAir zQ1HWLPq8KPtITMIL3Xj8qWSSHMeUq+95YKPtoC2ZAvjbYF4XTDqhhyp8FPlcTpJ6wKX bazXJwkZQlI0F58NEEmQBBuLewmjkW3PpW728/IDq/uCo22npP5riozVDV04HcwUY9i9 lKuA== X-Gm-Message-State: AOAM5321QIWav6Eh1Q9VdmzYqZs0jaVQK/YZlH/dCmK+HYDOx0iC6GbT WAItHBE0eKE/cYKpFZzLfG3XvMqCU/69b1Kg X-Google-Smtp-Source: ABdhPJxdNgycsEPGXc9AS1z287sgBoYCpzbelRFoKPpYJUrgcPR2pSv7Ac2QmIvIkAoLh9rrYBfziw== X-Received: by 2002:a37:bb44:: with SMTP id l65mr2718263qkf.64.1632873205315; Tue, 28 Sep 2021 16:53:25 -0700 (PDT) Received: from localhost.localdomain ([37.218.244.251]) by smtp.gmail.com with ESMTPSA id k10sm460992qkk.124.2021.09.28.16.53.23 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 28 Sep 2021 16:53:24 -0700 (PDT) From: Glenn Washburn To: grub-devel@gnu.org, Daniel Kiper Cc: Glenn Washburn Subject: [PATCH] docs: Add fuller accounting of make check prerequisites Date: Tue, 28 Sep 2021 18:52:55 -0500 Message-Id: <20210928235255.688975-1-development@efficientek.com> X-Mailer: git-send-email 2.27.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=2607:f8b0:4864:20::72d; envelope-from=development@efficientek.com; helo=mail-qk1-x72d.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 28 Sep 2021 23:53:31 -0000 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 --- 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