summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorEsteban Carnevale <alfplayer@mailoo.org>2013-03-13 19:25:06 -0300
committerbill-auger <mr.j.spam.me@gmail.com>2019-10-19 05:15:44 -0400
commite0816ea51337e87cbd5e62a05691315e1329f0c6 (patch)
tree0d01146835ef249f740e6877a2638aae838d72a2 /docs
parentaca77a1df472e2601e2471fa879fe4efba770fcf (diff)
Replace: Arch Linux -> Parabola GNU/Linux-libre
Diffstat (limited to 'docs')
-rw-r--r--docs/README.altbootmethods4
-rw-r--r--docs/README.build55
2 files changed, 53 insertions, 6 deletions
diff --git a/docs/README.altbootmethods b/docs/README.altbootmethods
index eeab486..12d309d 100644
--- a/docs/README.altbootmethods
+++ b/docs/README.altbootmethods
@@ -28,14 +28,14 @@ Note: Described method is for using with GRUB2.
is at path <TARGET-PATH> on disk <D> and partition <P>,
where filesystem is labeled as <TARGET-FS-LABEL>.
-menuentry "Arch Linux (x86_64)" {
+menuentry "Parabola GNU/Linux-libre (x86_64)" {
set isofile="/<TARGET-PATH>/parabola-<YYYY>.<MM>.<DD>-dual.iso"
loopback loop (hd<D>,<P>)$isofile
linux (loop)/arch/boot/x86_64/vmlinuz img_label=<TARGET-FS-LABEL> img_loop=$isofile
initrd (loop)/arch/boot/x86_64/archiso.img
}
-menuentry "Arch Linux (i686)" {
+menuentry "Parabola GNU/Linux-libre (i686)" {
set isofile="/<TARGET-PATH>/parabola-<YYYY>.<MM>.<DD>-dual.iso"
loopback loop (hd<D>,<P>)$isofile
linux (loop)/arch/boot/i686/vmlinuz img_label=<TARGET-FS-LABEL> img_loop=$isofile
diff --git a/docs/README.build b/docs/README.build
index 1fa9eee..fa9a1c7 100644
--- a/docs/README.build
+++ b/docs/README.build
@@ -2,8 +2,11 @@ INDEX
-----
* Build requirements
-* Building the most basic Arch Linux live media. (configs/baseline)
-* Building official Arch Linux live media. (configs/releng)
+* Image types generated by mkarchiso.
+* File format for aitab.
+* Why the /isolinux and /arch/boot/syslinux directories?
+* Building the most basic Parabola GNU/Linux-libre live media. (configs/baseline)
+* Building official Parabola GNU/Linux-libre live media. (configs/releng)
@@ -36,7 +39,51 @@ INDEX
+ (none)
-*** Building the most basic Arch Linux live media. (configs/baseline)
+*** Image types generated by mkarchiso.
+
+* 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 mkarchiso and mounted at initramfs stage from the archiso 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 /arch/boot/syslinux directories?
+
+The /isolinux directory holds files needed for the ISOLINUX boot loader
+module of SYSLINUX. ISOLINUX can not find config files on
+/arch/boot/syslinux, like other boot loaders modules (EXTLINUX, SYSLINUX, etc).
+When make your custom boot-pendrive, you need to copy /arch directory to it.
+/isolinux/isolinux.cfg just holds /arch/boot/syslinux/syslinux.cfg
+
+
+
+*** Building the most basic Parabola GNU/Linux-libre live media. (configs/baseline)
* Install needed packages.
# pacman -S git make arch-install-scripts squashfs-tools libisoburn --needed
@@ -52,7 +99,7 @@ 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 Arch Linux live media. (configs/releng)
+*** Building official Parabola GNU/Linux-libre live media. (configs/releng)
* Install needed packages.
# pacman -S git make arch-install-scripts squashfs-tools libisoburn dosfstools lynx --needed