forked from mmatuska/mfsbsd
/
BUILD
68 lines (52 loc) · 2.29 KB
/
BUILD
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
# $Id$
#
# mfsBSD building instructions
# Copyright (c) 2007-2013 Martin Matuska <mm at FreeBSD.org>
#
# Version 2.1
BUILDING INSTRUCTIONS:
1. Configuration
Read hints in the sample configuration files in the conf/ directory, copy
these files to files without .sample ending and make modifications to suit
your needs.
2. Additional packages and files
If you want any packages installed, copy the .tbz files that should be
automatically installed into the packages/ directory.
Add any additional files into the customfiles/ directory. These will be copied
recursively into the root of the boot image.
WARNING: Your image should not exceed 45MB in total, otherwise kernel panic
may occur on boot-time. To allow bigger images, you have to
recompile your kernel with increased NKPT (e.g. NKPT=120)
3. Distribution or custom world and kernel
You may choose to build from a FreeBSD distribution (e.g. CDROM), or by
using make buildworld / buildkernel from your own world and kernel
configuration.
To use a distribution (e.g. FreeBSD cdrom), you need access to it
(e.g. a mounted FreeBSD ISO via mdconfig) and use BASE=/path/to/distribution
To use your own but already built world and kernel, use CUSTOM=1
If you want this script to do make buildworld and make buildkernel for you,
use BUILDWORLD=1 and BUILDKERNEL=1
4. Creating images
You may create three types of output: disc image for use by dd(1),
ISO image or a simple .tar.gz file
Examples:
a) disc image
make BASE=/cdrom/usr/freebsd-dist
make BASE=/cdrom/11.0-RELEASE
make CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1
b) bootable ISO file:
make iso BASE=/cdrom/usr/freebsd-dist
make iso BASE=/cdrom/11.0-RELEASE
make iso CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1
c) .tar.gz file:
make tar BASE=/cdrom/usr/freebsd-dist
make tar BASE=/cdrom/11.0-RELEASE
make tar CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1
d) roothack edition:
make iso CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1 ROOTHACK=1
e) special edition (with FreeBSD distribution):
make iso BASE=/cdrom/11.0-RELEASE RELEASE=11.0-RELEASE ARCH=amd64
f) GCE-compatible .tar.gz file:
make gce BASE=/cdrom/usr/freebsd-dist
make gce BASE=/cdrom/11.0-RELEASE
make gce CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1