cowbird

Crates.io Docs.rs CI Coverage Status

About

cowbird is a tool for triggering endpoint detection and response (EDR) agents, and produces structured logs for regression testing.

Installation

Select an installation method for installing cowbird:

Install from Releases

Install from Cargo

Commands

``` cowbird 0.1.1 EDR tool

USAGE: cowbird [OPTIONS]

OPTIONS: -l, --log Log file location [default: cowbird.log] -h, --help Print help information -V, --version Print version information

SUBCOMMANDS: start Starts a new process create Create a file modify Modify a file delete Delete a file send Send data over network script Run commands from YAML input cowbird-start Starts a new process

USAGE: cowbird start [ARGS]...

ARGS:
...
cowbird-create Create a file

USAGE: cowbird create

ARGS: File to create cowbird-modify Modify a file

USAGE: cowbird modify [OFFSET]

ARGS: File to modify Bytes to write, decode hex if value starts with "0x" Byte offset for writing data [default: 0] cowbird-delete Delete a file

USAGE: cowbird delete

ARGS: File to delete cowbird-send Send data over network

USAGE: cowbird send [ARGS]

ARGS: Destination address:port Bytes to write, decode hex if value starts with "0x" [default: ] Network protocol to use [default: udp] [possible values: tcp, udp] cowbird-script Run commands from YAML input

USAGE: cowbird script [FILE]

ARGS: File to read [default: -]

OPTIONS: -h, --help Print help information ```

Scripting Example

See examples/test.yaml as an example for using YAML document separators for ingesting multiple commands, and how those command inputs are formatted.

If building from source on a unix like system the example can be run with ./examples/test.yaml, or the script can be run with a pre-built binary using cowbird script ./examples/test.yaml.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

See CONTRIBUTING.md.