aticonfig(1) parse an existing X-Server configuration file and modify it to operate with ATI products

SYNOPSIS

aticonfig [OPTIONS...]

DESCRIPTION

aticonfig

is a tool which should help you to create an (initial) X-server configuration file using the fglrx(4x) video driver. You can enable or disable special driver options.

OPTIONS

aticonfig currently supports the following options:

ATI Initial Configuration

--initial[=dual-head]

If this option is given without any parameter, a default ATI device section is generated in the configuration file which is capable of loading the fglrx driver.

If this option is used with the dual-head parameter, it further generates a dual head setup configuration. See fglrx(4x) for an explanation of a dual head setup.

TV Options

--tvf string, --tv-format-type=string

Change the TV signal format. string can be one of: NTSC-JPN, NTSC-M, NTSC-N, PAL-B, PAL-COMB-N, PAL-D, PAL-G, PAL-H, PAL-I, PAL-K, PAL-K1, PAL-L, PAL-M, PAL-N, PAL-SECAM-D, PAL-SECAM-K, PAL-SECAM-K1, PAL-SECAM-L. Using this option affects Option "TVFormat" of fglrx(4x).


Note
Not all graphics cards support every mode. Regional settings are applicable.

--tvs string, --tv-standard-type=string

Change the TV standard for TV output. string can be one of: VIDEO, SCART, YUV. Using this option affects Option "TVStandard" of fglrx(4x).

--tv-overscan=boolean

Enable or disable overscan mode for TV-Out. boolean can be one of: yes, no. Using this option affects Option "TVOverscan" of fglrx(4x).


Note
Not all TV formats support overscan. Try to toggle overscan "off" before changing the TV format if an error occurs.

--tv-info

Print out the current TV geometry, TV format and if the TV is physically connected.

--tv-geometry=widthxheight{+|-}vertical_offset{+|-}horizontal_offset

Change the size and position of the TV-Out display. The integer values for width and height are given in percentage units. Please note that the valid range for these values depends on the TV format, but as a rule of thumb they are valid in the range of [1..100]. You can further specify the vertical_offset and horizontal_offset values as offset from the center of the screen in pixels. Their ranges depend on the ASIC and you should use --tv-info to get valid ranges for these values. Using this option affects Option "TVHSizeAdj", Option "TVVSizeAdj" and - if given - Option "TVHPosAdj" and Option "TVVPosAdj" of fglrx(4x). If you invoke this option only with height and width, the offset values are automatically set to "0".

FireGL Workstation Board Features

--app string, --use-app-profile=string

Change the application profile for a FireGL workstation board. string can be one of: default, maya, softimage-xsi, softimage-3d, houdini4.0, houdini5.0, houdini5.5. Using this option affects Option "Capabilities" of fglrx(4x).

FSAA Options

--fsaa=boolean

Enable or disable full scene anti-aliasing (FSAA). Enable this option to enhance photo-realism in 3D rendering. Disable it to get the most accurate 3D image. boolean can be one of: on, off. Using this option affects Option "FSAAEnable" of fglrx(4x).

--fs integer, --fsaa-samples=integer

Set the number of FSAA samples per pixel. integer can be one of: 0, 2, 4, 6, off. off is the same as 0. Using this option affects Option "FSAAScale" of fglrx(4x).

--fsg boolean, --fsaa-gamma=boolean

Enable or disable FSAA gamma. boolean can be one of: on, off. Using this option affects Option "FSAADisableGamma" of fglrx(4x).

--fmsp real,real,...,real, --fsaa-ms-positions=real,real,...,real

Change the FSAA Multi-Sample Positions for x0,y0 to x5,y5. You must specify exactly 12 real number values separated by commas. Using this option affects Option "FSAAMSPosX0..5", Option "FSAAMSPosY0..5" and Option "FSAACustomizeMSPos" of fglrx(4x).

Screen-Related Options

--ovt string, --overlay-type=string

Change the overlay for the X server. string can be one of: opengl, Xv, disable.


Note
Affects Option "OpenGLOverlay" and Option "VideoOverlay". See fglrx(4x).

--ovon boolean, --overlay-on=boolean

Choose which head the hardware overlay should be visible on. The hardware overlay can be used for either OpenGL, video, pseudo-color or stereo. boolean can be one of: 0, 1.

--lcd string, --lcd-mode=string

Change the LCD mode. string can be one of: center, full.


Note
Affects Option "CenterMode". See fglrx(4x).

--dtop string, --desktop-setup=string

Change the desktop setup for multiple display adapters. string can be one of: single, clone, mirror, horizontal, horizontal,reverse, vertical, vertical,reverse.


Note
Affects Option "DesktopSetup". See fglrx(4x).

--vs boolean, --sync-vsync=boolean

Enable or disable sync buffer swaps with vsync. Enable this option to prevent tearing during 3D rendering. boolean can be one of: on, off.


Note
Affects Option "Capabilities". See fglrx(4x).

--psc boolean, --pseudo-color=boolean

Enable or disable pseudo-color visuals. Enable this option to get 8-bit color support. boolean can be one of: on, off.


Note
Affects Option "PseudoColorVisuals". See fglrx(4x).

--stereo=boolean

Enable or disable quad-buffer stereo support. Enable this option only for using applications that support the use of hardware 3D shutter glasses. boolean can be one of: on, off.


Note
Affects Option "Stereo". See fglrx(4x).

--ss boolean, --stereo-sync=boolean

Enable or disable quad-buffer stereo sync. Enable this option to get 3D glasses to synchronize with the infrared transmitter. boolean can be one of: on, off.


Note
Affects Option "StereoSyncEnable". See fglrx(4x).

--resolution=resolution1[,resolution2,...]

Set the modes for the first screen. You may specify several resolutions separated by commas.


Note
Affects Modes in SubSection "Display" (Section "Screen"). See xorg.conf(5x).

--hsync=frequency

Change the horizontal sync range of the first monitor. Make sure you know the capabilities of your monitor before changing this option. frequency should be understood as a range of frequencies.


Note
Affects HorizSync in Section "Monitor". See xorg.conf(5x).

--vrefresh=frequency

Change the vertical refresh range of the first monitor. Make sure you know the capabilities of your monitor before changing this option. frequency should be understood as a range of frequencies.


Note
Affects VertRefresh in Section "Monitor". See xorg.conf(5x).

--resolution2=resolution1[,resolution2,...]

Set the modes for the second screen for dual head. You may specify several resolutions separated by commas.


Note
The secondary screen must exist.

--hsync2=frequency

Change the horizontal sync range of the second display. Make sure you know the capabilities of your monitor before changing this option. frequency should be understood as a range of frequencies.

--vrefresh2=frequency

Change the vertical refresh range of the second display. Make sure you know the capabilities of your monitor before changing this option. frequency should be understood as a range of frequencies.

--mode2=mode1[,mode2,...]

Change the modes for the second display. You may specify several resolutions separated by commas. This option is only valid for clone and big desktop mode settings.


Note
Affects Option "Mode2". See fglrx(4x).

--screen-layout=string

Set the secondary screen position for dual head. string can be one of: left, right, above, below.

--screen-overlap=integer

Set the screen overlap region in big desktop mode in pixels.


Note
Affects Option "ScreenOverlap". See fglrx(4x).

--force-monitor=string[,string,...]

Describe all displays that are to be enabled and/or disabled regardless of their physical connection. string can be one or more of the following set, separated by commas: crt1, crt2, lvds, tv, tmds1, tmds2, tmds2i, nocrt1, nocrt2, nolvds, notv, notmds1, notmds2, notmds2i.


Note
Affects Option "ForceMonitors". See fglrx(4x).

POWERplay Options

The following options will not change the configuration file and take affect immediately. Other options given on the (same) command line will be ignored.

--lsp, --list-powerstates

Print information about power states and exit.

--set-powerstate=state

Set a power state listed by --lsp.

Advanced Options

--tls=boolean

Enable or disable fast thread local storage. Disable this option when virtual machines or Wine(X) fail to work properly. boolean can be one of: on, off. Using this option affects Option "UseFastTLS" of fglrx(4x).

--sb boolean, --signal-block=boolean

Enable or disable signal blocking. Disable this option when debugging a multi-threaded OpenGL application. boolean can be one of: on, off. Using this option affects Option "BlockSignalsOnLock" of fglrx(4x).

--locked-userpages=boolean

Enable or disable locked user pages. Disable this option if the system hangs when running fgl_glxgears(1x). boolean can be one of: on, off. Using this option affects Option "KernelModuleParm" of fglrx(4x).


Important
As of version 8.28.8 of the ATI Linux Driver, user page lock is no longer available on AGP systems.

--gcpu boolean, --generic-cpu=boolean

Enable or disable generic CPU. Use this option if the CPU is being reported improperly. For example: If you have an AMDCPU that is being reported as Intel. boolean can be one of: on, off. Using this option affects Option "ForceGenericCPU" of fglrx(4x).

--max-gart-size=integer

Set user-defined max GART size for non-AGP systems. Possible integer values are [64..512] MB. Using this option affects Option "MaxGARTSize" of fglrx(4x).

Dynamic Display Management Options

The following options are used to query or set the driver, controller and adaptor information. Changes will take effect immediately. Other options given on the (same) command line will be ignored.

--enable-monitor=string,string

Setting current monitor to be enabled. Only 2 displays can be enabled at the same time. Any displays that are not on the list will be disabled. string can be one of: none, auto, crt1, crt2, lvds, tmds1, tmds2, tv. To use the default policy to enable the displays use auto. Using this option affects Option "EnableMonitor" of fglrx(4x).

--query-monitor

Return information about connected and enabled monitors.

--swap-monitor

Swap the contents on the two monitors.


Note
Only effective to big desktop setups. See fglrx(4x)

Pair Mode Options

The following options are used to query, add and/or remove pair modes. Changes will will take effect immediately. Other options given on the (same) command line will be ignored.

--list-pairmode

List all current existing pair modes the driver can use.

--add-pairmode=width0xheight0+width1xheight1

Add one pair mode to the list. width0xheight0 specifies the size of primary and width1xheight1 the size of the secondary display. Using this option affects Option "PairModes" of fglrx(4x).

--remove-pairmode=index-number

Remove one pair mode from the list. The index-number can be get from the --list-pairmode option.

External Events Daemon Options

The following options will not change the configuration file. Instead they are used to send commands to atieventsd(8), ATI's external events daemon.

--set-policy=string

Sets the event policy for the daemon. string can be one of: handle_lid, ignore_lid. For more information see atieventsd(8).

Miscellaneous Options

-v, --verbose

Show what aticonfig is doing on a verbose level.

-q, --quiet

Disable all information output except for errors.

--effective=string

Choose when the requested changes should take effect:

now

Changes take effect immediately. This change will affect the running X session if applicable. Only --set-powerstate and --ovon options are applicable for now.

startup

Changes take effect on future X server startups. This change will modify the X server configuration file if applicable.

The default is now,startup, i.e., do both as applicable.

--nobackup

Do not make an automatic backup of the configuration file.

-i file, --input=file

Select a file to input as the configuration file. Without this option, aticonfig will search /etc/X11 for the default configuration file.

-o file, --output=file

Select a file to output the new configuration file to. Without this option, aticonfig will replace the input file with the newly generated file.


Note
If the (given) file is already existing, it will be backuped as file.fglrx-integer. To suppress this behavior, use the --nobackup option.

-h, --help

Display the help screen.

-f, --force

Force aticonfig to generate default Monitor, Device and Screen sections even if the original configuration file has invalid settings in these sections. Only valid with the --initial option.

EXAMPLES

This paragraph should show you some examples, how you can use the aticonfig application.

Initial single-head X

To set up a configuration for a single headed X server, you can use the following command. Note, that only giving an input file will overwrite this file. If you want to save your original file, you should also use the -f option.

aticonfig --initial --input=/etc/X11/xorg.conf

Initial dual-head X

To set up a configuration for a dual-head X server, you can use the following command. The resulting dual-head will give you one monitor upon the other.
aticonfig --initial=dual-head --screen-layout=above --input=/etc/X11/xorg.conf

Desktop modes

The following command will set up the big desktop to horizontal and overlay on secondary display.
aticonfig --dtop=horizontal --overlay-on=1

Primary display modes

To set up the modes for the primary display, use:
aticonfig --resolution=1600x1200,1280x1024,1024x768

Monitor layout

Force CRT on primary display with TV-Out disabled.
aticonfig --force-monitor=crt1,notv

TV Geometry

Change the TV geometry to 85% width (where 100% == overscan) and 90% height. Shift 10 pixels right and 10 pixels down from the center of the screen.
aticonfig --tv-geometry=85x90+10-10

This command sets

BUGS

Report any issues with the aticonfig program to m[blue]http://support.ati.comm[].

We currently know these bugs:

• Trying to use --tv-geometry option only giving width and height results in a broken entry Option "TVVSizeAdj" "--tv-geometry=value" in aticonfig(1x). Also the leading sign of the given pixels offsets from center are not preserved, when creating the entries for Option "TVHPosAdj" and TVVPosAdj.

Using this option may also output the following error: "failed to set tv geometry. check help for possible causes." But --help doesn't tell anything useful here. Possible reasons for this issue are: needs to be written - maybe TV needs to be connected?

• The options --dw and --disable-workstation are still accepted, but it seems, they are obsolete and they always result in a Option "Capabilities" "0x00000000" entry in fglrx(4x). So just don't use it.

• Following the -h output, aticonfig should support reading from stdin and writing to stdout when using the --input or --output options. But it doesn't work as expected and you will receive error messages or a file named -.

• Following the -h output, the options described in the section called "Dynamic Display Management Options" will not affect the config file. This is of course wrong. The --enable-monitor=string,string has an affect to xorg.conf(5x).

AUTHORS

Daniel Leidert <[email protected]>

Author.

Flavio Stanchina <[email protected]>

Author and Debian package maintainer.

Matthijs Kooijman <[email protected]>

Debian Bug report #360822.

COPYRIGHT


Copyright © 2005-2007 Daniel Leidert
Copyright © 2005-2006 Flavio Stanchina

See the file /usr/share/doc/fglrx_man/COPYING for license and warranty information.