1dpkg-scansources(1) dpkg suite dpkg-scansources(1)
2
3
4
6 dpkg-scansources - create Sources index files
7
9 dpkg-scansources [option...] binary-dir [override-file [path-prefix]] >
10 Sources
11
13 dpkg-scansources scans the given binary-dir for .dsc files. These are
14 used to create a Debian source index, which is output to stdout.
15
16 The override-file, if given, is used to set priorities in the resulting
17 index stanzas and to override the maintainer field given in the .dsc
18 files. The file can be compressed (since dpkg 1.15.5). See deb-
19 override(5) for the format of this file.
20
21 Note: Since the override file is indexed by binary, not source
22 packages, there's a bit of a problem here. The current implementation
23 uses the highest priority of all the binary packages produced by a .dsc
24 file for the priority of the source package, and the override entry for
25 the first binary package listed in the .dsc file to modify maintainer
26 information. This might change.
27
28 The path-prefix, if given, is prepended to the directory field in the
29 generated source index. You generally use this to make the directory
30 fields contain the path from the top of the Debian archive hierarchy.
31
32 Note: If you want to access the generated Sources file with apt(8) you
33 will probably need to compress the file with gzip(1) (generating a
34 Sources.gz file). apt(8) ignores uncompressed Sources files except on
35 local access (i.e. file:// sources).
36
38 -n, --no-sort
39 Do not sort the index stanzas. Normally they are sorted by source
40 package name.
41
42 -e, --extra-override file
43 Scan file to find supplementary overrides (since dpkg 1.15.4; the
44 file can be compressed since dpkg 1.15.5). See deb-extra-
45 override(5) for more information on its format.
46
47 -s, --source-override file
48 Use file as the source override file (the file can be compressed
49 since dpkg 1.15.5). The default is the name of the override file
50 you specified with .src appended.
51
52 The source override file is in a different format from the binary
53 override file. It contains only two whitespace separated fields,
54 the first is the source package name and the second is the section.
55 Blank lines and comment lines are ignored in the normal manner. If
56 a package appears in both files the source override takes
57 precedence for setting the section.
58
59 --debug
60 Turn debugging on.
61
62 --help
63 Show the usage message and exit.
64
65 --version
66 Show the version and exit.
67
69 DPKG_COLORS
70 Sets the color mode (since dpkg 1.18.5). The currently accepted
71 values are: auto (default), always and never.
72
73 DPKG_NLS
74 If set, it will be used to decide whether to activate Native
75 Language Support, also known as internationalization (or i18n)
76 support (since dpkg 1.19.0). The accepted values are: 0 and 1
77 (default).
78
80 deb-override(5), deb-extra-override(5), dpkg-scanpackages(1).
81
82
83
841.21.21 2023-02-25 dpkg-scansources(1)