diff options
| author | Yevhen Bondarenko <evgeniy.bondarenko@sentrium.io> | 2026-05-08 20:26:22 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2026-05-08 20:26:22 +0200 |
| commit | 05e156f50e8ad1f7b3aedfc2dda9aec8fde3c2db (patch) | |
| tree | cd1273ed7cd95ac9c8bc298b4a7620c16b232063 | |
| parent | 54d043f9a3a49e2ee93eab2c623df34465571da5 (diff) | |
| parent | 63d431010670b640a84f7b51141a4e6a4d168f47 (diff) | |
| download | vyatta-biosdevname-05e156f50e8ad1f7b3aedfc2dda9aec8fde3c2db.tar.gz vyatta-biosdevname-05e156f50e8ad1f7b3aedfc2dda9aec8fde3c2db.zip | |
Merge pull request #10 from vyos/T8595-add-agents-md
general: T8595: add AGENTS.md
| l--------- | .github/copilot-instructions.md | 1 | ||||
| -rw-r--r-- | AGENTS.md | 46 |
2 files changed, 47 insertions, 0 deletions
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md new file mode 120000 index 0000000..be77ac8 --- /dev/null +++ b/.github/copilot-instructions.md @@ -0,0 +1 @@ +../AGENTS.md
\ No newline at end of file diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..799d902 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,46 @@ +# AGENTS.md + +## Project purpose + +VyOS fork of `biosdevname` — a Dell-originated utility that maps Linux kernel network-device names (e.g. `eth0`) to BIOS/chassis-supplied names (e.g. `Gb1`). Ships as the `vyatta-biosdevname` Debian package and is invoked by udev rules during interface naming. + +## Tech stack + +- C, GNU autotools (`configure.ac`, `Makefile.am`, `ltmain.sh`). +- Debian packaging in `debian/` (debhelper >= 5, `autotools-dev`, `libpci-dev`, `autoconf`, `automake`). +- License: GPL-2.0 (per `COPYING`). + +## Build / test / run + +```sh +autoreconf -fi +./configure +make +dpkg-buildpackage -us -uc +``` + +No in-tree test runner. + +## Repository layout + +- `src/` — main biosdevname source. +- `biosdevname.1` — man page. +- `biosdevname.rules.in` — udev rules template. +- `biosdevname.spec.fedora.in`, `biosdevname.spec.suse.in` — RPM specs (upstream). +- `debian/`. + +## Cross-repo context + +Listed in an internal repository. Pulled into the ISO via `vyos/vyos-build`. Provides predictable interface naming used throughout `vyos-1x`'s ifconfig logic. + +## Conventions + +- Default branch `current`. +- Commit / PR title format: `component: T12345: description` (Phorge task ID at https://vyos.dev). +- Active workflows: `cla-check.yml`, `trigger-rebuild-repo-package.yml` — wired into the rebuild-dispatch chain, but **not** the PR-mirror pipeline. +- Treat as upstream-vendored; minimise diffs against the original Dell biosdevname. + +## Notes for future contributors + +- Renaming the source/binary package from upstream `biosdevname` to `vyatta-biosdevname` is intentional — don't revert. +- Any change here can affect interface naming on every VyOS install; coordinate with `vyos-1x` if you change rule names. |