tests: add Novell DOS tool baseline suite
Add DOS-side baseline scripts for the Novell tools used to compare the reimplemented public utilities. The suite covers the current baseline set: MAP SLIST WHOAMI LOGIN / LOGOUT NDIR NCOPY FLAG FLAGDIR CREATOR RIGHTS GRANT REVOKE REMOVE It also includes supporting trustee, rights, rename, move, delete and file-operation tests. Each test writes reproducible output into a per-tool CMP directory and provides a matching ZIP helper for collecting the results. The ZIP helpers clean generated test trees afterwards so SYS: does not keep accumulating temporary directories. This is the Novell baseline layer only. A later change can extend the same scripts to run the full comparison cycle: NPUBLIC baseline -> PUBLIC implementation -> NPUBLIC control
This commit is contained in:
172
test/filer/README.md
Normal file
172
test/filer/README.md
Normal file
@@ -0,0 +1,172 @@
|
||||
# FILER tests
|
||||
|
||||
Manual Novell FILER baseline with pre/post output comparison.
|
||||
|
||||
## Files
|
||||
|
||||
| File | Purpose |
|
||||
| --- | --- |
|
||||
| `FILPREN.BAT` | Pre-FILER setup and baseline output capture. |
|
||||
| `FILPOSTN.BAT` | Post-FILER output capture, compare, and cleanup. |
|
||||
| `FILCMPN.BAT` | Repeat PRE/POST comparisons only. |
|
||||
| `FILTSTM.TST` | MARS/dosutils regression notes/spec for the scenario. |
|
||||
|
||||
## Test flow
|
||||
|
||||
```text
|
||||
FILPREN.BAT
|
||||
NPUBLIC\FILER
|
||||
FILPOSTN.BAT
|
||||
```
|
||||
|
||||
Optional repeat compare:
|
||||
|
||||
```text
|
||||
FILCMPN.BAT
|
||||
```
|
||||
|
||||
## Output comparison
|
||||
|
||||
`FILPREN.BAT` writes baseline files to:
|
||||
|
||||
```text
|
||||
F:\TFILE\PRE\*.OUT
|
||||
```
|
||||
|
||||
`FILPOSTN.BAT` writes post-FILER files to:
|
||||
|
||||
```text
|
||||
F:\TFILE\POST\*.OUT
|
||||
```
|
||||
|
||||
Then `FC` compares:
|
||||
|
||||
```text
|
||||
FLAGA.OUT
|
||||
FLAGB.OUT
|
||||
FLAGK.OUT
|
||||
NDIR.OUT
|
||||
DATES.OUT
|
||||
RIGHTS.OUT
|
||||
TRUST.OUT
|
||||
TRUSTA.OUT
|
||||
```
|
||||
|
||||
No differences are expected if FILER was only used for inspection.
|
||||
Intentional differences are expected if attributes or metadata were changed in FILER.
|
||||
|
||||
|
||||
|
||||
## Manual changes to perform in FILER
|
||||
|
||||
The FILER screen starts at `MARS\SYS:NPUBLIC`. Use the menu to navigate and make a small, controlled change set.
|
||||
|
||||
### 1. Go to the test directory
|
||||
|
||||
Use:
|
||||
|
||||
```text
|
||||
Select Current Directory
|
||||
```
|
||||
|
||||
Change to:
|
||||
|
||||
```text
|
||||
F:\TFILE
|
||||
```
|
||||
|
||||
or the equivalent NetWare path:
|
||||
|
||||
```text
|
||||
MARS\SYS:TFILE
|
||||
```
|
||||
|
||||
Then use:
|
||||
|
||||
```text
|
||||
Directory Contents
|
||||
```
|
||||
|
||||
You should see:
|
||||
|
||||
```text
|
||||
A.TXT
|
||||
B.TXT
|
||||
KEEP.TXT
|
||||
SUBDIR
|
||||
```
|
||||
|
||||
### 2. Inspect file and directory information
|
||||
|
||||
Open/inspect the information screen for:
|
||||
|
||||
```text
|
||||
A.TXT
|
||||
B.TXT
|
||||
KEEP.TXT
|
||||
SUBDIR
|
||||
SUBDIR\C.TXT
|
||||
```
|
||||
|
||||
Just opening these screens should exercise the server info-readback paths without changing anything.
|
||||
|
||||
### 3. Make one or more intentional attribute changes
|
||||
|
||||
Use FILER to change only a few obvious attributes, so the `PRE` versus `POST` compare is easy to understand.
|
||||
|
||||
Suggested changes:
|
||||
|
||||
```text
|
||||
A.TXT Hidden: toggle
|
||||
B.TXT Read Only: toggle
|
||||
KEEP.TXT Archive Needed: toggle
|
||||
```
|
||||
|
||||
If FILER allows editing directory attributes, also inspect `SUBDIR`, but keep directory changes minimal.
|
||||
|
||||
### 4. Optional no-change pass
|
||||
|
||||
For a pure readback test, do not change anything in FILER. Then `FILPOSTN.BAT` should show no `FC` differences except harmless output/date formatting differences.
|
||||
|
||||
### 5. Expected compare results
|
||||
|
||||
After leaving FILER, run:
|
||||
|
||||
```text
|
||||
FILPOSTN.BAT
|
||||
```
|
||||
|
||||
Expected results:
|
||||
|
||||
```text
|
||||
No FILER changes:
|
||||
FC should report no differences for the PRE/POST files.
|
||||
|
||||
Changed A.TXT Hidden:
|
||||
FLAGA.OUT, NDIR.OUT, DATES.OUT may differ.
|
||||
|
||||
Changed B.TXT Read Only:
|
||||
FLAGB.OUT, NDIR.OUT, DATES.OUT may differ.
|
||||
|
||||
Changed KEEP.TXT Archive Needed:
|
||||
FLAGK.OUT, NDIR.OUT, DATES.OUT may differ.
|
||||
|
||||
Changed rights/trustees:
|
||||
RIGHTS.OUT and/or TRUST*.OUT may differ.
|
||||
```
|
||||
|
||||
The important part is that the differences match the intentional FILER changes and the server log shows no unexpected completion codes.
|
||||
|
||||
## Server log focus
|
||||
|
||||
Look for:
|
||||
|
||||
```text
|
||||
NCP22/25
|
||||
Set Directory/File Information
|
||||
change bits
|
||||
nwp_stat
|
||||
nw_optain_file_dir_info
|
||||
nw_search_file_dir
|
||||
build_d_i
|
||||
```
|
||||
Reference in New Issue
Block a user