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/driver-api/aperturemodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/zh_TW/driver-api/aperturemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/it_IT/driver-api/aperturemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/ja_JP/driver-api/aperturemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/ko_KR/driver-api/aperturemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/pt_BR/driver-api/aperturemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget'/translations/sp_SP/driver-api/aperturemodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhA/var/lib/git/docbuild/linux/Documentation/driver-api/aperture.rsthKubhsection)}(hhh](htitle)}(h.Managing Ownership of the Framebuffer Apertureh]h.Managing Ownership of the Framebuffer Aperture}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hXA graphics device might be supported by different drivers, but only one driver can be active at any given time. Many systems load a generic graphics drivers, such as EFI-GOP or VESA, early during the boot process. During later boot stages, they replace the generic driver with a dedicated, hardware-specific driver. To take over the device, the dedicated driver first has to remove the generic driver. Aperture functions manage ownership of framebuffer memory and hand-over between drivers.h]hXA graphics device might be supported by different drivers, but only one driver can be active at any given time. Many systems load a generic graphics drivers, such as EFI-GOP or VESA, early during the boot process. During later boot stages, they replace the generic driver with a dedicated, hardware-specific driver. To take over the device, the dedicated driver first has to remove the generic driver. Aperture functions manage ownership of framebuffer memory and hand-over between drivers.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:6: ./drivers/video/aperture.chKhhhhubh)}(hXGraphics drivers should call aperture_remove_conflicting_devices() at the top of their probe function. The function removes any generic driver that is currently associated with the given framebuffer memory. An example for a graphics device on the platform bus is shown below.h]hXGraphics drivers should call aperture_remove_conflicting_devices() at the top of their probe function. The function removes any generic driver that is currently associated with the given framebuffer memory. An example for a graphics device on the platform bus is shown below.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:6: ./drivers/video/aperture.chKhhhhubh literal_block)}(hX^static int example_probe(struct platform_device *pdev) { struct resource *mem; resource_size_t base, size; int ret; mem = platform_get_resource(pdev, IORESOURCE_MEM, 0); if (!mem) return -ENODEV; base = mem->start; size = resource_size(mem); ret = aperture_remove_conflicting_devices(base, size, "example"); if (ret) return ret; // Initialize the hardware ... return 0; } static const struct platform_driver example_driver = { .probe = example_probe, ... };h]hX^static int example_probe(struct platform_device *pdev) { struct resource *mem; resource_size_t base, size; int ret; mem = platform_get_resource(pdev, IORESOURCE_MEM, 0); if (!mem) return -ENODEV; base = mem->start; size = resource_size(mem); ret = aperture_remove_conflicting_devices(base, size, "example"); if (ret) return ret; // Initialize the hardware ... return 0; } static const struct platform_driver example_driver = { .probe = example_probe, ... };}hhsbah}(h]h ]h"]h$]h&]hhƌforcelanguagechighlight_args}uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:6: ./drivers/video/aperture.chKhhhhubh)}(hXuThe given example reads the platform device's I/O-memory range from the device instance. An active framebuffer will be located within this range. The call to aperture_remove_conflicting_devices() releases drivers that have previously claimed ownership of the range and are currently driving output on the framebuffer. If successful, the new driver can take over the device.h]hXwThe given example reads the platform device’s I/O-memory range from the device instance. An active framebuffer will be located within this range. The call to aperture_remove_conflicting_devices() releases drivers that have previously claimed ownership of the range and are currently driving output on the framebuffer. If successful, the new driver can take over the device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:6: ./drivers/video/aperture.chK;hhhhubh)}(hXWhile the given example uses a platform device, the aperture helpers work with every bus that has an addressable framebuffer. In the case of PCI, device drivers can also call aperture_remove_conflicting_pci_devices() and let the function detect the apertures automatically. Device drivers without knowledge of the framebuffer's location can call aperture_remove_all_conflicting_devices(), which removes all known devices.h]hXWhile the given example uses a platform device, the aperture helpers work with every bus that has an addressable framebuffer. In the case of PCI, device drivers can also call aperture_remove_conflicting_pci_devices() and let the function detect the apertures automatically. Device drivers without knowledge of the framebuffer’s location can call aperture_remove_all_conflicting_devices(), which removes all known devices.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:6: ./drivers/video/aperture.chKBhhhhubh)}(hXDrivers that are susceptible to being removed by other drivers, such as generic EFI or VESA drivers, have to register themselves as owners of their framebuffer apertures. Ownership of the framebuffer memory is achieved by calling devm_aperture_acquire_for_platform_device(). If successful, the driver is the owner of the framebuffer range. The function fails if the framebuffer is already owned by another driver. See below for an example.h]hXDrivers that are susceptible to being removed by other drivers, such as generic EFI or VESA drivers, have to register themselves as owners of their framebuffer apertures. Ownership of the framebuffer memory is achieved by calling devm_aperture_acquire_for_platform_device(). If successful, the driver is the owner of the framebuffer range. The function fails if the framebuffer is already owned by another driver. See below for an example.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:6: ./drivers/video/aperture.chKIhhhhubh)}(hXstatic int generic_probe(struct platform_device *pdev) { struct resource *mem; resource_size_t base, size; mem = platform_get_resource(pdev, IORESOURCE_MEM, 0); if (!mem) return -ENODEV; base = mem->start; size = resource_size(mem); ret = devm_aperture_acquire_for_platform_device(pdev, base, size); if (ret) return ret; // Initialize the hardware ... return 0; } static int generic_remove(struct platform_device *) { // Hot-unplug the device ... return 0; } static const struct platform_driver generic_driver = { .probe = generic_probe, .remove = generic_remove, ... };h]hXstatic int generic_probe(struct platform_device *pdev) { struct resource *mem; resource_size_t base, size; mem = platform_get_resource(pdev, IORESOURCE_MEM, 0); if (!mem) return -ENODEV; base = mem->start; size = resource_size(mem); ret = devm_aperture_acquire_for_platform_device(pdev, base, size); if (ret) return ret; // Initialize the hardware ... return 0; } static int generic_remove(struct platform_device *) { // Hot-unplug the device ... return 0; } static const struct platform_driver generic_driver = { .probe = generic_probe, .remove = generic_remove, ... };}hj@sbah}(h]h ]h"]h$]h&]hhj jjj}uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:6: ./drivers/video/aperture.chKPhhhhubh)}(hThe similar to the previous example, the generic driver claims ownership of the framebuffer memory from its probe function. This will fail if the memory range, or parts of it, is already owned by another driver.h]hThe similar to the previous example, the generic driver claims ownership of the framebuffer memory from its probe function. This will fail if the memory range, or parts of it, is already owned by another driver.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:6: ./drivers/video/aperture.chKuhhhhubh)}(hXIf successful, the generic driver is now subject to forced removal by another driver. This only works for platform drivers that support hot unplugging. When a driver calls aperture_remove_conflicting_devices() et al for the registered framebuffer range, the aperture helpers call platform_device_unregister() and the generic driver unloads itself. The generic driver also has to provide a remove function to make this work. Once hot unplugged from hardware, it may not access the device's registers, framebuffer memory, ROM, etc afterwards.h]hXIf successful, the generic driver is now subject to forced removal by another driver. This only works for platform drivers that support hot unplugging. When a driver calls aperture_remove_conflicting_devices() et al for the registered framebuffer range, the aperture helpers call platform_device_unregister() and the generic driver unloads itself. The generic driver also has to provide a remove function to make this work. Once hot unplugged from hardware, it may not access the device’s registers, framebuffer memory, ROM, etc afterwards.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:6: ./drivers/video/aperture.chKyhhhhubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](single4aperture_remove_all_conflicting_devices (C function))c.aperture_remove_all_conflicting_deviceshNtauh1jnhhhhhNhNubhdesc)}(hhh](hdesc_signature)}(h>int aperture_remove_all_conflicting_devices (const char *name)h]hdesc_signature_line)}(h=int aperture_remove_all_conflicting_devices(const char *name)h](hdesc_sig_keyword_type)}(hinth]hint}(hjhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jhjhhh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:9: ./include/linux/aperture.hhK0ubhdesc_sig_space)}(h h]h }(hjhhhNhNubah}(h]h ]wah"]h$]h&]uh1jhjhhhjhK0ubh desc_name)}(h'aperture_remove_all_conflicting_devicesh]h desc_sig_name)}(h'aperture_remove_all_conflicting_devicesh]h'aperture_remove_all_conflicting_devices}(hjhhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1jhjhhhjhK0ubhdesc_parameterlist)}(h(const char *name)h]hdesc_parameter)}(hconst char *nameh](hdesc_sig_keyword)}(hconsth]hconst}(hjhhhNhNubah}(h]h ]kah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubhdesc_sig_punctuation)}(h*h]h*}(hjhhhNhNubah}(h]h ]pah"]h$]h&]uh1jhjubj)}(hnameh]hname}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhK0ubeh}(h]h ]h"]h$]h&]hhƌ add_permalinkuh1jsphinx_line_type declaratorhjhhhjhK0ubah}(h]j}ah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jhjhK0hjhhubh desc_content)}(hhh]h)}(h remove all existing framebuffersh]h remove all existing framebuffers}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:9: ./include/linux/aperture.hhK0hj[hhubah}(h]h ]h"]h$]h&]uh1jYhjhhhjhK0ubeh}(h]h ](jfunctioneh"]h$]h&]domainjobjtypejvdesctypejvnoindex noindexentrynocontentsentryuh1jhhhhhNhNubh container)}(hX.**Parameters** ``const char *name`` a descriptive name of the requesting driver **Description** This function removes all graphics device drivers. Use this function on systems that can have their framebuffer located anywhere in memory. **Return** 0 on success, or a negative errno code otherwiseh](h)}(h**Parameters**h]hstrong)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:9: ./include/linux/aperture.hhK4hjubhdefinition_list)}(hhh]hdefinition_list_item)}(hA``const char *name`` a descriptive name of the requesting driver h](hterm)}(h``const char *name``h]hliteral)}(hjh]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:9: ./include/linux/aperture.hhK1hjubh definition)}(hhh]h)}(h+a descriptive name of the requesting driverh]h+a descriptive name of the requesting driver}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK1hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK1hjubah}(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&]uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:9: ./include/linux/aperture.hhK3hjubh)}(hThis function removes all graphics device drivers. Use this function on systems that can have their framebuffer located anywhere in memory.h]hThis function removes all graphics device drivers. Use this function on systems that can have their framebuffer located anywhere in memory.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:9: ./include/linux/aperture.hhK2hjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:9: ./include/linux/aperture.hhK5hjubh)}(h00 on success, or a negative errno code otherwiseh]h00 on success, or a negative errno code otherwise}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hh[/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:9: ./include/linux/aperture.hhK6hjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubjo)}(hhh]h}(h]h ]h"]h$]h&]entries](j{6devm_aperture_acquire_for_platform_device (C function)+c.devm_aperture_acquire_for_platform_devicehNtauh1jnhhhhhNhNubj)}(hhh](j)}(hxint devm_aperture_acquire_for_platform_device (struct platform_device *pdev, resource_size_t base, resource_size_t size)h]j)}(hwint devm_aperture_acquire_for_platform_device(struct platform_device *pdev, resource_size_t base, resource_size_t size)h](j)}(hinth]hint}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVhhh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chKubj)}(h h]h }(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVhhhjhhKubj)}(h)devm_aperture_acquire_for_platform_deviceh]j)}(h)devm_aperture_acquire_for_platform_deviceh]h)devm_aperture_acquire_for_platform_device}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwubah}(h]h ](jjeh"]h$]h&]hhuh1jhjVhhhjhhKubj)}(hJ(struct platform_device *pdev, resource_size_t base, resource_size_t size)h](j)}(hstruct platform_device *pdevh](j)}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubh)}(hhh]j)}(hplatform_deviceh]hplatform_device}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftype identifier reftargetjmodnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]j ASTIdentifier)}jj}sb+c.devm_aperture_acquire_for_platform_deviceasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]j&ah"]h$]h&]uh1jhjubj)}(hpdevh]hpdev}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hresource_size_t baseh](h)}(hhh]j)}(hresource_size_th]hresource_size_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]j+c.devm_aperture_acquire_for_platform_deviceasbuh1hhjubj)}(h h]h }(hj3hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hbaseh]hbase}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hresource_size_t sizeh](h)}(hhh]j)}(hresource_size_th]hresource_size_t}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj_modnameN classnameNjj)}j]j+c.devm_aperture_acquire_for_platform_deviceasbuh1hhjVubj)}(h h]h }(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjVhhhjhhKubeh}(h]h ]h"]h$]h&]hhjKuh1jjLjMhjRhhhjhhKubah}(h]jMah ](jQjReh"]h$]h&]jVjW)jXhuh1jhjhhKhjOhhubjZ)}(hhh]h)}(hAAcquires ownership of an aperture on behalf of a platform device.h]hAAcquires ownership of an aperture on behalf of a platform device.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chKhjhhubah}(h]h ]h"]h$]h&]uh1jYhjOhhhjhhKubeh}(h]h ](jfunctioneh"]h$]h&]jzjj{jj|jj}j~juh1jhhhhhNhNubj)}(hXR**Parameters** ``struct platform_device *pdev`` the platform device to own the aperture ``resource_size_t base`` the aperture's byte offset in physical memory ``resource_size_t size`` the aperture size in bytes **Description** Installs the given device as the new owner of the aperture. The function expects the aperture to be provided by a platform device. If another driver takes over ownership of the aperture, aperture helpers will then unregister the platform device automatically. All acquired apertures are released automatically when the underlying device goes away. The function fails if the aperture, or parts of it, is currently owned by another device. To evict current owners, callers should use remove_conflicting_devices() et al. before calling this function. **Return** 0 on success, or a negative errno value otherwise.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chKhjubj)}(hhh](j)}(hI``struct platform_device *pdev`` the platform device to own the aperture h](j)}(h ``struct platform_device *pdev``h]j)}(hjh]hstruct platform_device *pdev}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chKhjubj)}(hhh]h)}(h'the platform device to own the apertureh]h'the platform device to own the aperture}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hKhjubj)}(hG``resource_size_t base`` the aperture's byte offset in physical memory h](j)}(h``resource_size_t base``h]j)}(hj-h]hresource_size_t base}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chKhj'ubj)}(hhh]h)}(h-the aperture's byte offset in physical memoryh]h/the aperture’s byte offset in physical memory}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjBhKhjCubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhjBhKhjubj)}(h4``resource_size_t size`` the aperture size in bytes h](j)}(h``resource_size_t size``h]j)}(hjfh]hresource_size_t size}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chKhj`ubj)}(hhh]h)}(hthe aperture size in bytesh]hthe aperture size in bytes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{hKhj|ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj{hKhjubeh}(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&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chKhjubh)}(hX[Installs the given device as the new owner of the aperture. The function expects the aperture to be provided by a platform device. If another driver takes over ownership of the aperture, aperture helpers will then unregister the platform device automatically. All acquired apertures are released automatically when the underlying device goes away.h]hX[Installs the given device as the new owner of the aperture. The function expects the aperture to be provided by a platform device. If another driver takes over ownership of the aperture, aperture helpers will then unregister the platform device automatically. All acquired apertures are released automatically when the underlying device goes away.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chKhjubh)}(hThe function fails if the aperture, or parts of it, is currently owned by another device. To evict current owners, callers should use remove_conflicting_devices() et al. before calling this function.h]hThe function fails if the aperture, or parts of it, is currently owned by another device. To evict current owners, callers should use remove_conflicting_devices() et al. before calling this function.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chKhjubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chKhjubh)}(h20 on success, or a negative errno value otherwise.h]h20 on success, or a negative errno value otherwise.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubjo)}(hhh]h}(h]h ]h"]h$]h&]entries](j{0aperture_remove_conflicting_devices (C function)%c.aperture_remove_conflicting_deviceshNtauh1jnhhhhhNhNubj)}(hhh](j)}(hfint aperture_remove_conflicting_devices (resource_size_t base, resource_size_t size, const char *name)h]j)}(heint aperture_remove_conflicting_devices(resource_size_t base, resource_size_t size, const char *name)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMubj)}(h h]h }(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhj*hMubj)}(h#aperture_remove_conflicting_devicesh]j)}(h#aperture_remove_conflicting_devicesh]h#aperture_remove_conflicting_devices}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhj*hMubj)}(h>(resource_size_t base, resource_size_t size, const char *name)h](j)}(hresource_size_t baseh](h)}(hhh]j)}(hresource_size_th]hresource_size_t}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj^modnameN classnameNjj)}j]j)}jj?sb%c.aperture_remove_conflicting_devicesasbuh1hhjUubj)}(h h]h }(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubj)}(hbaseh]hbase}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjQubj)}(hresource_size_t sizeh](h)}(hhh]j)}(hresource_size_th]hresource_size_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetjmodnameN classnameNjj)}j]jx%c.aperture_remove_conflicting_devicesasbuh1hhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjQubj)}(hconst char *nameh](j)}(hjh]hconst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hj"hhhNhNubah}(h]h ]j&ah"]h$]h&]uh1jhjubj)}(hnameh]hname}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjQubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhj*hMubeh}(h]h ]h"]h$]h&]hhjKuh1jjLjMhjhhhj*hMubah}(h]jah ](jQjReh"]h$]h&]jVjW)jXhuh1jhj*hMhjhhubjZ)}(hhh]h)}(h!remove devices in the given rangeh]h!remove devices in the given range}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMhjVhhubah}(h]h ]h"]h$]h&]uh1jYhjhhhj*hMubeh}(h]h ](jfunctioneh"]h$]h&]jzjj{jqj|jqj}j~juh1jhhhhhNhNubj)}(hXo**Parameters** ``resource_size_t base`` the aperture's base address in physical memory ``resource_size_t size`` aperture size in bytes ``const char *name`` a descriptive name of the requesting driver **Description** This function removes devices that own apertures within **base** and **size**. **Return** 0 on success, or a negative errno code otherwiseh](h)}(h**Parameters**h]j)}(hj{h]h Parameters}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMhjuubj)}(hhh](j)}(hH``resource_size_t base`` the aperture's base address in physical memory h](j)}(h``resource_size_t base``h]j)}(hjh]hresource_size_t base}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMhjubj)}(hhh]h)}(h.the aperture's base address in physical memoryh]h0the aperture’s base address in physical memory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h0``resource_size_t size`` aperture size in bytes h](j)}(h``resource_size_t size``h]j)}(hjh]hresource_size_t size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMhjubj)}(hhh]h)}(haperture size in bytesh]haperture size in bytes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(hA``const char *name`` a descriptive name of the requesting driver h](j)}(h``const char *name``h]j)}(hj h]hconst char *name}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMhjubj)}(hhh]h)}(h+a descriptive name of the requesting driverh]h+a descriptive name of the requesting driver}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hMhj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj!hMhjubeh}(h]h ]h"]h$]h&]uh1jhjuubh)}(h**Description**h]j)}(hjGh]h Description}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMhjuubh)}(hNThis function removes devices that own apertures within **base** and **size**.h](h8This function removes devices that own apertures within }(hj]hhhNhNubj)}(h**base**h]hbase}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubh and }(hj]hhhNhNubj)}(h**size**h]hsize}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubh.}(hj]hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMhjuubh)}(h **Return**h]j)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMhjuubh)}(h00 on success, or a negative errno code otherwiseh]h00 on success, or a negative errno code otherwise}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMhjuubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubjo)}(hhh]h}(h]h ]h"]h$]h&]entries](j{1__aperture_remove_legacy_vga_devices (C function)&c.__aperture_remove_legacy_vga_deviceshNtauh1jnhhhhhNhNubj)}(hhh](j)}(h?int __aperture_remove_legacy_vga_devices (struct pci_dev *pdev)h]j)}(h>int __aperture_remove_legacy_vga_devices(struct pci_dev *pdev)h](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chM1ubj)}(h h]h }(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM1ubj)}(h$__aperture_remove_legacy_vga_devicesh]j)}(h$__aperture_remove_legacy_vga_devicesh]h$__aperture_remove_legacy_vga_devices}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhM1ubj)}(h(struct pci_dev *pdev)h]j)}(hstruct pci_dev *pdevh](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj! hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hpci_devh]hpci_dev}(hj2 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj4 modnameN classnameNjj)}j]j)}jjsb&c.__aperture_remove_legacy_vga_devicesasbuh1hhj ubj)}(h h]h }(hjR hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjh]h*}(hj` hhhNhNubah}(h]h ]j&ah"]h$]h&]uh1jhj ubj)}(hpdevh]hpdev}(hjm hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhM1ubeh}(h]h ]h"]h$]h&]hhjKuh1jjLjMhjhhhjhM1ubah}(h]jah ](jQjReh"]h$]h&]jVjW)jXhuh1jhjhM1hjhhubjZ)}(hhh]h)}(h*remove legacy VGA devices of a PCI devicesh]h*remove legacy VGA devices of a PCI devices}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chM1hj hhubah}(h]h ]h"]h$]h&]uh1jYhjhhhjhM1ubeh}(h]h ](jfunctioneh"]h$]h&]jzjj{j j|j j}j~juh1jhhhhhNhNubj)}(hX!**Parameters** ``struct pci_dev *pdev`` PCI device **Description** This function removes VGA devices provided by **pdev**, such as a VGA framebuffer or a console. This is useful if you have a VGA-compatible PCI graphics device with framebuffers in non-BAR locations. Drivers should acquire ownership of those memory areas and afterwards call this helper to release remaining VGA devices. If your hardware has its framebuffers accessible via PCI BARS, use aperture_remove_conflicting_pci_devices() instead. The function will release any VGA devices automatically. WARNING: Apparently we must remove graphics drivers before calling this helper. Otherwise the vga fbdev driver falls over if we have vgacon configured. **Return** 0 on success, or a negative errno code otherwiseh](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chM5hj ubj)}(hhh]j)}(h$``struct pci_dev *pdev`` PCI device h](j)}(h``struct pci_dev *pdev``h]j)}(hj h]hstruct pci_dev *pdev}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chM2hj ubj)}(hhh]h)}(h PCI deviceh]h PCI device}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM2hj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hM2hj ubah}(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&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chM4hj ubh)}(hX@This function removes VGA devices provided by **pdev**, such as a VGA framebuffer or a console. This is useful if you have a VGA-compatible PCI graphics device with framebuffers in non-BAR locations. Drivers should acquire ownership of those memory areas and afterwards call this helper to release remaining VGA devices.h](h.This function removes VGA devices provided by }(hj) hhhNhNubj)}(h**pdev**h]hpdev}(hj1 hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj) ubhX , such as a VGA framebuffer or a console. This is useful if you have a VGA-compatible PCI graphics device with framebuffers in non-BAR locations. Drivers should acquire ownership of those memory areas and afterwards call this helper to release remaining VGA devices.}(hj) hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chM3hj ubh)}(hIf your hardware has its framebuffers accessible via PCI BARS, use aperture_remove_conflicting_pci_devices() instead. The function will release any VGA devices automatically.h]hIf your hardware has its framebuffers accessible via PCI BARS, use aperture_remove_conflicting_pci_devices() instead. The function will release any VGA devices automatically.}(hjJ hhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chM9hj ubj)}(hhh]j)}(hWARNING: Apparently we must remove graphics drivers before calling this helper. Otherwise the vga fbdev driver falls over if we have vgacon configured. h](j)}(hBWARNING: Apparently we must remove graphics drivers before callingh]hBWARNING: Apparently we must remove graphics drivers before calling}(hj` hhhNhNubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chM?hj\ ubj)}(hhh]h)}(hTthis helper. Otherwise the vga fbdev driver falls over if we have vgacon configured.h]hTthis helper. Otherwise the vga fbdev driver falls over if we have vgacon configured.}(hjr hhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chM>hjo ubah}(h]h ]h"]h$]h&]uh1jhj\ ubeh}(h]h ]h"]h$]h&]uh1jhjn hM?hjY ubah}(h]h ]h"]h$]h&]uh1jhj ubh)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMAhj ubh)}(h00 on success, or a negative errno code otherwiseh]h00 on success, or a negative errno code otherwise}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMBhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubjo)}(hhh]h}(h]h ]h"]h$]h&]entries](j{4aperture_remove_conflicting_pci_devices (C function))c.aperture_remove_conflicting_pci_deviceshNtauh1jnhhhhhNhNubj)}(hhh](j)}(hTint aperture_remove_conflicting_pci_devices (struct pci_dev *pdev, const char *name)h]j)}(hSint aperture_remove_conflicting_pci_devices(struct pci_dev *pdev, const char *name)h](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMPubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhj hMPubj)}(h'aperture_remove_conflicting_pci_devicesh]j)}(h'aperture_remove_conflicting_pci_devicesh]h'aperture_remove_conflicting_pci_devices}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj hhhj hMPubj)}(h((struct pci_dev *pdev, const char *name)h](j)}(hstruct pci_dev *pdevh](j)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj$ hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubh)}(hhh]j)}(hpci_devh]hpci_dev}(hj5 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2 ubah}(h]h ]h"]h$]h&] refdomainjreftypej reftargetj7 modnameN classnameNjj)}j]j)}jj sb)c.aperture_remove_conflicting_pci_devicesasbuh1hhj ubj)}(h h]h }(hjU hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjh]h*}(hjc hhhNhNubah}(h]h ]j&ah"]h$]h&]uh1jhj ubj)}(hpdevh]hpdev}(hjp hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubj)}(hconst char *nameh](j)}(hjh]hconst}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hcharh]hchar}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(h h]h }(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]j&ah"]h$]h&]uh1jhj ubj)}(hnameh]hname}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubeh}(h]h ]h"]h$]h&]hhuh1jhj hhhj hMPubeh}(h]h ]h"]h$]h&]hhjKuh1jjLjMhj hhhj hMPubah}(h]j ah ](jQjReh"]h$]h&]jVjW)jXhuh1jhj hMPhj hhubjZ)}(hhh]h)}(h,remove existing framebuffers for PCI devicesh]h,remove existing framebuffers for PCI devices}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMPhj hhubah}(h]h ]h"]h$]h&]uh1jYhj hhhj hMPubeh}(h]h ](jfunctioneh"]h$]h&]jzjj{j j|j j}j~juh1jhhhhhNhNubj)}(hX**Parameters** ``struct pci_dev *pdev`` PCI device ``const char *name`` a descriptive name of the requesting driver **Description** This function removes devices that own apertures within any of **pdev**'s memory bars. The function assumes that PCI device with shadowed ROM drives a primary display and therefore kicks out vga16fb as well. **Return** 0 on success, or a negative errno code otherwiseh](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMThj ubj)}(hhh](j)}(h$``struct pci_dev *pdev`` PCI device h](j)}(h``struct pci_dev *pdev``h]j)}(hj8 h]hstruct pci_dev *pdev}(hj: hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj6 ubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMQhj2 ubj)}(hhh]h)}(h PCI deviceh]h PCI device}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjM hMQhjN ubah}(h]h ]h"]h$]h&]uh1jhj2 ubeh}(h]h ]h"]h$]h&]uh1jhjM hMQhj/ ubj)}(hA``const char *name`` a descriptive name of the requesting driver h](j)}(h``const char *name``h]j)}(hjq h]hconst char *name}(hjs hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjo ubah}(h]h ]h"]h$]h&]uh1jh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMRhjk ubj)}(hhh]h)}(h+a descriptive name of the requesting driverh]h+a descriptive name of the requesting driver}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMRhj ubah}(h]h ]h"]h$]h&]uh1jhjk ubeh}(h]h ]h"]h$]h&]uh1jhj hMRhj/ 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&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMThj ubh)}(hThis function removes devices that own apertures within any of **pdev**'s memory bars. The function assumes that PCI device with shadowed ROM drives a primary display and therefore kicks out vga16fb as well.h](h?This function removes devices that own apertures within any of }(hj hhhNhNubj)}(h**pdev**h]hpdev}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubh’s memory bars. The function assumes that PCI device with shadowed ROM drives a primary display and therefore kicks out vga16fb as well.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMShj ubh)}(h **Return**h]j)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMWhj ubh)}(h00 on success, or a negative errno code otherwiseh]h00 on success, or a negative errno code otherwise}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hh\/var/lib/git/docbuild/linux/Documentation/driver-api/aperture:12: ./drivers/video/aperture.chMXhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jhhhhhNhNubeh}(h].managing-ownership-of-the-framebuffer-apertureah ]h"].managing ownership of the framebuffer apertureah$]h&]uh1hhhhhhhhKubeh}(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_handlerj< error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _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}refids}nameids}j j s nametypes}j sh}(j hj}jjMjRjjjjj j u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.