grio_associate_file(3X)

NAME
     grio_associate_file - associate a grio stream id with a specific file

SYNOPSIS
     #include <grio.h>
     int grio_associate_file( int fd, stream_id_t *stream_id);

DESCRIPTION
     grio_associate_file marks the file indicated by fd so that when the
     current process accesses the file it will receive the I/O at the rate
     guaranteed by the grio stream stream_id.

DIAGNOSTICS
     A zero will be returned if the stream id is successfully associated with
     the file. On failure, -1 will be returned and errno will be set to the
     following:

     EIO            the fd or stream_id is invalid

     EPERM          the characteristics of the stream_id prevent the transfer.
                    This error is returned for any one of the following
                    conditions.  The rate guarantee was created with the
                    PER_FILE_GUAR flag set, and the user is attempting to
                    transfer the guarantee to a different file.  The rate
                    guarantee was created with the PROC_PRIVATE_GUAR flag set,
                    and the current user is not the creator of the guarantee.
                    The filesystem where the file resides is different from
                    the one on which the rate guarantee was created.

     EPERM          The requesting proocess is not priviledged enough to use
                    grio. For this, the process needs CAP_DEVICE_MGMT or has
                    to have root permissions.

FILES
     /etc/grio_disks

SEE ALSO
     ggd(1M), grio_query_fs(3X), grio_action_list(3X), grio_reserve_file(3X),
     grio_reserve_fs(3X), grio_unreserve_bw(3X), grio_disk(4), grio(5)