github.com/google/syzkaller@v0.0.0-20251211124644-a066d2bc4b02/docs/translations/zh_CN/contributing.md (about)

     1  > [!WARNING]
     2  >
     3  > **请注意，这是社区驱动的官方 syzkaller 文档翻译。当前文档的最新版本（英文版）可在 [docs/contributing.md](/docs/contributing.md) 中找到。**
     4  
     5  # 如何为 syzkaller 项目做贡献
     6  
     7  如果你想为本项目做出贡献，请按照下面的[指南](contributing.md#guidelines)提交拉取请求。
     8  
     9  如果这是你第一次向 syzkaller 提交拉取请求，你需要[签署 Google CLA](https://cla.developers.google.com/)，
    10  并在第一次提交时将自己添加到 [AUTHORS](/AUTHORS)/[CONTRIBUTORS](/CONTRIBUTORS) 文件中。
    11  
    12  ## 工作内容
    13  
    14  扩展/改进 [系统调用描述](/docs/syscall_descriptions.md) 一直是个好主意。
    15  
    16  [错误跟踪器](https://github.com/google/syzkaller/issues) 中未分配的议题是值得去做的，但其中有些议题可能比较复杂。
    17  
    18  要贡献代码或系统调用描述，你至少需要能够构建并运行 syzkaller，请参阅[此处](/docs/setup.md)的说明。
    19  
    20  ## 指南
    21  
    22  如果您想做一些并不微小的事情，请先在 [syzkaller@googlegroups.com](https://groups.google.com/forum/#!forum/syzkaller) 邮件列表上简要描述，以便在高层面的方法/设计上达成一致，且避免贡献者之间的重复工作。
    23  
    24  将大改动拆分成逻辑上连贯的小提交。小的提交更容易、更快地进行审核和迭代。
    25  
    26  所有可以合理测试的内容都应进行测试。
    27  
    28  为了其他用户能方便地使用新特性，请提供足够的文档说明。
    29  
    30  保持代码、测试、注释、文档、日志/错误信息的风格与现有风格一致。
    31  
    32  持续集成（CI）系统会运行大量测试和一些 [意见] 式检查。它们需要通过。你可以使用 `make presubmit` 进行本地测试，如果没有安装某些先决条件，你可以尝试使用 `syz-env` （见下文）。
    33  
    34  ### 提交
    35  
    36  提交信息应遵循以下模板：
    37  
    38  ```
    39  dir/path: 单行描述
    40  <空行>
    41  扩展的多行描述，包括
    42  您要解决的问题以及如何解决问题。
    43  ```
    44  
    45  `dir/path` 是本次提交更改的主目录的相对路径（参见 [提交历史](https://github.com/google/syzkaller/commits/master) 中的示例）。如果多个软件包/目录发生重大改动，则允许使用以下格式：
    46  ```
    47  dir1/path1, dir2/path2: 单行描述
    48  ```
    49  不过，如果目录仅有细微改动，则不应包括在内。
    50  对于普遍的更改，可以使用以下格式：
    51  ```
    52  all: 单行描述
    53  ```
    54  
    55  请注意标点符号，特别是：
    56  
    57  - `单行描述` *不*应该以大写字母开头。
    58  - `单行描述` 末尾*没有点*。
    59  - `扩展的多行描述` 是带有大写字母和圆点的全英文句子。
    60  
    61  提交信息行长度限制为 120 个字符。
    62  
    63  还有:
    64  
    65  - 如果您的提交修复了一个议题，请在提交信息中加入 `Fixes #NNN` 行（其中 `NNN` 是议题编号）。这将自动关闭议题。如果您需要提及议题，请添加 `Update #NNN`。
    66  - 对于系统调用描述，`*.const` 文件应该与 `*.txt` 的更改在同一提交中被合入。
    67  
    68  ### 拉取请求
    69  
    70  - 在发送拉取请求前，将你的工作分支变基到主分支以避免合并冲突。
    71  - 运行 `make presubmit` 并确保通过后再发送 PR。
    72    该操作可能需要安装一些额外的软件包（请尝试 `sudo make install_prerequisites`）。
    73  - 在拉取请求标题中提供简短的高级描述。
    74    拉取请求文本大多无关紧要，所有细节都应在提交信息中说明。
    75  - 如果您被要求在拉取请求中添加一些修正，请将修正压入旧提交中。
    76  
    77  ### 如何在 Github 上创建一个拉取请求
    78  
    79  - 首先，您需要一个自己的 syzkaller 仓库的复刻 git 仓库。导航到 [github.com/google/syzkaller](https://github.com/google/syzkaller)，然后点击页面右上角的 "Fork" 按钮。这将创建 `https://github.com/YOUR_GITHUB_USERNAME/syzkaller` 仓库。
    80  
    81  - 请切换到 syzkaller 主版本库，如果尚未进行这一步。最简单的方法是运行 `git clone https://github.com/google/syzkaller`，这将在当前工作目录中切换到该仓库。
    82  - 请记得 `export PATH=$GOPATH/bin:$PATH`，如果尚未导出 PATH 到环境变量。
    83  - 然后将您的仓库添加为附加源：
    84  
    85      ```shell
    86      cd syzkaller
    87      git remote add my-origin https://github.com/YOUR_GITHUB_USERNAME/syzkaller.git
    88      git fetch my-origin
    89      git checkout -b my-branch my-origin/master
    90      ```
    91  
    92  这会将您的仓库添加到 git origin `my-origin`，并基于 `master` 分支创建并切换新的分支 `my-branch` 。
    93  
    94  - 根据需要更改/添加文件。
    95  - 将更改提交到本地。为此，你需要对所有更改的文件运行 `git add`，例如 `git add sys/linux/sys.txt`。你可以运行 `git status` 查看有哪些文件被修改/创建。当所有文件都添加完毕后（`git status` 显示 `Changes not staged for commit` 部分没有文件，并且 `Untracked files` 部分没有相关文件），运行 `git commit` 并在你的编辑器中输入提交描述。
    96  - 在本地运行测试（`make install_prerequisites`，然后执行 `make presubmit`）。
    97  - 使用 `git push my-origin my-branch` 将提交推送到 github 上的复刻仓库。
    98  - 导航至 [github.com/google/syzkaller](https://github.com/google/syzkaller)，你会看到绿色的 `比较 & 拉取请求` 按钮，按下它。然后按 `创建拉取请求`。现在你的拉取请求应该会出现在[拉取请求页面](https://github.com/google/syzkaller/pulls)上。
    99  - 如果你由于任何原因看不到 `创建拉取请求` 按钮，你可以手动创建拉取请求。为此，请导航至[拉取请求页面](https://github.com/google/syzkaller/pulls)，按下 `新的拉取请求`，然后按下 `横叉比较` 并选择 `google/syzkaller`/`master` 作为基础，选择 `YOUR_GITHUB_USERNAME/syzkaller`/`my-branch` 作为比较，然后按下 `创建拉取请求`。
   100  - 如果在创建了拉取请求后，你决定对 `my-branch` 中的提交进行变基（例如，将它们变基到更新的 master 上），则需要执行一次强制推送：`git push -f my-origin my-branch`。
   101  
   102  ### 使用 syz-env
   103  
   104  开发 syzkaller 需要安装大量工具（Go 工具链、C/C++ 交叉编译器、golangci-lint 等）。安装所有这些工具可能会很麻烦，例如由于软件包损坏/缺失。[syz-env](/tools/syz-env) 提供了一个基于 Docker 容器的密封开发环境。如果尚未安装 Docker，请参阅[文档](https://docs.docker.com/engine/install)，特别是关于启用 [sudo-less](https://docs.docker.com/engine/install/linux-postinstall) 的 Docker（Googlers 参见 go/docker）。
   105  
   106  建议为 `syz-env` 脚本创建别名：
   107  
   108  ```
   109  alias syz-env="$(go env GOPATH)/src/github.com/google/syzkaller/tools/syz-env"
   110  ```
   111  
   112  然后，几乎所有的 make 调用都可以用它来封装：
   113  
   114  ```
   115  syz-env make format
   116  syz-env make presubmit
   117  syz-env make extract SOURCEDIR=$(readlink -f ~/linux)
   118  ```
   119  
   120  或其他命令/脚本，例如：
   121  
   122  ```
   123  syz-env go test -short ./pkg/csource
   124  ```
   125  
   126  或者，你也可以只使用 `syz-env` 来在容器内运行 shell 并查看。
   127  
   128  要将 `syz-env` 容器更新到最新版本，请执行以下操作：
   129  
   130  ``` bash
   131  docker pull gcr.io/syzkaller/env
   132  ```
   133  
   134  如果你无法访问 `gcr.io` 登记处，在 `docker.pkg.github.com` 登记处中也有一个镜像。要使用它，你需要使用你的 Github 账户来[验证 Docker](https://docs.github.com/en/packages/using-github-packages-with-your-projects-ecosystem/configuring-docker-for-use-with-github-packages)：
   135  
   136  ```
   137  docker login https://docker.pkg.github.com
   138  ```
   139  
   140  然后拉取镜像，并将其重新标记为 `syz-env` 所期望的名称：
   141  
   142  ```
   143  docker pull docker.pkg.github.com/google/syzkaller/env
   144  docker tag docker.pkg.github.com/google/syzkaller/env gcr.io/syzkaller/env
   145  ```