poldek manual

Avaialble reports:

Dependency loops and unmet dependencies

This report allows to verify if package set contain any unsatisfied dependencies and requirements (PreReqs) loops (loop makes impossible to install packages in the right order). This report is called deps and it is the default one, so it is accessible through --verify without an argument. Output example:

$ poldek -n home --verify
Verifying dependency loops...
error: PreReq loop: pam <- coreutils <- pam <- SysVinit
error: PreReq loop: xinitrc <- XFree86 <- xinitrc
2 prerequirement loops detected 

Verifying dependencies...
error: docbook-utils-0.6.13-7: req perl(Getopt::Long) >= 2.01 version mismatch
eog-2.8.2-1: req libexif.so.10 not found
error: ruby-gnome2-0.11.0-2: req ruby-rbogl not found
3 unsatisfied dependencies found
    

Package conflicts

Report prints all package pairs beeing in conflict or beeing obsoleted one another. It lets to verify if all conflicts are needed, what are redundant, and so on. Report is called conflicts. Output example (Obsoletes are printed with asterisk '*'):

$ poldek -n foo --verify=conflicts
Verifying conflicts...
bind-9.2.5-2 -> *maradns-1.1.30-1, *dnsmasq-2.19-1, *pdnsd-1.1.8b1-0.par8.2
maradns-1.1.30-1 -> *bind-9.2.5-2 
login-2.12-15 -> *heimdal-login-0.6.3-2
pdnsd-1.1.8b1-0.par8.2 -> *maradns-1.1.30-1, *maradns-zoneserver-1.1.30-1 
shadow-4.0.4.1-3 -> pwdutils-2.6.90-3
    

File conflicts

Report prints all package pairs beeing in conflict on file level and pairs which share the same file. It lets to verify if all file conflicts are wanted. Report is called file-conflicts:

$ poldek -n foo --verify=file-conflicts
Path: /usr/lib/perl5/vendor_perl/5.8.0/i686-pld-linux-thread-multi/Image
  shr   perl-base-5.8.6-3(D m40755 s4096)  -  ImageMagick-perl-6.1.8.9-1(D m40755 s4096)

Path: /var/log/archiv/mail
  cnfl  syslog-ng-1.6.6-2(D m40755 s4096) <-> zmailer-2.99.56-4(D m40750 s48)

Path: /usr/bin/digest
  cnfl  perl-XMLDigest-0.1-1(F m100755 s1418) <-> nss-tools-3.1-1(F m100755 s32964)
    

'<' and '>' mean missing explicit conflict between packages.

Orphaned directories

Report prints all directories without an owner, i.e. directories not explicit included in packages (a %files section of RPM spec file). In proper package distribution set such directories should not happened. Orphans are created with root's umask and they later cannot be verified by rpm.

Report is called file-orphans:

$ poldek -n foo --verify=file-orphans
error: /etc/X11/dm: orphaned directory from gdm-2.4.4.5-1, gnome-session-2.4.0-1
error: /var/games/phantasia: orphaned directory from bsd-games-2.16-2
    

Missing dependencies

Report helps to avoid rather subtle packaging bugs when one package has files in directories owned by other package which is not requied by the first one.

Report is called file-missing-deps:

$ poldek -n foo --verify=file-missing-deps
GConf-1.0.9-11: /etc/gconf: not in required packages (missing Requires: gnome-utils?)
cups-1.1.19-13: /etc/logrotate.d: not in required packages (missing Requires: logrotate?)
    

--mkidx[=PATH]

Create package index (under SOURCE-PATH by default)

--mt=TYPE[,TYPE]

Set created index type (use --stl to list available values)

--nodesc

Don't put package user-level information (like Summary or Description) into created index.

--nodiff

Don't create index delta files

--nocompress

Create uncompressed index

-s, --source=PATH

Get packages info from repository under PATH

-n, --sn=SOURCE-NAME

Get packages info from repository named SOURCE-NAME

--dn=SOURCE-NAME

Install to source SOURCE-NAME instead to the system

--st=SOURCE-TYPE

Set the source type (use --stl to list available values)

-P, --prefix=PREFIX

Get packages from PREFIX instead of SOURCE

--stl

List available source types

-l, --sl

List configured sources

--update

Update the source and verify it

--update-whole

Update whole index of source

--clean

Remove source index files from cache directory

--clean-pkg

Remove cached packages of the source

--clean-whole

Remove all files belongs to source from cache directory

--pset=FILE

Take package set definition from FILE

--caplookup

Look into package capabilities and files to resolve packages

-i, --install

Install given packages

--reinstall

Reinstall given packages

--downgrade

Downgrade

-u, --upgrade

Upgrade given packages

--install-dist=DIR

Install package set under DIR as root directory

--upgrade-dist[=DIR]

Upgrade all packages needs upgrade

--reinstall-dist[=DIR]

Reinstall all packages under DIR as root directory

--hold=PACKAGE[,PACKAGE]...

Prevent packages listed from being upgraded if they are already installed. If option is not set then packages to hold are taken from hold configuration option. Held package won't be upgraded with exception if it will be pointed directly by the user.

Example:

   $ poldek --hold=kernel\*,dev ...

Configuration option: hold = PACKAGE[,PACKAGE]...

--nohold

Do not hold any packages. Disables --hold settings.

--ignore=PACKAGE[,PACKAGE]...

Make packages listed invisible to the program. If option is not set then packages to ignore are taken from ignore configuration option.

Example:

  $  poldek --ignore=kernel\*-smp\*,foo

Configuration option: ignore = PACKAGE[,PACKAGE]...

--noignore

Make invisibled packages visible. Disables --ignore settings.

-Q, --uniq

Remove package duplicates from available package list

--parsable-tr-summary

Print installation summary in parseable form

--force

Install packages ignoring broken dependencies, conflicts, etc

-t, --test

Do not install packages, but tell if it would work or not. Given once causes poldek's checks only, to perform full tests using rpm;, option must be given twice.

-F, --fresh

Upgrade packages, but only if an earlier version currently exists

-N, --nofollow

Don't install packages required by selected ones

--follow[=[yes|no]]

Install packages required by selected ones

--greedy[=[yes|no]]

Automatically upgrade packages which dependencies are broken by uninstalled ones, for example if package foo is upgraded from version 1.0 to 1.2 and package foo-devel is already installed with requirement "foo = 1.0" then foo-devel will be upgraded to version 1.2 too.

Configuration option: greedy = [yes|no]

--fetch[=DIR]

Download packages to DIR (poldek's cache directory by default)instead of install them

-r, --root=DIR

Set top directory to DIR

--nodeps

Install packages with broken dependencies

-m, --mercy

Be tolerant for unmatched versioned dependencies which rpm; tolerates, e.g. package A requires capability foo >= 1.0 while package B provides "foo" without any version. Use with care.

Configuration option: mercy = [yes|no]

--promoteepoch

Promote non-existent requirement's epoch to package's one (rpm; < 4.2.1 behaviour).

Configuration option: promoteepoch = [yes|no]

--dump[=FILE]

Print packages file names to FILE (stdout by default) instead of install them

--dumpn[=FILE]

Print packages names to FILE (stdout by default) instead of install them

--justdb

Modify only the database

--pm-nodeps

Same as --nodeps but applied to PM (rpm) only

--pm-force

Same as --force but applied to PM (rpm) only)

--pmopt=OPTION

Pass option to package manager (rpm) binary. Example:

    $ poldek --pmopt=ignoreos
   

-e, --erase

Uninstall given packages

-t, --test

Do not remove, but tell if it would work or not

-N, --nofollow

Remove only selected packages

--nodeps

Ignore broken dependencies

--greedy[=[yes|no]]

Remove packages required by selected ones if possible

-V, --verify[=REPORT-TYPE...]

Verify package set, available reports are: 'deps', 'conflicts', 'file-conflicts', 'file-orphans' and 'file-missing-deps'. Default is 'deps'.

--split=SIZE[:FIRST_FREE_SPACE]

Split packages to SIZE MB size chunks, the first chunk will be FIRST_FREE_SPACE MB smaller

--priconf=FILE

Take package priorities from FILE

--split-out=PREFIX

Write chunks to PREFIX.XX, default PREFIX is 'packages.chunk'

--pmcmd=FILE

Use FILE as PM(rpm) binary

--sudocmd=FILE

Use FILE as sudo binary

--cachedir=DIR

DIR points to directory where all downloaded files will be stored. If not set then $TMPDIR is used. If $TMPDIR is not set then $HOME/.poldek-cache is created and used as cache directory

--cmd

Run in command mode (like ipoldek does by default)

--ask

Confirm packages installation and let user choose among equivalent packages

--noask

Don't ask about anything

--shell

Run in interactive mode (default)

--skip-installed

Don't load installed packages at startup

--conf=FILE

Read configuration from FILE

--noconf

Do not read configuration

--upconf

Update remote configuration files (if any)

--version

Display program version information and exit

--log=FILE

Log program messages to FILE

--runas=USER

Run program as user USER

-O=OPTION=VALUE

Can be used to give options in the format used in the configuration file. This is useful for specifying options for which there is no separate command-line flag. Whitespaces in option names may be replaced with underscore '_' or dash '-' there, for example:

$ poldek -O keep-downloads=yes

-v

Be verbose.

-q

Do not produce any output.

[global]

Section contains global paramameters. May be declared multiple times, in this case content of all global sections are concatenated.

[source]

This section contains poldek's repository configuration. Each section describes one repository.

[fetcher]

Configuration of external file getters. Each section declares one external downloader.

default index type

This parameter allows to configure the default repository index type.

Default: default index type = pndir

cachedir

Cache directory for downloaded files. NOTE: that parent directory of cachedir must exists.

Default: cachedir = $HOME/.poldek-cache

runas

Switch to ordinary user at startup when executed by root

Default: runas =

use sudo

Permits using root privileges for installation only. Automatically turned on when poldek executed as ordinary user.

Default: use sudo = no

load apt sources list

Load /etc/apt/sources.list.

Default: load apt sources list = no

vfile external compress

Handle gzipped indexes externally (needed on RedHat 9 and Fedora Core 1 and 2). This option is a workaround for broken zlib linked into librpm; with enabled 'auto zlib in rpm' poldek tries to detect such case and then enables external *.gz handling automatically.

Default: vfile external compress = no

auto zlib in rpm

Auto detection of zlib linked into librpm. See 'vfile external compress' description.

Default: auto zlib in rpm = yes

autoupa

Automatically download whole index if incremental update fails.

Default: autoupa = yes

exclude path

Do not save given paths into created indexes. This option may significantly reduce index size. Example (notice missing starting '/'):

 exclude path = usr/share/doc:usr/share/man:usr/src
    

Default: exclude path =

pm command

Full path name to a PM (rpm for now) binary.

Default: pm command = /bin/rpm

sudo command

Full path name to sudo binary.

Default: sudo command = /usr/bin/sudo

File downloaders configuration

vfile ftp sysuser as anon passwd

Send ${USER}@${HOSTNAME} as anonymous FTP password (by default 'poldek@znienacka.net' is sent)

Default: vfile ftp sysuser as anon passwd = no

default fetcher

File getters configuration parameter. By this option URL handlers may be configured. To get file from HTTP and FTP servers poldek uses its internal client (what is recommended), although it can be changedby this option. Others protocols handled by external utilities can be configured also. The syntax is:

 default fetcher = PROTOCOL[,PROTOCOL...]:FETCHER_NAME
     

where FETCHER_NAME is a name of one of the fetcher preconfigured in [fetch] sections (placed in fetch.conf in default configuration). Examples:

 default fetcher = ftp,http:internal
 default fetcher = https:wget
 default fetcher = cdrom:vfjuggle
     

vfjuggle is a cdrom getter supplied with poldek.

Default: default fetcher = http,ftp: internal

proxy

Proxies for internal FTP and HTTP client may be configured in usual way, by environment variables ftp_proxy and http_proxy, or by this option. Its syntax is similar to "default fetcher" one:

 proxy = PROTOCOL[,PROTOCOL...]:PROXY_URL
    

Example:

 proxy = http: http://w3cache.foo.org:8080
    

Default: proxy =

noproxy

Comma separated list of hosts or domains which will not be accessed via proxy. Option overrides no_proxy environment variable. Example:

 noproxy = localhost, .pl, ftp.foo.bar.org
    

Default: noproxy =

vfile retries

Internal HTTP and FTP client is stubborn, it retries to retrive file if connection breaks. This option tells it how many times it should try.

Default: vfile retries = 128

Installation options

particle install

Install packages in small groups instead of doing all-or-nothing installations.

Default: particle install = yes

keep downloads

Do not remove downloaded packages after its successful installation.

Default: keep downloads = no

unique package names

Controls visibility of multiple package instances with different EVR. If on, only one, highest version will be visible.

Default: unique package names = no

promoteepoch

Epoch autopromotion during dependency comparision. RPM specific. Set it up if you are using system with rpm prior to 4.2.1 version.

Default: promoteepoch = no

confirm installation

Confirm packages installation.

Default: confirm installation = no

confirm removal

Confirm packages removal.

Default: confirm removal = yes

choose equivalents manually

Let the user select package among equivalents.

Default: choose equivalents manually = no

hold

Prevent package listed from being upgraded if they are already installed.

 hold = kernel* dev
    

Default: hold =

ignore

Ignore package list - packages fits given mask will be invisible.

 ignore   = *-smp-* foo*
    

Default: ignore =

allow duplicates

Conflicts with already installed packages are treated as resolved if at least one of multiple-installed package satisfies conflict. rpm doesn't support such cases, so --pm-nodeps is needed (use with care).

Default: allow duplicates = yes

RPM specific options

rpmdef

rpm macros can be set by this option. Examples:

 rpmdef   = _install_langs pl:pl_PL:lt:lt_LT
    

Do not install any documentation:

 rpmdef  = _netsharedpath /usr/share/info:/usr/share/man
 rpmdef  = _excludedocs 1
    

Default: rpmdef =

Dependency processing settings

Subtle dependency processing options, they should not be changed unless you know what you are doing

follow

Automatically install packages required by installed ones.

Default: follow = yes

greedy

Greedy upgrades, i.e. upgrade packages which dependencies are broken by being uninstalled ones.

Default: greedy = yes

aggressive greedy

Be yet more greedy; if successor of orphaned package found, and this successor drags no packages then upgrade the package instead of process its dependencies. Option value is implied by 'greedy' one by defalut.

Default: aggressive greedy = yes

mercy

Be tolerant for unmatched versioned dependencies which rpm tolerates, e.g. package A requires capability foo >= 1.0 while package B provides "foo" without any version. Use with care, it may cause weird dependency errors.

Default: mercy = no

obsoletes

Taking into account package Obsoletes.

Default: obsoletes = yes

conflicts

Taking into account package Conflicts.

Default: conflicts = yes

name

Unique name of the repository.

type

Type of repository index. Permitted values are 'pndir', 'pdir', 'apt', 'yum' and 'dir' as listed by --stl switch.

original type

This parameter sets index original type i.e type of repository from what this repository is created. Default is 'dir' - means that directory of packages is scanned.

Default: original type = dir

path

Unique name of the repository. May be either path or URL.

prefix

If package index and packages are stored in different locations then prefix stands for packages path.

douniq

Controls visibility of multiple package instances with different EVR. If on, only one, highest version will be visible.

Default: douniq = no

pri

Repository priority. If the same packages (equal names and EVR) are available in more than one source then package from highest prioritized source are taken. Priority is numeric value. Lower number means higher priority, and negative priorities are allowed. Priority is numeric value.

Default: pri = 0

auto

Controling if repository index will be implicit loaded. Set it off if the index should be loaded on demand only, i.e. if specified directly by --sn option.

Default: auto = yes

autoup

Controls if repository index will be implicit updated. Set it off if the index should be updated on demand only, i.e. if specified directly by --sn option.

Default: autoup = yes

signed

Packages PGP/GPG signatures (if any) will be verified before their installation.

Default: signed = no

hold

Have the same meaning as [global] parameter. Example:

 hold = kernel* dev
    

Default: hold =

ignore

Have the same meaning as [global] parameter. Example:

 ignore = kernel*smp* dev
    

Default: ignore =

exclude path

Parameter have the same meaning as [global] parameter.

 exclude path = usr/share/doc:usr/share/man:usr/src
    

Default: exclude path =

lang

Preferred language of package descriptions. If not set, taken from locale settings. Example:

 lang = pl_PL:lt_LT
    

name

Unique name of the fetcher. This is an optional parameter, if not set then name is taken from the "cmd" parameter value as "$(basename $cmd)".

proto

Protocol or protocols supported by fetcher. Name of the protocol can be completely arbitrary, i.e. if you can handle protocol "foo" by writing a script which takes URLs in form 'foo://'.

cmd

Parameter specifies an external command and its invoking syntax. The syntax of "cmd" is:

 cmd = COMMAND [ OPTION... ] {%d,%D}  {%p,%P}[n]
    

Where COMMAND is the name or full path of command, OPTION is command specific options. Macro '%d' is replaced with cache directory, '%D' is replaced with 'cache directory/file basename', and '%p' with file basename, %P with file full path (URL). Optional suffix 'n' with %p and %P means that command can be invoked with multiple files at once.