diff options
| author | Lukas Wunner <lukas@wunner.de> | 2016-07-11 04:22:33 -0400 |
|---|---|---|
| committer | Daniel Vetter <daniel.vetter@ffwll.ch> | 2016-07-12 10:14:36 -0400 |
| commit | fb001dfd7e773d86b5dcd2050995a5fee301eab1 (patch) | |
| tree | 8730c815bb497802bcc90a08e7e348cbf7b5c0e7 | |
| parent | 396f5d62d1a5fd99421855a08ffdef8edb43c76e (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.rst | 4 | ||||
| -rw-r--r-- | Documentation/gpu/vga-switcheroo.rst | 8 | ||||
| -rw-r--r-- | drivers/gpu/vga/vga_switcheroo.c | 28 |
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. | |||
| 280 | The lastclose method should restore CRTC and plane properties to default | 280 | The lastclose method should restore CRTC and plane properties to default |
| 281 | value, so that a subsequent open of the device will not inherit state | 281 | value, so that a subsequent open of the device will not inherit state |
| 282 | from the previous user. It can also be used to execute delayed power | 282 | from the previous user. It can also be used to execute delayed power |
| 283 | switching state changes, e.g. in conjunction with the vga_switcheroo | 283 | switching state changes, e.g. in conjunction with the :ref:`vga_switcheroo` |
| 284 | infrastructure (see ?). Beyond that KMS drivers should not do any | 284 | infrastructure. Beyond that KMS drivers should not do any |
| 285 | further cleanup. Only legacy UMS drivers might need to clean up device | 285 | further cleanup. Only legacy UMS drivers might need to clean up device |
| 286 | state so that the vga console or an independent fbdev driver could take | 286 | state so that the vga console or an independent fbdev driver could take |
| 287 | over. | 287 | over. |
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 | ============== |
| 2 | VGA Switcheroo | 4 | VGA 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, |
