aboutsummaryrefslogtreecommitdiffstats
path: root/libcoopgamma_context_marshal.3
blob: aa7feea78a1b29ee0705fca1307ec9306e7f439a (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
.TH LIBCOOPGAMMA_CONTEXT_MARSHAL 3 LIBCOOPGAMMA
.SH "NAME"
libcoopgamma_context_marshal - Marshal a libcoopgamma_context_t
.SH "SYNOPSIS"
.nf
#include <libcoopgamma.h>

size_t libcoopgamma_context_marshal(libcoopgamma_context_t *restrict \fIthis\fP,
                                    void *restrict \fIbuffer\fP);
.fi
.P
Link with
.IR -lcoopgamma .
.SH "DESCRIPTION"
The
.BR libcoopgamma_context_marshal ()
function marshals
.I this
into a
.I buffer
that can be sent to another process on any computer
with a compatible processor. A compatible processor
is any processor with the same endianness, encoding
and sizes of the intrinsic data types and
.IR size_t .
However, it is probably nonsensical to send the
marshalled data to any other process than the
process itself since it contains a file descriptor.
.SH "RETURN VALUES"
The
.BR libcoopgamma_context_marshal ()
function returns the number of bytes stored in the
.IR buffer ,
or if
.I buffer
is
.IR NULL ,
the the number of bytes that would have
been written if it was not
.IR NULL .
The function is always successful.
.SH "SEE ALSO"
.BR libcoopgamma_context_destroy (3),
.BR libcoopgamma_context_unmarshal (3),
.BR libcoopgamma_ramps_marshal (3),
.BR libcoopgamma_filter_marshal (3),
.BR libcoopgamma_crtc_info_marshal (3),
.BR libcoopgamma_filter_query_marshal (3),
.BR libcoopgamma_queried_filter_marshal (3),
.BR libcoopgamma_filter_table_marshal (3),
.BR libcoopgamma_error_marshal (3),
.BR libcoopgamma_async_context_marshal (3)