NAME
       ctoperate - operate on a ClearCase VOB

VERSION
       1.17-r350
                                                                             
SYNOPSIS
       ctoperate [-f] [(-v | -t)] (-c <comment> | -C <comment-file> | -n)
                 [-o (mk | ci | rm)] [(-x <file-spec> | -X <dir-spec>)...]
                 [(-l | -L) <label>] [(<file-spec> | <dir-spec>)...]
       ctoperate -h
       ctoperate -V
                                                                             
DESCRIPTION
       The command operates on all files specified by the <file-spec> arguments
       and  all  elements  in the trees spanned by the directories specified by
       the  <dir-spec>  arguments  (or  by the current working directory, if no
       arguments  are  supplied).  The command operation has to be specified by
       supplying  option  -o.  Operation  -o mk is used to create ClearCase VOB
       elements for all view private files and directories leaving them checked
       out.  Operation  -o  ci  additionally  causes  all  checked out file and
       directory  elements  to  be  checked in. In contrast to these operations
       operation  -o  rm removes view private files and directories and does an
       uncheckout  for checked out file and directory elements. If option -f is
       given, the handling of directories is not recursive.
       The  arguments  <file-spec>  and <dir-spec> may contain pattern matching
       operators  as  explained  below.  Be sure to quote them according to the
       needs of the shell used.
       For  ctoperate  to  work, the parent directories of the files and of the
       directories  handled  shall be ClearCase VOB elements. Moreover, exactly
       one of the comment options -c, -C or n has to be given.
       Unless  option  -h  or  -V is supplied, the command returns with an exit
       code 0 on success and with an exit code 1, if any error did occur.
                                                                             
OPTIONS
       -h     help:  print  this man page on standard output and exit with exit
              code 2.
                                                                             
       -V     version: print version info on standard output and exit with exit
              code 2.
                                                                             
       -f     flat:  suppress  recursive  descent  into  the  trees  spanned by
              directories.
                                                                             
       -v     verbose: issue additional diagnostic messages on stdout.
                                                                             
       -t     tell: do no actions, issue messages on stdout instead.
                                                                             
       -c <comment>
              use the string <comment> as ClearCase check in comment.
                                                                             
       -C <comment-file>
              use  the content of <comment-file> as ClearCase check in comment.
              The  file  shall  not  be  inside  the tree spanned by one of the
              directories <directory>.
                                                                             
       -n     use no ClearCase check in comment.
                                                                             
       -o <operation>
              <operation> is one of the following actions:
              mk: make ClearCase VOB elements for view private elements
                  leaving them checked out
              ci: additionally check in checked out VOB elements
              rm: in contrast remove view private elements and uncheckout
                  checked out VOB elements
                                                                             
       -x <file-spec>
              exclude  files  matched  by <file-spec> which may contain pattern
              matching  operators  as explained below but no path separator. Be
              sure  to  quote  <file-spec>  according to the needs of the shell
              used.
                                                                             
       -X <dir-spec>
              exclude  directories  and the whole trees spanned by them matched
              by  <dir-spec>  which  may  contain pattern matching operators as
              explained   below   but   no   path   separator. Be sure to quote
              <dir-spec> according to the needs of the shell used.
                                                                             
       -l <label-list>
              label  all  elements  handled  with  the  labels specified by the
              non-empty  whitespace  or  comma separated list <label-list>. The
              labels are generated from each list element by brace expansion as
              in the bash shell. Be sure to quote <label-list> according to the
              needs  of  the  shell  used. If a label does not yet exist, it is
              created.  This  option  may  be  used  only  in  conjunction with
              '-m ci -u ci'. It is an error, if some other ClearCase version of
              an element to be labeled already bears the label.
                                                                             
       -L <label-list>
              label  all  elements  handled  with  the  labels specified by the
              non-empty  whitespace  or  comma separated list <label-list>. The
              labels are generated from each list element by brace expansion as
              in the bash shell. Be sure to quote <label-list> according to the
              needs  of  the  shell  used. If a label does not yet exist, it is
              created.  This  option  may  be  used  only  in  conjunction with
              '-m ci -u ci'.  If  some other Clearcase version of an element to
              be  labeled already bears the label, this existing label is moved
              to the version just handled.
                                                                             
FILENAME EXPANSION
       The  evaluation of the spec arguments <file-spec> and <dir-spec> is done
       using  pattern  matching based file name expansion. If the spec contains
       one  of  the unescaped extended regular expression operators '(' or '|',
       it  is interpreted as extended regular expression as defined in the Open
       System  Group  Base  Specification  Issue  6, IEEE Std 1003.1-2004 (XBD:
       9.4). Otherwise if the spec contains no unescaped '{', it is interpreted
       as  filename  expansion pattern as defined in IEEE Std 1003.1-2004 (XCU:
       2.13.3).  Else  the spec is brace expanded as in the bash shell and each
       of the resulting words is interpreted as filename expansion pattern.
       On  windows  systems as escape character for brace expansion '%' is used
       instead  of  the  usual '\'. The bracket expressions used in the regular
       expressions  and  in the filename expansion patterns conform to IEEE Std
       1003.1-2004  (XBD:  9.3.5)  with  the exception that equivalence classes
       [=x=] of collating elements are not supported.

AUTHOR
       (C) 2005-2008 Tom Michaelis, SysToMath