NAME

tt_type_comp − the ToolTalk otype and ptype compiler

SYNOPSIS

tt_type_comp [−s] [−d db] [−mM] source_file
tt_type_comp [−s] [−d db] -r type ...
tt_type_comp [−sE] −p|O|P [−d db]
tt_type_comp [−s] −p|O|P source_file
tt_type_comp [−s] -x [−o compiled_file] source_file
tt_type_comp [−hv]

DESCRIPTION

tt_type_comp processes otypes and ptypes, which are descriptions of ToolTalk objects and ToolTalk processes.  The default action of tt_type_comp is to compile types from source form into compiled form and then merge the compiled types into the standard ToolTalk types databases.  tt_type_comp preprocesses the source types with cpp(1), and can optionally write out the compiled types instead of merging them into the standard databases.  tt_type_comp can also remove types from the standard databases, or print the contents of these databases. 

tt_type_comp operates in two fundamental modes: XDR and Classing Engine.  XDR mode is the default.  In XDR mode, the standard databases are simply serialized ToolTalk data structures, and the format of tt_type_comp output files is the same as that of the databases.  In Classing Engine mode, the standard databases are in fact the Classing Engine’s own databases, and the format of tt_type_comp output files is that expected for input to ce_db_build(1) and ce_db_merge(1). 

OPTIONS

−E Use Classing Engine mode, instead of the default XDR mode. 

−d Specify the database to work on which should be one of user, system, or network. For Classing Engine mode these are defined as:

user -- $HOME/.cetables/cetables

system -- /etc/cetables/cetables

network -- $OPENWINHOME/lib/cetables/cetables For the XDR format these are defined as:

user -- $HOME/.tt/types.xdr

system -- /etc/tt/types.xdr

network -- $OPENWINHOME/etc/tt/types.xdr

These three databases form a hierarchy in which the definition of a type in the user database overrides the definition in the system database, and so on.  For the merge and remove options, the default database is user.  For the print options, the default is all three databases. 

−h Print help on invoking tt_type_comp and exit. 

−m Merge types into specified database, updating any existing type with the new definition given. This is the default action.  This action is no longer supported for Classing Engine mode. 

−M Merge types into specified database, but only if they do not already exist in that database.  This action is no longer supported for Classing Engine mode. 

−p Pretty-print on stdout all the ToolTalk types read. Types are printed out in source format suitable for recompilation with tt_type_comp. 

−O Enumerate on stdout the names of all otypes read. 

−P Enumerate on stdout the names of all ptypes read. 

−o compiled_file
With the -x (compile) option, emit the compiled types into the specified file, or stdout if compiled_file is "-". 

source_file
Read source types from the specified file, or stdin if source_file is "-". 

−r type...
Remove the given ptypes or otypes from the specified database.

−s Silent mode. Don’t print anything. 

−x Compile source types into a compiled types file, instead of merging them into the standard types databases. 

−v Print out the version number and exit. 

ENVIRONMENT

TTPATH
In XDR mode, a colon-separated list of directories that tells ToolTalk where to find the ToolTalk types databases.  The format of this variable is userDir[:systemDir[:networkDir]].

CEPATH
In Classing Engine mode, a colon-separated list of directories that tells the Classing Engine where to find the databases that contain (among other things) ToolTalk types.  See ce_db_build(1). 

FILES

$HOME/.tt/types.xdr
User’s ToolTalk types database for XDR mode

/etc/tt/types.xdr System ToolTalk types database for XDR mode

$OPENWINHOME/etc/tt/types.xdr
Network ToolTalk types database for XDR mode

$HOME/.cetables/cetables

/etc/cetables/cetables

$OPENWINHOME/lib/cetables/cetables
Classing Engine databases containing ToolTalk types for CE mode.  See ce_db_build(1). 

SEE ALSO

ttsession(1), ce_db_build(1), ce_db_merge(1) cpp(1)

DIAGNOSTICS

tt_type_comp exits with the following exit codes:

0 Normal termination. 

1 Usage.  tt_type_comp was given invalid command line options. 

2 Syntax error.  A syntax error was found in the source types given to tt_type_comp. 

3 System error.  tt_type_comp was interrupted by SIGINT, or encountered some system or internal error. 

SunOS 5.4  —  Last change: 6 Mar 1993