Preface

The KCMS 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.

---

Note -

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 9 Installation Guide.

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.

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.

Typographic Conventions

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	#