Index for Section 4

Alphabetical listing for D

Bottom of page

dtdtfile(4)
CDE
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 CDE 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 variable.

  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
  addition, 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
  DTDATABASESEARCHPATH 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 unspecified results. Directories can be set up for various locales.
  Each directory contains localized action definitions 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

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

  File Format

  In addition to the version information, comments and variable references
  described under other headings in this document, 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 indicates the version
  of the database syntax used by a particular 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 database file is ignored.  The database version number is specified
  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 variable 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 by ending the
  line with a \ character. The \ and any blank s following the \ and
  preceding the newline are discarded; leading blank s on the following line
  are preserved in the continued field.

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

Index for Section 4

Alphabetical listing for D

Top of page