grio_get_stream(3x)

NAME
     grio_get_stream - map a bound file descriptor to its stream ID

C SYNOPSIS
     #include <grio2.h>

     int grio_get_stream(
             grio_descriptor_t fd,
             grio_stream_id_t *stream_id);

     cc ... -lgrio2

PARAMETERS
     fd        An open file descriptor.

     stream_id User-allocated buffer for the returned stream ID.

DESCRIPTION
     Given a file descriptor fd grio_get_stream returns the ID of the stream
     to which it is bound.

DIAGNOSTICS
     On success, 0 is returned and the stream ID is copied to stream_id. If
     the file descriptor is not bound to a GRIO stream a -1 is returned and
     errno is set to indicate the error. The following error codes are
     defined:

     EBADF     Bad file descriptor.

     ENOENT    The file descriptor is not bound to a stream.

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

FILES
     /etc/griotab

SEE ALSO
     grio2(5), grio_avail(3X), grio_modify(3X), grio_release(3X),
     grio_reserve(3X), grio_unbind(3X)