# Vault 7: Projects

This publication series is about specific projects related to the Vault 7 main publication.

### Grasshopper

# Grasshopper-v1_1-AdminGuide

1 December, 2013

- 1
- 2
…
- 19
- 20
- 21
- 22
- 23
…
- 106
- 107

SECRET//ORCON//NOFORN
2.1 Introduction
Grasshopper rules are used to perform a pre-installation survey of the target device,
assuring that the payload will only installed if the target has the right configuration.
A rule can be as simple a single true statement, or highly complex with layers of
logical statement. In either case, every rule results in a single return code of: True,
False, or Invalid. Invalid is a special case where an issue occurred during the
gathering of the fact that makes the result indeterminate. If the final result of a rule
is an Invalid, the rule will be treated as if it failed, and the system will move to the
next payload, if available.
Every Grasshopper module, payloads and persist modules, require a rule. The only
exception to this is the Cricket builder, which generates an installation that ignores
all rules and installs the payload and persist module blind. The following section will
describe the custom Grasshopper Rule language and provide best practices for
updating existing or writing new rules.
21
SECRET//ORCON//NOFORN

- 1
- 2
…
- 19
- 20
- 21
- 22
- 23
…
- 106
- 107