sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget&/translations/zh_CN/gpu/vga-switcheroomodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/zh_TW/gpu/vga-switcheroomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/it_IT/gpu/vga-switcheroomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/ja_JP/gpu/vga-switcheroomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/ko_KR/gpu/vga-switcheroomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/pt_BR/gpu/vga-switcheroomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget&/translations/sp_SP/gpu/vga-switcheroomodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhtarget)}(h.. _vga_switcheroo:h]h}(h]h ]h"]h$]h&]refidvga-switcheroouh1hhKhhhhh@/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo.rstubhsection)}(hhh](htitle)}(hVGA Switcherooh]hVGA Switcheroo}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(h\vga_switcheroo is the Linux subsystem for laptop hybrid graphics. These come in two flavors:h]h\vga_switcheroo is the Linux subsystem for laptop hybrid graphics. These come in two flavors:}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhb/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:7: ./drivers/gpu/vga/vga_switcheroo.chK/hhhhubh bullet_list)}(hhh](h list_item)}(hHmuxed: Dual GPUs with a multiplexer chip to switch outputs between GPUs.h]h)}(hhh]hHmuxed: Dual GPUs with a multiplexer chip to switch outputs between GPUs.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhb/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:7: ./drivers/gpu/vga/vga_switcheroo.chK2hhubah}(h]h ]h"]h$]h&]uh1hhhubh)}(hmuxless: Dual GPUs but only one of them is connected to outputs. The other one is merely used to offload rendering, its results are copied over PCIe into the framebuffer. On Linux this is supported with DRI PRIME. h]h)}(hmuxless: Dual GPUs but only one of them is connected to outputs. The other one is merely used to offload rendering, its results are copied over PCIe into the framebuffer. On Linux this is supported with DRI PRIME.h]hmuxless: Dual GPUs but only one of them is connected to outputs. The other one is merely used to offload rendering, its results are copied over PCIe into the framebuffer. On Linux this is supported with DRI PRIME.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhb/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:7: ./drivers/gpu/vga/vga_switcheroo.chK3hj ubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]bullet*uh1hhjhK2hhhhubh)}(hXHybrid graphics started to appear in the late Naughties and were initially all muxed. Newer laptops moved to a muxless architecture for cost reasons. A notable exception is the MacBook Pro which continues to use a mux. Muxes come with varying capabilities: Some switch only the panel, others can also switch external displays. Some switch all display pins at once while others can switch just the DDC lines. (To allow EDID probing for the inactive GPU.) Also, muxes are often used to cut power to the discrete GPU while it is not used.h]hXHybrid graphics started to appear in the late Naughties and were initially all muxed. Newer laptops moved to a muxless architecture for cost reasons. A notable exception is the MacBook Pro which continues to use a mux. Muxes come with varying capabilities: Some switch only the panel, others can also switch external displays. Some switch all display pins at once while others can switch just the DDC lines. (To allow EDID probing for the inactive GPU.) Also, muxes are often used to cut power to the discrete GPU while it is not used.}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhb/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:7: ./drivers/gpu/vga/vga_switcheroo.chK8hhhhubh)}(hXDRM drivers register GPUs with vga_switcheroo, these are henceforth called clients. The mux is called the handler. Muxless machines also register a handler to control the power state of the discrete GPU, its ->switchto callback is a no-op for obvious reasons. The discrete GPU is often equipped with an HDA controller for the HDMI/DP audio signal, this will also register as a client so that vga_switcheroo can take care of the correct suspend/resume order when changing the discrete GPU's power state. In total there can thus be up to three clients: Two vga clients (GPUs) and one audio client (on the discrete GPU). The code is mostly prepared to support machines with more than two GPUs should they become available.h]hXDRM drivers register GPUs with vga_switcheroo, these are henceforth called clients. The mux is called the handler. Muxless machines also register a handler to control the power state of the discrete GPU, its ->switchto callback is a no-op for obvious reasons. The discrete GPU is often equipped with an HDA controller for the HDMI/DP audio signal, this will also register as a client so that vga_switcheroo can take care of the correct suspend/resume order when changing the discrete GPU’s power state. In total there can thus be up to three clients: Two vga clients (GPUs) and one audio client (on the discrete GPU). The code is mostly prepared to support machines with more than two GPUs should they become available.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhb/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:7: ./drivers/gpu/vga/vga_switcheroo.chKAhhhhubh)}(hXcThe GPU to which the outputs are currently switched is called the active client in vga_switcheroo parlance. The GPU not in use is the inactive client. When the inactive client's DRM driver is loaded, it will be unable to probe the panel's EDID and hence depends on VBIOS to provide its display modes. If the VBIOS modes are bogus or if there is no VBIOS at all (which is common on the MacBook Pro), a client may alternatively request that the DDC lines are temporarily switched to it, provided that the handler supports this. Switching only the DDC lines and not the entire output avoids unnecessary flickering.h]hXgThe GPU to which the outputs are currently switched is called the active client in vga_switcheroo parlance. The GPU not in use is the inactive client. When the inactive client’s DRM driver is loaded, it will be unable to probe the panel’s EDID and hence depends on VBIOS to provide its display modes. If the VBIOS modes are bogus or if there is no VBIOS at all (which is common on the MacBook Pro), a client may alternatively request that the DDC lines are temporarily switched to it, provided that the handler supports this. Switching only the DDC lines and not the entire output avoids unnecessary flickering.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhb/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:7: ./drivers/gpu/vga/vga_switcheroo.chKLhhhhubh)}(hhh](h)}(h Modes of Useh]h Modes of Use}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjWhhhhhK ubh)}(hhh](h)}(h)Manual switching and manual power controlh]h)Manual switching and manual power control}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhhKubh)}(hX<In this mode of use, the file /sys/kernel/debug/vgaswitcheroo/switch can be read to retrieve the current vga_switcheroo state and commands can be written to it to change the state. The file appears as soon as two GPU drivers and one handler have registered with vga_switcheroo. The following commands are understood:h]hX<In this mode of use, the file /sys/kernel/debug/vgaswitcheroo/switch can be read to retrieve the current vga_switcheroo state and commands can be written to it to change the state. The file appears as soon as two GPU drivers and one handler have registered with vga_switcheroo. The following commands are understood:}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:16: ./drivers/gpu/vga/vga_switcheroo.chMahjhhhubh)}(hhh](h)}(h%OFF: Power off the device not in use.h]h)}(hjh]h%OFF: Power off the device not in use.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:16: ./drivers/gpu/vga/vga_switcheroo.chMghjubah}(h]h ]h"]h$]h&]uh1hhjubh)}(h#ON: Power on the device not in use.h]h)}(hjh]h#ON: Power on the device not in use.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:16: ./drivers/gpu/vga/vga_switcheroo.chMhhjubah}(h]h ]h"]h$]h&]uh1hhjubh)}(hX|IGD: Switch to the integrated graphics device. Power on the integrated GPU if necessary, power off the discrete GPU. Prerequisite is that no user space processes (e.g. Xorg, alsactl) have opened device files of the GPUs or the audio client. If the switch fails, the user may invoke lsof(8) or fuser(1) on /dev/dri/ and /dev/snd/controlC1 to identify processes blocking the switch.h]h)}(hX|IGD: Switch to the integrated graphics device. Power on the integrated GPU if necessary, power off the discrete GPU. Prerequisite is that no user space processes (e.g. Xorg, alsactl) have opened device files of the GPUs or the audio client. If the switch fails, the user may invoke lsof(8) or fuser(1) on /dev/dri/ and /dev/snd/controlC1 to identify processes blocking the switch.h]hX|IGD: Switch to the integrated graphics device. Power on the integrated GPU if necessary, power off the discrete GPU. Prerequisite is that no user space processes (e.g. Xorg, alsactl) have opened device files of the GPUs or the audio client. If the switch fails, the user may invoke lsof(8) or fuser(1) on /dev/dri/ and /dev/snd/controlC1 to identify processes blocking the switch.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:16: ./drivers/gpu/vga/vga_switcheroo.chMihjubah}(h]h ]h"]h$]h&]uh1hhjubh)}(h,DIS: Switch to the discrete graphics device.h]h)}(hjh]h,DIS: Switch to the discrete graphics device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:16: ./drivers/gpu/vga/vga_switcheroo.chMohjubah}(h]h ]h"]h$]h&]uh1hhjubh)}(hDIGD: Delayed switch to the integrated graphics device. This will perform the switch once the last user space process has closed the device files of the GPUs and the audio client.h]h)}(hDIGD: Delayed switch to the integrated graphics device. This will perform the switch once the last user space process has closed the device files of the GPUs and the audio client.h]hDIGD: Delayed switch to the integrated graphics device. This will perform the switch once the last user space process has closed the device files of the GPUs and the audio client.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:16: ./drivers/gpu/vga/vga_switcheroo.chMphjubah}(h]h ]h"]h$]h&]uh1hhjubh)}(h5DDIS: Delayed switch to the discrete graphics device.h]h)}(hjh]h5DDIS: Delayed switch to the discrete graphics device.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:16: ./drivers/gpu/vga/vga_switcheroo.chMshjubah}(h]h ]h"]h$]h&]uh1hhjubh)}(hXDMIGD: Mux-only switch to the integrated graphics device. Does not remap console or change the power state of either gpu. If the integrated GPU is currently off, the screen will turn black. If it is on, the screen will show whatever happens to be in VRAM. Either way, the user has to blindly enter the command to switch back.h]h)}(hXDMIGD: Mux-only switch to the integrated graphics device. Does not remap console or change the power state of either gpu. If the integrated GPU is currently off, the screen will turn black. If it is on, the screen will show whatever happens to be in VRAM. Either way, the user has to blindly enter the command to switch back.h]hXDMIGD: Mux-only switch to the integrated graphics device. Does not remap console or change the power state of either gpu. If the integrated GPU is currently off, the screen will turn black. If it is on, the screen will show whatever happens to be in VRAM. Either way, the user has to blindly enter the command to switch back.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:16: ./drivers/gpu/vga/vga_switcheroo.chMthjubah}(h]h ]h"]h$]h&]uh1hhjubh)}(h7MDIS: Mux-only switch to the discrete graphics device. h]h)}(h6MDIS: Mux-only switch to the discrete graphics device.h]h6MDIS: Mux-only switch to the discrete graphics device.}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:16: ./drivers/gpu/vga/vga_switcheroo.chMyhj6ubah}(h]h ]h"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]j(j)uh1hhjhMghjhhhubh)}(h|For GPUs whose power state is controlled by the driver's runtime pm, the ON and OFF commands are a no-op (see next section).h]h~For GPUs whose power state is controlled by the driver’s runtime pm, the ON and OFF commands are a no-op (see next section).}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:16: ./drivers/gpu/vga/vga_switcheroo.chM{hjhhhubh)}(hWFor muxless machines, the IGD/DIS, DIGD/DDIS and MIGD/MDIS commands should not be used.h]hWFor muxless machines, the IGD/DIS, DIGD/DDIS and MIGD/MDIS commands should not be used.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:16: ./drivers/gpu/vga/vga_switcheroo.chM~hjhhhubeh}(h])manual-switching-and-manual-power-controlah ]h"])manual switching and manual power controlah$]h&]uh1hhjWhhhhhKubh)}(hhh](h)}(hDriver power controlh]hDriver power control}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{hhhhhKubh)}(hXIn this mode of use, the discrete GPU automatically powers up and down at the discretion of the driver's runtime pm. On muxed machines, the user may still influence the muxer state by way of the debugfs interface, however the ON and OFF commands become a no-op for the discrete GPU.h]hXIn this mode of use, the discrete GPU automatically powers up and down at the discretion of the driver’s runtime pm. On muxed machines, the user may still influence the muxer state by way of the debugfs interface, however the ON and OFF commands become a no-op for the discrete GPU.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:22: ./drivers/gpu/vga/vga_switcheroo.chMhj{hhubh)}(hThis mode is the default on Nvidia HybridPower/Optimus and ATI PowerXpress. Specifying nouveau.runpm=0, radeon.runpm=0 or amdgpu.runpm=0 on the kernel command line disables it.h]hThis mode is the default on Nvidia HybridPower/Optimus and ATI PowerXpress. Specifying nouveau.runpm=0, radeon.runpm=0 or amdgpu.runpm=0 on the kernel command line disables it.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:22: ./drivers/gpu/vga/vga_switcheroo.chMhj{hhubh)}(hX+After the GPU has been suspended, the handler needs to be called to cut power to the GPU. Likewise it needs to reinstate power before the GPU can resume. This is achieved by vga_switcheroo_init_domain_pm_ops(), which augments the GPU's suspend/resume functions by the requisite calls to the handler.h]hX-After the GPU has been suspended, the handler needs to be called to cut power to the GPU. Likewise it needs to reinstate power before the GPU can resume. This is achieved by vga_switcheroo_init_domain_pm_ops(), which augments the GPU’s suspend/resume functions by the requisite calls to the handler.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:22: ./drivers/gpu/vga/vga_switcheroo.chMhj{hhubh)}(hWhen the audio device resumes, the GPU needs to be woken. This is achieved by a PCI quirk which calls device_link_add() to declare a dependency on the GPU. That way, the GPU is kept awake whenever and as long as the audio device is in use.h]hWhen the audio device resumes, the GPU needs to be woken. This is achieved by a PCI quirk which calls device_link_add() to declare a dependency on the GPU. That way, the GPU is kept awake whenever and as long as the audio device is in use.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:22: ./drivers/gpu/vga/vga_switcheroo.chMhj{hhubh)}(hXOn muxed machines, if the mux is initially switched to the discrete GPU, the user ends up with a black screen when the GPU powers down after boot. As a workaround, the mux is forced to the integrated GPU on runtime suspend, cf. https://bugs.freedesktop.org/show_bug.cgi?id=75917h](hOn muxed machines, if the mux is initially switched to the discrete GPU, the user ends up with a black screen when the GPU powers down after boot. As a workaround, the mux is forced to the integrated GPU on runtime suspend, cf. }(hjhhhNhNubh reference)}(h2https://bugs.freedesktop.org/show_bug.cgi?id=75917h]h2https://bugs.freedesktop.org/show_bug.cgi?id=75917}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1jhjubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:22: ./drivers/gpu/vga/vga_switcheroo.chMhj{hhubeh}(h]driver-power-controlah ]h"]driver power controlah$]h&]uh1hhjWhhhhhKubeh}(h] modes-of-useah ]h"] modes of useah$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(hAPIh]hAPI}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(hPublic functionsh]hPublic functions}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhKubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](single,vga_switcheroo_register_handler (C function)!c.vga_switcheroo_register_handlerhNtauh1jhj hhhNhNubhdesc)}(hhh](hdesc_signature)}(hint vga_switcheroo_register_handler (const struct vga_switcheroo_handler *handler, enum vga_switcheroo_handler_flags_t handler_flags)h]hdesc_signature_line)}(hint vga_switcheroo_register_handler(const struct vga_switcheroo_handler *handler, enum vga_switcheroo_handler_flags_t handler_flags)h](hdesc_sig_keyword_type)}(hinth]hint}(hj>hhhNhNubah}(h]h ]ktah"]h$]h&]uh1j<hj8hhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKubhdesc_sig_space)}(h h]h }(hjPhhhNhNubah}(h]h ]wah"]h$]h&]uh1jNhj8hhhjMhKubh desc_name)}(hvga_switcheroo_register_handlerh]h desc_sig_name)}(hvga_switcheroo_register_handlerh]hvga_switcheroo_register_handler}(hjghhhNhNubah}(h]h ]nah"]h$]h&]uh1jehjaubah}(h]h ](sig-namedescnameeh"]h$]h&] xml:spacepreserveuh1j_hj8hhhjMhKubhdesc_parameterlist)}(ha(const struct vga_switcheroo_handler *handler, enum vga_switcheroo_handler_flags_t handler_flags)h](hdesc_parameter)}(h,const struct vga_switcheroo_handler *handlerh](hdesc_sig_keyword)}(hconsth]hconst}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubj)}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubh)}(hhh]jf)}(hvga_switcheroo_handlerh]hvga_switcheroo_handler}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubah}(h]h ]h"]h$]h&] refdomaincreftype identifier reftargetjmodnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)}jjisb!c.vga_switcheroo_register_handlerasbuh1hhjubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubhdesc_sig_punctuation)}(hj)h]h*}(hjhhhNhNubah}(h]h ]pah"]h$]h&]uh1jhjubjf)}(hhandlerh]hhandler}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]noemphj~juh1jhjubj)}(h1enum vga_switcheroo_handler_flags_t handler_flagsh](j)}(henumh]henum}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj&ubjO)}(h h]h }(hj8hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj&ubh)}(hhh]jf)}(hvga_switcheroo_handler_flags_th]hvga_switcheroo_handler_flags_t}(hjIhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjFubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjKmodnameN classnameNjj)}j]j!c.vga_switcheroo_register_handlerasbuh1hhj&ubjO)}(h h]h }(hjghhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj&ubjf)}(h handler_flagsh]h handler_flags}(hjuhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj&ubeh}(h]h ]h"]h$]h&]noemphj~juh1jhjubeh}(h]h ]h"]h$]h&]j~juh1jhj8hhhjMhKubeh}(h]h ]h"]h$]h&]j~j add_permalinkuh1j6sphinx_line_type declaratorhj2hhhjMhKubah}(h]j)ah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1j0hjMhKhj-hhubh desc_content)}(hhh]h)}(hregister handlerh]hregister handler}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhjhhubah}(h]h ]h"]h$]h&]uh1jhj-hhhjMhKubeh}(h]h ](jfunctioneh"]h$]h&]domainjobjtypejdesctypejnoindex noindexentrynocontentsentryuh1j+hhhj hNhNubh container)}(hXI**Parameters** ``const struct vga_switcheroo_handler *handler`` handler callbacks ``enum vga_switcheroo_handler_flags_t handler_flags`` handler flags **Description** Register handler. Enable vga_switcheroo if two vga clients have already registered. **Return** 0 on success, -EINVAL if a handler was already registered.h](h)}(h**Parameters**h]hstrong)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhjubhdefinition_list)}(hhh](hdefinition_list_item)}(hC``const struct vga_switcheroo_handler *handler`` handler callbacks h](hterm)}(h0``const struct vga_switcheroo_handler *handler``h]hliteral)}(hjh]h,const struct vga_switcheroo_handler *handler}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhjubh definition)}(hhh]h)}(hhandler callbacksh]hhandler callbacks}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hD``enum vga_switcheroo_handler_flags_t handler_flags`` handler flags h](j)}(h5``enum vga_switcheroo_handler_flags_t handler_flags``h]j)}(hj7h]h1enum vga_switcheroo_handler_flags_t handler_flags}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhj1ubj)}(hhh]h)}(h handler flagsh]h handler flags}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhKhjMubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhjLhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjrh]h Description}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhjubh)}(hSRegister handler. Enable vga_switcheroo if two vga clients have already registered.h]hSRegister handler. Enable vga_switcheroo if two vga clients have already registered.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhjubh)}(h:0 on success, -EINVAL if a handler was already registered.h]h:0 on success, -EINVAL if a handler was already registered.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'.vga_switcheroo_unregister_handler (C function)#c.vga_switcheroo_unregister_handlerhNtauh1jhj hhhNhNubj,)}(hhh](j1)}(h-void vga_switcheroo_unregister_handler (void)h]j7)}(h,void vga_switcheroo_unregister_handler(void)h](j=)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hjhhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhjhKubj`)}(h!vga_switcheroo_unregister_handlerh]jf)}(h!vga_switcheroo_unregister_handlerh]h!vga_switcheroo_unregister_handler}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hjhhhjhKubj)}(h(void)h]j)}(hvoidh]j=)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hjubah}(h]h ]h"]h$]h&]noemphj~juh1jhjubah}(h]h ]h"]h$]h&]j~juh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhjhhhjhKubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1j0hjhKhjhhubj)}(hhh]h)}(hunregister handlerh]hunregister handler}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhjBhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKubeh}(h]h ](jfunctioneh"]h$]h&]jjjj]jj]jjjuh1j+hhhj hNhNubj)}(he**Parameters** ``void`` no arguments **Description** Unregister handler. Disable vga_switcheroo.h](h)}(h**Parameters**h]j)}(hjgh]h Parameters}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jhjeubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjaubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]j)}(hjh]hvoid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhjubj)}(hhh]h)}(h no argumentsh]h no arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj}ubah}(h]h ]h"]h$]h&]uh1jhjaubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhjaubh)}(h+Unregister handler. Disable vga_switcheroo.h]h+Unregister handler. Disable vga_switcheroo.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjaubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j')vga_switcheroo_handler_flags (C function)c.vga_switcheroo_handler_flagshNtauh1jhj hhhNhNubj,)}(hhh](j1)}(hGenum vga_switcheroo_handler_flags_t vga_switcheroo_handler_flags (void)h]j7)}(hFenum vga_switcheroo_handler_flags_t vga_switcheroo_handler_flags(void)h](j)}(hj,h]henum}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhjhMubh)}(hhh]jf)}(hvga_switcheroo_handler_flags_th]hvga_switcheroo_handler_flags_t}(hj%hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj"ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj'modnameN classnameNjj)}j]j)}jvga_switcheroo_handler_flagssbc.vga_switcheroo_handler_flagsasbuh1hhjhhhjhMubjO)}(h h]h }(hjFhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhjhMubj`)}(hvga_switcheroo_handler_flagsh]jf)}(hjCh]hvga_switcheroo_handler_flags}(hjXhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjTubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hjhhhjhMubj)}(h(void)h]j)}(hvoidh]j=)}(hvoidh]hvoid}(hjshhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hjoubah}(h]h ]h"]h$]h&]noemphj~juh1jhjkubah}(h]h ]h"]h$]h&]j~juh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhjhhhjhMubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1j0hjhMhjhhubj)}(hhh]h)}(hobtain handler flagsh]hobtain handler flags}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1j+hhhj hNhNubj)}(h**Parameters** ``void`` no arguments **Description** Helper for clients to obtain the handler flags bitmask. **Return** Handler flags. A value of 0 means that no handler is registered or that the handler has no special capabilities.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]j)}(hjh]hvoid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhjubj)}(hhh]h)}(h no argumentsh]h no arguments}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhjubh)}(h7Helper for clients to obtain the handler flags bitmask.h]h7Helper for clients to obtain the handler flags bitmask.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjubh)}(h **Return**h]j)}(hj@h]hReturn}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj>ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjubh)}(hpHandler flags. A value of 0 means that no handler is registered or that the handler has no special capabilities.h]hpHandler flags. A value of 0 means that no handler is registered or that the handler has no special capabilities.}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'+vga_switcheroo_register_client (C function) c.vga_switcheroo_register_clienthNtauh1jhj hhhNhNubj,)}(hhh](j1)}(hint vga_switcheroo_register_client (struct pci_dev *pdev, const struct vga_switcheroo_client_ops *ops, bool driver_power_control)h]j7)}(hint vga_switcheroo_register_client(struct pci_dev *pdev, const struct vga_switcheroo_client_ops *ops, bool driver_power_control)h](j=)}(hinth]hint}(hjhhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hjhhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMDubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhjhMDubj`)}(hvga_switcheroo_register_clienth]jf)}(hvga_switcheroo_register_clienth]hvga_switcheroo_register_client}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hjhhhjhMDubj)}(h^(struct pci_dev *pdev, const struct vga_switcheroo_client_ops *ops, bool driver_power_control)h](j)}(hstruct pci_dev *pdevh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubh)}(hhh]jf)}(hpci_devh]hpci_dev}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsb c.vga_switcheroo_register_clientasbuh1hhjubjO)}(h h]h }(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubj)}(hj)h]h*}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjf)}(hpdevh]hpdev}(hj hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]noemphj~juh1jhjubj)}(h+const struct vga_switcheroo_client_ops *opsh](j)}(hjh]hconst}(hj4 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0 ubjO)}(h h]h }(hjA hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj0 ubj)}(hjh]hstruct}(hjO hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0 ubjO)}(h h]h }(hj\ hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj0 ubh)}(hhh]jf)}(hvga_switcheroo_client_opsh]hvga_switcheroo_client_ops}(hjm hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjo modnameN classnameNjj)}j]j c.vga_switcheroo_register_clientasbuh1hhj0 ubjO)}(h h]h }(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj0 ubj)}(hj)h]h*}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj0 ubjf)}(hopsh]hops}(hj hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj0 ubeh}(h]h ]h"]h$]h&]noemphj~juh1jhjubj)}(hbool driver_power_controlh](j=)}(hboolh]hbool}(hj hhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hj ubjO)}(h h]h }(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubjf)}(hdriver_power_controlh]hdriver_power_control}(hj hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj ubeh}(h]h ]h"]h$]h&]noemphj~juh1jhjubeh}(h]h ]h"]h$]h&]j~juh1jhjhhhjhMDubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhj}hhhjhMDubah}(h]jxah ](jjeh"]h$]h&]jj)jhuh1j0hjhMDhjzhhubj)}(hhh]h)}(hregister vga clienth]hregister vga client}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMDhj hhubah}(h]h ]h"]h$]h&]uh1jhjzhhhjhMDubeh}(h]h ](jfunctioneh"]h$]h&]jjjj jj jjjuh1j+hhhj hNhNubj)}(hX5**Parameters** ``struct pci_dev *pdev`` client pci device ``const struct vga_switcheroo_client_ops *ops`` client callbacks ``bool driver_power_control`` whether power state is controlled by the driver's runtime pm **Description** Register vga client (GPU). Enable vga_switcheroo if another GPU and a handler have already registered. The power state of the client is assumed to be ON. Beforehand, vga_switcheroo_client_probe_defer() shall be called to ensure that all prerequisites are met. **Return** 0 on success, -ENOMEM on memory allocation error.h](h)}(h**Parameters**h]j)}(hj' h]h Parameters}(hj) hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj% ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMHhj! ubj)}(hhh](j)}(h+``struct pci_dev *pdev`` client pci device h](j)}(h``struct pci_dev *pdev``h]j)}(hjF h]hstruct pci_dev *pdev}(hjH hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjD ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMEhj@ ubj)}(hhh]h)}(hclient pci deviceh]hclient pci device}(hj_ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[ hMEhj\ ubah}(h]h ]h"]h$]h&]uh1jhj@ ubeh}(h]h ]h"]h$]h&]uh1jhj[ hMEhj= ubj)}(hA``const struct vga_switcheroo_client_ops *ops`` client callbacks h](j)}(h/``const struct vga_switcheroo_client_ops *ops``h]j)}(hj h]h+const struct vga_switcheroo_client_ops *ops}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj} ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMFhjy ubj)}(hhh]h)}(hclient callbacksh]hclient callbacks}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMFhj ubah}(h]h ]h"]h$]h&]uh1jhjy ubeh}(h]h ]h"]h$]h&]uh1jhj hMFhj= ubj)}(h[``bool driver_power_control`` whether power state is controlled by the driver's runtime pm h](j)}(h``bool driver_power_control``h]j)}(hj h]hbool driver_power_control}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMHhj ubj)}(hhh]h)}(hwhether power state is controlled by the driver’s runtime pm}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMGhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMHhj= ubeh}(h]h ]h"]h$]h&]uh1jhj! ubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMJhj! ubh)}(hXRegister vga client (GPU). Enable vga_switcheroo if another GPU and a handler have already registered. The power state of the client is assumed to be ON. Beforehand, vga_switcheroo_client_probe_defer() shall be called to ensure that all prerequisites are met.h]hXRegister vga client (GPU). Enable vga_switcheroo if another GPU and a handler have already registered. The power state of the client is assumed to be ON. Beforehand, vga_switcheroo_client_probe_defer() shall be called to ensure that all prerequisites are met.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMIhj! ubh)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMNhj! ubh)}(h10 on success, -ENOMEM on memory allocation error.h]h10 on success, -ENOMEM on memory allocation error.}(hj1 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMOhj! ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'1vga_switcheroo_register_audio_client (C function)&c.vga_switcheroo_register_audio_clienthNtauh1jhj hhhNhNubj,)}(hhh](j1)}(hint vga_switcheroo_register_audio_client (struct pci_dev *pdev, const struct vga_switcheroo_client_ops *ops, struct pci_dev *vga_dev)h]j7)}(hint vga_switcheroo_register_audio_client(struct pci_dev *pdev, const struct vga_switcheroo_client_ops *ops, struct pci_dev *vga_dev)h](j=)}(hinth]hint}(hj` hhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hj\ hhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM\ubjO)}(h h]h }(hjo hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj\ hhhjn hM\ubj`)}(h$vga_switcheroo_register_audio_clienth]jf)}(h$vga_switcheroo_register_audio_clienth]h$vga_switcheroo_register_audio_client}(hj hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj} ubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hj\ hhhjn hM\ubj)}(h\(struct pci_dev *pdev, const struct vga_switcheroo_client_ops *ops, struct pci_dev *vga_dev)h](j)}(hstruct pci_dev *pdevh](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjO)}(h h]h }(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubh)}(hhh]jf)}(hpci_devh]hpci_dev}(hj hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj)}j]j)}jj sb&c.vga_switcheroo_register_audio_clientasbuh1hhj ubjO)}(h h]h }(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubj)}(hj)h]h*}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubjf)}(hpdevh]hpdev}(hj hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj ubeh}(h]h ]h"]h$]h&]noemphj~juh1jhj ubj)}(h+const struct vga_switcheroo_client_ops *opsh](j)}(hjh]hconst}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjO)}(h h]h }(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubj)}(hjh]hstruct}(hj* hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjO)}(h h]h }(hj7 hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubh)}(hhh]jf)}(hvga_switcheroo_client_opsh]hvga_switcheroo_client_ops}(hjH hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjE ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjJ modnameN classnameNjj)}j]j &c.vga_switcheroo_register_audio_clientasbuh1hhj ubjO)}(h h]h }(hjf hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubj)}(hj)h]h*}(hjt hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubjf)}(hopsh]hops}(hj hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj ubeh}(h]h ]h"]h$]h&]noemphj~juh1jhj ubj)}(hstruct pci_dev *vga_devh](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjO)}(h h]h }(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubh)}(hhh]jf)}(hpci_devh]hpci_dev}(hj hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj modnameN classnameNjj)}j]j &c.vga_switcheroo_register_audio_clientasbuh1hhj ubjO)}(h h]h }(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubj)}(hj)h]h*}(hj hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj ubjf)}(hvga_devh]hvga_dev}(hj hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj ubeh}(h]h ]h"]h$]h&]noemphj~juh1jhj ubeh}(h]h ]h"]h$]h&]j~juh1jhj\ hhhjn hM\ubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhjX hhhjn hM\ubah}(h]jS ah ](jjeh"]h$]h&]jj)jhuh1j0hjn hM\hjU hhubj)}(hhh]h)}(hregister audio clienth]hregister audio client}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM\hj hhubah}(h]h ]h"]h$]h&]uh1jhjU hhhjn hM\ubeh}(h]h ](jfunctioneh"]h$]h&]jjjj3 jj3 jjjuh1j+hhhj hNhNubj)}(hX**Parameters** ``struct pci_dev *pdev`` client pci device ``const struct vga_switcheroo_client_ops *ops`` client callbacks ``struct pci_dev *vga_dev`` pci device which is bound to current audio client **Description** Register audio client (audio device on a GPU). The client is assumed to use runtime PM. Beforehand, vga_switcheroo_client_probe_defer() shall be called to ensure that all prerequisites are met. **Return** 0 on success, -ENOMEM on memory allocation error, -EINVAL on getting client id error.h](h)}(h**Parameters**h]j)}(hj= h]h Parameters}(hj? hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj; ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM`hj7 ubj)}(hhh](j)}(h+``struct pci_dev *pdev`` client pci device h](j)}(h``struct pci_dev *pdev``h]j)}(hj\ h]hstruct pci_dev *pdev}(hj^ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjZ ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM]hjV ubj)}(hhh]h)}(hclient pci deviceh]hclient pci device}(hju hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjq hM]hjr ubah}(h]h ]h"]h$]h&]uh1jhjV ubeh}(h]h ]h"]h$]h&]uh1jhjq hM]hjS ubj)}(hA``const struct vga_switcheroo_client_ops *ops`` client callbacks h](j)}(h/``const struct vga_switcheroo_client_ops *ops``h]j)}(hj h]h+const struct vga_switcheroo_client_ops *ops}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM^hj ubj)}(hhh]h)}(hclient callbacksh]hclient callbacks}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM^hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hM^hjS ubj)}(hN``struct pci_dev *vga_dev`` pci device which is bound to current audio client h](j)}(h``struct pci_dev *vga_dev``h]j)}(hj h]hstruct pci_dev *vga_dev}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM_hj ubj)}(hhh]h)}(h1pci device which is bound to current audio clienth]h1pci device which is bound to current audio client}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM_hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hM_hjS ubeh}(h]h ]h"]h$]h&]uh1jhj7 ubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMahj7 ubh)}(hRegister audio client (audio device on a GPU). The client is assumed to use runtime PM. Beforehand, vga_switcheroo_client_probe_defer() shall be called to ensure that all prerequisites are met.h]hRegister audio client (audio device on a GPU). The client is assumed to use runtime PM. Beforehand, vga_switcheroo_client_probe_defer() shall be called to ensure that all prerequisites are met.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM`hj7 ubh)}(h **Return**h]j)}(hj0h]hReturn}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMdhj7 ubh)}(hU0 on success, -ENOMEM on memory allocation error, -EINVAL on getting client id error.h]hU0 on success, -ENOMEM on memory allocation error, -EINVAL on getting client id error.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMehj7 ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'.vga_switcheroo_client_probe_defer (C function)#c.vga_switcheroo_client_probe_deferhNtauh1jhj hhhNhNubj,)}(hhh](j1)}(h=bool vga_switcheroo_client_probe_defer (struct pci_dev *pdev)h]j7)}(hprobe callback and return ``-EPROBE_DEFER`` if it evaluates to ``true``. Thou shalt not register the client ere thou hast called this. **Return** ``true`` if probing should be deferred, otherwise ``false``.h](h)}(h**Parameters**h]j)}(hjVh]h Parameters}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjPubj)}(hhh]j)}(h+``struct pci_dev *pdev`` client pci device h](j)}(h``struct pci_dev *pdev``h]j)}(hjuh]hstruct pci_dev *pdev}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjsubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjoubj)}(hhh]h)}(hclient pci deviceh]hclient pci device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjoubeh}(h]h ]h"]h$]h&]uh1jhjhMhjlubah}(h]h ]h"]h$]h&]uh1jhjPubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjPubh)}(hXDetermine whether any prerequisites are not fulfilled to probe a given client. Drivers shall invoke this early on in their ->probe callback and return ``-EPROBE_DEFER`` if it evaluates to ``true``. Thou shalt not register the client ere thou hast called this.h](hDetermine whether any prerequisites are not fulfilled to probe a given client. Drivers shall invoke this early on in their ->probe callback and return }(hjhhhNhNubj)}(h``-EPROBE_DEFER``h]h -EPROBE_DEFER}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if it evaluates to }(hjhhhNhNubj)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh?. Thou shalt not register the client ere thou hast called this.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjPubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjPubh)}(h<``true`` if probing should be deferred, otherwise ``false``.h](j)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh* if probing should be deferred, otherwise }(hjhhhNhNubj)}(h ``false``h]hfalse}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjPubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j',vga_switcheroo_get_client_state (C function)!c.vga_switcheroo_get_client_statehNtauh1jhj hhhNhNubj,)}(hhh](j1)}(hPenum vga_switcheroo_state vga_switcheroo_get_client_state (struct pci_dev *pdev)h]j7)}(hOenum vga_switcheroo_state vga_switcheroo_get_client_state(struct pci_dev *pdev)h](j)}(hj,h]henum}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\hhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMubjO)}(h h]h }(hjnhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj\hhhjmhMubh)}(hhh]jf)}(hvga_switcheroo_stateh]hvga_switcheroo_state}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj|ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jvga_switcheroo_get_client_statesb!c.vga_switcheroo_get_client_stateasbuh1hhj\hhhjmhMubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj\hhhjmhMubj`)}(hvga_switcheroo_get_client_stateh]jf)}(hjh]hvga_switcheroo_get_client_state}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hj\hhhjmhMubj)}(h(struct pci_dev *pdev)h]j)}(hstruct pci_dev *pdevh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubh)}(hhh]jf)}(hpci_devh]hpci_dev}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j!c.vga_switcheroo_get_client_stateasbuh1hhjubjO)}(h h]h }(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubj)}(hj)h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjf)}(hpdevh]hpdev}(hj$hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]noemphj~juh1jhjubah}(h]h ]h"]h$]h&]j~juh1jhj\hhhjmhMubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhjXhhhjmhMubah}(h]jSah ](jjeh"]h$]h&]jj)jhuh1j0hjmhMhjUhhubj)}(hhh]h)}(h$obtain power state of a given clienth]h$obtain power state of a given client}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjKhhubah}(h]h ]h"]h$]h&]uh1jhjUhhhjmhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjfjjfjjjuh1j+hhhj hNhNubj)}(h**Parameters** ``struct pci_dev *pdev`` client pci device **Description** Obtain power state of a given client as seen from vga_switcheroo. The function is only called from hda_intel.c. **Return** Power state.h](h)}(h**Parameters**h]j)}(hjph]h Parameters}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjnubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjjubj)}(hhh]j)}(h+``struct pci_dev *pdev`` client pci device h](j)}(h``struct pci_dev *pdev``#h]j)}(hjh]hstruct pci_dev *pdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjubj)}(hhh]h)}(hclient pci deviceh]hclient pci device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjjubh)}(hoObtain power state of a given client as seen from vga_switcheroo. The function is only called from hda_intel.c.h]hoObtain power state of a given client as seen from vga_switcheroo. The function is only called from hda_intel.c.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjjubh)}(h Power state.h]h Power state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'-vga_switcheroo_unregister_client (C function)"c.vga_switcheroo_unregister_clienthNtauh1jhj hhhNhNubj,)}(hhh](j1)}(hubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj=hMhjubj)}(h%``struct fb_info *info`` framebuffer h](j)}(h``struct fb_info *info``h]j)}(hjah]hstruct fb_info *info}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhj[ubj)}(hhh]h)}(h framebufferh]h framebuffer}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhMhjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhjvhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM hjubh)}(hUSet framebuffer of a given client. The console will be remapped to this on switching.h]hUSet framebuffer of a given client. The console will be remapped to this on switching.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'$vga_switcheroo_lock_ddc (C function)c.vga_switcheroo_lock_ddchNtauh1jhj hhhNhNubj,)}(hhh](j1)}(h2int vga_switcheroo_lock_ddc (struct pci_dev *pdev)h]j7)}(h1int vga_switcheroo_lock_ddc(struct pci_dev *pdev)h](j=)}(hinth]hint}(hjhhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hjhhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhjhMubj`)}(hvga_switcheroo_lock_ddch]jf)}(hvga_switcheroo_lock_ddch]hvga_switcheroo_lock_ddc}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hjhhhjhMubj)}(h(struct pci_dev *pdev)h]j)}(hstruct pci_dev *pdevh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjO)}(h h]h }(hj+hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubh)}(hhh]jf)}(hpci_devh]hpci_dev}(hj<hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj9ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj>modnameN classnameNjj)}j]j)}jjsbc.vga_switcheroo_lock_ddcasbuh1hhjubjO)}(h h]h }(hj\hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubj)}(hj)h]h*}(hjjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjf)}(hpdevh]hpdev}(hjwhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]noemphj~juh1jhjubah}(h]h ]h"]h$]h&]j~juh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhjhhhjhMubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1j0hjhMhjhhubj)}(hhh]h)}(h.temporarily switch DDC lines to a given clienth]h.temporarily switch DDC lines to a given client}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1j+hhhj hNhNubj)}(hX**Parameters** ``struct pci_dev *pdev`` client pci device **Description** Temporarily switch DDC lines to the client identified by **pdev** (but leave the outputs otherwise switched to where they are). This allows the inactive client to probe EDID. The DDC lines must afterwards be switched back by calling vga_switcheroo_unlock_ddc(), even if this function returns an error. **Return** Previous DDC owner on success or a negative int on error. Specifically, ``-ENODEV`` if no handler has registered or if the handler does not support switching the DDC lines. Also, a negative value returned by the handler is propagated back to the caller. The return value has merely an informational purpose for any caller which might be interested in it. It is acceptable to ignore the return value and simply rely on the result of the subsequent EDID probe, which will be ``NULL`` if DDC switching failed.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjubj)}(hhh]j)}(h+``struct pci_dev *pdev`` client pci device h](j)}(h``struct pci_dev *pdev``h]j)}(hjh]hstruct pci_dev *pdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjubj)}(hhh]h)}(hclient pci deviceh]hclient pci device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjubh)}(hX-Temporarily switch DDC lines to the client identified by **pdev** (but leave the outputs otherwise switched to where they are). This allows the inactive client to probe EDID. The DDC lines must afterwards be switched back by calling vga_switcheroo_unlock_ddc(), even if this function returns an error.h](h9Temporarily switch DDC lines to the client identified by }(hj3hhhNhNubj)}(h**pdev**h]hpdev}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh (but leave the outputs otherwise switched to where they are). This allows the inactive client to probe EDID. The DDC lines must afterwards be switched back by calling vga_switcheroo_unlock_ddc(), even if this function returns an error.}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjubh)}(h **Return**h]j)}(hjVh]hReturn}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM#hjubh)}(hXPrevious DDC owner on success or a negative int on error. Specifically, ``-ENODEV`` if no handler has registered or if the handler does not support switching the DDC lines. Also, a negative value returned by the handler is propagated back to the caller. The return value has merely an informational purpose for any caller which might be interested in it. It is acceptable to ignore the return value and simply rely on the result of the subsequent EDID probe, which will be ``NULL`` if DDC switching failed.h](hHPrevious DDC owner on success or a negative int on error. Specifically, }(hjlhhhNhNubj)}(h ``-ENODEV``h]h-ENODEV}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubhX if no handler has registered or if the handler does not support switching the DDC lines. Also, a negative value returned by the handler is propagated back to the caller. The return value has merely an informational purpose for any caller which might be interested in it. It is acceptable to ignore the return value and simply rely on the result of the subsequent EDID probe, which will be }(hjlhhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjlubh if DDC switching failed.}(hjlhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM$hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'&vga_switcheroo_unlock_ddc (C function)c.vga_switcheroo_unlock_ddchNtauh1jhj hhhNhNubj,)}(hhh](j1)}(h4int vga_switcheroo_unlock_ddc (struct pci_dev *pdev)h]j7)}(h3int vga_switcheroo_unlock_ddc(struct pci_dev *pdev)h](j=)}(hinth]hint}(hjhhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hjhhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM>ubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhjhM>ubj`)}(hvga_switcheroo_unlock_ddch]jf)}(hvga_switcheroo_unlock_ddch]hvga_switcheroo_unlock_ddc}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hjhhhjhM>ubj)}(h(struct pci_dev *pdev)h]j)}(hstruct pci_dev *pdevh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjO)}(h h]h }(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubh)}(hhh]jf)}(hpci_devh]hpci_dev}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j)}jjsbc.vga_switcheroo_unlock_ddcasbuh1hhjubjO)}(h h]h }(hj:hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubj)}(hj)h]h*}(hjHhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjf)}(hpdevh]hpdev}(hjUhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]noemphj~juh1jhjubah}(h]h ]h"]h$]h&]j~juh1jhjhhhjhM>ubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhjhhhjhM>ubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1j0hjhM>hjhhubj)}(hhh]h)}(h'switch DDC lines back to previous ownerh]h'switch DDC lines back to previous owner}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM>hj|hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhM>ubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1j+hhhj hNhNubj)}(hX**Parameters** ``struct pci_dev *pdev`` client pci device **Description** Switch DDC lines back to the previous owner after calling vga_switcheroo_lock_ddc(). This must be called even if vga_switcheroo_lock_ddc() returned an error. **Return** Previous DDC owner on success (i.e. the client identifier of **pdev**) or a negative int on error. Specifically, ``-ENODEV`` if no handler has registered or if the handler does not support switching the DDC lines. Also, a negative value returned by the handler is propagated back to the caller. Finally, invoking this function without calling vga_switcheroo_lock_ddc() first is not allowed and will result in ``-EINVAL``.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMBhjubj)}(hhh]j)}(h+``struct pci_dev *pdev`` client pci device h](j)}(h``struct pci_dev *pdev``h]j)}(hjh]hstruct pci_dev *pdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM?hjubj)}(hhh]h)}(hclient pci deviceh]hclient pci device}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM?hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM?hjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMAhjubh)}(hSwitch DDC lines back to the previous owner after calling vga_switcheroo_lock_ddc(). This must be called even if vga_switcheroo_lock_ddc() returned an error.h]hSwitch DDC lines back to the previous owner after calling vga_switcheroo_lock_ddc(). This must be called even if vga_switcheroo_lock_ddc() returned an error.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chM@hjubh)}(h **Return**h]j)}(hj"h]hReturn}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMDhjubh)}(hXPrevious DDC owner on success (i.e. the client identifier of **pdev**) or a negative int on error. Specifically, ``-ENODEV`` if no handler has registered or if the handler does not support switching the DDC lines. Also, a negative value returned by the handler is propagated back to the caller. Finally, invoking this function without calling vga_switcheroo_lock_ddc() first is not allowed and will result in ``-EINVAL``.h](h=Previous DDC owner on success (i.e. the client identifier of }(hj8hhhNhNubj)}(h**pdev**h]hpdev}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubh,) or a negative int on error. Specifically, }(hj8hhhNhNubj)}(h ``-ENODEV``h]h-ENODEV}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubhX if no handler has registered or if the handler does not support switching the DDC lines. Also, a negative value returned by the handler is propagated back to the caller. Finally, invoking this function without calling vga_switcheroo_lock_ddc() first is not allowed and will result in }(hj8hhhNhNubj)}(h ``-EINVAL``h]h-EINVAL}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj8ubh.}(hj8hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMEhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'2vga_switcheroo_process_delayed_switch (C function)'c.vga_switcheroo_process_delayed_switchhNtauh1jhj hhhNhNubj,)}(hhh](j1)}(h0int vga_switcheroo_process_delayed_switch (void)h]j7)}(h/int vga_switcheroo_process_delayed_switch(void)h](j=)}(hinth]hint}(hjhhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hjhhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhjhMubj`)}(h%vga_switcheroo_process_delayed_switchh]jf)}(h%vga_switcheroo_process_delayed_switchh]h%vga_switcheroo_process_delayed_switch}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hjhhhjhMubj)}(h(void)h]j)}(hvoidh]j=)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hjubah}(h]h ]h"]h$]h&]noemphj~juh1jhjubah}(h]h ]h"]h$]h&]j~juh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhjhhhjhMubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1j0hjhMhjhhubj)}(hhh]h)}(hhelper for delayed switchingh]hhelper for delayed switching}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjjjjjjjuh1j+hhhj hNhNubj)}(hXO**Parameters** ``void`` no arguments **Description** Process a delayed switch if one is pending. **Return** 0 on success. -EINVAL if no delayed switch is pending, if the client has unregistered in the meantime or if there are other clients blocking the switch. If the actual switch fails, an error is reported and 0 is returned.h](h)}(h**Parameters**h]j)}(hj&h]h Parameters}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhj ubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]j)}(hjEh]hvoid}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhj?ubj)}(hhh]h)}(h no argumentsh]h no arguments}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjZhKhj[ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhjZhKhj<ubah}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chKhj ubh)}(h+Process a delayed switch if one is pending.h]h+Process a delayed switch if one is pending.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhj ubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhj ubh)}(h0 on success. -EINVAL if no delayed switch is pending, if the client has unregistered in the meantime or if there are other clients blocking the switch. If the actual switch fails, an error is reported and 0 is returned.h]h0 on success. -EINVAL if no delayed switch is pending, if the client has unregistered in the meantime or if there are other clients blocking the switch. If the actual switch fails, an error is reported and 0 is returned.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'.vga_switcheroo_init_domain_pm_ops (C function)#c.vga_switcheroo_init_domain_pm_opshNtauh1jhj hhhNhNubj,)}(hhh](j1)}(hXint vga_switcheroo_init_domain_pm_ops (struct device *dev, struct dev_pm_domain *domain)h]j7)}(hWint vga_switcheroo_init_domain_pm_ops(struct device *dev, struct dev_pm_domain *domain)h](j=)}(hinth]hint}(hjhhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hjhhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhjhMubj`)}(h!vga_switcheroo_init_domain_pm_opsh]jf)}(h!vga_switcheroo_init_domain_pm_opsh]h!vga_switcheroo_init_domain_pm_ops}(hj hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj ubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hjhhhjhMubj)}(h2(struct device *dev, struct dev_pm_domain *domain)h](j)}(hstruct device *devh](j)}(hjh]hstruct}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjO)}(h h]h }(hj6hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj%ubh)}(hhh]jf)}(hdeviceh]hdevice}(hjGhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjDubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjImodnameN classnameNjj)}j]j)}jjsb#c.vga_switcheroo_init_domain_pm_opsasbuh1hhj%ubjO)}(h h]h }(hjghhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj%ubj)}(hj)h]h*}(hjuhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj%ubjf)}(hdevh]hdev}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj%ubeh}(h]h ]h"]h$]h&]noemphj~juh1jhj!ubj)}(hstruct dev_pm_domain *domainh](j)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubh)}(hhh]jf)}(h dev_pm_domainh]h dev_pm_domain}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]jc#c.vga_switcheroo_init_domain_pm_opsasbuh1hhjubjO)}(h h]h }(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubj)}(hj)h]h*}(hjhhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhjubjf)}(hdomainh]hdomain}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubeh}(h]h ]h"]h$]h&]noemphj~juh1jhj!ubeh}(h]h ]h"]h$]h&]j~juh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhjhhhjhMubah}(h]jah ](jjeh"]h$]h&]jj)jhuh1j0hjhMhjhhubj)}(hhh]h)}(hhelper for driver power controlh]hhelper for driver power control}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](jfunctioneh"]h$]h&]jjjj4jj4jjjuh1j+hhhj hNhNubj)}(hX3**Parameters** ``struct device *dev`` vga client device ``struct dev_pm_domain *domain`` power domain **Description** Helper for GPUs whose power state is controlled by the driver's runtime pm. After the GPU has been suspended, the handler needs to be called to cut power to the GPU. Likewise it needs to reinstate power before the GPU can resume. To this end, this helper augments the suspend/resume functions by the requisite calls to the handler. It needs only be called on platforms where the power switch is separate to the device being powered down.h](h)}(h**Parameters**h]j)}(hj>h]h Parameters}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhj8ubj)}(hhh](j)}(h)``struct device *dev`` vga client device h](j)}(h``struct device *dev``h]j)}(hj]h]hstruct device *dev}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjWubj)}(hhh]h)}(hvga client deviceh]hvga client device}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjrhMhjsubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjrhMhjTubj)}(h.``struct dev_pm_domain *domain`` power domain h](j)}(h ``struct dev_pm_domain *domain``h]j)}(hjh]hstruct dev_pm_domain *domain}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhjubj)}(hhh]h)}(h power domainh]h power domain}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjTubeh}(h]h ]h"]h$]h&]uh1jhj8ubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhj8ubh)}(hXHelper for GPUs whose power state is controlled by the driver's runtime pm. After the GPU has been suspended, the handler needs to be called to cut power to the GPU. Likewise it needs to reinstate power before the GPU can resume. To this end, this helper augments the suspend/resume functions by the requisite calls to the handler. It needs only be called on platforms where the power switch is separate to the device being powered down.h]hXHelper for GPUs whose power state is controlled by the driver’s runtime pm. After the GPU has been suspended, the handler needs to be called to cut power to the GPU. Likewise it needs to reinstate power before the GPU can resume. To this end, this helper augments the suspend/resume functions by the requisite calls to the handler. It needs only be called on platforms where the power switch is separate to the device being powered down.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:31: ./drivers/gpu/vga/vga_switcheroo.chMhj8ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj hhhNhNubeh}(h]public-functionsah ]h"]h$]public functionsah&]uh1hhjhhhhhK referencedKubh)}(hhh](h)}(hPublic structuresh]hPublic structures}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhK#ubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'!vga_switcheroo_handler (C struct)c.vga_switcheroo_handlerhNtauh1jhjhhha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhNubj,)}(hhh](j1)}(hvga_switcheroo_handlerh]j7)}(hstruct vga_switcheroo_handlerh](j)}(hjh]hstruct}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-hhha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKubjO)}(h h]h }(hj?hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj-hhhj>hKubj`)}(hvga_switcheroo_handlerh]jf)}(hj+h]hvga_switcheroo_handler}(hjQhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjMubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hj-hhhj>hKubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhj)hhhj>hKubah}(h]j#ah ](jjeh"]h$]h&]jj)jhuh1j0hj>hKhj&hhubj)}(hhh]h)}(hhandler callbacksh]hhandler callbacks}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhK^hjphhubah}(h]h ]h"]h$]h&]uh1jhj&hhhj>hKubeh}(h]h ](jstructeh"]h$]h&]jjjjjjjjjuh1j+hhhjhj%hNubj)}(hX**Definition**:: struct vga_switcheroo_handler { int (*init)(void); int (*switchto)(enum vga_switcheroo_client_id id); int (*switch_ddc)(enum vga_switcheroo_client_id id); int (*power_state)(enum vga_switcheroo_client_id id, enum vga_switcheroo_state state); enum vga_switcheroo_client_id (*get_client_id)(struct pci_dev *pdev); }; **Members** ``init`` initialize handler. Optional. This gets called when vga_switcheroo is enabled, i.e. when two vga clients have registered. It allows the handler to perform some delayed initialization that depends on the existence of the vga clients. Currently only the radeon and amdgpu drivers use this. The return value is ignored ``switchto`` switch outputs to given client. Mandatory. For muxless machines this should be a no-op. Returning 0 denotes success, anything else failure (in which case the switch is aborted) ``switch_ddc`` switch DDC lines to given client. Optional. Should return the previous DDC owner on success or a negative int on failure ``power_state`` cut or reinstate power of given client. Optional. The return value is ignored ``get_client_id`` determine if given pci device is integrated or discrete GPU. Mandatoryh](h)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKbhjubh literal_block)}(hXNstruct vga_switcheroo_handler { int (*init)(void); int (*switchto)(enum vga_switcheroo_client_id id); int (*switch_ddc)(enum vga_switcheroo_client_id id); int (*power_state)(enum vga_switcheroo_client_id id, enum vga_switcheroo_state state); enum vga_switcheroo_client_id (*get_client_id)(struct pci_dev *pdev); };h]hXNstruct vga_switcheroo_handler { int (*init)(void); int (*switchto)(enum vga_switcheroo_client_id id); int (*switch_ddc)(enum vga_switcheroo_client_id id); int (*power_state)(enum vga_switcheroo_client_id id, enum vga_switcheroo_state state); enum vga_switcheroo_client_id (*get_client_id)(struct pci_dev *pdev); };}hjsbah}(h]h ]h"]h$]h&]j~juh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKdhjubh)}(h **Members**h]j)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKlhjubj)}(hhh](j)}(hXE``init`` initialize handler. Optional. This gets called when vga_switcheroo is enabled, i.e. when two vga clients have registered. It allows the handler to perform some delayed initialization that depends on the existence of the vga clients. Currently only the radeon and amdgpu drivers use this. The return value is ignored h](j)}(h``init``h]j)}(hjh]hinit}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKehjubj)}(hhh]h)}(hX;initialize handler. Optional. This gets called when vga_switcheroo is enabled, i.e. when two vga clients have registered. It allows the handler to perform some delayed initialization that depends on the existence of the vga clients. Currently only the radeon and amdgpu drivers use this. The return value is ignoredh]hX;initialize handler. Optional. This gets called when vga_switcheroo is enabled, i.e. when two vga clients have registered. It allows the handler to perform some delayed initialization that depends on the existence of the vga clients. Currently only the radeon and amdgpu drivers use this. The return value is ignored}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhK`hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKehjubj)}(h``switchto`` switch outputs to given client. Mandatory. For muxless machines this should be a no-op. Returning 0 denotes success, anything else failure (in which case the switch is aborted) h](j)}(h ``switchto``h]j)}(hjh]hswitchto}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKihjubj)}(hhh]h)}(hswitch outputs to given client. Mandatory. For muxless machines this should be a no-op. Returning 0 denotes success, anything else failure (in which case the switch is aborted)h]hswitch outputs to given client. Mandatory. For muxless machines this should be a no-op. Returning 0 denotes success, anything else failure (in which case the switch is aborted)}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKfhj2ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj1hKihjubj)}(h``switch_ddc`` switch DDC lines to given client. Optional. Should return the previous DDC owner on success or a negative int on failure h](j)}(h``switch_ddc``h]j)}(hjVh]h switch_ddc}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjTubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKlhjPubj)}(hhh]h)}(hxswitch DDC lines to given client. Optional. Should return the previous DDC owner on success or a negative int on failureh]hxswitch DDC lines to given client. Optional. Should return the previous DDC owner on success or a negative int on failure}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKjhjlubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjkhKlhjubj)}(h^``power_state`` cut or reinstate power of given client. Optional. The return value is ignored h](j)}(h``power_state``h]j)}(hjh]h power_state}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKnhjubj)}(hhh]h)}(hMcut or reinstate power of given client. Optional. The return value is ignoredh]hMcut or reinstate power of given client. Optional. The return value is ignored}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKmhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKnhjubj)}(hX``get_client_id`` determine if given pci device is integrated or discrete GPU. Mandatoryh](j)}(h``get_client_id``h]j)}(hjh]h get_client_id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKohjubj)}(hhh]h)}(hFdetermine if given pci device is integrated or discrete GPU. Mandatoryh]hFdetermine if given pci device is integrated or discrete GPU. Mandatory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKohjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKohjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhj%hNubh)}(h**Description**h]j)}(hj h]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKshjhhubh)}(hHandler callbacks. The multiplexer itself. The **switchto** and **get_client_id** methods are mandatory, all others may be set to NULL.h](h/Handler callbacks. The multiplexer itself. The }(hj"hhhNhNubj)}(h **switchto**h]hswitchto}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubh and }(hj"hhhNhNubj)}(h**get_client_id**h]h get_client_id}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubh6 methods are mandatory, all others may be set to NULL.}(hj"hhhNhNubeh}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:37: ./include/linux/vga_switcheroo.hhKphjhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'$vga_switcheroo_client_ops (C struct)c.vga_switcheroo_client_opshNtauh1jhjhhha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhNubj,)}(hhh](j1)}(hvga_switcheroo_client_opsh]j7)}(h struct vga_switcheroo_client_opsh](j)}(hjh]hstruct}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkhhha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKubjO)}(h h]h }(hj}hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjkhhhj|hKubj`)}(hvga_switcheroo_client_opsh]jf)}(hjih]hvga_switcheroo_client_ops}(hjhhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehjubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hjkhhhj|hKubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhjghhhj|hKubah}(h]jaah ](jjeh"]h$]h&]jj)jhuh1j0hj|hKhjdhhubj)}(hhh]h)}(hclient callbacksh]hclient callbacks}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhK~hjhhubah}(h]h ]h"]h$]h&]uh1jhjdhhhj|hKubeh}(h]h ](jstructeh"]h$]h&]jjjjjjjjjuh1j+hhhjhjchNubj)}(hXM**Definition**:: struct vga_switcheroo_client_ops { void (*set_gpu_state)(struct pci_dev *dev, enum vga_switcheroo_state); void (*reprobe)(struct pci_dev *dev); bool (*can_switch)(struct pci_dev *dev); void (*gpu_bound)(struct pci_dev *dev, enum vga_switcheroo_client_id); }; **Members** ``set_gpu_state`` do the equivalent of suspend/resume for the card. Mandatory. This should not cut power to the discrete GPU, which is the job of the handler ``reprobe`` poll outputs. Optional. This gets called after waking the GPU and switching the outputs to it ``can_switch`` check if the device is in a position to switch now. Mandatory. The client should return false if a user space process has one of its device files open ``gpu_bound`` notify the client id to audio client when the GPU is bound.h](h)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKhjubj)}(hXstruct vga_switcheroo_client_ops { void (*set_gpu_state)(struct pci_dev *dev, enum vga_switcheroo_state); void (*reprobe)(struct pci_dev *dev); bool (*can_switch)(struct pci_dev *dev); void (*gpu_bound)(struct pci_dev *dev, enum vga_switcheroo_client_id); };h]hXstruct vga_switcheroo_client_ops { void (*set_gpu_state)(struct pci_dev *dev, enum vga_switcheroo_state); void (*reprobe)(struct pci_dev *dev); bool (*can_switch)(struct pci_dev *dev); void (*gpu_bound)(struct pci_dev *dev, enum vga_switcheroo_client_id); };}hjsbah}(h]h ]h"]h$]h&]j~juh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKhjubh)}(h **Members**h]j)}(hjh]hMembers}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKhjubj)}(hhh](j)}(h``set_gpu_state`` do the equivalent of suspend/resume for the card. Mandatory. This should not cut power to the discrete GPU, which is the job of the handler h](j)}(h``set_gpu_state``h]j)}(hj h]h set_gpu_state}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKhj ubj)}(hhh]h)}(hdo the equivalent of suspend/resume for the card. Mandatory. This should not cut power to the discrete GPU, which is the job of the handlerh]hdo the equivalent of suspend/resume for the card. Mandatory. This should not cut power to the discrete GPU, which is the job of the handler}(hj7 hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKhj4 ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj3 hKhj ubj)}(hj``reprobe`` poll outputs. Optional. This gets called after waking the GPU and switching the outputs to it h](j)}(h ``reprobe``h]j)}(hjX h]hreprobe}(hjZ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjV ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKhjR ubj)}(hhh]h)}(h]poll outputs. Optional. This gets called after waking the GPU and switching the outputs to ith]h]poll outputs. Optional. This gets called after waking the GPU and switching the outputs to it}(hjq hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKhjn ubah}(h]h ]h"]h$]h&]uh1jhjR ubeh}(h]h ]h"]h$]h&]uh1jhjm hKhj ubj)}(h``can_switch`` check if the device is in a position to switch now. Mandatory. The client should return false if a user space process has one of its device files open h](j)}(h``can_switch``h]j)}(hj h]h can_switch}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKhj ubj)}(hhh]h)}(hcheck if the device is in a position to switch now. Mandatory. The client should return false if a user space process has one of its device files openh]hcheck if the device is in a position to switch now. Mandatory. The client should return false if a user space process has one of its device files open}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhj ubj)}(hI``gpu_bound`` notify the client id to audio client when the GPU is bound.h](j)}(h ``gpu_bound``h]j)}(hj h]h gpu_bound}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKhj ubj)}(hhh]h)}(h;notify the client id to audio client when the GPU is bound.h]h;notify the client id to audio client when the GPU is bound.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhj ubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhjhhhjchNubh)}(h**Description**h]j)}(hj!h]h Description}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj !ubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKhjhhubh)}(hX,Client callbacks. A client can be either a GPU or an audio device on a GPU. The **set_gpu_state** and **can_switch** methods are mandatory, **reprobe** may be set to NULL. For audio clients, the **reprobe** member is bogus. OTOH, **gpu_bound** is only for audio clients, and not used for GPU clients.h](hPClient callbacks. A client can be either a GPU or an audio device on a GPU. The }(hj%!hhhNhNubj)}(h**set_gpu_state**h]h set_gpu_state}(hj-!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%!ubh and }(hj%!hhhNhNubj)}(h**can_switch**h]h can_switch}(hj?!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%!ubh methods are mandatory, }(hj%!hhhNhNubj)}(h **reprobe**h]hreprobe}(hjQ!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%!ubh, may be set to NULL. For audio clients, the }(hj%!hhhNhNubj)}(h **reprobe**h]hreprobe}(hjc!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%!ubh member is bogus. OTOH, }(hj%!hhhNhNubj)}(h **gpu_bound**h]h gpu_bound}(hju!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%!ubh9 is only for audio clients, and not used for GPU clients.}(hj%!hhhNhNubeh}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:40: ./include/linux/vga_switcheroo.hhKhjhhubeh}(h]public-structuresah ]h"]public structuresah$]h&]uh1hhjhhhhhK#ubh)}(hhh](h)}(hPublic constantsh]hPublic constants}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hhhhhK,ubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j''vga_switcheroo_handler_flags_t (C enum) c.vga_switcheroo_handler_flags_thNtauh1jhj!hhha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:46: ./include/linux/vga_switcheroo.hhNubj,)}(hhh](j1)}(hvga_switcheroo_handler_flags_th]j7)}(h#enum vga_switcheroo_handler_flags_th](j)}(hj,h]henum}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!hhha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:46: ./include/linux/vga_switcheroo.hhKubjO)}(h h]h }(hj!hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj!hhhj!hKubj`)}(hvga_switcheroo_handler_flags_th]jf)}(hj!h]hvga_switcheroo_handler_flags_t}(hj!hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj!ubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hj!hhhj!hKubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhj!hhhj!hKubah}(h]j!ah ](jjeh"]h$]h&]jj)jhuh1j0hj!hKhj!hhubj)}(hhh]h)}(hhandler flags bitmaskh]hhandler flags bitmask}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:46: ./include/linux/vga_switcheroo.hhK'hj"hhubah}(h]h ]h"]h$]h&]uh1jhj!hhhj!hKubeh}(h]h ](jenumeh"]h$]h&]jjjj"jj"jjjuh1j+hhhj!hj!hNubj)}(hXz**Constants** ``VGA_SWITCHEROO_CAN_SWITCH_DDC`` whether the handler is able to switch the DDC lines separately. This signals to clients that they should call drm_get_edid_switcheroo() to probe the EDID ``VGA_SWITCHEROO_NEEDS_EDP_CONFIG`` whether the handler is unable to switch the AUX channel separately. This signals to clients that the active GPU needs to train the link and communicate the link parameters to the inactive GPU (mediated by vga_switcheroo). The inactive GPU may then skip the AUX handshake and set up its output with these pre-calibrated values (DisplayPort specification v1.1a, section 2.5.3.3)h](h)}(h **Constants**h]j)}(hj%"h]h Constants}(hj'"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#"ubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:46: ./include/linux/vga_switcheroo.hhK+hj"ubj)}(hhh](j)}(h``VGA_SWITCHEROO_CAN_SWITCH_DDC`` whether the handler is able to switch the DDC lines separately. This signals to clients that they should call drm_get_edid_switcheroo() to probe the EDID h](j)}(h!``VGA_SWITCHEROO_CAN_SWITCH_DDC``h]j)}(hjD"h]hVGA_SWITCHEROO_CAN_SWITCH_DDC}(hjF"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjB"ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:46: ./include/linux/vga_switcheroo.hhK0hj>"ubj)}(hhh]h)}(hwhether the handler is able to switch the DDC lines separately. This signals to clients that they should call drm_get_edid_switcheroo() to probe the EDIDh]hwhether the handler is able to switch the DDC lines separately. This signals to clients that they should call drm_get_edid_switcheroo() to probe the EDID}(hj]"hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:46: ./include/linux/vga_switcheroo.hhK.hjZ"ubah}(h]h ]h"]h$]h&]uh1jhj>"ubeh}(h]h ]h"]h$]h&]uh1jhjY"hK0hj;"ubj)}(hX``VGA_SWITCHEROO_NEEDS_EDP_CONFIG`` whether the handler is unable to switch the AUX channel separately. This signals to clients that the active GPU needs to train the link and communicate the link parameters to the inactive GPU (mediated by vga_switcheroo). The inactive GPU may then skip the AUX handshake and set up its output with these pre-calibrated values (DisplayPort specification v1.1a, section 2.5.3.3)h](j)}(h#``VGA_SWITCHEROO_NEEDS_EDP_CONFIG``h]j)}(hj~"h]hVGA_SWITCHEROO_NEEDS_EDP_CONFIG}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|"ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:46: ./include/linux/vga_switcheroo.hhK7hjx"ubj)}(hhh]h)}(hXxwhether the handler is unable to switch the AUX channel separately. This signals to clients that the active GPU needs to train the link and communicate the link parameters to the inactive GPU (mediated by vga_switcheroo). The inactive GPU may then skip the AUX handshake and set up its output with these pre-calibrated values (DisplayPort specification v1.1a, section 2.5.3.3)h]hXxwhether the handler is unable to switch the AUX channel separately. This signals to clients that the active GPU needs to train the link and communicate the link parameters to the inactive GPU (mediated by vga_switcheroo). The inactive GPU may then skip the AUX handshake and set up its output with these pre-calibrated values (DisplayPort specification v1.1a, section 2.5.3.3)}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:46: ./include/linux/vga_switcheroo.hhK3hj"ubah}(h]h ]h"]h$]h&]uh1jhjx"ubeh}(h]h ]h"]h$]h&]uh1jhj"hK7hj;"ubeh}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj!hhhj!hNubh)}(h**Description**h]j)}(hj"h]h Description}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj"ubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:46: ./include/linux/vga_switcheroo.hhK:hj!hhubh)}(hkHandler flags bitmask. Used by handlers to declare their capabilities upon registering with vga_switcheroo.h]hkHandler flags bitmask. Used by handlers to declare their capabilities upon registering with vga_switcheroo.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:46: ./include/linux/vga_switcheroo.hhK1hj!hhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'!vga_switcheroo_client_id (C enum)c.vga_switcheroo_client_idhNtauh1jhj!hhha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:49: ./include/linux/vga_switcheroo.hhNubj,)}(hhh](j1)}(hvga_switcheroo_client_idh]j7)}(henum vga_switcheroo_client_idh](j)}(hj,h]henum}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"hhha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:49: ./include/linux/vga_switcheroo.hhKubjO)}(h h]h }(hj#hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj"hhhj #hKubj`)}(hvga_switcheroo_client_idh]jf)}(hj"h]hvga_switcheroo_client_id}(hj #hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj#ubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hj"hhhj #hKubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhj"hhhj #hKubah}(h]j"ah ](jjeh"]h$]h&]jj)jhuh1j0hj #hKhj"hhubj)}(hhh]h)}(hclient identifierh]hclient identifier}(hjB#hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:49: ./include/linux/vga_switcheroo.hhKLhj?#hhubah}(h]h ]h"]h$]h&]uh1jhj"hhhj #hKubeh}(h]h ](jenumeh"]h$]h&]jjjjZ#jjZ#jjjuh1j+hhhj!hj"hNubj)}(hX**Constants** ``VGA_SWITCHEROO_UNKNOWN_ID`` initial identifier assigned to vga clients. Determining the id requires the handler, so GPUs are given their true id in a delayed fashion in vga_switcheroo_enable() ``VGA_SWITCHEROO_IGD`` integrated graphics device ``VGA_SWITCHEROO_DIS`` discrete graphics device ``VGA_SWITCHEROO_MAX_CLIENTS`` currently no more than two GPUs are supportedh](h)}(h **Constants**h]j)}(hjd#h]h Constants}(hjf#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjb#ubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:49: ./include/linux/vga_switcheroo.hhKPhj^#ubj)}(hhh](j)}(h``VGA_SWITCHEROO_UNKNOWN_ID`` initial identifier assigned to vga clients. Determining the id requires the handler, so GPUs are given their true id in a delayed fashion in vga_switcheroo_enable() h](j)}(h``VGA_SWITCHEROO_UNKNOWN_ID``h]j)}(hj#h]hVGA_SWITCHEROO_UNKNOWN_ID}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:49: ./include/linux/vga_switcheroo.hhKUhj}#ubj)}(hhh]h)}(hinitial identifier assigned to vga clients. Determining the id requires the handler, so GPUs are given their true id in a delayed fashion in vga_switcheroo_enable()h]hinitial identifier assigned to vga clients. Determining the id requires the handler, so GPUs are given their true id in a delayed fashion in vga_switcheroo_enable()}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:49: ./include/linux/vga_switcheroo.hhKShj#ubah}(h]h ]h"]h$]h&]uh1jhj}#ubeh}(h]h ]h"]h$]h&]uh1jhj#hKUhjz#ubj)}(h2``VGA_SWITCHEROO_IGD`` integrated graphics device h](j)}(h``VGA_SWITCHEROO_IGD``h]j)}(hj#h]hVGA_SWITCHEROO_IGD}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:49: ./include/linux/vga_switcheroo.hhKXhj#ubj)}(hhh]h)}(hintegrated graphics deviceh]hintegrated graphics device}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hKXhj#ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj#hKXhjz#ubj)}(h0``VGA_SWITCHEROO_DIS`` discrete graphics device h](j)}(h``VGA_SWITCHEROO_DIS``h]j)}(hj#h]hVGA_SWITCHEROO_DIS}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:49: ./include/linux/vga_switcheroo.hhK[hj#ubj)}(hhh]h)}(hdiscrete graphics deviceh]hdiscrete graphics device}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj $hK[hj $ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj $hK[hjz#ubj)}(hL``VGA_SWITCHEROO_MAX_CLIENTS`` currently no more than two GPUs are supportedh](j)}(h``VGA_SWITCHEROO_MAX_CLIENTS``h]j)}(hj/$h]hVGA_SWITCHEROO_MAX_CLIENTS}(hj1$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj-$ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:49: ./include/linux/vga_switcheroo.hhK]hj)$ubj)}(hhh]h)}(h-currently no more than two GPUs are supportedh]h-currently no more than two GPUs are supported}(hjH$hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:49: ./include/linux/vga_switcheroo.hhK^hjE$ubah}(h]h ]h"]h$]h&]uh1jhj)$ubeh}(h]h ]h"]h$]h&]uh1jhjD$hK]hjz#ubeh}(h]h ]h"]h$]h&]uh1jhj^#ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj!hhhj"hNubh)}(h**Description**h]j)}(hjr$h]h Description}(hjt$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp$ubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:49: ./include/linux/vga_switcheroo.hhK`hj!hhubh)}(hAClient identifier. Audio clients use the same identifier & 0x100.h]hAClient identifier. Audio clients use the same identifier & 0x100.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:49: ./include/linux/vga_switcheroo.hhKShj!hhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'vga_switcheroo_state (C enum)c.vga_switcheroo_statehNtauh1jhj!hhha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:52: ./include/linux/vga_switcheroo.hhNubj,)}(hhh](j1)}(hvga_switcheroo_stateh]j7)}(henum vga_switcheroo_stateh](j)}(hj,h]henum}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$hhha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:52: ./include/linux/vga_switcheroo.hhKubjO)}(h h]h }(hj$hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj$hhhj$hKubj`)}(hvga_switcheroo_stateh]jf)}(hj$h]hvga_switcheroo_state}(hj$hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj$ubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hj$hhhj$hKubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhj$hhhj$hKubah}(h]j$ah ](jjeh"]h$]h&]jj)jhuh1j0hj$hKhj$hhubj)}(hhh]h)}(hclient power stateh]hclient power state}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:52: ./include/linux/vga_switcheroo.hhK;hj$hhubah}(h]h ]h"]h$]h&]uh1jhj$hhhj$hKubeh}(h]h ](jenumeh"]h$]h&]jjjj %jj %jjjuh1j+hhhj!hj$hNubj)}(h**Constants** ``VGA_SWITCHEROO_OFF`` off ``VGA_SWITCHEROO_ON`` on ``VGA_SWITCHEROO_NOT_FOUND`` client has not registered with vga_switcheroo. Only used in vga_switcheroo_get_client_state() which in turn is only called from hda_intel.ch](h)}(h **Constants**h]j)}(hj%h]h Constants}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:52: ./include/linux/vga_switcheroo.hhK?hj%ubj)}(hhh](j)}(h``VGA_SWITCHEROO_OFF`` off h](j)}(h``VGA_SWITCHEROO_OFF``h]j)}(hj4%h]hVGA_SWITCHEROO_OFF}(hj6%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2%ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:52: ./include/linux/vga_switcheroo.hhKBhj.%ubj)}(hhh]h)}(hoffh]hoff}(hjM%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjI%hKBhjJ%ubah}(h]h ]h"]h$]h&]uh1jhj.%ubeh}(h]h ]h"]h$]h&]uh1jhjI%hKBhj+%ubj)}(h``VGA_SWITCHEROO_ON`` on h](j)}(h``VGA_SWITCHEROO_ON``h]j)}(hjm%h]hVGA_SWITCHEROO_ON}(hjo%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjk%ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:52: ./include/linux/vga_switcheroo.hhKEhjg%ubj)}(hhh]h)}(honh]hon}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj%hKEhj%ubah}(h]h ]h"]h$]h&]uh1jhjg%ubeh}(h]h ]h"]h$]h&]uh1jhj%hKEhj+%ubj)}(h``VGA_SWITCHEROO_NOT_FOUND`` client has not registered with vga_switcheroo. Only used in vga_switcheroo_get_client_state() which in turn is only called from hda_intel.ch](j)}(h``VGA_SWITCHEROO_NOT_FOUND``h]j)}(hj%h]hVGA_SWITCHEROO_NOT_FOUND}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1jha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:52: ./include/linux/vga_switcheroo.hhKIhj%ubj)}(hhh]h)}(hclient has not registered with vga_switcheroo. Only used in vga_switcheroo_get_client_state() which in turn is only called from hda_intel.ch]hclient has not registered with vga_switcheroo. Only used in vga_switcheroo_get_client_state() which in turn is only called from hda_intel.c}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:52: ./include/linux/vga_switcheroo.hhKHhj%ubah}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]uh1jhj%hKIhj+%ubeh}(h]h ]h"]h$]h&]uh1jhj%ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj!hhhj$hNubh)}(h**Description**h]j)}(hj%h]h Description}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:52: ./include/linux/vga_switcheroo.hhKLhj!hhubh)}(hClient power state.h]hClient power state.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hha/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:52: ./include/linux/vga_switcheroo.hhKAhj!hhubeh}(h]public-constantsah ]h"]public constantsah$]h&]uh1hhjhhhhhK,ubh)}(hhh](h)}(hPrivate structuresh]hPrivate structures}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hhhhhK8ubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'vgasr_priv (C struct) c.vgasr_privhNtauh1jhj&hhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chNubj,)}(hhh](j1)}(h vgasr_privh]j7)}(hstruct vgasr_privh](j)}(hjh]hstruct}(hjA&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=&hhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKubjO)}(h h]h }(hjO&hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj=&hhhjN&hKubj`)}(h vgasr_privh]jf)}(hj;&h]h vgasr_priv}(hja&hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj]&ubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hj=&hhhjN&hKubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhj9&hhhjN&hKubah}(h]j3&ah ](jjeh"]h$]h&]jj)jhuh1j0hjN&hKhj6&hhubj)}(hhh]h)}(hvga_switcheroo private datah]hvga_switcheroo private data}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj&hhubah}(h]h ]h"]h$]h&]uh1jhj6&hhhjN&hKubeh}(h]h ](jstructeh"]h$]h&]jjjj&jj&jjjuh1j+hhhj&hj5&hNubj)}(hXu**Definition**:: struct vgasr_priv { bool active; bool delayed_switch_active; enum vga_switcheroo_client_id delayed_client_id; struct dentry *debugfs_root; int registered_clients; struct list_head clients; const struct vga_switcheroo_handler *handler; enum vga_switcheroo_handler_flags_t handler_flags; struct mutex mux_hw_lock; int old_ddc_owner; }; **Members** ``active`` whether vga_switcheroo is enabled. Prerequisite is the registration of two GPUs and a handler ``delayed_switch_active`` whether a delayed switch is pending ``delayed_client_id`` client to which a delayed switch is pending ``debugfs_root`` directory for vga_switcheroo debugfs interface ``registered_clients`` number of registered GPUs (counting only vga clients, not audio clients) ``clients`` list of registered clients ``handler`` registered handler ``handler_flags`` flags of registered handler ``mux_hw_lock`` protects mux state (in particular while DDC lines are temporarily switched) ``old_ddc_owner`` client to which DDC lines will be switched back on unlockh](h)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubh:}(hj&hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj&ubj)}(hXustruct vgasr_priv { bool active; bool delayed_switch_active; enum vga_switcheroo_client_id delayed_client_id; struct dentry *debugfs_root; int registered_clients; struct list_head clients; const struct vga_switcheroo_handler *handler; enum vga_switcheroo_handler_flags_t handler_flags; struct mutex mux_hw_lock; int old_ddc_owner; };h]hXustruct vgasr_priv { bool active; bool delayed_switch_active; enum vga_switcheroo_client_id delayed_client_id; struct dentry *debugfs_root; int registered_clients; struct list_head clients; const struct vga_switcheroo_handler *handler; enum vga_switcheroo_handler_flags_t handler_flags; struct mutex mux_hw_lock; int old_ddc_owner; };}hj&sbah}(h]h ]h"]h$]h&]j~juh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj&ubh)}(h **Members**h]j)}(hj&h]hMembers}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj&ubj)}(hhh](j)}(hi``active`` whether vga_switcheroo is enabled. Prerequisite is the registration of two GPUs and a handler h](j)}(h ``active``h]j)}(hj&h]hactive}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj&ubj)}(hhh]h)}(h]whether vga_switcheroo is enabled. Prerequisite is the registration of two GPUs and a handlerh]h]whether vga_switcheroo is enabled. Prerequisite is the registration of two GPUs and a handler}(hj 'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj'ubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhj'hKhj&ubj)}(h>``delayed_switch_active`` whether a delayed switch is pending h](j)}(h``delayed_switch_active``h]j)}(hj*'h]hdelayed_switch_active}(hj,'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj('ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj$'ubj)}(hhh]h)}(h#whether a delayed switch is pendingh]h#whether a delayed switch is pending}(hjC'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj?'hKhj@'ubah}(h]h ]h"]h$]h&]uh1jhj$'ubeh}(h]h ]h"]h$]h&]uh1jhj?'hKhj&ubj)}(hB``delayed_client_id`` client to which a delayed switch is pending h](j)}(h``delayed_client_id``h]j)}(hjc'h]hdelayed_client_id}(hje'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhja'ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj]'ubj)}(hhh]h)}(h+client to which a delayed switch is pendingh]h+client to which a delayed switch is pending}(hj|'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjx'hKhjy'ubah}(h]h ]h"]h$]h&]uh1jhj]'ubeh}(h]h ]h"]h$]h&]uh1jhjx'hKhj&ubj)}(h@``debugfs_root`` directory for vga_switcheroo debugfs interface h](j)}(h``debugfs_root``h]j)}(hj'h]h debugfs_root}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj'ubj)}(hhh]h)}(h.directory for vga_switcheroo debugfs interfaceh]h.directory for vga_switcheroo debugfs interface}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hKhj'ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj'hKhj&ubj)}(h```registered_clients`` number of registered GPUs (counting only vga clients, not audio clients) h](j)}(h``registered_clients``h]j)}(hj'h]hregistered_clients}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj'ubj)}(hhh]h)}(hHnumber of registered GPUs (counting only vga clients, not audio clients)h]hHnumber of registered GPUs (counting only vga clients, not audio clients)}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj'ubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhj'hKhj&ubj)}(h'``clients`` list of registered clients h](j)}(h ``clients``h]j)}(hj(h]hclients}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj (ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj (ubj)}(hhh]h)}(hlist of registered clientsh]hlist of registered clients}(hj((hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$(hKhj%(ubah}(h]h ]h"]h$]h&]uh1jhj (ubeh}(h]h ]h"]h$]h&]uh1jhj$(hKhj&ubj)}(h``handler`` registered handler h](j)}(h ``handler``h]j)}(hjH(h]hhandler}(hjJ(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjF(ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhjB(ubj)}(hhh]h)}(hregistered handlerh]hregistered handler}(hja(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj](hKhj^(ubah}(h]h ]h"]h$]h&]uh1jhjB(ubeh}(h]h ]h"]h$]h&]uh1jhj](hKhj&ubj)}(h.``handler_flags`` flags of registered handler h](j)}(h``handler_flags``h]j)}(hj(h]h handler_flags}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj{(ubj)}(hhh]h)}(hflags of registered handlerh]hflags of registered handler}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hKhj(ubah}(h]h ]h"]h$]h&]uh1jhj{(ubeh}(h]h ]h"]h$]h&]uh1jhj(hKhj&ubj)}(h\``mux_hw_lock`` protects mux state (in particular while DDC lines are temporarily switched) h](j)}(h``mux_hw_lock``h]j)}(hj(h]h mux_hw_lock}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj(ubj)}(hhh]h)}(hKprotects mux state (in particular while DDC lines are temporarily switched)h]hKprotects mux state (in particular while DDC lines are temporarily switched)}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj(hKhj&ubj)}(hK``old_ddc_owner`` client to which DDC lines will be switched back on unlockh](j)}(h``old_ddc_owner``h]j)}(hj(h]h old_ddc_owner}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj(ubj)}(hhh]h)}(h9client to which DDC lines will be switched back on unlockh]h9client to which DDC lines will be switched back on unlock}(hj )hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj )ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj )hKhj&ubeh}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj&hhhj5&hNubh)}(h**Description**h]j)}(hj7)h]h Description}(hj9)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj5)ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj&hhubh)}(h`vga_switcheroo private data. Currently only one vga_switcheroo instance per system is supported.h]h`vga_switcheroo private data. Currently only one vga_switcheroo instance per system is supported.}(hjM)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:58: ./drivers/gpu/vga/vga_switcheroo.chKhj&hhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j' vga_switcheroo_client (C struct)c.vga_switcheroo_clienthNtauh1jhj&hhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chNubj,)}(hhh](j1)}(hvga_switcheroo_clienth]j7)}(hstruct vga_switcheroo_clienth](j)}(hjh]hstruct}(hjv)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjr)hhhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKubjO)}(h h]h }(hj)hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjr)hhhj)hKubj`)}(hvga_switcheroo_clienth]jf)}(hjp)h]hvga_switcheroo_client}(hj)hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj)ubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hjr)hhhj)hKubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhjn)hhhj)hKubah}(h]jh)ah ](jjeh"]h$]h&]jj)jhuh1j0hj)hKhjk)hhubj)}(hhh]h)}(hregistered clienth]hregistered client}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chK[hj)hhubah}(h]h ]h"]h$]h&]uh1jhjk)hhhj)hKubeh}(h]h ](jstructeh"]h$]h&]jjjj)jj)jjjuh1j+hhhj&hjj)hNubj)}(hX**Definition**:: struct vga_switcheroo_client { struct pci_dev *pdev; struct fb_info *fb_info; enum vga_switcheroo_state pwr_state; const struct vga_switcheroo_client_ops *ops; enum vga_switcheroo_client_id id; bool active; bool driver_power_control; struct list_head list; struct pci_dev *vga_dev; }; **Members** ``pdev`` client pci device ``fb_info`` framebuffer to which console is remapped on switching ``pwr_state`` current power state if manual power control is used. For driver power control, call vga_switcheroo_pwr_state(). ``ops`` client callbacks ``id`` client identifier. Determining the id requires the handler, so gpus are initially assigned VGA_SWITCHEROO_UNKNOWN_ID and later given their true id in vga_switcheroo_enable() ``active`` whether the outputs are currently switched to this client ``driver_power_control`` whether power state is controlled by the driver's runtime pm. If true, writing ON and OFF to the vga_switcheroo debugfs interface is a no-op so as not to interfere with runtime pm ``list`` client list ``vga_dev`` pci device, indicate which GPU is bound to current audio clienth](h)}(h**Definition**::h](j)}(h**Definition**h]h Definition}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubh:}(hj)hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chK_hj)ubj)}(hX@struct vga_switcheroo_client { struct pci_dev *pdev; struct fb_info *fb_info; enum vga_switcheroo_state pwr_state; const struct vga_switcheroo_client_ops *ops; enum vga_switcheroo_client_id id; bool active; bool driver_power_control; struct list_head list; struct pci_dev *vga_dev; };h]hX@struct vga_switcheroo_client { struct pci_dev *pdev; struct fb_info *fb_info; enum vga_switcheroo_state pwr_state; const struct vga_switcheroo_client_ops *ops; enum vga_switcheroo_client_id id; bool active; bool driver_power_control; struct list_head list; struct pci_dev *vga_dev; };}hj)sbah}(h]h ]h"]h$]h&]j~juh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKahj)ubh)}(h **Members**h]j)}(hj*h]hMembers}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKmhj)ubj)}(hhh](j)}(h``pdev`` client pci device h](j)}(h``pdev``h]j)}(hj%*h]hpdev}(hj'*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#*ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chK]hj*ubj)}(hhh]h)}(hclient pci deviceh]hclient pci device}(hj>*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:*hK]hj;*ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhj:*hK]hj*ubj)}(hB``fb_info`` framebuffer to which console is remapped on switching h](j)}(h ``fb_info``h]j)}(hj^*h]hfb_info}(hj`*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj\*ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chK^hjX*ubj)}(hhh]h)}(h5framebuffer to which console is remapped on switchingh]h5framebuffer to which console is remapped on switching}(hjw*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjs*hK^hjt*ubah}(h]h ]h"]h$]h&]uh1jhjX*ubeh}(h]h ]h"]h$]h&]uh1jhjs*hK^hj*ubj)}(h~``pwr_state`` current power state if manual power control is used. For driver power control, call vga_switcheroo_pwr_state(). h](j)}(h ``pwr_state``h]j)}(hj*h]h pwr_state}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chK`hj*ubj)}(hhh]h)}(hocurrent power state if manual power control is used. For driver power control, call vga_switcheroo_pwr_state().h]hocurrent power state if manual power control is used. For driver power control, call vga_switcheroo_pwr_state().}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chK_hj*ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhj*hK`hj*ubj)}(h``ops`` client callbacks h](j)}(h``ops``h]j)}(hj*h]hops}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKahj*ubj)}(hhh]h)}(hclient callbacksh]hclient callbacks}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hKahj*ubah}(h]h ]h"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]uh1jhj*hKahj*ubj)}(h``id`` client identifier. Determining the id requires the handler, so gpus are initially assigned VGA_SWITCHEROO_UNKNOWN_ID and later given their true id in vga_switcheroo_enable() h](j)}(h``id``h]j)}(hj +h]hid}(hj +hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKdhj+ubj)}(hhh]h)}(hclient identifier. Determining the id requires the handler, so gpus are initially assigned VGA_SWITCHEROO_UNKNOWN_ID and later given their true id in vga_switcheroo_enable()h]hclient identifier. Determining the id requires the handler, so gpus are initially assigned VGA_SWITCHEROO_UNKNOWN_ID and later given their true id in vga_switcheroo_enable()}(hj#+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKbhj +ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhj+hKdhj*ubj)}(hE``active`` whether the outputs are currently switched to this client h](j)}(h ``active``h]j)}(hjD+h]hactive}(hjF+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjB+ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKehj>+ubj)}(hhh]h)}(h9whether the outputs are currently switched to this clienth]h9whether the outputs are currently switched to this client}(hj]+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjY+hKehjZ+ubah}(h]h ]h"]h$]h&]uh1jhj>+ubeh}(h]h ]h"]h$]h&]uh1jhjY+hKehj*ubj)}(h``driver_power_control`` whether power state is controlled by the driver's runtime pm. If true, writing ON and OFF to the vga_switcheroo debugfs interface is a no-op so as not to interfere with runtime pm h](j)}(h``driver_power_control``h]j)}(hj}+h]hdriver_power_control}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{+ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKhhjw+ubj)}(hhh]h)}(hwhether power state is controlled by the driver's runtime pm. If true, writing ON and OFF to the vga_switcheroo debugfs interface is a no-op so as not to interfere with runtime pmh]hwhether power state is controlled by the driver’s runtime pm. If true, writing ON and OFF to the vga_switcheroo debugfs interface is a no-op so as not to interfere with runtime pm}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKfhj+ubah}(h]h ]h"]h$]h&]uh1jhjw+ubeh}(h]h ]h"]h$]h&]uh1jhj+hKhhj*ubj)}(h``list`` client list h](j)}(h``list``h]j)}(hj+h]hlist}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKihj+ubj)}(hhh]h)}(h client listh]h client list}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+hKihj+ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhj+hKihj*ubj)}(hK``vga_dev`` pci device, indicate which GPU is bound to current audio clienth](j)}(h ``vga_dev``h]j)}(hj+h]hvga_dev}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKihj+ubj)}(hhh]h)}(h?pci device, indicate which GPU is bound to current audio clienth]h?pci device, indicate which GPU is bound to current audio client}(hj ,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKjhj,ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhj,hKihj*ubeh}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj&hhhjj)hNubh)}(h**Description**h]j)}(hj3,h]h Description}(hj5,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1,ubah}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKmhj&hhubh)}(hRegistered client. A client can be either a GPU or an audio device on a GPU. For audio clients, the **fb_info** and **active** members are bogus. For GPU clients, the **vga_dev** is bogus.h](hdRegistered client. A client can be either a GPU or an audio device on a GPU. For audio clients, the }(hjI,hhhNhNubj)}(h **fb_info**h]hfb_info}(hjQ,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjI,ubh and }(hjI,hhhNhNubj)}(h **active**h]hactive}(hjc,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjI,ubh) members are bogus. For GPU clients, the }(hjI,hhhNhNubj)}(h **vga_dev**h]hvga_dev}(hju,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjI,ubh is bogus.}(hjI,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhc/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:61: ./drivers/gpu/vga/vga_switcheroo.chKjhj&hhubeh}(h]private-structuresah ]h"]private structuresah$]h&]uh1hhjhhhhhK8ubeh}(h]apiah ]h"]apiah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hHandlersh]hHandlers}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hhhhhKAubh)}(hhh](h)}(happle-gmux Handlerh]happle-gmux Handler}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hhhhhKDubh)}(hgmux is a microcontroller built into the MacBook Pro to support dual GPUs: A `Lattice XP2`_ on pre-retinas, a `Renesas R4F2113`_ on pre-T2 retinas.h](hMgmux is a microcontroller built into the MacBook Pro to support dual GPUs: A }(hj,hhhNhNubj)}(h`Lattice XP2`_h]h Lattice XP2}(hj,hhhNhNubah}(h]h ]h"]h$]h&]name Lattice XP2refuriBhttp://www.latticesemi.com/en/Products/FPGAandCPLD/LatticeXP2.aspxuh1jhj,resolvedKubh on pre-retinas, a }(hj,hhhNhNubj)}(h`Renesas R4F2113`_h]hRenesas R4F2113}(hj,hhhNhNubah}(h]h ]h"]h$]h&]nameRenesas R4F2113j,Dhttp://www.renesas.com/products/mpumcu/h8s/h8s2100/h8s2113/index.jspuh1jhj,j,Kubh on pre-T2 retinas.}(hj,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:70: ./drivers/platform/x86/apple-gmux.chKhj,hhubh)}(hXoOn T2 Macbooks, the gmux is part of the T2 Coprocessor's SMC. The SMC has an I2C connection to a `NXP PCAL6524` GPIO expander, which enables/disables the voltage regulators of the discrete GPU, drives the display panel power, and has a GPIO to switch the eDP mux. The Intel CPU can interact with gmux through MMIO, similar to how the main SMC interface is controlled.h](hcOn T2 Macbooks, the gmux is part of the T2 Coprocessor’s SMC. The SMC has an I2C connection to a }(hj,hhhNhNubhtitle_reference)}(h`NXP PCAL6524`h]h NXP PCAL6524}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1j-hj,ubhX GPIO expander, which enables/disables the voltage regulators of the discrete GPU, drives the display panel power, and has a GPIO to switch the eDP mux. The Intel CPU can interact with gmux through MMIO, similar to how the main SMC interface is controlled.}(hj,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:70: ./drivers/platform/x86/apple-gmux.chK hj,hhubh)}(ho(The MacPro6,1 2013 also has a gmux, however it is unclear why since it has dual GPUs but no built-in display.)h]ho(The MacPro6,1 2013 also has a gmux, however it is unclear why since it has dual GPUs but no built-in display.)}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:70: ./drivers/platform/x86/apple-gmux.chK&hj,hhubh)}(hX+gmux is connected to the LPC bus of the southbridge. Its I/O ports are accessed differently depending on the microcontroller: Driver functions to access a pre-retina gmux are infixed ``_pio_``, those for a pre-T2 retina gmux are infixed ``_index_``, and those on T2 Macs are infixed with ``_mmio_``.h](hgmux is connected to the LPC bus of the southbridge. Its I/O ports are accessed differently depending on the microcontroller: Driver functions to access a pre-retina gmux are infixed }(hj--hhhNhNubj)}(h ``_pio_``h]h_pio_}(hj5-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj--ubh-, those for a pre-T2 retina gmux are infixed }(hj--hhhNhNubj)}(h ``_index_``h]h_index_}(hjG-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj--ubh(, and those on T2 Macs are infixed with }(hj--hhhNhNubj)}(h ``_mmio_``h]h_mmio_}(hjY-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj--ubh.}(hj--hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:70: ./drivers/platform/x86/apple-gmux.chK)hj,hhubh)}(hW.. _Lattice XP2: http://www.latticesemi.com/en/Products/FPGAandCPLD/LatticeXP2.aspxh]h}(h] lattice-xp2ah ]h"] lattice xp2ah$]h&]j,j,uh1hhKhj,hhhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:70: ./drivers/platform/x86/apple-gmux.cjKubh)}(h].. _Renesas R4F2113: http://www.renesas.com/products/mpumcu/h8s/h8s2100/h8s2113/index.jsph]h}(h]renesas-r4f2113ah ]h"]renesas r4f2113ah$]h&]j,j,uh1hhKhj,hhhj~-jKubh)}(hI.. _NXP PCAL6524: https://www.nxp.com/docs/en/data-sheet/PCAL6524.pdfh]h}(h] nxp-pcal6524ah ]h"] nxp pcal6524ah$]h&]j,3https://www.nxp.com/docs/en/data-sheet/PCAL6524.pdfuh1hhKhj,hhhj~-ubh)}(hX!gmux is also connected to a GPIO pin of the southbridge and thereby is able to trigger an ACPI GPE. ACPI name GMGP holds this GPIO pin's number. On the MBP5 2008/09 it's GPIO pin 22 of the Nvidia MCP79, on following generations it's GPIO pin 6 of the Intel PCH, on MMIO gmux's it's pin 21.h]hX+gmux is also connected to a GPIO pin of the southbridge and thereby is able to trigger an ACPI GPE. ACPI name GMGP holds this GPIO pin’s number. On the MBP5 2008/09 it’s GPIO pin 22 of the Nvidia MCP79, on following generations it’s GPIO pin 6 of the Intel PCH, on MMIO gmux’s it’s pin 21.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:73: ./drivers/platform/x86/apple-gmux.chMbhj,hhubh)}(huThe GPE merely signals that an interrupt occurred, the actual type of event is identified by reading a gmux register.h]huThe GPE merely signals that an interrupt occurred, the actual type of event is identified by reading a gmux register.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:73: ./drivers/platform/x86/apple-gmux.chMghj,hhubh)}(hXIn addition to the GMGP name, gmux's ACPI device also has two methods GMSP and GMLV. GMLV likely means "GMUX Level", and reads the value of the GPIO, while GMSP likely means "GMUX Set Polarity", and seems to write to the GPIO's value. On newer Macbooks (This was introduced with or sometime before the MacBookPro14,3), the ACPI GPE method differentiates between the OS type: On Darwin, only a notification is signaled, whereas on other OSes, the GPIO's value is read and then inverted.h]hXIn addition to the GMGP name, gmux’s ACPI device also has two methods GMSP and GMLV. GMLV likely means “GMUX Level”, and reads the value of the GPIO, while GMSP likely means “GMUX Set Polarity”, and seems to write to the GPIO’s value. On newer Macbooks (This was introduced with or sometime before the MacBookPro14,3), the ACPI GPE method differentiates between the OS type: On Darwin, only a notification is signaled, whereas on other OSes, the GPIO’s value is read and then inverted.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:73: ./drivers/platform/x86/apple-gmux.chMjhj,hhubh)}(hX1Because Linux masquerades as Darwin, it ends up in the notification-only code path. On MMIO gmux's, this seems to lead to us being unable to clear interrupts, unless we call GMSP(0). Without this, there is a flood of status=0 interrupts that can't be cleared. This issue seems to be unique to MMIO gmux's.h]hX7Because Linux masquerades as Darwin, it ends up in the notification-only code path. On MMIO gmux’s, this seems to lead to us being unable to clear interrupts, unless we call GMSP(0). Without this, there is a flood of status=0 interrupts that can’t be cleared. This issue seems to be unique to MMIO gmux’s.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:73: ./drivers/platform/x86/apple-gmux.chMrhj,hhubh)}(hhh](h)}(h Graphics muxh]h Graphics mux}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hhhhhKMubh)}(hX[On pre-retinas, the LVDS outputs of both GPUs feed into gmux which muxes either of them to the panel. One of the tricks gmux has up its sleeve is to lengthen the blanking interval of its output during a switch to synchronize it with the GPU switched to. This allows for a flicker-free switch that is imperceptible by the user (`US 8,687,007 B2`_).h](hXGOn pre-retinas, the LVDS outputs of both GPUs feed into gmux which muxes either of them to the panel. One of the tricks gmux has up its sleeve is to lengthen the blanking interval of its output during a switch to synchronize it with the GPU switched to. This allows for a flicker-free switch that is imperceptible by the user (}(hj-hhhNhNubj)}(h`US 8,687,007 B2`_h]hUS 8,687,007 B2}(hj-hhhNhNubah}(h]h ]h"]h$]h&]nameUS 8,687,007 B2j,0https://pimg-fpiw.uspto.gov/fdd/07/870/086/0.pdfuh1jhj-j,Kubh).}(hj-hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:79: ./drivers/platform/x86/apple-gmux.chMhhj-hhubh)}(hXHOn retinas, muxing is no longer done by gmux itself, but by a separate chip which is controlled by gmux. The chip is triple sourced, it is either an `NXP CBTL06142`_, `TI HD3SS212`_ or `Pericom PI3VDP12412`_. The panel is driven with eDP instead of LVDS since the pixel clock required for retina resolution exceeds LVDS' limits.h](hOn retinas, muxing is no longer done by gmux itself, but by a separate chip which is controlled by gmux. The chip is triple sourced, it is either an }(hj .hhhNhNubj)}(h`NXP CBTL06142`_h]h NXP CBTL06142}(hj.hhhNhNubah}(h]h ]h"]h$]h&]name NXP CBTL06142j,6https://www.nxp.com/documents/data_sheet/CBTL06141.pdfuh1jhj .j,Kubh, }(hj .hhhNhNubj)}(h`TI HD3SS212`_h]h TI HD3SS212}(hj&.hhhNhNubah}(h]h ]h"]h$]h&]name TI HD3SS212j,.https://www.ti.com/lit/ds/symlink/hd3ss212.pdfuh1jhj .j,Kubh or }(hj .hhhNhNubj)}(h`Pericom PI3VDP12412`_h]hPericom PI3VDP12412}(hj;.hhhNhNubah}(h]h ]h"]h$]h&]namePericom PI3VDP12412j,9https://www.pericom.com/assets/Datasheets/PI3VDP12412.pdfuh1jhj .j,Kubh{. The panel is driven with eDP instead of LVDS since the pixel clock required for retina resolution exceeds LVDS’ limits.}(hj .hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:79: ./drivers/platform/x86/apple-gmux.chMnhj-hhubh)}(hXuPre-retinas are able to switch the panel's DDC pins separately. This is handled by a `TI SN74LV4066A`_ which is controlled by gmux. The inactive GPU can thus probe the panel's EDID without switching over the entire panel. Retinas lack this functionality as the chips used for eDP muxing are incapable of switching the AUX channel separately (see the linked data sheets, Pericom would be capable but this is unused). However the retina panel has the NO_AUX_HANDSHAKE_LINK_TRAINING bit set in its DPCD, allowing the inactive GPU to skip the AUX handshake and set up the output with link parameters pre-calibrated by the active GPU.h](hWPre-retinas are able to switch the panel’s DDC pins separately. This is handled by a }(hjW.hhhNhNubj)}(h`TI SN74LV4066A`_h]hTI SN74LV4066A}(hj_.hhhNhNubah}(h]h ]h"]h$]h&]nameTI SN74LV4066Aj,1https://www.ti.com/lit/ds/symlink/sn74lv4066a.pdfuh1jhjW.j,KubhX which is controlled by gmux. The inactive GPU can thus probe the panel’s EDID without switching over the entire panel. Retinas lack this functionality as the chips used for eDP muxing are incapable of switching the AUX channel separately (see the linked data sheets, Pericom would be capable but this is unused). However the retina panel has the NO_AUX_HANDSHAKE_LINK_TRAINING bit set in its DPCD, allowing the inactive GPU to skip the AUX handshake and set up the output with link parameters pre-calibrated by the active GPU.}(hjW.hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:79: ./drivers/platform/x86/apple-gmux.chMthj-hhubh)}(hX$The external DP port is only fully switchable on the first two unibody MacBook Pro generations, MBP5 2008/09 and MBP6 2010. This is done by an `NXP CBTL06141`_ which is controlled by gmux. It's the predecessor of the eDP mux on retinas, the difference being support for 2.7 versus 5.4 Gbit/s.h](hThe external DP port is only fully switchable on the first two unibody MacBook Pro generations, MBP5 2008/09 and MBP6 2010. This is done by an }(hj{.hhhNhNubj)}(h`NXP CBTL06141`_h]h NXP CBTL06141}(hj.hhhNhNubah}(h]h ]h"]h$]h&]name NXP CBTL06141j,6https://www.nxp.com/documents/data_sheet/CBTL06141.pdfuh1jhj{.j,Kubh which is controlled by gmux. It’s the predecessor of the eDP mux on retinas, the difference being support for 2.7 versus 5.4 Gbit/s.}(hj{.hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:79: ./drivers/platform/x86/apple-gmux.chM~hj-hhubh)}(hXAThe following MacBook Pro generations replaced the external DP port with a combined DP/Thunderbolt port and lost the ability to switch it between GPUs, connecting it either to the discrete GPU or the Thunderbolt controller. Oddly enough, while the full port is no longer switchable, AUX and HPD are still switchable by way of an `NXP CBTL03062`_ (on pre-retinas MBP8 2011 and MBP9 2012) or two `TI TS3DS10224`_ (on pre-t2 retinas) under the control of gmux. Since the integrated GPU is missing the main link, external displays appear to it as phantoms which fail to link-train.h](hXIThe following MacBook Pro generations replaced the external DP port with a combined DP/Thunderbolt port and lost the ability to switch it between GPUs, connecting it either to the discrete GPU or the Thunderbolt controller. Oddly enough, while the full port is no longer switchable, AUX and HPD are still switchable by way of an }(hj.hhhNhNubj)}(h`NXP CBTL03062`_h]h NXP CBTL03062}(hj.hhhNhNubah}(h]h ]h"]h$]h&]name NXP CBTL03062j,Nhttp://pdf.datasheetarchive.com/indexerfiles/Datasheets-SW16/DSASW00308511.pdfuh1jhj.j,Kubh1 (on pre-retinas MBP8 2011 and MBP9 2012) or two }(hj.hhhNhNubj)}(h`TI TS3DS10224`_h]h TI TS3DS10224}(hj.hhhNhNubah}(h]h ]h"]h$]h&]name TI TS3DS10224j,0https://www.ti.com/lit/ds/symlink/ts3ds10224.pdfuh1jhj.j,Kubh (on pre-t2 retinas) under the control of gmux. Since the integrated GPU is missing the main link, external displays appear to it as phantoms which fail to link-train.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:79: ./drivers/platform/x86/apple-gmux.chMhj-hhubh)}(hXgmux receives the HPD signal of all display connectors and sends an interrupt on hotplug. On generations which cannot switch external ports, the discrete GPU can then be woken to drive the newly connected display. The ability to switch AUX on these generations could be used to improve reliability of hotplug detection by having the integrated GPU poll the ports while the discrete GPU is asleep, but currently we do not make use of this feature.h]hXgmux receives the HPD signal of all display connectors and sends an interrupt on hotplug. On generations which cannot switch external ports, the discrete GPU can then be woken to drive the newly connected display. The ability to switch AUX on these generations could be used to improve reliability of hotplug detection by having the integrated GPU poll the ports while the discrete GPU is asleep, but currently we do not make use of this feature.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:79: ./drivers/platform/x86/apple-gmux.chMhj-hhubh)}(hXrOur switching policy for the external port is that on those generations which are able to switch it fully, the port is switched together with the panel when IGD / DIS commands are issued to vga_switcheroo. It is thus possible to drive e.g. a beamer on battery power with the integrated GPU. The user may manually switch to the discrete GPU if more performance is needed.h]hXrOur switching policy for the external port is that on those generations which are able to switch it fully, the port is switched together with the panel when IGD / DIS commands are issued to vga_switcheroo. It is thus possible to drive e.g. a beamer on battery power with the integrated GPU. The user may manually switch to the discrete GPU if more performance is needed.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:79: ./drivers/platform/x86/apple-gmux.chMhj-hhubh)}(hXMOn all newer generations, the external port can only be driven by the discrete GPU. If a display is plugged in while the panel is switched to the integrated GPU, *both* GPUs will be in use for maximum performance. To decrease power consumption, the user may manually switch to the discrete GPU, thereby suspending the integrated GPU.h](hOn all newer generations, the external port can only be driven by the discrete GPU. If a display is plugged in while the panel is switched to the integrated GPU, }(hj.hhhNhNubhemphasis)}(h*both*h]hboth}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1j.hj.ubh GPUs will be in use for maximum performance. To decrease power consumption, the user may manually switch to the discrete GPU, thereby suspending the integrated GPU.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:79: ./drivers/platform/x86/apple-gmux.chMhj-hhubh)}(hX<gmux' initial switch state on bootup is user configurable via the EFI variable ``gpu-power-prefs-fa4ce28d-b62f-4c99-9cc3-6815686e30f9`` (5th byte, 1 = IGD, 0 = DIS). Based on this setting, the EFI firmware tells gmux to switch the panel and the external DP connector and allocates a framebuffer for the selected GPU.h](hQgmux’ initial switch state on bootup is user configurable via the EFI variable }(hj/hhhNhNubj)}(h8``gpu-power-prefs-fa4ce28d-b62f-4c99-9cc3-6815686e30f9``h]h4gpu-power-prefs-fa4ce28d-b62f-4c99-9cc3-6815686e30f9}(hj!/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubh (5th byte, 1 = IGD, 0 = DIS). Based on this setting, the EFI firmware tells gmux to switch the panel and the external DP connector and allocates a framebuffer for the selected GPU.}(hj/hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:79: ./drivers/platform/x86/apple-gmux.chMhj-hhubh)}(hE.. _US 8,687,007 B2: https://pimg-fpiw.uspto.gov/fdd/07/870/086/0.pdfh]h}(h]us-8-687-007-b2ah ]h"]us 8,687,007 b2ah$]h&]j,j-uh1hhK@hj-hhhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:79: ./drivers/platform/x86/apple-gmux.cjKubh)}(hK.. _NXP CBTL06141: https://www.nxp.com/documents/data_sheet/CBTL06141.pdfh]h}(h] nxp-cbtl06141ah ]h"] nxp cbtl06141ah$]h&]j,j.uh1hhKAhj-hhhjF/jKubh)}(hK.. _NXP CBTL06142: https://www.nxp.com/documents/data_sheet/CBTL06141.pdfh]h}(h] nxp-cbtl06142ah ]h"] nxp cbtl06142ah$]h&]j,j!.uh1hhKBhj-hhhjF/jKubh)}(hC.. _TI HD3SS212: https://www.ti.com/lit/ds/symlink/hd3ss212.pdfh]h}(h] ti-hd3ss212ah ]h"] ti hd3ss212ah$]h&]j,j6.uh1hhKChj-hhhjF/jKubh)}(hR.. _Pericom PI3VDP12412: https://www.pericom.com/assets/Datasheets/PI3VDP12412.pdfh]h}(h]pericom-pi3vdp12412ah ]h"]pericom pi3vdp12412ah$]h&]j,jK.uh1hhKDhj-hhhjF/jKubh)}(hF.. _TI SN74LV4066A: https://www.ti.com/lit/ds/symlink/sn74lv4066a.pdfh]h}(h]ti-sn74lv4066aah ]h"]ti sn74lv4066aah$]h&]j,jo.uh1hhKEhj-hhhjF/jKubh)}(hc.. _NXP CBTL03062: http://pdf.datasheetarchive.com/indexerfiles/Datasheets-SW16/DSASW00308511.pdfh]h}(h] nxp-cbtl03062ah ]h"] nxp cbtl03062ah$]h&]j,j.uh1hhKFhj-hhhjF/jKubh)}(hE.. _TI TS3DS10224: https://www.ti.com/lit/ds/symlink/ts3ds10224.pdfh]h}(h] ti-ts3ds10224ah ]h"] ti ts3ds10224ah$]h&]j,j.uh1hhKGhj-hhhjF/jKubeh}(h] graphics-muxah ]h"] graphics muxah$]h&]uh1hhj,hhhhhKMubh)}(hhh](h)}(h Power controlh]h Power control}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hhhhhKSubh)}(hgmux is able to cut power to the discrete GPU. It automatically takes care of the correct sequence to tear down and bring up the power rails for core voltage, VRAM and PCIe.h]hgmux is able to cut power to the discrete GPU. It automatically takes care of the correct sequence to tear down and bring up the power rails for core voltage, VRAM and PCIe.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:85: ./drivers/platform/x86/apple-gmux.chMhj/hhubeh}(h] power-controlah ]h"] power controlah$]h&]uh1hhj,hhhhhKSubh)}(hhh](h)}(hBacklight controlh]hBacklight control}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hhhhhKYubh)}(hXOn single GPU MacBooks, the PWM signal for the backlight is generated by the GPU. On dual GPU MacBook Pros by contrast, either GPU may be suspended to conserve energy. Hence the PWM signal needs to be generated by a separate backlight driver which is controlled by gmux. The earliest generation MBP5 2008/09 uses a `TI LP8543`_ backlight driver. Newer models use a `TI LP8545`_ or a TI LP8548.h](hX;On single GPU MacBooks, the PWM signal for the backlight is generated by the GPU. On dual GPU MacBook Pros by contrast, either GPU may be suspended to conserve energy. Hence the PWM signal needs to be generated by a separate backlight driver which is controlled by gmux. The earliest generation MBP5 2008/09 uses a }(hj/hhhNhNubj)}(h `TI LP8543`_h]h TI LP8543}(hj/hhhNhNubah}(h]h ]h"]h$]h&]name TI LP8543j,,https://www.ti.com/lit/ds/symlink/lp8543.pdfuh1jhj/j,Kubh& backlight driver. Newer models use a }(hj/hhhNhNubj)}(h `TI LP8545`_h]h TI LP8545}(hj/hhhNhNubah}(h]h ]h"]h$]h&]name TI LP8545j,,https://www.ti.com/lit/ds/symlink/lp8545.pdfuh1jhj/j,Kubh or a TI LP8548.}(hj/hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:91: ./drivers/platform/x86/apple-gmux.chMChj/hhubh)}(h;.. _TI LP8543: https://www.ti.com/lit/ds/symlink/lp8543.pdfh]h}(h] ti-lp8543ah ]h"] ti lp8543ah$]h&]j,j/uh1hhKhj/hhhd/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:91: ./drivers/platform/x86/apple-gmux.cjKubh)}(h;.. _TI LP8545: https://www.ti.com/lit/ds/symlink/lp8545.pdfh]h}(h] ti-lp8545ah ]h"] ti lp8545ah$]h&]j,j 0uh1hhK hj/hhhj!0jKubeh}(h]backlight-controlah ]h"]backlight controlah$]h&]uh1hhj,hhhhhKYubh)}(hhh](h)}(hPublic functionsh]hPublic functions}(hj90hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj60hhhhhK_ubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'apple_gmux_detect (C function)c.apple_gmux_detecthNtauh1jhj60hhhNhNubj,)}(hhh](j1)}(hPbool apple_gmux_detect (struct pnp_dev *pnp_dev, enum apple_gmux_type *type_ret)h]j7)}(hObool apple_gmux_detect(struct pnp_dev *pnp_dev, enum apple_gmux_type *type_ret)h](j=)}(hj h]hbool}(hj`0hhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hj\0hhh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKVubjO)}(h h]h }(hjn0hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj\0hhhjm0hKVubj`)}(happle_gmux_detecth]jf)}(happle_gmux_detecth]happle_gmux_detect}(hj0hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj|0ubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hj\0hhhjm0hKVubj)}(h9(struct pnp_dev *pnp_dev, enum apple_gmux_type *type_ret)h](j)}(hstruct pnp_dev *pnp_devh](j)}(hjh]hstruct}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubjO)}(h h]h }(hj0hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj0ubh)}(hhh]jf)}(hpnp_devh]hpnp_dev}(hj0hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj0ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj0modnameN classnameNjj)}j]j)}jj0sbc.apple_gmux_detectasbuh1hhj0ubjO)}(h h]h }(hj0hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj0ubj)}(hj)h]h*}(hj0hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj0ubjf)}(hpnp_devh]hpnp_dev}(hj0hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj0ubeh}(h]h ]h"]h$]h&]noemphj~juh1jhj0ubj)}(henum apple_gmux_type *type_reth](j)}(hj,h]henum}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj 1ubjO)}(h h]h }(hj1hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj 1ubh)}(hhh]jf)}(happle_gmux_typeh]happle_gmux_type}(hj,1hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj)1ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj.1modnameN classnameNjj)}j]j0c.apple_gmux_detectasbuh1hhj 1ubjO)}(h h]h }(hjJ1hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj 1ubj)}(hj)h]h*}(hjX1hhhNhNubah}(h]h ]j ah"]h$]h&]uh1jhj 1ubjf)}(htype_reth]htype_ret}(hje1hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj 1ubeh}(h]h ]h"]h$]h&]noemphj~juh1jhj0ubeh}(h]h ]h"]h$]h&]j~juh1jhj\0hhhjm0hKVubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhjX0hhhjm0hKVubah}(h]jS0ah ](jjeh"]h$]h&]jj)jhuh1j0hjm0hKVhjU0hhubj)}(hhh]h)}(h(detect if gmux is built into the machineh]h(detect if gmux is built into the machine}(hj1hhhNhNubah}(h]h ]P5h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKVhj1hhubah}(h]h ]h"]h$]h&]uh1jhjU0hhhjm0hKVubeh}(h]h ](jfunctioneh"]h$]h&]jjjj1jj1jjjuh1j+hhhj60hNhNubj)}(hX**Parameters** ``struct pnp_dev *pnp_dev`` Device to probe or NULL to use the first matching device ``enum apple_gmux_type *type_ret`` Returns (by reference) the apple_gmux_type of the device **Description** Detect if a supported gmux device is present by actually probing it. This avoids the false positives returned on some models by apple_gmux_present(). **Return** ``true`` if a supported gmux ACPI device is detected and the kernel was configured with CONFIG_APPLE_GMUX, ``false`` otherwise.h](h)}(h**Parameters**h]j)}(hj1h]h Parameters}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKZhj1ubj)}(hhh](j)}(hU``struct pnp_dev *pnp_dev`` Device to probe or NULL to use the first matching device h](j)}(h``struct pnp_dev *pnp_dev``h]j)}(hj1h]hstruct pnp_dev *pnp_dev}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj1ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKXhj1ubj)}(hhh]h)}(h8Device to probe or NULL to use the first matching deviceh]h8Device to probe or NULL to use the first matching device}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj1hKXhj1ubah}(h]h ]h"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]uh1jhj1hKXhj1ubj)}(h\``enum apple_gmux_type *type_ret`` Returns (by reference) the apple_gmux_type of the device h](j)}(h"``enum apple_gmux_type *type_ret``h]j)}(hj 2h]henum apple_gmux_type *type_ret}(hj 2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKYhj2ubj)}(hhh]h)}(h8Returns (by reference) the apple_gmux_type of the deviceh]h8Returns (by reference) the apple_gmux_type of the device}(hj"2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2hKYhj2ubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhj2hKYhj1ubeh}(h]h ]h"]h$]h&]uh1jhj1ubh)}(h**Description**h]j)}(hjD2h]h Description}(hjF2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjB2ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhK[hj1ubh)}(hDetect if a supported gmux device is present by actually probing it. This avoids the false positives returned on some models by apple_gmux_present().h]hDetect if a supported gmux device is present by actually probing it. This avoids the false positives returned on some models by apple_gmux_present().}(hjZ2hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKZhj1ubh)}(h **Return**h]j)}(hjk2h]hReturn}(hjm2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhji2ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhK^hj1ubh)}(h``true`` if a supported gmux ACPI device is detected and the kernel was configured with CONFIG_APPLE_GMUX, ``false`` otherwise.h](j)}(h``true``h]htrue}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubhc if a supported gmux ACPI device is detected and the kernel was configured with CONFIG_APPLE_GMUX, }(hj2hhhNhNubj)}(h ``false``h]hfalse}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubh otherwise.}(hj2hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhK_hj1ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj60hhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j'apple_gmux_present (C function)c.apple_gmux_presenthNtauh1jhj60hhhNhNubj,)}(hhh](j1)}(hbool apple_gmux_present (void)h]j7)}(hbool apple_gmux_present(void)h](j=)}(hj h]hbool}(hj2hhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hj2hhh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKubjO)}(h h]h }(hj2hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj2hhhj2hKubj`)}(happle_gmux_presenth]jf)}(happle_gmux_presenth]happle_gmux_present}(hj2hhhNhNubah}(h]h ]jrah"]h$]h&]uh1jehj2ubah}(h]h ](jyjzeh"]h$]h&]j~juh1j_hj2hhhj2hKubj)}(h(void)h]j)}(hvoidh]j=)}(hvoidh]hvoid}(hj 3hhhNhNubah}(h]h ]jIah"]h$]h&]uh1j<hj3ubah}(h]h ]h"]h$]h&]noemphj~juh1jhj3ubah}(h]h ]h"]h$]h&]j~juh1jhj2hhhj2hKubeh}(h]h ]h"]h$]h&]j~jjuh1j6jjhj2hhhj2hKubah}(h]j2ah ](jjeh"]h$]h&]jj)jhuh1j0hj2hKhj2hhubj)}(hhh]h)}(h$check if gmux ACPI device is presenth]h$check if gmux ACPI device is present}(hj63hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKhj33hhubah}(h]h ]h"]h$]h&]uh1jhj2hhhj2hKubeh}(h]h ](jfunctioneh"]h$]h&]jjjjN3jjN3jjjuh1j+hhhj60hNhNubj)}(hXF**Parameters** ``void`` no arguments **Description** Drivers may use this to activate quirks specific to dual GPU MacBook Pros and Mac Pros, e.g. for deferred probing, runtime pm and backlight. **Return** ``true`` if gmux ACPI device is present and the kernel was configured with CONFIG_APPLE_GMUX, ``false`` otherwise.h](h)}(h**Parameters**h]j)}(hjX3h]h Parameters}(hjZ3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjV3ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKhjR3ubj)}(hhh]j)}(h``void`` no arguments h](j)}(h``void``h]j)}(hjw3h]hvoid}(hjy3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhju3ubah}(h]h ]h"]h$]h&]uh1jh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKhjq3ubj)}(hhh]h)}(h no argumentsh]h no arguments}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hKhj3ubah}(h]h ]h"]h$]h&]uh1jhjq3ubeh}(h]h ]h"]h$]h&]uh1jhj3hKhjn3ubah}(h]h ]h"]h$]h&]uh1jhjR3ubh)}(h**Description**h]j)}(hj3h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKhjR3ubh)}(hDrivers may use this to activate quirks specific to dual GPU MacBook Pros and Mac Pros, e.g. for deferred probing, runtime pm and backlight.h]hDrivers may use this to activate quirks specific to dual GPU MacBook Pros and Mac Pros, e.g. for deferred probing, runtime pm and backlight.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKhjR3ubh)}(h **Return**h]j)}(hj3h]hReturn}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKhjR3ubh)}(hr``true`` if gmux ACPI device is present and the kernel was configured with CONFIG_APPLE_GMUX, ``false`` otherwise.h](j)}(h``true``h]htrue}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubhV if gmux ACPI device is present and the kernel was configured with CONFIG_APPLE_GMUX, }(hj3hhhNhNubj)}(h ``false``h]hfalse}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj3ubh otherwise.}(hj3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh]/var/lib/git/docbuild/linux/Documentation/gpu/vga-switcheroo:97: ./include/linux/apple-gmux.hhKhjR3ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhj60hhhNhNubeh}(h]id2ah ]h"]h$]jah&]uh1hhj,hhhhhK_jKubeh}(h]apple-gmux-handlerah ]h"]apple-gmux handlerah$]h&]uh1hhj,hhhhhKDubeh}(h]handlersah ]h"]handlersah$]h&]uh1hhhhhhhhKAubeh}(h](hŒid1eh ]h"](vga switcheroovga_switcherooeh$]h&]uh1hhhhhhhhKexpect_referenced_by_name}jB4hsexpect_referenced_by_id}hhsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjl4error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehÌ _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}( lattice xp2]j,arenesas r4f2113]j,aus 8,687,007 b2]j-a nxp cbtl06142]j.a ti hd3ss212]j&.apericom pi3vdp12412]j;.ati sn74lv4066a]j_.a nxp cbtl06141]j.a nxp cbtl03062]j.a ti ts3ds10224]j.a ti lp8543]j/a ti lp8545]j/aurefids}h]hasnameids}(jB4hjA4j>4jjjxjujjj,j,public functionsNj!j!j&j&j,j,j94j64j14j.4j{-jx-j-j-j-j-j/j/jC/j@/jP/jM/j\/jY/jh/je/jt/jq/j/j}/j/j/j/j/j/j/j30j00j0j0j+0j(0u nametypes}(jB4jA4jjxjj,j4j!j&j,j94j14j{-j-j-j/jC/jP/j\/jh/jt/j/j/j/j/j30j0j+0uh}(hhj>4hjjWjujhjj{j,jjj j)j2jjjjjxj}jS jX jhjmjSjXj)j.jjjjjjjjjjj!jj#j)jajgj&j!j!j!j"j"j$j$j,j&j3&j9&jh)jn)j64j,j.4j,jx-jr-j-j-j-j-j/j-j@/j:/jM/jG/jY/jS/je/j_/jq/jk/j}/jw/j/j/j/j/j/j/j00j/j0j0j(0j"0j'4j60jS0jX0j2j2u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jz4KsRparse_messages]hsystem_message)}(hhh]h)}(h3Duplicate implicit target name: "public functions".h]h7Duplicate implicit target name: “public functions”.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4ubah}(h]h ]h"]h$]h&]j'4alevelKtypeINFOsourcehÌlineK_uh1j4hj60hhhhhK_ubatransform_messages](j4)}(hhh]h)}(hhh]h4Hyperlink target "vga-switcheroo" is not referenced.}hj 5sbah}(h]h ]h"]h$]h&]uh1hhj5ubah}(h]h ]h"]h$]h&]levelKtypej5sourcehÌlineKuh1j4ubj4)}(hhh]h)}(hhh]h2Hyperlink target "nxp pcal6524" is not referenced.}hj%5sbah}(h]h ]h"]h$]h&]uh1hhj"5ubah}(h]h ]h"]h$]h&]levelKtypej5sourcej~-lineKuh1j4ube transformerN include_log] decorationNhhub.