이전 기사에서 계속: libdrm six 전체 분석 - 소스 코드 전체 분석(3)
이 문서는 다음 블로그 게시물을 참조합니다.
매우 감사합니다!
이 기사에서는 계속해서 include/drm/drm.h의 실제 함수 매크로 정의를 설명합니다.
5. DRM_IOCTL_GET_MAP
다섯 번째 매크로는 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의 정의는 다음과 같이 맨 위에 있습니다.
/*
* 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에 해당하는 사용자 공간 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
여섯 번째 매크로는 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에 해당하는 사용자 공간 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 장치의 모든 클라이언트 프로세스를 가져오는 것입니다. 이 기능은 나중에 기능을 자세히 설명할 때 자세히 분석해 보겠습니다. 먼저 서로를 알아가며 감상해보자.
나머지 매크로 정의는 후속 기사에서 계속 분석됩니다.