The keycompress option indicates whether to create files with key compression enabled. This feature is turned off by default. It may impact performance but reduces disk space usage.
Accepted Values
Value |
Effect |
Synonyms |
---|---|---|
yes |
Turns on key compression combining both leading character and padding compression. This provides the maximum key compression. |
y, true, on, 1 |
no |
Turns off key compression. |
n, false, off, 0 |
Attributes
Value |
Effect |
Synonyms |
vlennod |
Causes new files to be created with the new variable-length "vlennod" index node format. See the note below "Vlennod Index Node Format." Enabled by default. |
|
Additionally, the keycompress option may accept the following sub-options to specify which compression type to use:
<rle> keycompress option
<leading> keycompress option
<padding> keycompress option
Note: The <rle> and <padding> sub-options are mutually exclusive.
vlennod Index Node Format
Setting vlennod to "yes" causes new files to be created with the new index node format. The new index node format is variable-length hence the name "vlennod". The variable-length nature of the new index nodes allows better index compression. The vlennod attribute is enabled by default.
The following <keycompress> suboptions specify which compression type to use:
The new index compression does not support the <leading> compression type. The old index compression can be used by disabling <keycompress vlennod> (enabled by default), which allows the <leading> and <padding> to be specified. The new <rle> option cannot be specified when the <keycompress vlennod> attribute is disabled. The <rle> and <padding> sub-options are mutually exclusive unlike the old index compression where it was possible to combine <leading> and <padding>.
Examples
The following examples show different ways to turn on the new index compression:
<keycompress/>
<keycompress>1</keycompress>
<keycompress><rle/></keycompress>
<keycompression><padding>1</padding></keycompression>
The following example turns on default key compression that implicitly uses RLE compression:
<keycompress>yes</keycompress>
The following example turns on only padding key compression:
<keycompress>
<padding>yes</padding>
</keycompress>
The following example turns off key compression:
<keycompress>no<keycompress>
Using the Old-Style Compression
In some cases, older FairCom RTG versions that do not support the new vlennod index node format are in production and cannot be updated. The vlennod index node format can be disabled in these cases. This allows creation of compressed files in the old compression format so they are compatible with the old RTG version.
The old index compression can be used for file creation by disabling the <keycompress vlennod> attribute, which is enabled by default. When the <keycompress vlennod> attribute is disabled, the old index compression sub-options <leading> and <padding> can be specified. The new <rle> option cannot be specified when the <keycompress vlennod> attribute is disabled. The following examples show different ways to enable the old index compression:
<keycompress vlennod="no"/>
<keycompress vlennod="0">1</keycompress>
<keycompress vlennod="false"><leading>1</leading></keycompress>
<keycompression vlennod="n"><leading/><padding/></keycompression>