libdrm全解析七 —— 源码全解析（4）

本文参考以下博文：

特此致谢！

本文继续对include/drm/drm.h中实际功能宏定义进行讲解。

5. DRM_IOCTL_GET_MAP

第5个宏是DRM_IOCTL_GET_MAP，相应代码如下：

#define DRM_IOCTL_GET_MAP               DRM_IOWR(0x04, struct drm_map)

结合之前文章中的_IOWR(type,nr,size)的最终定义，得到如下代码：

#define DRM_IOCTL_GET_MAP		( ((3)  << 30) | (('d') << 8) | ((0x04)   << 0) | ((sizeof(struct drm_map)) << 16) )

struct drm_map在同文件（include/drm/drm.h）中定义，代码如下：

/*
 * DRM_IOCTL_GET_MAP, DRM_IOCTL_ADD_MAP and DRM_IOCTL_RM_MAP ioctls
 * argument type.
 *
 * \sa drmAddMap().
 */
struct drm_map {
	unsigned long offset;	 /**< Requested physical address (0 for SAREA)*/
	unsigned long size;	 /**< Requested physical size (bytes) */
	enum drm_map_type type;	 /**< Type of memory to map */
	enum drm_map_flags flags;	 /**< Flags */
	void *handle;		 /**< User-space: "Handle" to pass to mmap() */
				 /**< Kernel-space: kernel-virtual address */
	int mtrr;		 /**< MTRR slot used */
	/*   Private data */
};

drm_map_type和drm_map_flags的定义都是在上边，分别如下：

扫描二维码关注公众号，回复： 16370291 查看本文章

/*
 * Type of memory to map.
 */
enum drm_map_type {
	_DRM_FRAME_BUFFER = 0,	  /**< WC (no caching), no core dump */
	_DRM_REGISTERS = 1,	  /**< no caching, no core dump */
	_DRM_SHM = 2,		  /**< shared, cached */
	_DRM_AGP = 3,		  /**< AGP/GART */
	_DRM_SCATTER_GATHER = 4,  /**< Scatter/gather memory for PCI DMA */
	_DRM_CONSISTENT = 5	  /**< Consistent memory for PCI DMA */
};

/*
 * Memory mapping flags.
 */
enum drm_map_flags {
	_DRM_RESTRICTED = 0x01,	     /**< Cannot be mapped to user-virtual */
	_DRM_READ_ONLY = 0x02,
	_DRM_LOCKED = 0x04,	     /**< shared, cached, locked */
	_DRM_KERNEL = 0x08,	     /**< kernel requires access */
	_DRM_WRITE_COMBINING = 0x10, /**< use write-combining if available */
	_DRM_CONTAINS_LOCK = 0x20,   /**< SHM page that contains lock */
	_DRM_REMOVABLE = 0x40,	     /**< Removable mapping */
	_DRM_DRIVER = 0x80	     /**< Managed by driver */
};

drm_map结构中各成员的意义代码注释描述得很清楚了，在此无需赘述。

DRM_IOCTL_GET_MAP对应的Userspace API为：drmGetMap()。该函数也是在xf86drm.c中，代码如下：

drm_public int drmGetMap(int fd, int idx, drm_handle_t *offset, drmSize *size,
                         drmMapType *type, drmMapFlags *flags,
                         drm_handle_t *handle, int *mtrr)
{
    drm_map_t map;

    memclear(map);
    map.offset = idx;
    if (drmIoctl(fd, DRM_IOCTL_GET_MAP, &map))
        return -errno;
    *offset = map.offset;
    *size   = map.size;
    *type   = (drmMapType)map.type;
    *flags  = (drmMapFlags)map.flags;
    *handle = (unsigned long)map.handle;
    *mtrr   = map.mtrr;
    return 0;
}

函数的作用是从中获取内存映射（map）的相关信息。此函数在后文具体讲解函数的时候进行详细解析。在此先认识一下、有个印象就好。

6. DRM_IOCTL_GET_CLIENT

第6个宏是DRM_IOCTL_GET_CLIENT，相应代码如下：

#define DRM_IOCTL_GET_CLIENT            DRM_IOWR(0x05, struct drm_client)

结合之前文章中的_IOWR(type,nr,size)的最终定义，得到如下代码：

#define DRM_IOCTL_GET_CLIENT		( ((3)  << 30) | (('d') << 8) | ((0x05)   << 0) | ((sizeof(struct drm_client)) << 16) )

struct drm_client在同文件（include/drm/drm.h）中定义，代码如下：

/*
 * DRM_IOCTL_GET_CLIENT ioctl argument type.
 */
struct drm_client {
	int idx;		/**< Which client desired? */
	int auth;		/**< Is client authenticated? */
	unsigned long pid;	/**< Process ID */
	unsigned long uid;	/**< User ID */
	unsigned long magic;	/**< Magic */
	unsigned long iocs;	/**< Ioctl count */
};

drm_client结构中的各成员的意义代码注释描述得很清楚了，在此无需赘述。

DRM_IOCTL_GET_CLIENT对应的Userspace API为：drmGetClient()。该函数也是在xf86drm.c中，代码如下：

drm_public int drmGetClient(int fd, int idx, int *auth, int *pid, int *uid,
                            unsigned long *magic, unsigned long *iocs)
{
    drm_client_t client;

    memclear(client);
    client.idx = idx;
    if (drmIoctl(fd, DRM_IOCTL_GET_CLIENT, &client))
        return -errno;
    *auth      = client.auth;
    *pid       = client.pid;
    *uid       = client.uid;
    *magic     = client.magic;
    *iocs      = client.iocs;
    return 0;
}

函数的作用是获取当前DRM设备上的所有client进程。此函数在后文具体讲解函数的时候进行详细解析。在此先认识一下、有个印象就好。

其余宏定义将在后续文章中继续解析。