aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLukas Wunner <lukas@wunner.de>2016-07-11 04:22:33 -0400
committerDaniel Vetter <daniel.vetter@ffwll.ch>2016-07-12 10:14:36 -0400
commitfb001dfd7e773d86b5dcd2050995a5fee301eab1 (patch)
tree8730c815bb497802bcc90a08e7e348cbf7b5c0e7
parent396f5d62d1a5fd99421855a08ffdef8edb43c76e (diff)
vga_switcheroo: Sphinxify docs
Fix up formatting glitches remaining after the automatic rst conversion. Cc: Jonathan Corbet <corbet@lwn.net> Cc: Jani Nikula <jani.nikula@intel.com> Signed-off-by: Lukas Wunner <lukas@wunner.de> Signed-off-by: Daniel Vetter <daniel.vetter@ffwll.ch> Link: http://patchwork.freedesktop.org/patch/msgid/3a369602ae35fdbf5e4a12f7e172088c89fa27bb.1468225027.git.lukas@wunner.de
-rw-r--r--Documentation/gpu/drm-internals.rst4
-rw-r--r--Documentation/gpu/vga-switcheroo.rst8
-rw-r--r--drivers/gpu/vga/vga_switcheroo.c28
3 files changed, 18 insertions, 22 deletions
diff --git a/Documentation/gpu/drm-internals.rst b/Documentation/gpu/drm-internals.rst
index 4f7176576feb..490d655cda20 100644
--- a/Documentation/gpu/drm-internals.rst
+++ b/Documentation/gpu/drm-internals.rst
@@ -280,8 +280,8 @@ private data in the open method should free it here.
280The lastclose method should restore CRTC and plane properties to default 280The lastclose method should restore CRTC and plane properties to default
281value, so that a subsequent open of the device will not inherit state 281value, so that a subsequent open of the device will not inherit state
282from the previous user. It can also be used to execute delayed power 282from the previous user. It can also be used to execute delayed power
283switching state changes, e.g. in conjunction with the vga_switcheroo 283switching state changes, e.g. in conjunction with the :ref:`vga_switcheroo`
284infrastructure (see ?). Beyond that KMS drivers should not do any 284infrastructure. Beyond that KMS drivers should not do any
285further cleanup. Only legacy UMS drivers might need to clean up device 285further cleanup. Only legacy UMS drivers might need to clean up device
286state so that the vga console or an independent fbdev driver could take 286state so that the vga console or an independent fbdev driver could take
287over. 287over.
diff --git a/Documentation/gpu/vga-switcheroo.rst b/Documentation/gpu/vga-switcheroo.rst
index 327d930a2229..cbbdb994f1dd 100644
--- a/Documentation/gpu/vga-switcheroo.rst
+++ b/Documentation/gpu/vga-switcheroo.rst
@@ -1,3 +1,5 @@
1.. _vga_switcheroo:
2
1============== 3==============
2VGA Switcheroo 4VGA Switcheroo
3============== 5==============
@@ -94,9 +96,3 @@ Public functions
94 96
95.. kernel-doc:: include/linux/apple-gmux.h 97.. kernel-doc:: include/linux/apple-gmux.h
96 :internal: 98 :internal:
97
98.. WARNING: DOCPROC directive not supported: !Cdrivers/gpu/vga/vga_switcheroo.c
99
100.. WARNING: DOCPROC directive not supported: !Cinclude/linux/vga_switcheroo.h
101
102.. WARNING: DOCPROC directive not supported: !Cdrivers/platform/x86/apple-gmux.c
diff --git a/drivers/gpu/vga/vga_switcheroo.c b/drivers/gpu/vga/vga_switcheroo.c
index 2df216b39cc5..5f962bfcb43c 100644
--- a/drivers/gpu/vga/vga_switcheroo.c
+++ b/drivers/gpu/vga/vga_switcheroo.c
@@ -52,9 +52,9 @@
52 * 52 *
53 * * muxed: Dual GPUs with a multiplexer chip to switch outputs between GPUs. 53 * * muxed: Dual GPUs with a multiplexer chip to switch outputs between GPUs.
54 * * muxless: Dual GPUs but only one of them is connected to outputs. 54 * * muxless: Dual GPUs but only one of them is connected to outputs.
55 * The other one is merely used to offload rendering, its results 55 * The other one is merely used to offload rendering, its results
56 * are copied over PCIe into the framebuffer. On Linux this is 56 * are copied over PCIe into the framebuffer. On Linux this is
57 * supported with DRI PRIME. 57 * supported with DRI PRIME.
58 * 58 *
59 * Hybrid graphics started to appear in the late Naughties and were initially 59 * Hybrid graphics started to appear in the late Naughties and were initially
60 * all muxed. Newer laptops moved to a muxless architecture for cost reasons. 60 * all muxed. Newer laptops moved to a muxless architecture for cost reasons.
@@ -560,21 +560,21 @@ EXPORT_SYMBOL(vga_switcheroo_unlock_ddc);
560 * * OFF: Power off the device not in use. 560 * * OFF: Power off the device not in use.
561 * * ON: Power on the device not in use. 561 * * ON: Power on the device not in use.
562 * * IGD: Switch to the integrated graphics device. 562 * * IGD: Switch to the integrated graphics device.
563 * Power on the integrated GPU if necessary, power off the discrete GPU. 563 * Power on the integrated GPU if necessary, power off the discrete GPU.
564 * Prerequisite is that no user space processes (e.g. Xorg, alsactl) 564 * Prerequisite is that no user space processes (e.g. Xorg, alsactl)
565 * have opened device files of the GPUs or the audio client. If the 565 * have opened device files of the GPUs or the audio client. If the
566 * switch fails, the user may invoke lsof(8) or fuser(1) on /dev/dri/ 566 * switch fails, the user may invoke lsof(8) or fuser(1) on /dev/dri/
567 * and /dev/snd/controlC1 to identify processes blocking the switch. 567 * and /dev/snd/controlC1 to identify processes blocking the switch.
568 * * DIS: Switch to the discrete graphics device. 568 * * DIS: Switch to the discrete graphics device.
569 * * DIGD: Delayed switch to the integrated graphics device. 569 * * DIGD: Delayed switch to the integrated graphics device.
570 * This will perform the switch once the last user space process has 570 * This will perform the switch once the last user space process has
571 * closed the device files of the GPUs and the audio client. 571 * closed the device files of the GPUs and the audio client.
572 * * DDIS: Delayed switch to the discrete graphics device. 572 * * DDIS: Delayed switch to the discrete graphics device.
573 * * MIGD: Mux-only switch to the integrated graphics device. 573 * * MIGD: Mux-only switch to the integrated graphics device.
574 * Does not remap console or change the power state of either gpu. 574 * Does not remap console or change the power state of either gpu.
575 * If the integrated GPU is currently off, the screen will turn black. 575 * If the integrated GPU is currently off, the screen will turn black.
576 * If it is on, the screen will show whatever happens to be in VRAM. 576 * If it is on, the screen will show whatever happens to be in VRAM.
577 * Either way, the user has to blindly enter the command to switch back. 577 * Either way, the user has to blindly enter the command to switch back.
578 * * MDIS: Mux-only switch to the discrete graphics device. 578 * * MDIS: Mux-only switch to the discrete graphics device.
579 * 579 *
580 * For GPUs whose power state is controlled by the driver's runtime pm, 580 * For GPUs whose power state is controlled by the driver's runtime pm,