Name
copyddb - Copy Design Database Utility
Synopsis
copyddb srcfile dstfile {-ms|-md|-mr}
{-a|-as|-al|-ac|-sp|-ss|-sl|-sm|-ll|-lp|-ls|-ld|-cl|-cc|-cp|
-drc|-llib|-gtab|-fnt|-sct|-lct|-ict|-ulp|-ull|-rule|-recover} [pattern]
Description
The
copyddb utility program copies selected database class entries and all their references from one DDB (Design DataBase) file to another.
copyddb can be used as a batch mode driven tool for merging libraries or updating job design files.
copyddb accepts two filenames as arguments.
srcfile and
dstfile are the names of the DDB source file and the DDB destination file (these files must be available with extension
.ddb unless file name extensions are explicitly included with the file name specifications).
copyddb copies elements from the source file to the destination file. The merge switch is used to control whether existing destination file entries should be replaced overwritten (source file is master) or not (destination file is master) or whether only existing destination file elements should be overwritten (replace).
copyddb optionally accepts a key
pattern string as argument. The pattern denotes the name(s) of the elements to be copied. Wildcards are allowed with the pattern specification. All elements of the selected class are copied if no pattern is specified. The object class of the element(s) to be copied is selected with the class switch.
Options
Merge Switch (required):
-ms | merge source (source file is master) |
-md | merge destination (destination file is master) |
-mr | merge replace (source file is master) |
Class Switch (required):
-a | all classes |
-as | all SCM classes (same as all -s? switches) |
-al | all layout classes (same as all -l? switches) |
-ac | all chip/IC design classes (same as all -c? switches) |
-sp | SCM plans (with part list and logical net list) |
-ss | SCM symbols (with logical library) |
-sl | SCM labels |
-sm | SCM marker |
-ll | layout plans (with physical net list and paths) |
-lp | layout parts |
-ls | layout padstacks |
-ld | layout pads |
-cl | chip/IC design layouts (with physical net list and paths) |
-cc | chip/IC design cells |
-cp | chip/IC design pins |
-drc | layout design rule check parameter blocks |
-llib | logical library entries |
-gtab | Gerber aperture tables |
-fnt | BAE font data |
-sct | SCM color tables |
-lct | layout color tables |
-ict | chip/IC design color tables |
-ulp | User Language programs |
-ull | User Language libraries |
-rule | Rule system definitions |
-recover | all classes (recovery mode for corrupt DDB files) |
Examples
To copy all layout symbols with element names matching
so1* (e.g.,
so14,
so16, ...) from
newlib.ddb to
laylib.ddb with
laylib.ddb supposed to be the master file:
> copyddb newlib laylib -md -lp so1* 
To copy all schematic design data from
design.ddb to
redesign.ddb with
design.ddb supposed to be the master file:
> copyddb design redesign -ms -as 
To update the padstack definitions matching
finger* in
design.ddb according to the definitions in
laylib.ddb:
> copyddb laylib design -ms -ls finger* 
To copy all User Language libraries from
ulcprog.vdb to
ullibs.sav with
ulcprog.vdb supposed to be the master file:
> copyddb ulcprog.vdb ullibs.sav -ms -ulp 
Replace layout parts in
design.ddb with corresponding parts from
library.ddb, i.e., update job-specific layout library in
design.ddb:
> copyddb library design -mr -lp 
Files
bae.log -- logfile (written to current directory)
See also
listddb
The functionality for copying DDB file elements is also implemented through the
ddbcopyelem User Language system function.
Diagnosis
The error messages issued by
copyddb are intended to be self-explanatory.
Warnings
copyddb is a powerful tool for manipulating DDB file contents. Be aware of WHAT you are doing with
copyddb. Conflicts can occur when merging SCM and/or layout plans from different design files since the part lists, net lists, part attributes, etc. are merged, too (i.e., you might run into serious
Packager and/or
Backannotation problems, when using
copyddb inappropriately). We strongly recommend to check the destination file consistency after applying
copyddb!