GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
DRMMODEGETRESOURCES(3) Direct Rendering Manager DRMMODEGETRESOURCES(3)

drmModeGetResources - retrieve current display configuration information

#include <xf86drm.h>

#include <xf86drmMode.h>

drmModeResPtr drmModeGetResources(int fd);

drmModeGetResources allocates, populates, and returns a drmModeRes structure containing information about the current display configuration. The structure contains the following fields:

typedef struct _drmModeRes {
    int count_fbs;
    uint32_t *fbs;
    int count_crtcs;
    uint32_t *crtcs;
    int count_connectors;
    uint32_t *connectors;
    int count_encoders;
    uint32_t *encoders;
    uint32_t min_width, max_width;
    uint32_t min_height, max_height;
} drmModeRes, *drmModeResPtr;


The count_fbs and fbs fields indicate the number of currently allocated framebuffer objects (i.e., objects that can be attached to a given CRTC or sprite for display).

The count_crtcs and crtcs fields list the available CRTCs in the configuration. A CRTC is simply an object that can scan out a framebuffer to a display sink, and contains mode timing and relative position information. CRTCs drive encoders, which are responsible for converting the pixel stream into a specific display protocol (e.g., MIPI or HDMI).

The count_connectors and connectors fields list the available physical connectors on the system. Note that some of these may not be exposed from the chassis (e.g., LVDS or eDP). Connectors are attached to encoders and contain information about the attached display sink (e.g., width and height in mm, subpixel ordering, and various other properties).

The count_encoders and encoders fields list the available encoders on the device. Each encoder may be associated with a CRTC, and may be used to drive a particular encoder.

The min_* and max_* fields indicate the maximum size of a framebuffer for this device (i.e., the scanout size limit).

drmModeGetResources returns a drmModeRes structure pointer on success, NULL on failure. The returned structure must be freed with drmModeFreeResources(3).

Bugs in this function should be reported to https://gitlab.freedesktop.org/mesa/drm/-/issues

drm(7), drm-kms(7), drmModeGetFB(3), drmModeAddFB(3), drmModeAddFB2(3), drmModeRmFB(3), drmModeDirtyFB(3), drmModeGetCrtc(3), drmModeSetCrtc (3), drmModeGetEncoder (3), drmModeGetConnector(3)
September 2012

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.