Unix/Linux Go Back    


CentOS 7.0 - man page for pkgdata (centos section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


PKGDATA(1)				ICU 50.1.2 Manual			       PKGDATA(1)

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  pur-
       poses:  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  direc-
       tory.

       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 pack-
       aging  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 doc-
       umentation 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  mean-
	      ing 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  gen-
	      erate the correct packaged file. Such options include, but are not limited to, set-
	      ting 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 ver-
	      sion  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  tem-
	      porary directory is the same as the destination directory as set by the -d, --dest-
	      dir option.

AUTHORS
       Steven Loomis
       Yves Arrouye

VERSION
       50.1.2

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

ICU MANPAGE				 6 February 2009			       PKGDATA(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 12:54 AM.