github.com/google/syzkaller@v0.0.0-20240517125934-c0f1611a36d6/docs/db.md (about)

     1  # syz-db
     2  
     3  `syz-db` program can be used to manipulate corpus.db databases that are used
     4  by syz-managers.
     5  
     6  ## Build
     7  
     8  Build `syz-db` with `make db` or by changing to `tools/syz-db` and run `go build`.
     9  
    10  ## Options
    11  
    12  `syz-db` currently overs the following generic arguments:
    13  
    14  ```shell
    15    -arch string
    16      	target arch
    17    -os string
    18      	target OS
    19    -version uint
    20      	database version
    21    -vv int
    22      	verbosity
    23  ```
    24  
    25  That can be used with
    26  
    27  ```
    28    syz-db pack dir corpus.db
    29  ```
    30  
    31  to pack a database
    32  
    33  ```
    34    syz-db unpack corpus.db dir
    35  ```
    36  
    37  to unpack a database. A file containing performed syscalls will be returned.
    38  
    39  ```
    40    syz-db merge dst-corpus.db add-corpus.db* add-prog*
    41  ```
    42  
    43  to merge databases. No additional file will be created: The first file will be replaced by the merged result.
    44  
    45  ```
    46    syz-db bench corpus.db
    47  ```
    48  
    49  to run a deserialization benchmark. For example:
    50  
    51  ```
    52  syz-db -os=linux -arch=amd64 bench corpus.db
    53  ```
    54  
    55  could give an output like
    56  
    57  ```
    58  allocs 123 MB (123 M), next GC 123 MB, sys heap 123 MB, live allocs 123 MB (123 M), time 324s.
    59  ```