# DERB(1) - man - phpMan

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



## NAME
       **derb** - disassemble a resource bundle

## SYNOPSIS
       **derb**  [  **-h**,  **-?**,  **--help** ] [ **-V**, **--version** ] [ **-v**, **--verbose** ] [ **-e**, **--encoding** _encoding_ ] [
       **--bom** ] [ **-t**, **--truncate** [ _size_ ] ] [ **-s**, **--sourcedir** _source_ ] [ **-d**, **--destdir** _destination_  ]
       [ **-i**, **--icudatadir** _directory_ ] [ **-c**, **--to-stdout** ] _bundle_ ...

## DESCRIPTION
       **derb**  reads the compiled resource _bundle_ files passed on the command line and write them back
       in text form.  The resulting text files have a **.txt** extension while compiled resource  bundle
       source files typically have a **.res** extension.

       It  is customary to name the resource bundles by their locale name, i.e. to use a local iden‐
       tifier for the _bundle_ filename, e.g.  **ja**___**JP.res** for Japanese (Japan) data,  or  **root.res**  for
       the root bundle.  This is especially important for **derb** since the locale name is not accessi‐
       ble directly from the compiled resource bundle, and to know which  locale  to  ask  for  when
       opening  the  bundle.   **derb** will produce a file whose base name is the base name of the com‐
       piled resource file itself.  If the **--to-stdout**, **-c** option is used, however, the text will be
       written on the standard output.

## OPTIONS
### -h -? --help
              Print help about usage and exit.

### -V --version
              Print the version of **derb** and exit.

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

### -A --suppressAliases
              Don't follow aliases when producing output.

### -e --encoding
              Set  the encoding used to write output files to _encoding_.  The default encoding is the
              invariant (subset of ASCII or EBCDIC) codepage for the system (see  section  **INVARIANT**
              **CHARACTERS**).   The  choice of the encoding does not affect the data, just their repre‐
              sentation. Characters that cannot be represented in the _encoding_ will  be  represented
              using **\u**_hhhh_ escape sequences.

       **--bom**  Write a byte order mark (BOM) at the beginning of the file.

### -l --locale
              Set  the  _locale_ for the resource bundle, which is used both in the generated text and
              as the base name of the output file.

### -t --truncate
              Truncate individual resources (strings or binary data) to _size_ bytes. The  default  if
              _size_ is not specified is **80** bytes.

### -s --sourcedir
              Set  the  source directory to _source_.  The default source directory is the current di‐
              rectory.  If **-** is passed for _source_, then the _bundle_ will be looked for in its default
              location,  specified  by the **ICU**___**DATA** environment variable (or defaulting to the loca‐
              tion set when ICU was built if **ICU**___**DATA** is not set).

### -d --destdir
              Set the destination directory to _destination_.  The default  destination  directory  is
              specified  by  the  environment  variable **ICU**___**DATA** or is the location set when ICU was
              built if **ICU**___**DATA** is not set.

### -i --icudatadir
              Look for any necessary ICU data files in _directory_.  For example, when processing col‐
              lation  overrides,  the file **ucadata.dat** must be located.  The default ICU data direc‐
              tory is specified by the environment variable **ICU**___**DATA**.

### -c --to-stdout
              Write the disassembled _bundle_ on standard output instead of into a file.

## CAVEATS
       When the option **--bom** is used, the character **U+FEFF** is written in  the  destination  _encoding_
       regardless of whether it is a Unicode transformation format (UTF) or not.  This option should
       only be used with an UTF encoding, as byte order marks are not meaningful  for  other  encod‐
       ings.

## INVARIANT CHARACTERS
       The **invariant** **character** **set** consists of the following set of characters, expressed as a stan‐
       dard POSIX regular expression: **[a-z]|[A-Z]|[0-9]|**___**|** **|+|-|*|/**.  This is the set which is guar‐
       anteed to be available regardless of code page.

## ENVIRONMENT
       **ICU**___**DATA**  Specifies the directory containing ICU data. Defaults to **${prefix}/share/icu/70.1/**.
                 Some tools in ICU depend on the presence of the trailing slash. It is  thus  impor‐
                 tant to make sure that it is present if **ICU**___**DATA** is set.

## AUTHORS
       Vladimir Weinstein
       Yves Arrouye

## VERSION
       1.0

## COPYRIGHT
       Copyright (C) 2002 IBM, Inc. and others.

## SEE ALSO
       [**genrb**(1)](https://www.chedong.com/phpMan.php/man/genrb/1/markdown)




ICU MANPAGE                                  7 Mar 2014                                      [DERB(1)](https://www.chedong.com/phpMan.php/man/DERB/1/markdown)