https://github.com/zigtools/sus

Hunt down sus ZLS activity by spamming ZLS with hot req/notif garbage
https://github.com/zigtools/sus

language-server zig-language-server zls

Last synced: 4 days ago
JSON representation

Hunt down sus ZLS activity by spamming ZLS with hot req/notif garbage

• Host: GitHub
• URL: https://github.com/zigtools/sus
• Owner: zigtools
• License: mit
• Created: 2022-11-19T08:02:51.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-07-18T02:01:53.000Z (4 months ago)
• Last Synced: 2024-10-29T16:20:14.602Z (15 days ago)
• Topics: language-server, zig-language-server, zls
• Language: Zig
• Homepage: https://fuzzing.zigtools.org
• Size: 343 KB
• Stars: 17
• Watchers: 7
• Forks: 3
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# sus

ZLS fuzzing tooling.

```bash

git clone https://github.com/ziglang/zig repos/zig

git clone https://github.com/zigtools/zls repos/zls

zig build -- repos/zls/zig-out/bin/zls[.exe]

# example with 'markov training dir'

zig build run -- --zls-path repos/zls/zig-out/bin/zls[.exe] --mode markov -- --training-dir repos/zig/src

```

# usage

```console

Usage:   sus [options] --mode [mode] -- 

Example: sus --mode markov        -- --training-dir  /path/to/folder/containing/zig/files/

         sus --mode best_behavior -- --source_dir   ~/path/to/folder/containing/zig/files/

General Options:

  --help                Print this help and exit

  --output-as-dir       Output fuzzing results as directories (default: false)

  --zls-path [path]     Specify path to ZLS executable

  --mode [mode]         Specify fuzzing mode - one of { best_behavior, markov }

  --cycles-per-gen      How many times to fuzz a random feature before regenerating a new file. (default: 25)

For a listing of mode specific options, use 'sus --mode [mode] -- --help'.

For a listing of build options, use 'zig build --help'.

```

# .env

if a .env file is present at project root or next to the exe, the following keys will be used as default values.  

```console

zls_path=~/repos/zls/zig-out/bin/zls

mode=markov

markov_training_dir=~/repos/zig/src

```

this allows the project to be run with no args:

```console

zig build run

```