table of contents
rpm2html(1) | General Commands Manual | rpm2html(1) |
NAME¶
rpm2html - make an html database from rpm repositorySYNOPSIS¶
rpm2html [-q][-v][-force][-lang langfile] config-fileDESCRIPTION¶
Rpm2html tries to solve 2 big problems one face when grabbing a RPM package from a mirror on the net and trying to install it:- -
- it gives more information than just the filename before installing the package.
- -
- it tries to solve the dependency problem by analyzing all the Provides and Requires of the set of RPMs. It shows the cross references by the way of hypertext links.
1/ The configuration file is parsed, it sets all the default values for rpm2html. Then all the directory entries are parsed and a list of directories to scan is built.
2/ For each directory, the RPM are scanned, the HTML page describing the package is generated immediately.All resources provided and needed by the RPM file are stored in a list of resources. A list of parsed RPMs is also constructed.
3/ Once all the RPM for this config file have been scanned all resources are dumped in resources files with links to the RPM providing them (one could also add the RPM needing them but everything needs libc for example).
4/ The sorted lists of packages are generated by sorting the RPM list for various criteria and general front-end pages are generated unsing the new list order.
5/ The main page is generated with links to the various front-end pages, statistics and description of the packages analyzed.
6/ All the lists are freed and global variables are reset. rpm2html is now ready to handle the next configuration file.
CONFIGURATION¶
A configuration file a text file, lines beginning with semicolumns are comments. The first part is a global section defining some important parameters of rpm2html. Parameters are defined with the syntax:- variable=value
- maint
- The maintainer of the local mirror, NEEDED !
- The E-mail of the maintainer, NEEDED !
- dir
- The directory for for the HTML output, NEEDED !
- url
- The URL for the HTML files on the WWW server
- host
- The hostname for the server.
- name
- A significant name for this mirror, NEEDED !
- ftp
- The original FTP/HTTP url, NEEDED !
- ftpsrc
- Where the associated sources are stored
- color
- Background color for pages
- trust
- Unused yet
- url
- The local FTP/HTTP url.
EXAMPLE¶
Example of configuration files:; ; Sample configuration file for rpm2html ; maint=Joe mail=joe@mydistrib.org dir=/home/http/html/MyDistrib url=/Mydistrib tree=true rdf=true rdf_dir=/home/ftp/pub/mydistrib/RDF [/MyDistrib/RPM/noarch] name=Arch independent packages for MyDistrib ftp=ftp://ftp.mydistrib.org/pub/mydistrib/noarch subdir=noarch [/MyDistrib/RPM/i386] name=i386 packages for MyDistrib ftp=ftp://ftp.mydistrib.org/pub/mydistrib/i386 ftpsrc=ftp://ftp.mydistrib.org/pub/mydistrib/srcs color=#e0ffff subdir=i386 mirror=ftp://ftp.mydistrib.org/pub/mydistrib/i386 mirror=ftp://ftp.elsewhere.org/pub/mydistrib/i386 [/MyDistrib/RPM/alpha] name=Alpha packages for MyDistrib ftp=ftp://ftp.mydistrib.org/pub/mydistrib/alpha ftpsrc=ftp://ftp.mydistrib.org/pub/mydistrib/srcs color=#ffe0ff subdir=alpha mirror=ftp://ftp.mydistrib.org/pub/mydistrib/alpha mirror=ftp://ftp.elsewhere.org/pub/mydistrib/alpha [/MyDistrib/RPM/sparc] name=Sparc packages for MyDistrib ftp=ftp://ftp.mydistrib.org/pub/mydistrib/sparc ftpsrc=ftp://ftp.mydistrib.org/pub/mydistrib/srcs color=#ffffe0 subdir=sparc [/MyDistrib/RPM/ppc] name=PPC packages for MyDistrib ftp=ftp://ftp.mydistrib.org/pub/mydistrib/ppc ftpsrc=ftp://ftp.mydistrib.org/pub/mydistrib/srcs color=#e0ffe0 subdir=ppc mirror=ftp://ftp.mydistrib.org/pub/mydistrib/ppc mirror=ftp://ftp.pear.com/pub/mydistrib/ppc
OPERANDS¶
The following operands are supported:- files
- List of configuration files
EXIT STATUS¶
The following exit values are returned:- 0
- Successful completion.
- >0
- An error occurred.
SEE ALSO¶
rpm(1),22 Feb 1998 |