mirror of
https://github.com/microsoft/onefuzz.git
synced 2025-06-11 01:31:38 +00:00
a89065f882
## Summary of the Pull Request
Adds a new placeholder {setup_dir} for the setup directory
## PR Checklist
* [x] Applies to work item: #221
* [x] CLA signed. If not, go over [here](https://cla.opensource.microsoft.com/microsoft/onefuzz) and sign the CLI.
* [x] Requires documentation to be updated
* [x] I've discussed this with core contributors already. If not checked, I'm ready to accept this work might be rejected in favor of a different grand plan. Issue number where discussion took place: #xxx
## Info on Pull Request
_What does this include?_
## Validation Steps Performed
_How does someone test & validate?_
46 lines
1.9 KiB
Markdown
46 lines
1.9 KiB
Markdown
# Commandline Injection
|
|
|
|
The following values are replaced with the specific values at runtime.
|
|
|
|
* `{input}`: Path to the input file being processed in the current event
|
|
* `{crashes}`: Path to write crashes
|
|
* `{input_corpus}`: Path to the input corpus directory
|
|
* `{generated_inputs}`: Path to the generated inputs directory
|
|
* `{target_exe}`: Path to the target binary
|
|
* `{target_options}`: Target options (recursively expanded)
|
|
* `{output_dir}` : Path to the output directory as defined by the task
|
|
* `{input_file_name}`: the input file name with the extension (available
|
|
wherever `input` is available)
|
|
* `{input_file_name_no_ext}`: the input file name without the extension
|
|
(available wherever `input` is available)
|
|
* `{runtime_dir}`: Path to the runtime directory for the task
|
|
* `{tools_dir}`: Path to the task specific `tools` directory
|
|
* `{setup_dir}` : Path to the setup directory
|
|
|
|
## Example
|
|
|
|
Assume the following:
|
|
|
|
* `supervisor_options` is: "a", "{target_options}", "b"
|
|
* `target_options` is: "c", "{target_exe}"
|
|
* `target_exe` is: "d"
|
|
|
|
The resulting `supervisor_options` is: "a", "c", "d", "b"
|
|
|
|
## Uses
|
|
|
|
These are currently used in the following tasks:
|
|
|
|
* libfuzzer_fuzz: `target_exe`, `target_options`, `input_corpus`, `crashes`
|
|
* libfuzzer_crash_report: `target_exe`, `target_options`, `input`
|
|
* libfuzzer_merge: `target_exe`, `target_options`, `input_corpus`
|
|
* libfuzzer_coverage: None
|
|
* generic_analysis: `input`, `target_exe`, `target_options`, `analyzer_exe`,
|
|
`anayzer_options`, `output_dir`, `tools_dir`
|
|
* generic_generator: `generated_inputs`, `input_corpus`, `tools_dir`,
|
|
`generator_exe`, `generator_options`, `target_exe`, `target_options`, `input`
|
|
* generic_supervisor: `crashes`, `runtime_dir`, `target_exe`, `target_options`,
|
|
`input_corpus`, `input`, `supervisor_exe`, `supervisor_options`, `tools_dir`
|
|
* generic_merge: `input`, `input_corpus`, `output_dir`, `target_exe`,
|
|
`target_options`, `supervisor_exe`, `supervisor_options`, `tools_dir`
|