• print the currect directory
#> ct pwd
 
• change the current directory
#> ct cd


• create a link
  #> ct ln -s source target
  
  
• create a directory
  #> ct mkdir newdir
#> ct mkelem -eltype directory newdir
  
  
• create a new element from an existing private object
  #> ct mkelem myfile

• remove the entry file.c from the current directory (which must be checked out)
  #> ct rmname file.c
  
  
• remove the element file.c from the VOB (use with care...)
  #> ct rmelem file.c
  

• list the element type
  #> ct lstype -kind eltype
  
  
• create an element type subtype of text_file
  #> ct mkeltype -supertype text_file -nc c_source
  

• list the VOBs
#> ct lsvob
 
• get the description of the vob
#> ct describe vob:/vobs/foobar_src
 
• unlock a vob
#> ct unlock vob:/vobs/foobar_src


• activate VOB /vobs/foobar
  #> ct mount /vobs/foobar


• activate all VOBs
#> ct mount -all

• import the file hierarchy ~/foobar in VOB /vobs/quux
  #> clearfsimport -follow -recurse -nsetevent ~/foobar /vobs/quux
  

• to import data from a ClearCase / CVS / PVCS / RCS / SCCS / SourceSafe repository in a VOB, use clearexport_ccase / clearexport_cvs / clearexport_pvcs / clearexport_rcs / clearexport_sccs / clearexport_ssafe and then clearimport.

• display the graphical help navigator
  #> ct man -graph

• list the existing views
#> ct lsview
 
• get information about a view:
  #> ct lsview -long myview
  
  
• create a new view
#> ct mkview -tag my_view /export/home/view_store/my_view.vw
 
• delete an existing view
#> ct rmview -tag my_view
 
• destroy a view that is no more accessible (for example on a dead machine)
  first retrieve the view uuis with
  #> ct lsview -long my_view
  then execute
  #> ct rmview -uuid my_uuid -avobs
  #> ct unregister -view -uuid my_uuid
  #> ct rmtag -view my_view
  
  
• return the name of the setview (the one set by the last "ct setview" command)
  #> ct pwv -setview -short
  
  
• return the name view corresponding to the current directory (it will be different from the setview if with use "cd /view/myview" for exemple)
  #> ct pwv -wdview -short
  
  
• recover a dumped view
#> ct reformatview -load -tag my_view
 
• the active views are accessible in /view

• start a dynamic view
  #> ct startview my_view
  (mkview, mktag and setview automatically call startview, so this is useful only in situations such as when we want to access the view through the /view path)
  

• create a new branch type
#> ct mkbrtype my_branch
 
• list the branch types
  #> ct lstype -kind brtype
  
  
• list the branch types, including the obsolete ones
  #> ct lstype -obsolete -kind brtype
  
  
• create a branch for an element
  #> ct mkbranch my_branch foobar.c
  
  
• destroy a branch of an element
#> ct rmbranch foobar.c@@/main/my_branch
 
• find all elements which have a given branch
#> ct find . -elem 'brtype(my_branch)' -print

• create a label type
#> ct mklbtype MY_LABEL
-shared to enable to use the label type from any replica
 
• list all label types
#> ct lstype -kind lbtype
 
• list all the labels sorted by creation date
  #> ct lstype -kind lbtype -fmt "%Nd %n\n" | sort
  
  
• delete a label type and the corresponding labels:
#> ct rmtype -rmall lbtype:LM_INTEG


• label the current version of a file
#> ct mklabel MY_LABEL file.c
 
• move a label on a file
#> ct mklabel -replace MY_LABEL file.c@@/main/my_branch/105
 
• remove a label on a file
#> ct rmlabel MY_LABEL fobar.c@@/main/105
 
• rename a label
#> ct rename lbtype:FOO BAR
 
• extract the files from a list which have / have not a given label
  #> cat list | xargs cleartool describe -fmt "%n %l\n" | grep MY_LABEL | awk '{ print $1 }'
#> cat list | xargs cleartool describe -fmt "%n %l\n" | grep -v MY_LABEL | awk '{ print $1 }'

  
• find out files with given labels
#> ct find . -ver 'version(MY_LABEL_1) || version(MY_LABEL_2)' -print
 
• check that the latest on the main branch is correctly labeled
#> ct find . -ver ' ( version(/main/LATEST) && \!version(MY_LABEL) ) || ( \!version(/main/LATEST) && version(MY_LABEL) ) ' -print

• create an attribute type
#> ct mkattype -nc MY_ATTRIBUTE
 
• create an attribute type with a default value
#> ct mkattype -default '"TRUE"' -nc MY_ATTRIBUTE
 
• list the existing attribute types
  #> ct lstype -kind attype
  
  
• attach an attribute with its default value to an element
#> ct mkattr -default MY_ATTRIBUTE code.c@@
 
• list the attributes of an element
#> ct describe -aattr -all foobar.c@@
 
• remove an attribute on an element:
#> ct rmattr MY_ATTRIBUTE code.c@@
 
• return the elements which have a given attribute
#> ct find . -element 'attype(MY_ATRIBUTE)' -print
 
• of course, this also works for the element versions
#> ct mkattr -default MY_ATTRIBUTE code.c
#> ct describe -aattr -all foobar.c
#> ct rmattr MY_ATTRIBUTE code.c

• lock/unlock a label

	unlock	lock	obsolete
unlock	N/A	ct lock lbtype:MY_LABEL	ct lock -obsolete lbtype:MY_LABEL
lock	ct unlock lbtype:MY_LABEL	N/A	ct lock -replace lbtype:MY_LABEL
obsolete	ct unlock lbtype:MY_LABEL	ct lock -replace lbtype:MY_LABEL	N/A

• lock a label type except for some users
  
#> ct lock -nusers foo,bar lbtype:MY_LABEL
 
• describe the lock of a label type
#> ct lslock lbtype:MY_LABEL


• this form is much more handy in a script
#> ct describe -fmt "%[locked]p" lbtype:MY_LABEL
but it does not indicate if the label is locked for all users or if there are some users who can still use the label

• delete a file version
#> ct rmver -force foobar.c@@/main/LATEST

• merge latest of main branch in current checked out version of the file
#> ct merge -to quux.c -version /main/LATEST
 
• this also works with a label
  #> ct merge -to quux.c -version MY_LABEL
  
  
• remove a merge arrow
#> ct rmmerge foobar.c@@/main/my_branch/LATEST foobar.c@@/main/18
 
• perform a findmerge from a given labeled version
#> ct findmerge . -fversion MY_LABEL -merge
-nc checkout the files with no comment
-com "comment" checkout the files with a comment
 
• findmerge from a branch
#> ct findmerge . -fversion /main/the_branch/LATEST -merge

• to delete a merge arrow, it is necessary to get its ID
  #> ct describe -long ffobar.c@@/main/4
  version "foobar.c@@/main/4"
   created 07-Nov-03.13:47:50 by John Doe (doe.develop@aaron)
   "fixed memory leak"
   Element Protection:
     User : vobadm   : r--
     Group: informix : r--
     Other:          : r--
   element type: c_source
   predecessor version: /main/3
   Hyperlinks:
     Merge@1392667@/vobs-awa/AW4.2_src <- /vobs-awa/AW4.2_src/src/lib/vtkImagePipeline/MMXBilinearZoom.c@@/main/sg_dvpt_27/2
  #> ct rmhlink Merge@1392667
  Removed hyperlink "Merge@1392667".
  

• checkout a file
#> ct co foobar.c
#> ct checkout foobar.c
-com "comment" with a given comment
-nc without comment
 
• uncheckout a file
#> ct unco foobar.c
#> ct unchecout foobar.c
-keep create a foobar.c.keep backup in the view
-rm create no backup
 
• checkin a file
#> ct ci foobar.c
#> ct checkin foobar.c
-com "comment" with a given comment
-nc without comment
-ident force the checkin even if the new version is identical to the previous one
 
• modify the checkin comment on a file
#> ct chevent -replace -c "fix bug XYZge12345" foobar.c@@/main/goto_m3/1


• append a string to the checkin comment on a file
#> ct chevent -c "more information" foobar.c@@/main/goto_m3/1
or
#> ct chevent -append -c "more information" foobar.c@@/main/goto_m3/1


• prepend a string to the checkin comment on a file
#> ct chevent -insert -c "some introductional information" foobar.c@@/main/goto_m3/1


• list the checked out files
#> ct lsco -short display only the filename
           -me list only files checked out by current user
           -cview list files check out in current view
           -all lists all the checkouts in the VOB (use the VOB defined by the argument if there is one)
           -fmt "format" lists the information as defined by the format



• #> ct lsco -recur dir
list files checked out in the filesystem subtree (instead of only the directory level)
take care the directory dir itself is not  taken into account! (this is the same if no directory name is given, the current directory will not be reported if it is checked out)


• #> ct lsco -d dir
list the checked out version of the directory, not of its elements
 
• unreserve a checked out file (in a deleted view, for example)
#> ct lsco -long
10-Aug-96.16:59:25     Ellie Jackson (jackson.user@oxygen)
checkout version "hello.c" from /main/37 (reserved)
by view: jackson_fix ("oxygen:/usr/home/jackson/ccviews/fix.vws")
"merge from bugfix branch"
#> ct unreserve -view oxygen:/usr/home/jackson/ccviews/fix.vws hello.c
 
• get the checkin comment of a version of a file
#> ct describe -fmt '%Nc' foobar.c@@/main/17

• return the config spec of the current view
#> ct catcs
 
• return the config spec of a view
#> ct catcs -tag my_view
 
• set a given file as the config spec
#> ct setcs /tmp/foobar
 
• change the config spec of a given view
  #> ct setcs -tag myview /tmp/foobar
  
  
• element * FOOBAR
  select all elements labeled FOOBAR
  
  element -directory  * FOOBAR
  select all directory elements labeled FOOBAR (i.e. created by ct mkdir or ct mkelem -eltype directory)
  
  element -file  * FOOBAR
  
select all file elements labeled FOOBAR (i.e. not the previous ones)


• config spec to see the labels as a given date (time does no work for LATEST)
element * /main/lm_rsna_13/LATEST
time 21-Dec.10:00
element * /main/AW4.1_B1.1.50.E -mkbranch lm_rsna_13
element * /main/AW4.1_B1.1.50.D -mkbranch lm_rsna_13
element * /main/AW4.1_B1.1.50.C -mkbranch lm_rsna_13
element * /main/AW4.1_B1.1.50.B -mkbranch lm_rsna_13
element * /main/AW4.1_B1.1.50.A -mkbranch lm_rsna_13
element * /main/AW4.1_B1.1.49.E -mkbranch lm_rsna_13
element * /main/AW4.1_B1.1.49.D -mkbranch lm_rsna_13
element * /main/AW4.1_B1.1.49.C -mkbranch lm_rsna_13
element * /main/AW4.1_B1.1.49.B -mkbranch lm_rsna_13
element * /main/AW4.1_B1.1.49.A -mkbranch lm_rsna_13
element * /main/AW4.1_B1.1.48.F -mkbranch lm_rsna_13
element * /main/AW4.1_B1.1.48.E -mkbranch lm_rsna_13
element * /main/AW4.1_B1.1.48.D_EXT -mkbranch lm_rsna_13
end time
element * /main/0 -mkbranch lm_rsna_13

• list the derived objects
  #>  ct lsdo
  

• authorize group write access to the current directory
#> ct protect -chmod g+w .

• list the integration comments of a given day
#> ct find . -version "brtype(main) && created_since(Friday)" -exec 'cleartool describe -fmt "----------- %n (%u)\n%c" $CLEARCASE_PN'
 
• list who has done what and when on the main branch since a given date
#> ct find . -ver 'brtype(main) && created_since(10-sep-2000)' -exec 'cleartool describe -fmt "%Nd %u %n\n" $CLEARCASE_XPN'

• list the changes done since december 19
  #> ct lshistory -recur -since 19-dec .
  

• list the changes done since december 19 only for the main branch
  #> ct lshistory -recur -since 19-dec -branch main .
  
  
• To really look for all elements versions, instead of
  #> ct find . -version 'version(mylabel)' -print
  the following command must be used
  #> ct find . -all -nvisible -version 'version(mylabel)' -print
  

• display all helps
#> ct help
 
• display help for a command
#> ct help command
or
#> ct command -help

• verbose mode
  #> clearmake -v
  
  
• compatibility with gmake
  #> clearmake -C gnu
  
  
• disable winking
  #> clearmake -V
  

• list the files directly used to create a derived object
#> ct catcr -short -nxname quux.o
 
• display the configuration records of the subtargets of the derived object
#> ct catcr -recurse derived_object
 
• display the consolidated  configuration records of the subtargets of the derived object
#> ct catcr -flat derived_object
 
• display only the versionned elements, not the derived objects, user to create derived_object
#> ct catcr -element_only derived_object
 
• list all the elements used to build some DOs
#> ct catcr -short -nxname -flat -element_only do1 do2 do3 | sort -u
 
• retrieve the list of the files not used during the build
1) list all the files
#> find . -print | xargs cleartool catcr -short -nxname |& tee /tmp/full_log
2) extract the files used for the build
#> grep '^/vobs/foobar_src' /tmp/full_log | sort -u > /tmp/l_used
3) extract the files in the VOB
#> grep '^cleartool: Error: Not a derived object: ' /tmp/full_log | sed 's/cleartool: Error: Not a derived object: "\(.*\)"/\1/' | sort > /tmp/l_present
4) script performing the lookup

#!/bin/ksh cat /tmp/l_present | while read line   do     if { ( fgrep -x $line /tmp/l_used > /dev/null ) } then       echo OK $line     else       echo KO $line     fi   done



• idem
#> ct ls -recur -view -short | xargs cleartool describe -fmt "%n %m\n" | grep 'derived object' | awk '{print $1}' | xargs cleartool catcr -short -nxname | sort -u > l
#> ct find `pwd` -type f -exec 'echo -n "$CLEARCASE_PN "; grep -x -c $CLEARCASE_PN l' | grep -v ' 1$'

• #> ct diff foo bar
  display the difference between files foo and bar
  ct diff - pred hello.c display the difference between the current version of hello.c and its predecessor
  -serial display in serial format instead of side-by-side
  -graph display the diff in a window
  
  
• check if the files have been modified
  #> foreach file ( `ct lsco -me -short -cview -recur`)
  if { ( ct diff -pred $file > /dev/null ) } then
    echo $file is unchanged
  endif
end
  
  
• display all the modifications in the checked out files:
#> ct lsco -me -short -cview -recur | xargs -n 1 cleartool diff -pred -serial_format

• desintegrate a day's work
1) get the list of the file and their version
#> ct find . -version "{ created_by(`whoami`) && created_since(28-Oct-99) && \!created_since(29-Oct-99) && brtype(main) }" -print
2) apply a negative delta on these files with the following script

#!/bin/csh set file=`echo $1 | sed 's/\(.*\)@@.*/\1/'` set version=`echo $1 | sed 's/.*@@\(.*\)/\1/'` cleartool checkout-nc $file cleartool merge -to $file -delete -version $version



• #> ct annotate hello.c
  create a file hello.c.ann which contains, for each line, who, when and on which version the line has been changed for the last time.
  -rm also displays the lines that have been removed
  -all also displays all the lines present in any version of the file (i.e. even the lines which are not in a predecessor version, but which are present on other branches)
  -out foobar put the result in the file foobar instead of hello.c.ann
  -out - send the result in stdout instead of hello.c.ann
  

• list the replicas of the VOB
  #> ct lsreplica
  

• on my machine, the binaries are in /usr/atria
the configuration and log files are in /var/adm/atria
 
• display the version
  #> cleartool -version
  
  
• display the current license usage
#> clearlicense
 
• tar the elements of the VOB
#> tar cvf /tmp/aim.tar ` ct find . -type f -exec 'echo $CLEARCASE_PN' `
 
• run a grep only on the elements of the VOB (not the derived objects)
#> ct find /vobs/foobar_src -exec 'grep "SAFETY WARNING" $CLEARCASE_PN /dev/null'

Last update: January 1^st, 2006 - Laurent