apt-dater.conf

Langue: en

Version: May 23, 2009 (ubuntu - 24/10/10)

Section: 5 (Format de fichier)

NAME

apt-dater.conf - configuration file of apt-dater(8)

SYNOPSIS

[Section]
parameter=value
parameter=value;value;...;

DESCRIPTION

The file apt-dater.conf 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.conf. The default location of this file is $XDG_CONFIG_HOME/apt-dater/hosts.conf.

The syntax of the configuration file is the syntax of glib keyfiles.

OPTIONS

Section [Paths]

HostsFile=$XDG_CONFIG_HOME/apt-dater/hosts.conf

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)

Section [Screen]

Enabled=true

Enables/disables using of screen(1). (optional)

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.

Section [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).

Section [Commands]

CmdRefresh=sudo aptitude update && sudo aptitude -s -y -v upgrade

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

CmdUpgrade=sudo aptitude upgrade

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

CmdInstall=sudo aptitude install %s

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

Section [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

Section [AutoRef]

enabled=true

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

Section [Notify]

bell=true

Enables user notification by terminal bell.

flash=true

Enables user notification by terminal flashing.

Section [History]

record=true

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

Section [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 '%'.


    .PP Table 1. List of supported escapes.

escape replaced by
% escape character
h hostname
m maintainer name
p SSH port number
u SSH username

FILES

apt-dater.conf

The configuration file of apt-dater.

hosts.conf

Contains all hosts you would like to manage.

SEE ALSO

apt-dater(8), aptitude(1), apt-get(1), debtrack, screen(1), script(1), ssh(1), XDG Base Directory Specification[1].

Copyright © 2008-2009 IBH IT-Service GmbH [http://www.ibh.de/]

NOTES

1.
XDG Base Directory Specification
http://www.freedesktop.org/Standards/basedir-spec