Preface

The X Server Device Developer's Guide provides detailed information on writing device drivers that run with the OpenWindows^(TM) environment. These device drivers are DDX handlers that interface with the OpenWindows server.

Who Should Use This Book

If you are an Independent Hardware Vendor (IHV) interested in writing device drivers, you should read this book.

Before You Read This Book

Check the Solaris 2.5.1: Driver Developer Kit Introduction and Solaris 2.5.1: Driver Developer Kit Installation Guide for any corrections or updates to information in this manual.

See Appendix B, "Packaging and Installation Hints" for important information on packaging issues and installation hints.

This manual assumes that the reader has a programming background and familiarity with, or access to, appropriate documentation for:

• Solaris 2.5 and 2.5.1
• The X Window System; specifically the MIT sample server and the DDX (Device Dependent X) porting layer.
• C Language
• X, Xlib

How This Book Is Organized

Chapter 1, "DDX Porting Overview," provides an overview of porting features and requirements of the DDX layer.

Chapter 2, "The Loadable DDX Interface," explains how the server interfaces to a loadable DDX handler.

Chapter 3, "Screen Initialization," describes some aspects of Screen initialization common to many devices.

Chapter 4, "Cursors," discusses software and hardware cursor implementations and helps you decide which cursor layer to use for your purposes.

Chapter 5, "Multiple Plane Group Interface," provides an architectural overview and describes the feature of the multiple plane group (MPG) DDX module.

Chapter 6, "Overlay Window Interface," describes the overlay window interface (OVL) for your DDX handler.

Chapter 7, "Window ID Interface," defines the window management interface routines that are part of the MPG package.

Chapter 8, "Colormap Interface," describes all of the routines that are part of the CMAP package. It also provides several examples.

Chapter 9, "Multibuffering Extension to X Interface," describes how to port your DDX handler to the MBX (Multi-buffering) Extension.

Chapter 10, "Direct Graphics Access Drawable Client Interface," describes the DGA library interface for clients.

Chapter 11, "Direct Graphics Access Drawable DDX Interface," describes the DGA library interface for DDX handlers.

Chapter 12, "Input Devices," explains how to add an extension input device to the server and how to access the extension with MIT's XInput Extension.

Chapter 13, "Direct Pixel Access DDX Interface," describes the direct pixel access (DPA) interface for DDX handlers.

Chapter 14, "Debug Server Modules," provides information about the debug server modules.

Chapter 15, "MIT Shared Memory Extension," explains how to implement the MIT Shared Memory extension.

Appendix A, "The OWconfig File," includes the default OWconfig file and explains its content.

Appendix B, "Packaging and Installation Hints," discusses packaging and installation issues pertaining to loadable modules.

Appendix C, "Virtual User Input Device Interface," explains the mechanism that sets up input devices to generate event codes and what a device driver needs to do in order to conform to the vuid interface.

Appendix D, "Dynamically Loadable Extensions," discusses requirements X extensions must meet to be dynamically loadable by the server.

Related Books

Solaris Release Information

For information on this release, see the following:

• "New Features and Changes" on page xxiii
• Solaris 2.5.1: Driver Developer Kit Introduction
• Solaris 2.5.1: Driver Developer Kit Installation Guide
• Solaris 2.5.1 Software Developer Kit Installation Guide

OpenWindows Start Up Information

For information on how to start up the OpenWindows environment, see the following manuals:

• Solaris 2.5.1: Driver Developer Kit Introduction
• Solaris Advanced User's Guide

OpenWindows Environment Information

To learn how to use the OpenWindows environment, see the following manuals:

• Solaris User's Guide
• Solaris Advanced User's Guide

X Window System Information

The following X Window System manuals are available through SunExpress or your local bookstore. Contact your SunSoft representative for information about ordering.

• XView Reference Manual, O'Reilly & Associates
• XView Programming Manual, O'Reilly & Associates
• Xlib Reference Manual, O'Reilly & Associates
• Xlib Programming Manual, O'Reilly & Associates
• Programmer's Supplement for Release 5, O'Reilly & Associates
• X Toolkit Intrinsics Reference Manual, O'Reilly & Associates
• The X Window System, Third Edition, Digital Press
• The X Window System Server, Digital Press

MIT Sample Server Porting Information

The following manuals are available online in the /doc/Server directory of the SUNWxwddk package. The default installation directory of this package is /opt/SUNWddk/xserver. These manuals are recommended if you are new to X11 server development. The associated filename is in parentheses.

• Strategies for Porting the X v11 Sample Server (strat.ms)
• Definition of the Porting Layer for the X v11 Sample Server (ddx.tbl.ms)

MIT Sample Server Information on ftp.x.org

The following MIT documentation is available to systems on the Internet. The MIT documentation resides on the ftp.x.org machine. Use the File Transfer Protocol (ftp) to download files from this system. If you need help using ftp, refer to the ftp(1) man page. To determine if your system is connected to the Internet, see your system administrator.

The directory and filename is given in parenthesis for the document.

• X Window System, Version 11, Release 5. Release Notes

(/pub/R5untarred/mit/RELNOTES.TXT)

What Typographic Changes and Symbols Mean

The following table describes the type changes and symbols used in this book.

Table P-1

Typeface or Symbol	Meaning	Example
AaBbCc123	The names of commands, files, and directories; on-screen computer output	Edit your .login file. Use ls -a to list all files. system% You have mail.
AaBbCc123	What you type, contrasted with on-screen computer output	system%su Password:
AaBbCc123	Command-line placeholder: replace with a real name or value	To delete a file, type rm filename.
AaBbCc123	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.
Code samples are included in boxes and may display the following:
%	UNIX C shell prompt	system%
$	UNIX Bourne and Korn shell prompt	system$
#	Superuser prompt, all shells	system#