Raspi2-3_GenImage Commit - r230:e70175ee5557 · Collaboration Tremplin des Sciences

Merge pull request #13 from drtyhlpr/master...

Gérard Vidal -

r230:e70175ee5557

parent child

Context file:

r230:e70175ee5557

Collapse all files

README-CN.md created 644 +450 0

@@ -0,0 +1,450
	1	## 介绍
	2	`rpi23-gen-image.sh` 是一个自动生成树莓派2/3系统镜像的脚本工具, 当前支持自动生成32位 armhf 架构的Debian, 发行版本`jessie`, `stretch` 和 `buster`. 树莓派3 64位镜像需要使用特定的配置参数 (```templates/rpi3-stretch-arm64-4.11.y```).
	3
	4	## 构建环境所依赖的包
	5	一定要安装好下列deb包, 他们是构建过程需要的核心包. 脚本会自动检查, 如果缺少,经用户确认后会自动安装.
	6
	7	```debootstrap debian-archive-keyring qemu-user-static binfmt-support dosfstools rsync bmap-tools whois git bc psmisc dbus sudo```
	8
	9	推荐通过配置 `rpi23-gen-image.sh` 脚本编译安装最新的树莓派 Linux 内核, 对于树莓派3, 只能如此. 在构建系统上使用 ARM (armhf) 交叉编译工具链编译内核.
	10
	11	脚本已经在Debian Liux `jessie` 和`stretch` 构建系统下使用默认的 `crossbuild-essential-armhf` 工具链进行过测试. 获取更多信息请查看 [Debian 交叉工具链 Wiki](https://wiki.debian.org/CrossToolchains) .
	12
	13	如果使用Debian Linux `jessie` 构建系统, 先要添加交叉编译工具链的源 [Debian 交叉工具链仓库](http://emdebian.org/tools/debian/):
	14
	15	```
	16	echo "deb http://emdebian.org/tools/debian/ jessie main" > /etc/apt/sources.list.d/crosstools.list
	17	sudo -u nobody wget -O - http://emdebian.org/tools/debian/emdebian-toolchain-archive.key \| apt-key add -
	18	dpkg --add-architecture armhf
	19	apt-get update
	20	```
	21
	22	## 命令行参数
	23	脚本可以使用特定的命令行参数来允许或禁止操作系统的某些特性、服务和配置信息. 这些参数通过（简单）脚本变量传递给 `rpi23-gen-image.sh`. 不同于环境变量, （简单）脚本变量在调用`rpi23-gen-image.sh`的命令行前面定义.
	24
	25	##### 命令行示例:
	26	```shell
	27	ENABLE_UBOOT=true ./rpi23-gen-image.sh
	28	ENABLE_CONSOLE=false ENABLE_IPV6=false ./rpi23-gen-image.sh
	29	ENABLE_WM=xfce4 ENABLE_FBTURBO=true ENABLE_MINBASE=true ./rpi23-gen-image.sh
	30	ENABLE_HARDNET=true ENABLE_IPTABLES=true /rpi23-gen-image.sh
	31	APT_SERVER=ftp.de.debian.org APT_PROXY="http://127.0.0.1:3142/" ./rpi23-gen-image.sh
	32	ENABLE_MINBASE=true ./rpi23-gen-image.sh
	33	BUILD_KERNEL=true ENABLE_MINBASE=true ENABLE_IPV6=false ./rpi23-gen-image.sh
	34	BUILD_KERNEL=true KERNELSRC_DIR=/tmp/linux ./rpi23-gen-image.sh
	35	ENABLE_MINBASE=true ENABLE_REDUCE=true ENABLE_MINGPU=true BUILD_KERNEL=true ./rpi23-gen-image.sh
	36	ENABLE_CRYPTFS=true CRYPTFS_PASSWORD=changeme EXPANDROOT=false ENABLE_MINBASE=true ENABLE_REDUCE=true ENABLE_MINGPU=true BUILD_KERNEL=true ./rpi23-gen-image.sh
	37	RELEASE=stretch BUILD_KERNEL=true ./rpi23-gen-image.sh
	38	RPI_MODEL=3 ENABLE_WIRELESS=true ENABLE_MINBASE=true BUILD_KERNEL=true ./rpi23-gen-image.sh
	39	RELEASE=stretch RPI_MODEL=3 ENABLE_WIRELESS=true ENABLE_MINBASE=true BUILD_KERNEL=true ./rpi23-gen-image.sh
	40	```
	41
	42	## 参数模板文件
	43	为了避免冗长的命令行参数以及存储感兴趣的参数配置, `rpi23-gen-image.sh` 支持所谓的参数模板文件 (`CONFIG_TEMPLATE`=template). 这些文本文件位于 `./templates` 目录, 文件中含有将会使用的配置参数. 新的配置模板文件会被添加到 `./templates` 目录.
	44
	45	##### 命令行示例:
	46	```shell
	47	CONFIG_TEMPLATE=rpi3stretch ./rpi23-gen-image.sh
	48	CONFIG_TEMPLATE=rpi2stretch ./rpi23-gen-image.sh
	49	```
	50
	51	## 支持的参数和设置
	52	#### APT 设置:
	53	##### `APT_SERVER`="ftp.debian.org"
	54	设置 Debian 仓库地址. 选择一个 [镜像站点](https://www.debian.org/mirror/list). 选一个近的镜像站点会加快镜像生成过程中所需文件的下载速度.
	55
	56	##### `APT_PROXY`=""
	57	设置代理服务器地址. 使用本地缓存代理, 比如 `apt-cacher-ng` 可以缩短镜像生成时间, 因为所需要的 Debian 包文件只需下载一次.
	58
	59	##### `APT_INCLUDES`=""
	60	生成镜像过程中最先由debootstrap程序自动安装的附加包, 逗号分隔.
	61
	62	##### `APT_INCLUDES_LATE`=""
	63	生成镜像过程中最初的debootstrap完成后, 需要的使用apt命令安装的附加包, 逗号分隔. 特别用在含有 pre-depend 依赖关系的包的, 其依赖关系在打包过程中debootstrap程序中无法正确处理.
	64
	65	---
	66
	67	#### 通用系统设置:
	68	##### `RPI_MODEL`=2
	69	指定树莓派型号. 当前支持树莓派 `2` 和 `3`. 设为 `3` 时 `BUILD_KERNEL` 自动设为true .
	70
	71	##### `RELEASE`="jessie"
	72	设置 Debian 发行版. 脚本当前支持 Debian 发行版 "jessie", "stretch" 和 "buster" 的自动生成. 设为`stretch` 或 `buster`时 `BUILD_KERNEL` 自动设为true.
	73
	74	##### `RELEASE_ARCH`="armhf"
	75	设置期望的 Debian 发行架构.
	76
	77	##### `HOSTNAME`="rpi$RPI_MODEL-$RELEASE"
	78	设置主机名称. 建议所在的子网中主机名称是唯一的.
	79
	80	##### `PASSWORD`="raspberry"
	81	设置系统的 `root` 用户密码. 强烈建议选择一个自定义密码 .
	82
	83	##### `USER_PASSWORD`="raspberry"
	84	设置由 `USER_NAME`=pi 参数创建的普通用户的密码. 如果 `ENABLE_USER`=false 则忽略. 强烈建议选择一个自定义密码.
	85
	86	##### `DEFLOCAL`="en_US.UTF-8"
	87	设置系统默认 locale. 将来可以在运行的系统中执行 `dpkg-reconfigure locales` 命令更改此项设置. 设置这项脚本会自动安装 `locales`, `keyboard-configuration` 和 `console-setup` 三个包.
	88
	89	##### `TIMEZONE`="Europe/Berlin"
	90	设置系统默认时区. 可以在`/usr/share/zoneinfo/` 目录中找到全部可用时区. 将来可以在运行的系统中执行 `dpkg-reconfigure tzdata` 命令更改此项设置.
	91
	92	##### `EXPANDROOT`=true
	93	第一次运行时自动扩展根分区和文件系统.
	94
	95	---
	96
	97	#### 键盘设置:
	98	这些选项用来配置键盘布局文件 `/etc/default/keyboard` 影响控制台和X窗口. 将来可以在运行的系统中执行 `dpkg-reconfigure keyboard-configuration` 命令更改此项设置.
	99
	100	##### `XKB_MODEL`=""
	101	设置键盘类型, 大陆常见pc104.
	102
	103	##### `XKB_LAYOUT`=""
	104	设置键盘布局, 大陆常见us.
	105
	106	##### `XKB_VARIANT`=""
	107	设置键盘布局变种.
	108
	109	##### `XKB_OPTIONS`=""
	110	设置其它 XKB 配置选项.
	111
	112	---
	113
	114	#### 网络设置 (动态):
	115	设置网络为自动获取IP地址. 配置文件位于 `/etc/systemd/network/eth.network`. 在Debian `stretch`中, 默认位置更改为 `/lib/systemd/network`.
	116
	117	##### `ENABLE_DHCP`=true
	118	设置系统使用 DHCP 获取动态IP. 需要有一个 DHCP 服务器.
	119
	120	---
	121
	122	#### 网络设置 (静态):
	123	设置系统为手动配置IP地址. 配置文件位于 `/etc/systemd/network/eth.network`. 在Debian `stretch` 中, 默认位置更改为 `/lib/systemd/network`.
	124	当 `ENABLE_DHCP`=false 时下面这些静态IP设置才起作用.
	125
	126	##### `NET_ADDRESS`=""
	127	设置静态 IPv4 或 IPv6, 使用CIDR "/"形式, 如 "192.169.0.3/24".
	128
	129	##### `NET_GATEWAY`=""
	130	设置默认网关的地址.
	131
	132	##### `NET_DNS_1`=""
	133	设置主域名服务器地址.
	134
	135	##### `NET_DNS_2`=""
	136	设置辅域名服务器地址.
	137
	138	##### `NET_DNS_DOMAINS`=""
	139	设置默认的域名搜索后缀, 当主机名称不是一个完整域名(FQDN)时使用.
	140
	141	##### `NET_NTP_1`=""
	142	设置主时间服务器地址.
	143
	144	##### `NET_NTP_2`=""
	145	设置辅时间服务器地址.
	146
	147	---
	148
	149	#### 基本系统特性:
	150	##### `ENABLE_CONSOLE`=true
	151	允许串行控制台接口. 没有连接显示器键盘的树莓派推荐打开, 此时如果网络无法连接至树莓派, 可以使用串行控制台连至系统.
	152
	153	##### `ENABLE_I2C`=false
	154	允许树莓派2/3的 I2C 接口. 请对照 [树莓派2/3 引脚示意图](http://elinux.org/RPi_Low-level_peripherals) 正确连接 GPIO 引脚.
	155
	156	##### `ENABLE_SPI`=false
	157	允许树莓派2/3的 SPI 接口. 请对照 [树莓派2/3 引脚示意图](http://elinux.org/RPi_Low-level_peripherals) 正确连接 GPIO 引脚.
	158
	159	##### `ENABLE_IPV6`=true
	160	允许 IPv6 . 通过 systemd-networkd 配置管理网络接口.
	161
	162	##### `ENABLE_SSHD`=true
	163	安装并且允许 OpenSSH 服务. 此服务默认禁止 `root` 用户远程登录. 使用普通用户 `pi` 远程登录然后使用 `su -` 或 `sudo` 来取得root权限.
	164
	165	##### `ENABLE_NONFREE`=false
	166	允许安装仓库中的 non-free 类的软件包. 需要安装闭源的固件, 二进制大对象 blob.
	167
	168	##### `ENABLE_WIRELESS`=false
	169	下载安装树莓派3无线接口所需要的闭源固件二进制blob [树莓派3无线接口固件](https://github.com/RPi-Distro/firmware-nonfree/tree/master/brcm80211/brcm). 如果 `RPI_MODEL` 不是 `3` 则忽略.
	170
	171	##### `ENABLE_RSYSLOG`=true
	172	如果设置为 false, 禁用并卸载 rsyslog, 则只能通过日志文件查看logs.
	173
	174	##### `ENABLE_SOUND`=true
	175	允许声卡并且安装 ALSA.
	176
	177	##### `ENABLE_HWRANDOM`=true
	178	允许硬件随机数发生器. 强随机数对大多数使用加密的网络通信是非常重要的. 推荐允许此设置.
	179
	180	##### `ENABLE_MINGPU`=false
	181	最小化显存 (16MB, no X), 目前无法完全禁用GPU.
	182
	183	##### `ENABLE_DBUS`=true
	184	安装并允许 D-Bus 消息总线. 虽然 systemd 可以在没有 D-bus的情况下工作, 但是推荐允许D-Bus.
	185
	186	##### `ENABLE_XORG`=false
	187	是否安装 Xorg, 开源 X11 系统.
	188
	189	##### `ENABLE_WM`=""
	190	安装用户指定的X Window 窗口管理器. 如果设置了`ENABLE_WM`, 系统确定所有被依赖的X11相关软件包都安装好了以后`ENABLE_XORG`会自动设置为true, `rpi23-gen-image.sh` 脚本已经通过下列窗口管理器的测试: `blackbox`, `openbox`, `fluxbox`, `jwm`, `dwm`, `xfce4`, `awesome`.
	191
	192	---
	193
	194	#### 高级系统特性:
	195	##### `ENABLE_MINBASE`=false
	196	使用 debootstrap 脚本变量 `minbase`, 只含有必不可少的核心包和apt. 体积大约 65 MB.
	197
	198	##### `ENABLE_REDUCE`=false
	199	卸载包、删除文件以减小体积详情查看 `REDUCE_*` 参数.
	200
	201	##### `ENABLE_UBOOT`=false
	202	使用 [U-Boot 引导器](http://git.denx.de/?p=u-boot.git;a=summary) 替代树莓派2/3 默认的第二阶段引导器(bootcode.bin). U-Boot 可以通过网络使用 BOOTP/TFTP 协议引导镜像文件.
	203
	204	##### `UBOOTSRC_DIR`=""
	205	存放已下载 [U-Boot 引导器源文件](http://git.denx.de/?p=u-boot.git;a=summary) 的目录(`u-boot`).
	206
	207	##### `ENABLE_FBTURBO`=false
	208	安装并且允许 [硬件加速的 Xorg 显卡驱动](https://github.com/ssvb/xf86-video-fbturbo) `fbturbo`. 当前仅支持窗口的移动和滚动的硬件加速.
	209
	210	##### `FBTURBOSRC_DIR`=""
	211	设置存放已下载的 [硬件加速的 Xorg 显卡驱动](https://github.com/ssvb/xf86-video-fbturbo) 的目录 (`xf86-video-fbturbo`) , 可以复制到chroot内配置、构建和安装.
	212
	213	##### `ENABLE_IPTABLES`=false
	214	允许 iptables 防火墙. 使用最简单的规则集: 允许所有出站连接;禁止除OpenSSH外的所有入站连接.
	215
	216	##### `ENABLE_USER`=true
	217	创建普通用户, 默认用户名`pi`, 默认密码raspberry. 可以使用 `USER_NAME`=user 更改默认用户名;使用 `USER_PASSWORD`=raspberry 更改默认密码.
	218
	219	##### `USER_NAME`=pi
	220	创建普通用户pi. 如果`ENABLE_USER`=false 此参数被忽略.
	221
	222	##### `ENABLE_ROOT`=false
	223	允许root用户登录, 需要设置 root 用户密码.
	224
	225	##### `ENABLE_HARDNET`=false
	226	允许加固 IPv4/IPv6 协议栈, 防止DoS攻击.
	227
	228	##### `ENABLE_SPLITFS`=false
	229	允许将根分区放在USB驱动器中. 将会生成两个镜像文件, 一个挂载为 `/boot/firmware` , 另一个挂载为 `/`.
	230
	231	##### `CHROOT_SCRIPTS`=""
	232	设置自定义脚本目录的路径, 该目录中的脚本在镜像文件构建完成之前在chroot中运行. 这个目录里的可执行文件按着字典序运行.
	233
	234	##### `ENABLE_INITRAMFS`=false
	235	创建 Linux 启动时加载的 initramfs .如果 `ENABLE_CRYPTFS`=true 那么 `ENABLE_INITRAMFS` 自动设为true . 如果 `BUILD_KERNEL`=false 此参数被忽略.
	236
	237	##### `ENABLE_IFNAMES`=true
	238	允许一致/可预测网络接口命名, 支持 Debian 发行版 `stretch` 或 `buster` .
	239
	240	##### `DISABLE_UNDERVOLT_WARNINGS`=
	241	禁止树莓派2/3 的低电压警告. 设为 `1` 禁止警告. 设为 `2` 额外允许低电压下的turbo增强模式.
	242
	243	---
	244
	245	#### SSH 设置:
	246	##### `SSH_ENABLE_ROOT`=false
	247	允许root通过密码验证方式远程登录系统. 如果没有修改默认密码, 这将是个巨大的安全隐患. `ENABLE_ROOT` 必须设为 `true`.
	248
	249	##### `SSH_DISABLE_PASSWORD_AUTH`=false
	250	禁用SSH的密码验证方式, 只支持SSH (v2)的公钥认证.
	251
	252	##### `SSH_LIMIT_USERS`=false
	253	限制通过SSH远程登录的用户. 只允许由 `USER_NAME`=pi 参数创建的普通用户, 以及当 `SSH_ENABLE_ROOT`=true 时 root 用户远程登录. 如果使用的守护程序是 `dropbear` (通过 `REDUCE_SSHD`=true 设置) 则忽略此参数.
	254
	255	##### `SSH_ROOT_PUB_KEY`=""
	256	从指定文件(可包含多个公钥)添加 SSH (v2) 公钥到 `authorized_keys` 文件, 使得 `root` 用户可以使用SSH (v2)的公钥验证方式远程登录, 不支持SSH (v1). `ENABLE_ROOT` 和 `SSH_ENABLE_ROOT` 必须同时设为 `true`.
	257
	258	##### `SSH_USER_PUB_KEY`=""
	259	从指定文件(可包含多个公钥)添加 SSH (v2) 公钥到 `authorized_keys` 文件, 使得由 `USER_NAME`=pi 参数创建的普通用户可以使用SSH (v2)的公钥验证方式远程登录, 不支持SSH (v1).
	260
	261	---
	262
	263	#### 内核编译:
	264	##### `BUILD_KERNEL`=false
	265	构建安装最新的树莓派 2/3 Linux 内核, 当前只支持默认内核配置. 如果设置为树莓派`3`那么自动设置`BUILD_KERNEL`=true .
	266
	267	##### `CROSS_COMPILE`="arm-linux-gnueabihf-"
	268	设置交叉编译器.
	269
	270	##### `KERNEL_ARCH`="arm"
	271	设置内核架构.
	272
	273	##### `KERNEL_IMAGE`="kernel7.img"
	274	内核镜像名称, 如果没有设置, 编译32位内核默认“kernel7.img” 64位内核默认 "kernel8.img".
	275
	276	##### `KERNEL_BRANCH`=""
	277	GIT里的树莓派内核源代码分支名称, 默认使用当前默认分支.
	278
	279	##### `QEMU_BINARY`="/usr/bin/qemu-arm-static"
	280	设置构建系统中的QEMU程序位置. 如果没有设置, 32位内核默认 “/usr/bin/qemu-arm-static” 64位内核默认 "/usr/bin/qemu-aarch64-static".
	281
	282	##### `KERNEL_DEFCONFIG`="bcm2709_defconfig"
	283	设置编译内核的默认配置. 如果没有设置, 32位内核默认"bcm2709_defconfig" 64位内核默认"bcmrpi3\_defconfig".
	284
	285	##### `KERNEL_REDUCE`=false
	286	缩小内核体积, 移除不想要的设备驱动、网络驱动和文件系统驱动 (实验性质).
	287
	288	##### `KERNEL_THREADS`=1
	289	编译内核时的并发线程数量. 如果使用默认设置, 系统会自动检测CPU的内核数量, 设置线程数量, 加速内核编译.
	290
	291	##### `KERNEL_HEADERS`=true
	292	安装内核相应的头文件.
	293
	294	##### `KERNEL_MENUCONFIG`=false
	295	运行`make menuconfig`使用菜单界面配置内核. 退出配置菜单后脚本继续运行.
	296
	297	##### `KERNEL_REMOVESRC`=true
	298	编译安装完成后, 删掉内核源代码, 产生的镜像不含内核源代码.
	299
	300	##### `KERNELSRC_DIR`=""
	301	已下载好的 [Github上的树莓派官方内核](https://github.com/raspberrypi/linux) 源码所在目录 (`linux`) 的路径, 可以复制到chroot内配置、构建和安装.
	302
	303	##### `KERNELSRC_CLEAN`=false
	304	当`KERNELSRC_DIR`被复制到 chroot 之后开始编译之前(使用 `make mrproper`)清理内核源代码. 如果 `KERNELSRC_DIR` 没有设置或者 `KERNELSRC_PREBUILT`=true时忽略此设置.
	305
	306	##### `KERNELSRC_CONFIG`=true
	307	在编译前使用 `make bcm2709_defconfig` (也可以选择 `make menuconfig`) 配置内核源代码. 如果`KERNELSRC_DIR`指定的源码存放目录不存在,这个参数自动设为 `true`. 如果 `KERNELSRC_PREBUILT`=true 忽略此参数.
	308
	309	##### `KERNELSRC_USRCONFIG`=""
	310	复制自己的配置文件到内核的 `.config`. 如果 `KERNEL_MENUCONFIG`=true 拷贝完成后自动运行 make menuconfig.
	311
	312	##### `KERNELSRC_PREBUILT`=false
	313	如果这个参数设为true 表示内核源代码目录中包含成功交叉编译好的内核. 忽略 `KERNELSRC_CLEAN`, `KERNELSRC_CONFIG`, `KERNELSRC_USRCONFIG` and `KERNEL_MENUCONFIG` 这四个参数,不再执行交叉编译操作.
	314
	315	##### `RPI_FIRMWARE_DIR`=""
	316	指定目录 (`firmware`) 含有已经从 [Github上的树莓派官方固件](https://github.com/raspberrypi/firmware)下载到本地的固件. 默认直接从网上下载最新的固件.
	317
	318	---
	319
	320	#### 缩小体积:
	321	如果 `ENABLE_REDUCE`=false 则忽略下列参数.
	322
	323	##### `REDUCE_APT`=true
	324	配置 APT,压缩仓库文件列表,不缓存下载的包文件.
	325
	326	##### `REDUCE_DOC`=true
	327	移除所有的doc文档文件(harsh). 配置 APT, 将来使用`apt-get`安装deb包时不包括doc文件.
	328
	329	##### `REDUCE_MAN`=true
	330	移除所有的man手册页和info文件 (harsh). 配置 APT, 将来使用`apt-get`安装deb包时不包括man手册页.
	331
	332	##### `REDUCE_VIM`=false
	333	使用vim的小型克隆 `levee` 替代 `vim-tiny`.
	334
	335	##### `REDUCE_BASH`=false
	336	使用 `dash` 代替 `bash` (实验性质).
	337
	338	##### `REDUCE_HWDB`=true
	339	移除与 PCI 相关的 hwdb 文件 (实验性质).
	340
	341	##### `REDUCE_SSHD`=true
	342	使用`dropbear`代替 `openssh-server`.
	343
	344	##### `REDUCE_LOCALE`=true
	345	移除所有的 `locale` 本地化文件.
	346
	347	---
	348
	349	#### 加密根分区:
	350	##### `ENABLE_CRYPTFS`=false
	351	使用dm-crypt进行全盘加密. 创建一个 LUKS 加密根分区 (加密方法 aes-xts-plain64:sha512) 并生成所需要的 initramfs. /boot 目录不会被加密. 当`BUILD_KERNEL`=false时忽略此参数. `ENABLE_CRYPTFS` 这个参数当前是实验性质的. SSH-to-initramfs 当前不支持,正在进行中.
	352
	353	##### `CRYPTFS_PASSWORD`=""
	354	设置根分区的加密密码. 如果 `ENABLE_CRYPTFS`=true,请务必设置此参数.
	355
	356	##### `CRYPTFS_MAPPING`="secure"
	357	设置device-mapper映射名称.
	358
	359	##### `CRYPTFS_CIPHER`="aes-xts-plain64:sha512"
	360	加密算法. 推荐 `aes-xts*`加密法.
	361
	362	##### `CRYPTFS_XTSKEYSIZE`=512
	363	设置密钥长度,8的倍数,以bit为单位.
	364
	365	---
	366
	367	#### Build settings构建设置:
	368	##### `BASEDIR`=$(pwd)/images/${RELEASE}
	369	设置产生镜像的目录.
	370
	371	##### `IMAGE_NAME`=${BASEDIR}/${DATE}-${KERNEL_ARCH}-${KERNEL_BRANCH}-rpi${RPI_MODEL}-${RELEASE}-${RELEASE_ARCH}
	372	设置镜像文件名. 如果`ENABLE_SPLITFS`=false则文件名$IMAGE_NAME.img 如果`ENABLE_SPLITFS`=true则文件名$IMAGE_NAME-frmw.img 和 $IMAGE_NAME-root.img. 如果没有设置 `KERNEL_BRANCH` 则使用 "CURRENT" .
	373
	374	## 理解脚本
	375	制作镜像的每个阶段所实现的功能都由各自的脚本完成, 位于 `bootstrap.d` 目录. 按着字典序执行:
	376
	377	\| 脚本 \| 说明 \|
	378	\| --- \| --- \|
	379	\| `10-bootstrap.sh` \| 生成基本系统 \|
	380	\| `11-apt.sh` \| 设置 APT 仓库源 \|
	381	\| `12-locale.sh` \| 设置 Locales 和 keyboard \|
	382	\| `13-kernel.sh` \| 编译安装树莓派 2/3 内核 \|
	383	\| `14-fstab.sh` \| 设置 fstab 和 initramfs \|
	384	\| `15-rpi-config.sh` \| 设置 RPi2/3 config and cmdline \|
	385	\| `20-networking.sh` \| 设置网络 \|
	386	\| `21-firewall.sh` \| 设置防火墙 \|
	387	\| `30-security.sh` \| 设置用户以及安全相关 \|
	388	\| `31-logging.sh` \| 设置日志 \|
	389	\| `32-sshd.sh` \| 设置 SSH 和公钥 \|
	390	\| `41-uboot.sh` \| 编译设置 U-Boot \|
	391	\| `42-fbturbo.sh` \| 编译设置 fbturbo Xorg 驱动 \|
	392	\| `50-firstboot.sh` \| 首次启动执行的任务 \|
	393	\| `99-reduce.sh` \| 缩小体积 \|
	394
	395	所有需要拷贝到镜像文件的配置文件都位于 `files` 目录. 最好不要手动更改这些配置文件.
	396
	397	\| 目录 \| 说明 \|
	398	\| --- \| --- \|
	399	\| `apt` \| APT 管理配置文件 \|
	400	\| `boot` \| 引导文件树莓派2/3配置文件 \|
	401	\| `dpkg` \| 包管理配置文件 \|
	402	\| `etc` \| 配置文件以及 rc 启动脚本 \|
	403	\| `firstboot` \| 首次引导执行的脚本 \|
	404	\| `initramfs` \| Initramfs 脚本 \|
	405	\| `iptables` \| 防火墙配置文件 \|
	406	\| `locales` \| Locales 配置 \|
	407	\| `modules` \| 内核模块配置 \|
	408	\| `mount` \| Fstab 配置 \|
	409	\| `network` \| 网络配置文件 \|
	410	\| `sysctl.d` \| 交换文件以及IP协议加固配置文件 \|
	411	\| `xorg` \| fbturbo Xorg 驱动配置 \|
	412
	413	## 自定义包和脚本
	414	`packages` 目录里放置自定义deb包, 比如系统仓库里没有的软件.在安装完系统仓库中的包之后安装. 自定义包所依赖的deb包会自动从系统仓库下载. 不要把自定义包添加到 `APT_INCLUDES` 参数中.
	415	`custom.d` 目录中的脚本会在其它安装都完成后, 创建镜像文件之前执行.
	416
	417	## 记录镜像产生过程的信息
	418	所有镜像产生过程的信息、`rpi23-gen-image.sh` 脚本执行的命令都可以通过shell的 `script` 命令保存到日志文件中:
	419
	420	```shell
	421	script -c 'APT_SERVER=ftp.de.debian.org ./rpi23-gen-image.sh' ./build.log
	422	```
	423
	424	## 烧录镜像文件
	425	`rpi23-gen-image.sh` 所生成的镜像文件需要使用 `bmaptool` 或 `dd` 烧录到 microSD 卡. `bmaptool` 速度快比 `dd` 聪明.
	426
	427	##### 烧录示例:
	428	```shell
	429	bmaptool copy ./images/jessie/2017-01-23-rpi3-jessie.img /dev/mmcblk0
	430	dd bs=4M if=./images/jessie/2017-01-23-rpi3-jessie.img of=/dev/mmcblk0
	431	```
	432	如果设置过 `ENABLE_SPLITFS`, 烧录 `-frmw` 文件到 microSD 卡, 烧录 `-root` 文件到 USB 驱动器:
	433	```shell
	434	bmaptool copy ./images/jessie/2017-01-23-rpi3-jessie-frmw.img /dev/mmcblk0
	435	bmaptool copy ./images/jessie/2017-01-23-rpi3-jessie-root.img /dev/sdc
	436	```
	437	## 每周镜像
	438	这些镜像由JRWR'S I/O PORT提供, 每周日午夜UTC 0点编译!
	439	* [Debian Stretch Raspberry Pi2/3 周构建镜像](https://jrwr.io/doku.php?id=projects:debianpi)
	440
	441	## External links and references外部链接, 各种资源
	442	* [Debian 全世界镜像列表](https://www.debian.org/mirror/list)
	443	* [Debian 树莓派 2 Wiki](https://wiki.debian.org/RaspberryPi2)
	444	* [Debian 交叉工具链 Wiki](https://wiki.debian.org/CrossToolchains)
	445	* [Github上的树莓派官方固件](https://github.com/raspberrypi/firmware)
	446	* [Github上的树莓派官方内核](https://github.com/raspberrypi/linux)
	447	* [U-BOOT git 仓库](http://git.denx.de/?p=u-boot.git;a=summary)
	448	* [Xorg DDX fbturbo驱动](https://github.com/ssvb/xf86-video-fbturbo)
	449	* [树莓派3无线接口固件](https://github.com/RPi-Distro/firmware-nonfree/tree/master/brcm80211/brcm)
	450	* [Collabora 树莓派2预编译内核](https://repositories.collabora.co.uk/debian/)

bootstrap.d/10-bootstrap.sh +1 -1

             #
             # Debootstrap basic system
             #
             # Load utility functions
             . ./functions.sh
             VARIANT=""
             COMPONENTS="main"
             EXCLUDES=""
             # Use non-free Debian packages if needed
             if [ "$ENABLE_NONFREE" = true ] ; then
-              COMPONENTS="main,non-free"
+              COMPONENTS="main,non-free,contrib"
             fi
             # Use minbase bootstrap variant which only includes essential packages
             if [ "$ENABLE_MINBASE" = true ] ; then
               VARIANT="--variant=minbase"
             fi
             # Exclude packages if required by Debian release
             if [ "$RELEASE" = "stretch" ] || [ "$RELEASE" = "buster" ] ; then
               EXCLUDES="--exclude=init,systemd-sysv"
             fi
             # Base debootstrap (unpack only)
             http_proxy=${APT_PROXY} debootstrap ${EXCLUDES} --arch="${RELEASE_ARCH}" --foreign ${VARIANT} --components="${COMPONENTS}" --include="${APT_INCLUDES}" "${RELEASE}" "${R}" "http://${APT_SERVER}/debian"
             # Copy qemu emulator binary to chroot
             install -m 755 -o root -g root "${QEMU_BINARY}" "${R}${QEMU_BINARY}"
             # Copy debian-archive-keyring.pgp
             mkdir -p "${R}/usr/share/keyrings"
             install_readonly /usr/share/keyrings/debian-archive-keyring.gpg "${R}/usr/share/keyrings/debian-archive-keyring.gpg"
             # Complete the bootstrapping process
             chroot_exec /debootstrap/debootstrap --second-stage
             # Mount required filesystems
             mount -t proc none "${R}/proc"
             mount -t sysfs none "${R}/sys"
             # Mount pseudo terminal slave if supported by Debian release
             if [ -d "${R}/dev/pts" ] ; then
               mount --bind /dev/pts "${R}/dev/pts"
             fi

bootstrap.d/13-kernel.sh +2 -2

             #
             # Build and Setup RPi2/3 Kernel
             #
             # Load utility functions
             . ./functions.sh
             # Fetch and build latest raspberry kernel
             if [ "$BUILD_KERNEL" = true ] ; then
               # Setup source directory
               mkdir -p "${R}/usr/src/linux"
               # Copy existing kernel sources into chroot directory
               if [ -n "$KERNELSRC_DIR" ] && [ -d "$KERNELSRC_DIR" ] ; then
-                # Copy kernel sources
+                # Copy kernel sources and include hidden files
-                cp -r "${KERNELSRC_DIR}/"* "${R}/usr/src/linux"
+                cp -r "${KERNELSRC_DIR}/". "${R}/usr/src/linux"
                 # Clean the kernel sources
                 if [ "$KERNELSRC_CLEAN" = true ] && [ "$KERNELSRC_PREBUILT" = false ] ; then
                   make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" mrproper
                 fi
               else # KERNELSRC_DIR=""
                 # Create temporary directory for kernel sources
                 temp_dir=$(as_nobody mktemp -d)
                 # Fetch current RPi2/3 kernel sources
                 if [ -z "${KERNEL_BRANCH}" ] ; then
                   as_nobody git -C "${temp_dir}" clone --depth=1 "${KERNEL_URL}" linux
                 else
                   as_nobody git -C "${temp_dir}" clone --depth=1 --branch "${KERNEL_BRANCH}" "${KERNEL_URL}" linux
                fi
                 # Copy downloaded kernel sources
                 cp -r "${temp_dir}/linux/"* "${R}/usr/src/linux/"
                 # Remove temporary directory for kernel sources
                 rm -fr "${temp_dir}"
                 # Set permissions of the kernel sources
                 chown -R root:root "${R}/usr/src"
               fi
               # Calculate optimal number of kernel building threads
               if [ "$KERNEL_THREADS" = "1" ] && [ -r /proc/cpuinfo ] ; then
                 KERNEL_THREADS=$(grep -c processor /proc/cpuinfo)
               fi
               # Configure and build kernel
               if [ "$KERNELSRC_PREBUILT" = false ] ; then
                 # Remove device, network and filesystem drivers from kernel configuration
                 if [ "$KERNEL_REDUCE" = true ] ; then
                   make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" "${KERNEL_DEFCONFIG}"
                   sed -i\
                   -e "s/\(^CONFIG_SND.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_SOUND.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_AC97.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_VIDEO_.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_MEDIA_TUNER.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_DVB.*\=\)[ym]/\1n/"\
                   -e "s/\(^CONFIG_REISERFS.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_JFS.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_XFS.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_GFS2.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_OCFS2.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_BTRFS.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_HFS.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_JFFS2.*\=\)[ym]/\1n/"\
                   -e "s/\(^CONFIG_UBIFS.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_SQUASHFS.*\=\)[ym]/\1n/"\
                   -e "s/\(^CONFIG_W1.*\=\)[ym]/\1n/"\
                   -e "s/\(^CONFIG_HAMRADIO.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_CAN.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_IRDA.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_BT_.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_WIMAX.*\=\)[ym]/\1n/"\
                   -e "s/\(^CONFIG_6LOWPAN.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_IEEE802154.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_NFC.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_FB_TFT=.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_TOUCHSCREEN.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_USB_GSPCA_.*\=\).*/\1n/"\
                   -e "s/\(^CONFIG_DRM.*\=\).*/\1n/"\
                   "${KERNEL_DIR}/.config"
                 fi
                 if [ "$KERNELSRC_CONFIG" = true ] ; then
                   # Load default raspberry kernel configuration
                   make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" "${KERNEL_DEFCONFIG}"
                   if [ ! -z "$KERNELSRC_USRCONFIG" ] ; then
                     cp $KERNELSRC_USRCONFIG ${KERNEL_DIR}/.config
                   fi
                   # Start menu-driven kernel configuration (interactive)
                   if [ "$KERNEL_MENUCONFIG" = true ] ; then
                     make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" menuconfig
                   fi
                 fi
                 # Cross compile kernel and modules
                 make -C "${KERNEL_DIR}" -j${KERNEL_THREADS} ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" "${KERNEL_BIN_IMAGE}" modules dtbs
               fi
               # Check if kernel compilation was successful
               if [ ! -r "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/${KERNEL_BIN_IMAGE}" ] ; then
                 echo "error: kernel compilation failed! (kernel image not found)"
                 cleanup
                 exit 1
               fi
               # Install kernel modules
               if [ "$ENABLE_REDUCE" = true ] ; then
                 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" INSTALL_MOD_STRIP=1 INSTALL_MOD_PATH=../../.. modules_install
               else
                 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" INSTALL_MOD_PATH=../../.. modules_install
                 # Install kernel firmware
                 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" INSTALL_FW_PATH=../../../lib firmware_install
               fi
               # Install kernel headers
               if [ "$KERNEL_HEADERS" = true ] && [ "$KERNEL_REDUCE" = false ] ; then
                 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" INSTALL_HDR_PATH=../.. headers_install
               fi
               # Prepare boot (firmware) directory
               mkdir "${BOOT_DIR}"
               # Get kernel release version
               KERNEL_VERSION=`cat "${KERNEL_DIR}/include/config/kernel.release"`
               # Copy kernel configuration file to the boot directory
               install_readonly "${KERNEL_DIR}/.config" "${R}/boot/config-${KERNEL_VERSION}"
               # Copy dts and dtb device tree sources and binaries
               mkdir "${BOOT_DIR}/overlays"
               # Ensure the proper .dtb is located
               if [ "$KERNEL_ARCH" = "arm" ] ; then
                 install_readonly "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/dts/"*.dtb "${BOOT_DIR}/"
               else
                 install_readonly "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/dts/broadcom/"*.dtb "${BOOT_DIR}/"
               fi
               install_readonly "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/dts/overlays/"*.dtb* "${BOOT_DIR}/overlays/"
               install_readonly "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/dts/overlays/README" "${BOOT_DIR}/overlays/README"
               if [ "$ENABLE_UBOOT" = false ] ; then
                 # Convert and copy kernel image to the boot directory
                 "${KERNEL_DIR}/scripts/mkknlimg" "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/${KERNEL_BIN_IMAGE}" "${BOOT_DIR}/${KERNEL_IMAGE}"
               else
                 # Copy kernel image to the boot directory
                 install_readonly "${KERNEL_DIR}/arch/${KERNEL_ARCH}/boot/${KERNEL_BIN_IMAGE}" "${BOOT_DIR}/${KERNEL_IMAGE}"
               fi
               # Remove kernel sources
               if [ "$KERNEL_REMOVESRC" = true ] ; then
                 rm -fr "${KERNEL_DIR}"
               else
                 make -C "${KERNEL_DIR}" ARCH="${KERNEL_ARCH}" CROSS_COMPILE="${CROSS_COMPILE}" modules_prepare
                 # Create symlinks for kernel modules
                 chroot_exec ln -sf /usr/src/linux "/lib/modules/${KERNEL_VERSION}/build"
                 chroot_exec ln -sf /usr/src/linux "/lib/modules/${KERNEL_VERSION}/source"
               fi
             else # BUILD_KERNEL=false
               # Kernel installation
               chroot_exec apt-get -qq -y --no-install-recommends install linux-image-"${COLLABORA_KERNEL}" raspberrypi-bootloader-nokernel
               # Install flash-kernel last so it doesn't try (and fail) to detect the platform in the chroot
               chroot_exec apt-get -qq -y install flash-kernel
               # Check if kernel installation was successful
               VMLINUZ="$(ls -1 ${R}/boot/vmlinuz-* | sort | tail -n 1)"
               if [ -z "$VMLINUZ" ] ; then
                 echo "error: kernel installation failed! (/boot/vmlinuz-* not found)"
                 cleanup
                 exit 1
               fi
               # Copy vmlinuz kernel to the boot directory
               install_readonly "${VMLINUZ}" "${BOOT_DIR}/${KERNEL_IMAGE}"
             fi

General Comments 0

Écrire
Preview

Vous devez vous connecter pour laisser un commentaire. Se connecter maintenant

No TODOs yet

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Dépôts
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages