diff options
| -rw-r--r-- | docs/README.altbootmethods | 22 | ||||
| -rw-r--r-- | docs/README.build | 34 | ||||
| -rw-r--r-- | docs/README.transfer | 10 |
3 files changed, 40 insertions, 26 deletions
diff --git a/docs/README.altbootmethods b/docs/README.altbootmethods index ebe1c6e..ec308b1 100644 --- a/docs/README.altbootmethods +++ b/docs/README.altbootmethods @@ -13,7 +13,7 @@ INDEX *** Alternative boot methods (configs/releng) -ISO images names consist of: archlinux-<YYYY>.<MM>.<DD>-<ARCH>.iso +ISO images names consist of: parabola-<YYYY>.<MM>.<DD>-<ARCH>.iso Where: <YYYY> Year @@ -27,22 +27,22 @@ Where: ** ISO in loopback mode. Note: Described method is for using with GRUB2. - GRUB2 is installed on target media and archlinux-<YYYY>.<MM>.<DD>-<ARCH>.iso + GRUB2 is installed on target media and parabola-<YYYY>.<MM>.<DD>-<ARCH>.iso is at path <TARGET-PATH> on disk <D> and partition <P>, where filesystem is labeled as <TARGET-FS-LABEL>. -menuentry "Arch Linux (x86_64)" { - set isofile="/<TARGET-PATH>/archlinux-<YYYY>.<MM>.<DD>-<ARCH>.iso" +menuentry "Parabola (x86_64)" { + set isofile="/<TARGET-PATH>/parabola-<YYYY>.<MM>.<DD>-<ARCH>.iso" loopback loop (hd<D>,<P>)$isofile linux (loop)/arch/boot/x86_64/vmlinuz archisolabel=<FS-LABEL> img_label=<TARGET-FS-LABEL> img_loop=$isofile - initrd (loop)/arch/boot/x86_64/archiso.img + initrd (loop)/arch/boot/x86_64/libreiso.img } -menuentry "Arch Linux (i686)" { - set isofile="/<TARGET-PATH>/archlinux-<YYYY>.<MM>.<DD>-<ARCH>.iso" +menuentry "Parabola (i686)" { + set isofile="/<TARGET-PATH>/parabola-<YYYY>.<MM>.<DD>-<ARCH>.iso" loopback loop (hd<D>,<P>)$isofile linux (loop)/arch/boot/i686/vmlinuz archisolabel=<FS-LABEL> img_label=<TARGET-FS-LABEL> img_loop=$isofile - initrd (loop)/arch/boot/i686/archiso.img + initrd (loop)/arch/boot/i686/libreiso.img } @@ -50,7 +50,7 @@ menuentry "Arch Linux (i686)" { Note: Described method is for using with SYSLINUX. Anyway MEMDISK from SYSLINUX can work with other bootloaders. - SYSLINUX is installed on target media and archlinux-<YYYY>.<MM>.<DD>-<ARCH>.iso + SYSLINUX is installed on target media and parabola-<YYYY>.<MM>.<DD>-<ARCH>.iso is at path <TARGET-PATH>. On 32-bit systems, is needed to pass vmalloc=nnM to the kernel, where nn is the size of the ISO image plus 64 MiB (or 128 MiB). @@ -58,12 +58,12 @@ Note: Described method is for using with SYSLINUX. Anyway MEMDISK from SYSLINUX LABEL arch_x64 LINUX memdisk - INITRD /<TARGET-PATH>/archlinux-<YYYY>.<MM>.<DD>-<ARCH>.iso + INITRD /<TARGET-PATH>/parabola-<YYYY>.<MM>.<DD>-<ARCH>.iso APPEND iso LABEL arch_x32 LINUX memdisk - INITRD /<TARGET-PATH>/archlinux-<YYYY>.<MM>.<DD>-<ARCH>.iso + INITRD /<TARGET-PATH>/parabola-<YYYY>.<MM>.<DD>-<ARCH>.iso APPEND iso diff --git a/docs/README.build b/docs/README.build index 2a3d709..e5a6a55 100644 --- a/docs/README.build +++ b/docs/README.build @@ -4,9 +4,9 @@ INDEX * Build requirements * Image types generated by mkarchiso. * File format for aitab. -* Why the /isolinux and /arch/boot/syslinux directories? -* Building the most basic Arch Linux live media. (configs/baseline) -* Building official Arch Linux live media. (configs/releng) +* Why the /isolinux and /libre/boot/syslinux directories? +* Building the most basic Parabola live media. (configs/baseline) +* Building official Parabola live media. (configs/releng) @@ -75,19 +75,33 @@ It consists of some fields which define the behaviour of images. 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 +/libre/boot/syslinux, like other boot loaders modules (EXTLINUX, SYSLINUX, etc). +When make your custom boot-pendrive, you need to copy /libre directory to it. +/isolinux/isolinux.cfg just holds /libre/boot/syslinux/syslinux.cfg +*** Know issues -*** Building the most basic Arch Linux live media. (configs/baseline) +** (1) On shutdown lots of messages from systemd like: + + "Could not unmount /run/archiso/<ABC>: Device or resource busy" + "Could not delete loopback /dev/loop<N>: Device or resource busy" + This is not a real issue since, all mounted filesystem, loopback devices + and device mapper devices made by archiso will be "free" on "shutdown tmpfs" + (A.K.A deinitramfs), build at initramfs by [archiso_shutdown] initcpio hook. + Proper shutdown is mostly important when persistent is used. + +** (2) syslinux 4.05 bug with relative directories on FAT: + + + +*** Building the most basic Parabola live media. (configs/baseline) * Install needed packages. # pacman -S git make squashfs-tools libisoburn rsync --needed * Install archiso. - # git clone git://projects.archlinux.org/archiso.git + # git clone git://projects.parabolagnulinux.org/archiso.git # make -C archiso install * Build a basic iso. @@ -97,13 +111,13 @@ 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 live media. (configs/releng) * Install needed packages. # pacman -S git make squashfs-tools libisoburn dosfstools lynx patch --needed * Install archiso. - # git clone git://projects.archlinux.org/archiso.git + # git clone git://projects.parabolagnulinux.org/archiso.git # make -C archiso install * Build them! diff --git a/docs/README.transfer b/docs/README.transfer index e9654b8..e93b4e2 100644 --- a/docs/README.transfer +++ b/docs/README.transfer @@ -12,7 +12,7 @@ INDEX *** Transfer ISO image to target medium (configs/releng) -ISO images names consist of: archlinux-<YYYY>.<MM>.<DD>-<ARCH>.iso +ISO images names consist of: parabola-<YYYY>.<MM>.<DD>-<ARCH>.iso Where: <YYYY> Year @@ -36,7 +36,7 @@ Nomeclature: 1) Write it directly using your favorite recording program. -# cdrecord dev=<B>,<T>,<L> -dao archlinux-<YYYY>.<MM>.<DD>-<ARCH>.iso +# cdrecord dev=<B>,<T>,<L> -dao parabola-<YYYY>.<MM>.<DD>-<ARCH>.iso ** To -> USB Flash Drive (USB-key) / Memory card (SD) / @@ -55,10 +55,10 @@ Nomeclature: (example: /dev/sdx1) <MNT-TARGET-N>: Mount point path where <DEV-TARGET-N> is mounted (example: /mnt/sdx/1) -<ISO-SOURCE>: Path to the ISO file archlinux-<YYYY>.<MM>.<DD>-<ARCH>.iso - (example: ~/archlinux-2012.07.22-x86_64.iso) +<ISO-SOURCE>: Path to the ISO file parabola-<YYYY>.<MM>.<DD>-<ARCH>.iso + (example: ~/parabola-2012.07.22-x86_64.iso) <FS-LABEL>: Represents the filesystem label of the <ISO-SOURCE> - (example: ARCH_201207 [for all ~/archlinux-2012.07.*.iso]) + (example: ARCH_201207 [for all ~/parabola-2012.07.*.iso]) * PC-BIOS (MBR): |