Preface

The SunOS 5.x operating system is based on AT&T's System V Release 4.0 (SVR4), and therefore is not binary compatible with SunOS 4.x releases. This means that SunOS 4.x programs and applications based on those releases will not execute correctly when run directly on this release.

The SunOS^TM and OpenWindows^TM Binary Compatibility Packages allow SunOS 4.x based applications to run on the Solaris 8 release, making them available for use for this new release. Using these packages, well-behaved application binaries based on the SunOS 4.x release will run on this release without modifications or recompilation. These packages are provided as an aid in the transition to the Solaris 8 release, and not as a substitute for porting applications to this operating system.

Scope of This Manual

In the context of this guide, "SunOS 4.x" is a universal term that includes these releases:

• SunOS 4.1

• SunOS 4.1.1

• SunOS 4.1.2

• SunOS 4.1.3

Who Should Use This Book

This guide is intended for application writers who want to ensure that their SunOS 4.x applications will execute easily on the Solaris 8 release. It describes the binary compatibility package, what it does and does not handle, and how to install and use it. It also discusses specific areas to consider in developing an application or in evaluating how easily an existing SunOS 4.x application will execute on this release. Most importantly, this guide describes restrictions on this package; that is, areas where binary compatibility is not available.

A complete discussion of general compatibility issues can be found in the Solaris Transition Guide.

How This Book Is Organized

This book is organized into three areas:

Chapter 1, Introducing the Binary Compatibility Packages describes how to install these packages, and how to use them.

Chapter 2, Binary Compatibility explains what the SunOS Binary Compatibility Package provides for your applications at the system interface level. This chapter also explains areas where binary compatibility is not available.

Chapter 3, Window System Compatibility provides details on window system compatibility. This chapter discusses the binary compatibility available for the various window managers and toolkits available in the SunOS 4.x release.

Ordering Sun Documents

Fatbrain.com, 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 Fatbrain.com at http://www1.fatbrain.com/documentation/sun.

Accessing Sun Documentation Online

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

What Typographic Conventions Mean

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

Table P-1 Typographic Conventions

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. machine_name% you have mail.
AaBbCc123	What you type, contrasted with on-screen computer output	machine_name% 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.

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

Shell	Prompt
C shell prompt	machine_name%
C shell superuser prompt	machine_name#
Bourne shell and Korn shell prompt	$
Bourne shell and Korn shell superuser prompt	#