From 981650d285e69708db8da3ecb95c857544a4224b Mon Sep 17 00:00:00 2001
From: Leah Rowe <info@minifree.org>
Date: Fri, 14 Oct 2016 16:42:07 +0100
Subject: Add guides for installing FreeBSD and NetBSD on a libon a libreboot
systemm
---
docs/bsd/netbsd.html | 301 +++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 301 insertions(+)
create mode 100644 docs/bsd/netbsd.html
(limited to 'docs/bsd/netbsd.html')
diff --git a/docs/bsd/netbsd.html b/docs/bsd/netbsd.html
new file mode 100644
index 00000000..f18b6824
--- /dev/null
+++ b/docs/bsd/netbsd.html
@@ -0,0 +1,301 @@
+<!DOCTYPE html>
+<html>
+<head>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+
+ <style type="text/css">
+ @import url('../css/main.css');
+ </style>
+
+ <title>How to install NetBSD on a libreboot system</title>
+</head>
+
+<body>
+ <div id="pagetop" class="section">
+ <h1>How to install NetBSD on a libreboot system</h1>
+ <p>
+ This section relates to preparing, booting and installing
+ NetBSD on your libreboot system, using nothing more than a USB flash drive (and <i>dd</i>). They've only been tested on a librebooted ThinkPad X60.
+ </p>
+ <p>
+ It is expected that you use text mode in libreboot (txtmode images),
+ for the early boot process in NetBSD.
+ <strong>Suspend/hibernate is broken, according to at least 1 user.</strong>
+ </p>
+ <p>
+ Thanks go to ioxcide in <a href="https://www.reddit.com/r/BSD/comments/53jt70/libreboot_and_bsds/">this Reddit post</a>
+ for the initial instructions.
+ </p>
+ <ul>
+ <li><a href="#prepare">Prepare the USB drive (in NetBSD)</a></li>
+ <li><a href="#noencryption">Installing NetBSD without full disk encryption</a></li>
+ <li><a href="#encryption">Installing NetBSD with full disk encryption</a></li>
+ <li><a href="#booting">Booting</a></li>
+ <li><a href="#configuring_grub">Configuring Grub</a></li>
+ <li><a href="#troubleshooting">Troubleshooting</a></li>
+ </ul>
+ <p>
+ <a href="index.html">Back to previous index</a>
+ </p>
+ </div>
+
+ <div class="section">
+ <p>
+ <b>This section is only for the GRUB payload. For depthcharge (used on CrOS devices in libreboot), instructions
+ have yet to be written in the libreboot documentation.</b>
+ </p>
+ </div>
+
+ <div id="prepare" class="section">
+
+ <p>
+ netbsd.iso is the installation image for NetBSD. Adapt
+ the filename accordingly, for your version of NetBSD.
+ </p>
+
+ <h2>Prepare the USB drive (in NetBSD)</h2>
+ <p>
+ <a href="https://wiki.netbsd.org/tutorials/how_to_install_netbsd_from_an_usb_memory_stick/">This page</a>
+ on the NetBSD website shows how to create a NetBSD bootable USB drive
+ from within NetBSD itself. You should use the <em>dd</em> method
+ documented there.
+ </p>
+
+ <h2>Prepare the USB drive (in FreeBSD)</h2>
+ <p>
+ <a href="https://www.freebsd.org/doc/handbook/bsdinstall-pre.html">This page</a>
+ on the FreeBSD website shows how to create a bootable USB drive
+ for installing FreeBSD. Use the <em>dd</em> on that page. You can
+ also use the same instructions with a NetBSD ISO image.
+ </p>
+
+ <h2>Prepare the USB drive (in LibertyBSD or NetBSD)</h2>
+
+ <p>
+ If you downloaded your ISO on a LibertyBSD or NetBSD system,
+ here is how to create the bootable NetBSD USB drive:
+ </p>
+
+ <p>
+ Connect the USB drive. Check dmesg:<br/>
+ <b>$ dmesg | tail</b><br/>
+
+ Check to confirm which drive it is, for example, if you think its sd3:<br/>
+ <b>$ disklabel sd3</b>
+ </p>
+
+ <p>
+ Check that it wasn't automatically mounted. If it was, unmount it. For example:<br/>
+ <b>$ doas umount /dev/sd3i</b><br/>
+ </p>
+
+ <p>
+ dmesg told you what device it is. Overwrite the drive, writing the NetBSD installer to it with dd. For example:<br/>
+ <b>$ doas netbsd.iso of=/dev/rsdXc bs=1M; sync</b><br/>
+ </p>
+
+ <p>
+ You should now be able to boot the installer from your USB drive. Continue reading, for
+ information about how to do that.
+ </p>
+
+ <p>
+ <a href="#pagetop">Back to top of page</a>.
+ </p>
+
+ <h2>Prepare the USB drive (in GNU/Linux)</h2>
+
+ <p>
+ If you downloaded your ISO on a GNU/Linux system,
+ here is how to create the bootable NetBSD USB drive:
+ </p>
+
+ <p>
+ Connect the USB drive. Check dmesg:<br/>
+ <b>$ dmesg</b><br/>
+
+ Check lsblk to confirm which drive it is:<br/>
+ <b>$ lsblk</b>
+ </p>
+
+ <p>
+ Check that it wasn't automatically mounted. If it was, unmount it. For example:<br/>
+ <b>$ sudo umount /dev/sdX*</b><br/>
+ <b># umount /dev/sdX*</b>
+ </p>
+
+ <p>
+ dmesg told you what device it is. Overwrite the drive, writing your distro ISO to it with dd. For example:<br/>
+ <b>$ sudo dd if=install60.fs of=/dev/sdX bs=8M; sync</b><br/>
+ <b># dd if=netbsd.iso of=/dev/sdX bs=8M; sync</b>
+ </p>
+
+ <p>
+ You should now be able to boot the installer from your USB drive. Continue reading, for
+ information about how to do that.
+ </p>
+
+ <p>
+ <a href="#pagetop">Back to top of page</a>.
+ </p>
+
+ </div>
+
+
+ <div id="noencryption" class="section">
+
+ <h2>Installing NetBSD without full disk encryption</h2>
+
+ <p>
+ You might have to use an external USB keyboard during the installation.
+ Press C to access the GRUB terminal.
+ </p>
+ <p>
+ grub> <b>knetbsd -r sd0a (usb0,netbsd1)/netbsd</b><br/>
+ grub> <b>boot</b>
+ </p>
+ <p>
+ It will start booting into the NetBSD installer. Follow the normal process for installing NetBSD.
+ </p>
+
+ <p>
+ <a href="#pagetop">Back to top of page</a>.
+ </p>
+
+ </div>
+
+ <div id="encryption" class="section">
+
+ <h2>Installing NetBSD with full disk encryption</h2>
+
+ <p>
+ TODO
+ </p>
+
+ <p>
+ <a href="#pagetop">Back to top of page</a>.
+ </p>
+
+ </div>
+
+ <div id="booting" class="section">
+
+ <h2 id="booting">Booting</h2>
+
+ <p>
+ Press C in GRUB to access the command line:
+ </p>
+ <p>
+ grub> <b>knetbsd -r wd0a (ahci0,netbsd1)/netbsd</b><br/>
+ grub> <b>boot</b>
+ </p>
+ <p>
+ i NetBSD will start booting. Yay!
+ </p>
+
+ <p>
+ <a href="#pagetop">Back to top of page</a>.
+ </p>
+
+ </div>
+
+ <div id="configuring_grub" class="section">
+
+ <h2>Configuring Grub</h2>
+
+ <p>
+ If you don't want to drop to the GRUB command line and type in a command to boot NetBSD every time, you can create a GRUB configuration that's aware of your NetBSD installation and that will automatically be used by libreboot.
+ </p>
+ <p>
+ On your NetBSD root partition, create the <b>/grub</b> directory and add the file <b>libreboot_grub.cfg</b> to it. Inside the <b>libreboot_grub.cfg</b> add these lines:
+ <p><b>
+ default=0
+ timeout=3
+ menuentry "NetBSD" {<br>
+ knetbsd -r wd0a (ahci0,netbsd1)/netbsd<br>
+ }<br>
+ </b></p>
+ <p>The next time you boot, you'll see the old Grub menu for a few seconds, then you'll see the a new menu with only NetBSD on the list. After 3 seconds NetBSD will boot, or you can hit enter to boot.
+ <p>
+ <a href="#pagetop">Back to top of page</a>.
+ </p>
+
+ </div>
+
+ <div id="troubleshooting" class="section">
+
+ <h1>Troubleshooting</h1>
+
+ <p>
+ Most of these issues occur when using libreboot with coreboot's 'text mode' instead of the coreboot framebuffer.
+ This mode is useful for booting payloads like memtest86+ which expect text-mode, but for NetBSD
+ it can be problematic when they are trying to switch to a framebuffer because it doesn't exist.
+ </p>
+
+ <p>
+ In most cases, you should use the vesafb ROM images. Example filename: libreboot_ukdvorak_vesafb.rom.
+ </p>
+
+ <h2>won't boot...something about file not found</h2>
+ <p>
+ Your device names (i.e. usb0, usb1, sd0, sd1, wd0, ahci0, hd0, etc) and numbers may differ. Use TAB completion.
+ </p>
+
+ <p>
+ <a href="#pagetop">Back to top of page</a>.
+ </p>
+
+ </div>
+
+ <div class="section">
+
+ <p>
+ Copyright © 2016 Leah Rowe <info@minifree.org><br/>
+ Copyright © 2016 Scott Bonds <scott@ggr.com><br/>
+ Permission is granted to copy, distribute and/or modify this document
+ under the terms of the Creative Commons Attribution-ShareAlike 4.0 International license
+ or any later version published by Creative Commons;
+
+ A copy of the license can be found at <a href="../cc-by-sa-4.0.txt">../cc-by-sa-4.0.txt</a>
+ </p>
+
+ <p>
+ Updated versions of the license (when available) can be found at
+ <a href="https://creativecommons.org/licenses/by-sa/4.0/legalcode">https://creativecommons.org/licenses/by-sa/4.0/legalcode</a>
+ </p>
+
+ <p>
+ UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
+ EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
+ AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
+ ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
+ IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
+ WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
+ PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
+ ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
+ KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
+ ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
+ </p>
+ <p>
+ TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
+ TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
+ NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
+ INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
+ COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
+ USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
+ ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
+ DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
+ IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
+ </p>
+ <p>
+ The disclaimer of warranties and limitation of liability provided
+ above shall be interpreted in a manner that, to the extent
+ possible, most closely approximates an absolute disclaimer and
+ waiver of all liability.
+ </p>
+
+ </div>
+
+</body>
+</html>
--
cgit v1.2.3-70-g09d2