25.5.32 ndbxfrm — Compress, Decompress, Encrypt, and Decrypt Files Created by NDB Cluster (original) (raw)

--compress,-c

Compresses the input file, using the same compression method as is used for compressing NDB Cluster backups, and writes the output to an output file. To decompress a compressedNDB backup file that is not encrypted, it is necessary only to invoke ndbxfrm using the names of the compressed file and an output file (with no options required).

--decrypt-key=key,-K key

Decrypts a file encrypted by NDB using the supplied key.

--decrypt-password=password

Decrypts a file encrypted by NDB using the password supplied.

--defaults-group-suffix

Also read groups withCONCAT(_`group`_,_`suffix`_).

--detailed-info

Print out file information like--info, but include the file's header and trailer.

Example:

$> ndbxfrm --detailed-info S0.sysfile
File=/var/lib/cluster-data/ndb_7_fs/D1/NDBCNTR/S0.sysfile, compression=no, encryption=yes
header: {
  fixed_header: {
    magic: {
      magic: { 78, 68, 66, 88, 70, 82, 77, 49 },
      endian: 18364758544493064720,
      header_size: 32768,
      fixed_header_size: 160,
      zeros: { 0, 0 }
    },
    flags: 73728,
    flag_extended: 0,
    flag_zeros: 0,
    flag_file_checksum: 0,
    flag_data_checksum: 0,
    flag_compress: 0,
    flag_compress_method: 0,
    flag_compress_padding: 0,
    flag_encrypt: 18,
    flag_encrypt_cipher: 2,
    flag_encrypt_krm: 1,
    flag_encrypt_padding: 0,
    flag_encrypt_key_selection_mode: 0,
    dbg_writer_ndb_version: 524320,
    octets_size: 32,
    file_block_size: 32768,
    trailer_max_size: 80,
    file_checksum: { 0, 0, 0, 0 },
    data_checksum: { 0, 0, 0, 0 },
    zeros01: { 0 },
    compress_dbg_writer_header_version: { ... },
    compress_dbg_writer_library_version: { ... },
    encrypt_dbg_writer_header_version: { ... },
    encrypt_dbg_writer_library_version: { ... },
    encrypt_key_definition_iterator_count: 100000,
    encrypt_krm_keying_material_size: 32,
    encrypt_krm_keying_material_count: 1,
    encrypt_key_data_unit_size: 32768,
    encrypt_krm_keying_material_position_in_octets: 0,
  },
  octets: {
     102, 68, 56, 125, 78, 217, 110, 94, 145, 121, 203, 234, 26, 164, 137, 180,
     100, 224, 7, 88, 173, 123, 209, 110, 185, 227, 85, 174, 109, 123, 96, 156,
  }
}
trailer: {
  fixed_trailer: {
    flags: 48,
    flag_extended: 0,
    flag_zeros: 0,
    flag_file_checksum: 0,
    flag_data_checksum: 3,
    data_size: 512,
    file_checksum: { 0, 0, 0, 0 },
    data_checksum: { 226, 223, 102, 207 },
    magic: {
      zeros: { 0, 0 }
      fixed_trailer_size: 56,
      trailer_size: 32256,
      endian: 18364758544493064720,
      magic: { 78, 68, 66, 88, 70, 82, 77, 49 },
    },
  }
}

--encrypt-block-size=#

Size of input data chunks that are encrypted as a unit. Used with XTS; set to 0 (the default) for CBC mode.

--encrypt-cipher=#

Cipher used for encryption. Set to 1 for CBC mode (the default), or 2 for XTS.

--encrypt-kdf-iter-count=#,-k _`#`_

When encrypting a file, specifies the number of iterations to use for the encryption key. Requires the--encrypt-password option.

--encrypt-key=key

Encrypts a file using the supplied key.

--encrypt-password=password

Encrypts the backup file using the password supplied by the option. The password must meet the requirements listed here:

• Uses any of the printable ASCII characters except!, ',", $,%, \,`, and ^
• Is no more than 256 characters in length
• Is enclosed by single or double quotation marks

--info, -i

Prints the following information about one or more input files:

• The name of the file
• Whether the file is compressed (compression=yes orcompression=no)
• Whether the file is encrypted (encryption=yes orencryption=no)

Example:

$> ndbxfrm -i BACKUP-10-0.5.Data BACKUP-10.5.ctl BACKUP-10.5.log
File=BACKUP-10-0.5.Data, compression=no, encryption=yes
File=BACKUP-10.5.ctl, compression=no, encryption=yes
File=BACKUP-10.5.log, compression=no, encryption=yes

You can also see the file's header and trailer using the --detailed-info option.