Skip to content

Commit

Permalink
finish proofreading syzkaller/usage.md
Browse files Browse the repository at this point in the history
Signed-off-by: Dongliang Mu <[email protected]>
  • Loading branch information
mudongliang committed Apr 5, 2024
1 parent 20ce38c commit 28531a4
Showing 1 changed file with 16 additions and 14 deletions.
30 changes: 16 additions & 14 deletions sources/syzkaller/usage.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,13 @@
---
status: translated
status: proofread
title: "How to use syzkaller"
author: Syzkaller Community
collector: chengziqiu
collected_date: 20240314
translator: moyi_hust
translated_date: 20240317
proofreader: mudongliang
proofread_date: 20240403
link: https://github.com/google/syzkaller/blob/master/docs/usage.md
---

Expand All @@ -18,27 +20,27 @@ link: https://github.com/google/syzkaller/blob/master/docs/usage.md
./bin/syz-manager -config my.cfg
```

`syz-manager` 进程将进入 VMs 并开始在其中进行模糊测试
`-config` 命令行选项给出了配置文件的位置[此处](configuration.md)对其进行了描述
syzkaller 发现的崩溃、统计信息和其他信息都暴露在管理器配置中指定的 HTTP 地址上
`syz-manager` 进程将启动虚拟机并在其中进行模糊测试
`-config` 命令行选项给出了配置文件的位置,并于[此处](configuration.md)给出详细描述
Syzkaller 发现的崩溃、统计信息和其他信息都暴露在管理器配置中所指定的 HTTP 网址

## 崩溃

一旦 syzkaller 在某个 VM 中检测到内核崩溃,它将自动开始重现这个崩溃的过程(除非你在配置中指定 `"reproduce": false`)。
默认情况下,它将使用 4 个 VM 来重现崩溃,然后缩小引起崩溃的程序
这可能会停止模糊测试,因为所有的 VM 可能都在忙于重现检测到的崩溃
一旦 syzkaller 在某个 VM 中检测到内核崩溃,它将自动开始重现该崩溃全过程(除非你在配置中指定 `"reproduce": false`)。
默认情况下,它将使用 4 个 VM 来重现内核崩溃,并缩小引起内核崩溃的程序
这可能会停止模糊测试,因为所有的 VM 可能都在忙于重现检测到的内核崩溃

重现一个崩溃的过程可能需要从几分钟到一个小时不等,这取决于崩溃是否容易重现或根本不可重现
由于这个过程并不完美,有一种尝试手动重现崩溃的方法,[此处](reproducing_crashes.md)所描述
重现一个内核崩溃的过程可能需要几分钟到一个小时不等,这取决于内核崩溃是否容易重现或根本不可重现
由于这个过程并不完美,有一种尝试手动重现崩溃的方法,详见[此处](reproducing_crashes.md)描述

如果成功找到复现程序,它可以生成两种形式之一:syzkaller 程序或 C 程序。
Syzkaller 总是尝试生成更用户友好的 C 语言复现程序,但有时因为各种原因失败(例如轻微不同的时间间隔)。
如果 syzkaller 仅生成 syzkaller 程序,在这种情况下,有[一种方式](reproducing_crashes.md)可以执行这些程序来手动重现和调试崩溃
如果成功找到复现程序,它将以 syzkaller 程序或 C 程序 进行呈现
Syzkaller 总是尝试生成更用户友好的 C 语言复现程序,但有时因为各种原因失败(例如轻微不同的执行时序)。
如果 syzkaller 仅生成 syzkaller 程序,你可以通过[一种方式](reproducing_crashes.md)执行这些程序来手动重现和调试内核崩溃。

## Hub

如果你正在运行多个 `syz-manager` 实例,有一种方法可以将它们连接起来并允许交换程序和复现程序,详细信息见[这里](hub.md)
如果你正在运行多个 `syz-manager` 实例,有一种方法可以将它们连接起来并允许交换执行程序和复现程序,详见[这里](hub.md)

## 报告错误

查看[这里](linux/reporting_kernel_bugs.md)的说明,了解如何报告 Linux 内核错误。
查看[此处](linux/reporting_kernel_bugs.md)说明,了解如何报告 Linux 内核错误。

0 comments on commit 28531a4

Please sign in to comment.