How to find all checkedout files with ClearCase cleartool?

Question

I'm trying to setup our ClearCase with Hudson for a continuous integration (and deployment later).

I finally got a UCM view for the build, but unfortunatly our build process checks out files to store the build number. Now the build broke and the file is still checked out, preventing the next build.

I already now about cleartool find . -type f, but I can't figure out how to find checked out files. I know the syntax of UNIX' find, so that isn't a problem.

Can someone point me to a documentation of the query language or maybe give an example to find checked out or hijacked files?

Answer 1

You can start by this SO question on how to list private files.

Then it depends on the nature of your ClearCase view.
On a dynamic view for instance, a simple ct lsprivate list private files (including hijacked ones) and checkout files.

The official command is cleartool lscheckout (or 'lsco').
If you are within the right vob within your view:

$/path/to/view/vobs/aVob
cleartool lsco -rec -cview

,should list all checked out files from any user in any sub-directories of said vob.

But if your build is broken because of files checked out in several vobs, then you need to widen the scope:

$/path/to/view/
cleartool lsco -avobs -cview

(you don't need to be in a specific vob in this case)

---

As Manjunath K Mayya points out in the comments:

To list only the file names, without the version details, we can use "short":

cleartool lsco -short -avobs -cview