Linux Manuals session 3

Dpkg::Exit – program exit handlers DescriptionThe Dpkg::Exit module provides support functions to run handlers on exit. Functionspush_exit_handler($func) Register a code reference into the exit function handlers stack. pop_exit_handler() Pop the last registered exit handler from the handlers stack. run_exit_handlers() Run the registered exit handlers.ChangesVersion 1.01New functions: push_exit_handler(), pop_exit_handler(), run_exit_handlers() Deprecated variable: @handlers Version 1.00Mark the…

Dpkg::Deps – parse and manipulate dependencies of Debian packages DescriptionThe Dpkg::Deps module provides objects implementing various types of dependencies. The most important function is deps_parse(), it turns a dependency line in a set of Dpkg::Deps::{Simple,AND,OR,Union} objects depending on the case. FunctionsAll the deps_* functions are exported by default. deps_eval_implication($rel_p, $v_p, $rel_q, $v_q) ($rel_p, $v_p) and…

Dpkg::Control::Types – export CTRL_* constants DescriptionYou should not use this module directly. Instead you more likely want to use Dpkg::Control which also re-exports the same constants. This module has been introduced solely to avoid a dependency loop between Dpkg::Control and Dpkg::Control::Fields. ChangesVersion 0.xxThis is a private module. AuthorRaphaël Hertzog <hertzog [at] debian.org>.

Dpkg::Control::Info – parse files like debian/control DescriptionIt provides an object to access data of files that follow the same syntax as debian/control. Functions$c = Dpkg::Control::Info->new($file) Create a new Dpkg::Control::Info object for $file. If $file is omitted, it loads debian/control. If file is “-”, it parses the standard input. $c->reset() Resets what got read. $c->load($file) Load…

Dpkg::Control::HashCore – parse and manipulate a block of RFC822-like fields DescriptionThe Dpkg::Control::Hash object is a hash-like representation of a set of RFC822-like fields. The fields names are case insensitive and are always capitalized the same when output (see field_capitalize function in Dpkg::Control::Fields). The order in which fields have been set is remembered and is used…

Dpkg::Control::Hash – parse and manipulate a block of RFC822-like fields DescriptionThis module is just like Dpkg::Control::HashCore, with vendor-specific field knowledge. ChangesVersion 1.00Mark the module as public. AuthorRaphaël Hertzog <hertzog [at] debian.org>.

Dpkg::Control::FieldsCore – manage (list of official) control fields DescriptionThe modules contains a list of fieldnames with associated meta-data explaining in which type of control information they are allowed. The types are the CTRL_* constants exported by Dpkg::Control. Functionsmy $f = field_capitalize($field_name) Returns the field name properly capitalized. All characters are lowercase, except the first of…

Dpkg::Control::Fields – manage (list of official) control fields DescriptionThe module contains a list of vendor-neutral and vendor-specific fieldnames with associated meta-data explaining in which type of control information they are allowed. The vendor-neutral fieldnames and all functions are inherited from Dpkg::Control::FieldsCore. ChangesVersion 1.00Mark the module as public. AuthorRaphaël Hertzog <hertzog [at] debian.org>.

Dpkg::Control::Changelog – represent info fields output by dpkg-parsechangelog DescriptionThis object derives directly from Dpkg::Control with the type CTRL_CHANGELOG. Functions$c = Dpkg::Control::Changelog->new() Create a new empty set of changelog related fields.ChangesVersion 1.00Mark the module as public. AuthorRaphaël Hertzog <hertzog [at] debian.org>.

Dpkg::Control – parse and manipulate official control-like information DescriptionThe Dpkg::Control object is a smart version of Dpkg::Control::Hash. It associates a type to the control information. That type can be used to know what fields are allowed and in what order they must be output. The types are constants that are exported by default. Here’s the…

Dpkg::Conf – parse dpkg configuration files DescriptionThe Dpkg::Conf object can be used to read options from a configuration file. It can exports an array that can then be parsed exactly like @ARGV. Functionsmy $conf = Dpkg::Conf->new(%opts) Create a new Dpkg::Conf object. Some options can be set through %opts: if allow_short evaluates to true (it defaults…

Dpkg::Compression::Process – run compression/decompression processes DescriptionThis module provides an object oriented interface to run and manage compression/decompression processes. Methodsmy $proc = Dpkg::Compression::Process->new(%opts) Create a new instance of the object. Supported options are “compression” and “compression_level” (see corresponding set_* functions). $proc->set_compression($comp) Select the compression method to use. It errors out if the method is not supported…

Dpkg::Compression::FileHandle – object dealing transparently with file compression Synopsis use Dpkg::Compression::FileHandle; $fh = Dpkg::Compression::FileHandle->new(filename => ‘sample.gz’); print $fh "Something\n"; close $fh; $fh = Dpkg::Compression::FileHandle->new(); open($fh, ‘>’, ‘sample.bz2’); print $fh "Something\n"; close $fh; $fh = Dpkg::Compression::FileHandle->new(); $fh->open(‘sample.xz’, ‘w’); $fh->print("Something\n"); $fh->close(); $fh = Dpkg::Compression::FileHandle->new(filename => ‘sample.gz’); my @lines = <$fh>; close $fh; $fh = Dpkg::Compression::FileHandle->new(); open($fh, ‘<‘,…

Dpkg::Compression – simple database of available compression methods DescriptionThis modules provides a few public funcions and a public regex to interact with the set of supported compression methods. Functionsmy @list = compression_get_list() Returns a list of supported compression methods (sorted alphabetically). compression_is_supported($comp) Returns a boolean indicating whether the give compression method is known and supported….

Dpkg::Checksums – generate and manipulate file checksums DescriptionThis module provides an object that can generate and manipulate various file checksums as well as some methods to query information about supported checksums. Functions@list = checksums_get_list() Returns the list of supported checksums algorithms. $bool = checksums_is_supported($alg) Returns a boolean indicating whether the given checksum algorithm is supported….

Dpkg::Changelog::Parse – generic changelog parser for dpkg-parsechangelog DescriptionThis module provides a single function changelog_parse() which reproduces all the features of dpkg-parsechangelog. FUNCTIONSmy $fields = changelog_parse(%opt) This function will parse a changelog. In list context, it return as many Dpkg::Control object as the parser did output. In scalar context, it will return only the first one….

Dpkg::Changelog::Entry::Debian – represents a Debian changelog entry DescriptionThis object represents a Debian changelog entry. It implements the generic interface Dpkg::Changelog::Entry. Only functions specific to this implementation are described below. Functionsmy @items = $entry->get_change_items() Return a list of change items. Each item contains at least one line. A change line starting with an asterisk denotes the…

Dpkg::Changelog::Entry – represents a changelog entry DescriptionThis object represents a changelog entry. It is composed of a set of lines with specific purpose: an header line, changes lines, a trailer line. Blank lines can be between those kind of lines. Functionsmy $entry = Dpkg::Changelog::Entry->new() Creates a new object. It doesn’t represent a real changelog entry…

Dpkg::Changelog::Debian – parse Debian changelogs DescriptionDpkg::Changelog::Debian parses Debian changelogs as described in the Debian policy (version 3.6.2.1 at the time of this writing). See section “SEE ALSO” for locations where to find this definition. The parser tries to ignore most cruft like # or /* */ style comments, CVS comments, vim variables, emacs local variables…

Dpkg::Changelog – base class to implement a changelog parser DescriptionDpkg::Changelog is a class representing a changelog file as an array of changelog entries (Dpkg::Changelog::Entry). By deriving this object and implementing its parse method, you add the ability to fill this object with changelog entries. FUNCTIONSmy $c = Dpkg::Changelog->new(%options) Creates a new changelog object. $c->load($filename) Parse…