The "Bad Penguin" BPP File Format
=================================

First release: Antonio Gallo <agx@linux.it> - 19-06-1998
Last  release: Antonio Gallo <agx@linux.it> - 2002



Bad Penguin's Packages
======================

A Bad Penguin Package is a normal file wich name respect the following
syntax:  NameOfThePackage_VersionOfThePackage.bpp

So, the name and the version of the package are separated with an '_' 
(underscore) sign and the filename ends with '.bpp'.

The file it's self is a tar+gzip archive that's mean you can ALWAYS
extract the info from it with a sample command:
	tar -zxvf filename.bpp

The archive contain some special files and directories that are not
copied to your filesystem but contain special information about the
archive (the package) itself.

The /install directory contains all the package's informations and script
used by the various bpp-* utilities to handle the package operations
as well.

The /incoming directory contains all the package files that have not to 
overwrite, when installing the package, other pre-existing files onto the
destination filesystem.



The /install directory
======================

The /install directory contains some special files that we describe here:

- DESCRIPTION, contain a long text description about the package;

- INFO,	this is a shell script that is included from the bpp-* utilities 
        that contains all the package settings needed to manage it. This 
	file is automatically generated when building the package from 
	the file "Makefile"

- MANIFEST, this file contains all the files into the package. It's usefull
            to know in wich package is stored a file and to remove all the
	    files installed from a package. This file is automatically
	    generated when building the package.

- MD5MANIFEST.gz, contain a list of all the MD5 checksum for any binaries
                  or libraries. In future this file can be used to check
		  the integrity of files against exploits, crackers and
		  "root kits". This is automatically generated when
		  building the package.

- Makefile, this is the only file you need to edit manually. It contains all
            the info to build the package from scratch or from source. This
	    file is explained in bpp-manifest.txt


The /install directory can also contain this customized shell scripts that
if present will be run when doing some special action with the package:
- PRE-INSTALL,      run before installing the package
- INSTALL,          run after  installed the package
- POST-INSTALL,     run after  installed the package or at boot time
- X-POST-INSTALL,   run before X-Window will start
- PRE-REMOVE,       run before removing the package
- REMOVE,           run after  removing the package
- POST-REMOVE,      run after  removed the package or at boot time
- PURGE,            run after  REMOVE if --purge is specified


