share/man/man4/radeonkms.4

   1 .\"
   2 .\" Copyright (c) 2015 The DragonFly Project.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\"
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in
  12 .\"    the documentation and/or other materials provided with the
  13 .\"    distribution.
  14 .\" 3. Neither the name of The DragonFly Project nor the names of its
  15 .\"    contributors may be used to endorse or promote products derived
  16 .\"    from this software without specific, prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  20 .\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  21 .\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
  22 .\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  23 .\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
  24 .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  25 .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  26 .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  27 .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  28 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  29 .\" SUCH DAMAGE.
  30 .\"
  31 .Dd June 10, 2015
  32 .Dt RADEONKMS 4
  33 .Os
  34 .Sh NAME
  35 .Nm radeonkms
  36 .Nd Driver for AMD/ATI Radeon graphics chipsets
  37 .Sh DESCRIPTION
  38 The
  39 .Nm
  40 driver provides support for the AMD Radeon graphics chips.
  41 Please refer the
  42 .Sx Loader Tunables
  43 section in
  44 .Xr syscons 4
  45 for more information about how to make the console work with
  46 .Nm .
  47 .Sh LOADER TUNABLES
  48 Tunables can be set at the
  49 .Xr loader 8
  50 prompt before booting the kernel or stored in
  51 .Xr loader.conf 5 .
  52 .Bl -tag -width "xxxxxx"
  53 .It Va drm.radeon.no_wb
  54 Disables AGP writeback for scratch registers.
  55 .It Va drm.radeon.dynclks
  56 Enable/Disable dynamic clocks
  57 .\".It Va drm.radeon.r4xx_atom
  58 .\"XXX
  59 .\".It Va drm.radeon.vram_limit
  60 .\"XXX
  61 .\".It Va drm.radeon.agpmode
  62 .\"XXX
  63 .\".It Va drm.radeon.gart_size
  64 .\"XXX
  65 .\".It Va drm.radeon.benchmarking
  66 .\"XXX
  67 .\".It Va drm.radeon.testing
  68 .\"XXX
  69 .\".It Va drm.radeon.connector_table
  70 .\"XXX
  71 .\".It Va drm.radeon.tv
  72 .\"XXX
  73 .\".It Va drm.radeon.audio
  74 .\"XXX
  75 .\".It Va drm.radeon.disp_priority
  76 .\"XXX
  77 .\".It Va drm.radeon.hw_i2c
  78 .\"XXX
  79 .\".It Va drm.radeon.pcie_gen2
  80 .\"XXX
  81 .It Va drm.radeon.msi
  82 Enable/Disable MSI (message signaled interrupts)
  83 1 = enable, 0 = disable, -1 = auto (default)
  84 .\".It Va drm.radeon.lockup_timeout
  85 .\"XXX
  86 .It Va drm.radeon.fastfb
  87 Direct FB access for IGP chips, which can significantly improve performance
  88 for some applications.
  89 This option only affects the RS690, RS780 and RS880 chipsets, and only
  90 when no sideport memory is available.
  91 1 = enable, 0 = disable (default)
  92 .It Va drm.radeon.dpm
  93 DPM (dynamic power management) support.
  94 1 = enable, 0 = disable, -1 = auto (default)
  95 .\".It Va drm.radeon.aspm
  96 .\"XXX
  97 .El
  98 .Sh SYSCTL VARIABLES
  99 If display backlight level can be controlled by the GPU (which is often
 100 the case in notebooks), the sysctl
 101 .Va hw.backlight_level
 102 can be used to adjust the backlight level.
 103 Permitted values are from 0 to the value returned from the
 104 .Va hw.backlight_max
 105 sysctl.
 106 .Sh SEE ALSO
 107 .Xr drm 4 ,
 108 .Xr syscons 4
 109 .Sh HISTORY
 110 The
 111 .Nm
 112 driver was first available for Linux.
 113 .Sh BUGS
 114 Enabling
 115 .Va drm.radeon.fastfb
 116 on RS690 chipsets can cause graphics corruption when hardware acceleration
 117 is used.
 118 Display backlight control with the
 119 .Va hw.backlight_level
 120 sysctl is only supported for chipsets using AtomBIOS (which includes some
 121 R400 chipsets and all later generations).