Before your module can be loaded, you need to update the OWconfig file by inserting an entry for your module. To do this, you use the interactive OWconfig_calibrate program provided with the SDK.
To update the OWconfig file, you must be root. If you are not root or the /etc/openwin/server/etc path does not exist, the following error is generated:
OWconfile file not created/updated. Check that you are root and /etc/openwin/server/etc exists.
Start the OWconfig_calibrate program as follows:
example% su example# ./OWconfig_calibrate
The following is an example of how to insert a calibrator module configuration entry into the OWconfig file. Sample user responses are enclosed in brackets ([]).
ATTENTION: You must be root to update the OWconfig file. Are you inserting an OWconfig entry? y/n [y] You will be asked to supply a name, a device type, and a kcsLoadableModule to create an entry such as the following: name = 'mydriver' kcmsCalDeviceType = 'monitor' kcmscCalLoadableModule = 'kcmscSUNWmydriver.so.1' Please see the KCMS Calibrator Tool LOadable Interface Guide for information The class for this entry will always be KCMS_CALIBRATE Enter the unique name of the device [mydriver] Enter the device type - normally monitor [monitor] Enter the name of your dynamically loadable module. [kcmsSUNWmydriver.so.1] This is your OWconfig entry. OK? y/n class = KCMS_CALIBRATE name = mydriver kmcsCalDeviceType = monitor kmcsCalLoadableModule = kcmsSUNWmydriver.so.1 y Do you have more entries to create? y/n n
The OWconfig_calibrate program above appends the entry to the OWconfig file.
Try inserting the entry shown in the above example using the procedure outlined below:
Run the OWconfig_calibrate program. Be sure you are root.
Insert the user responses shown in Example 3-2 .
Check for the entry at the end of the OWconfig file.
The new configuration entry is appended to the /usr/openwin/server/etc/OWconfig file. For local machine use only, the /etc/openwin/server/etc/OWconfig file is updated. If you inserted the entry with the user responses in Example 3-2 , the entry appears in OWconfig as shown below.
class="KCMS_CALIBRATE" name="mydriver" kcmsCalDeviceType="monitor" kcmsCalLoadableModule="kcmsSUNWmydriver.so.1";
The following is an example of how to remove a configuration entry from the OWconfig file. Sample user responses are enclosed in brackets ([]).
ATTENTION: You must be root to update the OWconfig file. Are you inserting an OWconfig entry? y/n [n] To remove an OWconfig entry: Enter the unique name for your driver for removal from the OWconfig file. [mydriver] This is the OWconfig entry to remove. OK? y/n class = KCMS_CALIBRATE name = mydriver [y] Do you have more entries to remove? y/n [n]
The OWconfig_calibrate program removes the last entry in the OWconfig file.
Try removing the entry you inserted following Example 3-4 . Use the procedure outlined below:
Run the OWconfig_calibrate program again. Be sure you are root.
Fill in the user responses shown in Example 3-4 .
Check the OWconfig file.
The entry should no longer appear at the end of the file.