diff options
Diffstat (limited to 'docs')
-rw-r--r-- | docs/README.altbootmethods | 56 | ||||
-rw-r--r-- | docs/README.bootparams | 60 | ||||
-rw-r--r-- | docs/README.build | 52 | ||||
-rw-r--r-- | docs/README.knownissues | 6 | ||||
-rw-r--r-- | docs/README.transfer | 18 |
5 files changed, 96 insertions, 96 deletions
diff --git a/docs/README.altbootmethods b/docs/README.altbootmethods index 3dc8a2c..77ff917 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>-dual.iso +ISO images names consist of: parabola-<YYYY>.<MM>.<DD>-dual.iso Where: <YYYY> Year @@ -24,22 +24,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>-dual.iso + GRUB2 is installed on target media and parabola-<YYYY>.<MM>.<DD>-dual.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>-dual.iso" +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 archisolabel=<FS-LABEL> img_label=<TARGET-FS-LABEL> img_loop=$isofile - initrd (loop)/arch/boot/x86_64/archiso.img + linux (loop)/parabola/boot/x86_64/vmlinuz parabolaisolabel=<FS-LABEL> img_label=<TARGET-FS-LABEL> img_loop=$isofile + initrd (loop)/parabola/boot/x86_64/parabolaiso.img } -menuentry "Arch Linux (i686)" { - set isofile="/<TARGET-PATH>/archlinux-<YYYY>.<MM>.<DD>-dual.iso" +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 archisolabel=<FS-LABEL> img_label=<TARGET-FS-LABEL> img_loop=$isofile - initrd (loop)/arch/boot/i686/archiso.img + linux (loop)/parabola/boot/i686/vmlinuz parabolaisolabel=<FS-LABEL> img_label=<TARGET-FS-LABEL> img_loop=$isofile + initrd (loop)/parabola/boot/i686/parabolaiso.img } @@ -47,20 +47,20 @@ 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>-dual.iso + SYSLINUX is installed on target media and parabola-<YYYY>.<MM>.<DD>-dual.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). -LABEL arch_x64 +LABEL parabola_x64 LINUX memdisk - INITRD /<TARGET-PATH>/archlinux-<YYYY>.<MM>.<DD>-dual.iso + INITRD /<TARGET-PATH>/parabola-<YYYY>.<MM>.<DD>-dual.iso APPEND iso -LABEL arch_x32 +LABEL parabola_x32 LINUX memdisk - INITRD /<TARGET-PATH>/archlinux-<YYYY>.<MM>.<DD>-dual.iso + INITRD /<TARGET-PATH>/parabola-<YYYY>.<MM>.<DD>-dual.iso APPEND iso @@ -79,11 +79,11 @@ Note: All NIC firmwares should support this. # dnsmasq --port=0 \ --enable-tftp \ - --tftp-root=/run/archiso/bootmnt \ + --tftp-root=/run/parabolaiso/bootmnt \ --dhcp-range=192.168.0.2,192.168.0.254,86400 \ - --dhcp-boot=/arch/boot/syslinux/gpxelinux.0 \ - --dhcp-option-force=209,boot/syslinux/archiso.cfg \ - --dhcp-option-force=210,/arch/ + --dhcp-boot=/parabola/boot/syslinux/gpxelinux.0 \ + --dhcp-option-force=209,boot/syslinux/parabolaiso.cfg \ + --dhcp-option-force=210,/parabola/ * DHCP + HTTP @@ -92,34 +92,34 @@ Note: Not all NIC firmware supports HTTP and DNS (if domain name is used). # dnsmasq --port=0 \ --dhcp-range=192.168.0.2,192.168.0.254,86400 \ - --dhcp-boot=http://192.168.0.7/arch/boot/syslinux/gpxelinux.0 \ - --dhcp-option-force=209,boot/syslinux/archiso.cfg \ - --dhcp-option-force=210,http://192.168.0.7/arch/ + --dhcp-boot=http://192.168.0.7/parabola/boot/syslinux/gpxelinux.0 \ + --dhcp-option-force=209,boot/syslinux/parabolaiso.cfg \ + --dhcp-option-force=210,http://192.168.0.7/parabola/ Once the kernel is started from PXE, SquashFS files and other misc files -inside "arch" directory must be loaded (second stage). One of the following +inside "parabola" directory must be loaded (second stage). One of the following methods can be used to serve the rest of live-medium. * HTTP -# darkhttpd /run/archiso/bootmnt +# darkhttpd /run/parabolaiso/bootmnt * NFS -# echo "/run/archiso/bootmnt 192.168.0.*(ro,no_subtree_check,no_root_squash)" >> /etc/exports +# echo "/run/parabolaiso/bootmnt 192.168.0.*(ro,no_subtree_check,no_root_squash)" >> /etc/exports # systemctl start rpc-mountd.service * NBD -Note: Adjust ARCH_201302 as needed. +Note: Adjust PARABOLA_201302 as needed. # cat << EOF > /tmp/nbd-server.conf [generic] -[archiso] +[parabolaiso] readonly = true - exportname = /dev/disk/by-label/ARCH_201302 + exportname = /dev/disk/by-label/PARABOLA_201302 EOF # nbd-server -C /tmp/nbd-server.conf diff --git a/docs/README.bootparams b/docs/README.bootparams index 8063bd1..7139976 100644 --- a/docs/README.bootparams +++ b/docs/README.bootparams @@ -2,12 +2,12 @@ INDEX ----- * Boot parameters (initramfs stage) - * hooks/archiso - * hooks/archiso_pxe_common - * hooks/archiso_pxe_nbd - * hooks/archiso_pxe_http - * hooks/archiso_pxe_nfs - * hooks/archiso_loop_mnt + * hooks/parabolaiso + * hooks/parabolaiso_pxe_common + * hooks/parabolaiso_pxe_nbd + * hooks/parabolaiso_pxe_http + * hooks/parabolaiso_pxe_nfs + * hooks/parabolaiso_loop_mnt * Boot parameters (configs/releng) * scripts/choose-mirror @@ -15,16 +15,16 @@ INDEX *** Boot parameters (initramfs stage) -** hooks/archiso +** hooks/parabolaiso -* archisolabel= Set the filesystem label where archiso files reside. +* parabolaisolabel= Set the filesystem label where parabolaiso files reside. Default: (unset) -* archisodevice= Set the device node where archiso medium is located. - Default: "/dev/disk/by-label/${archisolabel}" -* archisobasedir= Set the base directory where all files reside. - Default: "arch" +* parabolaisodevice= Set the device node where parabolaiso medium is located. + Default: "/dev/disk/by-label/${parabolaisolabel}" +* parabolaisobasedir= Set the base directory where all files reside. + Default: "parabola" * aitab= Set the path for "aitab" file. - Default: ${archisobasedir}/aitab + Default: ${parabolaisobasedir}/aitab * copytoram= If set to "y" or just "copytoram" without arguments, all SquashFS are copied to "RAM". Default: (unset) @@ -39,7 +39,7 @@ INDEX must be stored. Default: (unset) or "/dev/disk/by-label/${cow_label}" * cow_directory= Set a directory inside ${cow_device}. - Default: "/persistent_${archisolabel}/${arch}" + Default: "/persistent_${parabolaisolabel}/${arch}" * cow_persistent= Set if snapshots are persistent "P" or non-persistent "N". Default: "N" (if no ${cow_device} is used) otherwise "P". * cowspace_size= Set the size of tmpfs /cowspace. This space is used for @@ -58,14 +58,14 @@ INDEX in percentage of available RAM. Default: "75%" * dm_snap_prefix= Set a prefix for device-mapper snapshot node names. - Default: "arch" + Default: "parabola" * arch= Force an architecture type (i686 | x86_64). Do not set it for normal operations. Useful for running a 64 bit kernel / 32 bit userspace. Default: (architecture of running kernel) -** hooks/archiso_pxe_common +** hooks/parabolaiso_pxe_common * ip= This parameter is setup automatically by PXELINUX when option "IPAPPEND" is set to 1 or 2 in config. @@ -80,31 +80,31 @@ INDEX Default: "y" -** hooks/archiso_pxe_nbd +** hooks/parabolaiso_pxe_nbd -* archiso_nbd_name= Set NBD export name used by the server. - Default: archiso -* archiso_nbd_srv= Set an IP address where NBD reside. +* parabolaiso_nbd_name= Set NBD export name used by the server. + Default: parabolaiso +* parabolaiso_nbd_srv= Set an IP address where NBD reside. If ${pxeserver} is used, PXE IP will be used. Default: (unset) -** hooks/archiso_pxe_http +** hooks/parabolaiso_pxe_http -* archiso_http_srv= Set an HTTP URL (must end with /) where ${archisobasedir} +* parabolaiso_http_srv= Set an HTTP URL (must end with /) where ${parabolaisobasedir} is found with all *.sfs files. In the IP/domain part if ${pxeserver} is used, use PXE IP. Default: (unset) -* archiso_http_spc= Set the size of tmpfs where *.sfs files are downloaded. +* parabolaiso_http_spc= Set the size of tmpfs where *.sfs files are downloaded. Default: "75%" -** hooks/archiso_pxe_nfs +** hooks/parabolaiso_pxe_nfs -* archiso_nfs_srv= Set the NFS-IP:/path of the server +* parabolaiso_nfs_srv= Set the NFS-IP:/path of the server In the IP part if ${pxeserver} is used, PXE IP will be used. Default: (unset) -* archiso_nfs_opt= Set NFS mount options separated by comma. +* parabolaiso_nfs_opt= Set NFS mount options separated by comma. Default: (unset, see below) These are the implicit options: port = as given by server portmap daemon @@ -119,13 +119,13 @@ INDEX flags = hard, nointr, noposix, cto, ac -** hooks/archiso_loop_mnt +** hooks/parabolaiso_loop_mnt -* img_label= Set the filesystem label where archiso-image.iso. +* img_label= Set the filesystem label where parabolaiso-image.iso. Default: (unset) -* img_dev= Device where archiso-image.iso reside. +* img_dev= Device where parabolaiso-image.iso reside. Default: (unset) or "/dev/disk/by-label/${img_label}" -* img_loop= Full path where archiso-image.iso is located on ${img_dev} +* img_loop= Full path where parabolaiso-image.iso is located on ${img_dev} Default: (unset) diff --git a/docs/README.build b/docs/README.build index 80d4b2c..f2fb594 100644 --- a/docs/README.build +++ b/docs/README.build @@ -2,17 +2,17 @@ INDEX ----- * Build requirements -* Image types generated by mkarchiso. +* Image types generated by mkparabolaiso. * 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 /parabola/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) *** Build requirements -** For mkarchiso script needs these packages (build host): +** For mkparabolaiso script needs these packages (build host): + squashfs-tools for mksquashfs + libisoburn for xorriso + btrfs-progs for mkfs.btrfs (optional) @@ -22,23 +22,23 @@ INDEX + lynx for fetching the latest installation guide ** For these hooks needs these packages (on target root-image) -* archiso +* parabolaiso + (none) -* archiso_loop_mnt +* parabolaiso_loop_mnt + (none) -* archiso_pxe_common +* parabolaiso_pxe_common + mkinitcpio-nfs-utils for ipconfig -* archiso_pxe_nbd +* parabolaiso_pxe_nbd + nbd for nbd-client -* archiso_pxe_http +* parabolaiso_pxe_http + curl for curl -* archiso_pxe_nfs +* parabolaiso_pxe_nfs + mkinitcpio-nfs-utils for nfsmount -* archiso_shutdown +* parabolaiso_shutdown + (none) -*** Image types generated by mkarchiso. +*** Image types generated by mkparabolaiso. * image-name.sfs SquashFS image with all files directly on it. [read-only, no dm-snapshot is used] @@ -51,7 +51,7 @@ INDEX *** 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. +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> @@ -72,40 +72,40 @@ It consists of some fields which define the behaviour of images. Space used + 10% (estimated for metadata overhead) + desired % -*** Why the /isolinux and /arch/boot/syslinux directories? +*** 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 -/arch/boot/syslinux, like other boot loaders modules (SYSLINUX, PXELINUX). +/parabola/boot/syslinux, like other boot loaders modules (SYSLINUX, PXELINUX). -*** Building the most basic Arch Linux live media. (configs/baseline) +*** 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 archiso. - # git clone git://projects.archlinux.org/archiso.git - # make -C archiso install +* Install parabolaiso. + # git clone git://projects.parabolagnulinux.org/parabolaiso.git + # make -C parabolaiso install * Build a basic iso. - # /usr/share/archiso/configs/baseline/build.sh + # /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 Arch Linux live media. (configs/releng) +*** Building official Parabola GNU/Linux-libre live media. (configs/releng) * Install needed packages. # pacman -S git make squashfs-tools libisoburn dosfstools lynx --needed -* Install archiso. - # git clone git://projects.archlinux.org/archiso.git - # make -C archiso install +* Install parabolaiso. + # git clone git://projects.parabolagnulinux.org/parabolaiso.git + # make -C parabolaiso install * Build them! - # /usr/share/archiso/configs/releng/build.sh + # /usr/share/parabolaiso/configs/releng/build.sh Note: See build.sh -h for more options. This only runs on x86_64. diff --git a/docs/README.knownissues b/docs/README.knownissues index 3a94764..7002c5e 100644 --- a/docs/README.knownissues +++ b/docs/README.knownissues @@ -2,11 +2,11 @@ ** (1) On shutdown lots of messages from systemd like: - "Could not unmount /run/archiso/<ABC>: Device or resource busy" + "Could not unmount /run/parabolaiso/<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. + and device mapper devices made by parabolaiso will be "free" on "shutdown tmpfs" + (A.K.A deinitramfs), build at initramfs by [parabolaiso_shutdown] initcpio hook. Proper shutdown is mostly important when persistent is used. diff --git a/docs/README.transfer b/docs/README.transfer index c2883ad..fd916fc 100644 --- a/docs/README.transfer +++ b/docs/README.transfer @@ -13,7 +13,7 @@ INDEX *** Transfer ISO image to target medium (configs/releng) -ISO images names consist of: archlinux-<YYYY>.<MM>.<DD>-dual.iso +ISO images names consist of: parabola-<YYYY>.<MM>.<DD>-dual.iso Where: <YYYY> Year @@ -34,7 +34,7 @@ Nomeclature: 1) Write it directly using your favorite recording program. -# cdrecord dev=<B>,<T>,<L> -dao archlinux-<YYYY>.<MM>.<DD>-dual.iso +# cdrecord dev=<B>,<T>,<L> -dao parabola-<YYYY>.<MM>.<DD>-dual.iso ** To -> USB Flash Drive (USB-key) / Memory card (SD) / @@ -42,9 +42,9 @@ Nomeclature: Note: These steps are the general workflow, you can skip some of them, using another filesystem if your bootloader supports it, - installing to another directory than "arch/" or using more than + installing to another directory than "parabola/" or using more than one partition. Just ensure that main boot params options - (archisolabel= and archisobasedir=) are set correctly according to your setup. + (parabolaisolabel= and parabolaisobasedir=) are set correctly according to your setup. Nomeclature: <DEV-TARGET>: Device node of the drive where ISO contents should be copied @@ -53,10 +53,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>-dual.iso - (example: ~/archlinux-2012.07.22-dual.iso) +<ISO-SOURCE>: Path to the ISO file parabola-<YYYY>.<MM>.<DD>-dual.iso + (example: ~/parabola-2012.07.22-dual.iso) <FS-LABEL>: Represents the filesystem label of the <ISO-SOURCE> - (example: ARCH_201302) + (example: PARABOLA_201302) * PC-BIOS (MBR): @@ -83,7 +83,7 @@ Note: COW is not supported on NTFS. # bsdtar -x --exclude=isolinux/ --exclude=EFI/ --exclude=loader/ -f <ISO-SOURCE> -C <MNT-TARGET-N> 5) Install syslinux bootloader on target filesystem. -# extlinux -i <MNT-TARGET-N>/arch/boot/syslinux +# extlinux -i <MNT-TARGET-N>/parabola/boot/syslinux 6) Unmount target filesystem. # umount <MNT-TARGET-N> @@ -117,7 +117,7 @@ Note: Using here a GPT partition mode as example, but MBR should also works # mount <DEV-TARGET-N> <MNT-TARGET-N> 4) Extract ISO image on target filesystem. -# bsdtar -x --exclude=isolinux/ --exclude=EFI/archiso/ --exclude=arch/boot/syslinux/ -f <ISO-SOURCE> -C <MNT-TARGET-N> +# bsdtar -x --exclude=isolinux/ --exclude=EFI/parabolaiso/ --exclude=parabola/boot/syslinux/ -f <ISO-SOURCE> -C <MNT-TARGET-N> 5) Unmount target filesystem. # umount <MNT-TARGET-N> |