P4App 使用指南

1. 项目目录结构及介绍

P4App 是一个用于构建、运行、调试和测试P4程序的工具，其设计哲学强调简化小而简单的P4程序的编写与分享过程。此开源项目在 GitHub 上托管，仓库地址为 https://github.com/p4lang/p4app.git。以下为其典型目录结构及其介绍：

• my_program: 包含实际的P4程序文件。
• p4app: 目录中拥有项目的核心，包括：
  • p4app.json: 包装清单文件，相当于Makefile，定义了如何构建和运行P4程序。
  • 其他配置或辅助脚本文件。
• examples: 示例程序目录，展示如何组织P4程序及相应的配置。
• docker: 可能包含Docker相关配置，用于环境搭建。
• LICENSE: 许可证文件。
• README.md: 项目说明文件，重要的是项目使用方法的概览。
• _config.yml: 可能是网站或文档构建相关的配置。

2. 项目启动文件介绍

P4App的核心不直接有一个所谓的“启动文件”，而是通过命令行接口进行操作。然而，对于每个要执行的P4程序来说，关键的“启动”概念围绕着p4app.json配置文件以及对应的P4源码文件（如my_program.p4）。当你运行命令p4app run examples/simple_counter.p4app时，实际上是在激活由该指定路径下的p4app.json配置的程序执行流程。

3. 项目的配置文件介绍

配置文件主要指p4app.json

• 结构简介: 此文件作为P4App的构建指令中心，包含了至少以下几个关键字段：

  • "program": 指定主P4程序文件名。
  • "language": 定义所使用的P4语言版本，如"p4-14"。
  • "targets": 配置目标，可以设定不同的运行环境或测试场景，例如Mininet配置，包含主机数量等详情。

  {
    "program": "my_program.p4",
    "language": "p4-14",
    "targets": [
      {
        "mininet": {
          "num-hosts": 2,
          "switch-config": "my_program.config"
        }
      }
    ]
  }
  

• 功能解析: 通过这个文件，你可以告诉P4App如何编译你的P4代码，它应该模拟什么样的网络环境（如Mininet配置），以及如何进行测试等。

综上所述，P4App通过灵活的配置文件与命令行交互，简化了P4开发的复杂度，使得开发者能够快速地部署和测试他们的P4程序，无需深入底层细节。