Clearcase User Commands: Configure user aliases:

File: $HOME/.bashrc alias ct=/usr/atria/bin/cleartool alias sv='/usr/atria/bin/cleartool setview' umask 022

File: $HOME/.cshrc alias ct /usr/atria/bin/cleartool alias sv '/usr/atria/bin/cleartool setview' umask 022

This umask will set the default privileges on new files and direcotries. Default protection will be set so that the user may write data but others can read.

Commands:

ClearCase Command Descriptionct -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

orct mktag -vob vob-tag ...

Create a view-tag or VOB-tag.

ct mkview -tag user1_view -stglocviewstore

Create a new view in "viewstore" Clearcase server view mount point (see YoLinux client or serverinstallation 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_viewct endview -server user-name_view

Deactivate a Clearcase view. (First exit view)Useful if you get stale NFS handles.

ct rmview -tag temp_viewor

ct rmview temp_view

Remove view temp_view.

cleartool setview username_viewsv user-name_view

Set Clearcase view. See alias defined above.

ct pwv Print working view/current view:Working directory view: username_viewSet view: username_view

echo $CLEARCASE_ROOT Print current view path.ct ls -lct ls -vob_only

Using current view, show files, private files, file version and rule.-vob_only: List elements and not derived objectsFormat:...version file.ext@@/main/2 Rule: element */main/LATESTdirectory version Directoy-name@@/main/2 Rule: element * /main/LATESTview 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@@/mainfile-name.ext@@/main/0file-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-directoryct 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-idct 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-elementChange the comment on a label.

ct lscoct lsco -rct lsco -avobs -me

List all checked out files in current directory.

ct lsco -avobs -cview Flag "-r" recusivly looks in sub directories.List all files checked out to all views.List checkouts in view.

ct lscheckout -lct lsco -lct 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)' -printct 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 lsprivatect lsp -co

List all private files in current view. View private files are files residing in the Clearcase filesystem but not under the control of Clearcase. i.e. object files as a result of a compile. May not be viewable by others.List files checked out to current view.

ct mklbtype -nc LABEL_NAMEct mklbtype -c "comment" LABEL_NAME

Create a label to be used later.

ct lstype -kind lbtype -short | sort List labels.

ct describe -l file.extDescribe 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.extct 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 if label has been applied. Use option "-rmall" to remove label and

all instances of its application.

ct rmtype -rmall -brtype branch-typeRemove branch and all files / directories in branch from Clearcase. Data disposed in "lost-found".

ct find -avobs -version "lbtype (Build-Label)" -printct 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-nameCheck-Out file (RCS command) -No Comment

ct mkdir directory-nameCreate a directory. Checkout parent directory first.

ct ln -s source-directory-namelocal-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. All history and knowledge of the element is completely removed. By contrast, the "ct rm" command will remove the file and not the history and the directory must be checked out in order to make this change.

ct rmelem -rm filenameRemove 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/LATESTorct rmver filenameorct rmver filename@@/main/22or remove specifed version on main branch:ct rmver -force -xlabel -ver

/main/22 file-or-element-name

Remove latest version checked in of the file from Clearcase. Second example removes version 22 from the Clearcase change management system. Previous versions will be available from the archive.

ct rm filename Remove file from Clearcase view. First perform a checkout ("ct co") of the file and directory. Past versions will be available from the archive although not visible in current view. Safer than "ct rmelem" which removes all knowledge of the file old and new.

ct reserve file-nameLock file. Convert unreserved checkout to reserved.

ct unco file-name UN-Check-Out file. Cancel a checkout of

ct unco -rm file-namect uncheckout file-name

a file.Cancel a checkout of a file and remove file which was checked out. Not removed from Clearcase, just view private the checked out file is deleted/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-nameNot locked. Checkout to read, print, etc. Same as above command.

ct ci file-nameCheck-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-namect 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 the parent directory first. If moving file to a new directory, check out the target directory as well.

ct protect -r -chmod 775 directory-or-file-name Set directory/file/element protection.

Configspec commandsct catcs

ct catcs -tag view_tag

Print rules of current view (configspec):element * CHECKEDOUTelement * /main/LATEST

Look at the configspec associated with another view.

ct edcs Edit current rules of view (config spec): Change from:element * CHECKEDOUTelement * /main/LATEST

To:element * Build-Labelelement -directory * /main/Latest

Close vi: wqSet config spec for view "username_view"? [yes]

ct setcs -defaultct setcs -cur

Reset to default view rules.Re-evaluate current configspec.

ct update -add_loadrules Updates elemets in snapshot view. GUI tool. Reevaluates config spec and reselects VOB elements to show. The option "-add_loadrules" allows you to load rules to your config spec and load

elements which satisfy the rules.

Help and Information commands

ct man clearcase-commandct man env_ccase

Man page for Clearcase command.List Clearcase environment variables.

ct apropos search-wordList commands and man page summaries for related Clearcase command.

ct help

ct help clearcase-commandHelp facility (simple). Lists possible command arguments.

Tree/Branch commandsct lstype -kind brtypect 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-namect 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 mkbrtype to create the branch type (name) first. This command also checks out the file. The config spec needs to include this branch so file can be viewed.

ct rmbranch Remove a branch in version tree.ct mkbrtypemkbrtype -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 ./ -flag 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 commandsct 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-nameCreate file cvt_data which is the result of a recursive export of files from given directory name..

clearlicenseList number of allowable client connections and list who is holding a license.

clearlicense -rel userRelease license from user who is holding a license.

getcachect 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.

locko ct lock

vob:/vob/projecto ct lock -brtype -

obsoletebranch-typeo ct lock

lbtype:LABEL_NAME

o ct lock file-name.cpp

o ct lock -nusers user1, user2 brtype:branchX

Command to lock a VOB, element, branch, type object or storage pool.

o Lock vob for read-only access.Disable write, create, delete, modify

o Hide branch permanently.o Lock code with given label.o Lock a file from use.

o 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.

rmvobct 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.

reformatvobUpdate 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-tagActivate 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.

setcachect setcache -view -host -cachesize 1024kct setcache -view -site -cachesize 2mct setcache -view -cachesize

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

5mview_tag 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.

o View cache sizeo defaults for Windows

clients

o defaults for chechin and checkout preserve

space Report VOB disk space usage.