Common Desktop Environment: ToolTalk Messaging Overview


This book describes the Common Desktop Environment (CDE) components, commands, and error messages of the ToolTalkTM service.

Note -

In-depth information about the functionality of the ToolTalk service in general is beyond the scope of this book. That is, CDE ToolTalk Messaging Overview does not describe ToolTalk APIs or commands, or other ToolTalk functionality not specifically related to this release of the ToolTalk service for the Common Desktop Environment.

Who Should Use This Book

This manual is for developers who create or maintain applications that use the ToolTalk service to inter-operate with other applications in Common Desktop Environment. This manual assumes familiarity with the ToolTalk service and its functionality, UNIX® operating system commands, system administrator commands, and system terminology.

How This Book Is Organized

This book is organized as follows:

Chapter 1, Introducing the ToolTalk Service describes how the ToolTalk service works and how it uses information that your application supplies to deliver messages; how applications use the ToolTalk service; and application and ToolTalk components.

Chapter 2, How to Use ToolTalk Messaging contains the information you need to write an application using the ToolTalk service in the Common Desktop Environment, including the kinds of ToolTalk toolkit messages that need to be included in your application in order for it to inter-operate with other ToolTalk-aware Common Desktop Environment-compliant applications.

Chapter 3, Using TTSnoop to Debug Messages and Patterns describes how to create and send custom-constructed ToolTalk messages, and also how to selectively monitor any or all ToolTalk messages.

Chapter 4, Using ToolTalk Tracing describes how a ToolTalk pattern matches and delivers every message ttsession sees.

Appendix A, The Messaging Toolkit describes some of the application program interface (API functions) that are a part of the messaging toolkit.

Appendix B, The CoEd Demonstration Program gives the ToolTalk-related portions of the ptype, header, and .c files of the ToolTalk demo program CoEd.

Appendix C, New ToolTalk Functions describes the ToolTalk functions that map file names between local and canonical paths.

Related Books and Other Documentation

CDE ToolTalk Messaging Overview does not provide in-depth information about ToolTalk and its functionality. In addition to the ToolTalk product base documentation (that is, ToolTalk User's Guide and the ToolTalk Reference Manual), the following related ToolTalk documentation provide in-depth information about the ToolTalk functionality that is beyond the scope of this book:

Ordering Sun Documents, an Internet professional bookstore, stocks select product documentation from Sun Microsystems, Inc.

For a list of documents and how to order them, visit the Sun Documentation Center on at

Accessing Sun Documentation Online

The docs.sun.comSM Web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject. The URL is

What Typographic Conventions Mean

The following table describes the typographic changes used in this book.

Table P-1 Typographic Conventions

Typeface or Symbol 




 The names of commands, files, and directories; on-screen computer output

Edit your .login file.

Use ls -a to list all files.

machine_name% you have mail.


 What you type, contrasted with on-screen computer outputmachine_name% su Password:


 Command-line placeholder: replace with a real name or value

To delete a file, type rm filename.


Book titles, new words, or terms, or words to be emphasized. 

Read Chapter 6 in User's Guide.

These are called class options.

You must be root to do this.

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P-2 Shell Prompts



 C shell promptmachine_name%
 C shell superuser promptmachine_name#
 Bourne shell and Korn shell prompt$
 Bourne shell and Korn shell superuser prompt#