clone - Clone a directory hierarchy.




clone [--verbose] [--preserve] [--dryrun] [--precious] [--ref=<path>] src dest [relative-src]


The clone command shadows a directory hierarchy using symbolic links. The two required arguments are the directory to clone and the destination path of the cloned hierarchy. The source is assumed to be a directory. The destination components, which are also assumed to be directories, are created if they do not already exist.

The 3rd, optional, argument allows the symbolic link targets to be created relative to another name space than the one existing on the host machine. This can be useful, for instance, when cloning hierarchies for a client workstation that may mount directories from the host in another location.

If a file already exists, in any fashion, in the destination hierarchy, the source file to be cloned is ignored. This can allow private copies of files in a hierarchy to be maintained without fear they will be deprecated when the clone command is executed. However, if a file corresponding to one in the cloned hierarchy is removed, the file is also removed from the cloned hierarchy blindly.


--verbose Causes link entries to be named as they are made.

--preserve Causes owner, uid and permissions to be preserved from the file being cloned.

--dryrun Actions are not performed, only reported.

--precious Files/directories in the target are precious and will not be removed.

--quiet Don't report warning messages when preserving
precious files.

--shownew Print a message about new files/directories in the target.

--ref Path of the original source directory, for the case where a clone of a clone is being generated.

--help Print manpage.


Set the environment variable CLUSTER_CONFIG to the location of the cluster database, for example /cluster/machine/machine_name.


The default paths for location of the database, cloned directories, and other defaults are recorded in $CLUSTER_CONFIG/


boot, clone, console, discover, dumpdb, lookup, power, status