驱动功能

驱动程序功能标志

DRIVER_USE_AGP

驱动程序使用AGP接口，DRM核心将管理AGP资源。

DRIVER_REQUIRE_AGP

驱动程序需要AGP接口才能运行。AGP初始化失败将成为致命错误。

DRIVER_PCI_DMA

驱动程序具有PCI DMA的功能，将启用PCI DMA缓冲区到用户空间的映射。不推荐使用。

DRIVER_SG

驱动程序可以执行分散/收集DMA，将启用分散/收集缓冲区的分配和映射。不推荐使用。

DRIVER_HAVE_DMA

驱动程序支持DMA，将支持用户空间DMA API。不推荐使用。

DRIVER_HAVE_IRQ，DRIVER_IRQ_SHARED

DRIVER_HAVE_IRQ指示驱动程序是否具有由DRM Core管理的IRQ处理程序。设置该标志后，内核将支持简单的IRQ处理程序安装。安装过程在“ IRQ注册”一节中介绍。

DRIVER_IRQ_SHARED指示设备和处理程序是否支持共享的IRQ（请注意，这是PCI驱动程序所必需的）。

DRIVER_GEM

驱动程序使用GEM内存管理器。

DRIVER_MODESET

驱动程序支持模式设置界面（KMS）。

DRIVER_PRIME

驱动程序实现DRM PRIME缓冲区共享。

DRIVER_RENDER

驱动程序支持专用渲染节点。

主要，次要和补丁级别

名称，说明和日期

驱动程序私有和性能计数器

IRQ注册

drm_irq_install和 drm_irq_uninstall都是通过调用函数drm_dev_to_irq获取设备的IRQ 。此内联函数将调用特定于总线的操作以检索IRQ号。对于平台设备，platform_get_irq（...，0）用于检索IRQ号。

drm_irq_install通过调用 irq_preinstall驱动程序操作启动。该操作是可选的，必须确保在通过清除所有挂起的中断标志或禁用中断时不会触发中断。

然后，通过调用request_irq来请求IRQ。如果设置了DRIVER_IRQ_SHARED驱动功能标志，则将请求共享（IRQF_SHARED）IRQ。

IRQ处理函数必须作为必需的irq_handler驱动程序操作提供。它会直接传递给 request_irq，所有IRQ处理程序相同的原型。他将作为第二个参数被调用，一个指向DRM设备的指针。

最后，该函数调用可选的 irq_postinstall驱动程序操作。该操作通常启用中断（vblank中断除外，vblank中断是单独启用的），但是驱动程序可以选择在其他时间启用/禁用中断。

drm_irq_uninstall与drm_irq_install相似，用于卸载IRQ处理程序。首先唤醒所有等待vblank中断的进程，以确保它们不会挂起，然后调用可选的 irq_uninstall驱动程序操作。该操作必须禁用所有硬件中断。最后，该函数通过调用 free_irq释放IRQ。

需要多个中断处理程序的驱动程序不能使用托管的IRQ注册功能。在这种情况下，必须手动注册和注销IRQ（通常使用request_irq 和free_irq函数，或者它们的devm_ *等效项）。

手动注册IRQ时，驱动程序不得设置DRIVER_HAVE_IRQ驱动程序功能标志，并且不得提供 irq_handler驱动程序操作。他们必须在注册IRQ 时将drm_device irq_enabled字段设置为1，并在取消注册IRQ之后将其清除为0。

内存管理器初始化

杂项设备配置

TTM初始化

GEM初始化

GEM对象创建

GEM对象生命周期

GEM对象命名

驱动程序可以使用辅助功能更简单的API的条款drm_gem_prime_export和 drm_gem_prime_import实现gem_prime_export和gem_prime_import。这些函数通过五个较低级别的驱动程序回调实现dma-buf支持：

导出回调：

- gem_prime_pin（可选）：准备要导出的GEM对象

- gem_prime_get_sg_table：提供固定页面的分散/聚集表

- gem_prime_vmap：vmap驱动程序导出的缓冲区// vmap a buffer exported by your driver

- gem_prime_vunmap：映射驱动程序导出的缓冲区//vunmap a buffer exported by your driver

导入回调：

- gem_prime_import_sg_table（导入）：从另一个驱动程序的散点图/聚集表生成GEM对象

GEM对象映射

Dumb GEM对象

• int (*dumb_create)(struct drm_file *file_priv, struct drm_device *dev,struct drm_mode_create_dumb *args);

  该dumb_create操作根据struct drm_mode_create_dumb 的宽度，高度和深度参数，创建适合于扫描的GEM对象。它用新创建的GEM对象的句柄及其行间距和大小(以字节为单位)填充参数的句柄、间距和大小字段。

• int (*dumb_destroy)(struct drm_file *file_priv, struct drm_device *dev,uint32_t handle);

  dumb_destroy操作会销毁dumb_create创建的dumb GEM对象。

• int (*dumb_map_offset)(struct drm_file *file_priv, struct drm_device *dev,uint32_t handle, uint64_t *offset);

  该dumb_map_offset操作将mmap伪偏移与该句柄给定的GEM对象相关联并返回。驱动程序必须使用drm_gem_create_mmap_offset函数关联虚假偏移量，如“ GEM对象映射”一节中 所述。

内存一致性

命令执行

CRTC初始化

CRTC操作

int (*set_config)(struct drm_mode_set *set);

将新的CRTC配置应用于设备。该配置指定CRTC，要从中扫描的帧缓冲区，帧缓冲区中的（x，y）位置，显示模式以及与CRTC一起驱动的一组连接器。

如果配置中指定的帧缓冲区为NULL，则驱动程序必须分离所有连接到CRTC的编码器和所有连接到这些编码器的连接器，并禁用它们。

在保持模式配置锁定的情况下调用此操作。

int (*page_flip)(struct drm_crtc *crtc, struct drm_framebuffer *fb,struct drm_pending_vblank_event *event);

将页面翻转安排到CRTC的给定帧缓冲区。在保持模式配置互斥锁的情况下调用此操作。

页面翻转是一种同步机制，可以在垂直消隐(vbank，打无效像素点的时候)期间将CRTC扫描出的帧缓冲区替换为新的帧缓冲区，从而避免撕裂。当应用程序请求翻页时，DRM内核将验证新的帧缓冲区是否足够大，以供CRTC在当前配置的模式下进行扫描，然后使用指向新帧缓冲区的指针调用CRTC的page_flip操作。

该page_flip实现翻页操作。一旦任何针对新帧缓冲区的等待渲染目标完成，CRTC将重新编程为在下一次垂直刷新后显示该帧缓冲区。该操作必须立即返回，而不必等待渲染或页面翻转完成，并且必须阻止任何新的渲染到帧缓冲区，直到页面翻转完成。

如果可以成功调度页面翻转，则驱动程序必须将该drm_crtc-<fb字段设置为指向的新帧缓冲区fb。这一点很重要，这样才能使基于帧缓冲区的引用计数保持平衡。

如果页面翻转已经挂起，则 page_flip操作必须返回-EBUSY。

为了将页面翻转同步到垂直消隐，驱动程序可能需要启用垂直消隐中断。它应该为此目的而调用drm_vblank_get，并在页面翻转完成后调用drm_vblank_put。

如果应用程序在翻页完成时请求得到通知，则将使用指向drm_pending_vblank_event实例的非空事件参数调用page_flip操作。翻页完成后，驱动程序必须调用drm_send_vblank_event 填写事件并发送，以唤醒所有等待的进程。这可以用

            spin_lock_irqsave(&dev->event_lock, flags);...drm_send_vblank_event(dev, pipe, event);spin_unlock_irqrestore(&dev->event_lock, flags);

在等待页面翻转完成时，驱动程序可以自由使用列表头event->base.link，以将pending事件存储在特定于驱动程序的列表中。

如果在发出事件信号之前关闭了文件句柄，则驱动程序必须注意在其preclose操作中销毁该事件 （并在需要时调用 drm_vblank_put）。

平面初始化

平面操作

• int (*update_plane)(struct drm_plane *plane, struct drm_crtc *crtc,struct drm_framebuffer *fb, int crtc_x, int crtc_y,unsigned int crtc_w, unsigned int crtc_h,uint32_t src_x, uint32_t src_y,uint32_t src_w, uint32_t src_h);

  使用给定的CRTC和帧缓冲区启用并配置平面以。

  帧缓冲存储器坐标源矩形由给定src_x，src_y， src_w和src_h 参数（如16.16固定点值）。不支持亚像素平面坐标的设备可以忽略小数部分。

  CRTC坐标目标矩形由给定 crtc_x，crtc_y， crtc_w和crtc_h 参数（如整数的值）。设备将源矩形缩放为目标矩形。如果不支持缩放，并且源矩形大小与目标矩形大小不匹配，则驱动程序必须返回-EINVAL错误。

• int (*disable_plane)(struct drm_plane *plane);
  

  禁用plane。DRM内核调用此方法以响应将帧缓冲区ID设置为0的DRM_IOCTL_MODE_SETPLANE ioctl调用。CRTC不得处理禁用的平面。

• void (*destroy)(struct drm_plane *plane);
  

  不再需要时销毁Plane。请参阅“ KMS初始化和清理”部分。

编码器初始化

• DRM_MODE_ENCODER_DAC for VGA and analog on DVI-I/DVI-A
• DRM_MODE_ENCODER_TMDS for DVI, HDMI and (embedded) DisplayPort
• DRM_MODE_ENCODER_LVDS for display panels
• DRM_MODE_ENCODER_TVDAC for TV output (Composite, S-Video, Component, SCART)
• DRM_MODE_ENCODER_VIRTUAL for virtual machine displays

编码器操作

• void (*destroy)(struct drm_encoder *encoder);
  

  在不再需要时调用销毁编码器。请参阅 “ KMS初始化和清理”部分。

• void (*set_property)(struct drm_plane *plane,struct drm_property *property, uint64_t value);

  将给定平面属性的值设置为 value。有关属性的更多信息，请参见“ KMS属性”一节。

连接器初始化

interlace_allowed

连接器是否可以处理隔行模式。

doublescan_allowed

连接器是否可以处理双重扫描。

display_info

当检测到显示时，显示信息由EDID信息填充。对于非热插拔显示器（例如嵌入式系统中的平板），驱动程序应初始化 display_info.width_mm 和 display_info.height_mm ,带有显示器实际尺寸的字段。

polled

连接器轮询模式，组合以下属性

将不支持连接状态发现的连接器设置为0。

• DRM_MODE_CONNECTOR_VGA
• DRM_MODE_CONNECTOR_DVII
• DRM_MODE_CONNECTOR_DVID
• DRM_MODE_CONNECTOR_DVIA
• DRM_MODE_CONNECTOR_Composite
• DRM_MODE_CONNECTOR_SVIDEO
• DRM_MODE_CONNECTOR_LVDS
• DRM_MODE_CONNECTOR_Component
• DRM_MODE_CONNECTOR_9PinDIN
• DRM_MODE_CONNECTOR_DisplayPort
• DRM_MODE_CONNECTOR_HDMIA
• DRM_MODE_CONNECTOR_HDMIB
• DRM_MODE_CONNECTOR_TV
• DRM_MODE_CONNECTOR_eDP
• DRM_MODE_CONNECTOR_VIRTUAL

连接器操作

void (*dpms)(struct drm_connector *connector, int mode);

DPMS操作设置连接器的电源状态。模式参数是以下之一

在除DPMS_ON模式以外的所有模式下，连接器所连接的编码器均应通过适当地驱动其信号，将显示器置于低功耗模式。如果编码器上连接了多个连接器，则应注意不要改变其他显示器的电源状态。当所有相关的连接器都置于低功耗模式时，应将低功耗模式传播到编码器和CRTC。[逻辑类似于suspend/resume]

int (*fill_modes)(struct drm_connector *connector, uint32_t max_width,uint32_t max_height);

用连接器支持的所有模式填充模式列表。如果 max_width和max_height 参数不为零，则实现必须忽略大于max_width或大于max_height的所有模式。

连接器还必须以连接的显示器物理尺寸（以毫米为单位）填写其display_info width_mm 和height_mm字段。如果该值未知或不适用（例如，对于投影仪设备），则应将字段设置为0。

如果支持，则通过轮询或热插拔事件更新连接状态（请参阅参考资料polled）。状态值通过ioctls报告给用户空间，并且不能在驱动程序内部使用，因为状态值只能从用户空间调用drm_mode_getconnector来初始化 。

enum drm_connector_status (*detect)(struct drm_connector *connector,bool force);

检查连接器上是否连接了任何东西。force参数在轮询时设置为false，在根据用户请求检查连接器时设置为true。在自动探测期间，驱动程序可以使用force来避免昂贵的、破坏性的操作。

如果连接器已连接东西，则返回connector_status_connected；如果未连接任何东西，则返回connector_status_disconnected；如果连接状态未知，则返回connector_status_unknown。

如果连接状态确实被探测为已连接，驱动程序应该只返回connector_status_connected。无法检测连接状态或连接状态探测失败的连接器应该返回connector_status_unknown。

名称

drm_modeset_lock_all —获取所有模式集锁

概要

void fsfuncdrm_modeset_lock_all (    dev);
struct drm_device * dev;

参数

描述

此函数具有所有模式集锁定，适用于尚未实现更细粒度的方案的情况。

名称

drm_modeset_unlock_all —删除所有模式集锁

概要

void fsfuncdrm_modeset_unlock_all (  dev);
struct drm_device * dev;

参数

名称

drm_warn_on_modeset_not_all_locked —检查是否已锁定所有模式设置锁

概要

void fsfuncdrm_warn_on_modeset_not_all_locked (   dev);
struct drm_device * dev;

参数

名称

drm_mode_object_find —查找具有静态生存期的drm对象

概要

struct drm_mode_object * fsfuncdrm_mode_object_find (    dev,     id,     type);
struct drm_device * dev;
uint32_t id;
uint32_t type;

参数

描述

请注意，framebuffer不能用这个函数查找——因为它们是引用计数的，所以需要特殊处理。

名称

drm_framebuffer_init —初始化帧缓冲区

概要

int fsfuncdrm_framebuffer_init (   dev,     fb,     funcs);
struct drm_device * dev;
struct drm_framebuffer * fb;
const struct drm_framebuffer_funcs * funcs;

参数

描述

为帧缓冲区的父模式对象分配一个ID，设置其模式函数和设备文件，并将其添加到主fd列表中。

重要

此功能将发布fb，并使其可供其他用户并发访问。这意味着此时必须完全设置fb -由于所有fb属性在其生命周期内都是不变的，因此无需进一步锁定，而仅需要正确的引用计数即可。

返回

成功为零，失败为错误代码。

名称

drm_framebuffer_lookup —查找drm帧缓冲区并获取引用

概要

struct drm_framebuffer * fsfuncdrm_framebuffer_lookup ( dev,     id);
struct drm_device * dev;
uint32_t id;

参数

描述

如果成功，这将获取对帧缓冲区的附加引用-调用者需要确保最终再次取消对返回的帧缓冲区的引用。

名称

drm_framebuffer_unreference —取消引用帧缓冲区

概要

void fsfuncdrm_framebuffer_unreference (  fb);
struct drm_framebuffer * fb;

参数

描述

此功能将fb的refcount递减，并在其降至零时释放它。

名称

drm_framebuffer_reference —增加fb引用

概要

void fsfuncdrm_framebuffer_reference ( fb);
struct drm_framebuffer * fb;

参数

名称

drm_framebuffer_unregister_private —查找IDR中注销私有fb

概要

void fsfuncdrm_framebuffer_unregister_private ( fb);
struct drm_framebuffer * fb;

参数

描述

驱动程序需要在清理驱动程序私有的帧缓冲区时调用它，例如那些用于fbdev的帧缓冲区。请注意，调用者必须持有自己的引用，即对象不能通过这个调用被销毁(因为它会导致锁定反转)。

名称

drm_framebuffer_cleanup —删除一个帧缓冲对象

概要

void fsfuncdrm_framebuffer_cleanup (    fb);
struct drm_framebuffer * fb;

参数

描述

清理对用户创建的帧缓冲区的引用。该功能旨在从驱动程序-> destroy回调中使用。

请注意，这个函数并没有将fb从活动usuage中移除——如果它仍然在任何地方使用，则会出现hilarity，因为用户空间可以在id上调用getfb并返回-EINVAL。显然，不关心驱动程序卸载时间。

同样，不会从查找idr中删除帧缓冲区-对于用户创建的帧缓冲区，这将在rmfb ioctl中发生。对于驱动程序专用对象（例如，对于fbdev），驱动程序需要显式调用drm_framebuffer_unregister_private。

名称

drm_framebuffer_remove —删除和取消引用帧缓冲区对象

概要

void fsfuncdrm_framebuffer_remove (fb);
struct drm_framebuffer * fb;

参数

描述

在dev的mode_config中扫描所有CRTC和平面。如果他们使用fb，将其删除，并将其设置为NULL。然后删除对传入的帧缓冲区的引用。可能会占用模式设置锁。

请注意，如果调用方持有对帧缓冲区的最后一个引用，则此函数可优化清除操作。在这种情况下，还可以确保不使用模式集锁定。

名称

drm_crtc_init —初始化新的CRTC对象

概要

int fsfuncdrm_crtc_init ( dev,     crtc,   funcs);
struct drm_device * dev;
struct drm_crtc * crtc;
const struct drm_crtc_funcs * funcs;

参数

描述

创建一个新对象作为驱动程序crtc对象的基础部分。

返回

成功为零，失败为错误代码。

名称

drm_crtc_cleanup —清理核心crtc用法

概要

void fsfuncdrm_crtc_cleanup (  crtc);
struct drm_crtc * crtc;

参数

描述

此功能清除crtc并从DRM模式设置核心中将其删除。请注意，该函数“不会 ”释放crtc结构本身，这是调用者的责任。

名称

drm_mode_probed_add —将模式添加到连接器的探测模式列表

概要

void fsfuncdrm_mode_probed_add (  connector,   mode);
struct drm_connector * connector;
struct drm_display_mode * mode;

参数

描述

添加mode到connector的模式列表以供以后使用。

名称

drm_connector_init —初始化预分配的连接器

概要

int fsfuncdrm_connector_init (   dev,     connector,  funcs,  connector_type);
struct drm_device * dev;
struct drm_connector * connector;
const struct drm_connector_funcs * funcs;
int connector_type;

参数

描述

初始化预分配的连接器。连接器应细分为驱动程序连接器对象的一部分。

返回

成功为零，失败为错误代码。

名称

drm_connector_cleanup —清理一个初始化的连接器

概要

void fsfuncdrm_connector_cleanup (   connector);
struct drm_connector * connector;

参数

描述

清理连接器，但不释放对象。

名称

drm_plane_init —初始化一个新的平面对象

概要

int fsfuncdrm_plane_init (   dev,     plane,  possible_crtcs,     funcs,  formats,    format_count,   priv);
struct drm_device * dev;
struct drm_plane * plane;
unsigned long possible_crtcs;
const struct drm_plane_funcs * funcs;
const uint32_t * formats;
uint32_t format_count;
bool priv;

参数

描述

初始化一个新对象，该对象创建为驱动程序平面对象的基础部分。

返回

成功为零，失败为错误代码。

名称

drm_plane_cleanup —清理核心平面的使用

概要

void fsfuncdrm_plane_cleanup (    plane);
struct drm_plane * plane;

参数

描述

此功能清除plane并从DRM模式设置核心中将其删除。请注意，该函数*不会*释放平面结构本身，这是调用者的责任。

名称

drm_plane_force_disable —强制禁用plane

概要

void fsfuncdrm_plane_force_disable (  plane);
struct drm_plane * plane;

参数

描述

强制禁用plane。

在销毁平面的当前帧缓冲区以及恢复fbdev模式时使用。

名称

drm_mode_create —创建新的显示模式

概要

struct drm_display_mode * fsfuncdrm_mode_create (  dev);
struct drm_device * dev;

参数

描述

创建一个新的drm_display_mode，给它一个ID，然后返回它。

返回

成功时指向新模式的指针，错误时指向NULL。

名称

drm_mode_destroy —删除模式

概要

void fsfuncdrm_mode_destroy (    dev,     mode);
struct drm_device * dev;
struct drm_display_mode * mode;

参数

描述

释放mode的唯一标识符，然后释放它。

名称

drm_mode_create_dvi_i_properties —创建特定于DVI-I的连接器属性

概要

int fsfuncdrm_mode_create_dvi_i_properties (    dev);
struct drm_device * dev;

参数

描述

第一次建立DVI-I连接器时由驱动程序调用。

名称

drm_mode_create_tv_properties —创建TV特定的连接器属性

概要

int fsfuncdrm_mode_create_tv_properties (    dev,     num_modes,  modes[]);
struct drm_device * dev;
int num_modes;
char * modes[];

参数

描述

由驱动的TV初始化例程调用，此函数为给定设备创建TV特定的连接器属性。调用者负责分配格式名称列表，并将其传递给此例程。

名称

drm_mode_create_scaling_mode_property-创建缩放模式属性

概要

int fsfuncdrm_mode_create_scaling_mode_property ( dev);
struct drm_device * dev;

参数

描述

第一次需要时由驱动程序调用，必须将其连接到所需的连接器。

名称

drm_mode_create_dirty_info_property-创建脏属性

概要

int fsfuncdrm_mode_create_dirty_info_property ( dev);
struct drm_device * dev;

参数

描述

第一次需要时由驱动程序调用，必须将其连接到所需的连接器。

名称

drm_mode_set_config_internal —辅助调用-> set_config函数

概要

int fsfuncdrm_mode_set_config_internal (set);
struct drm_mode_set * set;

参数

描述

这是一个小助手包装内部调用到->set_config驱动程序接口。

名称

drm_format_num_planes —获取指定格式的平面数

概要

int fsfuncdrm_format_num_planes (format);
uint32_t format;

参数

返回

指定的像素格式使用的平面数。

名称

drm_format_plane_cpp —确定每个像素的字节值

概要

int fsfuncdrm_format_plane_cpp (format,     plane);
uint32_t format;
int plane;

参数

返回

指定平面的每个像素的字节值。

名称

drm_format_horz_chroma_subsampling —获取水平色度子采样因子

概要

int fsfuncdrm_format_horz_chroma_subsampling (format);
uint32_t format;

参数

返回

指定像素格式的水平色度子采样因子。

名称

drm_format_vert_chroma_subsampling —获取垂直色度子采样因子

概要

int fsfuncdrm_format_vert_chroma_subsampling (format);
uint32_t format;

参数

返回

指定像素格式的垂直色度子采样因子。

名称

drm_mode_config_init —初始化DRM mode_configuration结构

概要

void fsfuncdrm_mode_config_init (dev);
struct drm_device * dev;

参数

描述

初始化dev的mode_config结构，用于跟踪的图形配置dev。

由于这会初始化模式集锁定，因此无法进行锁定。因为这应该在单线程时初始化，所以没有问题，确保安全是驱动的问题。

名称

drm_mode_config_cleanup-释放DRM mode_config信息

概要

void fsfuncdrm_mode_config_cleanup (dev);
struct drm_device * dev;

参数

描述

释放与此DRM设备关联的所有连接器和CRTC，然后释放帧缓冲区和关联的缓冲区对象。

请注意，由于驱动/设备拆卸/应该/在单线程时操作，，因此不需要锁定。确保这项操作正确是驱动的工作。

FIXME

tongshi 清理所有悬空的用户缓冲区对象

名称

drm_helper_move_panel_connectors_to_head —将面板移到连接器列表的最前面

概要

void fsfuncdrm_helper_move_panel_connectors_to_head (dev);
struct drm_device * dev;

参数

描述

某些用户空间假定第一个连接的连接器是主显示屏，应该在其中显示例如登录屏幕。对于笔记本电脑，这应该是主面板。使用此功能可将所有（eDP / LVDS）面板排序到连接器列表的最前面，而不必费力地尝试按正确的顺序对其进行初始化。

名称

drm_helper_probe_single_connector_modes —获取完整的显示模式集

概要

int fsfuncdrm_helper_probe_single_connector_modes (connector,    maxX,   maxY);
struct drm_connector * connector;
uint32_t maxX;
uint32_t maxY;

参数

锁定

调用者必须持有模式配置锁。

基于connector实现的帮助程序回调，尝试检测所有有效模式。模式将首先被添加到连接器的probed_modes列表，然后剔除不符合的（基于有效性和maxX，maxY参数），其余投入正常模式列表。

打算用作->probe connector 回调的通用实现，为用crtc辅助函数进行输出模式过滤和检测的驱动程序所使用 。

返回

在connector上找到的模式数量。

名称

drm_helper_encoder_in_use —检查是否正在使用给定的编码器

概要

bool fsfuncdrm_helper_encoder_in_use (    encoder);
struct drm_encoder * encoder;

参数

锁定

调用者必须持有模式配置锁。

遍历encoders对应的DRM设备的mode_config，看看它是否正在使用中。

返回

如果encoder属于mode_config，则为true，否则为false。

名称

drm_helper_crtc_in_use —检查给定的CRTC是否在mode_config中

概要

bool fsfuncdrm_helper_crtc_in_use ( crtc);
struct drm_crtc * crtc;

参数

锁定

调用者必须持有模式配置锁。

遍历crtc对应的DRM设备的mode_config，看看它是否正在使用中。

返回

如果crtc属于mode_config，则为true，否则为false。

名称

drm_helper_disable_unused_functions —禁用未使用的对象

概要

void fsfuncdrm_helper_disable_unused_functions (dev);
struct drm_device * dev;

参数

锁定

调用者必须持有模式配置锁。

如果连接器或CRTC不属于dev的mode_config的一部分，则可以通过调用其dpms函数将其关闭，以将其关闭。

名称

drm_crtc_helper_set_mode —设置模式的内部辅助

概要

bool fsfuncdrm_crtc_helper_set_mode (   crtc,    mode,   x,  y,  old_fb);
struct drm_crtc * crtc;
struct drm_display_mode * mode;
int x;
int y;
struct drm_framebuffer * old_fb;

参数

锁定

调用者必须持有模式配置锁。

尝试crtc上设置mode。crtc在尝试设置模式之前，这是一个内部辅助功能，驱动程序可以用来更新属性，要求在新的配置中禁用和重新启用整个输出管道。例如，用于更改是否在hdmi链接上启用了音频，或用于更改面板fitter或抖动属性。drm_crtc_helper_set_config辅助函数也调用它 来驱动模式设置序列。

返回

如果成功设置了模式，则为true，否则为false。

名称

drm_crtc_helper_set_config-从用户空间设置新配置

概要

int fsfuncdrm_crtc_helper_set_config ( set);
struct drm_mode_set * set;

参数

锁定

调用者必须持有模式配置锁。

在set中设置由上层提供的新配置（来自用户空间的ioctl调用或内部的fbdev支持代码，例如fbdev支持代码），并启用他。这是驱动程序的主要辅助函数，它使用crtc辅助函数实现内核模式设置，这些驱动程序使用crtc帮助程序功能以及各种-> prepare，-> modeset和-> commithelper回调来实现内核模式设置。

返回

成功返回0，失败返回-ERRNO。

名称

drm_helper_connector_dpms —连接器dpms辅助实现

概要

void fsfuncdrm_helper_connector_dpms (    connector,   mode);
struct drm_connector * connector;
int mode;

参数

描述

这是crtc辅助程序框架提供的用于实现DPMS连接器属性的主要帮助程序功能。它为输出网格中的所有编码器和crtcs计算新的所需DPMS状态，并适当地调用驱动程序提供的->dpms 回调。

名称

drm_fb_helper_single_add_all_connectors —将所有连接器添加到fbdev仿真助手

概要

int fsfuncdrm_fb_helper_single_add_all_connectors (fb_helper);
struct drm_fb_helper * fb_helper;

参数

描述

此函数将添加所有可用的连接器，以与给定的fb_helper一起使用。这是一个单独的步骤，允许驱动程序自由地将连接器分配给fbdev，例如，如果某些连接器保留用于特殊目的或不足以用于fbcon。

由于这是发布fbdev之前的初始设置的一部分，因此不需要锁定。

名称

drm_fb_helper_debug_enter —-> fb_debug_enter的实现

概要

int fsfunc drm_fb_helper_debug_enter (info);
struct fb_info * info;

参数

名称

drm_fb_helper_debug_leave —-> fb_debug_leave的实现

概要

int fsfunc drm_fb_helper_debug_leave (info);
struct fb_info * info;

参数

名称

drm_fb_helper_restore_fbdev_mode —恢复fbdev配置

概要

bool fsfunc drm_fb_helper_restore_fbdev_mode (fb_helper);
struct drm_fb_helper * fb_helper;

参数

描述

使用此帮助程序在kms顶部实现fbcon时，应从驱动程序的drm-> lastclose回调中调用此函数。这样可以确保当X（x11，显示的上层server）死了时，用户不会看到黑屏。

名称

drm_fb_helper_blank —-> fb_blank的实现

概要

int fsfunc drm_fb_helper_blank (blank,   info);
int blank;
struct fb_info * info;

参数

名称

drm_fb_helper_init —初始化一个drm_fb_helper结构

概要

int fsfunc drm_fb_helper_init (   dev,     fb_helper,  crtc_count,     max_conn_count);
struct drm_device * dev;
struct drm_fb_helper * fb_helper;
int crtc_count;
int max_conn_count;

参数

描述

这将使用给定的限制为fbdev帮助程序分配结构。请注意，这还不会（通过驱动程序接口）接触硬件，也不会注册fbdev。 这仅在drm_fb_helper_initial_config完成，是为了允许驱动程序对确切的初始化顺序进行更多控制。

驱动程序必须在调用drm_fb_helper_initial_config之前设置fb_helper-> funcs 。

返回

如果一切正常，则为零，否则为非零。

名称

drm_fb_helper_setcmap —-> fb_setcmap的实现

概要

int fsfuncdrm_fb_helper_setcmap (  cmap,    info);
struct fb_cmap * cmap;
struct fb_info * info;

参数

名称

drm_fb_helper_check_var —-> fb_check_var的实现

概要

int fsfuncdrm_fb_helper_check_var (    var,     info);
struct fb_var_screeninfo * var;
struct fb_info * info;

参数

名称

drm_fb_helper_set_par —-> fb_set_par的实现

概要

int fsfuncdrm_fb_helper_set_par (   info);
struct fb_info * info;

参数

描述

这将使fbcon进行模式初始化，并在初始化时由fbdev内核在注册驱动程序时进行调用，然后再通过hotplug回调进行调用。

名称

drm_fb_helper_pan_display —-> fb_pan_display的实现

概要

int fsfuncdrm_fb_helper_pan_display (   var,     info);
struct fb_var_screeninfo * var;
struct fb_info * info;

参数

名称

drm_fb_helper_fill_fix —初始化固定的fbdev信息

概要

void fsfuncdrm_fb_helper_fill_fix (   info,    pitch,  depth);
struct fb_info * info;
uint32_t pitch;
uint32_t depth;

参数

描述

帮助程序可填充固定的fbdev信息，这些信息对于非加速的fbdev仿真非常有用。支持加有其他约束的加速方法的驱动程序需要设置自己的限制。

驱动程序应从其-> fb_probe回调中调用此代码（或等效的安装代码）。

名称

drm_fb_helper_fill_var —初始化变量fbdev信息

概要

void fsfuncdrm_fb_helper_fill_var (  info,    fb_helper,  fb_width,   fb_height);
struct fb_info * info;
struct drm_fb_helper * fb_helper;
uint32_t fb_width;
uint32_t fb_height;

参数

描述

根据给定的fb帮助程序实例和fb_helper-> fb中分配的drm帧缓冲区设置变量fbdev元信息。

在分配了fbdev后备存储帧缓冲区之后，驱动程序应从其-> fb_probe回调中调用此代码（或等效的安装代码）。

名称

drm_fb_helper_initial_config —设置合理的初始连接器配置

概要

bool fsfuncdrm_fb_helper_initial_config (  fb_helper,   bpp_sel);
struct drm_fb_helper * fb_helper;
int bpp_sel;

参数

描述

扫描CRTC和连接器，并尝试将初始设置放在一起。目前，这是所有源头的克隆配置，其中有一个新的framebuffer对象作为后备存储。

请注意，这还会注册fbdev，因此允许用户空间通过fbdev接口调用驱动程序。

该函数将调用-> fb_probe回调，以使驱动程序分配和初始化fbdev信息结构以及用于支持fbdev的drm帧缓冲区。drm_fb_helper_fill_var和 drm_fb_helper_fill_fix作为帮助程序来设置fbdev info结构的简单默认值。

返回

如果一切正常，则为零，否则为非零。

名称

drm_fb_helper_hotplug_event —通过探测附加到fb的所有输出来响应热插拔通知

概要

int fsfuncdrm_fb_helper_hotplug_event (   fb_helper);
struct drm_fb_helper * fb_helper;

争论

描述

通知输出配置的更改后，扫描连接到fb_helper的连接器，并尝试将设置汇总在一起。

在运行时调用，使用模式配置锁可以检查/更改模式集配置。必须从进程上下文运行（这通常意味着输出轮询工作或从驱动程序的热插拔中断启动的工作项）。

注意，驱动程序必须确保这仅是fb已完全设置后的唯一调用，即在调用drm_fb_helper_initial_config之后。

返回

成功时返回0，否则返回非零错误代码。

名称

struct drm_fb_helper_funcs — fbdev仿真库的驱动程序回调

概要

struct drm_fb_helper_funcs {void (* gamma_set) (struct drm_crtc *crtc, u16 red, u16 green,u16 blue, int regno);void (* gamma_get) (struct drm_crtc *crtc, u16 *red, u16 *green,u16 *blue, int regno);int (* fb_probe) (struct drm_fb_helper *helper,struct drm_fb_helper_surface_size *sizes);bool (* initial_config) (struct drm_fb_helper *fb_helper,struct drm_fb_helper_crtc **crtcs,struct drm_display_mode **modes,bool *enabled, int width, int height);
}; 

成员

描述

fbdev仿真帮助程序库使用的驱动程序回调。

名称

struct i2c_algo_dp_aux_data —基于dp aux算法的i2c的驱动程序接口结构

概要

struct i2c_algo_dp_aux_data {bool running;u16 address;int (* aux_ch) (struct i2c_adapter *adapter,int mode, uint8_t write_byte,uint8_t *read_byte);
};  

成员

名称

i2c_dp_aux_add_bus —使用辅助通道帮助程序注册i2c适配器

概要

int fsfunci2c_dp_aux_add_bus ( adapter);
struct i2c_adapter * adapter;

参数

描述

这将注册一个使用dp aux通道作为传输基础的i2c适配器。驱动程序需要填写i2c_algo_dp_aux_data结构并将其存储在algo_data成员的adapter参数中。i2c over dp aux算法将使用它来驱动硬件。

返回

成功时为0，失败时为-ERRNO。

名称

drm_edid_is_valid —完整性检查EDID数据

概要

bool fsfuncdrm_edid_is_valid ( edid);
struct edid * edid;

参数

描述

完整检查整个EDID记录（包括扩展名）

名称

drm_probe_ddc —

概要

bool fsfuncdrm_probe_ddc (   adapter);
struct i2c_adapter * adapter;

争论

描述

\ param适配器：i2c设备适配器\成功返回1

名称

drm_get_edid —获取EDID数据（如果有）

概要

struct edid * fsfuncdrm_get_edid (  connector,   adapter);
struct drm_connector * connector;
struct i2c_adapter * adapter;

参数

描述

如有可能，拨入给定的i2c通道以获取EDID数据。如果找到，将其连接到连接器。

返回edid数据；如果找不到，则返回NULL。

名称

drm_match_cea_mode —查找与给定模式匹配的CEA模式

概要

u8 fsfuncdrm_match_cea_mode (  to_match);
const struct drm_display_mode * to_match;

参数

描述

返回该模式的CEA视频ID（VIC）；如果不是CEA-861模式，则返回0。

名称

drm_edid_to_eld —从EDID生成ELD

概要

void fsfuncdrm_edid_to_eld (  connector,   edid);
struct drm_connector * connector;
struct edid * edid;

参数

描述

填充ELD（类似于EDID的数据）缓冲区以传递给音频驱动程序。

一些ELD字段留给图形驱动程序调用方

-Conn_Type-HDCP-Port_ID

名称

drm_edid_to_sad —从EDID中提取SAD

概要

int fsfuncdrm_edid_to_sad ( edid,    sads);
struct edid * edid;
struct cea_sad ** sads;

争论

描述

查找CEA EDID块并从中提取SAD（短音频描述符）。

注意

返回的指针需要kfreed

返回找到的SAD数或错误时返回负数。

名称

drm_edid_to_speaker_allocation —从EDID中提取扬声器分配的数据块

概要

int fsfuncdrm_edid_to_speaker_allocation (   edid,    sadb);
struct edid * edid;
u8 ** sadb;

参数

描述

查找CEA EDID块，并从中提取扬声器分配数据块。

注意

返回的指针需要kfreed

返回找到的扬声器分配块数或错误时返回负数。

名称

drm_av_sync_delay — HDMI / DP接收器音频-视频同步延迟（以毫秒为单位）

概要

int fsfuncdrm_av_sync_delay (    connector,   mode);
struct drm_connector * connector;
struct drm_display_mode * mode;

参数

名称

drm_select_eld —从多个HDMI / DP接收器中选择一个ELD

概要

struct drm_connector * fsfuncdrm_select_eld (  encoder,     mode);
struct drm_encoder * encoder;
struct drm_display_mode * mode;

参数

描述

一个编码器可能与多个HDMI / DP接收器关联。现在，已对该策略进行了硬编码，以仅使用第一个HDMI / DP接收器的ELD。

名称

drm_detect_hdmi_monitor —检测显示器是否为hdmi。

概要

bool fsfuncdrm_detect_hdmi_monitor (   edid);
struct edid * edid;

参数

描述

根据CEA-861-B解析CEA扩展名。如果HDMI，则返回true，否则返回false，否则返回未知。

名称

drm_detect_monitor_audio —检查监视器音频功能

概要

bool fsfuncdrm_detect_monitor_audio ( edid);
struct edid * edid;

参数

描述

显示器应具有CEA扩展块。如果显示器具有“基本音频”，但没有CEA音频块，则仅是“基本音频”。如果有任何音频扩展块和支持的音频格式，则即使在EDID中未定义“基本音频”，也至少要假定“基本音频”支持。

名称

drm_rgb_quant_range_selectable — RGB量化范围可以选择吗？

概要

bool fsfuncdrm_rgb_quant_range_selectable (  edid);
struct edid * edid;

参数

描述

检查显示器是否报告支持的RGB量化范围选择。然后可以使用AVI信息帧通知监视器使用了哪个量化范围（完整或有限）。

名称

drm_add_edid_modes —从EDID数据添加模式（如果有）

概要

int fsfuncdrm_add_edid_modes (    connector,   edid);
struct drm_connector * connector;
struct edid * edid;

参数

描述

将指定的模式添加到连接器的模式列表中。

返回添加的模式数量，如果找不到则返回0。

名称

drm_add_modes_noedid —为没有EDID的连接器添加模式

概要

int fsfuncdrm_add_modes_noedid ( connector,   hdisplay,   vdisplay);
struct drm_connector * connector;
int hdisplay;
int vdisplay;

参数

描述

将指定的模式添加到连接器的模式列表中。仅当hdisplay / vdisplay不超过给定限制时，才会添加它。

返回添加的模式数量，如果找不到则返回0。

名称

drm_hdmi_avi_infoframe_from_display_mode —用来自DRM显示模式的数据填充HDMI AVI信息帧

概要

int fsfuncdrm_hdmi_avi_infoframe_from_display_mode (    frame,   mode);
struct hdmi_avi_infoframe * frame;
const struct drm_display_mode * mode;

参数

描述

成功返回0，失败返回负错误代码。

名称

drm_hdmi_vendor_infoframe_from_display_mode —用来自DRM显示模式的数据填充HDMI信息帧

概要

int fsfuncdrm_hdmi_vendor_infoframe_from_display_mode (    frame,   mode);
struct hdmi_vendor_infoframe * frame;
const struct drm_display_mode * mode;

参数

描述

请注意，仅在使用4k或立体3D模式时才需要发送HDMI供应商信息帧。因此，当提供任何其他模式作为输入时，此函数将返回-EINVAL，该错误可以安全地忽略。

成功返回0，失败返回负错误代码。

名称

struct drm_rect —二维矩形

概要

struct drm_rect {int x1;int y1;int x2;int y2;
};  

成员

名称

drm_rect_adjust_size —调整矩形的大小

概要

void fsfuncdrm_rect_adjust_size (    r,   dw,     dh);
struct drm_rect * r;
int dw;
int dh;

参数

描述

改变矩形r的大小由dw在水平方向上，并且通过dh在垂直方向上，同时保持r的中心固定不动。

正dw和dh增加大小，负值减少它。

名称

drm_rect_translate —平移矩形

概要

void fsfuncdrm_rect_translate (   r,   dx,     dy);
struct drm_rect * r;
int dx;
int dy;

参数

描述

移动矩形r，dx在水平方向上 ，dy在垂直方向上移动矩形。

名称

drm_rect_downscale —缩小矩形

概要

void fsfuncdrm_rect_downscale (    r,   horz,   vert);
struct drm_rect * r;
int horz;
int vert;

参数

描述

矩形的坐标r除以horz和vert。

名称

drm_rect_width —确定矩形的宽度

概要

int fsfuncdrm_rect_width (    r);
const struct drm_rect * r;

参数

返回

矩形的宽度。

名称

drm_rect_height —确定矩形的高度

概要

int fsfuncdrm_rect_width (r);
const struct drm_rect * r;

参数

返回

矩形的高度。

名称

drm_rect_visible —确定矩形是否可见

概要

int fsfuncdrm_rect_height (  r);
const struct drm_rect * r;

参数

返回

true如果矩形可见，false否则。

名称

drm_rect_equals —确定两个矩形是否相等

概要

bool fsfuncdrm_rect_equals (    r1,  r2);
const struct drm_rect * r1;
const struct drm_rect * r2;

参数

返回

true如果矩形相等，false否则。

名称

drm_rect_intersect —与两个矩形相交

概要

bool fsfuncdrm_rect_intersect ( r1,  r2);
struct drm_rect * r1;
const struct drm_rect * r2;

参数

描述

计算矩形r1和的交点r2。 r1将被相交处覆盖。

返回

true如果矩形r1在操作后仍然可见， false否则。

名称

drm_rect_clip_scaled —执行缩放的剪辑操作

概要

bool fsfuncdrm_rect_clip_scaled (   src,     dst,    clip,   hscale,     vscale);
struct drm_rect * src;
struct drm_rect * dst;
const struct drm_rect * clip;
int hscale;
int vscale;

参数

描述

用矩形clip 剪辑矩形dst。裁剪矩形src以相同数量乘以hscale和vscale。

返回

true如果矩形dst在裁剪后仍然可见， false否则

名称

drm_rect_calc_hscale —计算水平缩放因子

概要

int fsfuncdrm_rect_calc_hscale (    src,     dst,    min_hscale,     max_hscale);
const struct drm_rect * src;
const struct drm_rect * dst;
int min_hscale;
int max_hscale;

参数

描述

将水平缩放系数计算为（src宽度）/（dst宽度）。

返回

水平缩放因子或超出范围的错误。

名称

drm_rect_calc_vscale —计算垂直比例因子

概要

int fsfuncdrm_rect_calc_vscale (  src,     dst,    min_vscale,     max_vscale);
const struct drm_rect * src;
const struct drm_rect * dst;
int min_vscale;
int max_vscale;

参数

描述

将垂直缩放系数计算为（src高度）/（dst高度）。

返回

垂直比例因子或超出范围的错误值。

名称

drm_rect_calc_hscale_relaxed —计算水平缩放因子

概要

int fsfuncdrm_rect_calc_hscale_relaxed ( src,     dst,    min_hscale,     max_hscale);
struct drm_rect * src;
struct drm_rect * dst;
int min_hscale;
int max_hscale;

参数

描述

将水平缩放系数计算为（src宽度）/（dst宽度）。

如果计算出的比例因子小于min_vscale，则减小矩形的高度以dst进行补偿。

如果计算出的比例因子大于max_vscale，则减小矩形的高度以src进行补偿。

返回

水平缩放因子。

名称

drm_rect_calc_vscale_relaxed —计算垂直比例因子

概要

int fsfuncdrm_rect_calc_vscale_relaxed (   src,     dst,    min_vscale,     max_vscale);
struct drm_rect * src;
struct drm_rect * dst;
int min_vscale;
int max_vscale;

参数

描述

将垂直缩放系数计算为（src高度）/（dst高度）。

如果计算出的比例因子小于min_vscale，则减小矩形的高度以dst进行补偿。

如果计算出的比例因子大于max_vscale，则减小矩形的高度以src进行补偿。

返回

垂直比例因子。

名称

drm_rect_debug_print —打印矩形信息

概要

void fsfuncdrm_rect_debug_print ( r,   fixed_point);
const struct drm_rect * r;
bool fixed_point;

参数

名称

struct drm_flip_work —翻转工作队列

概要

struct drm_flip_work {const char * name;atomic_t pending;atomic_t count;drm_flip_func_t func;struct work_struct worker;
};  

成员

名称

drm_flip_work_queue —工作队列

概要

void fsfuncdrm_flip_work_queue (    work,    val);
struct drm_flip_work * work;
void * val;

参数

描述

队列工作，该工作随后将在drm_flip_work_commit调用后在工作队列上运行（传递回drm_flip_func_t func）。

名称

drm_flip_work_commit —提交排队的工作

概要

void fsfuncdrm_flip_work_commit (  work,    wq);
struct drm_flip_work * work;
struct workqueue_struct * wq;

参数

描述

触发先前排队的工作drm_flip_work_queue以在工作队列上运行。典型的用法是（通过 drm_flip_work_queue）在任何点（通过vblank irq和/或之前）对工作进行排队，然后从vblank irq提交排队的工作。

名称

drm_flip_work_init —初始化翻转工作

概要

int fsfuncdrm_flip_work_init (    work,    size,   name,   func);
struct drm_flip_work * work;
int size;
const char * name;
drm_flip_func_t func;

参数

描述

初始化/分配用于翻转作业的资源

返回

成功为零，失败为错误代码。

名称

drm_flip_work_cleanup —清理翻转工作

概要

void fsfuncdrm_flip_work_cleanup ( work);
struct drm_flip_work * work;

参数

描述

销毁分配给filp-work的资源

名称

drm_vma_offset_manager_init —初始化新的偏移量管理器

概要

void fsfuncdrm_vma_offset_manager_init (   mgr,     page_offset,    size);
struct drm_vma_offset_manager * mgr;
unsigned long page_offset;
unsigned long size;

参数

描述

初始化一个新的偏移量管理器。可用于管理器的偏移量和区域大小以page_offset和size给出。两者单位都为页码，而不是字节。

从管理器添加/删除节点在内部被锁定，并且可以防止并发访问。但是，节点分配和销毁留给调用方。调用vma-manager时，必须始终保证引用了给定节点。

名称

drm_vma_offset_manager_destroy —销毁偏移量管理器

概要

void fsfuncdrm_vma_offset_manager_destroy (    mgr);
struct drm_vma_offset_manager * mgr;

参数

描述

销毁先前通过drm_vma_offset_manager_init创建的对象管理器 。在销毁管理器之前，调用者必须删除所有分配的节点。否则，drm_mm将拒绝释放请求的资源。

调用此函数后，不得再访问此管理器。

名称

drm_vma_offset_lookup —在偏移空间中查找节点

概要

struct drm_vma_offset_node * fsfuncdrm_vma_offset_lookup (  mgr,     start,  pages);
struct drm_vma_offset_manager * mgr;
unsigned long start;
unsigned long pages;

参数

描述

查找具有给定起始地址和对象大小的节点。这将返回给定节点的_best_匹配项。也就是说，start只要该节点指向整个有效区域（给定的页面数为pages），就可以指向某个有效区域中的某个位置并返回给定的节点。

返回

如果找不到合适的节点，则返回NULL。否则，将返回最佳匹配。调用者有责任确保在调用者访问节点之前不会破坏该节点。

名称

drm_vma_offset_lookup_locked —在偏移空间中查找节点

概要

struct drm_vma_offset_node * fsfuncdrm_vma_offset_lookup_locked (  mgr,     start,  pages);
struct drm_vma_offset_manager * mgr;
unsigned long start;
unsigned long pages;

参数

描述

与drm_vma_offset_lookup相同，但要求调用者手动锁定偏移量查找。请参阅drm_vma_offset_lock_lookup示例。

返回

如果找不到合适的节点，则返回NULL。否则，将返回最佳匹配。

名称

drm_vma_offset_add —将偏移量节点添加到管理器

概要

int fsfuncdrm_vma_offset_add (    mgr,     node,   pages);
struct drm_vma_offset_manager * mgr;
struct drm_vma_offset_node * node;
unsigned long pages;

参数

描述

将节点添加到offset-manager。如果已添加节点，则不执行任何操作，并返回0。pages是对象的大小（以页数为单位）。成功执行此调用后，您可以访问节点的偏移量，直到再次将其删除为止。

如果此调用失败，则可以安全地重试该操作或调用drm_vma_offset_remove。但是，在这种情况下，不需要清理。

pages不需要与要映射的基础内存对象大小相同。它仅限制了用户空间可以映射到其地址空间的大小。

返回

成功时为0，失败时为负错误代码。

名称

drm_vma_offset_remove —从管理器中删除偏移节点

概要

void fsfuncdrm_vma_offset_remove (  mgr,     node);
struct drm_vma_offset_manager * mgr;
struct drm_vma_offset_node * node;

参数

描述

从偏移管理器中删除节点。如果之前未添加节点，则不会执行任何操作。此调用返回后，偏移量和大小将为0，直到drm_vma_offset_add再次分配新的偏移量为止。辅助函数类似于 drm_vma_node_start，drm_vma_node_offset_addr如果没有分配偏移量，它将返回0。

名称

drm_vma_node_allow-将打开文件添加到允许的用户列表中

概要

int fsfuncdrm_vma_node_allow (  node,    filp);
struct drm_vma_offset_node * node;
struct file * filp;

参数

描述

添加filp到此节点允许的打开文件列表。如果filp已在此列表中，则引用计数将增加。

允许的用户列表保留在drm_vma_offset_add和 drm_vma_offset_remove调用之间。如果该节点当前未添加到任何偏移量管理器中，您甚至可以调用它。

在销毁节点之前，您必须删除所有打开文件的次数与添加它们的次数相同。否则，您将泄漏内存。

这是在内部禁止并发访问的。

返回

成功时为0，内部失败时为负错误代码（内存不足）

名称

drm_vma_node_revoke —从允许的用户列表中删除打开文件

概要

void fsfuncdrm_vma_node_revoke (  node,    filp);
struct drm_vma_offset_node * node;
struct file * filp;

参数

描述

减少filp上允许的打开文件列表node中的ref-count 。如果引用计数降至零，filp则从列表中删除。你必须调用此一次，每drm_vma_node_allow上filp。

这是在内部禁止并发访问的。

如果filp不在列表中，则什么也不做。

名称

drm_vma_node_is_allowed —检查是否授予打开文件访问权限

概要

bool fsfuncdrm_vma_node_is_allowed ( node,    filp);
struct drm_vma_offset_node * node;
struct file * filp;

参数

描述

在当前node搜索列表是否filp在允许的打开文件列表中（请参阅参考资料drm_vma_node_allow）。

这是在内部禁止并发访问的。

返回

真的，如果filp在清单上

名称

drm_vma_offset_exact_lookup —按确切地址查找节点

概要

struct drm_vma_offset_node * fsfuncdrm_vma_offset_exact_lookup ( mgr,     start,  pages);
struct drm_vma_offset_manager * mgr;
unsigned long start;
unsigned long pages;

参数

描述

与drm_vma_offset_lookup节点相同，但不允许向节点偏移。它仅返回具有给定起始地址的确切对象。

返回

节点位于确切的起始地址start。

名称

drm_vma_offset_lock_lookup-锁定查找以供扩展私人使用

概要

void fsfuncdrm_vma_offset_lock_lookup (   mgr);
struct drm_vma_offset_manager * mgr;

参数

描述

锁定VMA Manager以进行扩展查找。_locked按住此锁定仅允许* VMA函数调用。在通过drm_vma_offset_unlock_lookup释放锁定之前，所有其他上下文都无法访问VMA 。

如果您需要在重新释放此锁之前引用drm_vma_offset_lookup_locked返回的对象，请使用此方法 。

除扩展查找外，不得将此锁用于任何其他用途。按住此锁定时，不得调用任何其他VMA帮助器。

注意

持有此锁，您处于原子上下文中！

例

     drm_vma_offset_lock_lookup(mgr);node = drm_vma_offset_lookup_locked(mgr);if (node)kref_get_unless_zero(container_of(node, sth, entr));drm_vma_offset_unlock_lookup(mgr);

名称

drm_vma_offset_unlock_lookup —解锁查找以供扩展私人使用

概要

void fsfuncdrm_vma_offset_unlock_lookup (   mgr);
struct drm_vma_offset_manager * mgr;

参数

描述

释放查找锁定。请参阅drm_vma_offset_lock_lookup以获取更多信息。

名称

drm_vma_node_reset —初始化或重置节点对象

概要

void fsfuncdrm_vma_node_reset (    node);
struct drm_vma_offset_node * node;

参数

描述

将节点重置为其初始状态。在与任何VMA偏移管理器一起使用之前，必须先调用它。

不得在已分配的节点上调用此方法，否则会泄漏内存。

名称

drm_vma_node_start —返回基于页面的寻址的起始地址

概要

unsigned long fsfuncdrm_vma_node_start (   node);
struct drm_vma_offset_node * node;

参数

描述

返回给定节点的起始地址。可以用作VMA偏移管理器提供的线性VM空间中的偏移。请注意，这只能用于基于页面的寻址。如果您需要为用户空间映射提供适当的偏移量，则必须应用“ << PAGE_SHIFT ”或使用 drm_vma_node_offset_addr辅助程序。

返回

node用于基于页面的寻址的 起始地址。如果节点未分配偏移量，则为0。

名称

drm_vma_node_size —返回大小（基于页面）

概要

unsigned long fsfuncdrm_vma_node_size (   node);
struct drm_vma_offset_node * node;

参数

描述

以给定节点的页面数形式返回大小。这与传递给drm_vma_offset_add的大小相同。如果没有为节点分配偏移量，则为0。

返回

node页数的 大小。如果节点未分配偏移量，则为0。

名称

drm_vma_node_has_offset —检查是否将节点添加到偏移管理器

概要

bool fsfuncdrm_vma_node_has_offset (  node);
struct drm_vma_offset_node * node;

参数

返回

如果先前已为节点分配了偏移并将其添加到vma偏移管理器，则为true。

名称

drm_vma_node_offset_addr —返回用户空间mmap的已清理偏移量

概要

__u64 fsfuncdrm_vma_node_offset_addr (    node);
struct drm_vma_offset_node * node;

参数

描述

与相同，drm_vma_node_start但返回地址作为有效偏移量，可在期间用于用户空间映射mmap。不能在未链接的节点上调用它。

返回

node基于字节的寻址的 偏移量。如果节点未分配对象，则为0。

名称

drm_vma_node_unmap —取消映射偏移量节点

概要

void fsfuncdrm_vma_node_unmap (  node,    file_mapping);
struct drm_vma_offset_node * node;
struct address_space * file_mapping;

参数

描述

取消映射给定偏移节点的所有用户空间映射。映射必须与file_mapping地址空间关联。如果不存在偏移量或地址空间无效，则不执行任何操作。

此呼叫已解锁。调用方必须保证drm_vma_offset_remove 不会在此节点上同时调用。

名称

drm_vma_node_verify_access — TTM的访问验证帮助器

概要

int fsfuncdrm_vma_node_verify_access (   node,    filp);
struct drm_vma_offset_node * node;
struct file * filp;

参数

描述

这将检查是否filp授予对的访问权限node。它与drm_vma_node_is_allowed相同， 但很适合 TTM verify_access回调的插入助手。

返回

如果授予访问权限，则为0，否则为-EACCES。