summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/README.altbootmethods20
-rw-r--r--docs/README.bootparams56
-rw-r--r--docs/README.build38
-rw-r--r--docs/README.knownissues6
-rw-r--r--docs/README.transfer4
5 files changed, 62 insertions, 62 deletions
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="/<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)/arch/boot/x86_64/vmlinuz parabolaisolabel=<FS-LABEL> img_label=<TARGET-FS-LABEL> img_loop=$isofile
+ initrd (loop)/arch/boot/x86_64/parabolaiso.img
}
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)/arch/boot/i686/vmlinuz parabolaisolabel=<FS-LABEL> img_label=<TARGET-FS-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.
# <img> <mnt> <arch> <sfs_comp> <fs_type> <fs_size>
@@ -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/<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.
** (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:
<DEV-TARGET>: 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 <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=arch/boot/syslinux/ -f <ISO-SOURCE> -C <MNT-TARGET-N>
5) Unmount target filesystem.
# umount <MNT-TARGET-N>