- initial import of revision 374 from cnc
[apt.git] / contrib / apt-files / README
1
2 Notice
3 ------
4
5 APT-RPM supports translation of filenames to package names internally
6 since version 0.5.15cnc3, but filenames must be in the pkglists for
7 the internal version to work. It means that to access all files in the
8 system pkglists must be built with --bloat, so using this script is
9 still an option.
10
11 What is apt-files?
12 ------------------
13
14 This is a simple APT-RPM plugin allowing one to pass any
15 filename for apt-get, like:
16
17     apt-get install /etc/rc.d/init.d/myservice
18
19 or
20
21     apt-get install /usr/bin/lua
22
23
24 How to use it?
25 --------------
26
27 First, you must create a "database" with the "filename -> pkgname" map.
28 This database is a simple compressed text file with one "filename pkgname"
29 pair per line, with a space separating them. For example:
30
31     /usr/bin/lua lua
32     /usr/bin/apt-get apt-get
33     ...
34
35 You can create these files from an hdlist or from a directory full of
36 rpm files using the convert.py program (you'll need the rpm python
37 module).
38
39 After you created the database, you can install the plugin putting
40 these files in the following directories:
41
42     /etc/apt/apt.conf.d/apt-files.conf
43     /usr/lib/apt/scripts/apt-files.lua
44     /var/state/apt/Contents.gz
45
46 Bingo! It should be working. ;-)
47