Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  DPKG::CONTROL::FIELDSCORE (3)

.ds Aq ’


Dpkg::Control::FieldsCore - manage (list of official) control fields



The 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.


$f = field_capitalize($field_name) Returns the field name properly capitalized. All characters are lowercase, except the first of each word (words are separated by a hyphen in field names).
field_is_official($fname) Returns true if the field is official and known.
field_is_allowed_in($fname, @types) Returns true (1) if the field $fname is allowed in all the types listed in the list. Note that you can use type sets instead of individual types (ex: CTRL_FILE_CHANGES | CTRL_CHANGELOG).

field_allowed_in(A|B, C) returns true only if the field is allowed in C and either A or B.

Undef is returned for non-official fields.

field_transfer_single($from, $to, $field) If appropriate, copy the value of the field named $field taken from the $from Dpkg::Control object to the $to Dpkg::Control object.

Official fields are copied only if the field is allowed in both types of objects. Custom fields are treated in a specific manner. When the target is not among CTRL_PKG_SRC, CTRL_PKG_DEB or CTRL_FILE_CHANGES, then they are alway copied as is (the X- prefix is kept). Otherwise they are not copied except if the target object matches the target destination encoded in the field name. The initial X denoting custom fields can be followed by one or more letters among S (Source: corresponds to CTRL_PKG_SRC), B (Binary: corresponds to CTRL_PKG_DEB) or C (Changes: corresponds to CTRL_FILE_CHANGES).

Returns undef if nothing has been copied or the name of the new field added to $to otherwise.

field_transfer_all($from, $to) Transfer all appropriate fields from $from to $to. Calls field_transfer_single() on all fields available in $from.

Returns the list of fields that have been added to $to.

field_ordered_list($type) Returns an ordered list of fields for a given type of control information. This list can be used to output the fields in a predictable order. The list might be empty for types where the order does not matter much.
field_list_src_dep() List of fields that contains dependencies-like information in a source Debian package.
field_list_pkg_dep() List of fields that contains dependencies-like information in a binary Debian package. The fields that express real dependencies are sorted from the stronger to the weaker.
field_get_dep_type($field) Return the type of the dependency expressed by the given field. Can either be normal for a real dependency field (Pre-Depends, Depends, ...) or union for other relation fields sharing the same syntax (Conflicts, Breaks, ...). Returns undef for fields which are not dependencies.
field_get_sep_type($field) Return the type of the field value separator. Can be one of FIELD_SEP_UNKNOWN, FIELD_SEP_SPACE, FIELD_SEP_COMMA or FIELD_SEP_LINE.
field_register($field, $allowed_types, %opts) Register a new field as being allowed in control information of specified types. %opts is optional
field_insert_after($type, $ref, @fields) Place field after another one ($ref) in output of control information of type $type.
field_insert_before($type, $ref, @fields) Place field before another one ($ref) in output of control information of type $type.


    Version 1.00 (dpkg 1.17.0)

Mark the module as public.


RaphaŽl Hertzog <>.
Search for    or go to Top of page |  Section 3 |  Main Index

1.18.4 DPKG::CONTROL::FIELDSCORE (3) 2015-12-25

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.