rpm_is_valid(3) [php man page]

RPM_IS_VALID(3) 							 1							   RPM_IS_VALID(3)

rpm_is_valid - Tests a filename for validity as an RPM file

SYNOPSIS

       bool rpm_is_valid (string  $filename)

DESCRIPTION

       rpm_is_valid(3)	will  test  an	RPM  file  for validity as an RPM file. This is not the same as rpm_open(3) as it only checks the file for
       validity but does not return a file pointer to be used by further functions.

PARAMETERS

	      o $filename
		- The filename of the RPM file you wish to check for validity.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      rpm_is_valid(3) example

	      <?php

	      $file = "/path/to/file.rpm";

	      if (rpm_is_valid($file)) {
		  echo "File is recognized as an RPM file.<br>
";
	      }
	      else {
		  echo "File is not recognized as an RPM file.<br>
";
	      }

	      ?>

PHP Documentation Group 													   RPM_IS_VALID(3)

RPM2(3) 						User Contributed Perl Documentation						   RPM2(3)

NAME

       RPM2 - Perl bindings for the RPM Package Manager API

SYNOPSIS

	 use RPM2;

	 my $db = RPM2->open_rpm_db();

	 my $i = $db->find_all_iter();
	 print "The following packages are installed (aka, 'rpm -qa'):
";
	 while (my $pkg = $i->next) {
	   print $pkg->as_nvre, "
";
	 }

	 $i = $db->find_by_name_iter("kernel");
	 print "The following kernels are installed (aka, 'rpm -q kernel'):
";
	 while (my $pkg = $i->next) {
	   print $pkg->as_nvre, " ", int($pkg->size()/1024), "k
";
	 }

	 $i = $db->find_by_provides_iter("kernel");
	 print "The following packages provide 'kernel' (aka, 'rpm -q --whatprovides kernel'):
";
	 while (my $pkg = $i->next) {
	   print $pkg->as_nvre, " ", int($pkg->size()/1024), "k
";
	 }

	 print "The following packages are installed (aka, 'rpm -qa' once more):
";
	 foreach my $pkg ($db->find_by_file("/bin/sh")) {
	   print $pkg->as_nvre, "
";
	 }

	 my $pkg = RPM2->open_package("/tmp/XFree86-4.1.0-15.src.rpm");
	 print "Package opened: ", $pkg->as_nvre(), ", is source: ", $pkg->is_source_package, "
";

DESCRIPTION

       The RPM2 module provides an object-oriented interface to querying both the installed RPM database as well as files on the filesystem.

CLASS METHODS

       Pretty much all use of the class starts here.  There are two main entrypoints into the package -- either through the database of installed
       rpms (aka the rpmdb) or through a file on the filesystem (such as kernel-2.4.9-31.src.rpm or kernel-2.4.9-31.i386.rpm

       You can have multiple RPM databases open at once, as well as running multiple queries on each.

       open_rpm_db(-path => "/path/to/db")
	      As it sounds, it opens the RPM database, and returns it as an object.

       open_package("foo-1.1-14.noarch.rpm")
	      Opens a specific package (RPM or SRPM).  Returns a Header object.

RPM DB object methods
       find_all_iter()
	      Returns an iterator object that iterates over the entire database.

       find_all()
	      Returns an list of all of the results of the find_all_iter() method.

       find_by_file_iter($filename)
	      Returns an iterator that returns all packages that contain a given file.

       find_by_file($filename)
	      Ditto, except it just returns the list

       find_by_name_iter($package_name)
	      You get the idea.  This one is for iterating by package name.

       find_by_name($package_name)
	      Ditto, except it returns a list.

       find_by_provides_iter($provides_string)
	      This one iterates over provides.

       find_by_provides($provides_string)
	      Ditto, except it returns a list.

       find_by_requires_iter($requires_string)
	      This one iterates over requires.

       find_by_requires($requires_string)
	      Ditto, except it returns a list.

RPM Header object methods
       stuff goes here

TODO

       Package installation and removal.

       Signature validation.

HISTORY

       0.01 Initial release

AUTHOR

       Chip Turner <cturner@redhat.com>

SEE ALSO

       perl.  The original RPM module.

perl v5.8.0							    2002-11-08								   RPM2(3)