tests: document AFP file information smoke coverage

Document the Linux smoke-test coverage for the newly implemented AFP Get File Information endpoint.\n\nThe WebSDK-documented NCP 0x2222/35/05 path now has a Linux libncp smoke test alongside the existing AFP Entry ID probe. Record the verified SYS:, SYS:PUBLIC, SYS:SYSTEM, and SYS:BURST cases and describe the read-only reply fields currently populated from Unix stat data and the optional libatalk helper wrappers.\n\nAlso update the AFP Entry ID smoke-test documentation to match the current default raw-path mode, where SYS:-style paths are sent with directory handle 0 and handle allocation is kept behind --alloc-handle for separate debugging.\n\nKeep the remaining AFP/Mac namespace work in TODO.md, including persistent CNID/AppleDouble entry IDs, Parent ID mapping, Finder Info/resource-fork semantics, AFP 2.0 file information, and Scan File Information coverage.\n\nThis is documentation-only and does not change AFP protocol behavior.

tests/linux/README.md

@@ -12,6 +12,7 @@ Build with:
 ```sh
 cmake -DMARS_NWE_BUILD_LINUX_TESTS=ON ...
 cmake --build . --target afp_entry_id_smoke
+cmake --build . --target afp_file_info_smoke
 ```
 
 ## AFP Entry ID smoke test
@@ -31,10 +32,11 @@ Example:
 ./tests/linux/afp_entry_id_smoke -S MARS -U SUPERVISOR -P secret SYS:PUBLIC
 ```
 
-The test accepts NetWare-style `VOL:PATH` arguments.  It logs in through
-libncp, allocates a temporary directory handle for the volume root, and sends
-only the relative path to `AFP Get Entry ID From Path Name`, matching the
-WebSDK request layout of `DirectoryHandle + Path String`.
+The test accepts NetWare-style `VOL:PATH` arguments.  By default it sends the
+supplied `SYS:`-style path directly with directory handle 0, matching the
+verified mars_nwe smoke-test path.  `--alloc-handle` is available only for
+follow-up debugging of the separate directory-handle allocation path, and
+`--dir-handle N` expects a handle that is valid in the current connection.
 
 Useful smoke cases for a standard MARS-NWE `SYS` volume are:
 
@@ -45,11 +47,11 @@ Useful smoke cases for a standard MARS-NWE `SYS` volume are:
 ./tests/linux/afp_entry_id_smoke -S MARS -U SUPERVISOR -P secret SYS:BURST
 ```
 
-A successful reply prints the temporary directory handle, the relative request
-path, and the returned 32-bit AFP Entry ID.  Server-side diagnostics currently
-mark stat-derived temporary IDs with `fallback`; that means the endpoint is
-reachable, but persistent CNID/AppleDouble entry-id storage is still future
-Mac-namespace work.
+A successful reply prints the request path, directory handle, and returned
+32-bit AFP Entry ID.  Server-side diagnostics currently mark stat-derived
+temporary IDs with `fallback`; that means the endpoint is reachable, but
+persistent CNID/AppleDouble entry-id storage is still future Mac-namespace
+work.
 
 If the server was built without the optional Netatalk/libatalk backend, the
 endpoint is expected to return invalid namespace.  To treat that as a successful
@@ -61,3 +63,36 @@ negative smoke test, use:
 
 For path-resolution negative tests, use `--allow-invalid-path` to accept the
 expected `0x9c` Invalid Path completion.
+
+## AFP File Information smoke test
+
+`afp_file_info_smoke` sends the WebSDK-documented NetWare AFP request:
+
+```text
+NCP 0x2222/35/05  AFP Get File Information
+```
+
+It uses the same libncp `NWRequestSimple()` transport path as the Entry ID
+smoke test and sends raw `SYS:`-style path requests with directory handle 0.
+The server replies with the read-only AFP file information record currently
+implemented by mars_nwe: Entry ID, Parent ID, attributes, data/resource fork
+lengths, offspring count, fixed long/short names, and access rights.
+
+Useful smoke cases for a standard MARS-NWE `SYS` volume are:
+
+```sh
+./tests/linux/afp_file_info_smoke -S MARS -U SUPERVISOR -P secret SYS:
+./tests/linux/afp_file_info_smoke -S MARS -U SUPERVISOR -P secret SYS:PUBLIC
+./tests/linux/afp_file_info_smoke -S MARS -U SUPERVISOR -P secret SYS:SYSTEM
+./tests/linux/afp_file_info_smoke -S MARS -U SUPERVISOR -P secret SYS:BURST
+```
+
+The current implementation fills fields that can be derived from Unix `stat(2)`
+and the optional libatalk helper wrappers.  Server-side diagnostics mark
+stat-derived temporary Entry IDs with `fallback`; Parent ID, persistent
+CNID/AppleDouble IDs, and fuller Finder Info/resource-fork semantics remain
+future Mac-namespace work.
+
+If the server was built without the optional Netatalk/libatalk backend, use
+`--allow-invalid-namespace` for the expected negative test.  Use
+`--allow-invalid-path` for path-resolution negative tests.