NNAAMMEE

m64config - configure the M64 Graphics Accelerator

SSYYNNOOPPSSIISS

//uussrr//ssbbiinn//mm6644ccoonnfifigg [ --ddeevv device-filename ]

          [ --rreess video-mode [nnooww || ttrryy] [nnooccoonnfifirrmm || nnoocchheecckk] ]
          [ --fifillee mmaacchhiinnee || ssyysstteemm ] [ --pprroopptt ] [ --pprrccoonnff ] [ --ddeeffaauullttss ]

//uussrr//ssbbiinn//mm6644ccoonnfifigg [ --pprroopptt ] [ --pprrccoonnff ]

//uussrr//ssbbiinn//mm6644ccoonnfifigg [ --hheellpp ] [ --rreess ? ]

DDEESSCCRRIIPPTTIIOONN

mm6644ccoonnfifigg configures the M64 Graphics Accelerator and some of the X11 window system defaults for M64.

The first form of mm6644ccoonnfifigg shown in the synopsis above stores the specified options in the OWconfig file. These options will be used to initialize the M64 device the next time the window system is run on that device. Updating options in the OWconfig file provides persistence of these options across window system sessions and system reboots.

The second and third forms which invoke only the --pprrccoonnff, --pprroopptt, --hheellpp, and --rreess ? options do not update the OWconfig file. Additionally, for the third form all other options are ignored.

Options may be specified for only one M64 device at a time. Specifying options for multiple M64 devices requires multiple invocations of mm6644ccoonnfifigg.

Only M64-specific options can be specified through mm6644ccoonnfifigg. The normal window system options for specifying default depth, default visual class and so forth are still specified as device modifiers on the openwin command line (see XXssuunn(1) ).

The user can also specify the OWconfig file that is to be updated. By default, the machine-specific file in the /etc/openwin directory tree is updated. The -file option can be used to specify an alternate file to use. For example, the system-global OWconfig file in the /usr/openwin directory tree can be updated instead.

Both of these standard OWconfig files can only be written by root. Consequently, the mm6644ccoonnfifigg program, which is owned by the root user, always runs with setuid root permission.

OOPPTTIIOONNSS

--ddeevv device-filename

Specifies the M64 special file. The default is //ddeevv//ffbbss//mm664400 .

--fifillee mmaacchhiinnee || ssyysstteemm

Specifies which OWconfig file to update. If machine, the machine-specific OWconfig file in the /etc/openwin directory tree is used. If system, the global OWconfig file in the /usr/openwin directory tree is used. If the file does not exist, it is created.

--rreess video-mode [[ nnooww || ttrryy [[ nnooccoonnfifirrmm || nnoocchheecckk ]] ]]

Specifies the video mode used to drive the monitor connected to the specified M64 device.

The format of these built-in video modes is:

wwiiddtthhxhheeiigghhttxrraattee

where wwiiddtthh is the screen width in pixels, hheeiigghhtt is the screen height in pixels, and rraattee is the vertical frequency of the screen refresh. The ii suffix of 640x480x60i and 768x575x50i designates interlaced video timing. If absent, noninterlaced timing will be used. As a convenience, -res also accepts formats with @ in front of the refresh rate instead of x. For example: 1280x1024@76. The list of valid video-modes is shown below. This list can also be obtained by running mm6644ccoonnfifigg with the --rreess ? option (the third form shown in the command synopsis above). Note that not all resolutions are supported by both the video board and by the monitor. m64config will not permit you to set a resolution the board does not support, and will request confirmation before setting a resolution the monitor does not support.

720x400x70

720x400x88

640x480x60

640x480x67

640x480x72

640x480x75

800x600x56

800x600x60

800x600x72

800x600x75

832x624x75

1024x768x87

1024x768x60

1024x768x70

1024x768x75

1280x1024x75

1280x1024x76

1152x870x75

1280x1024x60

1152x900x66

1152x900x76

1280x1024x67

960x680x112S

960x680x108S

640x480x60i

768x575x50i

1600x1280x76

1920x1080x72

1280x800x76

1440x900x76

1600x1000x66

1600x1000x76

1920x1200x70

	names For convenience, some for them. Instead of as the argument to -res. window system is run programmed in the device.	of the above the form widthx The meaning of the screen
	Name Corresponding	Video Mode
	svga 1024x768x60
	1152 1152x900x76
	1280 1280x1024x76
	ntsc 640x480x60i
	pal 768x575x50i
	none (see text above)

Symbolic

video modes have symbolic names defined

heightx rate, one of these names may be supplied

the symbolic name none is that when the

resolution will be the video mode that is currently

The -res option also accepts additional, optional arguments immediately following the video mode specification. Any or all of these may be present.

nnooww

If present, not only will the video mode be updated in the OWconfig file, but the M64 device will be immediately programmed to display this video mode. (This is useful for changing the video mode before starting the window system).

Note - It is inadvisable to use this suboption with mm6644ccoonnfifigg while

the configured device is being used (e.g. while running the

window system); unpredictable results may occur. To run

mm6644ccoonnfifigg with the now suboption, first bring the window

system down. If the now suboption is used within a window system session, the video mode will be changed immediately, but the width and height of the affected screen won't change until the window system is exited and reentered again. In

addition, the system may not recognize changes in stereo

mode. Consequently, this usage is strongly discouraged.

nnooccoonnfifirrmm

Using the -res option, the user could potentially put the system into an usable state, a state where there is no video output. This can happen if there is ambiguity in the monitor sense codes for the particular code read. To reduce the chance of this, the default behavior of mm6644ccoonnfifigg is to print a warning message to this effect and to prompt the user to find out if it is okay to continue. The noconfirm option instructs mm6644ccoonnfifigg to bypass this confirmation and to program the requested video mode anyway. This option is useful when

mm6644ccoonnfifigg is being run from a shell script.

nnoocchheecckk

If present, the normal error checking based on the monitor sense code (described above) will be suspended. The video mode specified by

the user will be accepted regardless of whether it is appropriate for the currently attached monitor. (This option is useful if a different monitor is to be connected to the M64 device). Use of this option implies noconfirm well.

ttrryy

If present, the specified video mode will be programmed on a trial basis. The user will be asked to confirm the video mode by typing 'y' within 10 seconds. Or the user may terminate the trial before 10 seconds are up by typing any character. Any character other than 'y' or carriage return is considered a no and the previous video mode will be restored and mm6644ccoonnfifigg will not change the video mode in the OWconfig file (other options specified will still take effect). If a carriage return is typed, the user is prompted for a yes or no answer on whether to keep the new video mode. This option implies the now suboption (see the warning note on the now suboption).

--ddeeffaauullttss

Resets all option values to their default values.

--pprroopptt Prints the current values of all M64 options in the OWconfig file specified by the

-file option for the device specified by the -dev option. Prints the values of options as they will be in the OWconfig file after the call to mm6644ccoonnfifigg completes. This is a typical display:

        --- OpenWindows Configuration for /dev/fbs/m640 ---
        OWconfig: machine
        Video Mode: not set

--pprrccoonnff

Prints the M64 hardware configuration. This is a typical display:

--- Hardware Configuration for /dev/fbs/m640 ---
ASIC: version 0x41004754
DAC: version 0x0
PROM: version 0x0
Card possible resolutions:           640x480x60, 800x600x75,
          1024x768x60,      1024x768x70, 1024x768x75, 1280x1024x75,
          1280x1024x76, 1280x1024x60, 1152x900x66, 1152x900x76,
          1280x1024x67, 960x680x112S, 960x680x108S, 640x480x60i,
          768x575x50i, 1280x800x76, 1440x900x76, 1600x1000x66,
          1600x1000x76, vga, svga, 1152, 1280, stereo, ntsc, pal
Monitor possible resolutions:            720x400x70, 720x400x88,
          640x480x60, 640x480x67, 640x480x72, 640x480x75,
          800x600x56, 800x600x60, 800x600x72, 800x600x75,
          832x624x75, 1024x768x87, 1024x768x60, 1024x768x70,

          1024x768x75, 1280x1024x75, 1280x1024x76, 1152x900x66,
          1152x900x76, 1280x1024x67, 960x680x112S, vga, svga,
          1152, 1280, stereo
Current resolution setting: 1280x1024x76
Current depth: 8

--hheellpp

Prints a list of the mm6644ccoonnfifigg command line options, along with a brief explanation of each.

DDEEFFAAUULLTTSS

For a given invocation of mm6644ccoonnfifigg command line if an option does not appear on the command line, the corresponding OWconfig option is not updated; it retains its previous value.

When the window system is run, if an M64 option has never been specified via mm6644ccoonnfifigg, a default value is used. The option defaults are as follows:

Option	Default
-dev	/dev/fbs/m640
-file	machine
-res	none

The default for the -res option of none means that when the window system is run the screen resolution will be the video mode that is currently programmed in the device.

Note - This provides compatibility for users who are used to specifying the device reso-

lution through the PROM. On some devices (e.g. GX) this is the only way of specifying the video mode. This means that the PROM ultimately determines the default M64 video mode.

EEXXAAMMPPLLEESS

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

eexxaammppllee%% //uussrr//ssbbiinn//mm6644ccoonnfifigg --rreess 11228800xx11002244xx7766

FFIILLEESS

//ddeevv//ffbbss//mm664400

device special file

//uussrr//ooppeennwwiinn//sseerrvveerr//eettcc//OOWWccoonnfifigg

System config file

//eettcc//ooppeennwwiinn//sseerrvveerr//eettcc//OOWWccoonnfifigg

System config file

SSEEEE AALLSSOO

XXssuunn(1), mmmmaapp(2), ffbbiioo(7I), mm6644 (7D)