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