371 lines
7.1 KiB
HTML
371 lines
7.1 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of PKGDATA</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>PKGDATA</H1>
|
|
Section: ICU 66.1 Manual (1)<BR>Updated: 6 February 2009<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
<B>pkgdata</B>
|
|
|
|
- package data for use by ICU
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>pkgdata</B>
|
|
|
|
[
|
|
<B>-h</B>, <B>-?</B>, <B>--help</B>
|
|
|
|
]
|
|
[
|
|
<B>-v</B>, <B>--verbose</B>
|
|
|
|
]
|
|
[
|
|
<B>-c</B>, <B>--copyright</B>
|
|
|
|
|
|
|
<B>-C</B>, <B>--comment</B><I> comment</I>
|
|
|
|
]
|
|
[
|
|
<B>-m</B>, <B>--mode</B><I> mode</I>
|
|
|
|
]
|
|
<B>-p</B>, <B>--name</B><I> name</I>
|
|
|
|
<B>-O</B>, <B>--bldopt</B><I> options</I>
|
|
|
|
[
|
|
<B>-e</B>, <B>--entrypoint</B><I> name</I>
|
|
|
|
]
|
|
[
|
|
<B>-r</B>, <B>--revision</B><I> version</I>
|
|
|
|
]
|
|
[
|
|
<B>-F</B>, <B>--rebuild</B>
|
|
|
|
]
|
|
[
|
|
<B>-I</B>, <B>--install</B>
|
|
|
|
]
|
|
[
|
|
<B>-s</B>, <B>--sourcedir</B><I> source</I>
|
|
|
|
]
|
|
[
|
|
<B>-d</B>, <B>--destdir</B><I> destination</I>
|
|
|
|
]
|
|
[
|
|
<B>-T</B>, <B>--tempdir</B><I> directory</I>
|
|
|
|
]
|
|
[
|
|
<I>file</I> ...
|
|
|
|
]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>pkgdata</B>
|
|
|
|
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
|
|
<B>pkgdata</B>
|
|
|
|
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.
|
|
<P>
|
|
|
|
<B>pkgdata</B>
|
|
|
|
supports a few different methods of packaging data that serve
|
|
different purposes.
|
|
<P>
|
|
|
|
The default packaging
|
|
<I>mode</I>
|
|
|
|
is
|
|
<B>common</B>,
|
|
|
|
or
|
|
<B>archive</B>.
|
|
|
|
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.
|
|
<P>
|
|
|
|
Another packaging mode is the
|
|
<B>dll</B>,
|
|
|
|
or
|
|
<B>library</B>,
|
|
|
|
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.
|
|
<P>
|
|
|
|
The
|
|
<B>static</B>
|
|
|
|
packaging mode is similar to the shared library one except that it
|
|
produces a static library.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<P>
|
|
|
|
Finally,
|
|
<B>pkgdata</B>
|
|
|
|
supports a
|
|
<B>files</B>
|
|
|
|
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.
|
|
<P>
|
|
|
|
<B>pkgdata</B>
|
|
|
|
builds, packages, installs, or cleans the appropriate data based on the options given
|
|
without the need to call GNU
|
|
<B>make</B>
|
|
|
|
anymore.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-h</B>, <B>-?</B>, <B>--help</B>
|
|
|
|
<DD>
|
|
Print help about usage and exit.
|
|
<DT id="2"><B>-v</B>, <B>--verbose</B>
|
|
|
|
<DD>
|
|
Display extra informative messages during execution.
|
|
<DT id="3"><B>-c</B>, <B>--copyright</B>
|
|
|
|
<DD>
|
|
Include a copyright notice in the binary data.
|
|
<DT id="4"><B>-C</B>, <B>--comment</B><I> comment</I>
|
|
|
|
<DD>
|
|
Includes the specified
|
|
<I>comment</I>
|
|
|
|
in the resulting data instead of the ICU copyright notice.
|
|
<DT id="5"><B>-m</B>, <B>--mode</B><I> mode</I>
|
|
|
|
<DD>
|
|
Set the packaging
|
|
<I>mode</I>
|
|
|
|
to be used by
|
|
<B>pkgdata</B>.
|
|
|
|
The different modes and their meaning are explained in the
|
|
<B>DESCRIPTION</B>
|
|
|
|
section above. The valid mode names are
|
|
<B>common</B>
|
|
|
|
(or
|
|
<B>archive</B>),
|
|
|
|
<B>dll</B>
|
|
|
|
(or
|
|
<B>library</B>),
|
|
|
|
and
|
|
<B>files</B>.
|
|
|
|
<DT id="6"><B>-O</B>, <B>--bldopt</B><I> options</I>
|
|
|
|
<DD>
|
|
Specify options for the builder. The builder is used internally by
|
|
<B>pkgdata</B>
|
|
|
|
to generate the correct packaged file. Such options include, but are
|
|
not limited to, setting variables used by
|
|
<B><A HREF="/cgi-bin/man/man2html?1+make">make</A></B>(1)
|
|
|
|
during the build of the packaged file. Note: If
|
|
<B>icu-config</B>
|
|
|
|
is available, then this option is not needed.
|
|
<DT id="7"><B>-p</B>, <B>--name</B><I> name</I>
|
|
|
|
<DD>
|
|
Set the packaged file name to
|
|
<I>name</I>.
|
|
|
|
This name is also used as the default entry point name after having
|
|
been turned into a valid C identifier.
|
|
<DT id="8"><B>-e</B>, <B>--entrypoint</B><I> name</I>
|
|
|
|
<DD>
|
|
Set the data entry point (used for linking against the data in a
|
|
shared library form) to
|
|
<I>name</I>.
|
|
|
|
The default entry point name is the name set by the
|
|
<B>-n</B>, <B>--name</B>
|
|
|
|
option.
|
|
<DT id="9"><B>-r</B>, <B>--revision</B><I> version</I>
|
|
|
|
<DD>
|
|
Enable versioning of the shared library produced in
|
|
<B>dll</B>,
|
|
|
|
or
|
|
<B>library</B>,
|
|
|
|
mode. The version number has the format
|
|
<I>major</I>.<I>minor</I>.<I>patchlevel</I>
|
|
|
|
and all parts except for
|
|
<I>major</I>
|
|
|
|
are optional. If only
|
|
<I>major</I>
|
|
|
|
is supplied then the version is
|
|
assumed to be
|
|
<I>major</I>.0
|
|
|
|
for versioning purposes.
|
|
<DT id="10"><B>-F</B>, <B>--rebuild</B>
|
|
|
|
<DD>
|
|
Force the rebuilding of all data and their repackaging.
|
|
<DT id="11"><B>-I</B>, <B>--install</B>
|
|
|
|
<DD>
|
|
Install the packaged file (or all the files in the
|
|
<B>files</B>
|
|
|
|
mode). If the variable
|
|
<B>DESTDIR</B>
|
|
|
|
is set it will be used for installation.
|
|
<DT id="12"><B>-s</B>, <B>--sourcedir</B><I> source</I>
|
|
|
|
<DD>
|
|
Set the source directory to
|
|
<I>source</I>.
|
|
|
|
The default source directory is the current directory.
|
|
<DT id="13"><B>-d</B>, <B>--destdir</B><I> destination</I>
|
|
|
|
<DD>
|
|
Set the destination directory to
|
|
<I>destination</I>.
|
|
|
|
The default destination directory is the current directory.
|
|
<DT id="14"><B>-T</B>, <B>--tempdir</B><I> directory</I>
|
|
|
|
<DD>
|
|
Set the directory used to generate temporary files to
|
|
<I>directory</I>.
|
|
|
|
The default temporary directory is the same as the destination
|
|
directory
|
|
as set by the
|
|
<B>-d</B>, <B>--destdir</B>
|
|
|
|
option.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
Steven Loomis
|
|
<BR>
|
|
|
|
Yves Arrouye
|
|
<A NAME="lbAG"> </A>
|
|
<H2>VERSION</H2>
|
|
|
|
66.1
|
|
<A NAME="lbAH"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright (C) 2000-2009 IBM, Inc. and others.
|
|
<P>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="15"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="16"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="17"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="18"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="19"><A HREF="#lbAF">AUTHORS</A><DD>
|
|
<DT id="20"><A HREF="#lbAG">VERSION</A><DD>
|
|
<DT id="21"><A HREF="#lbAH">COPYRIGHT</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:23 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|