change the name and/or definition of a reference tree


accurev chref -r <reftree-name> <new-name>
accurev chref -r <reftree-name> [ -l <new-location> ] [ -m <new-machine> ]
[ -e <eol-type> ]


Note: Before changing the location of a reference tree, consult A Word of Caution on Windows Zip Utilities in the AccuRev Admin Guide.

The chref command registers with AccuRev the fact that a reference tree has changed location. However, chref does not physically move the contents of the reference tree. Before using chref, you must move the reference tree yourself, using operating system commands such as tar (UNIX/Linux) or xcopy (Windows).

You can also use chref to change the name of a reference tree. You can subsequently create a new reference tree with the original name, or rename an existing reference tree to the original name. AccuRev will consider the two reference trees to be distinct, even though they’ve shared the same name (at different times). See Entity Names for information on naming reference trees.

Note: You cannot change the backing stream of an existing reference tree. You must use mkref to create a new reference tree.


-r <reftree-name>

Specify the name of the reference tree to be changed.

-l <new-location>

Specify the pathname where you have moved the reference tree. You must use a pathname that is valid on the machine where you are executing the chref command; if necessary, AccuRev will figure out the actual pathname on the machine where the reference tree has been moved.

Typically, you cd to the location where you have moved the reference tree, then use “.” as the argument to the -l option. See Examples below.

-m <new-machine>

Specify the hostname where you have moved the reference tree. It is usually not necessary to use this option, even if you move the reference tree to another machine.

-e <eol-type>

Specify the line terminator to be used when an AccuRev command (e.g. update, co) copies a version of a text file from depot storage to the reference tree. (In depot storage, all text files are stored with the AccuRev-standard line terminator, NL.) The <eol-type> can be d (default: use the standard line terminator for the client machine’s operating system), u (use the UNIX/Linux line terminator, NL), or w (use the Windows line terminator, CR-NL).


Rename a reference tree:

> accurev chref -r nbuild nightly_build

After moving the contents of reference tree amber_1.3.2 to a network storage area accessed on your machine as /net/bigdisk/reftree/amber132, register the new reference tree location:

> accurev chws -w amber_1.3.2 -l /net/bigdisk/reftree/amber132

See Also

mkref, show (refs)