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 /doc/man/libcoopgamma_set_gamma_send.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 'doc/man/libcoopgamma_set_gamma_send.3')
-rw-r--r-- | doc/man/libcoopgamma_set_gamma_send.3 | 140 |
1 files changed, 0 insertions, 140 deletions
diff --git a/doc/man/libcoopgamma_set_gamma_send.3 b/doc/man/libcoopgamma_set_gamma_send.3 deleted file mode 100644 index 18c13f0..0000000 --- a/doc/man/libcoopgamma_set_gamma_send.3 +++ /dev/null @@ -1,140 +0,0 @@ -.TH LIBCOOPGAMMA_SET_GAMMA_SEND 3 LIBCOOPGAMMA -.SH "NAME" -libcoopgamma_set_gamma_send - Send a request to add, update, or remove a gamma ramp filter for CRTC -.SH "SYNOPSIS" -.nf -#include <libcoopgamma.h> - -int libcoopgamma_set_gamma_send(const libcoopgamma_filter_t *restrict \fIfilter\fP, - libcoopgamma_context_t *restrict \fIctx\fP, - libcoopgamma_async_context_t *restrict \fIasync\fP); -.fi -.P -Link with -.IR -lcoopgamma . -.SH "DESCRIPTION" -The -.BR libcoopgamma_set_gamma_send () -function sends a request over the connection of -.I ctx -to add, update, or remove a gamma ramp filter for -the CRTC with the name given in -.IR filter->crtc . -Information about the request is stored in -.IR *async , -this information is used by -.BR libcoopgamma_synchronise (3) -to identify the response, and by -.BR libcoopgamma_get_gamma_recv (3) -to parse the response. -.P -A filter with the class (identifier) -.I filter->class -is removed if -.I filter->lifespan -is -.IR LIBCOOPGAMMA_REMOVE . -If -.I filter->lifespan -is not -.IR LIBCOOPGAMMA_REMOVE , -a filter with matching class is updated -if such filter exists, otherwise the filter is -added. The fitler, unless it is removed, is -inserted or moved to the priority specified by -.IR filter->priority . -.I filter->priority -is isregarded when -.I filter->lifespan -is -.IR LIBCOOPGAMMA_REMOVE . -A filter with high priority is applied before -a fitler with low priority. The filter is removed -when it is explicit removed used -.IR LIBCOOPGAMMA_REMOVE , -or if -.I filter->lifespan -is -.IR LIBCOOPGAMMA_UNTIL_DEATH , -when the client that last added or updated -the filter disconnects from the server, which -ever comes first. Note that, when updating a -filter, the lifespan is updated to -.IR filter->lifespan . -.P -The class -.RI ( filter->class ) -must be of the format -\fI${PACKAGE_NAME}\fP\fB::\fP\fI${COMMAND_NAME}\fP\fB::\fP\fI${RULE}\fP, -where -.I ${PACKAGE_NAME} -is the name of the package as installed on the system, -the program should make it easy to adjust this; -.I ${COMMAND_NAME} -is the name of the program, this too should not -easily adjustable, and -.I ${RULE} -is a string that identifies filter uniquely within -the program, or can be hardcoded or runtime -configurable. -.P -Unless -.I filter->lifespan -is -.IR LIBCOOPGAMMA_REMOVE , -.I filter->depth -and -.I filter->ramps -must be configured to specified the desired ramp values. -.SH "RETURN VALUES" -Upon successful completion, the -.BR libcoopgamma_set_gamma_send () -function returns 0. On error, -1 is returned and -.I errno -is set appropriately. -.SH "ERRORS" -The -.BR libcoopgamma_set_gamma_send () -function may fail for any reason specified for -.BR malloc (3), -.BR realloc (3), -or -.BR libcoopgamma_flush (3). -Particularly interesting exceptional -conditions, that are not errors proper, include -those indicated by the following values on -.IR errno : -.TP -.B EINTR -The function was interrupted by a signal. When -this happens, call -.BR libcoopgamma_flush (3) -to resume. -.TP -.BR EAGAIN " or " EWOULDBLOCK -The communication is nonblocking and the buffer -between the server and the client is full, -and no more data can be queued without blocking. -When this happens, wait a short period of time -and call -.BR libcoopgamma_flush (3) -to resume. -.BR select (3) -or similar function can be used to wait until -.I ctx->fd -is readable. -.TP -.B ECONNREST -The connection to the server has closed. -.SH "SEE ALSO" -.BR libcoopgamma.h (0), -.BR libcoopgamma_filter_initialise (3), -.BR libcoopgamma_async_context_initialise (3), -.BR libcoopgamma_flush (3), -.BR libcoopgamma_synchronise (3), -.BR libcoopgamma_set_nonblocking (3), -.BR libcoopgamma_set_gamma_recv (3), -.BR libcoopgamma_set_gamma_sync (3), -.BR libcoopgamma_get_crtcs_send (3), -.BR libcoopgamma_get_gamma_send (3), -.BR libcoopgamma_set_gamma_send (3) |