From 14cbf6993b60460516f1b8e8ce7f4704a0f9a51b Mon Sep 17 00:00:00 2001 From: James Troup Date: Wed, 26 Sep 2001 03:45:04 +0000 Subject: [PATCH] sync --- TODO | 7 +- contrib/README | 9 + cron.hourly | 10 ++ docs/README.assumptions | 9 + docs/README.config | 266 +++++++++++++++++++++++++++++ examples/katie.conf | 23 +++ templates/katie.override-disparity | 6 + 7 files changed, 327 insertions(+), 3 deletions(-) create mode 100644 contrib/README create mode 100644 cron.hourly create mode 100644 docs/README.assumptions create mode 100644 docs/README.config create mode 100644 examples/katie.conf diff --git a/TODO b/TODO index 6b9eed42..d3e4e6ee 100644 --- a/TODO +++ b/TODO @@ -66,7 +66,8 @@ Less Urgent o cron.daily* should change umask (aj sucks) o Rene doesn't look at debian-installer but should. o Rene needs to check for binary-less source packages. - o Rene could accept a suite argument + o Rene could accept a suite argument (?) + o run shania every day (?) [ryan] * Bizzare/uncertain: @@ -100,8 +101,9 @@ More Urgent o [Complexish] Secure incoming handling o [Hard] dependency checking (esp. stable) - o Logging + o Logging [mostly done] o Abstraction of suite hardcoding (q.v. progengy) + o morgue needs auto-cleaning Packaging --------- @@ -110,7 +112,6 @@ Packaging o Install config file o Fix stuff to look in sensible places for libs and config file in debian package (?) o man pages and/or documentation - o debian/* assumes arch: all but sql-aptvc.o isn't arch: all. Less Urgent ----------- diff --git a/contrib/README b/contrib/README new file mode 100644 index 00000000..23886888 --- /dev/null +++ b/contrib/README @@ -0,0 +1,9 @@ +This is a collection of patches and fixes/hacks. The fixes/hacks are +very specific to Debian at the time they were written. They are +retained here mostly for hysterical raisans and hysetiria's way of +repeating itself, so I don't have to rewrite these disgusting hacks. +Please don't use them, or better yet, even read them. + +-- +James + diff --git a/cron.hourly b/cron.hourly new file mode 100644 index 00000000..6ef4d5a9 --- /dev/null +++ b/cron.hourly @@ -0,0 +1,10 @@ +#! /bin/sh +# +# Executed hourly via cron, out of troup's crontab. + +set -e +export SCRIPTVARS=/org/ftp.debian.org/katie/vars +. $SCRIPTVARS + +cd $masterdir +julia /var/lib/misc/auric.debian.org/passwd diff --git a/docs/README.assumptions b/docs/README.assumptions new file mode 100644 index 00000000..24faf6e0 --- /dev/null +++ b/docs/README.assumptions @@ -0,0 +1,9 @@ +Assumptions +----------- + +[Incomplete, to be sure] + +Usernames do not contain ",". [aria] +Password files do not contain ":" except as a field separator. [aria] +Version numbers do not contain "~" [logging, charisma] + diff --git a/docs/README.config b/docs/README.config new file mode 100644 index 00000000..67b48752 --- /dev/null +++ b/docs/README.config @@ -0,0 +1,266 @@ +Explanation of configuration files options for katie +==================================================== + +DB +-- + +Essential. List of database details, e.g. + +| DB +| { +| Name "projectb"; +| Host ""; +| Port -1; +| }; + +If the database is local, Host should be blank. If the port is the +default (5432), it should be set to -1. + +================================================================================ + +Dir +--- + +Mandatory. List of directory locations, e.g. + +| Dir +| { +| RootDir "/org/ftp.debian.org/ftp/"; +| PoolDir "/org/ftp.debian.org/ftp/pool/"; +| TemplatesDir "/org/ftp.debian.org/katie/templates/"; +| PoolRoot "pool/"; +| IncomingDir "/org/ftp.debian.org/incoming/"; +| OverrideDir "/org/ftp.debian.org/scripts/override/"; +| ListsDir "/org/ftp.debian.org/database/dists/"; +| LogDir "/org/ftp.debian.org/log/"; +| Morgue "/org/ftp.debian.org/morgue/"; +| }; + +================================================================================ + +Suite +----- + +Mandatory. List of all suites, e.g. + +| Suite +| { +| Unstable +| { +| Components +| { +| main ""; +| }; +| Architectures +| { +| "source" ""; +| "all" ""; +| "i386" ""; +| }; +| Announce "debian-devel-changes@lists.debian.org"; +| Origin "Debian"; +| Description "Debian Unstable - Not Released"; +| CodeName "sid"; +| OverrideCodeName "sid"; +| Priority "5"; +| }; +| }; + +Announce controls where "Installed foo" mails are sent; leave empty to +not send any. CodeName, Origin and Description are used by ziyi and +put in the Release files. OverrideCodeName is used by Denise. +Priority determines which suite is used for the Maintainers file as +generated by charisma/da_mkmaintainers (highest wins). + +================================================================================ + +Dinstall +-------- + +Mandatory. List of dinstall options, e.g.: + +| Dinstall +| { +| PGPKeyring "/org/keyring.debian.org/keyrings/debian-keyring.pgp"; +| GPGKeyring "/org/keyring.debian.org/keyrings/debian-keyring.gpg"; +| SigningKeyring "/org/ftp.debian.org/s3kr1t/dot-gnupg/secring.gpg"; +| MyEmailAddress "Debian Installer "; +| MyAdminAddress "ftpmaster@debian.org"; +| MyHost "debian.org"; // used for generating user@my_host addresses in e.g. manual_reject() +| MyDistribution "Debian"; +| BugServer "bugs.debian.org"; +| PackagesServer "packages.debian.org"; +| NewAckList "/org/ftp.debian.org/katie/log"; +| LockFile "/org/ftp.debian.org/katie/lock"; +| Bcc "archive@ftp-master.debian.org"; +| GroupOverrideFilename "override.group-maint"; +| }; + +PGPKeyring and GPGKeyring are mandatory fields which are filenames of +the PGP and GnuPG keyrings to be used by katie respectively. + +SigningKeyring is the private keyring used by ziyi. + +MyEmailAddress is used as the From: line for sending mails as a +script/daemon. MyAdminAddress is used as a contact address in mails. + +MyDistribution is used in emails sent out by katie and others. + +BugServer is used by katie and melanie when closing bugs. + +PackagesServer is used by melanie when carbon-copying a bug close mail +to a package maintainer. + +NewAckList is a mandatory field and contains the filename of list of +NEW packages dinstall knows about and is used when dinstall is running +in -k/--ack-new mode (usually in the daily cron run). + +LockFile is a mandatory field and contains the filename of the +lockfile used by dinstall when in action mode (i.e. not using +-n/--no-action). + +All sent mail is blind carbon copied to the email +address in Bcc if it's not blank. + +GroupOverrideFilename, if non-blank, 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. + +================================================================================ + +Archive +------- + +Mandatory. List of all archives, e.g. + +| Archive +| { +| ftp-master +| { +| OriginServer "ftp-master.debian.org"; +| PrimaryMirror "ftp.debian.org"; +| Description "Master Archive for the Debian project"; +| }; +| }; + +OriginServer and PrimaryMirror are mandatory and are 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. + +================================================================================ + +Architectures +------------- + +Mandatory. List of all architectures, e.g. + +| Architectures +| { +| source "Source"; +| all "Architecture Independent"; +| i386 "Intel ia32"; +| }; + +Both values go into the SQL database's 'architecture' table. +Description is currently unused. + +================================================================================ + +Component +--------- + +Mandatory. List of all components, e.g. + +| Component +| { +| main +| { +| Description "Main"; +| MeetsDFSG "true"; +| }; +| }; + +All three values go into the SQL database's 'component' table. +MeetsDFSG is currently unused. + +================================================================================ + +Section +------- + +Mandatory. List of all valid sections, e.g. + +| Section +| { +| base ""; +| }; + +The section goes into the 'section' table in SQL database. + +================================================================================ + +Priority +-------- + +Mandatory. List of all valid priorities, e.g. + +| Priority +| { +| required 1; +| important 2; +| standard 3; +| optional 4; +| extra 5; +| source 0; // i.e. unused +| }; + +The value is the sorting key. Both the section and it's sorting key +go into the SQL database's 'priority' table. + +================================================================================ + +OverrideType +------------ + +Mandatory. List of al valid override types, e.g. + +| OverrideType +| { +| deb ""; +| dsc ""; +| udeb ""; +| }; + +The type goes into the 'override_type' table in the SQL database. + +================================================================================ + +Location +-------- + +Mandatory. List all locations, e.g. + +| Location +| { +| /org/ftp.debian.org/ftp/pool/ +| { +| Archive "ftp-master"; +| Type "pool"; +| }; +| }; + +There are three types: '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. + +[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 revisted at some stage.] + +================================================================================ + +-- +James Troup , Horsforth, Leeds +Wed, 26 Sep 2001 03:20:39 +0100 diff --git a/examples/katie.conf b/examples/katie.conf new file mode 100644 index 00000000..76e0a9a6 --- /dev/null +++ b/examples/katie.conf @@ -0,0 +1,23 @@ +// Example /etc/katie/katie.conf + +Config +{ + // FQDN hostname + auric.debian.org + { + + // Optional hostname as it appears in the database (if it differs + // from the FQDN hostname). + DatbaseHostname "ftp-master"; + + // Optional filename of katie's config file; if not present, this + // file is assumed to contain katie config info. + KatieConfig "/org/ftp.debian.org/katie/katie.conf"; + + // Optional filename of apt-ftparchive's config file; if not + // present, the file is assumed to be 'apt.conf' in the same + // directory as this file. + AptConfig "/org/ftp.debian.org/katie/apt.conf"; + } + +} diff --git a/templates/katie.override-disparity b/templates/katie.override-disparity index 1aa66a5f..24d23ff2 100644 --- a/templates/katie.override-disparity +++ b/templates/katie.override-disparity @@ -12,6 +12,12 @@ the override is correct and the package wrong please fix the package so that this disparity is fixed in the next upload. If you feel the override is incorrect then please reply to this mail and explain why. +[NB: this is an automatically generated mail; if you replied to one +like it before and have not received a response yet, please ignore +this mail. Your reply needs to be processed by a human and will be in +due course, but until then the installer will send these automated +mails; sorry.] + -- __DISTRO__ distribution maintenance software -- 2.39.2