OS Manuals

/opt/datadog-agent/embedded/bin/in-toto-mock

From datadog-agent-7.75-core-integrations 7.75.4-r12 (enterprise-packages), captured 2026-11-08 by running in-toto-mock --help (exit 0). permalink

usage: in-toto-mock [-h] --name <name> -- <command> [args]

in-toto-mock is a variant of 'in-toto-run' that can be used to create unsigned
link metadata, using defaults for many of the 'in-toto-run' arguments.
in-toto-mock verbosely executes the passed command, records all files in the
current working directory as materials and products, and generates a link file
under '<name>.link'.

This is useful for trying out how to generate a link without the need for a
key, or knowledge about all 'in-toto-run' arguments. It can also be used to
quickly generate link metadata, inspect it and sign it retroactively.

Required Named Arguments:
  -n, --name <name>  name for the resulting link metadata file, which is written to '<name>.link'.
                     It is also used to associate the link with a step defined in an in-toto
                     layout.

Positional Arguments:
  <command>          command to be executed. It is separated from named and optional arguments by
                     a double dash '--'.

Options:
  -h, --help         show this help message and exit
  --use-dsse         generate metadata using dsse (experimental).
  --version          show program's version number and exit

EXAMPLE USAGE

Generate unsigned link metadata 'foo.link' for the activity of creating file
'bar', inspect it, and sign it with 'mykey'

  # Generate unsigned link
  in-toto-mock --name foo -- touch bar
  # Inspect and/or update unsigned link metadata
  vi foo.link
  # Sign the link, attesting to its validity, and write it to
  # 'foo.<mykey keyid prefix>.link'.
  in-toto-sign -k mykey -f foo.link
Options (4)
OptionDescriptionSource
-n, --name namename for the resulting link metadata file, which is written to '<name>.link'.help
-h, --helpshow this help message and exithelp
--use-dssegenerate metadata using dsse (experimental).help
--versionshow program's version number and exithelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.