GLib.unix_fd_add
Description: Reference for GLib.unix_fd_add

### Function

# GLibunix_fd_add

since: 2.36

#### Declaration

    guint
    g_unix_fd_add (
      gint fd,
      GIOCondition condition,
      GUnixFDSourceFunc function,
      gpointer user_data
    )

#### Description

Sets a function to be called when the IO condition, as specified by `condition` becomes true for `fd`.

`function` will be called when the specified IO condition becomes `TRUE`. The function is expected to clear whatever event caused the IO condition to become true and return `TRUE` in order to be notified when it happens again. If `function` returns `FALSE` then the watch will be cancelled.

The return value of this function can be passed to `g_source_remove()` to cancel the watch at any time that it exists.

The source will never close the fd — you must do it yourself.

Available since: 2.36

This function is not directly available to language bindings.

#### Parameters

`fd`

  Type: `gint`

  A file descriptor.

`condition`

  Type: `GIOCondition`

  IO conditions to watch for on `fd`.

`function`

  Type: `GUnixFDSourceFunc`

  A `GUnixFDSourceFunc`.

`user_data`

  Type: `gpointer`

  Data to pass to `function`.

  The argument can be `NULL`.
  The data is owned by the caller of the function.

#### Return value

Type: `guint`

The ID (greater than 0) of the event source.