igsconfig
Maintenance Commands igsconfig(1M)NAME
igsconfig - configure the IGS Graphics AdaptorSYNOPSIS
/usr/sbin/igsconfig [ -dev device-filename ] [ -res video-mode [ noconfirm | nocheck ] ] [ -depth 8 | 24 ] [ -file machine | system ] [ -propt ] [ -prconf ] [ -defaults ] /usr/sbin/igsconfig [ -propt ] [ -prconf ] /usr/sbin/igsconfig [ -help ] [ -res ? ]DESCRIPTION
igsconfig configures the IGS Graphics Adaptor and some of the X11 window system defaults for IGS. The first form of igsconfig stores the specified options in the OWconfig file. These options will be used to initialize the IGS 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 -prconf, -propt, -help, and -res ? options do not update the OWcon- fig file. Additionally, for the third form all other options are ignored. Options may be specified for only one IGS device at a time. Specifying options for multiple IGS devices requires multi- ple invocations of igsconfig. Only IGS-specific options can be specified through igscon- fig. 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 the OpenWindows Desktop Reference Manual for details. 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 exam- ple, 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 igsconfig program, which is owned by the root user, always runs with setuid root permission. SunOS 5.8 Last change: 18 Jun 1997 1 Maintenance Commands igsconfig(1M)OPTIONS
-dev device-filename Specifies the IGS special file. If not specified, igsconfig will try /dev/fbs/igs0 through /dev/fbs/igs8 until one is found. -file machine | system 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. -res video-mode [ noconfirm | nocheck ] Specifies the video mode used to drive the monitor con- nected to the specified IGS device. Video modes are built-in. video-mode has the format of widthxheightx- rate. 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 @ preceding the refresh rate instead of x. For example, 1280x1024@75. The following table shows the list of valid video- modes. This list can also be obtained by running igsconfig -res '?'. Note that the ? must be quoted. Not all resolutions are supported by both the video board and by the monitor. igsconfig 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. SunOS 5.8 Last change: 18 Jun 1997 2 Maintenance Commands igsconfig(1M) _________________ | 640x480x60 | | 640x480x72 | | 640x480x75 | | 800x600x60 | | 800x600x72 | | 800x600x75 | | 1024x768x60 | | 1024x768x72 | | 1024x768x75 | | 1024x768x87 | | 1280x1024x60 | | 1280x1024x72 | | 1280x1024x75 | | 1280x1024x87 | | 1600x1200x60 | | 1600x1200x87 | |________________| Symbolic names For convenience, some video modes have symbolic names defined for them. Instead of the form widthxheightx- rate, one of these names may be supplied as the argu- ment to -res. The meaning of the symbolic name none is that when the window system is run the screen resolu- tion will be the video mode that is currently pro- grammed in the device. SunOS 5.8 Last change: 18 Jun 1997 3 Maintenance Commands igsconfig(1M) _________________________________________________________ | Name Corresponding Video Mode | |________________________________________________________| | vga 640x480x60 | | svga 1024x768x60 | | 640 640x480x75 | | 800 800x600x75 | | 1024 1024x768x75 | | 1280 1280x1024x75 | | 1600 1600x1200x87 | | 640x480 640x480x75 | | 800x600 800x600x75 | | 1024x768 1024x768x75 | | 1280x1024 1280x1024x75 | | 1600x1200 1600x1200x87 | | none (video mode currently programmed in device)| |________________________________________________________| The -res option also accepts additional, optional argu- ments immediately following the video mode specifica- tion. Any or all of these may be present. noconfirm 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 igsconfig 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 igsconfig to bypass this confirmation and to program the requested video mode anyway. This option is useful when igsconfig is being run from a shell script. nocheck If present, the normal error checking based on the mon- itor sense code 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 IGS device. Use of this option implies noconfirm as well. -depth 8|24 Sets the screen depth to 8 or 24 bits per pixel. 24 bits per pixel enables TrueColor graphics in the window system, at the expense of screen resolution. SunOS 5.8 Last change: 18 Jun 1997 4 Maintenance Commands igsconfig(1M) The maximum resolution that is available with 24 bits per pixel depends on the amount of memory installed on the PGX card. For 2-Meg PGX cards, the maximum avail- able resolution is 800x600. For 4-Meg cards, it is 1152x900. If there is not enough memory for the speci- fied combination of resolution and depth, igsconfig will print an error message and exit. Note: the current implementation only supports 8 bit depth. -defaults Resets all option values to their default values. -propt Prints the current values of all IGS 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 igsconfig completes. The following is a typical display using the -propt option: --- OpenWindows Configuration for /dev/fbs/igs0 --- OWconfig: machine Video Mode: 1024x768x75 Depth: 8 -prconf Prints the IGS hardware configuration. The following is a typical display using the -prconf option: --- Hardware Configuration for /dev/fbs/igs0 --- Mappable FB Memory: 2088960(0x1fe000) Bytes FB Virtual Address: 0x6082a000 Chip I.D. #0: version 164 Chip I.D. #1: version 8 Chip I.D. #2: version 1 PROM version #: 0 Card possible resolutions: 640x480x60, 640x480x72, 640x480x75, 800x600x60, 800x600x72, 800x600x75, 1024x768x60, 1024x768x72, 1024x768x75, 1024x768x87, 1280x1024x60, 1280x1024x72, 1280x1024x75, 1280x1024x87, 1600x1200x60, 1600x1200x87, vga, svga, 640, 800, 1024, 1280, 1600, 640x480, 800x600, 1024x768, 1280x1024, 1600x1200 Monitor possible resolutions: 720x400x70, 720x400x88, 640x480x60 640x480x67, 640x480x72, 640x480x75, 800x600x56, 800x600x60 800x600x72, 800x600x75, 832x624x75, 1024x768x87, 1024x768x60 1024x768x70, 1024x768x75, 1280x1024x75, 1280x1024x76, 1152x900x66, 1152x900x76, 1280x1024x67, vga, svga, 1152, SunOS 5.8 Last change: 18 Jun 1997 5 Maintenance Commands igsconfig(1M) 1280, stereo Current resolution setting: 1280x1024x75 Current depth: 8 -help Prints a list of the igsconfig command line options, along with a brief explanation of each. DEFAULTS For a given invocation of igsconfig command line if an option does not appear on the command line, the correspond- ing OWconfig option is not updated; it retains its previous value. When the window system is run, if an IGS option has never been specified by igsconfig, a default value is used. The option defaults are as follows: ________________________ | Option Default | |_______________________| | -dev /dev/fbs/igs0| | -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. This provides compatibility for users who are used to speci- fying the device resolution through the PROM. On some dev- ices (for example, GX) this is the only way of specifying the video mode. This means that the PROM ultimately deter- mines the default IGS video mode. EXAMPLES The following example switches the monitor type to the max- imum resolution of 1280 x 1024 at 75 Hz: example% /usr/sbin/igsconfig -res 1280x1024x75FILES
/dev/fbs/igs0 device special file /usr/openwin/server/etc/OWconfig system config file /etc/openwin/server/etc/OWconfig system config file SunOS 5.8 Last change: 18 Jun 1997 6 Maintenance Commands igsconfig(1M)ATTRIBUTES
See attributes(5) for descriptions of the following attri- butes: __________________________________ | ATTRIBUTE TYPE| ATTRIBUTE VALUE| |_______________|_________________| | Availability | SUNWigs | |_______________|_________________|SEE ALSO
mmap(2), attributes(5), fbio(7I), igs(7D) OpenWindows Desktop Reference Manual SunOS 5.8 Last change: 18 Jun 1997 7