NAME

X68k — X Window System Display Server for NetBSD/x68k

SYNOPSIS

X68k	[options ...]

DESCRIPTION

X68k is the server for Version 11 of the X Window System on X68k hardware running NetBSD. It will normally be started by the xdm(1) daemon or by a script that runs the program xinit(1).

SUPPORTED HARDWARE

X68k supports both the x68k built-in text bitmap screen and graphics bitmap screen. When it is configured to use the text screen, it can be used as a monochrome server. Otherwise, it can be used as 4-bit, 8-bit or 15-bit 16-bit color/monochrome server. X68k supports the x68k standard full-size and compact type keyboards. The initial arrangement of the keys on the keyboards can be configured either as the typewriter style ( ‘ASCII’ arrangement) or as the JIS standard style ( ‘JIS’ arrangement). Once it is started, the arrangement is freely configured with xmodmap(1) or xkbcomp(1) utility. The pointing device can be either the standard mouse or the mouse-trackball. Although the x68k can have two mice connected, it recognizes only one of them; if two mice are connected, the result is undefined.

OPTIONS

In addition to the normal server options described in the Xserver(1) manual page, X68k acdepts the following command line switch:

-x68kconfig config_file

Specify the configuration filename.

CONFIGURATION FILE

X68k configuration is specified in the configuration file called X68kConfig. If the configuration filename is specified on the command line option x68kconfig, the named file is used to read the configuration. Otherwise X68k searches for the file /etc/X68kConfig. If it is not found, <XRoot>/lib/X11/X68kConfig is used instead, where <XRoot> is replaced by the root of the X11 install tree (ordinary /usr/X11R7). X68kConfig has a Lisp-like syntax. Comments start with the character ‘;’, and ends at the end of line. There are 4 functions recognized:

ModeDef()

Define a display mode. 18 arguments are required:

 

name type depth class width height regs... r0 r1 r2 r3 r4 r5 r6 r7 r8 r20 videoc-r0 dotclk

 

Name is the name defined by this ModeDef definition.

 

Type is either Text or Graphic, and specifies the screen to be used by this mode. Note that the type Graphic requires the /dev/grf1 device driver configured in your kernel.

 

Depth is the framebuffer depth for this mode. If type is Text, this must be 1. Otherwise it can be chosen from 4, 8 and 15.

 

Class specifies the display class, and be chosen from either StaticGray, PseudoColor and TrueColor.

 

Width and height are the size of the screen by pixel.

 

Remaining arguments are set to the registers of the CRT controler and the video controler of the x68k. Be carefull to change these values, or it may DAMAGE THE DISPLAY HARDWARE!!

 

Mode()

One argument name is required. Set the display mode to name as defined by the ModeDef() function.

Mouse()

One argument type is required. Specify the pointing device type; currently standard is the only acceptable argument.

Keyboard()

One argument type is required. Specify the initial arrangement of the keyboard. Type is either standard or ascii, which means the JIS arrangement and the typewriter arrangement respectively.

See EXAMPLE section for an example of X68kConfig.

FILES

/etc/X68kConfig, /usr/X11R7/lib/X11/X68kConfig

EXAMPLE

Following is the example configuration file:

;; Example configuration file for X68k. 
;; These lines are comments. 
 
; Define standard monochrome mode: 
(ModeDef Monochrome768x512 
;  type depth   class     width height 
   Text   1   StaticGray   768   512 
; CRTC-R00 -R01 -R02 -R03 -R04 -R05 -R06 -R07 -R08 
       137   14   28  124  567    5   40  552   27 
; CRTC-R20 VIDEOC-R0 dotclk 
      1046         4      0) 
 
; Configure the display as Monochrome768x512 defined above: 
(Mode Monochrome768x512) 
 
; Specify the input devices: 
(Mouse standard) 
(Keyboard standard)

SEE ALSO

Xserver(1), X(1), xdm(1), xinit(1), xmodmap(1), xkbdcomp(1)

HISTORY

X68k was originally written by Yamasaki Yasushi <yamapu@osk3.3web.ne.jp> as XFree68 in May 1996, and was little modified by Minoura Makoto <minoura@netbsd.org> to fit with the NetBSD source tree in Jan. 1998. Officially appeared in NetBSD 1.4.

BUGS

X68k may damage your display hardware, depending on the configuration. The keyboard geometry database is not correct currently.