# DERB - disassemble a resource bundle - man(1) - [phpMan]

[_DERB_(1)](https://www.chedong.com/phpMan.php/man/DERB/1/markdown)                                    ICU 74.2 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/74.2/**.
                 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)