.\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "EM_AUTOGRIP 1" .TH EM_AUTOGRIP 1 "2011-03-27" "perl v5.12.3" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" em_autogrip \- create and maintain an Emdebian Grip repository .SH "Synopsis" .IX Header "Synopsis" .Vb 2 \& Syntax: em_autogrip \-b PATH [OPTIONS] [COMMAND [PACKAGES ...]] \& em_autogrip \-?|\-h|\-\-help|\-\-version \& \& Commands: \& \-b|\-\-base\-path PATH: path to the top level grip directory [required] \& \& \-p|\-\-package PACKAGES ... : add binary package(s) to the repository \& \-s|\-\-source PACKAGES ... : add source package(s) to the repository \& \-t|\-\-testing: only work on testing instead of unstable \& \-\-noskipold: reprepro option for newly added packages \& \-\-missing: print a list of missing source packages \& \-\-build\-depends: print a list of missing build dependencies \& \-\-britney: print the status of testing migrations \& \& \-?|\-h|\-\-help|\-\-version: print this help message and exit .Ve .PP Options: \-n|\-\-dry\-run: check which packages would be processed \-m|\-\-mirror \s-1MIRROR:\s0 use a different Debian mirror for setup [default: http://ftp.uk.debian.org/debian] \-\-filter\-name \s-1STRING:\s0 alternative name for the filter repository \-\-grip\-name \s-1STRING:\s0 alternative name for the grip repository \-\-add\-new: if a source package is found to be missing, or outdated in unstable, add it to the list. .SH "Description" .IX Header "Description" The default is to update all the packages so far existing in the filter repository, in all architectures. .PP After adding binary packages, ensure that em_autogrip is run without any options so that any missing source packages and any other Emdebian TDebs can be updated. .PP Although em_autogrip will setup the initial configuration files for the repository, it will not modify any existing files *except* the pkglist filter that prevents the mirror adding unwanted packages. .PP The mirror option only has an effect if there is no repository already found at the specified directory. .PP In particular, em_autogrip will only handle unstable by default. Migrations to testing and stable, even the creation of testing and stable, are not handled by em_autogrip. em_autogrip defaults to including packages into unstable and will only include packages directly into testing in \f(CW\*(C`\-\-testing\*(C'\fR mode when updating to versions of packages uploaded into Debian via testing-proposed-updates or when catching up with a new (or stalled) repository. \f(CW\*(C`\-\-testing\*(C'\fR mode requires a pre-configured testing configuration in \f(CW\*(C`reprepro\*(C'\fR. .PP Public repositories should also use Secure-Apt by adding a value for SignWith: to each distribution in the Grip repository (there is no point signing the filter repository as it should not be public and is merely a filtered copy of existing, officially signed, repositories). .PP em_autogrip also updates the locale repository, shared by Emdebian Grip and Emdebian Crush. .PP Note that em_autogrip will only update the *binary* package(s) specified, even when it includes the full source package. This is down to how reprepro runs the filtered update \- all binary packages expected to be listed in 'dpkg \-\-get\-selections' are included and even if a source package includes another binary, it will not be downloaded in the reprepro update. As em_autogrip does not actually build any packages from source, unless reprepro downloads the pre-built binary into the filter repository, that binary package will not be available to em_autogrip. This means that the same source package in Debian may be listed as generating a *smaller* number of binary packages in Emdebian Grip. .SH "Secure Apt and reprepro" .IX Header "Secure Apt and reprepro" The secret key for the GnuPG key specified with SignWith: needs to be in the secret keyring of each user performing repository updates. .PP To verify the release in update rules, copy \fI/etc/apt/trusted.gpg\fR to \&\fI~/.gnupg/trustedkeys.gpg\fR for all users who need to run updates. To add keys to the list available for \f(CW\*(C`gpgv\*(C'\fR use: .PP .Vb 1 \& C .Ve .SH "Bugs" .IX Header "Bugs" Problems with the automatic gripping of packages: .PP .Vb 6 \& 1. Source packages need to complement binary packages. \& 2. Binary packages with the same name as the source package cause both \& to be included \& 3. Some such binary packages cause unwanted dependencies to be added. \& 4. Some Architecture:all packages are dependencies of packages that only \& exist on some architectures, which breaks the edos\-debcheck. .Ve .PP An example of 3. is lsb. An example of 4. is acpi-support-base. .PP The source package lsb is needed to complement lsb-desktop but the lsb binary package is a meta-package for the entire lsb suite which brings in all of Qt. .PP acpi-support-base is Architecture: all but depends on acpid which is Architecture: any [i386 amd64] \- i.e. acpi-support-base should only exist on i386 and amd64 but as it is Architecture: all, it gets added to arm, armel, mips, mipsel and powerpc as well \- at which point it has to be removed. There are ongoing discussions about such packages. .PP .Vb 1 \& http://lists.debian.org/debian\-devel/2009/01/msg00246.html .Ve .SH "Signal:Noise ratio in output" .IX Header "Signal:Noise ratio in output" One important point here \- reprepro outputs \fBa lot\fR of messages and may include lots of statements about errors and checksum mismatches, \&'skipping foo' and 'downgrading bar' from and to the same version. The problem is that the useful information is hidden within all the noise, so not all reprepro \s-1STDERR\s0 (or \s-1STDOUT\s0) output can be simply ignored. For now, just go by effects. If something is broken, look for errors that relate specifically to that package but ignore \*(L"errors\*(R" where everything is fine. Something like that. More work in the Emdebian::Grip module should isolate duplicate operations and unnecessary work, which in turn, should cut out most of the noise. .SH "Using add-new" .IX Header "Using add-new" In \-\-testing mode, em_autogrip checks for packages that have missing or outdated source packages in unstable and outputs a sample command that can be run to fill the gap. If \-\-add\-new is used, that sample command will be run \- it does mean that \-\-add\-new requires \-\-testing and that a second run of \-\-testing without \-\-add\-new will be needed. This support is part of grip_cron.sh .SH "Build dependencies" .IX Header "Build dependencies" In the absence of a quicker way to identify which real package Provides: a virtual dependency, \fIapt-cache showpkg\fR is used against the main system cache. If this machine is not running Debian unstable, the list may be inaccurate or skip dependencies that are provided by packages that are only available in unstable (or if running stable, packages which are only in unstable or testing). .SH "Repetition" .IX Header "Repetition" If a package fails to build from source in Debian, \f(CW\*(C`em_autogrip\*(C'\fR will keep on trying to update it until the same version exists in the filter repository for all supported architectures. .PP Equally, manual tinkering with packages in the Grip repository, e.g. adding modified versions for testing, will cause the original Debian version to keep appearing in the \f(CW\*(C`em_autogrip\*(C'\fR updates and reprepro will ignore the built package as long as the modified version is higher. .SH "Old packages" .IX Header "Old packages" \&\f(CW\*(C`em_autogrip\*(C'\fR does not handle removals from the archive \- these are manual within Debian too. Packages that only exist in stable or oldstable will confuse \f(CW\*(C`em_autogrip\*(C'\fR, especially if the old package name is 'Provided' by another package which already exists in Grip. e.g. postgresql. .SH "Adding lots of packages in one run" .IX Header "Adding lots of packages in one run" Sometimes, perhaps when setting up a new mirror, a full list of packages already exists on another site. Copying that pkglist into the new site will clear that list as the filter repository on the new site is empty. To avoid this problem, create the pkglist you need, then run the filter update run directly: .PP .Vb 1 \& reprepro \-b /PATH/filter \-v update .Ve .PP Now run \f(CW\*(C`em_autogrip\*(C'\fR without specifying any packages. .PP .Vb 1 \& em_autogrip \-b /PATH/ .Ve .PP Note that \f(CW\*(C`reprepro\*(C'\fR needs the path to the filter directory, \&\f(CW\*(C`em_autogrip\*(C'\fR needs the path to the directory above where it can find \&\fI./filter/\fR, \fI./grip/\fR and \fI./locale/\fR. .PP \&\f(CW\*(C`em_autogrip\*(C'\fR will then update the pkglist file with the final contents of the filter repository. .SH "Ubuntu / non-Debian sources/suites" .IX Header "Ubuntu / non-Debian sources/suites" Emdebian Grip is still Debian, so although non-Debian repositories can be supported, the resulting Grip repository still requires a Debian-like layout. In particular, an 'unstable' suite must exist, even if the codename of that suite is not called 'sid'. Equally, if the repository is to support britney migrations, a suite called 'testing' must exist. .PP Remember, suites will change when a Debian stable release is made (i.e. testing points to something else after the release compared to what it contained before the release). Codenames do not change \- squeeze always contains squeeze, even once squeeze is released as stable. .SH "Architecture list" .IX Header "Architecture list" The list of architectures supported by a particular Grip setup cannot be easily changed \- a lot of repository updates are needed before new architectures can be added to the array. Existing architectures can be dropped relatively easily. Sequence is unimportant. .PP .Vb 1 \& @archlist = qw/i386 amd64 arm armel powerpc mips mipsel/; .Ve .SH "recursive edos considered risky" .IX Header "recursive edos considered risky" Recursion is still risky so edos is left as a manual step. The problem appears to be that once the repository gets out of step with Debian, an update must happen before edos can be resolved. Once the repository is up to date, edos can be run, apparently, without problems. Testing continues to see if simply moving the function lower in the flow resolves the problems. .SH "Copyright and Licence" .IX Header "Copyright and Licence" .Vb 1 \& Copyright (C) 2007\-2010 Neil Williams \& \& This package 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 3 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, see . .Ve