summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorEvgeny Zinoviev <me@ch1p.io>2020-12-01 02:28:59 +0300
committerEvgeny Zinoviev <me@ch1p.io>2020-12-01 02:28:59 +0300
commit743c8945fe381610dc3be84339719d966152a1e6 (patch)
tree5e101d7973a215d652cb8b9c7a4f4cdcd0e86333 /README.md
parent72fa0b987a87dc9d14ace50f5a9e0d7b88bba5f2 (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.md31
1 files changed, 24 insertions, 7 deletions
diff --git a/README.md b/README.md
index 883f8f3..5e41ce3 100644
--- a/README.md
+++ b/README.md
@@ -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