Next: Listing global options, Previous: Listing options, Up: Modify .gnupg home directories [Contents][Index]

#### 9.4.6 Changing options

The command `--change-options component` will attempt to change the options of the component component to the specified values. component must be the string in the field name in the output of the `--list-components` command. You have to provide the options that shall be changed in the following format on standard input:

`name:flags:new-value`

name

  This is the name of the option to change. name must be the string in the field name in the output of the `--list-options` command.

flags

  The flags field contains an unsigned number. Its value is the OR-wise combination of the following flag values:

  `default (16)`

    If this flag is set, the option is deleted and the default value is used instead (if applicable).

new-value

  The new value for the option. This field is only defined if the `default` flag is not set. The format is that of an option argument. If it is empty (or the field is omitted), the default argument is used (only allowed if the argument is optional for this option). Otherwise, the option will be set to the specified value.

The output of the command is the same as that of `--check-options` for the modified configuration file.

Examples:

To set the force option, which is of basic type `none (0)`:

    $ echo 'force:0:1' | gpgconf --change-options dirmngr

To delete the force option:

    $ echo 'force:16:' | gpgconf --change-options dirmngr

The `--runtime` option can influence when the changes take effect.

Next: Listing global options, Previous: Listing options, Up: Modify .gnupg home directories [Contents][Index]