Scroll to navigation

EYAML(1) General Commands Manual EYAML(1)

NAME

eyaml — command line interface for the hiera eyaml backend

SYNOPSIS

eyaml [--help] [subcommand [subcommand options]]

all subcommands

[--help, -h]

Display help
[--version]
Display program version
[--verbose, -v]
Be more verbose
[--quiet, -q]
Be less verbose
[--encrypt-method, -n METHOD]
Override default encryption and decryption method (default: pkcs7)
[--pkcs7-private-key -FILE]
Path to private key (default: ./keys/private_key.pkcs7.pem)
[--pkcs7-public-key -FILE]
Path to public key (default: ./keys/public_key.pkcs7.pem)
[--pkcs7-subject -SUBJECT]
Subject to use for certificate when creating keys (default: /)

eyaml createkeys [options]

Create a new key pair

eyaml decrypt [options]

Decrypt data

[--string STRING]

Source input STRING is provided as an argument
[--file, -f FILE]
Source input FILE is a regular file
[--eyaml, -e FILE]
Source input FILE is an eyaml file
[--stdin]
Source input is taken from STDIN

eyaml edit FILE

Edit a file

eyaml encrypt [options]

[--password, -p]

Source input is a password entered on the terminal
[--eyaml, -e FILE]
Source input FILE is an eyaml file
[--file, -f FILE]
Source input FILE is a regular file
[--stdin]
Source input is taken from STDIN
[--string STRING]
Source input STRING is provided as an argument
[--output, -o]
Output format of final result (examples, block, string) (default: examples)
[--label, -l LABEL]
Apply a label to the encrypted result

eyaml recrypt [options]

recrypt an eyaml file

eyaml version

show version information

DESCRIPTION

The eyaml command is a command line interface for hiera-eyaml. It is used to create keys, encrypt and decrypt data, and act as a wrapper around a text editor.

EXAMPLES

encrypting data

$ eyaml encrypt --string 'foo bar'

Encrypts the command line argument to "--string", and outputs the encrypted data on two formats, line and block. This can be included in an .eyaml file. The "eyaml" command expects keys to be present in the "./keys/" directory by default.

using the editor wrapper

$ eyaml edit hieradata/common.eyaml

Decrypts the file into a temporary file, and opens the file in a text editor. Values to be encrypted are wrapped in markup. When the file is saved, any changed values are encrypted.

AUTHORS

eyaml was written by Geoff Meakin, Peter Dyson, Robert Fielding, Simon Hildrew and Tom Poulton.

This man page was written by Stig Sandbeck Mathisen for the Debian distribution, but may be used by others.

BUGS

The file referenced in "eyaml edit" must exist.

An error in the markup may result in "eyaml edit" not being able to open the file.

March 31, 2014 Debian