Merge branch 'uutils:main' into lsns-basic-functionality

Author: vbmade2000

.github/workflows/run-gnu-test.yml

@@ -0,0 +1,68 @@
+
+name: Run GNU Test
+
+on:
+  pull_request:
+  push:
+    branches:
+      - 'main'
+
+jobs:
+  native:
+    name: Run GNU tests (native)
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout code (uutils/util-linux)
+        uses: actions/checkout@v6
+        with:
+          path: uutils-util-linux
+      - name: Checkout code (util-linux/util-linux)
+        uses: actions/checkout@v6
+        with:
+          repository: util-linux/util-linux
+          path: gnu-util-linux
+          ref: v2.41.4
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: "./uutils-util-linux -> target"
+      - name: Install dependencies
+        run: |
+          sudo apt-get update --quiet
+          # omit preinstalled tools <https://github.com/actions/runner-images/tree/main/images/ubuntu>
+          sudo apt-get install -y \
+            autopoint gettext bc socat ntp squashfs-tools \
+            libcap-ng-dev libpam-dev libudev-dev python3-dev libmount-dev libclang-dev libsmartcols-dev
+      - name: Build GNU tests
+        run: |
+          cd gnu-util-linux
+          ./autogen.sh
+          ./configure
+          make libsmartcols/src/filter-parser.c libsmartcols/src/filter-scanner.c
+          make -j$(nproc) check-programs
+      - name: Download test baseline if exists
+        id: download-test-baseline
+        continue-on-error: true
+        uses: actions/download-artifact@v8
+        with:
+          name: gnu-test-failures
+          path: uutils-util-linux/.reference/
+
+      - name: Run GNU tests
+        env:
+          GNU_PROJECT_DIR: ${{ github.workspace }}/gnu-util-linux
+        run: |
+          cd uutils-util-linux
+          ./scripts/run-tests.sh
+
+      - name: Update test baseline
+        if: github.ref == 'refs/heads/main'
+        run: |
+          cd uutils-util-linux
+          ./scripts/check-new-gnu-failures.sh --update-baseline
+
+      - name: Upload test baseline artifact
+        if: github.ref == 'refs/heads/main' || steps.download-test-baseline.outcome == 'failure'
+        uses: actions/upload-artifact@v7
+        with:
+          name: gnu-test-failures
+          path: uutils-util-linux/.reference/gnu-test-failures.txt

.gitignore

@@ -1,3 +1,6 @@
 syntax: glob
 
 /target/
+
+.test-helpers
+.reference

CONTRIBUTING.md

@@ -0,0 +1,32 @@
+# Contributing to util-linux
+
+Hi! Welcome to uutils/util-linux, and thanks for wanting to contribute!
+
+This project follows the shared conventions of the [uutils](https://github.com/uutils)
+organization. Before opening a pull request, please read:
+
+- Our **[Review Guidelines](https://uutils.github.io/reviews/)** — what we expect
+  from a pull request and how reviews are carried out.
+- Our community's [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md), if present.
+
+Finally, feel free to join our [Discord](https://discord.gg/wQVJbvJ)!
+
+> [!WARNING]
+> uutils is original code and cannot contain any code from GNU or other
+> strongly-licensed (GPL/LGPL) implementations. We **cannot** accept changes
+> based on the GNU source code, and you **must not link** to it either. You may
+> look at permissively-licensed implementations (MIT/BSD) and read the GNU
+> *manuals* — never the GNU *source*.
+
+## In short
+
+- Discuss non-trivial changes in an issue **before** writing the code.
+- Keep pull requests **small, self-contained, and descriptively titled**
+  (e.g. `util-linux: fix ...`).
+- Make sure CI passes: tests are green, `rustfmt` is satisfied, and there are
+  no `clippy` warnings.
+- Add tests for new behavior; don't let coverage regress.
+- Write small, atomic commits annotated with the component you touched.
+
+See the [Review Guidelines](https://uutils.github.io/reviews/) for the full
+details.