Package: dak
Version: 1.0-8
Severity: wishlist
Tags: patch
Hi,
Please, find included a katie.conf-dak (the file you are using as a
template for the package) with more comments. The comments come from
James Troup's /usr/share/doc/dak/README.config.gz. If I add some
more comments later, I will feed this bug report.
Best regards,
Frederic Lehobey
-- System Information:
Debian Release: 3.1
Architecture: sparc (sparc64)
Kernel: Linux 2.6.8-2-sparc64
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Versions of packages dak depends on:
ii apt [libapt-pkg-libc6.3-5-3 0.5.28.6 Advanced front-end for dpkg
ii apt-utils 0.5.28.6 APT utility programs
ii bzip2 1.0.2-7 high-quality block-sorting file co
ii debconf 1.4.30.13 Debian configuration management sy
ii dpkg-dev 1.10.28 Package building tools for Debian
ii exim4-daemon-light [mail-tr 4.50-8 lightweight exim MTA (v4) daemon
ii gnupg 1.4.1-1 GNU privacy guard - a free PGP rep
ii libc6 2.3.2.ds1-22 GNU C Library: Shared libraries an
ii libgcc1 1:3.4.3-13 GCC support library
ii libstdc++5 1:3.3.5-13 The GNU Standard C++ Library v3
ii python 2.3.5-2 An interactive high-level object-o
ii python-apt 0.5.10 Python interface to libapt-pkg
ii python-ldap 2.0.4-1 A LDAP interface module for Python
ii python-pygresql 1:3.6.1-1 PostgreSQL module for Python
ii ucf 1.17 Update Configuration File: preserv
-- debconf information:
* dak/username: deb-dak
* dak/groupname: debadmin
* dak/hostname: localhost.localdomain
* dak/path: /opt/dak
* dak/setup:
* dak/archivename: archive FDL (ondine)
// Dinstall. Mandatory. List of dinstall options.
Dinstall
{
// PGPKeyring and GPGKeyring (required): filenames of the PGP and
// GnuPG keyrings to be used by katie respectively.
// Both need to be defined at the moment, but they can point to the
// same file.
GPGKeyring "@PATH@/keyrings/keyring.gpg";
PGPKeyring "@PATH@/keyrings/keyring.gpg";
// SigningKeyring (optional): this is the private keyring used by
// ziyi.
// To sign the release files. Adjust the keyid!
// Note: Key must be without a passphrase or it wont work
// automagically!
SigningKeyring "@PATH@/s3kr1t/dot-gnupg/secring.gpg";
SigningPubKeyring "@PATH@/s3kr1t/dot-gnupg/pubring.gpg";
SigningKeyIds "CHANGETHISONEFORziyi";
// SendmailCommand (required): command to call the MTA.
SendmailCommand "/usr/sbin/sendmail -odq -oi -t";
// MyEmailAddress (required): this is used as the From: line for
// sending mails as a script/daemon.
MyEmailAddress "@ARCHIVE@ Installer <installer@@HOSTNAME@>";
// MyAdminAddress (required): used as a contact address in mails.
MyAdminAddress "ftpmaster@@HOSTNAME@";
// used for generating [EMAIL PROTECTED] addresses in
// e.g. manual_reject()
MyHost "@HOSTNAME@";
// MyDistribution (required): this variable is used in emails sent
// out by katie and others. It should indicate the name of the
// distribution.
MyDistribution "@ARCHIVE@";
// BugServer (required): is used by katie and melanie when closing
// bugs.
// Alicia and melanie can use it
BugServer "[EMAIL PROTECTED]@";
// PackagesServer (requried): used by melanie when carbon-copying a
// bug close mail to a package maintainer.
PackagesServer "[EMAIL PROTECTED]@";
// TrackingServer (optional): used by katie and melanie to send
// messages for the maintainer also to an alias for people tracking
// a specific source package.
// If defined then the [EMAIL PROTECTED] gets a copy of most of the
// actions related to the package. For an example look at
// packages.qa.debian.org
// TrackingServer "[EMAIL PROTECTED]@";
// LockFile (required): contains the filename of the lockfile used
// by dinstall when in action mode (i.e. not using
// -n/--no-action).
LockFile "@PATH@/katie/lock";
// All sent mail is blind carbon copied to the email address in Bcc
// if it's not blank and defined.
// Bcc "archive@@HOSTNAME@";
// GroupOverrideFilename (optional): this is the override file
// which contains the list of email addresses which, if part of the
// Maintainer field, cause uploads to always be treated as
// maintainer uploads.
// GroupOverrideFilename "override.group-maint";
// FutureTimeTravelGrace (required): specifies how many seconds
// into the future timestamps are allowed to be inside a deb before
// being rejected.
FutureTimeTravelGrace 28800; // 8 hours
// PastCutoffYear (required): specifies the cut-off year which is
// used when deciding whether or not to reject packages based on
// the file timestamp.
PastCutoffYear "1984";
// SkipTime (required): an integer value which is the number of
// seconds that a file must be older than (via it's last modified
// timestamp) before jennifer will REJECT rather than SKIP the
// package.
SkipTime 300;
// CloseBugs (optional): a boolean (default: no); if true the
// automated bug closing feature of dinstall is activated: mails to
// close bugs are sent to the bugserver.
CloseBugs "false";
// OverrideDisparityCheck (optional): a boolean (default: no); if
// true, jennifer compares an uploads section/priority with the
// overrides and whines at the maintainer if they differ.
OverrideDisparityCheck "true";
DefaultSuite "unstable";
Reject
{
NoSourceOnly "true";
};
// If set, only send mails to addresses listed there.
MailWhiteList "@PATH@/katie/mail-whitelist";
// (Unused in this default dak configuration.)
//
// BXANotify (optional): a boolean (default: no); if true
// (Debian-specific) BXA notification is sent. The template for
// the BXA notification is located in
// Dir::Templates/lisa.bxa_notification and should be changed if
// this option is set.
//
// AcceptedAutoBuildSuites (optional): a list of suites which
// should be auto build.
//
// SpecialAcceptedAutoBuild is a boolean; if true it activates
// support for auto-building from accepted.
//
// OverrideMaintainer (optional): be used to globally override the
// __MAINTAINER_TO__ and __MAINTAINER_FROM__ variables in template
// mails. Use with caution.
};
Alicia
{
MyEmailAddress "@ARCHIVE@ FTP Masters <ftpmaster@@HOSTNAME@>";
};
Jennifer{
// If you want Jennifer to run Helena for a NEW overview in HTML
// format set this value to a path. If not - uncomment.
HelenaPath "@PATH@/ftp/new.html";
};
Uma
{
// Should we sent a mail to newly added users?
SendEmail "true";
// Should we create an account so they can login?
// Account will be created with the defaults from adduser, so adjust
// it's configuration to fit your needs.
// NOTE: This requires that your dak user has a sudo entry, allowing
// to run /usr/sbin/useradd!
CreateAccount "true";
// Note: This is a comma separated list of additional groupnames to
// which uma should add the user. NO spaces between the groupnames
// or useradd will die.
// Disable it if you dont want or need that feature.
GID "debuser";
};
Julia
{
// The Primary GID of your users. Using uma it is the gid from group
// users.
ValidGID "800";
// Comma separated list of users who are in Postgres but not the
// passwd file
KnownPostgres "postgres,katie";
};
Shania
{
Options
{
Days 14;
};
MorgueSubDir "shania";
};
Natalie
{
Options
{
Component "main";
Suite "unstable";
Type "deb";
};
// Whether the component is prepended or appended to the section name.
ComponentPosition "prefix";
};
Melanie
{
Options
{
Suite "unstable";
};
MyEmailAddress "@ARCHIVE@ Maintenance <ftpmaster@@HOSTNAME@>";
LogFile "@PATH@/web/removals.txt";
};
Neve
{
ExportDir "@PATH@/katie/neve-files/";
};
Rhona
{
// How long (in seconds) dead packages are left before being killed
StayOfExecution 129600; // 1.5 days
AcceptedAutoBuildStayOfExecution 86400; // 24 hours
MorgueSubDir "rhona";
};
// Suite. Mandatory. List of all suites.
Suite
{
Unstable
{
Components
{
main;
contrib;
};
Architectures
{
source;
all;
alpha;
amd64;
arm;
hppa;
hurd-i386;
i386;
ia64;
m68k;
mips;
mipsel;
powerpc;
s390;
sh;
sparc;
};
// Announce (optional): controls where "Installed foo" mails
// are sent.
Announce "changeslist@@HOSTNAME@";
// CodeName, Origin and Description (optional): This settings
// are used by ziyi and put in the Release files.
Origin "@ARCHIVE@";
Description "@ARCHIVE@";
CodeName "duck";
// OverrideCodeName (optional): used by Denise.
OverrideCodeName "duck";
// Priority (optional) determines which suite is used for the
// Maintainers file as generated by charisma/da_mkmaintainers
// (highest wins).
Priority "7";
// (Unused in this default dak configuration.)
// CopyChanges (optional): if this variable is present it
// should be a path into the archive (i.e. "Dir::RootDir");
// any upload targeted for a suite with this config option
// present will have the .changes file copied into that path.
//
// CopyKatie (optional): if this is present it should be an
// absolute path; any upload targeted for a suite with this
// config option present will have the .katie file copied into
// that path. This option is similar to CopyChanges and will
// most often be used with it; they're seperate because
// .changes files are mirrored and .katie files aren't, so the
// paths will usually be different.
//
// There are more optional variables, such as VersionChecks.
// Please see /usr/share/doc/dak/examples/katie.conf for
// examples.
};
Experimental
{
Components
{
main;
contrib;
};
Architectures
{
source;
all;
alpha;
amd64;
arm;
hppa;
hurd-i386;
i386;
ia64;
m68k;
mips;
mipsel;
powerpc;
s390;
sh;
sparc;
};
// Announce (optional): controls where "Installed foo" mails
// are sent.
Announce "changeslist@@HOSTNAME@";
// CodeName, Origin and Description (optional): This settings
// are used by ziyi and put in the Release files.
Origin "@ARCHIVE@";
Description "Experimental packages - not released; use at your own risk.";
CodeName "experimental";
NotAutomatic "yes";
// OverrideCodeName (optional): used by Denise.
OverrideCodeName "duck";
OverrideSuite "unstable";
// Priority (optional) determines which suite is used for the
// Maintainers file as generated by charisma/da_mkmaintainers
// (highest wins).
Priority "0";
Tree "project/experimental";
// (Unused in this default dak configuration.)
//
// CopyChanges (optional): if this variable is present it
// should be a path into the archive (i.e. "Dir::RootDir");
// any upload targeted for a suite with this config option
// present will have the .changes file copied into that path.
//
// CopyKatie (optional): if this is present it should be an
// absolute path; any upload targeted for a suite with this
// config option present will have the .katie file copied into
// that path. This option is similar to CopyChanges and will
// most often be used with it; they're seperate because
// .changes files are mirrored and .katie files aren't, so the
// paths will usually be different.
// There are more optional variables, such as VersionChecks.
VersionChecks
{
MustBeNewerThan
{
Unstable;
};
};
};
};
// (Unused in this default dak configuration.)
//
// SuiteMappings. Optional. List of mappings for the Distribution
// file in a .changes file, e.g.:
//
// | SuiteMappings
// | {
// | "map stable proposed-updates";
// | "map frozen unstable";
// | "map-unreleased stable unstable";
// | "map-unreleased proposed-updates unstable";
// | "ignore testing";
// | };
//
// There are three mapping types:
//
// (1) map <source> <dest>
//
// Any target suite of '<source>' is unconditionally overriden
// to '<dest>'.
//
// (2) map-unreleased <source> <dest>
//
// Any upload targeted for suite '<source>' will be mapped to
// '<dest>' iff it contains uploads for an architecture that is
// not part of '<source>'.
//
// (3) ignore <suite>
//
// Any target suite of '<suite>' is unconditionally removed from
// the list of target suites. NB: if the upload had only one
// target suite this will lead to rejection.
//
// NB: ordering is not guaranteed.
// Dir. Mandatory. List of directory locations.
Dir
{
// Root (required): Specifies the path of the root of the FTP
// archive.
Root "@PATH@/ftp/";
// Pool (required): This variable specifies the path of the pool
// directory. Debian packages will be placed in the pool by kelly
// after they have been accepted by jennifer.
Pool "@PATH@/ftp/pool/";
// Templates (required): katie sends various mails and uses
// templates from this directory.
Templates "@PATH@/katie/templates/";
// PoolRoot (required): This variable specifies the basename of the
// pool directory.
PoolRoot "pool/";
// Lists (optional): This directory holds file lists used by
// apt-ftparchive to generate Packages and Sources files (used by
// jenna).
Lists "@PATH@/database/dists/";
// Log (required): Log files are put in this directory.
Log "@PATH@/log/";
// Morgue (required): Removed files are moved there. The morgue has
// various sub-directories, including (optionally) those defined by
// Shania::MorgueSubDir and Rhona::MorgueSubDir.
Morgue "@PATH@/morgue/";
// MorgueReject (required): if katie cannot move a rejected package
// to Dir::Queue::Reject, it will try to move it to the
// Dir::MorgueReject directory located under Dir::Morgue.
MorgueReject "reject";
// Override (optional): This directory optionally stores override
// files (used by denise).
Override "@PATH@/scripts/override/";
// UrgencyLog (optional): If this directory is specified, kelly will
// store the urgency value of each upload. This is mainly used for
// britney (the testing script).
UrgencyLog "@PATH@/testing/urgencies/";
// Queue (required): This sub-tree defines important directories for
// the incoming queue. The following variables have to be set:
// Accepted, Byhand Done, Holding, New, Reject, Unchecked. An
// explanation of the function of these directores can be found in
// README.new-incoming.
Queue
{
Accepted "@PATH@/queue/accepted/";
Byhand "@PATH@/queue/byhand/";
Done "@PATH@/queue/done/";
Holding "@PATH@/queue/holding/";
New "@PATH@/queue/new/";
Reject "@PATH@/queue/reject/";
Unchecked "@PATH@/queue/unchecked/";
// Queue::BTSVersionTrack (optional): this directory holds the
// DebBugs Version Tracking support files.
BTSVersionTrack "@PATH@/queue/bts_version_track/";
// (Unused in this default dak configuration.)
// AcceptedAutoBuild (optional): This variable is only relevant if
// any suites are to be auto built, i.e. if
// Dinstall::AcceptedAutoBuildSuites has any values.
};
};
// DB. Essential. List of database details.
DB
{
// Name (required): The name of the PostgreSQL database which has
// been created for katie.
Name "projectb";
// Host (required): The name of the host on which the database is
// located. If the database is local, Host should be blank.
Host "";
// Port (required): The port of the database. If the port is the
// default value (5432), this option should be set to -1.
Port -1;
};
// Architectures. Mandatory. List of all architectures.
Architectures
{
// Both values go into the SQL database's 'architecture' table.
// The description is currently unused.
source "Source";
all "Architecture Independent";
alpha "DEC Alpha";
hurd-i386 "Intel ia32 running the HURD";
hppa "HP PA RISC";
arm "ARM";
i386 "Intel ia32";
ia64 "Intel ia64";
m68k "Motorola Mc680x0";
mips "MIPS (Big Endian)";
mipsel "MIPS (Little Endian)";
powerpc "PowerPC";
s390 "IBM S/390";
sh "Hitatchi SuperH";
sparc "Sun SPARC/UltraSPARC";
amd64 "AMD x86_64 (AMD64)";
};
// Archive. Mandatory. List of all archives.
Archive
{
@HOSTNAME@
{
// OriginServer and PrimaryMirror (required): used melanie's bug
// closing mail templates. The host name and it's OriginServer
// and Description are part of the SQL database in the 'archive'
// table.
OriginServer "@HOSTNAME@";
PrimaryMirror "@HOSTNAME@";
Description "Master Archive for @ARCHIVE@";
};
};
// Component. Mandatory. List of all components
Component
{
// All three values go into the SQL database's 'component' table.
// MeetsDFSG is currently unused.
main
{
Description "Main";
MeetsDFSG "true";
};
contrib
{
Description "Contrib";
MeetsDFSG "true";
};
};
// Section. Mandatory. List of all valid sections.
// The section goes into the 'section' table in SQL database.
Section
{
admin;
base;
comm;
debian-installer;
devel;
doc;
editors;
embedded;
electronics;
games;
gnome;
graphics;
hamradio;
interpreters;
kde;
libdevel;
libs;
mail;
math;
misc;
net;
news;
oldlibs;
otherosfs;
perl;
python;
science;
shells;
sound;
tex;
text;
utils;
web;
x11;
};
// Priority. Mandatory. List of all valid priorities.
// The value is the sorting key. Both the section and it's sorting
// key go into the SQL database's 'priority' table.
Priority
{
required 1;
important 2;
standard 3;
optional 4;
extra 5;
source 0; // i.e. unused
};
// OverrideType. Mandatory. List of al valid override types.
// The type goes into the 'override_type' table in the SQL database.
OverrideType
{
deb;
udeb;
dsc;
};
// Location. Mandatory. List all locations.
// There are three valid values for 'Type': 'legacy', 'legacy-mixed'
// and 'pool'. 'legacy' and 'pool' are assumed to have sections for
// all components listed in the Components section 'legacy-mixed' are
// assumed to mix all components into one location. The 'Archive' and
// 'Type' sections go into the SQL database's 'location' table.
// 'Suites' is a list of existent suites that should be used to
// populate the SQL database.
//
// Note that the archive value specified here must correspond to one
// defined in Archive.
//
// [Note: yes, this is horrible, it dates back to the original `import
// the existent archive into the SQL Database' script (neve)
// and isn't otherwise used. It should be revisited at some
// stage.]
Location
{
// Pool locations on @HOSTNAME@
@PATH@/ftp/pool/
{
Archive "@HOSTNAME@";
Type "pool";
};
};
// Urgency. Mandatory.
// This defines the valid and default urgency of an upload. If a
// package is uploaded with an urgency not listed here, it will be
// rejected.
Urgency
{
Default "low";
Valid
{
low;
medium;
high;
emergency;
critical;
};
};
