---
name: "App::Cme::Command::modify"
section: "3pm"
platform: "linux"
package: "cme"
version: "1.041-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/App::Cme::Command::modify"
---

# App::Cme::Command::modify(3pm)

Modify the configuration of an application

## NAME

App::Cme::Command::modify - Modify the configuration of an application

## VERSION

version 1.041

## SYNOPSIS

```
  # modify configuration with command line
  cme modify dpkg source 'format="(3.0) quilt"'
```

## DESCRIPTION

Modify a configuration file with the values passed on the command line. These command must follow the syntax defined in Config::Model::Loader (which is similar to the output of cme dump command)

Example:

```
   cme modify dpkg 'source format="(3.0) quilt"'
   cme modify multistrap my_mstrap.conf 'sections:base source="http://ftp.fr.debian.org"'
```

Some application like dpkg-copyright allows you to override the configuration file name. You must then use `"-file"` option:

```
   cme modify dpkg-copyright -file ubuntu/copyright 'Comment="Silly example"'
```

Finding the right instructions to perform a modification may be difficult when starting from scratch.

To get started, you can run `"cme dump --format cml"` command to get the content of your configuration in the syntax accepted by `"cme modify"`:

```
 $ cme dump ssh -format cml
 Host:"*" -
 Host:"alioth.debian.org"
   User=dod -
 Host:"*.debian.org"
   IdentityFile:="~/.ssh/id_debian"
   User=dod -
```

Then you can use this output to create instruction for a modification:

```
 $  cme modify ssh 'Host:"*" User=dod'
 Changes applied to ssh configuration:
 - Host:"*" User has new value: 'dod'
```

## Common options

See "Global Options" in cme.

## options

- \-savek

  Force a save even if no change was done. Useful to reformat the configuration file.

- \-verbose

  Show effect of the modify instructions.

## SEE ALSO

cme

## AUTHOR

Dominique Dumont

## COPYRIGHT AND LICENSE

This software is Copyright (c) 2014-2022 by Dominique Dumont \<ddumont@cpan.org\>.

This is free software, licensed under:

```
  The GNU Lesser General Public License, Version 2.1, February 1999
```