The rpm Reference Manual

Table of Contents

The rpm Reference Manual

This is the rpm Reference Manual, version 0.0.2, generated automatically by Declt version 2.4 "Will Decker" on Wed Jun 20 12:31:46 2018 GMT+0.

1 Introduction

RPM

This library allows you to manipulate RPM packages from CL.


==== Exported Functionality ====

The rpm library creates a package RPM,
that exports the following macros and functions:

PARSE-RPM-VERSIONED-NAME STRING &KEY START END
  parses the STRING (within START and END bounds)
  as an rpm versioned package name, returning as multiple values two strings,
  one for the base package name and the other for epoch, version and release.
  e.g. "foo-1.4-6" ==> "foo" "1.4-6"

RPM-VERSIONED-NAME-BASENAME STRING
  from a rpm versioned package name, extract the base package name.
  e.g. "foo-1.4-6" ==> "foo"

RPM-VERSIONED-NAME-VERSION STRING
  from a rpm versioned package name, extract the epoch, version and release.
  e.g. "foo-1.4-6" ==> "1.4-6"

PARSE-RPM-PATHNAME PATHNAME
  from the designator of a pathname to a RPM, extract as multiple values:
  * the pathname of the parent directory
  * the base name of the package
  * the epoch:version-release string
  * the architecture
  e.g. "/tmp/foo-1.4-6.x86_64.rpm" ==> #P"/tmp/" "foo" "1.4-6" "x86_64"

RPM-PATHNAME-PACKAGENAME PATHNAME
  from the designator of a pathname to a RPM,
  extract the base name of the package
  e.g. "/tmp/foo-1.4-6.x86_64.rpm" ==> "foo"

RPM-PATHNAME-VERSION PATHNAME
  from the designator of a pathname to a RPM,
  extract the epoch:version-release string
  e.g. "/tmp/foo-1.4-6.x86_64.rpm" ==> "1.4-6"

RPM-VERSION= V1 V2
RPM-VERSION<= V1 V2
RPM-VERSION< V1 V2
RPM-VERSION>= V1 V2
RPM-VERSION> V1 V2
  compares the two given epoch:version-release strings,
  and returns T if the first is respectively
  equal, lesser or equal, lesser, greater or equal, or greater
  than the second one as far as RPM is concerned.

RPMS-INSTALLED &KEY PACKAGENAMES HOST
  return a list of versioned packagenames for the RPM packages installed
  on specified HOST (default: NIL, denoting current host),
  that match the list of names specified in PACKAGENAMES,
  or all packages if PACKAGENAMES is T (the default).

RPMS-TO-UPDATE DESIRED-RPMS &KEY HOST TEST
  given a list of DESIRED-RPMS of pathnames to RPM packages,
  a host HOST (default NIL, denoting current host),
  a test TEST (default RPM-VERSION<=, allowing newer versions than desired),
  return a list of the RPMs to install so all RPMs of given packagenames
  will be install and of a version satisfying the test with the desired version.
  With the default test RPM-VERSION<= this means that the desired RPM won't be
  listed if an existing more recent version is installed, whereas if you supply
  :TEST RPM-VERSION= then the desired RPM will only be skipped if
  an exact matching version is already installed.

2 Systems

The main system appears first, followed by any subsystem dependency.

2.1 rpm

Author

Francois-Rene Rideau

License

MIT

Description

functions to use the RedHat Package Management system

Version

0.0.2

Dependencies

• inferior-shell
• lambda-reader
• cl-ppcre
• fare-utils (at least version 1.0.0.5)

Source

rpm.asd (file)

Components

• pkgdcl.lisp (file)
• specials.lisp (file)
• version.lisp (file)
• upgrade.lisp (file)

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.

3.1 Lisp

3.1.1 rpm.asd

Location

rpm.asd

Systems

rpm (system)

3.1.2 rpm/pkgdcl.lisp

Parent

rpm (system)

Location

pkgdcl.lisp

Packages

rpm

3.1.3 rpm/specials.lisp

Dependency

pkgdcl.lisp (file)

Parent

rpm (system)

Location

specials.lisp

Internal Definitions

• *rpm-architecture* (special variable)
• asdf-to-rpm-architecture (function)

3.1.4 rpm/version.lisp

Dependency

pkgdcl.lisp (file)

Parent

rpm (system)

Location

version.lisp

Exported Definitions

• parse-rpm-pathname (function)
• parse-rpm-version (function)
• parse-rpm-versioned-name (function)
• rpm-pathname-packagename (function)
• rpm-pathname-version (function)
• rpm-version< (function)
• rpm-version<= (function)
• rpm-version= (function)
• rpm-version> (function)
• rpm-version>= (function)
• rpm-versioned-name-basename (function)
• rpm-versioned-name-version (function)

Internal Definitions

• compare-rpm-version-chunks (function)
• compare-rpm-version-components (function)
• compare-rpm-versions (function)
• parse-rpm-version-component (function)
• valid-rpm-architecture-component-p (function)
• valid-rpm-version-component-p (function)

3.1.5 rpm/upgrade.lisp

Dependency

pkgdcl.lisp (file)

Parent

rpm (system)

Location

upgrade.lisp

Exported Definitions

• hash-rpm-pathnames-by-packagename (function)
• hash-rpm-versioned-names-by-name (function)
• rpms-installed (function)
• rpms-to-update (function)

4 Packages

Packages are listed by definition order.

4.1 rpm

Source

pkgdcl.lisp (file)

Use List

• uiop/driver
• fare-utils
• λ-reader
• inferior-shell
• common-lisp

Exported Definitions

• hash-rpm-pathnames-by-packagename (function)
• hash-rpm-versioned-names-by-name (function)
• parse-rpm-pathname (function)
• parse-rpm-version (function)
• parse-rpm-versioned-name (function)
• rpm-pathname-packagename (function)
• rpm-pathname-version (function)
• rpm-version< (function)
• rpm-version<= (function)
• rpm-version= (function)
• rpm-version> (function)
• rpm-version>= (function)
• rpm-versioned-name-basename (function)
• rpm-versioned-name-version (function)
• rpms-installed (function)
• rpms-to-update (function)

Internal Definitions

• *rpm-architecture* (special variable)
• asdf-to-rpm-architecture (function)
• compare-rpm-version-chunks (function)
• compare-rpm-version-components (function)
• compare-rpm-versions (function)
• parse-rpm-version-component (function)
• valid-rpm-architecture-component-p (function)
• valid-rpm-version-component-p (function)

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.

5.1 Exported definitions

5.1.1 Functions

Function: hash-rpm-pathnames-by-packagename RPM-LIST

Package

rpm

Source

upgrade.lisp (file)

Function: hash-rpm-versioned-names-by-name RPM-LIST

Package

rpm

Source

upgrade.lisp (file)

Function: parse-rpm-pathname PATHNAME

Package

rpm

Source

version.lisp (file)

Function: parse-rpm-version X

Package

rpm

Source

version.lisp (file)

Function: parse-rpm-versioned-name STRING &key START END

Package

rpm

Source

version.lisp (file)

Function: rpm-pathname-packagename PATHNAME

Package

rpm

Source

version.lisp (file)

Function: rpm-pathname-version PATHNAME

Package

rpm

Source

version.lisp (file)

Function: rpm-version< V1 V2

Package

rpm

Source

version.lisp (file)

Function: rpm-version<= V1 V2

Package

rpm

Source

version.lisp (file)

Function: rpm-version= V1 V2

Package

rpm

Source

version.lisp (file)

Function: rpm-version> V1 V2

Package

rpm

Source

version.lisp (file)

Function: rpm-version>= V1 V2

Package

rpm

Source

version.lisp (file)

Function: rpm-versioned-name-basename STRING

Package

rpm

Source

version.lisp (file)

Function: rpm-versioned-name-version STRING

Package

rpm

Source

version.lisp (file)

Function: rpms-installed &key PACKAGENAMES HOST

Package

rpm

Source

upgrade.lisp (file)

Function: rpms-to-update DESIRED-RPMS &key HOST TEST

Package

rpm

Source

upgrade.lisp (file)

5.2 Internal definitions

5.2.1 Special variables

Special Variable: *rpm-architecture*

Package

rpm

Source

specials.lisp (file)

5.2.2 Functions

Function: asdf-to-rpm-architecture X

Package

rpm

Source

specials.lisp (file)

Function: compare-rpm-version-chunks CH1 CH2

Given the first chunks of two respective version numbers, return the symbol < = > depending on which of predicates hold, or nil is none does

Package

rpm

Source

version.lisp (file)

Function: compare-rpm-version-components V1 V2

Package

rpm

Source

version.lisp (file)

Function: compare-rpm-versions V1 V2

Package

rpm

Source

version.lisp (file)

Function: parse-rpm-version-component V

Given a version or release component of a RPM, parse it into a list of numbers and letters, e.g. "0.99p7" => (0 99 "p" 7)

Package

rpm

Source

version.lisp (file)

Function: valid-rpm-architecture-component-p STRING &key START END

Package

rpm

Source

version.lisp (file)

Function: valid-rpm-version-component-p STRING &key START END

Package

rpm

Source

version.lisp (file)

Appendix A Indexes

A.1 Concepts

A.2 Functions

A.3 Variables

A.4 Data types