tt_type_comp(1) USER COMMANDS tt_type_comp(1)NAMEtt_type_comp - compile ToolTalk otypes and ptypes
SYNOPSIStt_type_comp [-mMs] [-d db] source_file
tt_type_comp-r [-s] [-d db] type ...
tt_type_comp-p | -O | -P [-sE] [-d db]
tt_type_comp-p | -O | -P [-s] source_file
tt_type_comp-x [-s] [-o compiled_file] source_file
tt_type_comp [-hv]
DESCRIPTION
The tt_type_comp utility processes otypes and ptypes. 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. The
tt_type_comp utility preprocesses the source types with
cpp(1), and can optionally write out the compiled types
instead of merging them into the standard databases. The
tt_type_comp utility can also remove types from the standard
databases or write out the contents of these databases.
The tt_type_comp utility 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 out-
put files is that expected for input to ce_db_build(1) and
ce_db_merge(1).
OPTIONS
The following options are available:
-d db Specify the database to work on, which must 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 respectively
as the first, second, and last elements of $TTPATH.
Unix System LaboratorLast change: 11 May 1994 1
tt_type_comp(1) USER COMMANDS tt_type_comp(1)
These 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 data-
base is user. For the -p, -O and -P options, the
default is all three databases.
-E Use Classing Engine mode, instead of the default
XDR mode.
-h Write a help message for invoking tt_type_comp and
then exit.
-m Merge types into the specified database, updating
any existing type with the new definition given.
This is the default action. This action is not
supported for Classing Engine mode.
-M Merge types into the specified database (see -m),
but only if they do not already exist in that data-
base. This action is not supported for Classing
Engine mode.
-O Write the names of all otypes read.
-p Write the ToolTalk types read in a source format
suitable for recompilation with tt_type_comp.
-P Write the names of all ptypes read.
-o compiled_file
Write the compiled types into the specified file,
or to standard output if compiled_file is -.
-r Remove the given ptypes or otypes from the speci-
fied database, as indicated by the type operands.
-s Silent mode. Write nothing to standard output.
-v Write the version number of tt_type_comp and then
exit.
-x Compile source types into a compiled types file,
instead of merging them into the standard types
databases.
OPERANDS
The following operands are supported:
source_file
A pathname of a text file containing ToolTalk
source code. If source_file is -, standard input
Unix System LaboratorLast change: 11 May 1994 2
tt_type_comp(1) USER COMMANDS tt_type_comp(1)
is used.
type A name of a type to be removed by the -r option.
STDIN
The standard input is used only if a source_file operand is
-.
INPUT FILES
The input file named by source_file is a text file contain-
ing ToolTalk source code.
ENVIRONMENT VARIABLES
The following environment variables affect the execution of
tt_type_comp:
CEPATH In Classing Engine mode, a colon-separated
list of directories that tells the Class-
ing Engine where to find the databases
that contain (among other things) ToolTalk
types. See ce_db_build(1).
LANG Provide a default value for the interna-
tionalization variables that are unset or
null. If LANG is unset or null, the
corresponding value from the
implementation-specific default locale
will be used. If any of the internation-
alization variables contains an invalid
setting, the utility behaves as if none of
the variables had been defined.
LC_ALL If set to a non-empty string value, over-
ride the values of all the other interna-
tionalization variables.
LC_MESSAGES Determine the locale that is used to
affect the format and contents of diagnos-
tic messages written to standard error and
informative messages written to standard
output.
NLSPATH Determine the location of message catalo-
gues for the processing of LC_MESSAGES.
TTPATH In XDR mode, a colon-separated list of
directories that tells the ToolTalk ser-
vice where to find the ToolTalk types
databases. If TTPATH has no value or is
not set, it is considered to be:
Unix System LaboratorLast change: 11 May 1994 3
tt_type_comp(1) USER COMMANDS tt_type_comp(1)
$HOME/.tt:\
/etc/tt:\
/usr/dt/appconfig/tttypes:\
$OPENWINHOME/etc/tt
RESOURCES
None.
ASYNCHRONOUS EVENTS
The tt_type_comp utility takes the standard action for all
signals.
STDOUT
When the -h option is used, tt_type_comp writes to standard
output a help message in an unspecified format.
When the -o option is used, tt_type_comp writes to standard
output a listing of all otypes read.
When the -p option is used, tt_type_comp writes to standard
output a listing of all the ToolTalk types read, in a source
format suitable for recompilation with tt_type_comp.
When the -P option is used, tt_type_comp writes to standard
output a listing of all ptypes read.
When the -v option is used, tt_type_comp writes to standard
output a version number in an unspecified format.
STDERR
Used only for diagnostic messages.
OUTPUT FILES
When the -x or -d user option is used, tt_type_comp writes
the compiled types in an unspecified format into a user-
specified file. Otherwise, it writes the compiled types
into the databases described under -d.
EXTENDED DESCRIPTION
None.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
1 Usage; tt_type_comp was given invalid command line
options.
2 A syntax error was found in the source types given to
tt_type_comp.
Unix System LaboratorLast change: 11 May 1994 4
tt_type_comp(1) USER COMMANDS tt_type_comp(1)
3 System error; tt_type_comp was interrupted by SIGINT,
or encountered some system or internal error.
CONSEQUENCES OF ERRORS
Default.
FILES
$HOME/.tt/types.xdr
User's ToolTalk types database for XDR mode
/etc/tt/types.xdr
System ToolTalk types database for XDR mode
/usr/dt/appconfig/tttypes/types.xdr
$OPENWINHOME/etc/tt/types.xdr
Network ToolTalk types databases 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).
APPLICATION USAGE
None.
EXAMPLES
None.
SEE ALSOttsession(1), ce_db_build(1), ce_db_merge(1), cpp(1).
Unix System LaboratorLast change: 11 May 1994 5
