ClearCase Command |
Description |
ct -ver |
Display Clearcase, cleartool, db_server and VOB database schema version. |
ct lsvob |
List vob mount table: * /vob/VOB-NAME.vbt /hosts/host-name/r1vob/vobs/vobstore/VOB-NAME.vbs public
* /vob/practice_vob.vbt /hosts/host-name/view-name/Vobs/vobstore/practice_vob.vbs public |
ct dump element-or-DO |
Print internal Clearcase info. |
ct lsview |
List all views: millesc_view /hosts/host-name/view-name/Views/millesc_view.vws
* user-name /hosts/host-name/view-name/Views/reg_view.vws |
ct lsview view-tag |
List view path. |
ct mktag -view -tag dynamic-view-name -nstart /hosts/node-name/home/cleardata/views/dynamic-view-name or ct mktag -vob vob-tag ... |
Create a view-tag or VOB-tag. |
ct mkview -tag user1_view -stgloc viewstore |
Create a new view in "viewstore" Clearcase server view mount point (see YoLinux client or server installation tutorial). List view storage locations: ct lsstgloc |
ct mkview -tag tmpA_view /hosts/node-name/home/cleardata/views/tmpA_view |
Create a new view. |
ct setview user-name_view |
Set current view to user-name_view. |
ct startview common_view |
Set current view to common_view without starting a Clearcase shell environent. It allows one to view (only) the files. Path: /view/common_view/vob/vob-name/... |
ct endview common_view ct endview -server user-name_view |
Deactivate a Clearcase view. (First exit view) Useful if you get stale NFS handles. |
ct rmview -tag temp_view or ct rmview temp_view |
Remove view temp_view. |
cleartool setview username_view sv user-name_view |
Set Clearcase view. See alias defined above. |
ct pwv |
Print working view/current view: Working directory view: username_view
Set view: username_view |
echo $CLEARCASE_ROOT |
Print current view path. |
ct ls -l ct ls -vob_only |
Using current view, show files, private files, file version and rule. -vob_only: List elements and not derived objects Format: ...
version file.ext@@/main/2 Rule: element */main/LATEST
directory version Directoy-name@@/main/2 Rule: element * /main/LATEST
view private object file2.c
... |
ct lstype -kind lbtype -list labels |
List labels |
ct lsvtree -all file-name.ext |
List file version label and build label: (version tree) file-name.ext@@/main
file-name.ext@@/main/0
file-name.ext@@/main/1 (BUILD_1_0)
file-name.ext@@/main/2 (BUILD_1_1) |
ct lsvtree -all pref* |
List file version label and build label for files beginning with "pref" |
ct lshistory [all] file-or-directory ct lshistory file-name |
List file or directory version history. List event rocords for a given file. |
ct chevent -c 'new-comment-goes-here' -replace -event event-id ct chevent -c 'new-comment-goes-here' -replace -lbtype label |
Change the comment on a version of an element. Lookup event id: ct lsh -event file-or-element Change the comment on a label. |
ct lsco ct lsco -r ct lsco -avobs -me ct lsco -avobs -cview |
List all checked out files in current directory. Flag "-r" recusivly looks in sub directories. List all files checked out to all views. List checkouts in view. |
ct lscheckout -l ct lsco -l ct lsco -recursive -me -cview |
List checked out files. (same) List files in current directory and subdirectories checked out to you in current view. Omit -cview tag to get all. |
ct catcr file-name |
List configuration record for a file. |
ct find ./ -branch 'brtype(branch-name)' -print ct find ./ -version(main/LATEST) && \! version(LABEL_X)' -print ct find -avobs -nxname -element 'brtype(view_name)' -print |
List files in branch with search name or attribute. List files with label "LATEST" but not LABEL_X. |
ct lsprivate ct lsp -co |
List all private files in current view. View privatefiles are files residing in the Clearcase filesystem but not under thecontrol of Clearcase. i.e. object files as a result of a compile. Maynot be viewable by others. List files checked out to current view. |
ct mklbtype -nc LABEL_NAME ct mklbtype -c "comment" LABEL_NAME |
Create a label to be used later. |
ct lstype -kind lbtype -short | sort |
List labels. |
ct describe -l file.ext |
Describe object in VOB. Lists branch and version of file and configspec used in view. |
ct describe file-or-directory |
List file or directory information. |
ct describe -long element:file-or-directory |
List file or directory information. |
ct describe -long vob:/vob |
List vob information. |
ct mklabel LABEL_NAME file-name.ext ct mklabel -r LABEL_NAME |
Apply label to a file. Label elements in directory tree. |
ct mklabel -replace NEW_LABEL_NAME file-name.ext@@/main/4 |
Apply label to a newer version of the file. |
ct rmtype -rmall -force lbtype:LABEL_NAME ct rmtype -lbtype -rmall LABEL_NAME |
Remove a label of the name given. The option "-rmall"causes the removal of all instances of the label on all files /directories.Remove label type and all occurrences of the label. |
ct rmtype lbtype:LABEL_NAME |
Remove label from Clearcase. It will not be removed iflabel has been applied. Use option "-rmall" to remove label and allinstances of its application. |
ct rmtype -rmall -brtype branch-type |
Remove branch and all files / directories in branch from Clearcase. Data disposed in "lost-found". |
ct find -avobs -version "lbtype (Build-Label)" -print ct find . -name '*.[hc]' -element 'lbtype_sub(LABEL_NAME)' -print |
Print all files and file versions going into build specified. list all .h and .c files whith the given label. |
ct co -nc file-name |
Check-Out file (RCS command) -No Comment |
ct mkdir directory-name |
Create a directory. Checkout parent directory first. |
ct ln -s source-directory-name local-directory-name |
Create a symbolic link to a directory. Checkout parent directory first. |
ct mkelem -ci -nc filename |
Add file to Clearcase control. |
ct rmelem filename |
Remove file from Clearcase control. Allhistory and knowledge of the element is completely removed. Bycontrast, the "ct rm" command will remove the file and not the historyand the directory must be checked out in order to make this change. |
ct rmelem -rm filename |
Remove file from Clearcase control and remove private view file. |
ct rmelem directory-name/* |
Remove directory, revision history and its contents from Clearcase control. |
ct rmver filename@@/main/LATEST or ct rmver filename or ct rmver filename@@/main/22 or remove specifed version on main branch: ct rmver -force -xlabel -ver /main/22 file-or-element-name |
Remove latest version checked in of the filefrom Clearcase. Second example removes version 22 from the Clearcasechange management system. Previous versions will be available from thearchive. |
ct rm filename |
Remove file from Clearcase view. First perform a checkout("ct co") of the file and directory. Past versions will be availablefrom the archive although not visible in current view. Safer than "ctrmelem" which removes all knowledge of the file old and new. |
ct reserve file-name |
Lock file. Convert unreserved checkout to reserved. |
ct unco file-name ct unco -rm file-name ct uncheckout file-name |
UN-Check-Out file. Cancel a checkout of a file. Cancel a checkout of a file and remove file which was checked out. Notremoved from Clearcase, just view private the checked out file isdeleted/cleaned up. |
ct co -unr -nc file-name |
Checkout file even though file is checked out by another. Checkout "unreserved", must be merged at a later time. |
ct checkout -unreserved file-name |
Not locked. Checkout to read, print, etc. Same as above command. |
ct ci file-name |
Check-In file. (also ct checkin file-name) Enter comment,enter "." as sole character on line and enter. |
ct diff -gra -pre file-name & ct diff -pred file-name ct xdiff -pred file-name |
Graphical Diff/Merge tool. Clearcase diff between current file and predecessor. X-windows diff with predecessor. |
ct mv file-name_A file-name_B |
Rename a file. Be sure to checkout theparent directory first. If moving file to a new directory, check outthe target directory as well. |
ct protect -r -chmod 775 directory-or-file-name |
Set directory/file/element protection. |
Configspec commands |
|
ct catcs ct catcs -tag view_tag |
Print rules of current view (configspec): element * CHECKEDOUT
element * /main/LATEST Look at the configspec associated with another view. |
ct edcs |
Edit current rules of view (config spec): Change from: element * CHECKEDOUT
element * /main/LATEST To: element * Build-Label
element -directory * /main/Latest Close vi: wq Set config spec for view "username_view"? [yes] |
ct setcs -default ct setcs -cur |
Reset to default view rules. Re-evaluate current configspec. |
ct update -add_loadrules |
Updates elemets in snapshot view. GUI tool. Reevaluatesconfig spec and reselects VOB elements to show. The option"-add_loadrules" allows you to load rules to your config spec and loadelements which satisfy the rules. |
Help and Information commands |
|
ct man clearcase-command ct man env_ccase |
Man page for Clearcase command. List Clearcase environment variables. |
ct apropos search-word |
List commands and man page summaries for related Clearcase command. |
ct help ct help clearcase-command |
Help facility (simple). Lists possible command arguments. |
Tree/Branch commands |
|
ct lstype -kind brtype ct lstype -kind brtype -invob /vob/vob-name |
List all branches. List all branches in the vob specified. |
ct find -avobs -version 'brtype(branch-type)' -print |
Find all files of the specified branch name in all mounted VOB's. Find branch name with the ct lstype command.. |
ct lsvtree -all * ct lsvtree file-name ct lsvtree -g file-name |
List version trees (labels and branches) of files (even those without labels or branches). List all branches of specified file. Launch GUI display and show version tree (labels and branches) for a given file. ([Potential Pitfall]: You may have to issue the command export LANG=C prior to launching GUI.) |
ct chtype |
Change element type or rename branch. |
ct mkbranch ct mkbranch -nc branch-name file-to-branch.cpp |
Create a new branch in version tree. Use the command mkbrtypeto create the branch type (name) first. This command also checks outthe file. The config spec needs to include this branch so file can beviewed. |
ct rmbranch |
Remove a branch in version tree. |
ct mkbrtype mkbrtype -c "Comment goes here" branch_name |
Create a new branch type object. |
ct merge |
Merge changes/differences of a file from another branch. |
ct findmerge ct findmerge ./ -ftag VIEW-TAG -print |
Determines whether a merge is required for a file in your view. Find files in current directory tree which need to be merged. Use the describe command to see if branch has been merged. If so it wil be stated as such. |
Derived Objects commands |
|
ct lsdo -l |
List derived objects. |
ct rmdo |
Remove a derived object. |
ct winkin *.o *.a executables |
Wink-in a derived object. |
Admin commands |
|
clearexport_ffile -r directory-name |
Create file cvt_data which is the result of a recursive export of files from given directory name.. |
clearlicense |
List number of allowable client connections and list who is holding a license. |
clearlicense -rel user |
Release license from user who is holding a license. |
getcache ct getcache -mvfs |
Display Clearcase view or MVFS cache parameters. Troubleshoot by listing cache misses (Cache misses are bad). Perform this command on the server itself. |
getlog |
Examine Clearcase log files. |
hostinfo |
Display configuration data for a Clearcase host. |
lock
- ct lock vob:/vob/project
- ct lock -brtype -obsolete branch-type
- ct lock lbtype:LABEL_NAME
- ct lock file-name.cpp
- ct lock -nusers user1, user2 brtype:branchX
|
Command to lock a VOB, element, branch, type object or storage pool.
- Lock vob for read-only access.Disable write, create, delete, modify
- Hide branch permanently.
- Lock code with given label.
- Lock a file from use.
- Lock all users except user1 and user2 on branchX
|
unlock ct unlock -brtype branch-type |
Unlock a VOB object. |
lslock |
List locks. |
lsclients |
List client list for lisence or registry host server. |
lsreplica |
List replicas of a VOB. |
mkpool |
Create or modify VOB storage pool. |
rmpool |
Remove a storage pool from a VOB. |
lspool |
List storage pools. |
chpool |
Change the storage pool to which an element is assigned. |
mkregion |
Register a new Clearcase network region. |
rmregion |
Unregister a Clearcase network region. |
lsregion |
List Clearcase network region. |
mktrigger |
Attach a trigger to an element. |
rmtrigger |
Remove trigger from an element. |
mktrtype |
Create a trigger object. |
mkvob ct mkvob -tag VOB-tag -c "comment" /vobpath |
Create and register a versioned object base. |
rmvob ct rmvob /vobpath |
Remove a VOB. |
lsvob |
List of mounted VOBs. |
checkvob |
Fix inconsistancies between VOB database and storage pools. |
protectvob |
Change owner or group of a VOB. |
reformatvob |
Update the format of a VOB. Use command "ct -ver" to find the current VOB database schema version. |
rmtag |
Remove a VOB tag from a storage registry. |
complete_migration |
Take VOB out of migration mode. |
mount ct mount VOB-tag |
Activate a VOB. |
unmount ct umount VOB-tag |
Deactivate a VOB. ("ct describe -vob" to show VOB info/owner) |
register |
Create an entry in the VOB/view storage registry. |
unregister |
Remove a VOB/view from storage registry. |
relocate |
Move elements and directory trees from one VOB to another. |
rename |
Asign a new name to a Clearcase object (i.e. pool, replica, label). Use mv to change the name of a file or directory. |
setcache ct setcache -view -host -cachesize 1024k ct setcache -view -site -cachesize 2m ct setcache -view -cachesize 5m view_tag |
Set Clearcase view or MVFS cache parameters. Set cache size for all views on server to 1024 Kb. Set cache size for all views site-wide to 2 Mb. set cache size for a single specified view. View with ct lssite -inquire |
mvfscache |
Controls and monitors MVFS caches (dynamic views only). |
ct lssite -inquire |
List site-wide properties in the site config registry. |
setsite |
Sets or unsets site-wide properties in the site config registry.
- View cache size
- defaults for Windows clients
- defaults for chechin and checkout preserve
|
space |
Report VOB disk space usage. |