Preface

TheKCMS Test Suite User's Guide explains how to test a Kodak Color Management System (KCMS(TM)) color management module (CMM) to verify whether or not the CMM adheres to the KCMS framework. This guide describes a suite of test scripts and the testing facility the CMM developer can use to ensure that a CMM is KCMS-framework compliant. It is a supplemental DDK book in the KCMS documentation.

Who Should Use This Book

This guide is particularly useful if you are a CMM developer. It describes how you can test whether the CMM you have written adheres to the KCMS framework. It is also a reference to anyone interested in the development and use of the KCMS framework.

Typically you would use the test scripts described in this guide to test a CMM you have written for adherence to the framework. This guide assumes you have installed your CMM and its associated profiles. It describes the tests you get with the DDK and how you run them. If you need to change scripts to meet special requirements of your CMM, the guide explains how the script contents are organized. From this information, you can determine what changes you can make. For details on how to use the KCMS test suite in the development of your CMM, see Chapter 6, Putting It All Together .

The KCMS test suite can only test the profile attributes it knows about. It is not designed to test new attributes your CMM might add. For details on the supported profile attributes, see the KCMS Application Developer's Guide.

Before You Read This Book

Before you read this guide, you should be thoroughly versed in the KCMS framework and in how to write or customize CMMs. This guide assumes that you have read the KCMS Application Developer's Guide.

In addition, you should have read the following books:

• KCMS CMM Developer's Guide

• KCMS CMM Reference Manual

All assumptions of the readers of the above books apply to the reader of this guide. To recapitulate key requirements, you should

• Understand C++ and C language

• Be familiar with Solaris dynamic loading technology and all of the associated manual pages

• Understand color science concepts

You should also be familiar with the following manual pages:

• auto-kcmstest(1)

• auto-kcmstest-root(1)

• kcms_calibrate(1)

• kcms_configure(1)

• kcms_server(1)

• kcmstest(1)

• kcms-testreport(1)

See the on-line SUNWrdm packages for information on bugs and issues, engineering news, and patches. For Solaris installation bugs and for late breaking bugs, news, and patch information, see the Solaris 7 (SPARC Platform Edition) Installation Library and the Solaris 7 (Intel Platform Edition) Installation Library manuals.

For SPARC(TM) systems, consult the updates your hardware manufacturer may have provided.

How This Book Is Organized

This guide is organized as follows:

Chapter 1, KCMS Test Suite Overview ," summarizes the KCMS test suite. The chapter provides an overview of how the test suite works, it presents the test suite directory hierarchy, and it explains the approach used to test the KCMS framework so that you know what you can expect from the tests.

Chapter 2, Running KCMS Test Scripts ," gets you started using the kcmstest utility, identifies each of the test script commands, and provides the basic script command format. It also describes automated scripts that run several tests once and suggests a scenario for their use.

Chapter 3, KCMS Test Suite Commands ," provides the syntax and a description of each script command keyword.

Chapter 4, KCMS Test Script Descriptions ," summarizes the functionality of each test script provided with the DDK.

Chapter 5, Setting Attributes ," provides an annotated script example showing how to set each supported attribute.

Chapter 6, Putting It All Together ," threads together the procedure for using this test suite. The chapter provides references to the relevant documentation on developing and testing KCMS CMMs.

Appendix A, Status Codes ," associates status code values and strings.

Glossary " is a list of words and phrases found in this book along with their definitions.

Related Books

The following is a list of recommended books that can help you accomplish the tasks described in this guide:

• International Color Consortium (ICC) Profile Format Specification (located on-line in /opt/SUNWsdk/kcms/doc/icc.ps). For the most current version of the ICC specification, see the web site at http://www.color.org.

• White papers on color science provided with the KCMS product.

Ordering Sun Documents

The SunDocs^SM program provides more than 250 manuals from Sun Microsystems, Inc. If you live in the United States, Canada, Europe, or Japan, you can purchase documentation sets or individual manuals using this program.

For a list of documents and how to order them, see the catalog section of the SunExpress(TM) Internet site at http://www.sun.com/sunexpress.

The term "x86" refers to the Intel 8086 family of microprocessor chips, including Pentium and Pentium Pro processors and compatible microprocessor chips made by AMD and Cyrix. In this document, the term "x86" refers to the overall platform architecture, whereas "Intel Platform Edition" appears in the product name.

What Typographic Changes Mean

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

machine_name%su

Password:

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.