April 23, 2004

FreeBSD 4.9

PMGRrDbCreate(3) i386/PRM

PMGRrDbCreate

builds a series of data bases used to monitor installed port status

LIBRARY

libPMGR.so.1

SYNOPSIS

PMGRrDbCreate builds data bases whose purpose is to monitor the status of installed ports on a FreeBSD operating system.

DESCRIPTION

The general plan for data base creation is as follows:

All data bases created are located in /var/db. portI.db contains the name of each installed port and directory in the ports tree where it is located. portIP.db contains the name of each installed port, and the name and port tree directory of each port that the installed port requires inorder to be built.

RETURN VALUES

Returns 0 on success, 1 for failure.

On success two brand new shiny dBase files, portI.db and portIP.db will exist in /var/db directory.

FILES

C sources

PMGRrDbCreate.c
PMGRrDbCreate.h
       

portDB schema

portI.db
    fields:  port dir, port name

portIP.db
    fields:  port name, dependency port name, dependency port dir
           

EXAMPLES

To call PMGRrDbCreate simply link against libPMGR.so.0 and in your code include "{int returnvalue} = PMGRrDbCreate()". PMGRrDbCreate requires no input parameters. Of course you must have write access to /var/db for it to succeed and if you don't, you will receive the appropriate error message and it'll return with a one.

DIAGNOSTICS

COMPATIBILITY

ERRORS

See examples, you must have write access to /var/db for PMGRrDbCreate to work.

SEE ALSO

STANDARDS

HISTORY

AUTHORS

Mojave Green Software Co.
Landers Ca
Michael C. Shultz
       

BUGS