OS Manuals

/usr/bin/mapotf

A tool for mapping and transforming OpenTofu/Terraform configurations

From mapotf 0.0.0_git20261016-r4 (enterprise-packages), captured 2026-11-08 by running mapotf --help (exit 0). permalink

Also provided by 1 other package version
mapotf applies declarative HCL transforms to a target Terraform or OpenTofu
module: adding telemetry, normalising provider versions, sorting blocks and
attributes, and other repeatable rewrites used by AVM and similar governance
pipelines.

Usage:
  mapotf [command]

Available Commands:
  apply        [terraform]: Create or update infrastructure
  clean-backup Reserve all transformed Terraform files, clear backup files, mapotf clean-backup --tf-dir  [path to config files]
  completion   Generate the autocompletion script for the specified shell
  console      [terraform]: Try Terraform expressions at an interactive command prompt
  debug        Start REPL mode, mapotf debug --mptf-dir [path to config files]
  destroy      [terraform]: Destroy previously-created infrastructure
  fmt          [terraform]: Reformat your configuration in the standard style
  force-unlock [terraform]: Release a stuck lock on the current workspace
  get          [terraform]: Install or upgrade remote Terraform modules
  graph        [terraform]: Generate a Graphviz graph of the steps in an operation
  help         Help about any command
  import       [terraform]: Associate existing infrastructure with a Terraform resource
  init         [terraform]: Prepare your working directory for other commands
  login        [terraform]: Obtain and save credentials for a remote host
  logout       [terraform]: Remove locally-stored credentials for a remote host
  metadata     [terraform]: Metadata related commands
  output       [terraform]: Show output values from your root module
  plan         [terraform]: Generates a plan based on the specified configuration
  providers    [terraform]: Show the providers required for this configuration
  refresh      [terraform]: Update the state to match remote systems
  reset        Reset all transformed Terraform files, mapotf reset --tf-dir
  show         [terraform]: Show the current state or a saved plan
  state        [terraform]: Advanced state management
  taint        [terraform]: Mark a resource instance as not fully functional
  test         [terraform]: Execute integration tests for Terraform modules
  transform    Apply the transforms, mapotf transform [-r] [--keep-adjacent-blocks] --tf-dir [] --mptf-dir  [path to config files], support mutilple mptf dirs
  untaint      [terraform]: Remove the 'tainted' state from a resource instance
  validate     [terraform]: Check whether the configuration is valid
  version      [terraform]: Show the current Terraform version
  workspace    [terraform]: Workspace management

Flags:
      --eval string                 Evaluate an HCL expression as JSON without applying transforms (debug only)
  -h, --help                        help for mapotf
      --mptf-dir strings            MPTF directory
      --mptf-var stringArray        Set a value for one of the input variables in the root module of the configuration. Use this option more than once to set more than one variable.
      --mptf-var-file stringArray   Load variable values from the given file, in addition to the default files mptf.mptfvars and *.auto.mptfvars. Use this option more than once to include more than one variables file.
      --test-file string            Select one .tftest.hcl file relative to --tf-dir (transform, debug, reset, clean-backup only)
      --tf-dir string               Terraform directory (default "/tmp")
  -v, --version                     version for mapotf

Use "mapotf [command] --help" for more information about a command.
Options (8)
OptionDescriptionSource
--eval stringEvaluate an HCL expression as JSON without applying transforms (debug only)help
-h, --helphelp for mapotfhelp
--mptf-dir stringsMPTF directoryhelp
--mptf-var stringArraySet a value for one of the input variables in the root module of the configuration.help
--mptf-var-file stringArrayLoad variable values from the given file, in addition to the default files mptf.mptfvars and *.auto.mptfvars.help
--test-file stringSelect one .tftest.hcl file relative to --tf-dir (transform, debug, reset, clean-backup only)help
--tf-dir stringTerraform directory (default "/tmp")help
-v, --versionversion for mapotfhelp

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