##// END OF EJS Templates
Merge pull request #19 from g-vidal/drtyhlpr-master...
Gérard Vidal -
r247:2f699206ed0f Fusion
parent child
Show More
1 NO CONTENT: new file 100644, binary diff hidden
@@ -0,0 +1,22
1 ## Templates used at IFÉ ENS de Lyon for "Tremplin des sciences" project
2
3 These templates have been used to create Raspberry Pi images for the
4 project "Climate and meteorolgy springboard for teaching sciences".
5 These images are tuned andused as explained in the
6 [blog](http://blog.climatetmeteo.fr/GerardVidal/) (mostly in french
7 but under translation).
8
9 The aim is to share with teachers a Raspberry Pi3 binary image providing software resources to use commercial weatherstations or DIY weathersystems made with various sensors. The following images have been built :
10
11 * raspife2-stretch Debian stretch image for raspi 2
12 * raspife3-jessie Debian jessie image for raspi 3
13 * raspife3-stretch Debian stretch image for raspi 3
14 * raspife3W-stretch Debian stretch image for raspi 3 with single IPAddress and weewx service
15 * raspife3-buster Debian buster image for raspi 3
16
17 In these images language ichoosen is french and can easily be changed.
18 Pathes and other variables are the ones that have been used during
19 execution and personnal data are replaced by "*******", change the
20 values according to your needs.
21
22
@@ -0,0 +1,80
1 Configuration file raspife2 Stretch IFÉ 2017/02/24
2 #
3 APT_SERVER=ftp.fr.debian.org
4 APT_INCLUDES="gnupg,gnupg2,firmware-realtek,firmware-linux-nonfree,firmware-linux,tightvncserver,build-essentia$
5 bison,libboost-all-dev,automake,autoconf,autogen,libtool,pkg-config,checkinstall,python3,python3-dev,menulibre,$
6 libnotify-bin,python,python-configobj,python-cheetah,python-imaging,python-serial,python-usb,python-dev,\
7 pcre2-utils,libpcre++-dev,libpcre2-dev,libjpeg-dev,jed,i2c-tools,python-smbus,policykit-1,usbutils,\
8 pmount,python-pip,python3-pip,geany,geany-plugin-py,geany-plugin-markdown,firefox-esr,firefox-esr-l10n-fr,\
9 icedtea-8-plugin,openjdk-8-jdk,openjdk-8-jre,openjdk-8-jre-headless,libqtwebkit-dev,libqt5webkit5-dev,\
10 libudev-dev,libzzip-dev,zlib1g-dev,libcanberra-gtk-module,libnss-myhostname,libfreetype6-dev,libpng16-16,\
11 lxsession,openbox-lxde-session,lxde"
12 #----------------------
13 RPI_MODEL=2
14 RELEASE="stretch"
15 HOSTNAME="raspife2"
16 PASSWORD="***********"
17 USER_PASSWORD="**************"
18 DEFLOCAL="fr_FR.UTF-8"
19 TIMEZONE="Europe/Paris"
20 EXPANDROOT=false
21 #-----------------------
22 XKB_MODEL="pc105"
23 XKB_LAYOUT="fr"
24 XKB_VARIANT="latin9"
25 XKB_OPTIONS=""
26 #------------------------
27 ENABLE_DHCP=true
28 #------------------------
29 ENABLE_CONSOLE=true
30 ENABLE_I2C=true
31 ENABLE_SPI=true
32 ENABLE_IPV6=true
33 ENABLE_SSHD=true
34 ENABLE_NONFREE=true
35 ENABLE_WIRELESS=false
36 ENABLE_RSYSLOG=true
37 ENABLE_SOUND=true
38 ENABLE_HWRANDOM=true
39 ENABLE_MINGPU=true
40 ENABLE_DBUS=true
41 ENABLE_XORG=true
42 ENABLE_WM="lxdm"
43 #------------------------
44 ENABLE_MINBASE=false
45 ENABLE_REDUCE=false
46 ENABLE_UBOOT=false
47 ENABLE_FBTURBO=true
48 ENABLE_IPTABLES=false
49 ENABLE_USER=true
50 USER_NAME=ens-ife
51 ENABLE_ROOT=true
52 ENABLE_HARDNET=true
53 ENABLE_INITRAMFS=true
54 ENABLE_IFNAMES=true
55 #------------------------
56 ENABLE_ROOT_SSH=false
57 SSH_LIMIT_USERS=false
58 SSH_ROOT_PUB_KEY="/home/********/.ssh/authorized_keys"
59 SSH_USER_PUB_KEY="/home/********/.ssh/authorized_keys"
60 #------------------------
61 BUILD_KERNEL=true
62 KERNEL_REDUCE=false
63 KERNEL_HEADERS=true
64 KERNEL_REMOVESRC=true
65 KERNELSRC_CLEAN=true
66 KERNELSRC_CONFIG=true
67 #------------------------
68 REDUCE_APT=false
69 REDUCE_DOC=true
70 REDUCE_MAN=false
71 REDUCE_HWDB=true
72 REDUCE_BASH=false
73 REDUCE_SSHD=false
74 REDUCE_LOCALE=false
75 #-------------------------
76 ENABLE_CRYPTFS=false
77 #-------------------------
78 BASEDIR=/media/********/images/${RELEASE}
79 DATE=date
80 +%Y-%m-%d IMAGE_NAME=${BASEDIR}/${DATE}-rpi${RPI_MODEL}-${RELEASE}
@@ -0,0 +1,98
1 # Configuration file raspi3 Buster IFÉ 2017/11/01
2 #
3 APT_SERVER=debian.mirrors.ovh.net
4 APT_INCLUDES=""
5 APT_INCLUDES_LATE="gnupg,firmware-linux-nonfree,firmware-linux,dh-autoreconf,\
6 gettext,build-essential,git,cmake,libjson-c-dev,unzip,usbutils,\
7 bison,libboost-all-dev,automake,autoconf,autogen,libtool,libtool-bin,\
8 pkg-config,checkinstall,menulibre,libnotify-bin,pandoc,\
9 python3,python3-dev,python3-pypandoc,python3-scipy,python3-tk,python3-pandocfilters,\
10 python3-geopy,python3-pip,\
11 python,python-dev,python-pypandoc,python-scipy,python-tk,python-pandocfilters,\
12 python-geopy,python-pip,python-tk,pandoc,\
13 python-configobj,python-cheetah,python-imaging,python-serial,python-usb,\
14 pcre2-utils,libpcre++-dev,libpcre2-dev,libjpeg-dev,i2c-tools,python-smbus,policykit-1,\
15 pmount,ntpdate,ntp,rsync,\
16 texlive,texlive-xetex,nginx-extras,ffmpeg,wicd,wicd-gtk,console-data,keyboard-configuration,\
17 libqtwebkit-dev,libqt5webkit5-dev,\
18 libudev-dev,libzzip-dev,zlib1g-dev,libcanberra-gtk-module,libnss-myhostname,libfreetype6-dev,libpng16-16,\
19 nmap,libltdl-dev,dbus-user-session,debian-archive-keyring,\
20 xutils-dev,lxsession,openbox-lxde-session,lxde,x11proto-randr-dev,lxrandr,\
21 tightvncserver,geany,geany-plugin-py,firefox-esr,firefox-esr-l10n-fr,jed,terminator,automake"
22 #ca-certificates-java,icedtea-plugin,icedtea-netx,\
23 #openjdk-8-jdk,openjdk-8-jre,openjdk-8-jre-headless,\
24 #openjdk-9-jdk,openjdk-9-jre,openjdk-9-jre-headless"
25 #----------------------
26 RPI_MODEL=3
27 RELEASE="buster"
28 RELEASE_ARCH="armhf"
29 HOSTNAME="raspife3"
30 PASSWORD="***********"
31 USER_PASSWORD="*************"
32 DEFLOCAL="fr_FR.UTF-8"
33 TIMEZONE="Europe/Paris"
34 EXPANDROOT=false
35 #-----------------------
36 XKB_MODEL="pc105"
37 XKB_LAYOUT="fr"
38 XKB_VARIANT="latin9"
39 XKB_OPTIONS=""
40 #------------------------
41 ENABLE_DHCP=true
42 #------------------------
43 ENABLE_CONSOLE=false
44 ENABLE_I2C=true
45 ENABLE_SPI=true
46 ENABLE_IPV6=true
47 ENABLE_SSHD=true
48 ENABLE_NONFREE=true
49 ENABLE_WIRELESS=true
50 ENABLE_RSYSLOG=true
51 ENABLE_SOUND=true
52 ENABLE_HWRANDOM=true
53 ENABLE_MINGPU=true
54 ENABLE_DBUS=true
55 ENABLE_XORG=true
56 ENABLE_WM="lxdm"
57 #------------------------
58 ENABLE_MINBASE=false
59 ENABLE_REDUCE=false
60 ENABLE_UBOOT=false
61 ENABLE_FBTURBO=true
62 ENABLE_IPTABLES=false
63 ENABLE_USER=true
64 USER_NAME=ens-ife
65 ENABLE_ROOT=true
66 ENABLE_HARDNET=true
67 ENABLE_INITRAMFS=true
68 ENABLE_IFNAMES=true
69 #------------------------
70 ENABLE_ROOT_SSH=false
71 SSH_LIMIT_USERS=false
72 SSH_ROOT_PUB_KEY="/home/*****/.ssh/authorized_keys"
73 SSH_USER_PUB_KEY="/home/*****/.ssh/authorized_keys"
74 #------------------------
75 BUILD_KERNEL=true
76 KERNEL_BRANCH=rpi-4.13.y
77 KERNEL_REDUCE=false
78 KERNEL_HEADERS=true
79 KERNEL_REMOVESRC=true
80 KERNELSRC_CLEAN=true
81 KERNELSRC_CONFIG=true
82 #------------------------
83 REDUCE_APT=false
84 REDUCE_DOC=true
85 REDUCE_MAN=false
86 REDUCE_HWDB=true
87 REDUCE_BASH=false
88 REDUCE_SSHD=false
89 REDUCE_LOCALE=false
90 #-------------------------
91 ENABLE_CRYPTFS=false
92 #-------------------------
93 BASEDIR=/data/RpiGenImage/Images/${RELEASE}
94 #BASEDIR=/media/*******/*********/Nano-Ordinateurs/RaspberryPi/RpiGenImage/Images/${RELEASE}
95 DATE=`date +%Y-%m-%d`
96 IMAGE_NAME=${BASEDIR}/${DATE}-rpi${RPI_MODEL}-${RELEASE}
97
98
@@ -0,0 +1,106
1 # Configuration file raspi3 Buster IFÉ 2017/11/01
2 #
3 APT_SERVER=debian.mirrors.ovh.net
4 APT_INCLUDES=""
5 APT_INCLUDES_LATE=""
6 APT_INCLUDES_LATE="gnupg,firmware-linux-nonfree,firmware-linux,dh-autoreconf,\
7 gettext,build-essential,git,cmake,libjson-c-dev,unzip,usbutils,\
8 bison,libboost-all-dev,automake,autoconf,autogen,libtool,libtool-bin,\
9 pkg-config,checkinstall,menulibre,libnotify-bin,pandoc,\
10 python3,python3-dev,python3-pypandoc,python3-scipy,python3-tk,python3-pandocfilters,\
11 python3-geopy,python3-pip,\
12 python,python-dev,python-pypandoc,python-scipy,python-tk,python-pandocfilters,\
13 python-geopy,python-pip,python-tk,pandoc,\
14 python-configobj,python-cheetah,python-imaging,python-serial,python-usb,\
15 pcre2-utils,libpcre++-dev,libpcre2-dev,libjpeg-dev,i2c-tools,python-smbus,policykit-1,\
16 pmount,ntpdate,ntp,rsync,\
17 texlive,texlive-xetex,nginx-extras,ffmpeg,wicd,wicd-gtk,console-data,keyboard-configuration,\
18 libqtwebkit-dev,libqt5webkit5-dev,\
19 libudev-dev,libzzip-dev,zlib1g-dev,libcanberra-gtk-module,libnss-myhostname,libfreetype6-dev,libpng16-16,\
20 nmap,libltdl-dev,dbus-user-session,debian-archive-keyring,\
21 xutils-dev,lxsession,openbox-lxde-session,lxde,x11proto-randr-dev,lxrandr,\
22 tightvncserver,geany,geany-plugin-py,firefox-esr,firefox-esr-l10n-fr,jed"
23 #ca-certificates-java,icedtea-plugin,icedtea-netx,\
24 #openjdk-8-jdk,openjdk-8-jre,openjdk-8-jre-headless,\
25 #openjdk-9-jdk,openjdk-9-jre,openjdk-9-jre-headless"
26 #----------------------
27 RPI_MODEL=3
28 RELEASE=buster
29 RELEASE_ARCH="armhf"
30 HOSTNAME="raspife3"
31 PASSWORD="AChanger1$"
32 USER_PASSWORD="AChanger1$"
33 DEFLOCAL="fr_FR.UTF-8"
34 TIMEZONE="Europe/Paris"
35 EXPANDROOT=false
36 #-----------------------
37 XKB_MODEL="pc105"
38 XKB_LAYOUT="fr"
39 XKB_VARIANT="latin9"
40 XKB_OPTIONS=""
41 #------------------------
42 ENABLE_DHCP=true
43 #------------------------
44 ENABLE_CONSOLE=false
45 ENABLE_I2C=true
46 ENABLE_SPI=true
47 ENABLE_IPV6=true
48 ENABLE_SSHD=true
49 ENABLE_NONFREE=true
50 ENABLE_WIRELESS=true
51 ENABLE_RSYSLOG=true
52 ENABLE_SOUND=true
53 ENABLE_HWRANDOM=true
54 ENABLE_MINGPU=true
55 ENABLE_DBUS=true
56 ENABLE_XORG=true
57 ENABLE_WM="lxdm"
58 #------------------------
59 ENABLE_MINBASE=false
60 ENABLE_REDUCE=false
61 ENABLE_UBOOT=false
62 ENABLE_FBTURBO=true
63 ENABLE_IPTABLES=false
64 ENABLE_USER=true
65 USER_NAME=ens-ife
66 ENABLE_ROOT=true
67 ENABLE_HARDNET=true
68 ENABLE_INITRAMFS=true
69 ENABLE_IFNAMES=true
70 #------------------------
71 ENABLE_ROOT_SSH=false
72 SSH_LIMIT_USERS=false
73 SSH_ROOT_PUB_KEY="/home/vidal/.ssh/authorized_keys"
74 SSH_USER_PUB_KEY="/home/vidal/.ssh/authorized_keys"
75 #------------------------
76 BUILD_KERNEL=true
77 KERNEL_ARCH=arm64
78 RELEASE_ARCH=arm64
79 CROSS_COMPILE=aarch64-linux-gnu-
80 QEMU_BINARY=/usr/bin/qemu-aarch64-static
81 KERNEL_DEFCONFIG=bcmrpi3_defconfig
82 KERNEL_BIN_IMAGE=Image
83 KERNEL_IMAGE="kernel10.img"
84 KERNEL_BRANCH=rpi-4.13.y
85 KERNEL_REDUCE=false
86 KERNEL_HEADERS=true
87 KERNEL_REMOVESRC=true
88 KERNELSRC_CLEAN=true
89 KERNELSRC_CONFIG=true
90 #------------------------
91 REDUCE_APT=false
92 REDUCE_DOC=true
93 REDUCE_MAN=false
94 REDUCE_HWDB=true
95 REDUCE_BASH=false
96 REDUCE_SSHD=false
97 REDUCE_LOCALE=false
98 #-------------------------
99 ENABLE_CRYPTFS=false
100 #-------------------------
101 BASEDIR=/data/RpiGenImage/Images/${RELEASE}
102 #BASEDIR=/media/vidal/ExternGV/Nano-Ordinateurs/RaspberryPi/RpiGenImage/Images/${RELEASE}
103 DATE=`date +%Y-%m-%d`
104 IMAGE_NAME=${BASEDIR}/${DATE}-rpi${RPI_MODEL}-${RELEASE}
105
106
@@ -0,0 +1,4
1 # Configuration template file used by rpi23-gen-image.sh
2 RPI_MODEL=3
3 RELEASE=jessie
4 BUILD_KERNEL=true
@@ -0,0 +1,91
1 # Configuration file raspi3 Stretch IFÉ 2017/07/26
2 #
3 APT_SERVER=ftp.fr.debian.org
4 APT_INCLUDES="gnupg,gnupg2,firmware-linux-nonfree,firmware-linux,dh-autoreconf,\
5 gettext,build-essential,git,cmake,libjson-c-dev,unzip,usbutils,\
6 bison,libboost-all-dev,automake,autoconf,autogen,libtool,libtool-bin,\
7 pkg-config,checkinstall,menulibre,libnotify-bin,pandoc,\
8 python3,python3-dev,python3-pypandoc,python3-scipy,python3-tk,python3-pandocfilters,\
9 python,python-dev,python-pypandoc,python-scipy,python-tk,python-pandocfilters,\
10 python3-geopy,python3-pip,\
11 python-geopy,python-pip,\
12 python-configobj,python-cheetah,python-imaging,python-serial,python-usb,\
13 pcre2-utils,libpcre++-dev,libpcre2-dev,libjpeg-dev,jed,i2c-tools,python-smbus,policykit-1,\
14 pmount,ntpdate,\
15 texlive,texlive-xetex,nginx-extras,ffmpeg,wicd,wicd-gtk,console-data,keyboard-configuration,\
16 icedtea-8-plugin,openjdk-8-jdk,openjdk-8-jre,openjdk-8-jre-headless,libqtwebkit-dev,libqt5webkit5-dev,\
17 libudev-dev,libzzip-dev,zlib1g-dev,libcanberra-gtk-module,libnss-myhostname,libfreetype6-dev,libpng16-16,\
18 nmap,libltdl-dev,dbus-user-session,debian-archive-keyring,\
19 xutils-dev,lxsession,openbox-lxde-session,lxde,x11proto-randr-dev,lxrandr,\
20 tightvncserver,geany,geany-plugin-py,geany-plugin-markdown,firefox-esr,firefox-esr-l10n-fr"
21 #----------------------
22 RPI_MODEL=3
23 RELEASE="stretch"
24 HOSTNAME="raspife3"
25 PASSWORD="**************"
26 USER_PASSWORD="***************"
27 DEFLOCAL="fr_FR.UTF-8"
28 TIMEZONE="Europe/Paris"
29 EXPANDROOT=false
30 #-----------------------
31 XKB_MODEL="pc105"
32 XKB_LAYOUT="fr"
33 XKB_VARIANT="latin9"
34 XKB_OPTIONS=""
35 #------------------------
36 ENABLE_DHCP=true
37 #------------------------
38 ENABLE_CONSOLE=false
39 ENABLE_I2C=true
40 ENABLE_SPI=true
41 ENABLE_IPV6=true
42 ENABLE_SSHD=true
43 ENABLE_NONFREE=true
44 ENABLE_WIRELESS=true
45 ENABLE_RSYSLOG=true
46 ENABLE_SOUND=true
47 ENABLE_HWRANDOM=true
48 ENABLE_MINGPU=true
49 ENABLE_DBUS=true
50 ENABLE_XORG=true
51 ENABLE_WM="lxdm"
52 #------------------------
53 ENABLE_MINBASE=false
54 ENABLE_REDUCE=false
55 ENABLE_UBOOT=false
56 ENABLE_FBTURBO=true
57 ENABLE_IPTABLES=false
58 ENABLE_USER=true
59 USER_NAME=ens-ife
60 ENABLE_ROOT=true
61 ENABLE_HARDNET=true
62 ENABLE_INITRAMFS=true
63 ENABLE_IFNAMES=true
64 #------------------------
65 ENABLE_ROOT_SSH=false
66 SSH_LIMIT_USERS=false
67 SSH_ROOT_PUB_KEY="/home/*******/.ssh/authorized_keys"
68 SSH_USER_PUB_KEY="/home/*******/.ssh/authorized_keys"
69 #------------------------
70 BUILD_KERNEL=true
71 KERNEL_REDUCE=false
72 KERNEL_HEADERS=true
73 KERNEL_REMOVESRC=true
74 KERNELSRC_CLEAN=true
75 KERNELSRC_CONFIG=true
76 #------------------------
77 REDUCE_APT=false
78 REDUCE_DOC=true
79 REDUCE_MAN=false
80 REDUCE_HWDB=true
81 REDUCE_BASH=false
82 REDUCE_SSHD=false
83 REDUCE_LOCALE=false
84 #-------------------------
85 ENABLE_CRYPTFS=false
86 #-------------------------
87 BASEDIR=/data/RpiGenImage/Images/${RELEASE}
88 DATE=`date +%Y-%m-%d`
89 IMAGE_NAME=${BASEDIR}/${DATE}-rpi${RPI_MODEL}-${RELEASE}
90
91
@@ -0,0 +1,89
1 # Configuration file raspi3 Stretch Weewx IFÉ 2017/07/26
2 #
3 APT_SERVER=ftp.fr.debian.org
4 APT_INCLUDES="debian-archive-keyring,debian-keyring,automake,autoconf,autogen,gawk,gnupg,gnupg2,\
5 build-essential,git,cmake,libjson-c-dev,unzip,\
6 bison,libboost-all-dev,libtool,libtool-bin,pkg-config,checkinstall,libnotify-bin,pandoc,\
7 python3,python3-dev,python,python-dev,python-configobj,python-cheetah,python-mysqldb\
8 python-imaging,python-serial,python-usb,python-tk,python3-tk,python3-scipy,\
9 python-pypandoc,python3-pypandoc,python-pandocfilters,python3-pandocfilters,\
10 python-geopy,python3-geopy,python-pip,python3-pip,python-smbus,\
11 libudev-dev,libzzip-dev,zlib1g-dev,libnss-myhostname,libpng16-16,nmap,\
12 libltdl-dev,usbutils,pmount,ntpdate,texlive,texlive-xetex,nginx-extras,policykit-1,\
13 openjdk-8-jdk-headless,openjdk-8-jre-headless,\
14 pcre2-utils,libpcre++-dev,libpcre2-dev,libjpeg-dev,i2c-tools"
15 #----------------------
16 RPI_MODEL=3
17 RELEASE="stretch"
18 HOSTNAME="raspwife3"
19 PASSWORD="************"
20 USER_PASSWORD="************"
21 DEFLOCAL="fr_FR.UTF-8"
22 TIMEZONE="Europe/Paris"
23 EXPANDROOT=false
24 #-----------------------
25 XKB_MODEL="pc105"
26 XKB_LAYOUT="fr"
27 XKB_VARIANT="latin9"
28 XKB_OPTIONS=""
29 #------------------------
30 ENABLE_DHCP=false
31 NET_ADDRESS="192.168.***.***/24"
32 NET_GATEWAY="192.168.***.1"
33 NET_DNS_1="192.168.***.1"
34 NET_DNS_2="8.8.8.8"
35 #------------------------
36 ENABLE_CONSOLE=false
37 ENABLE_I2C=true
38 ENABLE_SPI=true
39 ENABLE_IPV6=true
40 ENABLE_SSHD=true
41 ENABLE_NONFREE=true
42 ENABLE_WIRELESS=true
43 ENABLE_RSYSLOG=true
44 ENABLE_SOUND=true
45 ENABLE_HWRANDOM=true
46 ENABLE_MINGPU=true
47 ENABLE_DBUS=true
48 ENABLE_XORG=false
49 ENABLE_WM=""
50 #------------------------
51 ENABLE_MINBASE=false
52 ENABLE_REDUCE=false
53 ENABLE_UBOOT=false
54 ENABLE_FBTURBO=false
55 ENABLE_IPTABLES=false
56 ENABLE_USER=true
57 USER_NAME=ens-ife
58 ENABLE_ROOT=true
59 ENABLE_HARDNET=true
60 ENABLE_INITRAMFS=true
61 ENABLE_IFNAMES=true
62 #------------------------
63 ENABLE_ROOT_SSH=false
64 SSH_LIMIT_USERS=false
65 SSH_ROOT_PUB_KEY="/home/*******/.ssh/authorized_keys"
66 SSH_USER_PUB_KEY="/home/*******/.ssh/authorized_keys"
67 #------------------------
68 BUILD_KERNEL=true
69 KERNEL_REDUCE=false
70 KERNEL_HEADERS=true
71 KERNEL_REMOVESRC=true
72 KERNELSRC_CLEAN=true
73 KERNELSRC_CONFIG=true
74 #------------------------
75 REDUCE_APT=false
76 REDUCE_DOC=true
77 REDUCE_MAN=false
78 REDUCE_HWDB=true
79 REDUCE_BASH=false
80 REDUCE_SSHD=false
81 REDUCE_LOCALE=false
82 #-------------------------
83 ENABLE_CRYPTFS=false
84 #-------------------------
85 BASEDIR=/data/RpiGenImage/Images/${RELEASE}
86 DATE=`date +%Y-%m-%d`
87 IMAGE_NAME=${BASEDIR}/${DATE}-rpiw${RPI_MODEL}-${RELEASE}
88
89
@@ -1,453 +1,454
1 1 # rpi23-gen-image
2 2 ## Introduction
3 3
4 4 `rpi23-gen-image.sh` is an advanced Debian Linux bootstrapping shell script for generating Debian OS images for Raspberry Pi 2 (RPi2) and Raspberry Pi 3 (RPi3) computers. The script at this time supports the bootstrapping of the Debian (armhf) releases `jessie`, `stretch` and `buster`. Raspberry Pi 3 images are generated for 32-bit mode only. Raspberry Pi 3 64-bit images can be generated using custom configuration parameters (```templates/rpi3-stretch-arm64-4.11.y```).
5 5
6
6 7 ## Build dependencies
7 8 The following list of Debian packages must be installed on the build system because they are essentially required for the bootstrapping process. The script will check if all required packages are installed and missing packages will be installed automatically if confirmed by the user.
8 9
9 10 ```debootstrap debian-archive-keyring qemu-user-static binfmt-support dosfstools rsync bmap-tools whois git bc psmisc dbus sudo```
10 11
11 12 It is recommended to configure the `rpi23-gen-image.sh` script to build and install the latest Raspberry Pi Linux kernel. For the RPi3 this is mandatory. Kernel compilation and linking will be performed on the build system using an ARM (armhf) cross-compiler toolchain.
12 13
13 14 The script has been tested using the default `crossbuild-essential-armhf` toolchain meta package on Debian Linux `jessie` and `stretch` build systems. Please check the [Debian CrossToolchains Wiki](https://wiki.debian.org/CrossToolchains) for further information.
14 15
15 16 If a Debian Linux `jessie` build system is used it will be required to add the [Debian Cross-toolchains repository](http://emdebian.org/tools/debian/) first:
16 17
17 18 ```
18 19 echo "deb http://emdebian.org/tools/debian/ jessie main" > /etc/apt/sources.list.d/crosstools.list
19 20 sudo -u nobody wget -O - http://emdebian.org/tools/debian/emdebian-toolchain-archive.key | apt-key add -
20 21 dpkg --add-architecture armhf
21 22 apt-get update
22 23 ```
23 24
24 25 ## Command-line parameters
25 26 The script accepts certain command-line parameters to enable or disable specific OS features, services and configuration settings. These parameters are passed to the `rpi23-gen-image.sh` script via (simple) shell-variables. Unlike environment shell-variables (simple) shell-variables are defined at the beginning of the command-line call of the `rpi23-gen-image.sh` script.
26 27
27 28 ##### Command-line examples:
28 29 ```shell
29 30 ENABLE_UBOOT=true ./rpi23-gen-image.sh
30 31 ENABLE_CONSOLE=false ENABLE_IPV6=false ./rpi23-gen-image.sh
31 32 ENABLE_WM=xfce4 ENABLE_FBTURBO=true ENABLE_MINBASE=true ./rpi23-gen-image.sh
32 33 ENABLE_HARDNET=true ENABLE_IPTABLES=true /rpi23-gen-image.sh
33 34 APT_SERVER=ftp.de.debian.org APT_PROXY="http://127.0.0.1:3142/" ./rpi23-gen-image.sh
34 35 ENABLE_MINBASE=true ./rpi23-gen-image.sh
35 36 BUILD_KERNEL=true ENABLE_MINBASE=true ENABLE_IPV6=false ./rpi23-gen-image.sh
36 37 BUILD_KERNEL=true KERNELSRC_DIR=/tmp/linux ./rpi23-gen-image.sh
37 38 ENABLE_MINBASE=true ENABLE_REDUCE=true ENABLE_MINGPU=true BUILD_KERNEL=true ./rpi23-gen-image.sh
38 39 ENABLE_CRYPTFS=true CRYPTFS_PASSWORD=changeme EXPANDROOT=false ENABLE_MINBASE=true ENABLE_REDUCE=true ENABLE_MINGPU=true BUILD_KERNEL=true ./rpi23-gen-image.sh
39 40 RELEASE=stretch BUILD_KERNEL=true ./rpi23-gen-image.sh
40 41 RPI_MODEL=3 ENABLE_WIRELESS=true ENABLE_MINBASE=true BUILD_KERNEL=true ./rpi23-gen-image.sh
41 42 RELEASE=stretch RPI_MODEL=3 ENABLE_WIRELESS=true ENABLE_MINBASE=true BUILD_KERNEL=true ./rpi23-gen-image.sh
42 43 ```
43 44
44 45 ## Configuration template files
45 46 To avoid long lists of command-line parameters and to help to store the favourite parameter configurations the `rpi23-gen-image.sh` script supports so called configuration template files (`CONFIG_TEMPLATE`=template). These are simple text files located in the `./templates` directory that contain the list of configuration parameters that will be used. New configuration template files can be added to the `./templates` directory.
46 47
47 48 ##### Command-line examples:
48 49 ```shell
49 50 CONFIG_TEMPLATE=rpi3stretch ./rpi23-gen-image.sh
50 51 CONFIG_TEMPLATE=rpi2stretch ./rpi23-gen-image.sh
51 52 ```
52 53
53 54 ## Supported parameters and settings
54 55 #### APT settings:
55 56 ##### `APT_SERVER`="ftp.debian.org"
56 57 Set Debian packages server address. Choose a server from the list of Debian worldwide [mirror sites](https://www.debian.org/mirror/list). Using a nearby server will probably speed-up all required downloads within the bootstrapping process.
57 58
58 59 ##### `APT_PROXY`=""
59 60 Set Proxy server address. Using a local Proxy-Cache like `apt-cacher-ng` will speed-up the bootstrapping process because all required Debian packages will only be downloaded from the Debian mirror site once.
60 61
61 62 ##### `APT_INCLUDES`=""
62 63 A comma separated list of additional packages to be installed by debootstrap during bootstrapping.
63 64
64 65 ##### `APT_INCLUDES_LATE`=""
65 66 A comma separated list of additional packages to be installed by apt after bootstrapping and after APT sources are set up. This is useful for packages with pre-depends, which debootstrap do not handle well.
66 67
67 68 ---
68 69
69 70 #### General system settings:
70 71 ##### `RPI_MODEL`=2
71 72 Specifiy the target Raspberry Pi hardware model. The script at this time supports the Raspberry Pi models `2` and `3`. `BUILD_KERNEL`=true will automatically be set if the Raspberry Pi model `3` is used.
72 73
73 74 ##### `RELEASE`="jessie"
74 75 Set the desired Debian release name. The script at this time supports the bootstrapping of the Debian releases "jessie", "stretch" and "buster". `BUILD_KERNEL`=true will automatically be set if the Debian releases `stretch` or `buster` are used.
75 76
76 77 ##### `RELEASE_ARCH`="armhf"
77 78 Set the desired Debian release architecture.
78 79
79 80 ##### `HOSTNAME`="rpi$RPI_MODEL-$RELEASE"
80 81 Set system host name. It's recommended that the host name is unique in the corresponding subnet.
81 82
82 83 ##### `PASSWORD`="raspberry"
83 84 Set system `root` password. It's **STRONGLY** recommended that you choose a custom password.
84 85
85 86 ##### `USER_PASSWORD`="raspberry"
86 87 Set password for the created non-root user `USER_NAME`=pi. Ignored if `ENABLE_USER`=false. It's **STRONGLY** recommended that you choose a custom password.
87 88
88 89 ##### `DEFLOCAL`="en_US.UTF-8"
89 90 Set default system locale. This setting can also be changed inside the running OS using the `dpkg-reconfigure locales` command. Please note that on using this parameter the script will automatically install the required packages `locales`, `keyboard-configuration` and `console-setup`.
90 91
91 92 ##### `TIMEZONE`="Europe/Berlin"
92 93 Set default system timezone. All available timezones can be found in the `/usr/share/zoneinfo/` directory. This setting can also be changed inside the running OS using the `dpkg-reconfigure tzdata` command.
93 94
94 95 ##### `EXPANDROOT`=true
95 96 Expand the root partition and filesystem automatically on first boot.
96 97
97 98 ---
98 99
99 100 #### Keyboard settings:
100 101 These options are used to configure keyboard layout in `/etc/default/keyboard` for console and Xorg. These settings can also be changed inside the running OS using the `dpkg-reconfigure keyboard-configuration` command.
101 102
102 103 ##### `XKB_MODEL`=""
103 104 Set the name of the model of your keyboard type.
104 105
105 106 ##### `XKB_LAYOUT`=""
106 107 Set the supported keyboard layout(s).
107 108
108 109 ##### `XKB_VARIANT`=""
109 110 Set the supported variant(s) of the keyboard layout(s).
110 111
111 112 ##### `XKB_OPTIONS`=""
112 113 Set extra xkb configuration options.
113 114
114 115 ---
115 116
116 117 #### Networking settings (DHCP):
117 118 This parameter is used to set up networking auto configuration in `/etc/systemd/network/eth.network`. The default location of network configuration files in the Debian `stretch` release was changed to `/lib/systemd/network`.`
118 119
119 120 ##### `ENABLE_DHCP`=true
120 121 Set the system to use DHCP. This requires an DHCP server.
121 122
122 123 ---
123 124
124 125 #### Networking settings (static):
125 126 These parameters are used to set up a static networking configuration in `/etc/systemd/network/eth.network`. The following static networking parameters are only supported if `ENABLE_DHCP` was set to `false`. The default location of network configuration files in the Debian `stretch` release was changed to `/lib/systemd/network`.
126 127
127 128 ##### `NET_ADDRESS`=""
128 129 Set a static IPv4 or IPv6 address and its prefix, separated by "/", eg. "192.169.0.3/24".
129 130
130 131 ##### `NET_GATEWAY`=""
131 132 Set the IP address for the default gateway.
132 133
133 134 ##### `NET_DNS_1`=""
134 135 Set the IP address for the first DNS server.
135 136
136 137 ##### `NET_DNS_2`=""
137 138 Set the IP address for the second DNS server.
138 139
139 140 ##### `NET_DNS_DOMAINS`=""
140 141 Set the default DNS search domains to use for non fully qualified host names.
141 142
142 143 ##### `NET_NTP_1`=""
143 144 Set the IP address for the first NTP server.
144 145
145 146 ##### `NET_NTP_2`=""
146 147 Set the IP address for the second NTP server.
147 148
148 149 ---
149 150
150 151 #### Basic system features:
151 152 ##### `ENABLE_CONSOLE`=true
152 153 Enable serial console interface. Recommended if no monitor or keyboard is connected to the RPi2/3. In case of problems fe. if the network (auto) configuration failed - the serial console can be used to access the system.
153 154
154 155 ##### `ENABLE_I2C`=false
155 156 Enable I2C interface on the RPi2/3. Please check the [RPi2/3 pinout diagrams](http://elinux.org/RPi_Low-level_peripherals) to connect the right GPIO pins.
156 157
157 158 ##### `ENABLE_SPI`=false
158 159 Enable SPI interface on the RPi2/3. Please check the [RPi2/3 pinout diagrams](http://elinux.org/RPi_Low-level_peripherals) to connect the right GPIO pins.
159 160
160 161 ##### `ENABLE_IPV6`=true
161 162 Enable IPv6 support. The network interface configuration is managed via systemd-networkd.
162 163
163 164 ##### `ENABLE_SSHD`=true
164 165 Install and enable OpenSSH service. The default configuration of the service doesn't allow `root` to login. Please use the user `pi` instead and `su -` or `sudo` to execute commands as root.
165 166
166 167 ##### `ENABLE_NONFREE`=false
167 168 Allow the installation of non-free Debian packages that do not comply with the DFSG. This is required to install closed-source firmware binary blobs.
168 169
169 170 ##### `ENABLE_WIRELESS`=false
170 171 Download and install the [closed-source firmware binary blob](https://github.com/RPi-Distro/firmware-nonfree/tree/master/brcm80211/brcm) that is required to run the internal wireless interface of the Raspberry Pi model `3`. This parameter is ignored if the specified `RPI_MODEL` is not `3`.
171 172
172 173 ##### `ENABLE_RSYSLOG`=true
173 174 If set to false, disable and uninstall rsyslog (so logs will be available only
174 175 in journal files)
175 176
176 177 ##### `ENABLE_SOUND`=true
177 178 Enable sound hardware and install Advanced Linux Sound Architecture.
178 179
179 180 ##### `ENABLE_HWRANDOM`=true
180 181 Enable Hardware Random Number Generator. Strong random numbers are important for most network based communications that use encryption. It's recommended to be enabled.
181 182
182 183 ##### `ENABLE_MINGPU`=false
183 184 Minimize the amount of shared memory reserved for the GPU. It doesn't seem to be possible to fully disable the GPU.
184 185
185 186 ##### `ENABLE_DBUS`=true
186 187 Install and enable D-Bus message bus. Please note that systemd should work without D-bus but it's recommended to be enabled.
187 188
188 189 ##### `ENABLE_XORG`=false
189 190 Install Xorg open-source X Window System.
190 191
191 192 ##### `ENABLE_WM`=""
192 193 Install a user defined window manager for the X Window System. To make sure all X related package dependencies are getting installed `ENABLE_XORG` will automatically get enabled if `ENABLE_WM` is used. The `rpi23-gen-image.sh` script has been tested with the following list of window managers: `blackbox`, `openbox`, `fluxbox`, `jwm`, `dwm`, `xfce4`, `awesome`.
193 194
194 195 ---
195 196
196 197 #### Advanced system features:
197 198 ##### `ENABLE_MINBASE`=false
198 199 Use debootstrap script variant `minbase` which only includes essential packages and apt. This will reduce the disk usage by about 65 MB.
199 200
200 201 ##### `ENABLE_REDUCE`=false
201 202 Reduce the disk space usage by deleting packages and files. See `REDUCE_*` parameters for detailed information.
202 203
203 204 ##### `ENABLE_UBOOT`=false
204 205 Replace the default RPi2/3 second stage bootloader (bootcode.bin) with [U-Boot bootloader](http://git.denx.de/?p=u-boot.git;a=summary). U-Boot can boot images via the network using the BOOTP/TFTP protocol.
205 206
206 207 ##### `UBOOTSRC_DIR`=""
207 208 Path to a directory (`u-boot`) of [U-Boot bootloader sources](http://git.denx.de/?p=u-boot.git;a=summary) that will be copied, configured, build and installed inside the chroot.
208 209
209 210 ##### `ENABLE_FBTURBO`=false
210 211 Install and enable the [hardware accelerated Xorg video driver](https://github.com/ssvb/xf86-video-fbturbo) `fbturbo`. Please note that this driver is currently limited to hardware accelerated window moving and scrolling.
211 212
212 213 ##### `FBTURBOSRC_DIR`=""
213 214 Path to a directory (`xf86-video-fbturbo`) of [hardware accelerated Xorg video driver sources](https://github.com/ssvb/xf86-video-fbturbo) that will be copied, configured, build and installed inside the chroot.
214 215
215 216 ##### `ENABLE_IPTABLES`=false
216 217 Enable iptables IPv4/IPv6 firewall. Simplified ruleset: Allow all outgoing connections. Block all incoming connections except to OpenSSH service.
217 218
218 219 ##### `ENABLE_USER`=true
219 220 Create non-root user with password `USER_PASSWORD`=raspberry. Unless overridden with `USER_NAME`=user, username will be `pi`.
220 221
221 222 ##### `USER_NAME`=pi
222 223 Non-root user to create. Ignored if `ENABLE_USER`=false
223 224
224 225 ##### `ENABLE_ROOT`=false
225 226 Set root user password so root login will be enabled
226 227
227 228 ##### `ENABLE_HARDNET`=false
228 229 Enable IPv4/IPv6 network stack hardening settings.
229 230
230 231 ##### `ENABLE_SPLITFS`=false
231 232 Enable having root partition on an USB drive by creating two image files: one for the `/boot/firmware` mount point, and another for `/`.
232 233
233 234 ##### `CHROOT_SCRIPTS`=""
234 235 Path to a directory with scripts that should be run in the chroot before the image is finally built. Every executable file in this directory is run in lexicographical order.
235 236
236 237 ##### `ENABLE_INITRAMFS`=false
237 238 Create an initramfs that that will be loaded during the Linux startup process. `ENABLE_INITRAMFS` will automatically get enabled if `ENABLE_CRYPTFS`=true. This parameter will be ignored if `BUILD_KERNEL`=false.
238 239
239 240 ##### `ENABLE_IFNAMES`=true
240 241 Enable automatic assignment of predictable, stable network interface names for all local Ethernet, WLAN interfaces. This might create complex and long interface names. This parameter is only supported if the Debian releases `stretch` or `buster` are used.
241 242
242 243 ##### `DISABLE_UNDERVOLT_WARNINGS`=
243 244 Disable RPi2/3 under-voltage warnings and overlays. Setting the parameter to `1` will disable the warning overlay. Setting it to `2` will additionally allow RPi2/3 turbo mode when low-voltage is present.
244 245
245 246 ---
246 247
247 248 #### SSH settings:
248 249 ##### `SSH_ENABLE_ROOT`=false
249 250 Enable password root login via SSH. This may be a security risk with default password, use only in trusted environments. `ENABLE_ROOT` must be set to `true`.
250 251
251 252 ##### `SSH_DISABLE_PASSWORD_AUTH`=false
252 253 Disable password based SSH authentication. Only public key based SSH (v2) authentication will be supported.
253 254
254 255 ##### `SSH_LIMIT_USERS`=false
255 256 Limit the users that are allowed to login via SSH. Only allow user `USER_NAME`=pi and root if `SSH_ENABLE_ROOT`=true to login. This parameter will be ignored if `dropbear` SSH is used (`REDUCE_SSHD`=true).
256 257
257 258 ##### `SSH_ROOT_PUB_KEY`=""
258 259 Add SSH (v2) public key(s) from specified file to `authorized_keys` file to enable public key based SSH (v2) authentication of user `root`. The specified file can also contain multiple SSH (v2) public keys. SSH protocol version 1 is not supported. `ENABLE_ROOT` **and** `SSH_ENABLE_ROOT` must be set to `true`.
259 260
260 261 ##### `SSH_USER_PUB_KEY`=""
261 262 Add SSH (v2) public key(s) from specified file to `authorized_keys` file to enable public key based SSH (v2) authentication of user `USER_NAME`=pi. The specified file can also contain multiple SSH (v2) public keys. SSH protocol version 1 is not supported.
262 263
263 264 ---
264 265
265 266 #### Kernel compilation:
266 267 ##### `BUILD_KERNEL`=false
267 268 Build and install the latest RPi2/3 Linux kernel. Currently only the default RPi2/3 kernel configuration is used. `BUILD_KERNEL`=true will automatically be set if the Raspberry Pi model `3` is used.
268 269
269 270 ##### `CROSS_COMPILE`="arm-linux-gnueabihf-"
270 271 This sets the cross compile enviornment for the compiler.
271 272
272 273 ##### `KERNEL_ARCH`="arm"
273 274 This sets the kernel architecture for the compiler.
274 275
275 276 ##### `KERNEL_IMAGE`="kernel7.img"
276 277 Name of the image file in the boot partition. If not set, `KERNEL_IMAGE` will be set to "kernel8.img" automatically if building for arm64.
277 278
278 279 ##### `KERNEL_BRANCH`=""
279 280 Name of the requested branch from the GIT location for the RPi Kernel. Default is using the current default branch from the GIT site.
280 281
281 282 ##### `QEMU_BINARY`="/usr/bin/qemu-arm-static"
282 283 Sets the QEMU enviornment for the Debian archive. If not set, `QEMU_BINARY` will be set to "/usr/bin/qemu-aarch64-static" automatically if building for arm64.
283 284
284 285 ##### `KERNEL_DEFCONFIG`="bcm2709_defconfig"
285 286 Sets the default config for kernel compiling. If not set, `KERNEL_DEFCONFIG` will be set to "bcmrpi3\_defconfig" automatically if building for arm64.
286 287
287 288 ##### `KERNEL_REDUCE`=false
288 289 Reduce the size of the generated kernel by removing unwanted device, network and filesystem drivers (experimental).
289 290
290 291 ##### `KERNEL_THREADS`=1
291 292 Number of parallel kernel building threads. If the parameter is left untouched the script will automatically determine the number of CPU cores to set the number of parallel threads to speed the kernel compilation.
292 293
293 294 ##### `KERNEL_HEADERS`=true
294 295 Install kernel headers with built kernel.
295 296
296 297 ##### `KERNEL_MENUCONFIG`=false
297 298 Start `make menuconfig` interactive menu-driven kernel configuration. The script will continue after `make menuconfig` was terminated.
298 299
299 300 ##### `KERNEL_REMOVESRC`=true
300 301 Remove all kernel sources from the generated OS image after it was built and installed.
301 302
302 303 ##### `KERNELSRC_DIR`=""
303 304 Path to a directory (`linux`) of [RaspberryPi Linux kernel sources](https://github.com/raspberrypi/linux) that will be copied, configured, build and installed inside the chroot.
304 305
305 306 ##### `KERNELSRC_CLEAN`=false
306 307 Clean the existing kernel sources directory `KERNELSRC_DIR` (using `make mrproper`) after it was copied to the chroot and before the compilation of the kernel has started. This parameter will be ignored if no `KERNELSRC_DIR` was specified or if `KERNELSRC_PREBUILT`=true.
307 308
308 309 ##### `KERNELSRC_CONFIG`=true
309 310 Run `make bcm2709_defconfig` (and optional `make menuconfig`) to configure the kernel sources before building. This parameter is automatically set to `true` if no existing kernel sources directory was specified using `KERNELSRC_DIR`. This parameter is ignored if `KERNELSRC_PREBUILT`=true.
310 311
311 312 ##### `KERNELSRC_USRCONFIG`=""
312 313 Copy own config file to kernel `.config`. If `KERNEL_MENUCONFIG`=true then running after copy.
313 314
314 315 ##### `KERNELSRC_PREBUILT`=false
315 316 With this parameter set to true the script expects the existing kernel sources directory to be already successfully cross-compiled. The parameters `KERNELSRC_CLEAN`, `KERNELSRC_CONFIG`, `KERNELSRC_USRCONFIG` and `KERNEL_MENUCONFIG` are ignored and no kernel compilation tasks are performed.
316 317
317 318 ##### `RPI_FIRMWARE_DIR`=""
318 319 The directory (`firmware`) containing a local copy of the firmware from the [RaspberryPi firmware project](https://github.com/raspberrypi/firmware). Default is to download the latest firmware directly from the project.
319 320
320 321 ---
321 322
322 323 #### Reduce disk usage:
323 324 The following list of parameters is ignored if `ENABLE_REDUCE`=false.
324 325
325 326 ##### `REDUCE_APT`=true
326 327 Configure APT to use compressed package repository lists and no package caching files.
327 328
328 329 ##### `REDUCE_DOC`=true
329 330 Remove all doc files (harsh). Configure APT to not include doc files on future `apt-get` package installations.
330 331
331 332 ##### `REDUCE_MAN`=true
332 333 Remove all man pages and info files (harsh). Configure APT to not include man pages on future `apt-get` package installations.
333 334
334 335 ##### `REDUCE_VIM`=false
335 336 Replace `vim-tiny` package by `levee` a tiny vim clone.
336 337
337 338 ##### `REDUCE_BASH`=false
338 339 Remove `bash` package and switch to `dash` shell (experimental).
339 340
340 341 ##### `REDUCE_HWDB`=true
341 342 Remove PCI related hwdb files (experimental).
342 343
343 344 ##### `REDUCE_SSHD`=true
344 345 Replace `openssh-server` with `dropbear`.
345 346
346 347 ##### `REDUCE_LOCALE`=true
347 348 Remove all `locale` translation files.
348 349
349 350 ---
350 351
351 352 #### Encrypted root partition:
352 353 ##### `ENABLE_CRYPTFS`=false
353 354 Enable full system encryption with dm-crypt. Setup a fully LUKS encrypted root partition (aes-xts-plain64:sha512) and generate required initramfs. The /boot directory will not be encrypted. This parameter will be ignored if `BUILD_KERNEL`=false. `ENABLE_CRYPTFS` is experimental. SSH-to-initramfs is currently not supported but will be soon - feel free to help.
354 355
355 356 ##### `CRYPTFS_PASSWORD`=""
356 357 Set password of the encrypted root partition. This parameter is mandatory if `ENABLE_CRYPTFS`=true.
357 358
358 359 ##### `CRYPTFS_MAPPING`="secure"
359 360 Set name of dm-crypt managed device-mapper mapping.
360 361
361 362 ##### `CRYPTFS_CIPHER`="aes-xts-plain64:sha512"
362 363 Set cipher specification string. `aes-xts*` ciphers are strongly recommended.
363 364
364 365 ##### `CRYPTFS_XTSKEYSIZE`=512
365 366 Sets key size in bits. The argument has to be a multiple of 8.
366 367
367 368 ---
368 369
369 370 #### Build settings:
370 371 ##### `BASEDIR`=$(pwd)/images/${RELEASE}
371 372 Set a path to a working directory used by the script to generate an image.
372 373
373 374 ##### `IMAGE_NAME`=${BASEDIR}/${DATE}-${KERNEL_ARCH}-${KERNEL_BRANCH}-rpi${RPI_MODEL}-${RELEASE}-${RELEASE_ARCH}
374 375 Set a filename for the output file(s). Note: the script will create $IMAGE_NAME.img if `ENABLE_SPLITFS`=false or $IMAGE_NAME-frmw.img and $IMAGE_NAME-root.img if `ENABLE_SPLITFS`=true. Note 2: If the KERNEL_BRANCH is not set, the word "CURRENT" is used.
375 376
376 377 ## Understanding the script
377 378 The functions of this script that are required for the different stages of the bootstrapping are split up into single files located inside the `bootstrap.d` directory. During the bootstrapping every script in this directory gets executed in lexicographical order:
378 379
379 380 | Script | Description |
380 381 | --- | --- |
381 382 | `10-bootstrap.sh` | Debootstrap basic system |
382 383 | `11-apt.sh` | Setup APT repositories |
383 384 | `12-locale.sh` | Setup Locales and keyboard settings |
384 385 | `13-kernel.sh` | Build and install RPi2/3 Kernel |
385 386 | `14-fstab.sh` | Setup fstab and initramfs |
386 387 | `15-rpi-config.sh` | Setup RPi2/3 config and cmdline |
387 388 | `20-networking.sh` | Setup Networking |
388 389 | `21-firewall.sh` | Setup Firewall |
389 390 | `30-security.sh` | Setup Users and Security settings |
390 391 | `31-logging.sh` | Setup Logging |
391 392 | `32-sshd.sh` | Setup SSH and public keys |
392 393 | `41-uboot.sh` | Build and Setup U-Boot |
393 394 | `42-fbturbo.sh` | Build and Setup fbturbo Xorg driver |
394 395 | `50-firstboot.sh` | First boot actions |
395 396 | `99-reduce.sh` | Reduce the disk space usage |
396 397
397 398 All the required configuration files that will be copied to the generated OS image are located inside the `files` directory. It is not recommended to modify these configuration files manually.
398 399
399 400 | Directory | Description |
400 401 | --- | --- |
401 402 | `apt` | APT management configuration files |
402 403 | `boot` | Boot and RPi2/3 configuration files |
403 404 | `dpkg` | Package Manager configuration |
404 405 | `etc` | Configuration files and rc scripts |
405 406 | `firstboot` | Scripts that get executed on first boot |
406 407 | `initramfs` | Initramfs scripts |
407 408 | `iptables` | Firewall configuration files |
408 409 | `locales` | Locales configuration |
409 410 | `modules` | Kernel Modules configuration |
410 411 | `mount` | Fstab configuration |
411 412 | `network` | Networking configuration files |
412 413 | `sysctl.d` | Swapping and Network Hardening configuration |
413 414 | `xorg` | fbturbo Xorg driver configuration |
414 415
415 416 ## Custom packages and scripts
416 417 Debian custom packages, i.e. those not in the debian repositories, can be installed by placing them in the `packages` directory. They are installed immediately after packages from the repositories are installed. Any dependencies listed in the custom packages will be downloaded automatically from the repositories. Do not list these custom packages in `APT_INCLUDES`.
417 418
418 419 Scripts in the custom.d directory will be executed after all other installation is complete but before the image is created.
419 420
420 421 ## Logging of the bootstrapping process
421 422 All information related to the bootstrapping process and the commands executed by the `rpi23-gen-image.sh` script can easily be saved into a logfile. The common shell command `script` can be used for this purpose:
422 423
423 424 ```shell
424 425 script -c 'APT_SERVER=ftp.de.debian.org ./rpi23-gen-image.sh' ./build.log
425 426 ```
426 427
427 428 ## Flashing the image file
428 429 After the image file was successfully created by the `rpi23-gen-image.sh` script it can be copied to the microSD card that will be used by the RPi2/3 computer. This can be performed by using the tools `bmaptool` or `dd`. Using `bmaptool` will probably speed-up the copy process because `bmaptool` copies more wisely than `dd`.
429 430
430 431 ##### Flashing examples:
431 432 ```shell
432 433 bmaptool copy ./images/jessie/2017-01-23-rpi3-jessie.img /dev/mmcblk0
433 434 dd bs=4M if=./images/jessie/2017-01-23-rpi3-jessie.img of=/dev/mmcblk0
434 435 ```
435 436 If you have set `ENABLE_SPLITFS`, copy the `-frmw` image on the microSD card, then the `-root` one on the USB drive:
436 437 ```shell
437 438 bmaptool copy ./images/jessie/2017-01-23-rpi3-jessie-frmw.img /dev/mmcblk0
438 439 bmaptool copy ./images/jessie/2017-01-23-rpi3-jessie-root.img /dev/sdc
439 440 ```
440 441 ## Weekly image builds
441 442 The image files are provided by JRWR'S I/O PORT and are built once a Sunday at midnight UTC!
442 443 * [Debian Stretch Raspberry Pi2/3 Weekly Image Builds](https://jrwr.io/doku.php?id=projects:debianpi)
443 444
444 445 ## External links and references
445 446 * [Debian worldwide mirror sites](https://www.debian.org/mirror/list)
446 447 * [Debian Raspberry Pi 2 Wiki](https://wiki.debian.org/RaspberryPi2)
447 448 * [Debian CrossToolchains Wiki](https://wiki.debian.org/CrossToolchains)
448 449 * [Official Raspberry Pi Firmware on github](https://github.com/raspberrypi/firmware)
449 450 * [Official Raspberry Pi Kernel on github](https://github.com/raspberrypi/linux)
450 451 * [U-BOOT git repository](http://git.denx.de/?p=u-boot.git;a=summary)
451 452 * [Xorg DDX driver fbturbo](https://github.com/ssvb/xf86-video-fbturbo)
452 453 * [RPi3 Wireless interface firmware](https://github.com/RPi-Distro/firmware-nonfree/tree/master/brcm80211/brcm)
453 454 * [Collabora RPi2 Kernel precompiled](https://repositories.collabora.co.uk/debian/)
@@ -1,183 +1,185
1 1 #
2 2 # Build and Setup RPi2/3 Kernel
3 3 #
4 4
5 5 # Load utility functions
6 6 . ./functions.sh
7 7
8 8 # Fetch and build latest raspberry kernel
9 9 if [ "$BUILD_KERNEL" = true ] ; then
10 10 # Setup source directory
11 11 mkdir -p "${R}/usr/src/linux"
12 12
13 13 # Copy existing kernel sources into chroot directory
14 14 if [ -n "$KERNELSRC_DIR" ] && [ -d "$KERNELSRC_DIR" ] ; then
15 15 # Copy kernel sources and include hidden files
16 16 cp -r "${KERNELSRC_DIR}/". "${R}/usr/src/linux"
17 17
18 18 # Clean the kernel sources
19 19 if [ "$KERNELSRC_CLEAN" = true ] && [ "$KERNELSRC_PREBUILT" = false ] ; then
20 20 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" mrproper
21 21 fi
22 22 else # KERNELSRC_DIR=""
23 23 # Create temporary directory for kernel sources
24 24 temp_dir=$(as_nobody mktemp -d)
25 25
26 26 # Fetch current RPi2/3 kernel sources
27 27 if [ -z "${KERNEL_BRANCH}" ] ; then
28 28 as_nobody git -C "${temp_dir}" clone --depth=1 "${KERNEL_URL}" linux
29 29 else
30 30 as_nobody git -C "${temp_dir}" clone --depth=1 --branch "${KERNEL_BRANCH}" "${KERNEL_URL}" linux
31 31 fi
32 32
33 33 # Copy downloaded kernel sources
34 34 cp -r "${temp_dir}/linux/"* "${R}/usr/src/linux/"
35 35
36 36 # Remove temporary directory for kernel sources
37 37 rm -fr "${temp_dir}"
38 38
39 39 # Set permissions of the kernel sources
40 40 chown -R root:root "${R}/usr/src"
41 41 fi
42 42
43 43 # Calculate optimal number of kernel building threads
44 44 if [ "$KERNEL_THREADS" = "1" ] && [ -r /proc/cpuinfo ] ; then
45 45 KERNEL_THREADS=$(grep -c processor /proc/cpuinfo)
46 46 fi
47 47
48 48 # Configure and build kernel
49 49 if [ "$KERNELSRC_PREBUILT" = false ] ; then
50 50 # Remove device, network and filesystem drivers from kernel configuration
51 51 if [ "$KERNEL_REDUCE" = true ] ; then
52 52 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" "${KERNEL_DEFCONFIG}"
53 53 sed -i\
54 54 -e "s/\(^CONFIG_SND.*\=\).*/\1n/"\
55 55 -e "s/\(^CONFIG_SOUND.*\=\).*/\1n/"\
56 56 -e "s/\(^CONFIG_AC97.*\=\).*/\1n/"\
57 57 -e "s/\(^CONFIG_VIDEO_.*\=\).*/\1n/"\
58 58 -e "s/\(^CONFIG_MEDIA_TUNER.*\=\).*/\1n/"\
59 59 -e "s/\(^CONFIG_DVB.*\=\)[ym]/\1n/"\
60 60 -e "s/\(^CONFIG_REISERFS.*\=\).*/\1n/"\
61 61 -e "s/\(^CONFIG_JFS.*\=\).*/\1n/"\
62 62 -e "s/\(^CONFIG_XFS.*\=\).*/\1n/"\
63 63 -e "s/\(^CONFIG_GFS2.*\=\).*/\1n/"\
64 64 -e "s/\(^CONFIG_OCFS2.*\=\).*/\1n/"\
65 65 -e "s/\(^CONFIG_BTRFS.*\=\).*/\1n/"\
66 66 -e "s/\(^CONFIG_HFS.*\=\).*/\1n/"\
67 67 -e "s/\(^CONFIG_JFFS2.*\=\)[ym]/\1n/"\
68 68 -e "s/\(^CONFIG_UBIFS.*\=\).*/\1n/"\
69 69 -e "s/\(^CONFIG_SQUASHFS.*\=\)[ym]/\1n/"\
70 70 -e "s/\(^CONFIG_W1.*\=\)[ym]/\1n/"\
71 71 -e "s/\(^CONFIG_HAMRADIO.*\=\).*/\1n/"\
72 72 -e "s/\(^CONFIG_CAN.*\=\).*/\1n/"\
73 73 -e "s/\(^CONFIG_IRDA.*\=\).*/\1n/"\
74 74 -e "s/\(^CONFIG_BT_.*\=\).*/\1n/"\
75 75 -e "s/\(^CONFIG_WIMAX.*\=\)[ym]/\1n/"\
76 76 -e "s/\(^CONFIG_6LOWPAN.*\=\).*/\1n/"\
77 77 -e "s/\(^CONFIG_IEEE802154.*\=\).*/\1n/"\
78 78 -e "s/\(^CONFIG_NFC.*\=\).*/\1n/"\
79 79 -e "s/\(^CONFIG_FB_TFT=.*\=\).*/\1n/"\
80 80 -e "s/\(^CONFIG_TOUCHSCREEN.*\=\).*/\1n/"\
81 81 -e "s/\(^CONFIG_USB_GSPCA_.*\=\).*/\1n/"\
82 82 -e "s/\(^CONFIG_DRM.*\=\).*/\1n/"\
83 83 "${KERNEL_DIR}/.config"
84 84 fi
85 85
86 86 if [ "$KERNELSRC_CONFIG" = true ] ; then
87 87 # Load default raspberry kernel configuration
88 88 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" "${KERNEL_DEFCONFIG}"
89 89
90 90 if [ ! -z "$KERNELSRC_USRCONFIG" ] ; then
91 91 cp $KERNELSRC_USRCONFIG ${KERNEL_DIR}/.config
92 92 fi
93 93
94 94 # Start menu-driven kernel configuration (interactive)
95 95 if [ "$KERNEL_MENUCONFIG" = true ] ; then
96 96 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" menuconfig
97 97 fi
98 98 fi
99 99
100 100 # Cross compile kernel and modules
101 101 make -C "${KERNEL_DIR}" -j${KERNEL_THREADS} ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" "${KERNEL_BIN_IMAGE}" modules dtbs
102 102 fi
103 103
104 104 # Check if kernel compilation was successful
105 105 if [ ! -r "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/${KERNEL_BIN_IMAGE}" ] ; then
106 106 echo "error: kernel compilation failed! (kernel image not found)"
107 107 cleanup
108 108 exit 1
109 109 fi
110 110
111 111 # Install kernel modules
112 112 if [ "$ENABLE_REDUCE" = true ] ; then
113 113 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" INSTALL_MOD_STRIP=1 INSTALL_MOD_PATH=../../.. modules_install
114 114 else
115 115 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" INSTALL_MOD_PATH=../../.. modules_install
116 116
117 117 # Install kernel firmware
118 if [ $(cat ./Makefile | grep "^firmware_install:") ] ; then
118 119 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" INSTALL_FW_PATH=../../../lib firmware_install
119 120 fi
121 fi
120 122
121 123 # Install kernel headers
122 124 if [ "$KERNEL_HEADERS" = true ] && [ "$KERNEL_REDUCE" = false ] ; then
123 125 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" INSTALL_HDR_PATH=../.. headers_install
124 126 fi
125 127
126 128 # Prepare boot (firmware) directory
127 129 mkdir "${BOOT_DIR}"
128 130
129 131 # Get kernel release version
130 132 KERNEL_VERSION=`cat "${KERNEL_DIR}/include/config/kernel.release"`
131 133
132 134 # Copy kernel configuration file to the boot directory
133 135 install_readonly "${KERNEL_DIR}/.config" "${R}/boot/config-${KERNEL_VERSION}"
134 136
135 137 # Copy dts and dtb device tree sources and binaries
136 138 mkdir "${BOOT_DIR}/overlays"
137 139
138 140 # Ensure the proper .dtb is located
139 141 if [ "$KERNEL_ARCH" = "arm" ] ; then
140 142 install_readonly "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/dts/"*.dtb "${BOOT_DIR}/"
141 143 else
142 144 install_readonly "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/dts/broadcom/"*.dtb "${BOOT_DIR}/"
143 145 fi
144 146
145 147 install_readonly "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/dts/overlays/"*.dtb* "${BOOT_DIR}/overlays/"
146 148 install_readonly "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/dts/overlays/README" "${BOOT_DIR}/overlays/README"
147 149
148 150 if [ "$ENABLE_UBOOT" = false ] ; then
149 151 # Convert and copy kernel image to the boot directory
150 152 "${KERNEL_DIR}/scripts/mkknlimg" "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/${KERNEL_BIN_IMAGE}" "${BOOT_DIR}/${KERNEL_IMAGE}"
151 153 else
152 154 # Copy kernel image to the boot directory
153 155 install_readonly "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/${KERNEL_BIN_IMAGE}" "${BOOT_DIR}/${KERNEL_IMAGE}"
154 156 fi
155 157
156 158 # Remove kernel sources
157 159 if [ "$KERNEL_REMOVESRC" = true ] ; then
158 160 rm -fr "${KERNEL_DIR}"
159 161 else
160 162 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" modules_prepare
161 163
162 164 # Create symlinks for kernel modules
163 165 chroot_exec ln -sf /usr/src/linux "/lib/modules/${KERNEL_VERSION}/build"
164 166 chroot_exec ln -sf /usr/src/linux "/lib/modules/${KERNEL_VERSION}/source"
165 167 fi
166 168
167 169 else # BUILD_KERNEL=false
168 170 # Kernel installation
169 171 chroot_exec apt-get -qq -y --no-install-recommends install linux-image-"${COLLABORA_KERNEL}" raspberrypi-bootloader-nokernel
170 172
171 173 # Install flash-kernel last so it doesn't try (and fail) to detect the platform in the chroot
172 174 chroot_exec apt-get -qq -y install flash-kernel
173 175
174 176 # Check if kernel installation was successful
175 177 VMLINUZ="$(ls -1 ${R}/boot/vmlinuz-* | sort | tail -n 1)"
176 178 if [ -z "$VMLINUZ" ] ; then
177 179 echo "error: kernel installation failed! (/boot/vmlinuz-* not found)"
178 180 cleanup
179 181 exit 1
180 182 fi
181 183 # Copy vmlinuz kernel to the boot directory
182 184 install_readonly "${VMLINUZ}" "${BOOT_DIR}/${KERNEL_IMAGE}"
183 185 fi
@@ -1,44 +1,44
1 1 #
2 2 # Setup Firewall
3 3 #
4 4
5 5 # Load utility functions
6 6 . ./functions.sh
7 7
8 8 if [ "$ENABLE_IPTABLES" = true ] ; then
9 9 # Create iptables configuration directory
10 10 mkdir -p "${ETC_DIR}/iptables"
11 11
12 12 # Install iptables systemd service
13 13 install_readonly files/iptables/iptables.service "${ETC_DIR}/systemd/system/iptables.service"
14 14
15 15 # Install flush-table script called by iptables service
16 16 install_exec files/iptables/flush-iptables.sh "${ETC_DIR}/iptables/flush-iptables.sh"
17 17
18 18 # Install iptables rule file
19 19 install_readonly files/iptables/iptables.rules "${ETC_DIR}/iptables/iptables.rules"
20 20
21 21 # Reload systemd configuration and enable iptables service
22 22 chroot_exec systemctl daemon-reload
23 23 chroot_exec systemctl enable iptables.service
24 24
25 25 if [ "$ENABLE_IPV6" = true ] ; then
26 26 # Install ip6tables systemd service
27 27 install_readonly files/iptables/ip6tables.service "${ETC_DIR}/systemd/system/ip6tables.service"
28 28
29 29 # Install ip6tables file
30 30 install_exec files/iptables/flush-ip6tables.sh "${ETC_DIR}/iptables/flush-ip6tables.sh"
31 31
32 32 install_readonly files/iptables/ip6tables.rules "${ETC_DIR}/iptables/ip6tables.rules"
33 33
34 34 # Reload systemd configuration and enable iptables service
35 35 chroot_exec systemctl daemon-reload
36 36 chroot_exec systemctl enable ip6tables.service
37 37 fi
38 fi
39 38
40 39 if [ "$ENABLE_SSHD" = false ] ; then
41 40 # Remove SSHD related iptables rules
42 41 sed -i "/^#/! {/SSH/ s/^/# /}" "${ETC_DIR}/iptables/iptables.rules" 2> /dev/null
43 42 sed -i "/^#/! {/SSH/ s/^/# /}" "${ETC_DIR}/iptables/ip6tables.rules" 2> /dev/null
44 43 fi
44 fi
@@ -1,653 +1,657
1 1 #!/bin/sh
2 2
3 3 ########################################################################
4 4 # rpi23-gen-image.sh 2015-2017
5 5 #
6 6 # Advanced Debian "jessie", "stretch" and "buster" bootstrap script for RPi2/3
7 7 #
8 8 # This program is free software; you can redistribute it and/or
9 9 # modify it under the terms of the GNU General Public License
10 10 # as published by the Free Software Foundation; either version 2
11 11 # of the License, or (at your option) any later version.
12 12 #
13 13 # Copyright (C) 2015 Jan Wagner <mail@jwagner.eu>
14 14 #
15 15 # Big thanks for patches and enhancements by 20+ github contributors!
16 16 ########################################################################
17 17
18 18 # Are we running as root?
19 19 if [ "$(id -u)" -ne "0" ] ; then
20 20 echo "error: this script must be executed with root privileges!"
21 21 exit 1
22 22 fi
23 23
24 24 # Check if ./functions.sh script exists
25 25 if [ ! -r "./functions.sh" ] ; then
26 26 echo "error: './functions.sh' required script not found!"
27 27 exit 1
28 28 fi
29 29
30 30 # Load utility functions
31 31 . ./functions.sh
32 32
33 33 # Load parameters from configuration template file
34 34 if [ ! -z "$CONFIG_TEMPLATE" ] ; then
35 35 use_template
36 36 fi
37 37
38 38 # Introduce settings
39 39 set -e
40 40 echo -n -e "\n#\n# RPi2/3 Bootstrap Settings\n#\n"
41 41 set -x
42 42
43 43 # Raspberry Pi model configuration
44 44 RPI_MODEL=${RPI_MODEL:=2}
45 45 RPI2_DTB_FILE=${RPI2_DTB_FILE:=bcm2709-rpi-2-b.dtb}
46 46 RPI2_UBOOT_CONFIG=${RPI2_UBOOT_CONFIG:=rpi_2_defconfig}
47 47 RPI3_DTB_FILE=${RPI3_DTB_FILE:=bcm2710-rpi-3-b.dtb}
48 48 RPI3_UBOOT_CONFIG=${RPI3_UBOOT_CONFIG:=rpi_3_32b_defconfig}
49 49
50 50 # Debian release
51 51 RELEASE=${RELEASE:=jessie}
52 52 KERNEL_ARCH=${KERNEL_ARCH:=arm}
53 53 RELEASE_ARCH=${RELEASE_ARCH:=armhf}
54 54 CROSS_COMPILE=${CROSS_COMPILE:=arm-linux-gnueabihf-}
55 55 COLLABORA_KERNEL=${COLLABORA_KERNEL:=3.18.0-trunk-rpi2}
56 56 if [ "$KERNEL_ARCH" = "arm64" ] ; then
57 57 KERNEL_DEFCONFIG=${KERNEL_DEFCONFIG:=bcmrpi3_defconfig}
58 58 KERNEL_IMAGE=${KERNEL_IMAGE:=kernel8.img}
59 59 else
60 60 KERNEL_DEFCONFIG=${KERNEL_DEFCONFIG:=bcm2709_defconfig}
61 61 KERNEL_IMAGE=${KERNEL_IMAGE:=kernel7.img}
62 62 fi
63 63 if [ "$RELEASE_ARCH" = "arm64" ] ; then
64 64 QEMU_BINARY=${QEMU_BINARY:=/usr/bin/qemu-aarch64-static}
65 65 else
66 66 QEMU_BINARY=${QEMU_BINARY:=/usr/bin/qemu-arm-static}
67 67 fi
68 68 KERNEL_BRANCH=${KERNEL_BRANCH:=""}
69 69
70 70 # URLs
71 71 KERNEL_URL=${KERNEL_URL:=https://github.com/raspberrypi/linux}
72 72 FIRMWARE_URL=${FIRMWARE_URL:=https://github.com/raspberrypi/firmware/raw/master/boot}
73 73 WLAN_FIRMWARE_URL=${WLAN_FIRMWARE_URL:=https://github.com/RPi-Distro/firmware-nonfree/raw/master/brcm}
74 74 COLLABORA_URL=${COLLABORA_URL:=https://repositories.collabora.co.uk/debian}
75 75 FBTURBO_URL=${FBTURBO_URL:=https://github.com/ssvb/xf86-video-fbturbo.git}
76 76 UBOOT_URL=${UBOOT_URL:=git://git.denx.de/u-boot.git}
77 77
78 78 # Build directories
79 79 BASEDIR=${BASEDIR:=$(pwd)/images/${RELEASE}}
80 80 BUILDDIR="${BASEDIR}/build"
81 81
82 82 # Prepare date string for default image file name
83 83 DATE="$(date +%Y-%m-%d)"
84 84 if [ -z "$KERNEL_BRANCH" ] ; then
85 85 IMAGE_NAME=${IMAGE_NAME:=${BASEDIR}/${DATE}-${KERNEL_ARCH}-CURRENT-rpi${RPI_MODEL}-${RELEASE}-${RELEASE_ARCH}}
86 86 else
87 87 IMAGE_NAME=${IMAGE_NAME:=${BASEDIR}/${DATE}-${KERNEL_ARCH}-${KERNEL_BRANCH}-rpi${RPI_MODEL}-${RELEASE}-${RELEASE_ARCH}}
88 88 fi
89 89
90 90 # Chroot directories
91 91 R="${BUILDDIR}/chroot"
92 92 ETC_DIR="${R}/etc"
93 93 LIB_DIR="${R}/lib"
94 94 BOOT_DIR="${R}/boot/firmware"
95 95 KERNEL_DIR="${R}/usr/src/linux"
96 96 WLAN_FIRMWARE_DIR="${R}/lib/firmware/brcm"
97 97
98 98 # Firmware directory: Blank if download from github
99 99 RPI_FIRMWARE_DIR=${RPI_FIRMWARE_DIR:=""}
100 100
101 101 # General settings
102 102 HOSTNAME=${HOSTNAME:=rpi${RPI_MODEL}-${RELEASE}}
103 103 PASSWORD=${PASSWORD:=raspberry}
104 104 USER_PASSWORD=${USER_PASSWORD:=raspberry}
105 105 DEFLOCAL=${DEFLOCAL:="en_US.UTF-8"}
106 106 TIMEZONE=${TIMEZONE:="Europe/Berlin"}
107 107 EXPANDROOT=${EXPANDROOT:=true}
108 108
109 109 # Keyboard settings
110 110 XKB_MODEL=${XKB_MODEL:=""}
111 111 XKB_LAYOUT=${XKB_LAYOUT:=""}
112 112 XKB_VARIANT=${XKB_VARIANT:=""}
113 113 XKB_OPTIONS=${XKB_OPTIONS:=""}
114 114
115 115 # Network settings (DHCP)
116 116 ENABLE_DHCP=${ENABLE_DHCP:=true}
117 117
118 118 # Network settings (static)
119 119 NET_ADDRESS=${NET_ADDRESS:=""}
120 120 NET_GATEWAY=${NET_GATEWAY:=""}
121 121 NET_DNS_1=${NET_DNS_1:=""}
122 122 NET_DNS_2=${NET_DNS_2:=""}
123 123 NET_DNS_DOMAINS=${NET_DNS_DOMAINS:=""}
124 124 NET_NTP_1=${NET_NTP_1:=""}
125 125 NET_NTP_2=${NET_NTP_2:=""}
126 126
127 127 # APT settings
128 128 APT_PROXY=${APT_PROXY:=""}
129 129 APT_SERVER=${APT_SERVER:="ftp.debian.org"}
130 130
131 131 # Feature settings
132 132 ENABLE_CONSOLE=${ENABLE_CONSOLE:=true}
133 133 ENABLE_I2C=${ENABLE_I2C:=false}
134 134 ENABLE_SPI=${ENABLE_SPI:=false}
135 135 ENABLE_IPV6=${ENABLE_IPV6:=true}
136 136 ENABLE_SSHD=${ENABLE_SSHD:=true}
137 137 ENABLE_NONFREE=${ENABLE_NONFREE:=false}
138 138 ENABLE_WIRELESS=${ENABLE_WIRELESS:=false}
139 139 ENABLE_SOUND=${ENABLE_SOUND:=true}
140 140 ENABLE_DBUS=${ENABLE_DBUS:=true}
141 141 ENABLE_HWRANDOM=${ENABLE_HWRANDOM:=true}
142 142 ENABLE_MINGPU=${ENABLE_MINGPU:=false}
143 143 ENABLE_XORG=${ENABLE_XORG:=false}
144 144 ENABLE_WM=${ENABLE_WM:=""}
145 145 ENABLE_RSYSLOG=${ENABLE_RSYSLOG:=true}
146 146 ENABLE_USER=${ENABLE_USER:=true}
147 147 USER_NAME=${USER_NAME:="pi"}
148 148 ENABLE_ROOT=${ENABLE_ROOT:=false}
149 149
150 150 # SSH settings
151 151 SSH_ENABLE_ROOT=${SSH_ENABLE_ROOT:=false}
152 152 SSH_DISABLE_PASSWORD_AUTH=${SSH_DISABLE_PASSWORD_AUTH:=false}
153 153 SSH_LIMIT_USERS=${SSH_LIMIT_USERS:=false}
154 154 SSH_ROOT_PUB_KEY=${SSH_ROOT_PUB_KEY:=""}
155 155 SSH_USER_PUB_KEY=${SSH_USER_PUB_KEY:=""}
156 156
157 157 # Advanced settings
158 158 ENABLE_MINBASE=${ENABLE_MINBASE:=false}
159 159 ENABLE_REDUCE=${ENABLE_REDUCE:=false}
160 160 ENABLE_UBOOT=${ENABLE_UBOOT:=false}
161 161 UBOOTSRC_DIR=${UBOOTSRC_DIR:=""}
162 162 ENABLE_FBTURBO=${ENABLE_FBTURBO:=false}
163 163 FBTURBOSRC_DIR=${FBTURBOSRC_DIR:=""}
164 164 ENABLE_HARDNET=${ENABLE_HARDNET:=false}
165 165 ENABLE_IPTABLES=${ENABLE_IPTABLES:=false}
166 166 ENABLE_SPLITFS=${ENABLE_SPLITFS:=false}
167 167 ENABLE_INITRAMFS=${ENABLE_INITRAMFS:=false}
168 168 ENABLE_IFNAMES=${ENABLE_IFNAMES:=true}
169 169 DISABLE_UNDERVOLT_WARNINGS=${DISABLE_UNDERVOLT_WARNINGS:=}
170 170
171 171 # Kernel compilation settings
172 172 BUILD_KERNEL=${BUILD_KERNEL:=false}
173 173 KERNEL_REDUCE=${KERNEL_REDUCE:=false}
174 174 KERNEL_THREADS=${KERNEL_THREADS:=1}
175 175 KERNEL_HEADERS=${KERNEL_HEADERS:=true}
176 176 KERNEL_MENUCONFIG=${KERNEL_MENUCONFIG:=false}
177 177 KERNEL_REMOVESRC=${KERNEL_REMOVESRC:=true}
178 178 if [ "$KERNEL_ARCH" = "arm64" ] ; then
179 179 KERNEL_BIN_IMAGE=${KERNEL_BIN_IMAGE:="Image"}
180 180 else
181 181 KERNEL_BIN_IMAGE=${KERNEL_BIN_IMAGE:="zImage"}
182 182 fi
183 183
184 184 # Kernel compilation from source directory settings
185 185 KERNELSRC_DIR=${KERNELSRC_DIR:=""}
186 186 KERNELSRC_CLEAN=${KERNELSRC_CLEAN:=false}
187 187 KERNELSRC_CONFIG=${KERNELSRC_CONFIG:=true}
188 188 KERNELSRC_PREBUILT=${KERNELSRC_PREBUILT:=false}
189 189
190 190 # Reduce disk usage settings
191 191 REDUCE_APT=${REDUCE_APT:=true}
192 192 REDUCE_DOC=${REDUCE_DOC:=true}
193 193 REDUCE_MAN=${REDUCE_MAN:=true}
194 194 REDUCE_VIM=${REDUCE_VIM:=false}
195 195 REDUCE_BASH=${REDUCE_BASH:=false}
196 196 REDUCE_HWDB=${REDUCE_HWDB:=true}
197 197 REDUCE_SSHD=${REDUCE_SSHD:=true}
198 198 REDUCE_LOCALE=${REDUCE_LOCALE:=true}
199 199
200 200 # Encrypted filesystem settings
201 201 ENABLE_CRYPTFS=${ENABLE_CRYPTFS:=false}
202 202 CRYPTFS_PASSWORD=${CRYPTFS_PASSWORD:=""}
203 203 CRYPTFS_MAPPING=${CRYPTFS_MAPPING:="secure"}
204 204 CRYPTFS_CIPHER=${CRYPTFS_CIPHER:="aes-xts-plain64:sha512"}
205 205 CRYPTFS_XTSKEYSIZE=${CRYPTFS_XTSKEYSIZE:=512}
206 206
207 207 # Stop the Crypto Wars
208 208 DISABLE_FBI=${DISABLE_FBI:=false}
209 209
210 210 # Chroot scripts directory
211 211 CHROOT_SCRIPTS=${CHROOT_SCRIPTS:=""}
212 212
213 213 # Packages required in the chroot build environment
214 214 APT_INCLUDES=${APT_INCLUDES:=""}
215 215 APT_INCLUDES="${APT_INCLUDES},apt-transport-https,apt-utils,ca-certificates,debian-archive-keyring,dialog,sudo,systemd,sysvinit-utils"
216 216
217 217 # Packages required for bootstrapping
218 218 REQUIRED_PACKAGES="debootstrap debian-archive-keyring qemu-user-static binfmt-support dosfstools rsync bmap-tools whois git bc psmisc dbus sudo"
219 219 MISSING_PACKAGES=""
220 220
221 221 # Packages installed for c/c++ build environment in chroot (keep empty)
222 222 COMPILER_PACKAGES=""
223 223
224 224 set +x
225 225
226 226 # Set Raspberry Pi model specific configuration
227 227 if [ "$RPI_MODEL" = 2 ] ; then
228 228 DTB_FILE=${RPI2_DTB_FILE}
229 229 UBOOT_CONFIG=${RPI2_UBOOT_CONFIG}
230 230 elif [ "$RPI_MODEL" = 3 ] ; then
231 231 DTB_FILE=${RPI3_DTB_FILE}
232 232 UBOOT_CONFIG=${RPI3_UBOOT_CONFIG}
233 233 BUILD_KERNEL=true
234 234 else
235 235 echo "error: Raspberry Pi model ${RPI_MODEL} is not supported!"
236 236 exit 1
237 237 fi
238 238
239 239 # Check if the internal wireless interface is supported by the RPi model
240 240 if [ "$ENABLE_WIRELESS" = true ] && [ "$RPI_MODEL" != 3 ] ; then
241 241 echo "error: The selected Raspberry Pi model has no internal wireless interface"
242 242 exit 1
243 243 fi
244 244
245 245 # Check if DISABLE_UNDERVOLT_WARNINGS parameter value is supported
246 246 if [ ! -z "$DISABLE_UNDERVOLT_WARNINGS" ] ; then
247 247 if [ "$DISABLE_UNDERVOLT_WARNINGS" != 1 ] && [ "$DISABLE_UNDERVOLT_WARNINGS" != 2 ] ; then
248 248 echo "error: DISABLE_UNDERVOLT_WARNINGS=${DISABLE_UNDERVOLT_WARNINGS} is not supported"
249 249 exit 1
250 250 fi
251 251 fi
252 252
253 253 # Build RPi2/3 Linux kernel if required by Debian release
254 254 if [ "$RELEASE" = "stretch" ] || [ "$RELEASE" = "buster" ] ; then
255 255 BUILD_KERNEL=true
256 256 fi
257 257
258 258 # Add packages required for kernel cross compilation
259 259 if [ "$BUILD_KERNEL" = true ] ; then
260 260 if [ "$KERNEL_ARCH" = "arm" ] ; then
261 261 REQUIRED_PACKAGES="${REQUIRED_PACKAGES} crossbuild-essential-armhf"
262 262 else
263 263 REQUIRED_PACKAGES="${REQUIRED_PACKAGES} crossbuild-essential-arm64"
264 264 fi
265 265 fi
266 266
267 267 # Add libncurses5 to enable kernel menuconfig
268 268 if [ "$KERNEL_MENUCONFIG" = true ] ; then
269 269 REQUIRED_PACKAGES="${REQUIRED_PACKAGES} libncurses5-dev"
270 270 fi
271 271
272 272 # Stop the Crypto Wars
273 273 if [ "$DISABLE_FBI" = true ] ; then
274 274 ENABLE_CRYPTFS=true
275 275 fi
276 276
277 277 # Add cryptsetup package to enable filesystem encryption
278 278 if [ "$ENABLE_CRYPTFS" = true ] && [ "$BUILD_KERNEL" = true ] ; then
279 279 REQUIRED_PACKAGES="${REQUIRED_PACKAGES} cryptsetup"
280 280 APT_INCLUDES="${APT_INCLUDES},cryptsetup"
281 281
282 282 if [ -z "$CRYPTFS_PASSWORD" ] ; then
283 283 echo "error: no password defined (CRYPTFS_PASSWORD)!"
284 284 exit 1
285 285 fi
286 286 ENABLE_INITRAMFS=true
287 287 fi
288 288
289 289 # Add initramfs generation tools
290 290 if [ "$ENABLE_INITRAMFS" = true ] && [ "$BUILD_KERNEL" = true ] ; then
291 291 APT_INCLUDES="${APT_INCLUDES},initramfs-tools"
292 292 fi
293 293
294 294 # Add device-tree-compiler required for building the U-Boot bootloader
295 295 if [ "$ENABLE_UBOOT" = true ] ; then
296 296 APT_INCLUDES="${APT_INCLUDES},device-tree-compiler"
297 297 fi
298 298
299 299 # Check if root SSH (v2) public key file exists
300 300 if [ ! -z "$SSH_ROOT_PUB_KEY" ] ; then
301 301 if [ ! -f "$SSH_ROOT_PUB_KEY" ] ; then
302 302 echo "error: '$SSH_ROOT_PUB_KEY' specified SSH public key file not found (SSH_ROOT_PUB_KEY)!"
303 303 exit 1
304 304 fi
305 305 fi
306 306
307 307 # Check if $USER_NAME SSH (v2) public key file exists
308 308 if [ ! -z "$SSH_USER_PUB_KEY" ] ; then
309 309 if [ ! -f "$SSH_USER_PUB_KEY" ] ; then
310 310 echo "error: '$SSH_USER_PUB_KEY' specified SSH public key file not found (SSH_USER_PUB_KEY)!"
311 311 exit 1
312 312 fi
313 313 fi
314 314
315 315 # Check if all required packages are installed on the build system
316 316 for package in $REQUIRED_PACKAGES ; do
317 317 if [ "`dpkg-query -W -f='${Status}' $package`" != "install ok installed" ] ; then
318 318 MISSING_PACKAGES="${MISSING_PACKAGES} $package"
319 319 fi
320 320 done
321 321
322 322 # If there are missing packages ask confirmation for install, or exit
323 323 if [ -n "$MISSING_PACKAGES" ] ; then
324 324 echo "the following packages needed by this script are not installed:"
325 325 echo "$MISSING_PACKAGES"
326 326
327 327 echo -n "\ndo you want to install the missing packages right now? [y/n] "
328 328 read confirm
329 329 [ "$confirm" != "y" ] && exit 1
330 330
331 331 # Make sure all missing required packages are installed
332 332 apt-get -qq -y install ${MISSING_PACKAGES}
333 333 fi
334 334
335 335 # Check if ./bootstrap.d directory exists
336 336 if [ ! -d "./bootstrap.d/" ] ; then
337 337 echo "error: './bootstrap.d' required directory not found!"
338 338 exit 1
339 339 fi
340 340
341 341 # Check if ./files directory exists
342 342 if [ ! -d "./files/" ] ; then
343 343 echo "error: './files' required directory not found!"
344 344 exit 1
345 345 fi
346 346
347 347 # Check if specified KERNELSRC_DIR directory exists
348 348 if [ -n "$KERNELSRC_DIR" ] && [ ! -d "$KERNELSRC_DIR" ] ; then
349 349 echo "error: '${KERNELSRC_DIR}' specified directory not found (KERNELSRC_DIR)!"
350 350 exit 1
351 351 fi
352 352
353 353 # Check if specified UBOOTSRC_DIR directory exists
354 354 if [ -n "$UBOOTSRC_DIR" ] && [ ! -d "$UBOOTSRC_DIR" ] ; then
355 355 echo "error: '${UBOOTSRC_DIR}' specified directory not found (UBOOTSRC_DIR)!"
356 356 exit 1
357 357 fi
358 358
359 359 # Check if specified FBTURBOSRC_DIR directory exists
360 360 if [ -n "$FBTURBOSRC_DIR" ] && [ ! -d "$FBTURBOSRC_DIR" ] ; then
361 361 echo "error: '${FBTURBOSRC_DIR}' specified directory not found (FBTURBOSRC_DIR)!"
362 362 exit 1
363 363 fi
364 364
365 365 # Check if specified CHROOT_SCRIPTS directory exists
366 366 if [ -n "$CHROOT_SCRIPTS" ] && [ ! -d "$CHROOT_SCRIPTS" ] ; then
367 367 echo "error: ${CHROOT_SCRIPTS} specified directory not found (CHROOT_SCRIPTS)!"
368 368 exit 1
369 369 fi
370 370
371 371 # Check if specified device mapping already exists (will be used by cryptsetup)
372 372 if [ -r "/dev/mapping/${CRYPTFS_MAPPING}" ] ; then
373 373 echo "error: mapping /dev/mapping/${CRYPTFS_MAPPING} already exists, not proceeding"
374 374 exit 1
375 375 fi
376 376
377 377 # Don't clobber an old build
378 378 if [ -e "$BUILDDIR" ] ; then
379 379 echo "error: directory ${BUILDDIR} already exists, not proceeding"
380 380 exit 1
381 381 fi
382 382
383 383 # Setup chroot directory
384 384 mkdir -p "${R}"
385 385
386 386 # Check if build directory has enough of free disk space >512MB
387 387 if [ "$(df --output=avail ${BUILDDIR} | sed "1d")" -le "524288" ] ; then
388 388 echo "error: ${BUILDDIR} not enough space left to generate the output image!"
389 389 exit 1
390 390 fi
391 391
392 392 set -x
393 393
394 394 # Call "cleanup" function on various signals and errors
395 395 trap cleanup 0 1 2 3 6
396 396
397 397 # Add required packages for the minbase installation
398 398 if [ "$ENABLE_MINBASE" = true ] ; then
399 399 APT_INCLUDES="${APT_INCLUDES},vim-tiny,netbase,net-tools,ifupdown"
400 400 fi
401 401
402 402 # Add required locales packages
403 403 if [ "$DEFLOCAL" != "en_US.UTF-8" ] ; then
404 404 APT_INCLUDES="${APT_INCLUDES},locales,keyboard-configuration,console-setup"
405 405 fi
406 406
407 407 # Add parted package, required to get partprobe utility
408 408 if [ "$EXPANDROOT" = true ] ; then
409 409 APT_INCLUDES="${APT_INCLUDES},parted"
410 410 fi
411 411
412 412 # Add dbus package, recommended if using systemd
413 413 if [ "$ENABLE_DBUS" = true ] ; then
414 414 APT_INCLUDES="${APT_INCLUDES},dbus"
415 415 fi
416 416
417 417 # Add iptables IPv4/IPv6 package
418 418 if [ "$ENABLE_IPTABLES" = true ] ; then
419 419 APT_INCLUDES="${APT_INCLUDES},iptables"
420 420 fi
421 421
422 422 # Add openssh server package
423 423 if [ "$ENABLE_SSHD" = true ] ; then
424 424 APT_INCLUDES="${APT_INCLUDES},openssh-server"
425 425 fi
426 426
427 427 # Add alsa-utils package
428 428 if [ "$ENABLE_SOUND" = true ] ; then
429 429 APT_INCLUDES="${APT_INCLUDES},alsa-utils"
430 430 fi
431 431
432 432 # Add rng-tools package
433 433 if [ "$ENABLE_HWRANDOM" = true ] ; then
434 434 APT_INCLUDES="${APT_INCLUDES},rng-tools"
435 435 fi
436 436
437 437 # Add fbturbo video driver
438 438 if [ "$ENABLE_FBTURBO" = true ] ; then
439 439 # Enable xorg package dependencies
440 440 ENABLE_XORG=true
441 441 fi
442 442
443 443 # Add user defined window manager package
444 444 if [ -n "$ENABLE_WM" ] ; then
445 445 APT_INCLUDES="${APT_INCLUDES},${ENABLE_WM}"
446 446
447 447 # Enable xorg package dependencies
448 448 ENABLE_XORG=true
449 449 fi
450 450
451 451 # Add xorg package
452 452 if [ "$ENABLE_XORG" = true ] ; then
453 453 APT_INCLUDES="${APT_INCLUDES},xorg,dbus-x11"
454 454 fi
455 455
456 456 # Replace selected packages with smaller clones
457 457 if [ "$ENABLE_REDUCE" = true ] ; then
458 458 # Add levee package instead of vim-tiny
459 459 if [ "$REDUCE_VIM" = true ] ; then
460 460 APT_INCLUDES="$(echo ${APT_INCLUDES} | sed "s/vim-tiny/levee/")"
461 461 fi
462 462
463 463 # Add dropbear package instead of openssh-server
464 464 if [ "$REDUCE_SSHD" = true ] ; then
465 465 APT_INCLUDES="$(echo ${APT_INCLUDES} | sed "s/openssh-server/dropbear/")"
466 466 fi
467 467 fi
468 468
469 if [ "$RELEASE" != "jessie" ] ; then
470 APT_INCLUDES="${APT_INCLUDES},libnss-systemd"
471 fi
472
469 473 # Configure kernel sources if no KERNELSRC_DIR
470 474 if [ "$BUILD_KERNEL" = true ] && [ -z "$KERNELSRC_DIR" ] ; then
471 475 KERNELSRC_CONFIG=true
472 476 fi
473 477
474 478 # Configure reduced kernel
475 479 if [ "$KERNEL_REDUCE" = true ] ; then
476 480 KERNELSRC_CONFIG=false
477 481 fi
478 482
479 483 # Execute bootstrap scripts
480 484 for SCRIPT in bootstrap.d/*.sh; do
481 485 head -n 3 "$SCRIPT"
482 486 . "$SCRIPT"
483 487 done
484 488
485 489 ## Execute custom bootstrap scripts
486 490 if [ -d "custom.d" ] ; then
487 491 for SCRIPT in custom.d/*.sh; do
488 492 . "$SCRIPT"
489 493 done
490 494 fi
491 495
492 496 # Execute custom scripts inside the chroot
493 497 if [ -n "$CHROOT_SCRIPTS" ] && [ -d "$CHROOT_SCRIPTS" ] ; then
494 498 cp -r "${CHROOT_SCRIPTS}" "${R}/chroot_scripts"
495 499 chroot_exec /bin/bash -x <<'EOF'
496 500 for SCRIPT in /chroot_scripts/* ; do
497 501 if [ -f $SCRIPT -a -x $SCRIPT ] ; then
498 502 $SCRIPT
499 503 fi
500 504 done
501 505 EOF
502 506 rm -rf "${R}/chroot_scripts"
503 507 fi
504 508
505 509 # Remove c/c++ build environment from the chroot
506 510 chroot_remove_cc
507 511
508 512 # Remove apt-utils
509 513 if [ "$RELEASE" = "jessie" ] ; then
510 514 chroot_exec apt-get purge -qq -y --force-yes apt-utils
511 515 fi
512 516
513 517 # Generate required machine-id
514 518 MACHINE_ID=$(dbus-uuidgen)
515 519 echo -n "${MACHINE_ID}" > "${R}/var/lib/dbus/machine-id"
516 520 echo -n "${MACHINE_ID}" > "${ETC_DIR}/machine-id"
517 521
518 522 # APT Cleanup
519 523 chroot_exec apt-get -y clean
520 524 chroot_exec apt-get -y autoclean
521 525 chroot_exec apt-get -y autoremove
522 526
523 527 # Unmount mounted filesystems
524 528 umount -l "${R}/proc"
525 529 umount -l "${R}/sys"
526 530
527 531 # Clean up directories
528 532 rm -rf "${R}/run/*"
529 533 rm -rf "${R}/tmp/*"
530 534
531 535 # Clean up files
532 536 rm -f "${ETC_DIR}/ssh/ssh_host_*"
533 537 rm -f "${ETC_DIR}/dropbear/dropbear_*"
534 538 rm -f "${ETC_DIR}/apt/sources.list.save"
535 539 rm -f "${ETC_DIR}/resolvconf/resolv.conf.d/original"
536 540 rm -f "${ETC_DIR}/*-"
537 541 rm -f "${ETC_DIR}/apt/apt.conf.d/10proxy"
538 542 rm -f "${ETC_DIR}/resolv.conf"
539 543 rm -f "${R}/root/.bash_history"
540 544 rm -f "${R}/var/lib/urandom/random-seed"
541 545 rm -f "${R}/initrd.img"
542 546 rm -f "${R}/vmlinuz"
543 547 rm -f "${R}${QEMU_BINARY}"
544 548
545 549 # Calculate size of the chroot directory in KB
546 550 CHROOT_SIZE=$(expr `du -s "${R}" | awk '{ print $1 }'`)
547 551
548 552 # Calculate the amount of needed 512 Byte sectors
549 553 TABLE_SECTORS=$(expr 1 \* 1024 \* 1024 \/ 512)
550 554 FRMW_SECTORS=$(expr 64 \* 1024 \* 1024 \/ 512)
551 555 ROOT_OFFSET=$(expr ${TABLE_SECTORS} + ${FRMW_SECTORS})
552 556
553 557 # The root partition is EXT4
554 558 # This means more space than the actual used space of the chroot is used.
555 # As overhead for journaling and reserved blocks 25% are added.
556 ROOT_SECTORS=$(expr $(expr ${CHROOT_SIZE} + ${CHROOT_SIZE} \/ 100 \* 25) \* 1024 \/ 512)
559 # As overhead for journaling and reserved blocks 35% are added.
560 ROOT_SECTORS=$(expr $(expr ${CHROOT_SIZE} + ${CHROOT_SIZE} \/ 100 \* 35) \* 1024 \/ 512)
557 561
558 562 # Calculate required image size in 512 Byte sectors
559 563 IMAGE_SECTORS=$(expr ${TABLE_SECTORS} + ${FRMW_SECTORS} + ${ROOT_SECTORS})
560 564
561 565 # Prepare image file
562 566 if [ "$ENABLE_SPLITFS" = true ] ; then
563 567 dd if=/dev/zero of="$IMAGE_NAME-frmw.img" bs=512 count=${TABLE_SECTORS}
564 568 dd if=/dev/zero of="$IMAGE_NAME-frmw.img" bs=512 count=0 seek=${FRMW_SECTORS}
565 569 dd if=/dev/zero of="$IMAGE_NAME-root.img" bs=512 count=${TABLE_SECTORS}
566 570 dd if=/dev/zero of="$IMAGE_NAME-root.img" bs=512 count=0 seek=${ROOT_SECTORS}
567 571
568 572 # Write firmware/boot partition tables
569 573 sfdisk -q -L -uS -f "$IMAGE_NAME-frmw.img" 2> /dev/null <<EOM
570 574 ${TABLE_SECTORS},${FRMW_SECTORS},c,*
571 575 EOM
572 576
573 577 # Write root partition table
574 578 sfdisk -q -L -uS -f "$IMAGE_NAME-root.img" 2> /dev/null <<EOM
575 579 ${TABLE_SECTORS},${ROOT_SECTORS},83
576 580 EOM
577 581
578 582 # Setup temporary loop devices
579 583 FRMW_LOOP="$(losetup -o 1M --sizelimit 64M -f --show $IMAGE_NAME-frmw.img)"
580 584 ROOT_LOOP="$(losetup -o 1M -f --show $IMAGE_NAME-root.img)"
581 585 else # ENABLE_SPLITFS=false
582 586 dd if=/dev/zero of="$IMAGE_NAME.img" bs=512 count=${TABLE_SECTORS}
583 587 dd if=/dev/zero of="$IMAGE_NAME.img" bs=512 count=0 seek=${IMAGE_SECTORS}
584 588
585 589 # Write partition table
586 590 sfdisk -q -L -uS -f "$IMAGE_NAME.img" 2> /dev/null <<EOM
587 591 ${TABLE_SECTORS},${FRMW_SECTORS},c,*
588 592 ${ROOT_OFFSET},${ROOT_SECTORS},83
589 593 EOM
590 594
591 595 # Setup temporary loop devices
592 596 FRMW_LOOP="$(losetup -o 1M --sizelimit 64M -f --show $IMAGE_NAME.img)"
593 597 ROOT_LOOP="$(losetup -o 65M -f --show $IMAGE_NAME.img)"
594 598 fi
595 599
596 600 if [ "$ENABLE_CRYPTFS" = true ] ; then
597 601 # Create dummy ext4 fs
598 602 mkfs.ext4 "$ROOT_LOOP"
599 603
600 604 # Setup password keyfile
601 605 touch .password
602 606 chmod 600 .password
603 607 echo -n ${CRYPTFS_PASSWORD} > .password
604 608
605 609 # Initialize encrypted partition
606 610 echo "YES" | cryptsetup luksFormat "${ROOT_LOOP}" -c "${CRYPTFS_CIPHER}" -s "${CRYPTFS_XTSKEYSIZE}" .password
607 611
608 612 # Open encrypted partition and setup mapping
609 613 cryptsetup luksOpen "${ROOT_LOOP}" -d .password "${CRYPTFS_MAPPING}"
610 614
611 615 # Secure delete password keyfile
612 616 shred -zu .password
613 617
614 618 # Update temporary loop device
615 619 ROOT_LOOP="/dev/mapper/${CRYPTFS_MAPPING}"
616 620
617 621 # Wipe encrypted partition (encryption cipher is used for randomness)
618 622 dd if=/dev/zero of="${ROOT_LOOP}" bs=512 count=$(blockdev --getsz "${ROOT_LOOP}")
619 623 fi
620 624
621 625 # Build filesystems
622 626 mkfs.vfat "$FRMW_LOOP"
623 627 mkfs.ext4 "$ROOT_LOOP"
624 628
625 629 # Mount the temporary loop devices
626 630 mkdir -p "$BUILDDIR/mount"
627 631 mount "$ROOT_LOOP" "$BUILDDIR/mount"
628 632
629 633 mkdir -p "$BUILDDIR/mount/boot/firmware"
630 634 mount "$FRMW_LOOP" "$BUILDDIR/mount/boot/firmware"
631 635
632 636 # Copy all files from the chroot to the loop device mount point directory
633 637 rsync -a "${R}/" "$BUILDDIR/mount/"
634 638
635 639 # Unmount all temporary loop devices and mount points
636 640 cleanup
637 641
638 642 # Create block map file(s) of image(s)
639 643 if [ "$ENABLE_SPLITFS" = true ] ; then
640 644 # Create block map files for "bmaptool"
641 645 bmaptool create -o "$IMAGE_NAME-frmw.bmap" "$IMAGE_NAME-frmw.img"
642 646 bmaptool create -o "$IMAGE_NAME-root.bmap" "$IMAGE_NAME-root.img"
643 647
644 648 # Image was successfully created
645 649 echo "$IMAGE_NAME-frmw.img ($(expr \( ${TABLE_SECTORS} + ${FRMW_SECTORS} \) \* 512 \/ 1024 \/ 1024)M)" ": successfully created"
646 650 echo "$IMAGE_NAME-root.img ($(expr \( ${TABLE_SECTORS} + ${ROOT_SECTORS} \) \* 512 \/ 1024 \/ 1024)M)" ": successfully created"
647 651 else
648 652 # Create block map file for "bmaptool"
649 653 bmaptool create -o "$IMAGE_NAME.bmap" "$IMAGE_NAME.img"
650 654
651 655 # Image was successfully created
652 656 echo "$IMAGE_NAME.img ($(expr \( ${TABLE_SECTORS} + ${FRMW_SECTORS} + ${ROOT_SECTORS} \) \* 512 \/ 1024 \/ 1024)M)" ": successfully created"
653 657 fi
General Comments 0
Vous devez vous connecter pour laisser un commentaire. Se connecter maintenant