# Phase 1 验证方案（用户执行）

> 背景：本轮已完成 phase1 代码改造，但当前代理环境无法在 root + SPDK 运行条件下完成端到端验证。下面步骤请你在本机执行。

## 0) 目标

验证 3 件事：
1. `zvfs_io_req` 解耦后，`read/write` 旧路径行为不回退。
2. 新增 `zvfs_pread/zvfs_pwrite` API 能正确处理 offset I/O。
3. 构建产物 `libzvfs.so` 可正常编译链接。

---

## 1) 构建验证

```bash
cd /home/lian/share/10.1-spdk/zvfs
make -C zvfs -j
```

期望：
- 编译成功，无报错。
- 生成 `/home/lian/share/10.1-spdk/zvfs/zvfs/libzvfs.so`。

---

## 2) Phase1 新 API 验证（不依赖 LD_PRELOAD hook）

### 2.1 生成临时测试程序

```bash
cat >/tmp/phase1_api_check.c <<'EOF'
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "zvfs.h"

static int expect_eq(const char *name, const void *got, const void *exp, size_t n) {
    if (memcmp(got, exp, n) != 0) {
        fprintf(stderr, "[FAIL] %s mismatch\n", name);
        return -1;
    }
    printf("[OK] %s\n", name);
    return 0;
}

int main(void) {
    int rc = 1;
    int mounted = 0;
    int created = 0;
    if (zvfs_env_setup() != 0) {
        fprintf(stderr, "zvfs_env_setup failed\n");
        return rc;
    }

    zvfs_t *fs = calloc(1, sizeof(*fs));
    zvfs_file_t *file = calloc(1, sizeof(*file));
    zvfs_dirent_t *dirent = calloc(1, sizeof(*dirent));
    if (!fs || !file || !dirent) {
        rc = 2;
        goto out;
    }

    if (!zvfs_mount(fs)) {
        fprintf(stderr, "zvfs_mount failed\n");
        rc = 3;
        goto out;
    }
    mounted = 1;

    file->fs = fs;
    file->dirent = dirent;
    if (!zvfs_create(file)) {
        fprintf(stderr, "zvfs_create failed\n");
        rc = 4;
        goto out;
    }
    created = 1;

    /* 验证 pwrite + pread 的 offset 语义 */
    const char *a = "AAAA";
    const char *b = "BBBB";
    if (zvfs_pwrite(file, (const uint8_t *)a, 4, 0) != 4) { rc = 5; goto out; }
    if (zvfs_pwrite(file, (const uint8_t *)b, 4, 8) != 4) { rc = 6; goto out; }

    uint8_t got[12] = {0};
    uint8_t exp[12] = {'A','A','A','A',0,0,0,0,'B','B','B','B'};
    if (zvfs_pread(file, got, sizeof(got), 0) != 12) { rc = 7; goto out; }
    if (expect_eq("pread/pwrite-hole", got, exp, sizeof(exp)) != 0) { rc = 8; goto out; }

    /* 验证旧 read/write 顺序语义未回退 */
    file->current_offset = 0;
    const char *c = "CCCC";
    if (zvfs_write(file, (const uint8_t *)c, 4) != 4) { rc = 9; goto out; }
    file->current_offset = 0;
    uint8_t got2[4] = {0};
    if (zvfs_read(file, got2, sizeof(got2)) != 4) { rc = 10; goto out; }
    if (expect_eq("read/write-seq", got2, c, 4) != 0) { rc = 11; goto out; }

    rc = 0;
    printf("[PASS] phase1_api_check\n");

out:
    if (created) {
        (void)zvfs_close(file);
        (void)zvfs_delete(file);
    }
    if (mounted) {
        (void)zvfs_umount(fs);
    }

    free(dirent);
    free(file);
    free(fs);
    return rc;
}
EOF
```

### 2.2 编译并运行

```bash
gcc -O2 -Wall -Wextra -std=gnu11 \
  -I/home/lian/share/10.1-spdk/zvfs/zvfs \
  -I/home/lian/share/10.1-spdk/zvfs/spdk/include \
  -o /tmp/phase1_api_check /tmp/phase1_api_check.c \
  /home/lian/share/10.1-spdk/zvfs/zvfs/libzvfs.so -ldl

sudo /tmp/phase1_api_check
```

期望：
- 输出包含：
  - `[OK] pread/pwrite-hole`
  - `[OK] read/write-seq`
  - `[PASS] phase1_api_check`

---

## 3) 旧 POSIX 路径回归（LD_PRELOAD）

```bash
cd /home/lian/share/10.1-spdk/zvfs
make -C test -j

sudo env LD_PRELOAD=/home/lian/share/10.1-spdk/zvfs/zvfs/libzvfs.so ./test/bin/test_basic /zvfs
sudo env LD_PRELOAD=/home/lian/share/10.1-spdk/zvfs/zvfs/libzvfs.so ./test/bin/test_lseek /zvfs
sudo env LD_PRELOAD=/home/lian/share/10.1-spdk/zvfs/zvfs/libzvfs.so ./test/bin/test_two_files /zvfs
```

期望：
- `test_basic`、`test_lseek`、`test_two_files` 通过。
- 无崩溃、无明显数据错乱。

若出现一次性 `zvfs_mount failed`，建议先确保没有残留测试进程，再重跑一次验证命令。

---

## 4) 验证完成后回填

请把验证结果回填到 `plan/plan.md` 的 phase1 区域：
- `### 阶段验收`
- `### 正确性验证方案`

若任何一项失败，请附上：
1. 命令；
2. 错误输出；
3. 是否可稳定复现。