# pkgdata

## 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.
    


## VERSION



           76.0.1
    


* * *