epm(1)
NAME
epm - create software packages
SYNOPSIS
epm
[ -f
format
] [ -g ] [ -n[mrs] ] [ -s
setup.xpm
] [ --setup-image
setup.xpm
] [ --setup-program
/foo/bar/setup
] [ -v ] [
name=value
name=value
] product [
listfile
]
DESCRIPTION
epm generates software packages complete with
installation, removal, and (if necessary) patch scripts. Unless
otherwise specified, the files required for product are
read from a file named "product.list".
The -f option ("format") specifies the distribution format:
- deb
- Generate a Debian distribution suitable for
installation on a Debian Linux system.
- inst, tardist
- Generate an IRIX distribution suitable for
installation on an system running IRIX.
- native
- Generate an native distribution. This uses
rpm for Linux, inst for IRIX, pkg
for Solaris, and swinstall for HP-UX. All other
operating systems default to the portable format.
- pkg
- Generate an AT&T software package. These are
used primarily under Solaris.
- portable
- Generate a portable distribution based on shell
scripts and tar files. The resulting distribution is
installed and removed the same way on all operating
systems. [default]
- rpm
- Generate a Red Hat Package Manager ("RPM")
distribution suitable for installation on a Red Hat
Linux system.
- swinstall, depot
- Generate a HP-UX software distribution.
Executable files in the distribution are normally stripped of
debugging information when packaged. To disable this
functionality use the -g option.
The -s and --setup-image options
("setup") include the ESP Software Wizard with the
specified XPM image file with the distribution. This option is
currently only supported by portable distributions.
The --setup-program option specifies the setup executable
to use with the distribution. This option is currently only
supported by portable distributions.
The -v option ("verbose") increases the
amount of information that is reported. Use multiple v's for
more verbose output.
Distributions normally are named
"product-version-system-release-machine.ext" and
"product-version-system-release-machine-patch.ext"
(for patch distributions.) The
"system-release-machine" information can be customized
or eliminated using the -n option with the appropriate
trailing letters. Using -n by itself will remove the
"system-release-machine" string from the filename
entirely.
Debian, IRIX, portable, and Red Hat distributions use the
extensions ".deb", ".tardist",
"tar.gz", and ".rpm" respectively.
LIST FILES
Each product has an associated list file that describes the files to include
with the product. Comment lines begin with the "#" character and are ignored.
All other non-blank lines must begin with a letter or the percent sign ("%")
as follows:
- %copyright copyright notice
- Sets the copyright notice for the file.
- %description description text
- Adds a line of descriptive text to the distribution.
Multiple lines are supported.
- %format format [... format]
- Uses following files and directives only if the
distribution format is the same as format.
- %format !format [... format]
- Uses following files and directives only if the
distribution format is not the same as format.
- %include filename
- Includes files listed in filename.
- %incompat product
- %incompat filename
- Indicates that this product is incompatible with the
named product or file.
- %install script or program
- Specifies a script or program to be run after all
files are installed.
- %license license file
- Specifies the file to display as the software license.
- %packager name of packager
- Specifies the name of the packager.
- %patch script or program
- Specifies a script or program to be run after all
files are patched.
- %product product name
- Specifies the product name.
- %readme readme file
- Specifies a README file to be included in the distribution.
- %remove script or program
- Specifies a script or program to be run before
removing or patching files.
- %replaces product
- Indicates that this product replaces the named product.
- %requires product
- %requires filename
- Indicates that this product requires the named product or file.
- %vendor vendor or author name
- Specifies the vendor or author of the product.
- %version version number
- Specifies the version number of the product.
- %system system[-release] [... system[-release]]
- Specifies that the following files should only be
used for the specified operating systems and releases.
- %system !system[-release] [... system[-release]]
- Specifies that the following files should not be
used for the specified operating systems and releases.
- %system all
- Specifies that the following files are applicable to
all operating systems.
- c mode user group destination source
- C mode user group destination source
- Specifies a configuration file for installation. The
second form specifies that the file has changed or is
new and should be included as part of a patch.
Configuration files are installed as
"destination.N" if the destination already
exists.
- d mode user group destination -
- D mode user group destination -
- Specifies a directory should be created when
installing the software. The second form specifies that
the directory is new and should be included as part of a
patch.
- f mode user group destination source
- F mode user group destination source
- Specifies a file for installation. The second form
specifies that the file has changed or is new and should
be included as part of a patch.
- f mode user group destination source/pattern
- F mode user group destination source/pattern
- Specifies one or more files for installation using shell
wildcard patterns. The second form specifies that the files have
changed or are new and should be included as part of a patch.
- i mode user group service-name source
- I mode user group service-name source
- Specifies an initialization script for installation.
The second form specifies that the file has changed or
is new and should be included as part of a patch.
Initialization scripts are stored in
/etc/software/init.d and are linked to the appropriate
system-specific directories for run levels 0, 2, 3, and
5. Initialization scripts must accepts at least
the start and stop commands.
- l mode user group destination source
- L mode user group destination source
- Specifies a symbolic link in the installation. The
second form specifies that the link has changed or is
new and should be included as part of a patch.
- R mode user group destination
- Specifies that the file is to be removed upon
patching. The user and group fields are
ignored. The mode field is only used to
determine if a check should be made for a previous
version of the file.
ENVIRONMENT VARIABLES
The RPMDIR environment variable will override where EPM looks
for RPM distributions you generate. The default locations are
/usr/src/redhat/RPMS, /usr/src/RPM/RPMS, /usr/src/packages/RPMS,
and /usr/local/src/RPMS.
KNOWN BUGS
EPM does not currently support generation of IRIX software patches.
COPYRIGHT
Copyright 1999-2000 by Easy Software Products, All Rights Reserved.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.