dpkg::path(3) [debian man page]

Dpkg::Path(3)							   libdpkg-perl 						     Dpkg::Path(3)

NAME

       Dpkg::Path - some common path handling functions

DESCRIPTION

       It provides some functions to handle various path.

METHODS

       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().

       my $cmdpath = find_command($command)
	       Return the path of the command if available on an absolute or relative path or on the $PATH, undef otherwise.

       my $control_file = get_control_path($pkg, $filetype)
	       Return the path of the control file of type $filetype for the given package.

       my @control_files = get_control_path($pkg)
	       Return the path of all available control files for the given package.

       my $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.

       my @files = find_build_file($basename)
	       Return the available variants of the given file. Returns an empty list if none of the files exists.

CHANGES

   Version 1.03
       New function: find_build_file()

   Version 1.02
       New function: get_control_path()

   Version 1.01
       New function: find_command()

AUTHOR

       Raphael Hertzog <hertzog@debian.org>.

1.16.15 							    2014-06-05							     Dpkg::Path(3)

Check Out this Related Man Page

Dpkg::Control::Info(3)						   libdpkg-perl 					    Dpkg::Control::Info(3)

NAME

       Dpkg::Control::Info - parse files like debian/control

DESCRIPTION

       It 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 the content of $file. Exits in case of errors. If file is "-", it loads from the standard input.

       $c->parse($fh, $description)
	   Parse a control file from the given filehandle. Exits in case of errors.  $description is used to describe the filehandle, ideally it's
	   a filename or a description of where the data comes from. It's used in error messages.

       $c->[0]
       $c->get_source()
	   Returns a Dpkg::Control object containing the fields concerning the source package.

       $c->get_pkg_by_idx($idx)
	   Returns a Dpkg::Control object containing the fields concerning the binary package numbered $idx (starting at 1).

       $c->get_pkg_by_name($name)
	   Returns a Dpkg::Control object containing the fields concerning the binary package named $name.

       $c->get_packages()
	   Returns a list containing the Dpkg::Control objects for all binary packages.

       $c->output($filehandle)
	   Dump the content into a filehandle.

       "$c"
	   Return a string representation of the content.

       @{$c}
	   Return a list of Dpkg::Control objects, the first one is corresponding to source information and the following ones are the binary
	   packages information.

AUTHOR

       Raphael Hertzog <hertzog@debian.org>.

1.16.15 							    2014-06-05						    Dpkg::Control::Info(3)

Linux and UNIX Man Pages

dpkg::path(3) [debian man page]

Check Out this Related Man Page