Differences

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

--- wimboot [2015/07/20 12:47]
mcb30
+++ wimboot [2021/02/15 13:41]
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 ====
@@ 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 =====