# phpman > man > pkgdata(1)

[PKGDATA(1)](https://www.chedong.com/phpMan.php/man/PKGDATA/1/markdown)                                 ICU 70.1 Manual                                [PKGDATA(1)](https://www.chedong.com/phpMan.php/man/PKGDATA/1/markdown)



## NAME
       **pkgdata** - package data for use by ICU

## SYNOPSIS
       **pkgdata**  [  **-h**,  **-?**, **--help** ] [ **-v**, **--verbose** ] [ **-c**, **--copyright** | **-C**, **--comment** _comment_ ] [
### -m --mode -p --name -O --bldopt -e --entrypoint -r --re
       **vision** _version_ ] [ **-F**, **--rebuild** ] [ **-I**, **--install** ] [ **-s**, **--sourcedir** _source_ ] [ **-d**, **--dest**‐‐
       **dir** _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 pack‐
       aging  is easy to use for applications resource bundles, for example, as long as the applica‐
       tion 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, in‐
       stead 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 packag‐
       ing 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
              Includes the specified _comment_ in the resulting data instead of the ICU copyright  no‐
              tice.

### -m --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
              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 vari‐
              ables  used  by  [**make**(1)](https://www.chedong.com/phpMan.php/man/make/1/markdown) during the build of the packaged file. Note: If **icu-config** is
              available, then this option is not needed.

### -p --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
              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
              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 op‐
              tional. If only _major_ is supplied then the version is assumed to be _major_.0  for  ver‐
              sioning 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 **DEST**‐‐
              **DIR** is set it will be used for installation.

### -s --sourcedir
              Set the source directory to _source_.  The default source directory is the  current  di‐
              rectory.

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

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

## AUTHORS
       Steven Loomis
       Yves Arrouye

## VERSION
       70.1

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




ICU MANPAGE                                6 February 2009                                [PKGDATA(1)](https://www.chedong.com/phpMan.php/man/PKGDATA/1/markdown)
