From 8ae7c2495886fa33c0b7fa63c5329bbc7fb796c2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Marczykowski-G=C3=B3recki?= Date: Sun, 20 Oct 2024 00:41:01 +0200 Subject: [PATCH] Update docs about /rw/config/rc.local* scripts Specify that files needs to be executable. Add info about `/rw/config/rc.local.d/*.rc`. Add info about `/rw/config/rc.local-early.d/*.rc` and `/rw/config/rc.local-early` (https://github.com/QubesOS/qubes-core-agent-linux/pull/386) --- user/advanced-topics/config-files.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/user/advanced-topics/config-files.md b/user/advanced-topics/config-files.md index 3ffdfd553c..db8a7f0791 100644 --- a/user/advanced-topics/config-files.md +++ b/user/advanced-topics/config-files.md @@ -19,7 +19,7 @@ That way, they can be used to customize a single VM instead of all VMs based on The scripts here all run as root. - `/rw/config/rc.local` - script runs at VM startup. - Good place to change some service settings, replace config files with its copy stored in `/rw/config`, etc. + Good place to change some service settings, replace config files with its copy stored in `/rw/config`, etc. The script need to have the executable permission set to be executed. Example usage: ~~~ @@ -33,6 +33,8 @@ The scripts here all run as root. echo '127.0.0.1 example.com' >> /etc/hosts ~~~ +- `/rw/config/rc.local.d/*.rc` - scripts run at VM startup just before `/rw/config/rc.local` +- `/rw/config/rc.local-early.d/*.rc`, `/rw/config/rc.local-early` - scripts similar to `/rw/config/rc.local`, but running earlier in the system startup sequence - just before `sysinit.target`, and setting up the network. - `/rw/config/qubes-ip-change-hook` - script runs in NetVM after every external IP change and on "hardware" link status change. - In ProxyVMs (or app qubes with `qubes-firewall` service enabled), scripts placed in the following directories will be executed in the listed order followed by `qubes-firewall-user-script` at start up.