10.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.