aboutsummaryrefslogtreecommitdiffstats
path: root/docs
Commit message (Collapse)AuthorAgeFilesLines
* prog: annotate image assets with fsck logsFlorent Revest2024-12-091-1/+4
| | | | | | | | | | | | | | | | | | Syscall attributes are extended with a fsck command field which lets file system mount definitions specify a fsck-like command to run. This is required because all file systems have a custom fsck command invokation style. When uploading a compressed image asset to the dashboard, syz-manager also runs the fsck command and logs its output over the dashapi. The dashboard logs these fsck logs into the database. This has been requested by fs maintainer Ted Tso who would like to quickly understand whether a filesystem is corrupted or not before looking at a reproducer in more details. Ultimately, this could be used as an early triage sign to determine whether a bug is obviously critical.
* tools/syz-env: add local build optionStefan Wiehler2024-11-291-0/+6
| | | | Useful for testing local Dockerfile changes that have not been pushed yet.
* docs: update reproduction instructionsAleksandr Nogikh2024-11-299-92/+84
| | | | | | | 1. Get rid of executing_syzkaller_programs.md as it now mostly overlaps with reproducing_crashes.md. 2. Update the instructions on building the kernel with syzbot compilers. 3. Update the links throughout the documentation.
* docs: rewrite reproducing_crashes.mdAleksandr Nogikh2024-11-251-25/+169
| | | | | | | | | | Let's list all the possible ways of reproducing syzkaller crashes locally and keep the instructions of how to manually craft a reproducer at the bottom. Add information about the ktest tooling - now it also automates the reproduction of syzbot bugs. See the discussion at: https://groups.google.com/g/syzkaller/c/UTPrWcJfS8Q/m/K1YXz-f1AQAJ
* all: support || operator in syzlang if conditionJiao, Joey2024-11-131-1/+2
| | | | | | | | | | | ex. f3 field has logic or operator in if condition: conditional_struct { mask int32 f1 field1 (if[value[mask] & FIELD_FLAG1]) f2 int64 (if[value[mask] & FIELD_FLAG2]) f3 int64 (if[value[mask] == FIELD_FLAG1 || value[mask] == FIELD_FLAG2]) } [packed]
* docs: add two more talksAleksandr Nogikh2024-11-011-0/+2
|
* dashboard: allow multiple allowed authentication domainsFlorent Revest2024-10-101-1/+1
| | | | | | | In some situations, it could be useful to share access to the dashboard to multiple authentication domains. The current GlobalConfig format doesn't really allow it so this deprecates the existing field and add a new slice of allowed authentication domains.
* doc: update go version in syzkaller setupSabyrzhan Tasbolatov2024-09-281-3/+3
| | | | | | | go.mod has been bumped with go 1.22.1 version recently. So let's update the documentation as well. https://github.com/google/syzkaller/blob/master/docs/linux/setup.md#go-and-syzkaller
* docs: refine Linux bug reporting instructionsDmitry Vyukov2024-09-161-5/+33
| | | | Add more guidelines and be more concrete.
* docs/linux: update debug info kernel configjohn2024-09-051-0/+6
|
* all: add npm package to syz-envJoey Jiao2024-08-291-0/+13
| | | | | | | | | | act(https://github.com/nektos/act) is used to build github workflow locally. When running `act -j build` in local host, it reports: exec failed: unable to start container process: exec: "node": executable file not found in $PATH: unknown. Adding nodejs package can fix the build error. Updated docs with act usage too.
* docs/adding_new_os_support.md: fix a typoMarsman19962024-08-211-1/+1
|
* docs/translations: add the translation of linux/reporting_kernel_bugs.mdQGrain2024-08-191-0/+74
| | | | Finish the translation of docs/linux/reporting_kernel_bugs.md, which has also been proofread by HCTT translation group.
* docs/translations: add the translation of ↵QGrain2024-08-191-0/+174
| | | | | | linux/setup_linux-host_qemu-vm_arm64-kernel.md Upload translation of linux/setup_linux-host_qemu-vm_arm64-kernel.md, which is proofread by HCTT.
* docs: update information about syz-runtestAleksandr Nogikh2024-08-072-5/+5
| | | | | | This is no longer a standalone tool, but rather a syz-manager mode. Closes #4970.
* docs/translations: add the Chinese translation of ↵Dongliang Mu2024-07-291-0/+76
| | | | executing_syzkaller_programs.md
* docs/translations: finish translating research.mdDongliang Mu2024-07-291-0/+64
|
* docs/translations: add the translation of configuration.mdDongliang Mu2024-07-291-0/+9
|
* docs/translations: add the Chinese translation of bisect.mdDongliang Mu2024-07-291-0/+82
|
* docs/coverage.md: quote values, not paramTaras Madan2024-07-181-1/+1
|
* docs/translations: add the translation of syscall_descriptions_syntax.mdQGrain2024-07-181-0/+584
| | | | Finish the translation of docs/syscall_descriptions_syntax.md, which has also been proofread by HCTT translation group.
* docs/translations: move the notice at the top of these documentsDongliang Mu2024-07-185-10/+20
|
* docs/translations: add the translation of contributing.mdQGrain2024-07-161-0/+143
| | | | | | Finish the translation of docs/contributing.md, which has also been proofread by HCTT translation group. Please note that pr https://github.com/google/syzkaller/pull/5038 is obsolete and closed, so please ignore it.
* docs/translations: add the translation of linux/external_fuzzing_network.mdDongliang Mu2024-07-151-0/+67
| | | | | | Finish the translation of linux/external_fuzzing_network.md. Signed-off-by: Dongliang Mu <dzm91@hust.edu.cn>
* docs/translations: add a notice at the end of usage.mdDongliang Mu2024-07-151-0/+2
|
* docs/contributing.md: fix a typoQGrain2024-07-151-1/+1
| | | | Fix a typo in the section of "Using syz-env": expacted to expected.
* docs/translations: add a notice at the end of internals.mdDongliang Mu2024-07-151-1/+4
|
* docs: fix 'fmt' description regarding 'const' typeIgor Chervatyuk2024-07-081-1/+1
| | | | Fixed 'fmt' documentation description at docs/syscall_descriptions_syntax.md.
* docs: link updated instructions for running USB reproducersAndrey Konovalov2024-07-031-112/+3
| | | | Closes #3802.
* docs: update process structure to remove syz-fuzzerJoey Jiao2024-07-022-0/+125
|
* executor: add runner modeDmitry Vyukov2024-06-244-17/+11
| | | | | | | Move all syz-fuzzer logic into syz-executor and remove syz-fuzzer. Also restore syz-runtest functionality in the manager. Update #4917 (sets most signal handlers to SIG_IGN)
* docs/syscall_descriptions_syntax.md: remove a redundant square bracketQGrain2024-06-171-1/+1
| | | | Remove a redundant square bracket in section "Expression syntax".
* docs/syzbot_assets.md: provide a sample qemu command for arm64Aleksandr Nogikh2024-06-111-0/+9
| | | | | In case of ARM64 bugs, we need to use a somewhat different set of qemu arguments to run the kernel from syzbot assets locally.
* docs: remove mentions of strconstDmitry Vyukov2024-06-111-1/+1
| | | | strconst["foo"] was replaced by ptr[in, string["foo"]].
* docs/freebsd: update with notes on slirp-based networkingMark Johnston2024-05-271-4/+12
|
* prog: introduce a remote_cover call attributeAleksandr Nogikh2024-05-271-0/+1
| | | | | | Update the descriptions to mark calls that cause remote coverage collection. Remote some hacky code from the executor.
* pkg/vminfo: move feature checking to hostDmitry Vyukov2024-05-151-10/+3
| | | | | | | | | | | | | | | | | Feature checking procedure is split into 2 phases: 1. syz-fuzzer invokes "syz-executor setup feature" for each feature one-by-one, and checks if executor does not fail. Executor can also return a special "this feature does not need custom setup", this allows to not call setup of these features in each new VM. 2. pkg/vminfo runs a simple program with ipc.ExecOpts specific for a concrete feature, e.g. for wifi injection it will try to run a program with wifi feature enabled, if setup of the feature fails, executor should also exit with an error. For coverage features we also additionally check that we actually got coverage. Then pkg/vminfo combines results of these 2 checks into final result. syz-execprog now also uses vminfo package and mimics the same checking procedure. Update #1541
* pkg/csource: replace go:generate with go:embedDmitry Vyukov2024-05-081-19/+3
| | | | | | | go:embed is a more modern way to do this and it does not require a special Makefile step. Since go:embed cannot use paths that contains "..", the actual embeding is moved to executor package.
* tools/syz-stress: delete utilityDmitry Vyukov2024-05-061-2/+2
| | | | | | | | Move syz-stress logic into syz-execprog. It's already doing most of what syz-stress could do, it even can load a corpus since recently. There are few remaining bits that are missing in execprog, so add them to execprog.
* docs: update required Go versionBjoern Doebel2024-05-031-1/+1
| | | | Builds won't work with 1.20 anymore and the download steps below already mention 1.21.4, so adjust the text as well.
* docs: add an external articleDmitry Vyukov2024-04-301-0/+1
|
* docs: remove outdated architecture descriptionAleksandr Nogikh2024-04-301-1/+1
| | | | syz-fuzzer no longer generates programs.
* docs/syzbot.md: fix typoDirk Behme2024-04-291-1/+1
| | | | | | Fix typo in syzbot.md. Signed-off-by: Dirk Behme <dirk.behme@gmail.com>
* tools/syz-db: add more usage info for syz-dbSimone Weiß2024-04-221-0/+59
| | | | | | Add some short notes on how syz-db can also be used manually. Signed-off-by: Simone Weiß <simone.weiss@elektrobit.com>
* docs: delete found_bugs.mdDmitry Vyukov2024-04-151-15/+0
| | | | We don't reference it anywhere and we have the list right on the main page.
* all: remove akaros supportDmitry Vyukov2024-04-156-31/+7
| | | | | | | Akaros support is unused, it was shutdown on syzbot for a while, the akaros development seems to be frozen for years as well. We have a bunch of hacks for Akaros since it supported only super old gcc and haven't supported Go. Remove it.
* vm/odroid: deleteDmitry Vyukov2024-04-152-330/+0
| | | | | | | | Delete support for odroid board. It's build broken for >3 years (at least on 8ba8079b119f). We keep it in history and if it's resurrected, it needs to be merged with vm/isolated and most code needs to be at least build-tested (mock out only the C interface).
* docs/translations: add the translation of program_syntax.mdDongliang Mu2024-04-091-0/+92
| | | | | | | The translation of program_syntax.md is done. There is no relative link in the document, no worry about relocation. Signed-off-by: Dongliang Mu <dzm91@hust.edu.cn>
* docs/translations: add zh_CN translation of usage.mdDongliang Mu2024-04-081-0/+33
| | | | | | | | | | Finish the translation of docs/usage.md. Our current policy is to keep the English link of untranslated documents. Note that, all the relative paths of documents need relocation since these documents may not be translated. Signed-off-by: Dongliang Mu <dzm91@hust.edu.cn>
* docs: fix a typo in the android device setupDongliang Mu2024-04-031-1/+1
| | | | The -> Then
generated by ggit (джигит) mrf-deployment (git 2.46.0) at 2026-04-01 05:33:47 +0000