diff options
| author | Mattias Andrée <maandree@kth.se> | 2019-10-22 18:59:27 +0200 |
|---|---|---|
| committer | Mattias Andrée <maandree@kth.se> | 2019-10-22 18:59:27 +0200 |
| commit | bf4020471356938b9181a33984f511ffdd7ff25b (patch) | |
| tree | 7f9a9abd1ae51318cd435f0ed7471be5f33b478c /libcoopgamma_get_crtcs_recv.3 | |
| parent | List radharc's priority (diff) | |
| download | libcoopgamma-bf4020471356938b9181a33984f511ffdd7ff25b.tar.gz libcoopgamma-bf4020471356938b9181a33984f511ffdd7ff25b.tar.bz2 libcoopgamma-bf4020471356938b9181a33984f511ffdd7ff25b.tar.xz | |
Change license, change style, clean up, flat file hier, clean valgrind output in test
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'libcoopgamma_get_crtcs_recv.3')
| -rw-r--r-- | libcoopgamma_get_crtcs_recv.3 | 63 |
1 files changed, 63 insertions, 0 deletions
diff --git a/libcoopgamma_get_crtcs_recv.3 b/libcoopgamma_get_crtcs_recv.3 new file mode 100644 index 0000000..02f8daa --- /dev/null +++ b/libcoopgamma_get_crtcs_recv.3 @@ -0,0 +1,63 @@ +.TH LIBCOOPGAMMA_GET_CRTCS_RECV 3 LIBCOOPGAMMA +.SH "NAME" +libcoopgamma_get_crtcs_recv - Receive a list of all available CRTC:s +.SH "SYNOPSIS" +.nf +#include <libcoopgamma.h> + +char **libcoopgamma_get_crtcs_recv(libcoopgamma_context_t *restrict \fIctx\fP, + libcoopgamma_async_context_t *restrict \fIasync\fP); +.fi +.P +Link with +.IR -lcoopgamma . +.SH "DESCRIPTION" +The +.BR libcoopgamma_get_crtcs_recv () +function parses the response for the requests +sent using the +.BR libcoopgamma_get_crtcs_send () +function with the same +.I ctx +and +.I async +arguments. The +.I async +must have been selected by the last call to the +.BR libcoopgamma_synchronise (3) +function. +.SH "RETURN VALUES" +Upon successful completion, the +.BR libcoopgamma_get_crtcs_recv () +function returns a +.I NULL +terminated +list of all available CRTC:s. If possible, +the CRTC:s are named by the connected +monitors' EDID:s. None of the elements can +contain a NUL or LF byte. The elements in +the list are subpointers of the returned +pointer. The user shall free the returned +pointer, which effectively frees all its +elements. On error, +.I NULL +is returned and +.I errno +is set appropriately. +.SH "ERRORS" +The +.BR libcoopgamma_get_crtcs_recv () +function may fail for any reason specified for +.BR malloc (3). +The function may also fail for the following reasons: +.TP +.B EBADMSG +The received message was corrupt. +.SH "SEE ALSO" +.BR libcoopgamma_async_context_destroy (3), +.BR libcoopgamma_synchronise (3), +.BR libcoopgamma_get_crtcs_send (3), +.BR libcoopgamma_get_crtcs_sync (3), +.BR libcoopgamma_get_gamma_info_recv (3), +.BR libcoopgamma_get_gamma_recv (3), +.BR libcoopgamma_set_gamma_recv (3) |