CDE

NAME

dtappintegrate − integrate applications into the CDE

SYNOPSIS

dtappintegrate −S application_root [−t target_path] [−l locale] [−u] [−?]

OPTIONS

The The following options are available:

−S application_root
Integrate the application files that are located under application_root. The application_root is the top directory under which all of an application’s files are installed.  The dtappintegrate utility looks for application CDE configuration files in the following subdirectories, with all C locale subdirectories containing the application’s default CDE configuration files:

<application_root>/dt/appconfig/types/<locale>
Contains application action and data type files
<application_root>/dt/appconfig/appmanager/<locale>
Contains application group files
<application_root>/dt/appconfig/icons/<locale>
Contains application icons
<application_root>/dt/appconfig/help/<locale>
Contains application help files

−t target_path
Link the application CDE configuration files to target_path rather than to the default CDE system locations. 

−l locale
Integrate only the files found in the locale subdirectories. If this option is not specified, all of the application’s CDE configuration files are integrated. 

−uDestroy the symbolic links previously created by dtappintegrate. If −l is specified with the −u option, only the symbolic links to the CDE configuration files in the specified locale subdirectories are destroyed. 

−?Write a help message to standard output that describes the command syntax of dtappintegrate and exit. 

OPERANDS

None

DESCRIPTION

The dtappintegrate utility integrates applications into CDE. Application installation scripts should invoke dtappintegrate as the last step before exiting. The dtappintegrate utility must be invoked with root user authority. 

When dtappintegrate is invoked with no target_path specified, it creates symbolic links to the application’s CDE configuration files under the following default CDE system locations:

/etc/dt/appconfig/types/<locale>
Contains symbolic links to the application action and datatype files

/etc/dt/appconfig/appmanager/<locale>
Contains symbolic links to the application group subdirectory

/etc/dt/appconfig/help/<locale>
Contains symbolic links to the application help files

/etc/dt/appconfig/icons/<locale>
Contains symbolic links to the application icons

EXTENDED DESCRIPTION

None

STDIN

Not used

STDOUT

When no option or the −? option is used, dtappintegrate writes a usage message to the standard output. 

During execution, dtappintegrate writes confirmation messages to the standard output. 

STDERR

Used only for diagnostic messages. 

ASYNCHRONOUS EVENTS

The dtappintegrate utility takes the standard action for all signals. 

CONSEQUENCE OF ERRORS

Default

APPLICATION USAGE

None

RESOURCES

None

ENVIRONMENT VARIABLES

None

EXIT STATUS

The following exit values are returned:

0Successful completion. 

2Help message displayed. 

3Not invoked with root user authority. 

4Invalid option. 

EXAMPLES

None

INPUT FILES

None

OUTPUT FILES

The dtappintegrate utility creates the symbolic links to the application’s CDE configuration files. 

During execution, dtappintegrate writes to the text file, /tmp/dtappint.log, output from the underlying system commands it invokes. 

SEE ALSO

None