/usr/dt/share/man/cat4/dtdtfile.4(/usr/dt/share/man/cat4/dtdtfile.4)

dtdtfile(4)	 DEVICES AND NETWORK INTERFACES	      dtdtfile(4)

NAME
     dtdtfile -	define the format and  location	 of  actions  and
     data type database	files

SYNOPSIS
     See dtactionfile(4) and dtdtsfile(4).

DESCRIPTION
     The actions and data types	database provides definitions for
     the  actions  and	data  types TED	clients	recognize.  Files
     containing	actions	and data type definitions must	end  with
     the  .dt suffix.  The database is constructed by reading all
     files ending in the .dt suffix that are found in the  search
     path specified by the DTDATABASESEARCHPATH	environment vari-
     able.

     The dttypes(1) utility is the  tool  that	allows	users  to
     examine and debug their database.

     The DTDATABASESEARCHPATH  environment  variable  contains	a
     comma-separated	list	of   directories   specified   in
     [host:]/path format.  The host:  portion is optional, but if
     specified,	 /path is interpreted relative to host.	 In addi-
     tion, host	defines	the DatabaseHost for records  defined  by
     files  in	the /path directory.  Otherwise, the DatabaseHost
     is	the same as the	LocalHost.  To allow for localized action
     definitions,  the	data base search path supports the string
     %L	within the pathname string.  The logic that parses  DTDA-
     TABASESEARCHPATH substitutes the value of the current locale
     as	stored in the LANG environment variable	for the	string %L
     (or  no  characters  if  LANG  is not set).  Other	uses of	%
     within the	DTDATABASESEARCHPATH pathnames	produce	 unspeci-
     fied  results.   Directories  can	be  set	 up  for  various
     locales.  Each directory contains localized  action  defini-
     tions  for	 a  single locale.  For	examples, see the default
     search path shown below.  The local system	administrator  or
     the  user	(in $HOME/.dtprofile) can modify the actual value
     of	the search path.  The default search  path  includes  the
     following directories, searched in	the following sequence:

	$HOME/.dt/types/
	      personal user-defined database files

	/etc/dt/appconfig/types/%L
	      locally defined language-specific	database files

	/etc/dt/appconfig/types/C
	      locally defined default database files

	/usr/dt/appconfig/types/%L
	      language-specific	database files

Unix System LaboratoLast change: 1 August 1995			1

dtdtfile(4)	 DEVICES AND NETWORK INTERFACES	      dtdtfile(4)

	/usr/dt/appconfig/types/C
	      implementation-default database files

  File Format
     In	addition to the	version	information, comments  and  vari-
     able references described under other headings in this docu-
     ment, these files may contain action and data type	 records,
     as	described in dtactionfile(4) and dtdtsfile(4).

  Comments
     Any line whose first non-space character is # is treated  as
     a	comment	 line,	and  is	ignored	during the reading of the
     database file.

  Database Version
     The database loader supports a version number,  which  indi-
     cates  the	version	of the database	syntax used by a particu-
     lar database file.	 If a  database	 version  number  is  not
     specified,	 then  the  database loader assumes that the file
     uses the version 1.0 syntax, described here.  If a	 database
     file  specifies  a	version	number,	then it	must be	the first
     non-blank,	non-comment line in the	 database  file;  if  the
     version  is  specified  anywhere  else  in	the file, then an
     error message is generated, and the remainder of that  data-
     base file is ignored.  The	database version number	is speci-
     fied using	the following syntax:

	  set DtDbVersion=version_number

  String Variables
     Database entries can reference string variables that can  be
     set  within  the database file.  The scope	of a string vari-
     able is restricted	to only	those record  definitions  within
     the  database  file  defining the string variable.	 A string
     variable is defined using the following syntax:

	  set VariableName=variable_value

     String variables are referenced using either of the standard
     shell  variable  referencing  syntaxes:   $variable_name  or
     ${variable_name}.	A variable name	can be made up of any  of
     the alphanumeric characters and the underscore.

  Environment Variables
     Database records may refer	to environment	variables,  using
     either  of	the standard shell variable referencing	syntaxes:
     $environment_variable or  ${environment_variable}.	  If  the
     environment  variable  name conflicts with	a string variable
     name, the string variable takes precedence.

  Line Continuation
     Any field within a	record can be continued	onto another line

Unix System LaboratoLast change: 1 August 1995			2

dtdtfile(4)	 DEVICES AND NETWORK INTERFACES	      dtdtfile(4)

     by	 ending	 the  line  with  a  \	character.  The	\ and any
     <blank>s following	the \ and preceding the	newline	are  dis-
     carded; leading <blank>s on the following line are	preserved
     in	the continued field.

SEE ALSO
     dtactionfile(4), dtdtsfile(4), dttypes(1).

Unix System LaboratoLast change: 1 August 1995			3

See also dtdtfile(4)