<!DOCTYPE opt SYSTEM 'aptate.dtd' >
<!ELEMENT opt ( topdir ) >
<!ATTLIST opt bad-rpm-mode
( report-only | rename )
"report-only"
>
<!ATTLIST opt bloat
( yes | no )
"yes"
>
<!ATTLIST opt flat
( yes | no )
"yes"
>
<!ATTLIST opt follow
( yes | no )
"no"
>
<!ATTLIST opt old-hashfile
( yes | no )
"yes"
>
<!ATTLIST opt patch-rpm-component
( yes | no )
"yes"
>
<!ATTLIST opt patch-rpm-string
( prpm | patchrpm )
"prpm"
>
<!ATTLIST opt security-component
( yes | no )
"yes"
>
<!ATTLIST opt signed-pkgs-only
( yes | no )
"no"
>
<!ATTLIST opt sign-repository
( yes | no )
"no"
>
<!ATTLIST opt update-rpms
( yes | no )
"no"
>
<!ATTLIST opt verbose
( 0 | 1 | 2 | 3 | 4 )
"3"
>
<!ATTLIST opt wget-tries
NMTOKEN
>
<!ATTLIST opt wget-wait
NMTOKEN
>
root element "options".
An explanation of the attributes belonging to the element "opt".
variable | explanation | cla |
---|---|---|
bad-rpm-mode | The action to be performed on a bad rpm. A bad rpm is an rpm that
fails the command "rpm -q". There are 2 treatments; report-only
and rename.
In both cases the rpm will be excluded from the apt repository. |
yes |
bloat | Provide apt databases with extensive information. It's adviced to activate this on rpm systems. | no |
flat | The location of source rpm components. In a flat repository (flat=yes)
the source rpms are located at the same level as the binary rpms. In non
flat (flat=no) repositories the source rpms are stored 1 directory higher
than the binary rpms.
Aptate has been optimized for flat repositories. Aptate has no problems creating a non flat apt repository that holds only 1 archive. The result in case the non flat repository holds more than 1 archive depends on the way the source rpms are organized in the rpm (not apt) repository. The result may be good may be bad. Anyway, a flat repository seems the right choice for most rpm based distributions. |
no |
follow | Follow symlinks when searching rpms in the rpm repository. This is a dangerous option as the links can lead outside the apt or rpm repository. The apt repository maintainer must ensure this will not happen and must ensure that no endless loops exist in the rpm repository if directories or files are symlinked. | no |
old-hashfile | Provide the apt-rpm version 0.3.19 hashfile for backwards compatibility. | no |
patch-rpm-component | If yes, aptate will look for patch rpms and if found will make a seperate apt component holding patch rpms only, next to the component being processed. Doing so gives the possibility to assign patch rpms a higher priority than regular binary rpms or to exclude them. The component gets the name of the component being processed suffixed with a "patch-rpm-string". The latter is explained as a seperate item. | no |
patch-rpm-string | The suffix that will be added to the component name in case the component provides patch rpms. It is a matter of taste: patchrpms says more than prpm, but hopefully prpms will be as common as srpms... So, the component for patch rpms will be either called RPMS.<component name>-prpm, or RPMS.<component name>-patchrpm. | no |
security-component | If yes, aptate makes an apt repository component providing rpms
that have been released to solve security problems only.
There are many reasons why it's good to have an apt component providing
only security related rpms. This can be because the user is behind a
slow connection, wants to maintain to stable system, etc.
This functionality works now only for SuSE, however it is possible to extend aptate's functionality to get other distributions supported. |
no |
signed-pkgs-only | If yes, aptate will only import rpms into the apt repository, that pass the rpm (gpg) signature check. | no |
sign-repository | If yes, aptate will sign the aptate repository with the name specified in the authorization element. This is usefull in case the apt repository is mirrored and you want to prevent others to sneak in incorrect rpms into your mirrored repository. | no |
update-rpms | If activated new rpm packages will be downloaded from the download server(s) as specified in the component parts of the configuration file. | yes |
verbose | The verboseness of aptate.
|
yes |
wget-tries | This is a wget option. The wget man states: Set number of retries to number. Specify 0 for infinite retrying. |
no |
wget-wait | This is a wget option. The wget man states: Wait the specified number of seconds between the retrievals. Use of this option is recommended, as it lightens the server load by making the requests less frequent. More about the wget wait option in the wget manual. |
no |
variable | explanation | cla |
---|---|---|
id | The unique name of this distribution. This name will be used to select the distribution on the command line, so make it an easy one to remember. | yes |
patch-rpm-component | This is the same option as the patch-rpm-patch option in the <opt> element. The main difference is that the patch-rpm-component option here operates at distribution level. It overwrites the global value that is specified by the patch-rpm-patch argument in the <opt> element. If the patch-rpm-patch argument is not defined here at distribution level the value specified in the <opt> element is used. | no |
process | With this attribute processing of an archive (which is actually a combination of distribution, version and architecture) can be activated or de-activated without the need to remove the configuration data from the configuration file. This may be usefull for archives that e.g. have no update activaty or in case the vendor discontinued the distribution. When processing is de-activated (process="no") the actual apt archive remains to exist, but it will not be updated. If a update is needed the command line argument --dist-id <distribution id> can be used to update the apt repository manually. | yes |
security-component | This is the same option as the security-component option in the <opt> element. The main difference is that the security-component option here operates at distribution level. It overwrites the global value that is specified by the security-component argument in the <opt> element. If the security-component argument is not defined here at distribution level the value specified in the <opt> element is used. | no |
structure | With this element the structure of the apt archive can be set. The following structure types are available:
|
no |
variable | explanation | cla |
---|---|---|
active | This attribute determines if a component is to be used or discarded. With this switch it is possible to de-activate the processing of this component, without removing the data from the configuration file. | no |
list-most-recent | If set to yes a list with the most recent rpms provided by the component is being created. This can be usefull for automatic installation programs, like e.g. autoyast. The list is called contlist.<component name>.bz2 and is stored in the directory "base" of the apt repository | yes |
scan | Activate or de-activate scanning of the rpm directory. De-activating scanning of an rpm directory might be usefull for rpm directories that won't change anymore, are stored on removable media, such as cd, dvd, usb sticks, etc. Scanning can be manually activated from the command line with the argument --scan. | yes |
update-rpms | Activate or de-activate downloading of rpms from the download server for this specific component. | yes *1 |
variable | explanation | cla |
---|---|---|
method | The method to retrieve the url. | no |
variable | explanation | cla |
---|---|---|
continue | This is a wget option.
The wget manual states: continue getting a partially-downloaded file. This is useful when you want to finish up a download started by a previous instance of wget, or by another program. More about the wget continue option in the wget manual. |
no |
cutdirs | This is a wget option.
The wget manual states: Ignore number directory components. This is useful for getting a fine-grained control over the directory where recursive retrieval will be saved. More about the wget cut-dirs option in the wget manual. The rpms being downloaded are stored under the <sharedir>/<dist-id>/update/ plus the directory obtained from the cutdirs action. Important to note; in case this option is used (cutdirs > 0) the wget option -no-host-directories is used by aptate too. |
no |