Import VX multicall utility and applets

2026-03-16 22:06:27 -05:00
parent 9a477cd852
commit 696cb27313
201 changed files with 35660 additions and 0 deletions
@@ -0,0 +1,41 @@
+# VX
+
+VX is a BSD-oriented multicall utility for Linux.
+
+It bundles a growing set of FreeBSD-derived userland tools into a single `vx` binary, with applets selected by `argv[0]` or by subcommand.
+
+## Included applets
+
+- `patch`
+- `diff`, `cmp`, `diff3`, `sdiff`
+- `which`
+- `gzip`, `gunzip`, `zcat`, `gzcat`, `uncompress`
+- `grep`, `egrep`, `fgrep`, `rgrep`
+- `find`
+- `xargs`
+
+## Build
+
+VX uses Meson.
+
+```text
+meson setup builddir
+meson compile -C builddir
+meson test -C builddir
+```
+
+## Run
+
+You can invoke applets either through the multicall binary:
+
+```text
+./builddir/vx grep pattern file
+./builddir/vx find . -name '*.c'
+```
+
+or via installed symlinks such as `grep`, `find`, or `patch`.
+
+## Notes
+
+- The project force-includes `src/compat-headers/compat.h` to provide Linux compatibility shims for BSD userland code.
+- Some behavior is intentionally BSD-flavored, even where GNU tools differ.