GUnixFDMessage
GUnixFDMessage — A GSocketControlMessage containing a GUnixFDList
|
|
Includes
#include <gio/gunixfdmessage.h>
Functions
g_unix_fd_message_get_fd_list ()
GUnixFDList *
g_unix_fd_message_get_fd_list (GUnixFDMessage *message);
Gets the GUnixFDList contained in message
. This function does not
return a reference to the caller, but the returned list is valid for
the lifetime of message
.
Since: 2.24
g_unix_fd_message_append_fd ()
gboolean
g_unix_fd_message_append_fd (GUnixFDMessage *message,
gint fd,
GError **error);
Adds a file descriptor to message
.
The file descriptor is duplicated using dup(). You keep your copy
of the descriptor and the copy contained in message
will be closed
when message
is finalized.
A possible cause of failure is exceeding the per-process or
system-wide file descriptor limit.
Returns
TRUE in case of success, else FALSE (and error
is set)
Since: 2.22
g_unix_fd_message_steal_fds ()
gint *
g_unix_fd_message_steal_fds (GUnixFDMessage *message,
gint *length);
Returns the array of file descriptors that is contained in this
object.
After this call, the descriptors are no longer contained in
message
. Further calls will return an empty list (unless more
descriptors have been added).
The return result of this function must be freed with g_free().
The caller is also responsible for closing all of the file
descriptors.
If length
is non-NULL then it is set to the number of file
descriptors in the returned array. The returned array is also
terminated with -1.
This function never returns NULL. In case there are no file
descriptors contained in message
, an empty array is returned.
Returns
an array of file
descriptors.
[array length=length][transfer full]
Since: 2.22
Types and Values
struct GUnixFDMessage
struct GUnixFDMessage;
GUnixFDMessage is an opaque data structure and can only be accessed
using the following functions.
Property Details
The “fd-list” property
“fd-list” GUnixFDList *
The GUnixFDList object to send with the message.
Owner: GUnixFDMessage
Flags: Read / Write / Construct Only