|
ClearCase::Wrapper::DSB - David Boyce's contributed cleartool wrapper functions |
ClearCase::Wrapper::DSB - David Boyce's contributed cleartool wrapper functions
This is an overlay module for ClearCase::Wrapper containing David
Boyce's non-standard extensions. See perldoc ClearCase::Wrapper for
more details.
##:Keyword: value ...
The value of any attribute may be retrieved by running
<cmd-context> catcs -attr keyword ...
And to print all attributes:
<cmd-context> catcs -attr -all
Start
attribute as described above; in other words -start is a synonym for
-attr Start.
The workon command (see) uses this value. E.g., using workon instead of setview with the config spec:
##:Start: /vobs_fw/src/java
element * CHECKEDOUT
element * /main/LATEST
would set the view and automatically cd to /vobs_fw/src/java.
The -new flag causes it to ignore the previous comment.
See edattr for the editor selection algorithm.
If the -view flag is used view attributes are edited instead. See the enhanced catcs command for further discussion of view attributes.
The environment variables WINEDITOR, VISUAL, and EDITOR are checked in that order for editor names. If none of the above are set, the default editor used is vi on UNIX and notepad on Windows.
Flags -nnn are accepted where nnn represents the number of versions
to go back. Thus grep -1 foo would search only the predecessor.
When -iflocked is used, no lock will be created where one didn't previously exist; the -nusers list will only be modified for existing locks.
The -replace flag is special; it uses the administrative fix_prot tool to completely replace any pre-existing identity information. This gives the view's permissions a ``clean start''; in particular, any grants of access to other groups will be removed.
This operation will not work on a running view. Views must be
manually stopped with endview -server before reprotection may proceed.
Warning: this is an experimental interface which has not been tested in all scenarios. It cannot destroy any data, so there's nothing it could break which could't be fixed with an administrator's help, but it should still be used with care. In particular, it's possible to specify values to -chmod which will confuse the view greatly.
Adds a -sync flag. This is similar to -current except that it analyzes the CS dependencies and only flushes the view cache if the compiled_spec file is out of date with respect to the config_spec source file or any file it includes. In other words: setcs -sync is to setcs -current as make foo.o is to cc -c foo.c.
Adds a -needed flag. This is similar to -sync above but it doesn't recompile the config spec. Instead, it simply indicates with its return code whether a recompile is in order.
Adds a -expand flag, which ``flattens out'' the config spec by inlining the contents of any include files.
If the view is already mapped to a drive letter that drive is used. If not, the first available drive working backwards from Z: is used. Without -persistent a drive mapped by setview will be unmapped when the setview process is exited.
With the -window flag, a new window is created for the setview. A beneficial side effect of this is that Ctrl-C handling within this new window is cleaner.
The setview emulation sets CLEARCASE_ROOT for compatibility and adds a new EV CLEARCASE_VIEWDRIVE.
UNIX setview functionality is left alone.
Processing dir ... and End dir ... messages so you can see what
files actually changed.
<cmd-context> winkin -tag otherview /vobs_myvob/dir1/dir2/file
The -vp flag, when used with -tag, causes the ``remote'' file to be
converted into a DO if required before winkin is attempted. See the
winkout extension for details. Note: this feature depends on
setview and thus will not work on Windows where setview has been
removed. However, it would be possible to re-code it to use the setview
emulation provided in this same package if you really want the
feature on Windows.
If the -promote flag is given, the view scrubber will be run on these new DO's. This has the effect of promoting them to the VOB and winking them back into the current view.
If a meta-DO filename is specified with -meta, this file is created as a DO and caused to reference all the other new DO's, thus defining a DO set and allowing the entire set to be winked in using the meta-DO as a hook. E.g. assuming view-private files X, Y, and Z already exist:
ct winkout -meta .WINKSET X Y Z
will make them into derived objects and create a 4th DO ``.WINKSET'' containing references to the others. A subsequent
ct winkin -recurse -adirs /view/extended/path/to/.WINKSET
from a different view will wink all four files into the current view.
The list of files to convert may be derived via
-dir/-rec/-all/-avobs, provided in a file containing a list of files
with -flist, or specified as a literal list of view-private files.
When using -dir/-rec/-all/-avobs to derive the file list only the
output of lsprivate -other is considered unless -do is used;
-do causes existing DO's to be re-converted. Use -do with care as
it may convert a useful CR to a meaningless one.
The ``-flist -'' flag can be used to read the file list from stdin, which may be useful in a script.
If a file called .viewenv.pl exists in the initial working
directory, it's read before starting the user's shell. This file uses
Perl syntax and must end with a ``1;'' like any require-d file. Any
unrecognized arguments given to workon following the view name will
be passed on to .viewenv.pl in @ARGV. Environment variables
required for builds within the setview may be set here.
Copyright (c) 1997-2002 David Boyce (dsbperl AT boyski.com). All rights reserved. This Perl program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.
perl(1), ClearCase::Wrapper
|
ClearCase::Wrapper::DSB - David Boyce's contributed cleartool wrapper functions |