Differences

This shows you the differences between two versions of the page.

--- wimboot [2015/07/20 12:47]
mcb30
+++ wimboot [2021/04/30 11:01] (current)
mcb30
@@ Line 1: / Line 1: @@
 ====== wimboot ======
-''wimboot'' is a boot loader for Windows Imaging Format (''.wim'') files.  It enables you to boot a [[http://en.wikipedia.org/wiki/Windows_Preinstallation_Environment|Windows PE (WinPE)]] environment from a RAM disk, without wasting the memory used for the RAM disk image.
+''wimboot'' is a boot loader for Windows Imaging Format (''.wim'') files.  It enables you to boot into a [[https://en.wikipedia.org/wiki/Windows_Preinstallation_Environment|Windows PE (WinPE)]] deployment or recovery environment.
-You can use ''wimboot'' with [[:start|iPXE]] to [[:howto:winpe|boot Windows PE via HTTP]].  With a Gigabit Ethernet network, a typical 200MB WinPE image should download in less than two seconds.
+You can use ''wimboot'' with [[:start|iPXE]] to [[:howto:winpe|boot Windows PE via HTTP]].  With a Gigabit Ethernet network, a typical WinPE image should download in just a few seconds.
 ===== Advantages =====
@@ Line 23: / Line 23: @@
 == BIOS/UEFI compatibility ==
-''wimboot'' allows you to use a single procedure and set of files to boot under both BIOS and UEFI environments.
+''wimboot'' allows you to use a single configuration and set of files to boot under both BIOS and UEFI environments.
 ===== Download =====
-You can download the latest version from [[http://git.ipxe.org/releases/wimboot/wimboot-latest.zip]].
+You can download the latest version of the ''wimboot'' binary from [[https://github.com/ipxe/wimboot/releases/latest/download/wimboot]].  This is a hybrid binary that will work on both BIOS and 64-bit UEFI systems (including UEFI systems with Secure Boot enabled).
-Older versions are available from [[http://git.ipxe.org/releases/wimboot]].  The source code is maintained in a ''git'' repository at [[http://git.ipxe.org/wimboot.git]].
+You can also download alternative binaries (e.g. for 32-bit UEFI systems) from [[https://github.com/ipxe/wimboot/releases/latest]].
+Older versions are available from [[https://github.com/ipxe/wimboot/releases]].
+The source code is maintained in a ''git'' repository at [[https://github.com/ipxe/wimboot]].
 ===== Getting started =====
@@ Line 49: / Line 53: @@
 ==== Download wimboot ====
-Download the [[http://git.ipxe.org/releases/wimboot/wimboot-latest.zip|latest version of wimboot]] and extract the file ''wimboot'' to the same directory on your web server.
+Download the [[https://github.com/ipxe/wimboot/releases/latest/download/wimboot|latest version of wimboot]] and save it to the same directory on your web server.
 ==== Create the iPXE script ====
@@ Line 75: / Line 79: @@
 You can use ''wimboot'' to boot any bootable ''.wim'' image.  See the [[:howto:winpe|Windows PE tutorial]] for information on how to create and customise your own ''.wim'' images.
-===== Licence and source code =====
+===== Licence =====
-''wimboot'' is free, open-source software licensed under the [[http://www.gnu.org/licenses/old-licenses/gpl-2.0.html|GNU GPL]].  You can obtain the source code from [[http://git.ipxe.org/wimboot.git]].
+''wimboot'' is free, open-source software licensed under the [[https://www.gnu.org/licenses/old-licenses/gpl-2.0.html|GNU GPL]].
-{{ :clipart:smile.png?100x100 |A smile}}
+===== Sponsors =====
+Portions of the ''wimboot'' development have been sponsored by:
+[[https://jumptrading.com|{{ :logos:jump.png?165x37 |Jump Trading}}]]
+[[https://2pintsoftware.com|{{ :logos:2pint.png?106x33 |2Pint Software}}]]
+[[https://digitalintelligence.com|{{ :logos:digitalintelligence.png?150x28 |Digital Intelligence}}]]
 ===== Advanced topics =====
@@ Line 90: / Line 102: @@
     kernel wimboot index=2
+==== Injected files ====
+You can provide additional files to ''wimboot''.  These files will appear within the ''X:\Windows\System32'' directory.  For example:
+    kernel wimboot
+    initrd winpeshl.ini     winpeshl.ini
+    initrd startup.bat      startup.bat
+    initrd boot/bcd         BCD
+    initrd boot/boot.sdi    boot.sdi
+    initrd sources/boot.wim boot.wim
+    boot
+You can use this to control the boot process after Windows PE has started.  For example, you can use a [[:howto:winpe#adding_a_startup_batch_file|startup batch file]] to automatically start the Windows installer from a network share.
+You can disable this behaviour by using the ''rawwim'' command-line option.  For example:
+    kernel wimboot rawwim
 ==== Custom boot manager ====
-''wimboot'' will attempt to extract an appropriate boot manager (such as ''bootmgr.exe'' or ''bootmgfw.efi'') from the WIM file.
+''wimboot'' will attempt to extract an appropriate boot manager (such as ''bootmgr'', ''bootmgr.exe'' or ''bootmgfw.efi'') from the WIM file.
 You can disable this behaviour by explicitly providing an appropriate set of boot manager binaries.  For example:
@@ Line 108: / Line 138: @@
     kernel wimboot rawbcd
+==== Disabling debug messages ====
+''wimboot'' will display some debug messages by default, to assist in diagnosing problems that may occur during booting.
+You can disable these debug messages by using the ''quiet'' command-line option.  For example:
+    kernel wimboot quiet
 ==== Displaying graphical boot messages ====
@@ Line 120: / Line 158: @@
     initrd boot/fonts/segoen_slboot.ttf segoen_slboot.ttf
     initrd boot/fonts/wgl4_boot.ttf     wgl4_boot.ttf
+==== Disabling paging ====
+''wimboot'' will automatically use paging to relocate the data files above 4GB if possible, to allow for the use of large ''.wim'' files on BIOS systems.
+You can disable this behaviour by using the ''linear'' command-line option.  For example:
+    kernel wimboot linear
 ===== Internals =====