vtrclip - MSB clip insertion/deletion utility


/usr/vtr/bin/vtrclip options add [-noindex | -rebuildindex ] clip ...
/usr/vtr/bin/vtrclip options rm clip ...
/usr/vtr/bin/vtrclip options convert clip ...


vtrclip enables clip insert and delete operations. The insert operation permits externally generated media to be introduced to the MSB clip cache. The delete operation permits cache-resident clip content to be safely deleted. The vtrclip utility allows users to convert sgi mpeg2 files to gxf files by invoking vtrmpegutil(1).

Clips may be specified either using the clip name or specifying the clip filename path (clip files are stored underneath /usr/vtr/clips).

The following general options may be specified:

Quietly perform the specified operation. Error messages are not suppressed.
-verbosity level
Set the verbosity to the specified level (for debugging).


Clips are added to the clip cache by specifying the add argument. The clip media file must reside in the appropriate directory underneath /usr/vtr/clips.

vtrclip generates an index (underneath /usr/vtr/index) for the clip before adding it to the clip cache unless, a pre-existing index is found, or the -noindex option is specified.

If a pre-existing index file is found, vtrclip does not rebuild this file unless the -rebuildindex option is specified.


Clips are removed from the clip cache by specifying the rm argument. vtrclip unconditionally removes the clip content and any attributed index file.


Sgi MPEG-2 clips are converted to GXF clips by specifying the convert subcommand. vtrclip converts the clip without prompting for comfirmation.


The MSB clip cache is intimately coupled to MSB execution. This implies that native UNIX filesystem operations against clip cache components, specifically clip content and index files, will corrupt and permanently perturb the cache structure, possibly leading to adverse or inconsistent MSB operation. It is therefore required that this utility, and others from the MSB command suite, be used exclusively to manipulate clip content elements outside of MVCP sessions. DO NOT use rm(1), mv(1), cp(1), or other native UNIX filesystem commands to manipulate clip content residing in the real-time filesystem.