summaryrefslogtreecommitdiff
path: root/README.profile.rst
diff options
context:
space:
mode:
authorDavid P <megver83@parabola.nu>2020-12-02 16:33:08 -0300
committerDavid P <megver83@parabola.nu>2020-12-02 16:33:08 -0300
commitce23b5ac79cc6ff418eabe5303c8029e381b0a1c (patch)
tree57522d7be01f266dae658cf4b3ccdd15b0a2977a /README.profile.rst
parent39f2387cbc51e6ba634984931ea2de160c3c350a (diff)
sync with archisov50
Imported from archiso v50.1 8ba2870 (HEAD -> master, tag: v50.1, origin/master, origin/HEAD) configs/releng/syslinux/archiso_pxe-linux.cfg: add missing /boot to initrd file path Imported from archiso 50 c10004d (tag: v50) Fix issues with file ownerships/modes 863247d Keep all SYSLINUX files in /syslinux 183ae52 Prevent path traversal outside of $airootfs_dir 42d9e4f Allow specifying ownership and mode of custom airootfs files and directories 2c99df5 Reset network interfaces at the end of the PXE boot to allow DHCP to run Signed-off-by: David P <megver83@parabola.nu>
Diffstat (limited to 'README.profile.rst')
-rw-r--r--README.profile.rst21
1 files changed, 8 insertions, 13 deletions
diff --git a/README.profile.rst b/README.profile.rst
index a34d557..7eb2c81 100644
--- a/README.profile.rst
+++ b/README.profile.rst
@@ -9,7 +9,6 @@ A parabolaiso profile consists of several configuration files and a directory fo
profile
|- airootfs/
|- efiboot/
- |- isolinux/
|- syslinux/
|- packages.arch
|- pacman.conf
@@ -54,6 +53,9 @@ The image file is constructed from some of the variables in **profiledef.sh**: `
- `ext4+squashfs`: Create an ext4 partition, copy the airootfs work directory to it and create a squashfs image from it
* `airootfs_image_tool_options`: An array of options to pass to the tool to create the airootfs image. Currently only
`mksquashfs` is supported - see `mksquashfs --help` for all possible options (defaults to `('-comp' 'xz')`).
+ - `file_permissions`: An associative array that lists files and/or directories who need specific ownership or
+ permissions. The array's keys contain the path and the value is a colon separated list of owner UID, owner GID and
+ access mode. E.g. `file_permissions=(["/etc/shadow"]="0:0:400")`.
packages.arch
=============
@@ -94,8 +96,9 @@ airootfs
This - optional - directory may contain files and directories that will be copied to the work directory of the resulting
image's root filesystem.
The files are copied before packages are being installed to work directory location.
-Ownership of files and directories from the profile's `airootfs` directory are not preserved (permissions are currently
-the same as in the profile's `airootfs` - see `#61 <https://gitlab.archlinux.org/archlinux/archiso/-/issues/73>`_).
+Ownership and permissions of files and directories from the profile's `airootfs` directory are not preserved. The mode
+will be `644` for files and `755` for directories, all of them will be owned by root. To set custom ownership and/or
+permissions, use `file_permissions` in **profiledef.sh**.
With this overlay structure it is possible to e.g. create users and set passwords for them, by providing
`airootfs/etc/passwd`, `airootfs/etc/shadow`, `airootfs/etc/gshadow` (see `man 5 passwd`, `man 5 shadow` and `man 5
@@ -134,21 +137,13 @@ The *custom template identifiers* are **only** understood in the boot loader ent
The same happens when the `uefi-x64.refind.esp` or `uefi-x64.refind.eltorito` bootmodes are selected.
-isolinux
---------
-
-This directory is mandatory when the `bios.syslinux.eltorito` bootmode is selected in **profiledef.sh**.
-It contains configuration for `isolinux <https://wiki.syslinux.org/wiki/index.php?title=ISOLINUX>`_ used in the resuling
-image.
-
-The *custom template identifiers* are understood in all `.cfg` files in this directory.
-
syslinux
--------
This directory is mandatory when the `bios.syslinux.mbr` or the `bios.syslinux.eltorito` bootmodes are selected in
**profiledef.sh**.
-It contains configuration files for `syslinux <https://wiki.syslinux.org/wiki/index.php?title=SYSLINUX>`_ or `pxelinux
+It contains configuration files for `syslinux <https://wiki.syslinux.org/wiki/index.php?title=SYSLINUX>`_ or `isolinux
+<https://wiki.syslinux.org/wiki/index.php?title=ISOLINUX>`_ , or `pxelinux
<https://wiki.syslinux.org/wiki/index.php?title=PXELINUX>`_ used in the resuling image.
The *custom template identifiers* are understood in all `.cfg` files in this directory.