dpkg-scansources(1)                                          dpkg suite                                         dpkg-scansources(1)

NAME
       dpkg-scansources - create Sources index files

SYNOPSIS
       dpkg-scansources [option...] binary-dir [override-file [path-prefix]] > Sources

DESCRIPTION
       dpkg-scansources scans the given binary-dir for .dsc files.  These are used to create a Debian source index, which is output
       to stdout.

       The override-file, if given, is used to set priorities in the resulting index records and to override the  maintainer  field
       given  in the .dsc files.  The file can be compressed (since dpkg 1.15.5).  See deb-override(5) for the format of this file.
       Note: Since the override file is indexed by binary, not source packages, there's a  bit  of  a  problem  here.  The  current
       implementation  uses  the highest priority of all the binary packages produced by a .dsc file for the priority of the source
       package, and the override entry for the first binary package listed in the .dsc file to modify maintainer information.  This
       might change.

       The path-prefix, if given, is prepended to the directory field in the generated source index. You generally use this to make
       the directory fields contain the path from the top of the Debian archive hierarchy.

       Note: If you want to access the generated Sources file with apt(8) you will probably need to compress the file with  gzip(1)
       (generating a Sources.gz file). apt ignores uncompressed Sources files except on local access (i.e.  file:// sources).

OPTIONS
       -n, --no-sort
           Don't sort the index records. Normally they are sorted by source package name.

       -e, --extra-override file
           Scan  file  to  find  supplementary  overrides  (since  dpkg 1.15.4; the file can be compressed since dpkg 1.15.5).  See
           deb-extra-override(5) for more information on its format.

       -s, --source-override file
           Use file as the source override file (the file can be compressed since dpkg 1.15.5).  The default is  the  name  of  the
           override file you specified with .src appended.

           The  source  override  file  is  in  a  different  format from the binary override file. It contains only two whitespace
           separated fields, the first is the source package name and the second is the section. Blank lines and comment lines  are
           ignored  in  the  normal manner. If a package appears in both files the source override takes precedence for setting the
           section.

       --debug
           Turn debugging on.

       --help
           Show the usage message and exit.

       --version
           Show the version and exit.

ENVIRONMENT
       DPKG_COLORS
              Sets the color mode (since dpkg 1.18.5).  The currently accepted values are: auto (default), always and never.

       DPKG_NLS
              If set, it will be used to decide whether to activate Native Language Support, also known as internationalization (or
              i18n) support (since dpkg 1.19.0).  The accepted values are: 0 and 1 (default).

SEE ALSO
       deb-override(5), deb-extra-override(5), dpkg-scanpackages(1).

1.19.7                                                       2019-06-03                                         dpkg-scansources(1)

Help output

dpkg-scansources --help

Usage: dpkg-scansources [<option>...] <binary-path> [<override-file> [<path-prefix>]] > Sources

Options:
  -n, --no-sort            don't sort by package before outputting.
  -e, --extra-override <file>
                           use extra override file.
  -s, --source-override <file>
                           use file for additional source overrides, default
                           is regular override file with .src appended.
      --debug              turn debugging on.
  -?, --help               show this help message.
      --version            show the version.

See the man page for the full documentation.

Related Content