Puppet Data Type Alias: Yum::VersionlockString

Defined in:

types/versionlockstring.pp

Overview

This type matches strings appropriate for use with yum-versionlock. Its basic format, using the ‘rpm(8)` query string format, is `%EPOCH:%NAME-%VERSION-%RELEASE.%ARCH`. As a Regex, it breaks down into five distinct parts, plus the seperators.

EPOCH: An unsigned integer
type Yum::PackageEpoch   = Regexp[/[0-9]\*]+/]

NAME: Any valid package name (see https://github.com/rpm-software-management/rpm/blob/master/doc/manual/spec)
type Yum::PackageName    = Regexp[/[0-9a-zA-Z\._\+%\{\}\*-]+/]

VERSION: Any valid version string. The only limitation here, according to the RPM manual, is that it may not contain a dash (`-`).
type Yum::PackageVersion = Regexp[/[^-]+/]

RELEASE: Any valid release string. Only limitation is that it is not a dash (`-`)
type Yum::PackageRelease = Regexp[/[^-]+/]

lint:ignore:140chars

ARCH: Matches a string such as `el7.x86_64`.  This is actuall two sub-expressions.  See below.
type Yum::PackageArch    = Regexp[/([0-9a-zZ-Z_\*]+)(?:\.(noarch|x86_64|i386|arm|ppc64|ppc64le|sparc64|ia64|alpha|ip|m68k|mips|mipsel|mk68k|mint|ppc|rs6000|s390|s390x|sh|sparc|xtensa|\*))?/]

lint:endignore

The ‘%ARCH` sub-expression is composed of two sub-expressions separated by a dot (`.`), where the second part is optional. The RPM specification calls the first field the `DistTag`, and the second the `BuildArch`.

DistTag: Any string consiting of only letters, numbers, or an underscore, e.g., `el6`, `sl7`, or `fc24`.
type Yum::PackageDistTag   = Regexp[/[0-9a-zZ-Z_\*]+/]

lint:ignore:140chars

BuildArch: Any string from the list at https://github.com/rpm-software-management/rpm/blob/master/rpmrc.in.  Strings are roughly listed from most common to least common to improve performance.
type Yum::PackageBuildArch = Regexp[/noarch|x86_64|i386|arm|ppc64|ppc64le|sparc64|ia64|alpha|ip|m68k|mips|mipsel|mk68k|mint|ppc|rs6000|s390|s390x|sh|sparc|xtensa/]

lint:endignore

wildcard characters may not span the fields, may not cover the seperators. This is an undocumented but tested limitation of yum-versionlock.

lint:ignore:140chars

Alias of

Pattern[/^([0-9\*]+):([0-9a-zA-Z\._\+%\{\}\*-]+)-([^-]+)-([^-]+)\.(([0-9a-zZ-Z_\*]+)(?:\.(noarch|x86_64|i386|arm|ppc64|ppc64le|sparc64|ia64|alpha|ip|m68k|mips|mipsel|mk68k|mint|ppc|rs6000|s390|s390x|sh|sparc|xtensa|\*))?)$/]

Note:

Each field may contain wildcard characters (‘*`), but the

Examples:

A complete, well-formed string: ‘0:bash-4.1.2-9.el6_2.x86_64’

A well-formed string that has dropped the optional BuildArch sub-field: ‘0:bash-4.1.2-9.el6_2`

A well-formed string using wildcards: ‘0:bash-4.-.*`

An invalid string (wildcard spans the VERSION and RELEASE fields): ‘0:bash-4.*-el6.x86_64

An invlaid string (wildcard spans the VERSION, RELEASE, and ARCH fields): ‘0:bash-*`

# File 'types/versionlockstring.pp', line 48