summaryrefslogtreecommitdiff
path: root/doc/examples
AgeCommit message (Collapse)AuthorFilesLines
2017-01-17Read dpkg tables to handle architecture wildcardsJulian Andres Klode1-0/+5
Our implementation of wildcards was rudimentary. It worked for some common ones, but it was also broken: For example, armel matched any-armel, but should match any-arm. With this commit, we load the correct tables from dpkg. Supported are both triplets and quadruplet tables (the latter introduced in dpkg 1.18.11). There are some odd things we have to deal with in the cache filter for historical and API reasons: * The character "*" must be accepted as an alternative to any - in fact it may appear anywhere in the wildcard as we also allow fnmatch() style wildcard matching on the commandline. * The code might get passed an arch with a minus at the end, for example the cmdline "install apt:any-arm-" will first try to check if any-arm- is a valid architecture. We deal with this by rejecting any wildcard ending in a minus. * Triplets are actually implemented by extending them to faux quadruplets - by prepending a "base" component for the architecture tuple, and "any" if there is a wildcard component. Once we have constructed a wildcard, it is transformed into an fnmatch() expression for historical reasons. In the future, we should really get a tuple class and implement matching in a better, more explicit way. This does for now though - it passes all the test cases and accepts all things it should accept. Closes: #748936 Thanks: James Clarke <jrtc27@jrtc27.com> for the initial patch
2016-12-31allow warning generation for non-whitelisted optionsDavid Kalnischkies1-243/+523
The idea is simple: Each¹ Find*( call starts with a call check if the given option (with the requested type) exists in the whitelist. The whitelist is specified via our configure-index file so that we have a better chance at keeping it current. the whitelist is loaded via a special (undocumented for now) configuration stanza and if none is loaded the empty whitelist will make it so that no warnings are shown. Much needs to be done still, but that is as good a time as any to take a snapshot of the current state and release it into the wild given that it found some bugs already and has no practical effect on users. ¹ not all in this iteration, but many
2016-11-11add hidden config to set packages as Essential/ImportantDavid Kalnischkies1-1/+6
You can pretty much achieve the same with a local dummy package if you want to, but libapt has an inbuilt setting for essential: "apt" which can be overridden with this option as well – it could be helpful in quick tests and what not so adding this alternative shouldn't really hurt much. We aren't going to document them much through as care must be taken in regards to the binary caches as they aren't invalidated by config options alone, so the effects of old settings could still be in them, similar to the other already existing pkgCacheGen option(s). Closes: 767891 Thanks: Anthony Towns for initial patch
2016-08-06CMake: Add initial support for documentation buildingJulian Andres Klode1-0/+4
Build HTML docbook guides (untranslated) and manual pages (including translations). Also install the examples in the example subdirectory. Translation of docbook guides has not been implemented yet, but should be easy to do. The code also needs some cleanup to automatically detect the available translations.
2016-05-27fix and document on the fly compressor configDavid Kalnischkies2-4/+14
libapt allows to configure compressors to be used by its system via configuration implemented in 03bef78461c6f443187b60799402624326843396, but that was never really documented and also only partly working, which also explains why the tests weren't using it…
2015-12-14mention APT::AutoRemove::{Recommends,Suggests}Important optionAndreas Metzler1-0/+3
Closes: 807413
2015-12-02use @CHANGEPATH@ as placeholder in changelog URI templatesDavid Kalnischkies1-2/+2
This should make it more obvious that CHANGEPATH is a placeholder which apt will replace with a package specific path rather than a string constant. Mail-Reference: <87d1upgvaf.fsf@deep-thought.43-1.org> Mail-Archive: https://lists.debian.org/debian-dak/2015/12/msg00005.html
2015-06-15provide a public interface for acquiring changelogsDavid Kalnischkies1-8/+3
Provided is a specialized acquire item which given a version can figure out the correct URI to try by itself and if not provides an error message alongside with static methods to get just the URI it would try to download if it should just be displayed or similar such. The URI is constructed as follows: Release files can provide an URI template in the "Changelogs" field, otherwise we lookup a configuration item based on the "Label" or "Origin" of the Release file to get a (hopefully known) default value for now. This template should contain the string CHANGEPATH which is replaced with the information about the version we want the changelog for (e.g. main/a/apt/apt_1.1). This middleway was choosen as this path part was consistent over the three known implementations (+1 defunct), while the rest of the URI varies widely between them. The benefit of this construct is that it is now easy to get changelogs for Debian packages on Ubuntu and vice versa – even at the moment where the Changelogs field is present nowhere. Strictly better than what apt-get had before as it would even fail to get changelogs from security… Now it will notice that security identifies as Origin: Debian and pick this setting (assuming again that no Changelogs field exists). If on the other hand security would ship its changelogs in a different location we could set it via the Label option overruling Origin. Closes: 687147, 739854, 784027, 787190
2014-11-05Merge branch 'debian/sid' into debian/experimentalMichael Vogt1-2/+2
Conflicts: debian/changelog
2014-10-22doc/examples/configure-index: make "Dpkg::Max{Arg,ArgBytes} match realityMichael Vogt1-2/+2
Git-Dch: ignore
2014-10-01Use Acquire::Allow{InsecureRepositories,DowngradeToInsecureRepositories}Michael Vogt1-1/+1
The configuration key Acquire::AllowInsecureRepositories controls if apt allows loading of unsigned repositories at all. The configuration Acquire::AllowDowngradeToInsecureRepositories controls if a signed repository can ever become unsigned. This should really never be needed but we provide it to avoid having to mess around in /var/lib/apt/lists if there is a use-case for this (which I can't think of right now).
2014-04-01Merge remote-tracking branch 'mvo/debian/sid' into debian/sidMichael Vogt1-1/+1
2014-04-01Add new Debug::RunScripts optionMichael Vogt1-1/+1
This debug option will display all scripts that are run by apts RunScripts and RunScriptsWithPkgs helpers.
2014-03-27fix documentation for APT::Periodic::MaxSize "0" (closes: #740551)Michael Vogt1-1/+1
2014-02-22Fix typos in documentation (codespell)Michael Vogt1-1/+1
2013-11-30introduce a vendor system to change sources.listDavid Kalnischkies1-8/+0
Many derivatives make quiet a few simple changes to apt introducing silly diffs just to change examples and co making it harder for them to update apt and harder for us to merge real changes back. First stop: doc/examples/sources.list
2013-06-20fix syntax error in the configure-indexDavid Kalnischkies1-1/+1
The file isn't supposed to be a valid config file, but it should show valid syntax non-the-less. Git-Dch: Ignore
2012-06-09* ftparchive/apt-ftparchive.cc:David Kalnischkies1-3/+3
- default to putting the Contents-* files below $(SECTION) as apt-file expects them there - thanks Martin-Éric Racine! (Closes: #675827)
2012-05-26* doc/examples/sources.list:David Kalnischkies2-9/+8
- use the codename instead of 'stable' in the examples sources.list as we do in the manpage and as the debian-installer does
2012-05-25* doc/apt-cdrom.8.xml:Justin B Rye2-2/+2
- replace CDROM with the proper CD-ROM in text
2011-07-25implement MultiarchCross for build-dep and source (Closes: #632221)David Kalnischkies1-0/+1
2011-07-05* doc/apt.conf.5.xml:David Kalnischkies1-0/+1
- document APT::Architectures list (Closes: #612102)
2011-03-10* apt-pkg/contrib/cdromutl.{cc,h}, apt-pkg/cdrom.{cc,h}:Michael Vogt1-1/+4
- deal with missing FSTAB_DIR when using libudev to discover cdrom - add experimental APT::cdrom::CdromOnly option (on by default). When this is set to false apt-cdrom will handle any removable deivce (like a usb-stick) as a "cdrom/dvd" source
2011-02-21doc/examples/configure-index: remove no longer used option NoConfigureMichael Vogt1-1/+0
2011-02-03merge 'after squeeze release'-stuffDavid Kalnischkies1-1/+2
[ David Kalnischkies ] * apt-pkg/depcache.cc: - add SetCandidateRelease() to set a candidate version and the candidates of dependencies if needed to a specified release (Closes: #572709) * cmdline/apt-get.cc: - if --print-uris is used don't setup downloader as we don't need progress, lock nor the directories it would create otherwise - show dependencies of essential packages which are going to remove only if they cause the remove of this essential (Closes: #601961) - keep not installed garbage packages uninstalled instead of showing in the autoremove section and installing those (Closes: #604222) - change pkg/release behavior to use the new SetCandidateRelease so installing packages from experimental or backports is easier - really do not show packages in the extra section if they were requested on the commandline, e.g. with a modifier (Closes: #184730) * debian/control: - add Vcs-Browser now that loggerhead works again (Closes: #511168) - depend on debhelper 7 to raise compat level - depend on dpkg-dev (>= 1.15.8) to have c++ symbol mangling * apt-pkg/contrib/fileutl.cc: - add a RealFileExists method and check that your configuration files are real files to avoid endless loops if not (Closes: #604401) - ignore non-regular files in GetListOfFilesInDir (Closes: #594694) * apt-pkg/contrib/weakptr.h: - include stddefs.h to fix compile error (undefined NULL) with gcc-4.6 * methods/https.cc: - fix CURLOPT_SSL_VERIFYHOST by really passing 2 to it if enabled * deb/dpkgpm.cc: - fix popen/fclose mismatch reported by cppcheck. Thanks to Petter Reinholdtsen for report and patch! (Closes: #607803) * doc/apt.conf.5.xml: - fix multipl{y,e} spelling error reported by Jakub Wilk (Closes: #607636) * apt-inst/contrib/extracttar.cc: - let apt-utils work with encoded tar headers if uid/gid are large. Thanks to Nobuhiro Hayashi for the patch! (Closes: #330162) * apt-pkg/cacheiterator.h: - do not segfault if cache is not build (Closes: #254770) * doc/apt-get.8.xml: - remove duplicated mentioning of --install-recommends * doc/sources.list.5.xml: - remove obsolete references to non-us (Closes: #594495) * debian/rules: - use -- instead of deprecated -u for dh_gencontrol - remove shlibs.local creation and usage - show differences in the symbol files, but never fail * pre-build.sh: - remove as it is not needed for a working 'bzr bd' * debian/{apt,apt-utils}.symbols: - ship experimental unmangled c++ symbol files * methods/rred.cc: - operate optional on gzip compressed pdiffs * apt-pkg/acquire-item.cc: - don't uncompress downloaded pdiff files before feeding it to rred - try downloading clearsigned InRelease before trying Release.gpg - change the internal handling of Extensions in pkgAcqIndex - add a special uncompressed compression type to prefer those files - download and use i18n/Index to choose which Translations to download * cmdline/apt-key: - don't set trustdb-name as non-root so 'list' and 'finger' can be used without being root (Closes: #393005, #592107) * apt-pkg/deb/deblistparser.cc: - rewrite LoadReleaseInfo to cope with clearsigned Releasefiles * ftparchive/writer.cc: - add config option to search for more patterns in release command - include Index files by default in the Release file * methods/{gzip,bzip}.cc: - print a good error message if FileSize() is zero * apt-pkg/aptconfiguration.cc: - remove the inbuilt Translation files whitelist
2011-01-26 - change the internal handling of Extensions in pkgAcqIndexDavid Kalnischkies1-1/+1
- add a special uncompressed compression type to prefer those files * methods/{gzip,bzip}.cc: - print a good error message if FileSize() is zero
2010-11-30add the possibility to disable only the progress reporting stuff as theDavid Kalnischkies1-0/+1
quiet level 1 does this, but also disables other stuff we might want to test against in a testcase
2010-11-18merged from the apt-get-changelog branchMichael Vogt1-3/+4
2010-11-18refactor/simplify changelog fetching codeMichael Vogt1-3/+4
2010-11-18merged lp:~mvo/apt/apt-get-changelog Michael Vogt1-45/+52
2010-11-15doc/examples/configure-index: updated to include apt::changelogs::serverMichael Vogt1-45/+52
2010-10-15* doc/examples/apt-https-method-example.conf:Olly Betts1-5/+5
- apply various typo fixes by Olly Betts, thanks! (Closes: #600249)
2010-09-21doc/examples/configure-index:Michael Vogt1-0/+1
- add info on debug::acquire::cdrom
2010-07-09* doc/apt.conf.5.xml:David Kalnischkies1-1/+3
- add and document APT::Cache-{Start,Grow,Limit} options for mmap control
2010-06-09 - backport forgotten Valid-Until patch from the obsolete experimentalDavid Kalnischkies1-0/+4
branch to prevent replay attacks better, thanks to Thomas Viehmann for the initial patch! (Closes: #499897) * doc/apt.conf.5.xml: - document the new Valid-Until related options * apt-pkg/contrib/strutl.cc: - split StrToTime() into HTTP1.1 and FTP date parser methods and use strptime() instead of some self-made scanf mangling - use the portable timegm shown in his manpage instead of a strange looking code copycat from wget * ftparchive/writer.cc: - add ValidTime option to generate a Valid-Until header in Release file
2010-06-09rename the options, document them and reorder the changelog a bitDavid Kalnischkies1-0/+4
2010-05-28* apt-pkg/deb/debsystem.cc:David Kalnischkies1-2/+1
- add better config item for extended_states file
2010-04-09* apt-pkg/acquire-item.cc:David Kalnischkies1-0/+1
- Acquire::ForceHash to force method for expected hash - display MD5Sum in --print-uris if not forced to use another method instead of displaying the strongest available (Closes: #576420)
2010-04-01merged from lp:~donkult/apt/sidMichael Vogt1-0/+2
2010-03-26* apt-pkg/deb/dpkgpm.cc:Michael Vogt1-0/+1
- fix backgrounding when dpkg runs (closes: #486222) * cmdline/apt-mark: - show error on incorrect aguments (LP: #517917), thanks to Torsten Spindler * cmdline/apt-get.cc: - if apt-get source foo=version or foo/distro can not be found, error out (LP: #502641) * apt-pkg/packagemanager.cc: - better debug output * doc/examples/configure-index: - add missing Debug::pkgPackageManager option
2010-03-21Add with pkgCacheGen::Essential a way to control which packages get theDavid Kalnischkies1-0/+2
essential flag: * native is the default and will only mark packages of the main arch * all will mark all packages which have these flag in Packages * none will obviously do the opposite * installed will only mark packages which are installed as essential, so it will behave in the same way as dpkg does it. It is mostly needed sometimes for debugging but some users with special needs might like to switch the mode as well under the expense to be on their own…
2010-03-16apt-pkg/packagemanager.cc: more debug output for debug::pkgPackageManagerMichael Vogt1-0/+1
2010-02-18* [BREAK] merged lp:~mvo/apt/historyMichael Vogt1-0/+8
- this writes a /var/log/apt/history tagfile that contains details from the transaction (complements term.log) * methods/http.cc: - add cache-control headers even if no cache is given to allow adding options for intercepting proxies - add Acquire::http::ProxyAutoDetect configuration that can be used to call a external helper to figure out the proxy configuration and return it to apt via stdout (this is a step towards WPAD and zeroconf/avahi support) * abicheck/ - add new abitest tester using the ABI Compliance Checker from http://ispras.linuxfoundation.org/index.php/ABI_compliance_checker * Change the package index Info methods to allow apt-cache policy to be useful when using several different archives on the same host. (Closes: #329814, LP: #22354)
2010-02-17merged from debian-sidMichael Vogt2-6/+35
2010-02-13merge with debian-sidDavid Kalnischkies1-0/+11
2010-01-27merge 1695..1701 from the lp:~mvo/apt/mvo branchMichael Vogt1-0/+11
2010-01-26add Dir::Media::MountPath config optionMichael Vogt1-0/+7
2010-01-26add new "Acquire::cdrom::AutoDetect" variable that enables/disablesMichael Vogt1-0/+4
the dlopen of libudev for automatic cdrom detection
2010-01-13merge with lp:~mvo/apt/debian-sid to get 0.7.25.1 and my changes backDavid Kalnischkies1-0/+1
2010-01-09* apt-pkg/deb/debindexfile.cc, apt-pkg/pkgcachegen.cc:Michael Vogt1-0/+1
- add debug option Debug::pkgCacheGen - merge fix for apt-get source pkg=version regression (closes: #561971)