- online man pages   

SunOS man pages : GFXconfig (1)

Maintenance Commands                                pgxconfig(1M)


pgxconfig, GFXconfig - configure the PGX32 (Raptor GFX) Graphics Accelerator


/usr/sbin/pgxconfig [ -dev device-filename ] [ -res video- mode [ try | noconfirm | nocheck ] ] [ -file machine | system ] [ -depth 8 | 24 ] [ -24only ] [ -defaults ] /usr/sbin/pgxconfig [ -propt ] [ -prconf ] /usr/sbin/pgxconfig [ -help ] [ -res ? ] /usr/sbin/pgxconfig [ -i ]


The pgxconfig utility configures the PGX32 (Raptor GFX) Graphics Accelerator and some of the X11 window system defaults for PGX32 (Raptor GFX). A previous version of this utility was named GFXconfig. The first form of pgxconfig shown in the synopsis above stores the specified options in the OWconfig file. These options are used to initialize the PGX32 (Raptor GFX) 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, third, and fourth forms, which invoke only the -prconf, -propt, -help, and -res ? options, do not update the OWconfig file. For the third form all other options are ignored. The -i option starts pgxconfig in interactive mode. Options may be specified for only one PGX32 (Raptor GFX) device at a time. Specifying options for multiple PGX32 (Raptor GFX) devices requires multiple invocations of pgxconfig -i. Only PGX32 (Raptor GFX)-specific options can be specified through pgxconfig. The normal window system options for specifying default depth, default visual class and so forth are still specified as device modifiers on the openwin com- mand line. See the Xsun(1) manual page available with the SUNWxwman package. The user can also specify the OWconfig file that is to be updated. By default, the machine-specific file in the /usr/openwin directory tree is updated. The -file option can be used to specify an alternate file to use. For example, SunOS 5.8 Last change: 25 Aug 1999 1 Maintenance Commands pgxconfig(1M) the system-global OWconfig file in the /etc/openwin direc- tory tree can be updated instead. Both of these standard OWconfig files can only be written by root. Consequently, the pgxconfig program, which is owned by the root user, always runs with setuid root permission.


-dev device-filename Specify the PGX32 (Raptor GFX) special file. The default is /dev/fbs/gfxp0, or /dev/fbs/raptor0 if applicable. -file machine | system Specify 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. -res video-mode [try | noconfirm | nocheck ] Specify the built-in video mode used to drive the mon- itor connected to the specified PGX32 (Raptor GFX) device. The format for video-mode can be one of the following: widthxheightxrate The width is the screen width in pixels, height is the screen height in pixels, and rate is the vertical frequency of the screen refresh. As a convenience, -res also accepts formats with @ prepended to the refresh rate rather than x. For example: 1280x1024@76. The list can be obtained by running pgxconfig with the -res ? 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. The pgxconfig utility will not permit you to set a resolution not supported by the board unless the noconfirm or nocheck option is specified. It will also request confirmation before setting a resolution not supported by the monitor if the nocheck option is not specified. Symbolic names For convenience, the video modes listed below have symbolic names defined. Rather than the form widthxheightxrate, the symbolic name may be supplied as the argument to -res. If the sym- bolic name is none, the screen resolution will SunOS 5.8 Last change: 25 Aug 1999 2 Maintenance Commands pgxconfig(1M) be the video mode that is currently programmed in the device when the window system is run. svga 1024x768x60 1152 1152x900x76 1280 1280x1024x76 vga 640x480x60 none default console resolution The -res option also accepts additional, optional arguments immediately following the video mode specif- ication. Any or all of these may be present. noconfirm Using the -res option, the user could put the system into an unusable 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 occurring, the default behavior of pgxconfig 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 pgxconfig to bypass this confirma- tion and to program the requested video mode anyway. This option is useful when pgxconfig is being run from a shell script. nocheck If present, normal error checking based on the monitor sense code is suspended. The video mode specified by the user will be accepted regard- less of whether it is appropriate for the currently attached monitor. (This option is use- ful if a different monitor is to be connected to the PGX32 (Raptor GFX) device). Use of this option implies noconfirm as well. try This option allows the user to test the speci- fied resolution before committing it. It displays a pattern on the screen with the speci- fied resolution. If the test pattern appears correctly, the user may answer "y" to the query. The other permissable answer is "n". -res ? SunOS 5.8 Last change: 25 Aug 1999 3 Maintenance Commands pgxconfig(1M) Print the list of possible resolutions supported by the PGX32 and the monitor. -24only Force the PGX32 (Raptor GFX) device to use 24 bit only when running Openwindows. -defaults Reset all option values to their default values. -propt Print the current values of all PGX32 (Raptor GFX) options in the OWconfig file specified by the -file option for the device specified by the -dev option. Print the values of options as they would be in the OWconfig file after the call to pgxconfig would have completed. The following is a typical display: --- OpenWindows Configuration for /dev/fbs/gfxp0 --- OWconfig: machine Video Mode: not set -prconf Print the PGX32 (Raptor GFX) hardware configuration. Thie following is a typical display: --- Hardware Configuration for /dev/fbs/gfxp0 --- DAC: version 0x0 Type: Board: PROM: version 0x0 PROM Information: RAM: EDID Data: Monitor Sense ID: 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 Possible depths: Current depth: 8 SunOS 5.8 Last change: 25 Aug 1999 4 Maintenance Commands pgxconfig(1M) -help Print a list of the pgxconfig command line options, along with a brief explanation of each. -i Start pgxconfig in interactive mode.


For a given invocation of pgxconfig, if an option does not appear on the command line, the corresponding OWconfig option is not updated; it retains its previous value, except for -depth and -24only. A default value is used if a PGX32 (Raptor GFX) option has not been specified with pgxconfig when the window system is run. The option defaults are as follows: -dev /dev/fbs/gfxp0 -file system -res none The default of none for the -res option indicates that when the window system is run, the screen resolution will be the video mode that is currently programmed in the device.


Example 1: Switch the monitor type resolution. The following example switches the monitor type to the reso- lution of 1280 x 1024 at 76 Hz: example% /usr/sbin/pgxconfig -res 280x1024x76


/dev/fbs/gfxp0 device special file /usr/openwin/server/etc/OWconfig system configuration file /etc/openwin/server/etc/OWconfig machine configuration file


PGX32 Installation Manual SunOS 5.8 Last change: 25 Aug 1999 5