chdepot

change the properties of a depot

Usage

accurev chdepot -p <depot-name> <new-name> 
accurev chdepot -p <depot-name> { -ke | -kd } { -Ci | -Cs }

Description

The chdepot command can change the name of a depot. A depot’s base stream has the same name as the depot itself. Accordingly, chdepot also renames the depot’s base stream, with a chstream command. See Entity Names for information on naming depots.

With the -k option, chdepot changes the setting of the depot’s exclusive file locking property. If this property is enabled (-ke), all of the depot’s workspaces use exclusive file locking. If this property is disabled (-kd), each of the depot’s workspaces can be set to use, or not use, exclusive file locking. For more on this feature, see Workspace Options in the mkws reference page.

A depot’s case-sensitivity (mkdepot -C) can be changed with the -Cs and -Ci options, within the following restrictions:

  • You can always change a depot’s case from insensitive to sensitive.
  • You can only change from sensitive to insensitive if the depot contains no elements.

Reusing a Depot Name

chdepot does not make the depot’s original name available for reuse. The only way to reuse a depot name is to

  • Rename the depot using chdepot.
  • Use the AccuRev administration utility command maintain rmdepot to completely remove the depot from the AccuRev repository. See Removing a Depot from the AccuRev Repository in the AccuRev AdminGuide.
  • Delete or rename the depot’s directory in the AccuRev storage directory tree
  • Create a new depot with the original name using mkdepot.

Options

-p <depot-name>

Specify the depot to be renamed.

-ke

Enable exclusive file locking on a depot-wide basis. All of the depot’s workspaces use exclusive file locking.

-kd

(default) Disable depot-wide exclusive file locking. Each of the depot’s workspaces can be set individually, either to use or not to use exclusive file locking.

-Cs

Set the depot to be case sensitive.

-Ci

Set the depot to be case insensitive. You can do this only if the depot contains no elements. This is useful when you first set up a depot with mkdepot and realize, before using it, that it should have been set to be insensitive.

Examples

Fix a misspelled depot name:

> accurev chdepot -p mercy mercury

Force all of a depot’s workspaces to use exclusive file locking:

> accurev chdepot -p mercury -ke

Change a depot to be case sensitive:

> accurev chdepot -p mercury -Cs

Change a depot to be case insensitive (will fail if the depot is not empty):

> accurev chdepot -p mercury -Ci

See Also

chstream, mkdepot, show (depots)