7.2.3 clone

Clone files.

Syntax

clone [{ -w | --wallet } wallet-location ] [{ -T | --trace } trace-level ] 
      source1 target1 [ sourceN targetN ]...

Command Options

The options for the clone command are:

  • source1-N: Specifies the source file(s) being cloned.

  • target1-N: Specifies the location of the clone(s).

  • -w, --wallet: Optionally specifies the path to the Exascale wallet directory.

  • -T, --trace: Optionally enables tracing and sets the trace level to 1 (minimum tracing), 2 (medium tracing), or 3 (maximum tracing).

    If the $ADR_BASE environment variable is set, the trace file is written to:

    $ADR_BASE/diag/EXC/xsh_<username>/<hostname>/trace/xsh_<date>.trc

    Otherwise, the trace file is written to:

    /tmp/diag/EXC/xsh_<username>/<hostname>/trace/xsh_<date>.trc

Usage Notes

Note the following information when using this command:

  • You can use a wildcard (%) in the source to specify multiple source files, in which case the corresponding target must also contain a matching wildcard.

  • All files in a clone operation must be in the same vault.

  • Multiple source and target pairs are permitted. In this case, the source file specifications are considered in order, and only the first match is used.

  • All clones created in the same operation are point-in-time consistent.