README

libvpd:
-------
The libvpd package contains the classes that are used to access a vpd database
created by vpdupdate in the lsvpd package.

Source:
-------
https://github.com/power-ras/libvpd

License:
--------
See 'COPYING' file.

Compilation dependencies:
-------------------------
- C and C++ compiler (gcc, g++)
- GNU build tools (automake, autoconf, libtool, etc)
- sg3_utils-devel
- zlib-devel

Binary dependencies:
--------------------
- sqlite3
- zlib

Note:
  - Package name may differ slightly between Linux distributors. Ex: RedHat and
    SLES ships development packages as "-devel" while Ubuntu ships it as "-dev"
    package. Please check your linux distribution package naming convention and
    make sure you have installed right packages.
  - For users of older RHEL and SLES versions
    sqlite is not available in the default repositories for some of the older
    RHEL (<= 5.x?) and SLES (<= 10.x?) versions. If you want to run the new
    lsvpd/libvpd setup you need build sqlite version 3.0.0 or newer from
    source (available here: http://www.sqlite.org) or find an appropriate
    binary package for your architecture and software setup.

Building:
---------
You can build on Power Linux system.

$ ./bootstrap.sh
$ ./configure [--prefix=/usr/]
$ make
$ make install

Building rpms:
--------------
To build a tarball to feed to rpmbuild, do

$ make dist-gzip

Next, move your source/zipped tarball file into SOURCES directory

$ mv libvpd-<version>.tar.gz /root/rpmbuild/SOURCES/

As an example, we use a command similar to the following:

$ rpmbuild -ba [--target=ppc/ppc64] <path-to-spec-file>

Reporting issues:
-----------------
Create a GitHub issue if you have any request for change, assuming one does
not already exist. Clearly describe the issue including steps to reproduce
if it is a bug.

How to contribute:
------------------
If you plan to submit the changes, submit a pull request based on top of
master. Include a descriptive commit message. Changes contributed should
focus on a single issue at a time to the extent possible.

Hacking:
--------
The following workflow should work for you:
- Fork the repository on GitHub into your account.
- Create a topic branch from where you want to base your work.
  This is usually the master branch.
- Make sure you have added the necessary tests for your changes and make sure
  all tests pass.
- Push your changes to the topic branch in your fork of the repository.
- Include a descriptive commit message, and each commit should have
  linux-kernel style 'Signed-Off-By'.
- Submit a pull request to this repository.

You probably want to read the linux Documentation/SubmittingPatches as
much of it applies to libvpd.

--