Function

GLibunix_open_pipe

since: 2.30

Declaration

gboolean
g_unix_open_pipe (
  gint* fds,
  gint flags,
  GError** error
)

Description

Similar to the UNIX pipe() call, but on modern systems like Linux uses the pipe2() system call, which atomically creates a pipe with the configured flags. The only supported flag currently is FD_CLOEXEC. If for example you want to configure O_NONBLOCK, that must still be done separately with fcntl().

This function does not take O_CLOEXEC, it takes FD_CLOEXEC as if for fcntl(); these are different on Linux/glibc.

Available since: 2.30

Parameters

fds

Type: An array of gint

Array of two integers.

The array must have 2 elements.

The data is owned by the caller of the function.

flags

Type: gint

Bitfield of file descriptor flags, as for fcntl()

error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.

If the return location is not NULL, then you must initialize it to a NULL GError*.

The argument will be left initialized to NULL by the function if there are no errors.

In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: gboolean

TRUE on success, FALSE if not (and errno will be set).