# mars_nwe test helpers

The test tree contains small smoke helpers for protocol areas that are easier to
exercise outside the normal install flow.

## AFP

`tests/afp` contains the current AFP endpoint smoke suite and AFP-specific
notes.  AFP deleted-file endpoint `0x13` is intentionally still unsupported
until the shared salvage backend exposes scan/recover/purge semantics.

## Salvage

`tests/salvage` contains the shared NetWare salvage coverage.  These tests are
kept outside `tests/afp` because AFP `0x13` must become a thin adapter over the
same backend that serves the NetWare NCP salvage calls.

The current salvage tests cover:

- local layout contract for `.recycle` payloads and `.salvage` JSON metadata,
- NCP create/delete capture through the normal server delete path,
- Samba-compatible history naming with `Copy #1 of NAME`,
- NCP `87/16` Scan Salvageable Files through the official `ncpfs` helper API,
- report-file generation with `--out FILE`.

`tests/salvage/salvage_smoke_suite.sh` is the single NCP integration entry
point.  It creates and deletes the same file twice, then appends the `87/16` scan check,
so one report covers delete capture, history/versioning, and scan visibility.

The NCP smoke suite is intended to run as the same Unix user that normally runs
the test client, not necessarily as root.  Pre-clean of old `.recycle` or
`.salvage` artifacts is therefore best-effort: permission failures are reported
as warnings and do not by themselves fail the smoke.  The actual pass/fail check
is based on artifacts created by the NCP delete path.