From eed77efd49e7104f776d411e8a20442d129d9db8 Mon Sep 17 00:00:00 2001 From: Esteban Carnevale Date: Wed, 13 Mar 2013 19:25:39 -0300 Subject: Replace: archiso -> parabolaiso --- docs/README.altbootmethods | 20 ++++++++--------- docs/README.bootparams | 56 +++++++++++++++++++++++----------------------- docs/README.build | 38 +++++++++++++++---------------- docs/README.knownissues | 6 ++--- docs/README.transfer | 4 ++-- 5 files changed, 62 insertions(+), 62 deletions(-) (limited to 'docs') diff --git a/docs/README.altbootmethods b/docs/README.altbootmethods index 1084d66..4d6304d 100644 --- a/docs/README.altbootmethods +++ b/docs/README.altbootmethods @@ -31,15 +31,15 @@ Note: Described method is for using with GRUB2. menuentry "Parabola GNU/Linux-libre (x86_64)" { set isofile="//parabola-..
-dual.iso" loopback loop (hd,

)$isofile - linux (loop)/arch/boot/x86_64/vmlinuz archisolabel= img_label= img_loop=$isofile - initrd (loop)/arch/boot/x86_64/archiso.img + linux (loop)/arch/boot/x86_64/vmlinuz parabolaisolabel= img_label= img_loop=$isofile + initrd (loop)/arch/boot/x86_64/parabolaiso.img } menuentry "Parabola GNU/Linux-libre (i686)" { set isofile="//parabola-..

-dual.iso" loopback loop (hd,

)$isofile - linux (loop)/arch/boot/i686/vmlinuz archisolabel= img_label= img_loop=$isofile - initrd (loop)/arch/boot/i686/archiso.img + linux (loop)/arch/boot/i686/vmlinuz parabolaisolabel= img_label= img_loop=$isofile + initrd (loop)/arch/boot/i686/parabolaiso.img } @@ -79,10 +79,10 @@ 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=209,boot/syslinux/parabolaiso.cfg \ --dhcp-option-force=210,/arch/ * DHCP + HTTP @@ -93,7 +93,7 @@ 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=209,boot/syslinux/parabolaiso.cfg \ --dhcp-option-force=210,http://192.168.0.7/arch/ @@ -103,12 +103,12 @@ 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 @@ -118,7 +118,7 @@ Note: Adjust ARCH_201302 as needed. # cat << EOF > /tmp/nbd-server.conf [generic] -[archiso] +[parabolaiso] readonly = true exportname = /dev/disk/by-label/ARCH_201302 EOF diff --git a/docs/README.bootparams b/docs/README.bootparams index 13e1ead..0f19b5b 100644 --- a/docs/README.bootparams +++ b/docs/README.bootparams @@ -2,27 +2,27 @@ 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 (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. +* 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: "arch" * 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) @@ -37,7 +37,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 @@ -63,7 +63,7 @@ INDEX 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. @@ -78,31 +78,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 @@ -117,11 +117,11 @@ 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 faf6cca..ba17e94 100644 --- a/docs/README.build +++ b/docs/README.build @@ -2,7 +2,7 @@ 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 Parabola GNU/Linux-libre live media. (configs/baseline) @@ -12,7 +12,7 @@ INDEX *** 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) @@ -23,23 +23,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] @@ -52,7 +52,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. # @@ -88,12 +88,12 @@ When make your custom boot-pendrive, you need to copy /arch directory to it. * Install needed packages. # pacman -S git make squashfs-tools libisoburn rsync --needed -* Install archiso. - # git clone git://projects.parabolagnulinux.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. @@ -104,11 +104,11 @@ used to build official images with much more things. * Install needed packages. # pacman -S git make squashfs-tools libisoburn dosfstools lynx patch --needed -* Install archiso. - # git clone git://projects.parabolagnulinux.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 2f9cf70..1ff23e1 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/: Device or resource busy" + "Could not unmount /run/parabolaiso/: Device or resource busy" "Could not delete loopback /dev/loop: 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. ** (2) ISOHYBRID-MBR does boot on some hardware: diff --git a/docs/README.transfer b/docs/README.transfer index f829e0c..37dfa77 100644 --- a/docs/README.transfer +++ b/docs/README.transfer @@ -43,7 +43,7 @@ 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 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: : Device node of the drive where ISO contents should be copied @@ -116,7 +116,7 @@ Note: Using here a GPT partition mode as example, but MBR should also works # mount 4) Extract ISO image on target filesystem. -# bsdtar -x --exclude=isolinux/ --exclude=EFI/archiso/ --exclude=arch/boot/syslinux/ -f -C +# bsdtar -x --exclude=isolinux/ --exclude=EFI/parabolaiso/ --exclude=arch/boot/syslinux/ -f -C 5) Unmount target filesystem. # umount -- cgit v1.2.2