Manpages

NAME

aticonfig − 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

Generate a default ATI device section in the configuration file which is capable of loading the fglrx driver.

−−initial=dual−head

Same as −−initial. But this special option generates a basic dual head configuration.

TV Options
−−tvf
string, −−tv−format−type=string

Change the TV signal format. string can be one of: NTSC−M, NTSC−JPN, PAL−B, PAL−D, PAL−G, PAL−H, PAL−I, PAL−K, PAL−K1, PAL−L, PAL−M, PAL−N, PAL−CN, PAL−SCART.

Note: Affects Option "TVFormat". See fglrx(4x).

−−tvs string, −−tv−standard−type=string

Change the TV standard for TV output. string can be one of: VIDEO, SCART, YUV.

Note: Affects Option "TVStandard". See fglrx(4x).

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.

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

−−dw string, −−disable−workstation=string

Disable a FireGL workstation board feature. string can be one of: all, timmo, timmo−extreme.

Note: Affects Option "Capabilities". See 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.

Note: Affects Option "FSAAEnable". See 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.

Note: Affects Option "FSAAScale". See fglrx(4x).

−−fsg boolean, −−fsaa−gamma=boolean

Enable or disable FSAA gamma. boolean can be one of: on, off.

Note: Affects Option "FSAADisableGamma". See 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.

Note: Affects Option "FSAAMSPosX0..5", Option "FSAAMSPosY0..5" and Option "FSAACustomizeMSPos". See 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
−−lsp
, −−list−powerstates

Print information about power states and exit.

−−set−powerstate=state

Set a power state listed by −−lsp or −−list−powerstates.

Advanced Options
−−tls=
boolean

Enable or disable fast thread local storage. Disable this option when virtual machines or Wine(X) fail to work properly. string can be one of: on, off.

Note: Affects Option "UseFastTLS". See fglrx(4x).

−−sb boolean, −−signal−block=boolean

Enable or disable signal blocking. Disable this option when debugging a multi−threaded OpenGL application. string can be one of: on, off.

Note: Affects Option "BlockSignalsOnLock". See fglrx(4x).

−−iagp boolean, −−internal−agp=boolean

Enable or disable internal AGP gart. Enable this option to use the ATI AGP GART module. Disable it to use the module included with the Linux kernel. Changing this option may help resolve display−related issues. string can be one of: on, off.

Note: Affects Option "UseInternalAGPGART". See fglrx(4x).

−−agpl boolean, −−agp−locked−userpages=boolean

Enable or disable AGP locked user pages. Disable this option if the system hangs when running fgl_glxgears(1x). string can be one of: on, off.

Note: Affects Option "KernelModuleParm". See fglrx(4x).

−−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 AMD cpu that is being reported as Intel. string can be one of: on, off.

Note: Affects Option "ForceGenericCPU". See fglrx(4x).

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 −−overlay−on 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.

−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.

−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 −−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|−−force 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

BUGS

Report any issues with the aticonfig program to http://support.ati.com.

We currently know these bugs:

Trying to use the option −−tv−format−type with one of the mentioned strings results in an error message ’Error: Option value: ’foo’ for option ’TVStandard’ is invalid.’ This option tries to manipulate the TV standard and not the format. Use −−tvf instead.

Trying to use −−dw timmo−extreme returns the following error message: ’aticonfig: parsing the command−line failed’.

Following the −−help output, aticonfig should support reading from stdin and writing to stdout when using the −−input or −−output options. But it doesnn’t work as expected and you will receive error messages or a file named .

SEE ALSO

xorgconfig(1x), fglrx(4x), xorg.conf(5x)

AUTHORS

Daniel Leidert <daniel.leidert [AT] wgdd.de>

Author.

Flavio Stanchina <flavio [AT] stanchina.net>

Author and Debian package maintainer.

Matthijs Kooijman <m.kooijman [AT] student.nl>

Debian Bug report #360822.