grio_unbind(3x)

NAME
     grio_unbind - unbind a file descriptor from its GRIO stream

C SYNOPSIS
     #include <grio2.h>

     int grio_unbind(grio_descriptor_t fd);

     cc ... -lgrio2

PARAMETERS
     fd        An open file descriptor.

DESCRIPTION
     grio_unbind unbinds a file descriptor from its GRIO stream.

     Unbinding a file descriptor decrements the reference count of its stream
     by 1.

     Once unbound, I/O to or from the file descriptor may continue, but will
     be scheduled as regular, non-guaranteed rate I/O.

DIAGNOSTICS
     On success, 0 is returned and the file descriptor is unbound from its
     GRIO stream. If the file descriptor is invalid or not currently bound to
     a GRIO stream, -1 is returned and errno is set to indicate the error.
     The following error codes are defined:

     EBADF     Bad file descriptor.

     EINVAL    File descriptor was not bound.

     EPERM     The process does not have root permissions or CAP_DEVICE_MGMT
               privilege.

FILES
     /etc/griotab

SEE ALSO
     grio2(5), grio_avail(3X), grio_get_stream(3X), grio_modify(3X),
     grio_release(3X), grio_reserve(3X), grio_reserve_fd(3X), grio_bind(3X)