Commit e7004659 authored by Julian Andres Klode's avatar Julian Andres Klode Committed by Lorenzo "Palinuro" Faletra
Browse files

Import Debian version 2.0.2

apt (2.0.2) unstable; urgency=medium

  [ Boyuan Yang ]
  * Simplified Chinese program translation update (Closes: #955023)

  [ Frans Spiesschaert ]
  * Dutch program translation update (Closes: #955505)

  [ Marco Ippolito ]
  * Fix gramma in apt(8): "by append(+ing) a" (Closes: #955412)

  [ Chris Leick ]
  * German manpage translation update
  * Fix "string match{ing,es}" and whitespace typo in apt-patterns(7)

  [ Julian Andres Klode ]
  * test/integration/apt.pem: Regenerate with SHA2 hashes to make the
    test work with stricter gnutls in Ubuntu which rejects SHA1
  * ubuntu: http: Add non-interactive to user agent if run by systemd
    (LP: #1825000)

apt (2.0.1) unstable; urgency=medium

  [ David Kalnischkies ]
  * Don't crash pattern matching sections if pkg has no section
  * Parse last line in deb file correctly by adding a newline

  [ Julian Andres Klode ]
  * apt-helper: Add analyze-pattern helper
  * Add color highlighting to E:/W:/N: prefixes (Closes: #953527)

  [ Алексей Шилин ]
  * Russian program translation update (Closes: #953804)

apt (2.0.0) unstable; urgency=medium

  * Upload to unstable - Happy APT 2.0 day!
  * GetLock: No strerror if it's just another process holding the lock
  * Show absolute time while waiting for lock instead of %, rework message

apt (1.9.12) experimental; urgency=medium

  * pkgcache: Add operator bool() to map_pointer
  * (temporarily) unhide pkgDPkgPM again to have python-apt compile

apt (1.9.11) experimental; urgency=medium

  [ Tomáš Janoušek ]
  * bash completion: Add autopurge command

  [ Tris Emmy Wilson ]
  * apt-mark: don't lie about successful marks

  [ Julian Andres Klode ]
  * apt(8): Wait for lock (Closes: #754103)
  * policy: Implement pinning by source package (Closes: #166032)
  * Initialize libgcrypt on first use (Closes: #949074)
  * Fix various compiler warnings
  * Bump ABI to 6.0; update symbols file; cleanup ABI:
    - Merge various function overloads together
    - Make stuff that should be virtual virtual
    - Default to hidden visibility
  * Code removals:
    - Use a 32-bit djb VersionHash instead of CRC-16
    - Remove CRC-16 implementation
  * Hardening:
    - tagfile: Check if memchr() returned null before using
    - tagfile: Check out-of-bounds access to Tags vector
  * Cache improvements:
    - Type safe cache: Replace map_pointer_t with map_pointer<T>
    - Extensibility: Add d-pointers to groups, packages, versions, and files
    - Prepare for package hashtable removal: Swap locations of hashtables

  [ Nis Martensen ]
  * apt-pkg/srcrecords.cc: 'source' means 'deb-src' in error message

  [ David Kalnischkies ]
  * Parse records including empty tag names correctly

apt (1.9.10) experimental; urgency=medium

  [ David Kalnischkies ]
  * Fix remaining usec vs sec time-delta calculation typos.
    Thanks to Trent W. Buck for initial patch (Closes: #950776)

  [ Julian Andres Klode ]
  * seccomp: Allow time64 variants (>402,<415) of allowed syscalls
    (Closes: #951012)
  * debian/control: Bump libseccomp-dev Build-Depends to >= 2.4.2
  * seccomp: Allow recvmmsg_time64() and futex_time64()
  * policy: Add SetPriority() methods
  * Revert "Add a Packages-Require-Authorization Release file field"

  [ Michael Vogt ]
  * doc: remove "WIP" from apt.8.xml

apt (1.9.9) experimental; urgency=medium

  * Widen regular expressions for versioned kernel packages (LP: #1607845)
  * Implement short patterns (patterns starting with ~)

apt (1.9.8) experimental; urgency=medium

  * pkgcache.cc: Mix PACKAGE_VERSION into the cache hash
  * mmap: Do not look for empty pool unless we need to
  * apt-verbatim.ent: Update ubuntu-codename from disco to focal
  * NewGroup: Create GrpIterator after allocation (fix segfault)

apt (1.9.7) experimental; urgency=medium

  * Trim trailing whitespace (thanks lintian-brush)
  * NewProvidesAllArch: Check if group is empty before using it.
    This caused automake-1.16 to not be provided by automake anymore,
    because apt wanted to add provides to packages in an empty automake-1.16
    group. LP: #1859952
  * Fix debian-rules-uses-deprecated-systemd-override.
    We accidentally managed to restart apt-daily{,-upgrade}.service
    again because our dh_systemd_start override was being ignored
    since we switched to debhelper 12. Override dh_installsystemd
    instead.

apt (1.9.6) experimental; urgency=medium

  [ Julian Andres Klode ]
  * gitlab-ci: Do not do coverage
  * gitlab-ci: Use ccache
  * satisfy: Fix segmentation fault when called with empty argument
  * Add support for GTest 1.9, do not fail silently if its missing
  * gtests: Fix netrc parser test regression from https-only changes
  * Macro cleanup:
    - Avoid #define _error, use anonymous C++ struct instead (Closes: #948338)
    - Rename _count() macro to APT_ARRAY_SIZE()
    - Remove various unused macros like MAX/MIN/ABS/APT_CONST
    - Only define likely/unlikely if APT_COMPILING_APT set
  * Performance: Avoid extra out-of-cache hash table deduplication for
    package names, this saved about 10-16% on gencaches in memory
  * acquire: Move queue startup after calling log's Start(), fixes abort()
    calls in python-apt
  * hashes: Use Libgcrypt for hashing purposes
    - Raise buffer size for Hashes::AddFD() from 4 KiB to 64 KiB
    - Convert users of {MD5,SHA1,SHA256,SHA512}Summation to use Hashes
    - Deprecate the Summation classes and mark them for removal
    - Remove includes of (md5|sha1|sha2).h headers
  * netrc: Add warning when ignoring entries for unencrypted protocols
  * apt(8): Disable regular expressions and fnmatch

  [ David Kalnischkies ]
  * Drop g++ build-dependency to help crossbuilding (Closes: #948201)

  [ Denis Mosolov ]
  * Fix typo in README.md

apt (1.9.5) experimental; urgency=medium

  [ Julian Andres Klode ]
  * Parse 'show' arguments for the 'info' alias as well (LP: #1843812)
  * patterns: Add base class for regular expression matching
  * patterns: Add ?version
  * patterns: Add ?source-name and ?source-version
  * patterns: Add ?archive
  * patterns: Add ?origin
  * patterns: Add ?any-version
  * patterns: Implement ?narrow(...), as ?any-version(?and(...))
  * patterns: Add ?all-versions
  * patterns: Add ?section
  * netrc: Restrict auth.conf entries to https by default (Closes: #945911)

  [ Anatoly Borodin ]
  * README.md: fix dead anonscm link

  [ Алексей Шилин ]
  * Search in all available description translations (Closes: #490000)
  * strutl: Add APT::String::DisplayLength() function
  * Fix progress bar width for multibyte charsets

  [ Chris Leick ]
  * German manpage translation update

  [ David Kalnischkies ]
  * Use correct filename on IMS-hit reverify for indices
  * Remove failed trusted signature instead of index on IMS hit

  [ Anthony Papillon ]
  * Fix a mistake in man french translation

apt (1.9.4) experimental; urgency=medium

  * CMake: Pass -Werror=return-type to gcc
  * CMake: Produce a fatal error if triehash could not be found
  * apt.systemd.daily: Do not numerically check if intervals equal 0
    (LP: #1840995)
  * srvrec: Use re-entrant resolver functions
  * Pass --abort-after=1 to dpkg when using --force-depends (Closes: #935910)
    (LP: #1844634)
  * Fix use of GTest to adjust for GTest 1.9

apt (1.9.3) experimental; urgency=medium

  * Fix segfault in pkgAcquire::Enqueue() with Acquire::Queue-Mode=access
    (LP: #1839714)
  * test: Use valgrind to ensure Acquire::Queue-Mode=access does not crash
  * Add initial support for package patterns (patterns on versions WIP)

apt (1.9.2) experimental; urgency=medium

  [ Julian Andres Klode ]
  * Improve locking messaging - pid and name, "do not remove lock file"

  [ Lynn Cyrin ]
  * Change a pronoun in the readme from `he` to `they`

  [ David Kalnischkies ]
  * Distribute host-less work based on backlog of the queues
  * Show details about the package with bad Provides
  * Apply various suggestions by cppcheck

apt (1.9.1) experimental; urgency=medium

  * RFC1123StrToTime: Accept const std::string& as first argument
  * Fix pkg-config-test autopkgtest

apt (1.9.0) experimental; urgency=medium

  [ Julian Andres Klode ]
  * CMakeLists.txt: Bump C++ standard version to C++14
  * debian: Update to debhelper-compat (= 12)
  * debian/rules: Do not use dh_install --list-missing (dh 12 porting)
  * Remove all the deprecated bits, merge various function prototypes together
  * prepare-release: Add merge-translations command
  * Use system-provided triehash
  * CI: Use unstable for now, as we need triehash package
  * Tighten dependencies from apt and apt-utils on libs
  * Add test case for local-only packages pinned to never
  * acq: worker: Move CurrentSize, TotalSize, ResumePoint to CurrentItem
  * apt-helper: Support multiple hashes for a file
  * Add 'explicit' to most single argument constructors
  * Get rid of pkgExtract and pkgFLCache
  * Merge libapt-inst into libapt-pkg
  * Use debDebFile to get control file instead of dpkg-deb
  * prepare-release: Add bump-abi command
  * Change soname to libapt-pkg.so.5.90
  * CMake: Enforce "override" use on overridden methods
  * debmetaindex: Use isspace_ascii() variant to normalize Signed-By
  * README.md: Quote -j <count> as code with backticks
  * apt-mark: Add hidden showheld alias for showhold
  * Mnor wording improvements in documentation
  * Make APT::StringView public, replace std::string with it in various places
  * Introduce apt satisfy and apt-get satisfy (Closes: #275379)
  * Run unifdef -DAPT_{8,9,10,15}_CLEANER_HEADERS
  * Adjust code for missing includes, and using std::string
  * Bump cache MajorVersion to 16

  [ Corentin Noël ]
  * Add pkg-config files for the apt-pkg and apt-inst libraries
    (Closes: #439121)

  [ Simon McVittie ]
  * vendor/getinfo: Iterate through vendors in lexicographic order
    (Closes: #924662)
  * vendor/getinfo: Don't assume that Ubuntu is the last vendor
    (Closes: #924662)

  [ Martin Michlmayr ]
  * Perform minor copy-editing on the docs

  [ Ivan Krylov ]
  * Mark apt-transport-https as M-A:foreign (Closes: #905141)

  [ David Kalnischkies ]
  * Don't limit cpu-limited queues to at most 10

  [ Stephen Kitt ]
  * apt-cache: only show solutions if displayed

  [ Brian Murray ]
  * Do not include squashfs file systems in df output. (LP: #1756595)

  [ Simon Körner ]
  * http: Fix Host header in proxied https connections
parent b44474d3
Pipeline #317 failed with stages
in 47 minutes and 9 seconds
include: https://nest.parrotsec.org/parrot-organization/ci/raw/master/deb-build.yml image: debian:unstable
variables:
DEBIAN_FRONTEND: noninteractive
CCACHE_DIR: $CI_PROJECT_DIR/.ccache
CCACHE_BASEDIR: $CI_PROJECT_DIR
cache:
paths:
- .ccache
test as root:
stage: test
script:
- adduser --home /home/travis travis --quiet --disabled-login --gecos "" --uid 1000
- rm -f /etc/dpkg/dpkg.cfg.d/excludes
- apt-get update
- apt-get install -qq build-essential expect sudo ccache
- chmod -R o+rwX $PWD
- ./prepare-release travis-ci
- sudo -u travis mkdir -p build .ccache
- sudo -u travis env -C build cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_COMPILER_LAUNCHER=ccache -DCMAKE_CXX_COMPILER_LAUNCHER=ccache -G Ninja ..
- sudo -u travis --preserve-env=CCACHE_DIR,CCACHE_BASEDIR ninja -C build
- CTEST_OUTPUT_ON_FAILURE=1 ninja -C build test
- unbuffer ./test/integration/run-tests -q -j 4
test as user:
stage: test
script:
- adduser --home /home/travis travis --quiet --disabled-login --gecos "" --uid 1000
- rm -f /etc/dpkg/dpkg.cfg.d/excludes
- apt-get update
- apt-get install -qq build-essential expect sudo ccache
- chmod 755 /root
- chmod -R o+rwX $PWD
- ./prepare-release travis-ci
- sudo -u travis mkdir -p build .ccache
- sudo -u travis env -C build cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_COMPILER_LAUNCHER=ccache -DCMAKE_CXX_COMPILER_LAUNCHER=ccache -G Ninja ..
- sudo -u travis --preserve-env=CCACHE_DIR,CCACHE_BASEDIR ninja -C build
- sudo -u travis CTEST_OUTPUT_ON_FAILURE=1 ninja -C build test
- sudo -u travis unbuffer ./test/integration/run-tests -q -j 4
# - Try to find GCRYPT
# Once done, this will define
#
# GCRYPT_FOUND - system has GCRYPT
# GCRYPT_INCLUDE_DIRS - the GCRYPT include directories
# GCRYPT_LIBRARIES - the GCRYPT library
find_package(PkgConfig)
pkg_check_modules(GCRYPT_PKGCONF libgcrypt)
find_path(GCRYPT_INCLUDE_DIRS
NAMES gcrypt.h
PATHS ${GCRYPT_PKGCONF_INCLUDE_DIRS}
)
find_library(GCRYPT_LIBRARIES
NAMES gcrypt
PATHS ${GCRYPT_PKGCONF_LIBRARY_DIRS}
)
include(FindPackageHandleStandardArgs)
find_package_handle_standard_args(GCRYPT DEFAULT_MSG GCRYPT_INCLUDE_DIRS GCRYPT_LIBRARIES)
mark_as_advanced(GCRYPT_INCLUDE_DIRS GCRYPT_LIBRARIES)
...@@ -64,6 +64,9 @@ ...@@ -64,6 +64,9 @@
/* The mail address to reach upstream */ /* The mail address to reach upstream */
#define PACKAGE_MAIL "${PACKAGE_MAIL}" #define PACKAGE_MAIL "${PACKAGE_MAIL}"
/* Guard for code that should only be emitted when compiling apt */
#define APT_COMPILING_APT
/* Various directories */ /* Various directories */
#cmakedefine CMAKE_INSTALL_FULL_BINDIR "${CMAKE_INSTALL_FULL_BINDIR}" #cmakedefine CMAKE_INSTALL_FULL_BINDIR "${CMAKE_INSTALL_FULL_BINDIR}"
#cmakedefine STATE_DIR "${STATE_DIR}" #cmakedefine STATE_DIR "${STATE_DIR}"
...@@ -81,10 +84,5 @@ ...@@ -81,10 +84,5 @@
#cmakedefine HAVE_FMV_SSE42_AND_CRC32 #cmakedefine HAVE_FMV_SSE42_AND_CRC32
#cmakedefine HAVE_FMV_SSE42_AND_CRC32DI #cmakedefine HAVE_FMV_SSE42_AND_CRC32DI
#define APT_8_CLEANER_HEADERS
#define APT_9_CLEANER_HEADERS
#define APT_10_CLEANER_HEADERS
#define APT_15_CLEANER_HEADERS
/* unrolling is faster combined with an optimizing compiler */ /* unrolling is faster combined with an optimizing compiler */
#define SHA2_UNROLL_TRANSFORM #define SHA2_UNROLL_TRANSFORM
...@@ -11,6 +11,7 @@ include_directories(${PROJECT_BINARY_DIR}/include) ...@@ -11,6 +11,7 @@ include_directories(${PROJECT_BINARY_DIR}/include)
enable_testing() enable_testing()
option(WITH_DOC "Build documentation." ON) option(WITH_DOC "Build documentation." ON)
option(WITH_TESTS "Build tests" ON)
option(USE_NLS "Localisation support." ON) option(USE_NLS "Localisation support." ON)
set(CMAKE_MODULE_PATH "${PROJECT_SOURCE_DIR}/CMake") set(CMAKE_MODULE_PATH "${PROJECT_SOURCE_DIR}/CMake")
...@@ -38,6 +39,12 @@ find_package(Iconv REQUIRED) ...@@ -38,6 +39,12 @@ find_package(Iconv REQUIRED)
find_package(Perl REQUIRED) find_package(Perl REQUIRED)
find_program(TRIEHASH_EXECUTABLE NAMES triehash)
if (NOT TRIEHASH_EXECUTABLE)
message(FATAL_ERROR "Could not find triehash executable")
endif()
if(USE_NLS) if(USE_NLS)
find_package(Intl REQUIRED) find_package(Intl REQUIRED)
link_libraries(${Intl_LIBRARIES}) link_libraries(${Intl_LIBRARIES})
...@@ -50,7 +57,7 @@ add_definitions(${LFS_DEFINITIONS}) ...@@ -50,7 +57,7 @@ add_definitions(${LFS_DEFINITIONS})
link_libraries(${LFS_LIBRARIES}) link_libraries(${LFS_LIBRARIES})
# Set compiler flags # Set compiler flags
set(CMAKE_CXX_STANDARD 11) set(CMAKE_CXX_STANDARD 14)
set(CMAKE_CXX_STANDARD_REQUIRED ON) set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_VISIBILITY_INLINES_HIDDEN 1) set(CMAKE_VISIBILITY_INLINES_HIDDEN 1)
...@@ -69,7 +76,9 @@ add_optional_compile_options(Wnoexcept) ...@@ -69,7 +76,9 @@ add_optional_compile_options(Wnoexcept)
add_optional_compile_options(Wsign-promo) add_optional_compile_options(Wsign-promo)
add_optional_compile_options(Wundef) add_optional_compile_options(Wundef)
add_optional_compile_options(Wdouble-promotion) add_optional_compile_options(Wdouble-promotion)
add_optional_compile_options(Wsuggest-override)
add_optional_compile_options(Werror=suggest-override)
add_optional_compile_options(Werror=return-type)
# apt-ftparchive dependencies # apt-ftparchive dependencies
find_package(BerkeleyDB REQUIRED) find_package(BerkeleyDB REQUIRED)
if (BERKELEY_DB_FOUND) if (BERKELEY_DB_FOUND)
...@@ -125,6 +134,8 @@ if (SECCOMP_FOUND) ...@@ -125,6 +134,8 @@ if (SECCOMP_FOUND)
set(HAVE_SECCOMP 1) set(HAVE_SECCOMP 1)
endif() endif()
find_package(Gcrypt REQUIRED)
# Mount()ing and stat()ing and friends # Mount()ing and stat()ing and friends
check_symbol_exists(statfs sys/vfs.h HAVE_VFS_H) check_symbol_exists(statfs sys/vfs.h HAVE_VFS_H)
check_include_files(sys/params.h HAVE_PARAMS_H) check_include_files(sys/params.h HAVE_PARAMS_H)
...@@ -178,7 +189,7 @@ if (NOT HAVE_SIGHANDLER_T) ...@@ -178,7 +189,7 @@ if (NOT HAVE_SIGHANDLER_T)
endif() endif()
# Handle resolving # Handle resolving
check_function_exists(res_init HAVE_LIBC_RESOLV) check_function_exists(res_ninit HAVE_LIBC_RESOLV)
if(HAVE_LIBC_RESOLV) if(HAVE_LIBC_RESOLV)
set(RESOLV_LIBRARIES) set(RESOLV_LIBRARIES)
else() else()
...@@ -193,7 +204,8 @@ check_cxx_target(HAVE_FMV_SSE42_AND_CRC32DI "sse4.2" "__builtin_ia32_crc32di(0, ...@@ -193,7 +204,8 @@ check_cxx_target(HAVE_FMV_SSE42_AND_CRC32DI "sse4.2" "__builtin_ia32_crc32di(0,
# Configure some variables like package, version and architecture. # Configure some variables like package, version and architecture.
set(PACKAGE ${PROJECT_NAME}) set(PACKAGE ${PROJECT_NAME})
set(PACKAGE_MAIL "APT Development Team <deity@lists.debian.org>") set(PACKAGE_MAIL "APT Development Team <deity@lists.debian.org>")
set(PACKAGE_VERSION "1.8.2") set(PACKAGE_VERSION "2.0.2")
string(REGEX MATCH "^[0-9.]+" PROJECT_VERSION ${PACKAGE_VERSION})
if (NOT DEFINED DPKG_DATADIR) if (NOT DEFINED DPKG_DATADIR)
execute_process(COMMAND ${PERL_EXECUTABLE} -MDpkg -e "print $Dpkg::DATADIR;" execute_process(COMMAND ${PERL_EXECUTABLE} -MDpkg -e "print $Dpkg::DATADIR;"
...@@ -229,7 +241,6 @@ configure_file(CMake/apti18n.h.in ${PROJECT_BINARY_DIR}/include/apti18n.h) ...@@ -229,7 +241,6 @@ configure_file(CMake/apti18n.h.in ${PROJECT_BINARY_DIR}/include/apti18n.h)
add_subdirectory(vendor) add_subdirectory(vendor)
add_subdirectory(apt-pkg) add_subdirectory(apt-pkg)
add_subdirectory(apt-private) add_subdirectory(apt-private)
add_subdirectory(apt-inst)
add_subdirectory(cmdline) add_subdirectory(cmdline)
add_subdirectory(completions) add_subdirectory(completions)
add_subdirectory(doc) add_subdirectory(doc)
......
FROM debian:buster FROM debian:unstable
COPY . /tmp COPY . /tmp
WORKDIR /tmp WORKDIR /tmp
RUN sed -i s#://deb.debian.org#://cdn-fastly.deb.debian.org# /etc/apt/sources.list \ RUN sed -i s#://deb.debian.org#://cdn-fastly.deb.debian.org# /etc/apt/sources.list \
......
APT APT
=== ===
apt is the main commandline package manager for Debian and its derivatives. apt is the main command-line package manager for Debian and its derivatives.
It provides commandline tools for searching and managing as well as querying It provides command-line tools for searching and managing as well as querying
information about packages as well as low-level access to all features information about packages as well as low-level access to all features
provided by the libapt-pkg and libapt-inst libraries which higher-level provided by the libapt-pkg and libapt-inst libraries which higher-level
package managers can depend upon. package managers can depend upon.
...@@ -13,24 +13,24 @@ Included tools are: ...@@ -13,24 +13,24 @@ Included tools are:
from authenticated sources and for installation, upgrade and from authenticated sources and for installation, upgrade and
removal of packages together with their dependencies removal of packages together with their dependencies
* **apt-cache** for querying available information about installed * **apt-cache** for querying available information about installed
as well as installable packages as well as available packages
* **apt-cdrom** to use removable media as a source for packages * **apt-cdrom** to use removable media as a source for packages
* **apt-config** as an interface to the configuration settings * **apt-config** as an interface to the configuration settings
* **apt-key** as an interface to manage authentication keys * **apt-key** as an interface to manage authentication keys
* **apt-extracttemplates** to be used by debconf to prompt for configuration * **apt-extracttemplates** to be used by debconf to prompt for configuration
questions before installation questions before installation
* **apt-ftparchive** creates Packages and other index files * **apt-ftparchive** creates Packages and other index files
needed to publish an archive of debian packages needed to publish an archive of deb packages
* **apt-sortpkgs** is a Packages/Sources file normalizer * **apt-sortpkgs** is a Packages/Sources file normalizer
* **apt** is a high-level commandline interface for better interactive usage * **apt** is a high-level command-line interface for better interactive usage
The libraries libapt-pkg and libapt-inst are also maintained as part of this project, The libraries libapt-pkg and libapt-inst are also maintained as part of this project,
alongside various additional binaries like the acquire-methods used by them. alongside various additional binaries like the acquire methods used by them.
Bindings for Python ([python-apt](https://tracker.debian.org/pkg/python-apt)) and Bindings for Python ([python-apt](https://tracker.debian.org/pkg/python-apt)) and
Perl ([libapt-pkg-perl](https://tracker.debian.org/pkg/libapt-pkg-perl)) are available as separated projects. Perl ([libapt-pkg-perl](https://tracker.debian.org/pkg/libapt-pkg-perl)) are available as separated projects.
Discussion happens mostly on [the mailinglist](mailto:deity@lists.debian.org) ([archive](https://lists.debian.org/deity/)) and on [IRC](irc://irc.oftc.net/debian-apt). Discussion happens mostly on [the mailing list](mailto:deity@lists.debian.org) ([archive](https://lists.debian.org/deity/)) and on [IRC](irc://irc.oftc.net/debian-apt).
Our bugtracker as well as a general overview can be found at the [Debian Tracker page](https://tracker.debian.org/pkg/apt). Our bug tracker as well as a general overview can be found at the [Debian Tracker page](https://tracker.debian.org/pkg/apt).
Contributing Contributing
...@@ -46,7 +46,7 @@ are encouraged to do as well. ...@@ -46,7 +46,7 @@ are encouraged to do as well.
### Coding ### Coding
APT uses cmake. To start building, you need to run APT uses CMake. To start building, you need to run
cmake <path to source directory> cmake <path to source directory>
...@@ -55,15 +55,15 @@ run: ...@@ -55,15 +55,15 @@ run:
cmake . cmake .
Then you can use make as you normally would (pass -j <count> to perform <count> Then you can use make as you normally would (pass `-j <count>` to perform `<count>`
jobs in parallel). jobs in parallel).
You can also use the Ninja generator of cmake, to do that pass You can also use the Ninja generator of CMake, to do that pass
-G Ninja -G Ninja
to the cmake invocation, and then use ninja instead of make. to the cmake invocation, and then use ninja instead of make.
The source code uses in most parts a relatively uncommon indent convention, The source code uses in most parts a relatively uncommon indent convention,
namely 3 spaces with 8 space tab (see [doc/style.txt](https://anonscm.debian.org/git/apt/apt.git/tree/doc/style.txt) for more on this). namely 3 spaces with 8 space tab (see [doc/style.txt](./doc/style.txt) for more on this).
Adhering to it avoids unnecessary code-churn destroying history (aka: `git blame`) Adhering to it avoids unnecessary code-churn destroying history (aka: `git blame`)
and you are therefore encouraged to write patches in this style. and you are therefore encouraged to write patches in this style.
Your editor can surely help you with this, for vim the settings would be Your editor can surely help you with this, for vim the settings would be
...@@ -73,23 +73,23 @@ Your editor can surely help you with this, for vim the settings would be ...@@ -73,23 +73,23 @@ Your editor can surely help you with this, for vim the settings would be
### Translations ### Translations
While we welcome contributions here, we highly encourage you to contact the [Debian Internationalization (i18n) team](https://wiki.debian.org/Teams/I18n). While we welcome contributions here, we highly encourage you to contact the [Debian Internationalization (i18n) team](https://wiki.debian.org/Teams/I18n).
Various language teams have formed which can help you creating, maintaining Various language teams have formed which can help you create, maintain
and improving a translation, while we could only do a basic syntax check of the and improve a translation, while we could only do a basic syntax check of the
file format… file format…
Further more, Translating APT is split into two independent parts: Further more, translating APT is split into two independent parts:
The program translation, meaning the messages printed by the tools, The program translation, meaning the messages printed by the tools,
as well as the manpages and other documentation shipped with APT. as well as the manual pages and other documentation shipped with APT.
### Bug triage ### Bug triage
Software tools like APT which are used by thousands of users every Software tools like APT, which are used by thousands of users every
day have a steady flow of incoming bugreports. Not all of them are really day, have a steady flow of incoming bug reports. Not all of them are really
bugs in APT: It can be packaging bugs like failing maintainer scripts a bugs in APT: It can be packaging bugs, like failing maintainer scripts, that a
user reports against apt, because apt was the command he executed leading user reports against apt, because apt was the command they executed that lead
to this failure or various wishlist items for new features. Given enough time to this failure; or various wishlist items for new features. Given enough time
also the occasional duplicate enters the system. the occasional duplicate enters the system as well.
Our bugtracker is therefore full with open bugreports which are waiting for you! ;) Our bug tracker is therefore full with open bug reports which are waiting for you! ;)
Testing Testing
------- -------
...@@ -101,17 +101,17 @@ automatically inserts an rpath so the binaries find the correct libraries. ...@@ -101,17 +101,17 @@ automatically inserts an rpath so the binaries find the correct libraries.
Note that you have to invoke CMake with the right install prefix set (e.g. Note that you have to invoke CMake with the right install prefix set (e.g.
`-DCMAKE_INSTALL_PREFIX=/usr`) to have your build find and use the right files `-DCMAKE_INSTALL_PREFIX=/usr`) to have your build find and use the right files
by default or alternatively set the locations at runtime via an `APT_CONFIG` by default or alternatively set the locations at run-time via an `APT_CONFIG`
configuration file. configuration file.
### Integration tests ### Integration tests
There is an extensive integration testsuite available which can be run via: There is an extensive integration test suite available which can be run via:
$ ./test/integration/run-tests $ ./test/integration/run-tests
Each test can also be run individually as well. The tests are very noisy by Each test can also be run individually as well. The tests are very noisy by
default, especially so while running all of them it might be beneficial to default, especially so while running all of them; it might be beneficial to
enabling quiet (`-q`) or very quiet (`-qq`) mode. The tests can also be run in enabling quiet (`-q`) or very quiet (`-qq`) mode. The tests can also be run in
parallel via `-j X` where `X` is the number of jobs to run. parallel via `-j X` where `X` is the number of jobs to run.
...@@ -121,7 +121,7 @@ run them on [Travis CI](https://travis-ci.org/) and ...@@ -121,7 +121,7 @@ run them on [Travis CI](https://travis-ci.org/) and
[Shippable](https://shippable.com/) as well as via autopkgtests e.g. on [Shippable](https://shippable.com/) as well as via autopkgtests e.g. on
[Debian Continuous Integration](https://ci.debian.net/packages/a/apt/). [Debian Continuous Integration](https://ci.debian.net/packages/a/apt/).
A testcase here is a shellscript embedded in a framework creating an environment in which A test case here is a shell script embedded in a framework creating an environment in which
apt tools can be used naturally without root-rights to test every aspect of its behavior apt tools can be used naturally without root-rights to test every aspect of its behavior
itself as well as in conjunction with dpkg and other tools while working with packages. itself as well as in conjunction with dpkg and other tools while working with packages.
...@@ -137,24 +137,24 @@ Debugging ...@@ -137,24 +137,24 @@ Debugging
--------- ---------
APT does many things, so there is no central debug mode which could be APT does many things, so there is no central debug mode which could be
activated. It uses instead various config-options to activate debug output activated. Instead, it uses various configuration options to activate debug output
in certain areas. The following describes some common scenarios and generally in certain areas. The following describes some common scenarios and generally
useful options, but is in no way exhaustive. useful options, but is in no way exhaustive.
Note that you should *NEVER* use these settings as root to avoid accidents. Note that, to avoid accidents, you should *NEVER* use these settings as root.
Simulation mode (`-s`) is usually sufficient to help you run apt as a non-root user. Simulation mode (`-s`) is usually sufficient to help you run apt as a non-root user.
### Using different state files ### Using different state files
If a dependency solver bug is reported, but can't be reproduced by the If a dependency solver bug is reported, but can't easily be reproduced by the
triager easily, it is beneficial to ask the reporter for the triager, it is beneficial to ask the reporter for the
`/var/lib/dpkg/status` file, which includes the packages installed on the `/var/lib/dpkg/status` file which includes the packages installed on the
system and in which version. Such a file can then be used via the option system and in which version. Such a file can then be used via the option
`dir::state::status`. Beware of different architecture settings! `dir::state::status`. Beware of different architecture settings!
Bugreports usually include this information in the template. Assuming you Bug reports usually include this information in the template. Assuming you
already have the `Packages` files for the architecture (see `sources.list` already have the `Packages` files for the architecture (see `sources.list`
manpage for the `arch=` option) you can change to a different architecture manpage for the `arch=` option) you can change to a different architecture
with a config file like: with a configuration file like:
APT::Architecture "arch1"; APT::Architecture "arch1";
#clear APT::Architectures; #clear APT::Architectures;
...@@ -173,8 +173,8 @@ APT works in its internal resolver in two stages: First all packages are visited ...@@ -173,8 +173,8 @@ APT works in its internal resolver in two stages: First all packages are visited
and marked for installation, keep back or removal. Option `Debug::pkgDepCache::Marker` and marked for installation, keep back or removal. Option `Debug::pkgDepCache::Marker`
shows this. This also decides which packages are to be installed to satisfy dependencies, shows this. This also decides which packages are to be installed to satisfy dependencies,
which can be seen by `Debug::pkgDepCache::AutoInstall`. After this is done, we might which can be seen by `Debug::pkgDepCache::AutoInstall`. After this is done, we might
be in a situation in which two packages want to be installed, but only on of them can be. be in a situation in which two packages want to be installed, but only one of them can be.
It is the job of the pkgProblemResolver to decide which of two packages 'wins' and can It is the job of the `pkgProblemResolver` to decide which of two packages 'wins' and can
therefore decide what has to happen. You can see the contenders as well as their fight and therefore decide what has to happen. You can see the contenders as well as their fight and
the resulting resolution with `Debug::pkgProblemResolver`. the resulting resolution with `Debug::pkgProblemResolver`.
...@@ -184,13 +184,13 @@ Various binaries (called 'methods') are tasked with downloading files. The Acqui ...@@ -184,13 +184,13 @@ Various binaries (called 'methods') are tasked with downloading files. The Acqui
talks to them via simple text protocol. Depending on which side you want to see, either talks to them via simple text protocol. Depending on which side you want to see, either
`Debug::pkgAcquire::Worker` or `Debug::Acquire::http` (or similar) will show the messages. `Debug::pkgAcquire::Worker` or `Debug::Acquire::http` (or similar) will show the messages.
The integration tests use a simple self-built webserver which also logs. If you find that The integration tests use a simple self-built web server (`webserver`) which also logs. If you find that
the http(s) methods do not behave like they should be try to implement this behavior in the the http(s) methods do not behave like they should be try to implement this behavior in
webserver for simpler and more controlled testing. webserver for simpler and more controlled testing.
### Installation order ### Installation order
Dependencies are solved, packages downloaded: Everything read for the installation! Dependencies are solved, packages downloaded: Everything is ready for the installation!
The last step in the chain is often forgotten, but still very important: The last step in the chain is often forgotten, but still very important:
Packages have to be installed in a particular order so that their dependencies are Packages have to be installed in a particular order so that their dependencies are
satisfied, but at the same time you don't want to install very important and optional satisfied, but at the same time you don't want to install very important and optional
...@@ -207,9 +207,9 @@ Additional documentation ...@@ -207,9 +207,9 @@ Additional documentation
Many more things could and should be said about APT and its usage but are more Many more things could and should be said about APT and its usage but are more
targeted at developers of related programs or only of special interest. targeted at developers of related programs or only of special interest.
* [Protocol specification of APTs communication with external dependency solvers (EDSP)](./doc/external-dependency-solver-protocol.md) * [Protocol specification of APT's communication with external dependency solvers (EDSP)](./doc/external-dependency-solver-protocol.md)
* [Protocol specification of APTs communication with external installation planners (EIPP)](./doc/external-installation-planner-protocol.md) * [Protocol specification of APT's communication with external installation planners (EIPP)](./doc/external-installation-planner-protocol.md)
* [Howto use and configure APT to acquire additional files in 'update' operations](./doc/acquire-additional-files.md) * [How to use and configure APT to acquire additional files in 'update' operations](./doc/acquire-additional-files.md)
* [Download and package installation progress reporting details](./doc/progress-reporting.md) * [Download and package installation progress reporting details](./doc/progress-reporting.md)
* [Remarks on DNS SRV record support in APT](./doc/srv-records-support.md) * [Remarks on DNS SRV record support in APT](./doc/srv-records-support.md)
* [Protocol specification of APT interfacing with external hooks via JSON](./doc/json-hooks-protocol.md) * [Protocol specification of APT interfacing with external hooks via JSON](./doc/json-hooks-protocol.md)
...@@ -8,5 +8,4 @@ ...@@ -8,5 +8,4 @@
<libs> <libs>
@build_path@/apt-pkg/ @build_path@/apt-pkg/
@build_path@/apt-inst/
</libs> </libs>
# Include apt-pkg directly, as some files have #include <system.h>
include_directories(${PROJECT_BINARY_DIR}/include/apt-pkg)
# Set the version of the library
set(MAJOR 2.0)
set(MINOR 0)
set(APT_INST_MAJOR ${MAJOR} PARENT_SCOPE)
# Definition of the C++ files used to build the library - note that this
# is expanded at CMake time, so you have to rerun cmake if you add or remove
# a file (you can just run cmake . in the build directory)
file(GLOB_RECURSE library "*.cc")
file(GLOB_RECURSE headers "*.h")
# Create a library using the C++ files
add_library(apt-inst SHARED ${library})
# Link the library and set the SONAME
target_link_libraries(apt-inst PUBLIC apt-pkg ${CMAKE_THREAD_LIBS_INIT})
target_link_libraries(apt-inst PRIVATE ${CMAKE_THREAD_LIBS_INIT})
set_target_properties(apt-inst PROPERTIES VERSION ${MAJOR}.${MINOR})
set_target_properties(apt-inst PROPERTIES SOVERSION ${MAJOR})
add_version_script(apt-inst)
# Install the library and the headers
install(TARGETS apt-inst LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR})
install(FILES ${headers} DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/apt-pkg)
flatify(${PROJECT_BINARY_DIR}/include/apt-pkg/ "${headers}")
- Replacing directories with files
dpkg permits this with the weak condition that the directory is owned only
by the package. APT requires that the directory have no files that are not
owned by the package. Replaces are specifically not checked to prevent
file list corruption.
// -*- mode: cpp; mode: fold -*-
// Description /*{{{*/
/* ######################################################################
Archive Extraction Directory Stream
Extraction for each file is a bit of an involved process. Each object
undergoes an atomic backup, overwrite, erase sequence. First the
object is unpacked to '.dpkg.new' then the original is hardlinked to
'.dpkg.tmp' and finally the new object is renamed to overwrite the old
one. From an external perspective the file never ceased to exist.
After the archive has been successfully unpacked the .dpkg.tmp files
are erased. A failure causes all the .dpkg.tmp files to be restored.
Decisions about unpacking go like this:
- Store the original filename in the file listing
- Resolve any diversions that would effect this file, all checks
below apply to the diverted name, not the real one.
- Resolve any symlinked configuration files.
- If the existing file does not exist then .dpkg-tmp is checked for.
[Note, this is reduced to only check if a file was expected to be
there]
- If the existing link/file is not a directory then it is replaced
regardless
- If the existing link/directory is being replaced by a directory then
absolutely nothing happens.
- If the existing link/directory is being replaced by a link then
absolutely nothing happens.
- If the existing link/directory is being replaced by a non-directory
then this will abort if the package is not the sole owner of the
directory. [Note, this is changed to not happen if the directory
non-empty - that is, it only includes files that are part of this
package - prevents removing user files accidentally.]
- If the non-directory exists in the listing database and it
does not belong to the current package then an overwrite condition
is invoked.
As we unpack we record the file list differences in the FL cache. If
we need to unroll the FL cache knows which files have been unpacked
and can undo. When we need to erase then it knows which files have not
been unpacked.
##################################################################### */
/*}}}*/
// Include Files /*{{{*/
#include <config.h>
#include <apt-pkg/debversion.h>
#include <apt-pkg/dirstream.h>
#include <apt-pkg/error.h>
#include <apt-pkg/extract.h>
#include <apt-pkg/filelist.h>
#include <apt-pkg/fileutl.h>
#include <apt-pkg/mmap.h>
#include <apt-pkg/pkgcache.h>
#include <iostream>
#include <string>
#include <dirent.h>
#include <errno.h>
#include <stdio.h>
#include <string.h>
#include <sys/stat.h>
#include <apti18n.h>
/*}}}*/
using namespace std;
static const char *TempExt = "dpkg-tmp";
//static const char *NewExt = "dpkg-new";
// Extract::pkgExtract - Constructor /*{{{*/
// ---------------------------------------------------------------------
/* */
pkgExtract::pkgExtract(pkgFLCache &FLCache,pkgCache::VerIterator Ver) :
FLCache(FLCache), Ver(Ver)
{
FLPkg = FLCache.GetPkg(Ver.ParentPkg().Name(),true);
if (FLPkg.end() == true)
return;