test

KCMS Test Suite User's Guide

Enhancement Tests

The scripts listed below are described alphabetically by script name. These scripts test value-added features and bug fixes to the KCMS framework.

IC_evalplus.scr

Concept

IC_evalplus.scr connects configured X Window System visual profiles to scanner and printer profiles and evaluates the profiles in the same manner as generic profiles.

Description

This script is similar to IC_eval.scr (see "Evaluate") with one exception: the monitor profile used is a configured/calibrated X Window System visual profile for the current frame buffer. This test should succeed if the system has been previously configured using the kcms_configure(1) or kcms_calibrate(1) command. After evaluation, the script frees the profiles from memory.

Verification

All the commands listed in this script are expected to complete successfully.

IC_gray.scr

Concept

IC_gray.scr creates a gray profile and sets attributes.

Description

This script demonstrates that the KCMS framework can create a gray device color profile and set several attributes. It performs the following sequence of events first on a display profile and then on an input profile.

It uses the CREATE: command to create the new profile and sets several attributes with the SETATTR: command. Then it uses the GETATTR: command to get the attributes to verify that they are properly set. It saves the profile and frees it from memory. Then it reloads the profile and again verifies the attributes.

Verification

All the commands are expected to complete successfully.

IC_loadsol.scr

Concept

IC_loadsol.scr loads and frees 100 59

Solaris file-type profiles without memory problems.

Description

This script demonstrates that the KCMS framework successfully can load and free 100 SolarisTM file-type profiles. The script actually verifies a previous fix of an error that caused file descriptors to overflow because of improper file closings in the library.

Verification

All the commands in this script are expected to complete successfully.

IC_pacbug.scr

Concept

IC_pacbug.scr verifies a bug in the CONNECT: command.

Description

This script tests scanner and monitor profile connects. It tests a previous bug in the system.

Verification

All the commands complete as expected.

IC_sun_update.scr

Concept

IC_sun_update.scr verifies a bug in the UPDATE: command.

Description

This script demonstrates that the KCMS framework can update a monitor profile several times. It loads, updates, and saves a monitor profile to a different name three times and frees the updated profiles. Then the script reloads each of the saved monitor profiles and a scanner profile. It connects each monitor profile to the scanner profile, specifying the forward transformation operation and evaluates the results. Finally, the script frees all the profiles from memory.

Verification

All the commands are expected to complete successfully.

IC_updatewin.scr

Concept

IC_updatewin.scr updates a profile several times in a row.

Note -

This script must be run as root.

Description

This script demonstrates that the KCMS framework can update an X Window System profile several times--saving and freeing the profile each time.

Verification

All the commands are expected to complete successfully.

IC_xdisplay.scr

Concept

IC_xdisplay.scr recognizes a display number when accessing a remote host.

Description

This script demonstrates that the KCMS framework can recognize a display number when accessing a remote host. It requests a Solaris file profile from display 0.0 of a remote host that has a single display. It loads a local X Window System profile and sets an attribute to verify that the host is reset properly. Then it frees the profiles from memory.

Note -

The kcms_server(1) daemon must be running on the remote most. If it is not running, type kcms_server in a command shell as root on the remote host.

Verification

All the commands in this test are expected to complete successfully provided the kcms_server(1) daemon is running.

IC_xprofile.scr

Concept

IC_xprofile.scr tests ways of finding profiles.

Description

IC_xprofile.scr sets the environment variable KCMS_PROFILES to a directory containing a profile called junk1.pro, which should be a copy of an existing profile copied to this directory prior to running the test. It essentially tests the ability of the library to use KCMS_PROFILES to find profiles.

Verification

All the commands in this test are expected to complete successfully.

IC_xprofilehost.scr

Concept

IC_xprofilehost.scr tests local and remote hosts.

Description

This script finds a profile remotely and sets the KCMS host to a remote server. It tests the local host using the Internet name instead of the keyword local and sets the KCMS host to the local machine.

Verification

All the commands in this test are expected to complete successfully.

IC_xprofilesav.scr

Concept

IC_xprofilesav.scr saves an X Window System profile.

Description

This script attempts to save X Window System profiles in /etc/openwin/devdata without being root.

Verification

The test should fail with Xstatus 4011 (KCS_IO_WRITE), because it does not have write permissions.

IC_xprofilesavremote.scr

Concept

IC_xprofilesavremote.scr tests writing to a remote host.

Description

This script sets the DISPLAY environment variable to a KCMS remote host. Then it attempts to save an X Window System profile remotely.

Verification

The test should fail with XStatus 4302(KCS_X11_PROFILE_RO), because it does not have write permissions.

IC_xprofilesavroot.scr

Concept

IC_xprofilesavroot.scr saves an X Window System profile.

Note -

This script must be run as root.

Description

This script saves an X Window System profile in /etc/openwin/devdata/profiles.

Verification

All the commands in this test are expected to complete successfully.

IC_xwindow.scr

Concept

IC_xwindow.scr:

Description

This script demonstrates that the KCMS framework can access profiles locally and across the network. First it loads the default X Window System profile from the local host. Then it loads a Solaris profile from another host machine. Finally it frees the profiles from memory.

Note -

The kcms_server(1) daemon must be running on the remote most. If it is not running, type kcms_server in a command shell as root on the remote host.

Verification

All the commands are expected to complete successfully, provided the kcms_server(1) daemon is running on the current machine.

IC_xwindowerr.scr

Concept

IC_xwindowerr.scr captures errors and reports KcsStatus class extensions.

Description

This script tests Solaris file error cases. An invalid host name is requested in three LOAD: commands, and invalid profiles are requested from the valid local host in three other LOAD: commands.

Verification

All the LOAD: commands should fail because of an attempt to access an invalid host name or profile name.