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::PATH (3)

.ds Aq ’


Dpkg::Path - some common path handling functions



It provides some functions to handle various path.


get_pkg_root_dir($file) This function will scan upwards the hierarchy of directory to find out the directory which contains the DEBIAN sub-directory and it will return its path. This directory is the root directory of a package being built.

If no DEBIAN subdirectory is found, it will return undef.

relative_to_pkg_root($file) Returns the filename relative to get_pkg_root_dir($file).
guess_pkg_root_dir($file) This function tries to guess the root directory of the package build tree. It will first use get_pkg_root_dir(), but it will fallback to a more imprecise check: namely it will use the parent directory that is a sub-directory of the debian directory.

It can still return undef if a file outside of the debian sub-directory is provided.

check_files_are_the_same($file1, $file2, $resolve_symlink) This function verifies that both files are the same by checking that the device numbers and the inode numbers returned by stat()/lstat() are the same. If $resolve_symlink is true then stat() is used, otherwise lstat() is used.
canonpath($file) This function returns a cleaned path. It simplifies double //, and remove /./ and /../ intelligently. For /../ it simplifies the path only if the previous element is not a symlink. Thus it should only be used on real filenames.
$newpath = resolve_symlink($symlink) Return the filename of the file pointed by the symlink. The new name is canonicalized by canonpath().
$cmdpath = find_command($command) Return the path of the command if defined and available on an absolute or relative path or on the $PATH, undef otherwise.
$control_file = get_control_path($pkg, $filetype) Return the path of the control file of type $filetype for the given package.
@control_files = get_control_path($pkg) Return the path of all available control files for the given package.
$file = find_build_file($basename) Selects the right variant of the given file: the arch-specific variant ($basename.$arch) has priority over the OS-specific variant ($basename.$os) which has priority over the default variant ($basename). If none of the files exists, then it returns undef.
@files = find_build_file($basename) Return the available variants of the given file. Returns an empty list if none of the files exists.


    Version 1.04 (dpkg 1.17.11)

Update semantics: find_command() now handles an empty or undef argument.

    Version 1.03 (dpkg 1.16.1)

New function: find_build_file()

    Version 1.02 (dpkg 1.16.0)

New function: get_control_path()

    Version 1.01 (dpkg 1.15.8)

New function: find_command()

    Version 1.00 (dpkg 1.15.6)

Mark the module as public.


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

1.18.4 DPKG::PATH (3) 2015-11-26

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