NAME

OWconfig − X11/NeWS server device description file

SYNOPSIS

$OPENWINHOME/lib/OWconfig

DESCRIPTION

The file $OPENWINHOME/lib/OWconfig is used at runtime by the X11/NeWS server to determine which input and output devices to use and how each should be configured.  Each device “resource” entry is described by a collection of lines similar to a kernel device’s .conf file.  Each entry consists of a number of thing=value pairs, separated by whitespace (including spaces, tabs, and newline characters) and terminated by a semicolon (;) character.  Any characters following a “#” through the end of the line are treated as a comment and are disregarded.  Each entry must have a class=owin pair to indicate that this entry is for the OpenWindows server, and the name= field should indicate whether this entry is for a pointer, keyboard, or display device, concatenated with the display number, for example, name=pointer:0 is for the pointing device associated with the server for display unix:0.  The final required pair is a type= item, where value indicates the kind of device, typically the model or manufacturer of the device.  (See the Solaris 2.1 Release Notes for x86 and the UNKNOWN TITLE ABBREVIATION: OVERVIEW for information on specific device models supported in this release.)  The software to support each device may use additional pairs of information to configure itself; see the sections “Displays,” “Pointers,” and “Keyboards” below for further information. 

EXAMPLE

Here is a sample $OPENWINHOME/lib/OWconfig file that configures the server to use a Logitech MouseMan serial mouse, an ATI Graphics Ultra display adapter, and the standard 101-key keyboard:

#
# ATI Graphics Ultra display adapter
#
class="owin" name="display:0"
type=i8514
res=1024x768
size=12x9.5
pmifile=$OPENWINHOME/etc/vesa/i8514/ati.pmi;
 #
# Logitech Mouseman 3 button serial mouse on tty00
#
class="owin" name="pointer:0"
type=MOUSEMAN-S buttons=3 dev=/dev/tty00;
 #
# AT 101-key keyboard
#
class="owin" name="keyboard:0"
        type=101 layout=1 dev=/dev/vt00;
  

Displays

The X11/NeWS server supports two kinds of display adapters−enhanced VGA cards and 8514/A compatible cards.  Both types of displays are configured similarly.  VGA cards will have a type of VGA, while 8514/A cards use i8514.  The remaining items are res, which takes a string specifying the display resolution in the form widthxheight; size, which specifies the display monitor size in inches; and pmifile, which specifies the pathname to the VESA PMI file to use to control the display card. For example:

class="owin" name="display:0"
type=i8514
res=1024x768
size=12x9.5
pmifile=$OPENWINHOME/etc/vesa/i8514/ati.pmi;

Pointers

The X11/NeWS server presently supports several kinds of mice:

Logitech C7 and C9 Serialtype=LOGI-S
Logitech C7 and C9 Bustype=LOGI-B
Logitech MouseMan Serialtype=MOUSEMAN-S
Logitech MouseMan Bustype=MOUSEMAN-B
Microsoft Serialtype=MS-S
Microsoft Bustype=MS-B
MSC (Mouse Systems) Serial type=MSC-S
MSC Bustype=MSC-B

For all mice, the dev field must specify the system device name that corresponds to the mouse, for example, /dev/tty00 for a serial mouse plugged into the first serial port, and /dev/logi for the Logitech bus mouse.  Optionally, buttons=n may be used to indicate how many buttons are present on the mouse.  (The default value for all except the Microsoft mice is 3; the Microsoft mice have 2 buttons.) For example:

class="owin" name="pointer:0"
type=MOUSEMAN-S buttons=3 dev=/dev/tty00;

Keyboards

The X11/NeWS server presently only supports the integral PC console keyboard.  It should be configured with type set to the number of keys on the keyboard (101 and 84 are typical).  layout specifies the nationality of the keyboard.  These numbers correspond to the entries in $OPENWINHOME/etc/keytables/keytable.map (for example, layout 35 is French).  For example:

class="owin" name="keyboard:0"
type=101 layout=1 dev=/dev/vt00;

FILES

$OPENWINHOME/lib/OWconfig
$OPENWINHOME/etc/keytables/keytable.map

NOTES

The OWconfig file is specific to this release of Solaris for x86.  It may be changed in future releases of OpenWindows. 

Note that this data base is only intended as a mechanism for system administrators to communicate device configuration to the X11/NeWS server.  No application other than the X11/NeWS server should parse this file. 
 
 

SunOS 5.1  —  Last change: 31 May 1993