pkgdata - Online in the Cloud

PROGRAM:

NAME

pkgdata - package data for use by ICU

SYNOPSIS

pkgdata [ -h, -?, --help ] [ -v, --verbose ] [ -c, --copyright | -C, --comment comment ] [
-m, --mode mode ] -p, --name name -O, --bldopt options [ -e, --entrypoint name ] [ -r,
--revision version ] [ -F, --rebuild ] [ -I, --install ] [ -s, --sourcedir source ] [ -d,
--destdir destination ] [ -T, --tempdir directory ] [ file ... ]

DESCRIPTION

pkgdata takes a set of data files and packages them for use by ICU or applications that
use ICU. The typical reason to package files using pkgdata is to make their distribution
easier and their loading by ICU faster and less consuming of limited system resources such
as file descriptors. Packaged data also allow applications to be distributed with fewer
resource files, or even with none at all if they link against the packaged data directly.

pkgdata supports a few different methods of packaging data that serve different purposes.

The default packaging mode is common, or archive. In this mode, the different data files
are bundled together as an architecture-dependent file that can later be memory mapped for
use by ICU. Data packaged using this mode will be looked up under the ICU data directory.
Such packaging is easy to use for applications resource bundles, for example, as long as
the application can install the packaged file in the ICU data directory.

Another packaging mode is the dll, or library, mode, where the data files are compiled
into a shared library. ICU used to be able to dynamically load these shared libraries, but
as of ICU 2.0, such support has been removed. This mode is still useful for two main
purposes: to build ICU itself, as the ICU data is packaged as a shared library by default;
and to build resource bundles that are linked to the application that uses them. Such
resource bundles can then be placed anywhere where the system's dynamic linker will be
looking for shared libraries, instead of being forced to live inside the ICU data
directory.

The static packaging mode is similar to the shared library one except that it produces a
static library.

Finally, pkgdata supports a files mode which simply copies the data files instead of
packaging them as a single file or library. This mode is mainly intended to provide
support for building ICU before it is packaged as separate small packages for distribution
with operating systems such as Debian GNU/Linux for example. Please refer to the packaging
documentation in the ICU source distribution for further information on the use of this
mode.

pkgdata builds, packages, installs, or cleans the appropriate data based on the options
given without the need to call GNU make anymore.

OPTIONS

-h, -?, --help
Print help about usage and exit.

-v, --verbose
Display extra informative messages during execution.

-c, --copyright
Include a copyright notice in the binary data.

-C, --comment comment
Includes the specified comment in the resulting data instead of the ICU copyright
notice.

-m, --mode mode
Set the packaging mode to be used by pkgdata. The different modes and their
meaning are explained in the DESCRIPTION section above. The valid mode names are
common (or archive), dll (or library), and files.

-O, --bldopt options
Specify options for the builder. The builder is used internally by pkgdata to
generate the correct packaged file. Such options include, but are not limited to,
setting variables used by make(1) during the build of the packaged file. Note: If
icu-config is available, then this option is not needed.

-p, --name name
Set the packaged file name to name. This name is also used as the default entry
point name after having been turned into a valid C identifier.

-e, --entrypoint name
Set the data entry point (used for linking against the data in a shared library
form) to name. The default entry point name is the name set by the -n, --name
option.

-r, --revision version
Enable versioning of the shared library produced in dll, or library, mode. The
version number has the format major.minor.patchlevel and all parts except for major
are optional. If only major is supplied then the version is assumed to be major.0
for versioning purposes.

-F, --rebuild
Force the rebuilding of all data and their repackaging.

-I, --install
Install the packaged file (or all the files in the files mode). If the variable
DESTDIR is set it will be used for installation.

-s, --sourcedir source
Set the source directory to source. The default source directory is the current
directory.

-d, --destdir destination
Set the destination directory to destination. The default destination directory is
the current directory.

-T, --tempdir directory
Set the directory used to generate temporary files to directory. The default
temporary directory is the same as the destination directory as set by the -d,
--destdir option.

AUTHORS

Steven Loomis
Yves Arrouye

VERSION

55.1

COPYRIGHT

Copyright (C) 2000-2009 IBM, Inc. and others.

Use pkgdata online using onworks.net services