% apt-sourcemgr(1) User Manual % Jens John [email protected] % Version 0.1
apt-sourcemgr - Tool for managing local APT sources.list configuration
apt-sourcemgr [-h
| --help
] ACTION
[OPTION
]...
apt-sourcemgr is a command line interface for managing the of the sources.list configuration of the local system as used by the Debian APT package management tools. Its working principle is to first select a set of source entries using criterea received via option arguments and then perform an action given by ACTION on it.
- add: Ensure that an entry matching the given criteria is present and enabled.
- apply-template: A special case of the add action. A python-apt distribution template is used as a source of entries, and all entries matching the specification are added to the system configuration.
- disable: Disable existing entries matching the given criteria. An
entry is said to be disabled when its line in the configuration
starts with a
#
character. - enable: Enable entries matching the given criteria. An entry is said to be enabled when it isn't commented out in the configuration file.
- find: Find existing entries matching the filter specification and print them to standard output.
- remove: Remove entries matching the given criteria.
Options affect how actions are executed or may change how other options
are interpreted. The -h
, --help
option is special; it prints a help text
and immediately ends the program.
Show this help message and exit.
Path to the .list file to store the entry in. Works only with the add
verb. Note that if a similar entry already exists (for example when just
adding a component), or if the entry is present but disabled), the
existing entry will be reused, modified and the file argument will be
ignored. (default: None)
Matches disabled (commented-out) entries. (default: None)
Matches enabled entries. (default: None)
Matches invalid entries. (default: False)
Matches entries with the given architecture(s). May be specified multiple times. (default: None)
Matches entries with the given component(s). May be specified multiple times. (default: None)
Matches the given distribution. (default: None)
Normally, whenever a list-based filter parameter is being evaluated,
entries only match if they fulfill the specification completely. For
example, when filtering using --component main
, entries which
possess the component main
but also contrib
will not match. By
setting this flag, entries will match if any of the command line
filter paramters will match. Applies only to: --architecture,
--component. (default: False)
--uri, --distribution and --component will now be evaluated as
case-insensitive regular expressions against the entry. When used with
apply-template
, the behaviour of --component is different. Only the
first occurrence of --component will be taken as the regex and only
components matching that regex will be included in the final entry.
(default: False)
DEB source type. (default: None)
Source URI. (default: None)
Do not save any changes, and log all changed source entries to stdout. (default: False)
Derive all specifications from the given pyton-apt template. Only used by the apply-template action. (default: None)
sources.list(5).