NAME

leoconfig − initialize the Leo (ZX and TZX) Graphics Accelerator and download microcode

SYNOPSIS

/usr/sbin/leoconfig [ −c ] [ −h ] [ −i ] [ −v ] [ −d device_filename ] [ −f filename ]

[ −g gamma_value ] [ −I microcode_directory ] [ −l leofloat_enable ]

[ [ −degamma8 on | off ] | [ −DEGAMMA8 on | off ] ] [ −m monitor_type ]
/usr/sbin/leoconfig −G gamma_value [ −v ]
/usr/sbin/leoconfig −M monitor_type [ −v ]

DESCRIPTION

The leoconfig command initializes the Leo (both ZX and TZX) Graphics Accelerator and downloads microcode from the host.  leoconfig is normally run as a part of the /etc/init.d/leoconfig script to download the Leo microcode file and to complete Leo initialization.  The standard version of the file /etc/init.d/leoconfig runs leoconfig with the following command line options:

/usr/sbin/leoconfig ${MONTYPE} −d $devpath/$inst −I /usr/lib

If another configuration is desired, edit the leoconfig script in the /etc/init.d/leoconfig file. 

It is inadvisable to run the leoconfig command while the configured device is being used; unpredictable results may occur. To run leoconfig, first bring the window system down. 

Only root can run this command. 

File names may be either relative or absolute path names. Relative path names are prepended with the path specified by −I, or the default path /usr/lib. 

OPTIONS

The following options are supported:

−c Checks that the microcode has loaded correctly. 

−d device_filename
Specifies the Leo special file. The default is /dev/fbs/leo0. 

−degamma8 on | off
Specifies automatic inverse gamma correction of 8-bit indexed color maps. This allows color maps with built-in gamma correction to work properly on Leo. The default is on. 

−DEGAMMA8 on | off
Like the −degamma8 option but only specifies automatic inverse gamma correction; does not otherwise initialize Leo or download microcode. 

−f filename
Specifies the microcode file. The default is leo.ucode. 

−g gamma_value
Specifies the gamma correction value. The default is 2.22. 

−G gamma_value
Loads the gamma correction table only; does not initialize Leo or download microcode. Any other option besides −v will cause an invalid option message to be displayed. 

−h Display help menu of valid command arguments. 

−i Initialize the Leo system. 

−I microcode_directory
Specifies the directory containing the microcode files. The default is /usr/lib. 

−l leofloat_enable
Specifies the LeoFloat enable mask in decimal form (one bit per float).  The default for model ZX is 15.  The default for model TZX is 255. 

−m monitor_type
Specifies the monitor type, where monitor_type must be one of the following:

1280_76 1280 × 1024 @ 76 Hz, non-interlaced. 

1280_67 1280 × 1024 @ 67 Hz, non-interlaced. 

1152_76 1152 × 900 @ 76 Hz, non-interlaced. 

1152_66 1152 × 900 @ 66 Hz, non-interlaced. 

1024_76 1024 × 768 @ 76 Hz, non-interlaced. 

1024_60 1024 × 768 @ 60 Hz, non-interlaced. 

stereo_108 960 × 680 @ 108 Hz, non-interlaced, stereo. 

stereo_114 960 × 680 @ 112 Hz, non-interlaced, stereo. 

pal 770 × 575 @ 50 Hz, interlaced (PAL). 

ntsc 640 × 480 @ 60 Hz, interlaced (NTSC). 

−M monitor_type
Specifies the monitor type only; does not initialize the Leo or download microcode. Any other option besides −v will cause an invalid option message to be displayed. The monitor_type value is the same as for the −m option. 

−v Verbose. Display detailed progress reports. 

EXAMPLES

The following example switches the monitor type to the maximum resolution of 1280 × 1024 at 76 Hz:

example% /usr/sbin/leoconfig −M 1280_76 −v

EXIT STATUS

0 success

1 an error has occurred

FILES

/dev/fbs/leo0 device special file

leo.ucode Leo microcode file

/usr/lib directory that normally contains microcode file

/etc/init.d/leoconfig local Leo initialization script

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

SEE ALSO

mmap(2), attributes(5), fbio(7I), leo(7D)

SunOS 5.6  —  Last change: 14 Nov 1994