1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
INDEX
-----
* Build requirements
* Image types generated by mkparabolaiso.
* File format for aitab.
* Why the /isolinux and /parabola/boot/syslinux directories?
* Git branches and build configurations.
* Building the most basic Parabola GNU/Linux-libre live media. (configs/baseline)
* Building official Parabola GNU/Linux-libre live media. (configs/releng)
*** Build requirements
** For mkparabolaiso script needs these packages (build host):
+ squashfs-tools for mksquashfs
+ libisoburn for xorriso
+ btrfs-progs for mkfs.btrfs (optional)
** For configs/releng build.sh needs theses packages (build host):
+ dosfstools for mkfs.vfat
+ lynx for fetching the latest installation guide
** For these hooks needs these packages (on target root-image)
* parabolaiso
+ (none)
* parabolaiso_loop_mnt
+ (none)
* parabolaiso_pxe_common
+ mkinitcpio-nfs-utils for ipconfig
* parabolaiso_pxe_nbd
+ nbd for nbd-client
* parabolaiso_pxe_http
+ curl for curl
* parabolaiso_pxe_nfs
+ mkinitcpio-nfs-utils for nfsmount
* parabolaiso_shutdown
+ (none)
*** Image types generated by mkparabolaiso.
* image-name.sfs SquashFS image with all files directly on it.
[read-only, no dm-snapshot is used]
* image-name.fs.sfs SquashFS with only one file inside (image-name.fs),
which is an image of some type of filesystem
(ext4, ext3, ext2, xfs, btrfs), all files reside on it.
[read-write, via COW image with dm-snapshot]
*** File format for aitab.
The aitab file holds information about the filesystems images that must be
created by mkparabolaiso and mounted at initramfs stage from the parabolaiso hook.
It consists of some fields which define the behaviour of images.
# <img> <mnt> <arch> <sfs_comp> <fs_type> <fs_size>
<img> Image name without extension (.fs .fs.sfs .sfs).
<mnt> Mount point.
<arch> Architecture { i686 | x86_64 | any }.
<sfs_comp> SquashFS compression type { gzip | lzo | xz }.
<fs_type> Set the filesystem type of the image
{ ext4 | ext3 | ext2 | xfs | btrfs }.
A special value of "none" denotes no usage of a filesystem.
In that case all files are pushed directly to SquashFS filesystem.
<fs_size> An absolute value of file system image size in MiB.
(example: 100, 1000, 4096, etc)
A relative value of file system free space [in percent].
{1%..99%} (example 50%, 10%, 7%).
This is an estimation, and calculated in a simple way.
Space used + 10% (estimated for metadata overhead) + desired %
*** Why the /isolinux and /parabola/boot/syslinux directories?
The /isolinux directory holds files needed for the ISOLINUX boot loader
module of SYSLINUX. ISOLINUX can not find config files on
/parabola/boot/syslinux, like other boot loaders modules (SYSLINUX, PXELINUX).
*** Git branches and build configurations.
The parabolaiso git repo consists of several branches; only some of which are useful for building ISOs. Others exist only for merging with upstream. The build configurations on the 'master' branch are used to build the official release ISOs.
** Branches not intended for building ISOs.
* helper/rebrand - Branch to aid rebranding. Branch master of archiso.git plus Parabola rebranding of filenames and file contents. It is used as an intermediate step to merge Archiso, to aid git detecting file renames.
* rebrand/releng - Rebranding branch. helper/rebrand leaving only the directory of releng inside configs/, renamed to profile/. It is possible to create equivalent branches for other ISO variants.
* rebrand/baseline - Rebranding branch. Same concept as rebrand/releng.
* release - Contains snapshots of releases, with commits showing updates of each profile. It should be updated only by make dist.
* release-branches - Snapshots of last commits (HEAD) of each specified profile branch. Same concept as the branch release. It should be updated only by make dist-branches. Using it is not strictly necessary. It does not exist in the public Parabola repository parabolaiso.git.
** Branches for building ISOs.
* baseline - Profile branch "baseline". master is separated from baseline to its own branch. This is now different from Archiso, and enables merging the releng profile in other profiles that use releng as a base.
* master - Profile branch a.k.a "releng". Branch rebrand/releng with Parabola customizations. The files outside configs/ which are common to all variants are packaged from this branch.
** Build configurations.
* configs/profile - the Parabola standard CLI release ISO
* configs/mate - the Parabola Mate release ISO
* configs/talkingparabola - the TalkingParabola CLI release ISO
* configs/talkingparabola-X11- the TalkingParabola Mate release ISO
*** Building the most basic Parabola GNU/Linux-libre live media. (configs/baseline)
* Install needed packages.
# pacman -S git make squashfs-tools libisoburn rsync --needed
* Install parabolaiso.
# git clone git://projects.parabolagnulinux.org/parabolaiso.git
# make -C parabolaiso install
* Build a basic iso.
# /usr/share/parabolaiso/configs/baseline/build.sh
Note: If you want to customize, just see the configs/releng directory which is
used to build official images with much more things.
*** Building official Parabola GNU/Linux-libre live media. (configs/releng)
* Install needed packages.
# pacman -S git make squashfs-tools libisoburn dosfstools lynx --needed
* Install parabolaiso.
# git clone git://projects.parabolagnulinux.org/parabolaiso.git
# make -C parabolaiso install
* Build them!
# /usr/share/parabolaiso/configs/releng/build.sh
Note: See build.sh -h for more options. This only runs on x86_64.
|
