diff options
author | Evgeny Zinoviev <me@ch1p.io> | 2020-12-01 02:28:59 +0300 |
---|---|---|
committer | Evgeny Zinoviev <me@ch1p.io> | 2020-12-01 02:28:59 +0300 |
commit | 743c8945fe381610dc3be84339719d966152a1e6 (patch) | |
tree | 5e101d7973a215d652cb8b9c7a4f4cdcd0e86333 /README.md | |
parent | 72fa0b987a87dc9d14ace50f5a9e0d7b88bba5f2 (diff) |
version 1.1
- bind whole /etc and /var when installing, removing or reconfiguring packages
- update readme
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 31 |
1 files changed, 24 insertions, 7 deletions
@@ -1,6 +1,6 @@ # voidnsrun -`voidnsrun` is utility for launching programs in an isolated namespace with +**voidnsrun** is utility for launching programs in an isolated namespace with alternative `/usr` tree. Its primary goal is to run glibc programs in musl-libc Void Linux environments or vice-versa. @@ -33,7 +33,7 @@ Options: -v: print version ``` -`voidnsrun` needs to know the path to your alternative root directory and it can +**voidnsrun** needs to know the path to your alternative root directory and it can read it from the `VOIDNSRUN_DIR` environment variable or you can use `-r` argument to specify it. @@ -43,13 +43,19 @@ You may want to add something like this to your `~/.bashrc` or similar script: export VOIDNSRUN_DIR=/glibc ``` -By default, `voidnsrun` binds these paths from alternative root to the new +By default, **voidnsrun** binds these paths from alternative root to the new namespace: - `/usr` - `/var/db/xbps` - `/etc/xbps.d` -If you want to mount something else, use `-m` argument. +But if you're launching `xbps-install`, `xbps-remove` or `xbps-reconfigure` +and using **voidnsrun** version 1.1 or newer, this is what it will bind: +- `/usr` +- `/var` +- `/etc` + +If you want to bind something else, use the `-m` argument. ## Example @@ -64,7 +70,7 @@ separate new directory: # XBPS_ARCH=x86_64 xbps-install --repository=http://alpha.de.repo.voidlinux.org/current -r /glibc -S base-voidstrap ``` -Export path to this installation for `voidnsrun`: +Export path to this installation for **voidnsrun**: ``` export VOIDNSRUN_DIR=/glibc ``` @@ -93,9 +99,9 @@ glib-devel-2.66.2_1 /usr/share/gdb/auto-load/usr/lib/libgobject-2.0.so.0.6600.2- libglib-devel-2.66.2_1 /usr/lib/libgobject-2.0.so -> /usr/lib/libgobject-2.0.so.0 ``` -Sync repos and install `glib`. You can use `voidnsrun` for this purpose too. +Sync repos and install `glib`. You can use **voidnsrun** for this purpose too. Also, I think you should bind `/etc` and `/var` while using `xbps-install` via -`voidnsrun`, to not mess with your main system files. +**voidnsrun**, to not mess with your main system files. ``` $ sudo voidnsrun -r /glibc -m /etc -m /var xbps-install -Su $ sudo voidnsrun -r /glibc -m /etc -m /var xbps-install glib @@ -113,6 +119,17 @@ end, it will work. (If it's not, then something's still missing. In particular, make sure to install fonts related packages: `xorg-fonts`, `freetype`, `fontconfig`, `libXft`.) +## Changelog + +##### 1.1 + +- Bind whole `/etc` and `/var` when launching `xbps-install`, `xbps-remove` or + `xbps-reconfigure`. + +##### 1.0 + +Initial release. + ## License BSD-2c |