1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
|
IP Engineering Rescue Disk
==========================
The IP Egineering Rescue Disk is not a disk or set of disks, but rather
a framework which allows an administrator to download collections of boot
images for packaging into either bootable ISO images, bootable USB pen drives,
or network shares for PXE booting.
Table of Contents
-----------------
* Disclaimer
* Maintainers
* Quick Start
* Directory Structure
* Distro Definition
* Compatibility
* Source Code
Disclaimer
==========
This software is provided by the copyright holders and contributors "as
is" and any express or implied warranties, including, but not limited to,
the implied warranties of merchantability and fitness for a particular
purpose are disclaimed. In no event shall David M. Syzdek be liable for
any direct, indirect, incidental, special, exemplary, or consequential
damages (including, but not limited to, procurement of substitute goods or
services; loss of use, data, or profits; or business interruption) however
caused and on any theory of liability, whether in contract, strict
liability, or tort (including negligence or otherwise) arising in any way
out of the use of this software, even if advised of the possibility of
such damage.
Maintainers
===========
David M. Syzdek
david@syzdek.net
Requirements
============
Build requirements:
* Bash shell
* GNU Make
* GNU Mtools
* GNU GCC
* wget
* GNU Grub 2
* cdrtools
Network boot requirements:
* DHCP Server (dnsmasq configuration included)
* TFTP Server (dnsmasq configuration included)
* HTTP Server (busybox httpd widget instructions included)
Quick Start
===========
Configure images and disk options:
make configure
Download files:
make download
Make ISO image and USB images in `images/`:
make images
Make bootable USB thumbdrive:
make thumbdrive DISK=/dev/sdX
Directory Structure
===================
* `EFI/BOOT/` - UEFI boot files
* `boot/<distro>/` - Distribution images
* `boot/grub/` - Grub binaries and configurations
* `doc/` - Additional documentation
* `images/` - Generated IPERD images
* `src/distros/<distro>/` - Distro definition
* `src/grub/` - Grub templates and build files
* `src/scripts/` - helper scripts
* `src/syslinux/` - Syslinux templates and build files
* `tmp/` - Download and build cache
* `var/config/` - Configuration files
Distro Definition
-----------------
* `./broken` - existence indicates broken distro
* `./broken.efi` - existence indicates broken UEFI implementation
* `./broken.iso` - existence indicates broken ISO implementation
* `./broken.pxe` - existence indicates broken PXE implementation
* `./broken.sys` - existence indicates broken USB implementation
* `./cfg.header` - start of syslinux configuration
* `./cfg.header.iso.efi` - start of grub configuration for UEFI ISO
* `./cfg.label` - default syslinux label template
* `./cfg.label.iso` - syslinux label template for ISO images
* `./cfg.label.iso.efi` - grub menuentry template for UEFI ISO images
* `./cfg.label.pxe` - syslinux label template for PXE labels
* `./cfg.label.sys` - syslinux label template for USB labels
* `./cfg.footer` - end of syslinux configuration
* `./cfg.footer.iso.efi` - end of grub configuration for UEFI ISO
* `./make.header` - start of Makefile definitions for distro
* `./make.boot` - Makefile targets for distro
* `./make.footer` - end of Makefile definitions for distro
* `./option` - list of distro variants (single option)
* `./options` - list of distro variants (multiple options)
Compatibility
=============
+-------------------+-----------------+-----------------+-----------------+
| | USB Boot | CD Boot | Net Boot |
| | BIOS UEFI | BIOS UEFI | BIOS UEFI |
| Boot Images +-----------------+-----------------+-----------------+
| | 32 | 64 | 64 | 32 | 64 | 64 | 32 | 64 | 64 |
+--------------+----+-----+-----+-----+-----+-----+-----+-----+-----+-----+
| Alpine Linux | Y | Y | N | N | N | N | N | N | N |
| Archboot | ? | ? | ? | ? | ? | ? | ? | ? | ? |
| CentOS Install | n/a | Y | Y | n/a | Y | Y | n/a | Y | Y |
| DBAN | Y | - | - | Y | - | - | - | - | - |
| Debian Install | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| Memtest86+ | Y | - | - | Y | - | - | ? | - | - |
| Slackware Install | Y | Y | Y | Y | Y | Y | Y | Y | Y |
| TinyCore | Y | n/a | n/a | Y | n/a | n/a | ? | n/a | n/a |
| Ubuntu Install | Y | Y | Y | Y | Y | Y | Y | Y | Y |
+-------------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+
Source Code
===========
The source code for this project is maintained using git
(http://git-scm.com). The following contains information to checkout the
source code from the git repository.
Browse Source:
https://github.com/syzdek/iperd
Downloading Source:
$ git clone https://github.com/syzdek/iperd.git
Preparing Source:
$ cd iperd
$ make configure
Git Branches:
master - Current release of packages.
next - changes staged for next release
pu - proposed updates for next release
xx/yy+ - branch for testing new changes before merging to 'pu' branch
|
