--- /dev/null
+ Notes
+ =====
+
+o Please be careful: katie sends out lots of emails and if not
+ configured properly will happily send them to lots of people who
+ probably didn't want those emails.
+
+o Don't use katie.conf, apt.conf, cron.* etc. as starting points for
+ your own configuration files, they're the configuration files for
+ auric (aka ftp-master.debian.org) and are highly Debian specific.
+ Start from scratch and refer to the security.debian.org config files
+ (-security) as they're a better example for a private archive.
+
+o Don't be put off by the names, see doc/README.names for a mapping of
+ name -> what the script does.
+
+ What do all these scripts do?
+ =============================
+
+Generic and generally useful
+----------------------------
+
+o To process queue/:
+
+ * jennifer - processes queue/unchecked
+ * kelly - processes queue/accepted
+ * lisa - processes queue/new and queue/byhand
+
+o To generate indices files:
+
+ * jenna - generates file lists for apt-ftparchive and removes
+ obsolete packages from suites
+ * ziyi - generates Release
+
+o To clean things up:
+
+ * rhona - to remove obsolete files from the pool
+ * shania - to remove obsolete/stray files from the queue
+ * melanie - to remove package(s) from suite(s)
+
+o Information display:
+
+ * madison - shows information about package(s)
+ * helena - shows information about package(s) in queue/
+
+Generic and useful, but only for those with existing archives
+-------------------------------------------------------------
+
+o catherine - migrates packages from legacy locations to the pool
+o neve - initializes a projectb database from an exisiting archive
+
+Generic but not overly useful (in normal use)
+---------------------------------------------
+
+o ashley - dumps info in .katie files
+o julia - sync PostgreSQL users with system users
+o rene - check for obsolete or duplicated packages
+o rose - directory creation in the initial setup of an archive
+o tea - various sanity checks of the database and archive
+o natalie - manpiulates/list override entries
+o heidi - removes/adds/lists package(s) from/to/for a suite
+o saffron - produces various statistics
+
+Semi-generic
+------------
+
+To generate less-used indices files:
+
+o charisma - generates Maintainers file
+o denise - generates override.<foo> files
+
+Mostly Debian(.org) specific
+----------------------------
+
+o amber - wrapper for Debian security team
+o halle - removes obsolete .changes files from proposed-updates
+o jeri - basic dependency checking for proposed-updates
+
+Very Incomplete or otherwise not generally useful
+-------------------------------------------------
+
+o alyson - currently only initializes a DB from a katie.conf config file
+o andrea - looks for version descrepancies that shouldn't exist in many
+ archives
+o cindy - override cruft checker that doesn't work well with New Incoming
+
+Scripts invoked by other scripts
+--------------------------------
+
+o fernanda - invoked by lisa to "check" NEW packages
+o claire - invoked by catherine to determine packages still in legacy locations
+o katie - common code used by lisa, jennifer, kelly and others
+
+ How do I get started?
+ =====================
+
+[Very incomplete - FIXME]
+
+o Write your own katie.conf and apt.conf files
+o Run rose
+o If you have an existing archive:
+ * Run neve
+ otherwise:
+ * Run alyson
+
--- /dev/null
+<!-- -*- mode: sgml; mode: fold -*- -->
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
+
+<!ENTITY % katieent SYSTEM "katie.ent">
+%katieent;
+
+]>
+
+<refentry>
+ &katie-docinfo;
+
+ <refmeta>
+ <refentrytitle>lisa</>
+ <manvolnum>1</>
+ </refmeta>
+
+ <!-- Man page title -->
+ <refnamediv>
+ <refname>lisa</>
+ <refpurpose>Processes BYHAND and NEW packages</>
+ </refnamediv>
+
+ <!-- Arguments -->
+ <refsynopsisdiv>
+ <cmdsynopsis>
+ <command>lisa</>
+ <arg><option><replaceable>options</replaceable></></arg>
+ <arg choice="plain"><replaceable>changes_file</replaceable></arg>
+ <arg><option><replaceable>...</replaceable></option></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <RefSect1><Title>Description</>
+ <para>
+ <command>lisa</command> is the program which installs packages from the accepted directory into the distribution.
+ </PARA></REFSECT1>
+
+ <RefSect1><Title>Options</>
+
+ <VariableList>
+
+ <varlistentry>
+ <term><option>-a/--automatic</option></term>
+ <listitem>
+ <para>Run automatically; i.e. perform the default action if it's possible to do so without user interaction. Intend for use in cron jobs and the like.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-h/--help</option></term>
+ <listitem>
+ <para>Display usage help and then exit.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-m/--manual-reject=<replaceable>message</replaceable></option></term>
+ <listitem>
+ <para>Perform a manual rejection of the package. The <replaceable>message</replaceable> is included in the rejection notice sent to the uploader. If no <replaceable>message</replaceable> is given, an editor will be spawned so one can be added to the rejection notice.
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-n/--no-action</option></term>
+ <listitem>
+ <para>Don't actually install anything; just show what would be done.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-p/--no-lock</option></term>
+ <listitem>
+ <para>Don't check the lockfile. Obviously dangerous and should only be used for cron jobs (if at all).</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-v/--version</option></term>
+ <listitem>
+ <para>Display the version number and then exit.</para>
+ </listitem>
+ </varlistentry>
+
+ </VariableList>
+ </RefSect1>
+
+ <RefSect1><Title>Diagnostics</>
+ <para>
+ <command>lisa</command> returns zero on normal operation, non-zero on error.
+ </PARA>
+ </RefSect1>
+
+ &manauthor;
+
+</refentry>
--- /dev/null
+#!/usr/bin/env python
+
+# Various statistical pr0nography fun and games
+# Copyright (C) 2000, 2001, 2002 James Troup <james@nocrew.org>
+# $Id: saffron,v 1.1 2003-01-02 18:06:19 troup Exp $
+
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+
+################################################################################
+
+import pg, sys;
+import utils;
+import apt_pkg;
+
+################################################################################
+
+Cnf = None;
+projectB = None;
+
+################################################################################
+
+def usage(exit_code=0):
+ print """Usage: saffron STAT
+Print various stats.
+
+ -h, --help show this help and exit.
+
+The following STAT modes are available:
+
+ arch-space - displays space used by each architecture
+ pkg-nums - displays the number of packages by suite/architecture
+ daily-install - displays daily install stats suitable for graphing
+"""
+ sys.exit(exit_code)
+
+################################################################################
+
+def per_arch_space_use():
+ q = projectB.query("""
+SELECT a.arch_string as Architecture, sum(f.size)
+ FROM files f, binaries b, architecture a
+ WHERE a.id=b.architecture AND f.id=b.file
+ GROUP BY a.arch_string""");
+ print q;
+
+################################################################################
+
+def daily_install_stats():
+ stats = {};
+ file = utils.open_file("2001-11");
+ for line in file.readlines():
+ split = line.strip().split('~');
+ program = split[1];
+ if program != "katie":
+ continue;
+ action = split[2];
+ if action != "installing changes" and action != "installed":
+ continue;
+ date = split[0][:8];
+ if not stats.has_key(date):
+ stats[date] = {};
+ stats[date]["packages"] = 0;
+ stats[date]["size"] = 0.0;
+ if action == "installing changes":
+ stats[date]["packages"] += 1;
+ elif action == "installed":
+ stats[date]["size"] += float(split[5]);
+
+ dates = stats.keys();
+ dates.sort();
+ for date in dates:
+ packages = stats[date]["packages"]
+ size = int(stats[date]["size"] / 1024.0 / 1024.0)
+ print "%s %s %s" % (date, packages, size);
+
+################################################################################
+
+def longest(list):
+ longest = 0;
+ for i in list:
+ l = len(i);
+ if l > longest:
+ longest = l;
+ return longest;
+
+def suite_sort(a, b):
+ a_priority = int(Cnf["Suite::%s::Priority" % (a)]);
+ b_priority = int(Cnf["Suite::%s::Priority" % (b)]);
+ return cmp(a_priority, b_priority);
+
+def output_format(suite):
+ output_suite = [];
+ for word in suite.split("-"):
+ output_suite.append(word[0]);
+ return output_suite.join("-");
+
+# Obvious query with GROUP BY and mapped names -> 50 seconds
+# GROUP BY but ids instead of suite/architecture names -> 28 seconds
+# Simple query -> 14 seconds
+# Simple query into large dictionary + processing -> 21 seconds
+# Simple query into large pre-created dictionary + processing -> 18 seconds
+
+def number_of_packages():
+ arches = {};
+ arch_ids = {};
+ suites = {};
+ suite_ids = {};
+ d = {};
+ # Build up suite mapping
+ q = projectB.query("SELECT id, suite_name FROM suite");
+ suite_ql = q.getresult();
+ for i in suite_ql:
+ (id, name) = i;
+ suites[id] = name;
+ suite_ids[name] = id;
+ # Build up architecture mapping
+ q = projectB.query("SELECT id, arch_string FROM architecture");
+ for i in q.getresult():
+ (id, name) = i;
+ arches[id] = name;
+ arch_ids[name] = id;
+ # Pre-create the dictionary
+ for suite_id in suites.keys():
+ d[suite_id] = {};
+ for arch_id in arches.keys():
+ d[suite_id][arch_id] = 0;
+ # Get the raw data for binaries
+ q = projectB.query("""
+SELECT ba.suite, b.architecture
+ FROM binaries b, bin_associations ba
+ WHERE b.id = ba.bin""");
+ # Simultate 'GROUP by suite, architecture' with a dictionary
+ for i in q.getresult():
+ (suite_id, arch_id) = i;
+ d[suite_id][arch_id] = d[suite_id][arch_id] + 1;
+ # Get the raw data for source
+ arch_id = arch_ids["source"];
+ q = projectB.query("""
+SELECT suite, count(suite) FROM src_associations GROUP BY suite;""");
+ for i in q.getresult():
+ (suite_id, count) = i;
+ d[suite_id][arch_id] = d[suite_id][arch_id] + count;
+ ## Print the results
+ # Setup
+ suite_list = suites.values();
+ suite_list.sort(suite_sort);
+ suite_id_list = [];
+ suite_arches = {};
+ for suite in suite_list:
+ suite_id = suite_ids[suite];
+ suite_arches[suite_id] = {};
+ for arch in Cnf.ValueList("Suite::%s::Architectures" % (suite)):
+ suite_arches[suite_id][arch] = "";
+ suite_id_list.append(suite_id);
+ output_list = map(lambda x: output_format(x), suite_list);
+ longest_suite = longest(output_list);
+ arch_list = arches.values();
+ arch_list.sort();
+ longest_arch = longest(arch_list);
+ # Header
+ output = (" "*longest_arch) + " |"
+ for suite in output_list:
+ output = output + suite.center(longest_suite)+" |";
+ output = output + "\n"+(len(output)*"-")+"\n";
+ # per-arch data
+ arch_list = arches.values();
+ arch_list.sort();
+ longest_arch = longest(arch_list);
+ for arch in arch_list:
+ arch_id = arch_ids[arch];
+ output = output + arch.center(longest_arch)+" |";
+ for suite_id in suite_id_list:
+ if suite_arches[suite_id].has_key(arch):
+ count = repr(d[suite_id][arch_id]);
+ else:
+ count = "-";
+ output = output + count.rjust(longest_suite)+" |";
+ output = output + "\n";
+ print output;
+
+################################################################################
+
+def main ():
+ global Cnf, projectB;
+
+ Cnf = utils.get_conf();
+ Arguments = [('h',"help","Saffron::Options::Help")];
+ for i in [ "help" ]:
+ if not Cnf.has_key("Saffron::Options::%s" % (i)):
+ Cnf["Saffron::Options::%s" % (i)] = "";
+
+ args = apt_pkg.ParseCommandLine(Cnf, Arguments, sys.argv);
+
+ Options = Cnf.SubTree("Saffron::Options")
+ if Options["Help"]:
+ usage();
+
+ if len(args) < 1:
+ utils.warn("saffron requires at least one argument");
+ usage(1);
+ elif len(args) > 1:
+ utils.warn("saffron accepts only one argument");
+ usage(1);
+ mode = args[0].lower();
+
+ projectB = pg.connect(Cnf["DB::Name"], Cnf["DB::Host"], int(Cnf["DB::Port"]));
+
+ if mode == "arch-space":
+ per_arch_space_use();
+ elif mode == "pkg-nums":
+ number_of_packages();
+ elif mode == "daily-install":
+ daily_install_stats();
+ else:
+ utils.warn("unknown mode '%s'" % (mode));
+ usage(1);
+
+################################################################################
+
+if __name__ == '__main__':
+ main()
+
projects / dak.git / commitdiff