apt-dater.config(5) configuration file of apt-dater(8)

SYNOPSIS

Group: {

parameter=value;

}

DESCRIPTION

The file apt-dater.config is the configuration file for apt-dater(8). apt-dater(8) is a program to manage package updats on a large number of remote hosts using SSH. This man page descripes briefly the parameters of the file apt-dater.config. The default location of this file is $XDG_CONFIG_HOME/apt-dater/apt-dater.config.

The configuration file is parsed using libconfig. Please be aware that config statements are case sensitive. Look at libconfig's documentation for more details about the required file syntax.

OPTIONS

Group 'Paths'

HostsFile="$XDG_CONFIG_HOME/apt-dater/hosts.config";

The location of the file contains all host which will be managed with apt-dater. (optional)

StatsDir="$XDG_DATA_HOME/apt-dater";

The location of the directory which contains the status files of any host. (optional)

Group 'Screen'

RCFile="$XDG_CONFIG_HOME/apt-dater/screenrc";

Location of screen(1) config file. (optional)

Title="%m # %u@%h:%p";

Template for screen titles using string escapes. (optional)

NoDumps=false;

Enables/disables support of screen dumps. (optional)

QueryMaintainer=0;

If set to 1, apt-dater will ask for the maintainers name on startup. If set to 2, apt-dater will only ask if no MAINTAINER environment variable is set.

Group 'SSH'

Cmd="/usr/bin/ssh";

The location of ssh-client binary.

SFTPCmd

The command to initiate sftp file transfer e.g. /usr/bin/sftp

OptionalCmdFlags

Additional ssh-client command flags, which will be appended.

SpawnAgent=false;

If enabled, apt-dater tries to spawn ssh-agent(1) if none is already running. ssh-add(1) will be called to load your private keys.

AddKeys

List of private keys which should be loaded when apt-dater calls ssh-add(1).

Group 'Commands'

CmdRefresh="apt-dater-host refresh";

The command which will be used to refresh the status of the managed host.

CmdUpgrade="apt-dater-host upgrade";

The command which will be used to intitate a upgrade of a managed host.

CmdInstall="apt-dater-host install %s";

The command which will be used to update a single package. %s will be replaced by the name of the package.

Group 'Appearance'

Colors

Set your own color style of the ui components. To highlight colors you can use the bright* keyword. Example: Colors=menu brightgreen blue;status brightgreen blue;selector black red;

.
   Components are:

default

menu

status

selector

hoststatus

query

input

Colors are:

default

black

cyan

green

magenta

red

white

yellow

Group 'AutoRef'

enabled=true;

Enabled the auto refresh feature if compiled in (see README.autoref).

Group 'Notify'

bell=true;

Enables user notification by terminal bell.

flash=true;

Enables user notification by terminal flashing.

Group 'History'

ErrPattern="((?<!no )error|warning|fail)";

A regular expression pattern to match the screen output. A match indicates the user should be asked to review the output (using less). (Optional)

record=true;

Enables session recording using script(1). (Optional)

Group 'Hooks'

PreUpdate="/etc/apt-dater/pre-upg.d";, PreRefresh="/etc/apt-dater/pre-ref.d";, PreInstall="/etc/apt-dater/pre-ins.d";, PreConnect="/etc/apt-dater/pre-con.d";, PostUpdate="/etc/apt-dater/post-upg.d";, PostRefresh="/etc/apt-dater/post-ref.d";, PostInstall="/etc/apt-dater/post-ins.d";, PostConnect="/etc/apt-dater/post-con.d";

Hooks to be run before and after an action on a host is done. The values should be path names, any executable script within these directories will be run by run-parts(8).

STRING ESCAPES

apt-dater(8) provides an string escape mechanism. The escape character is '%'.


    .sp
Table 1. List of supported escapes.

escape replaced by
% escape character
h hostname
H SSH hostname used for connecting
m maintainer name
p SSH port number
u SSH username
U SSH username appended by '@', empty string if no SSH username is configured.

FILES

apt-dater.config

The configuration file of apt-dater.

hosts.config

Contains all hosts you would like to manage.

AUTHORS

Thomas Liske <[email protected]>

maintainer

Andre Ellguth

ex-maintainer

COPYRIGHT


Copyright © 2008-2014 IBH IT-Service GmbH [m[blue]https://www.ibh.de/m[]]

NOTES

1.
XDG Base Directory Specification
http://www.freedesktop.org/Standards/basedir-spec
2.
libconfig documentation
http://www.hyperrealm.com/libconfig/libconfig_manual.html