Skip to content

Latest commit

 

History

History
81 lines (58 loc) · 2.1 KB

BUILD.md

File metadata and controls

81 lines (58 loc) · 2.1 KB

mfsBSD building instructions

Copyright (c) 2007-2016 Martin Matuska

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.

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 MFSROOT_MAXSIZE in total. Please adjust the variable for larger images.

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

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

  1. disc image
make BASE=/cdrom/usr/freebsd-dist
make BASE=/cdrom/10.2-RELEASE
make CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1
  1. bootable ISO file:
make iso BASE=/cdrom/usr/freebsd-dist
make iso BASE=/cdrom/10.2-RELEASE
make iso CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1
  1. .tar.gz file:
make tar BASE=/cdrom/usr/freebsd-dist
make tar BASE=/cdrom/10.2-RELEASE
make tar CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1
  1. roothack edition:
make iso CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1 ROOTHACK=1
  1. special edition (with FreeBSD distribution):
make iso BASE=/cdrom/11.0-RELEASE RELEASE=11.0-RELEASE ARCH=amd64
  1. GCE-compatible .tar.gz file:
make gce BASE=/cdrom/11.0-RELEASE
make gce CUSTOM=1 BUILDWORLD=1 BUILDKERNEL=1