grio_associate_file(3X)grio_associate_file(3X)NAMEgrio_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);
DESCRIPTIONgrio_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 process 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
NOTE
The guaranteed rate I/O capabilities described in this man page refer to
the version one GRIO implementation. Refer to grio2(5) for information
covering the newer GRIO Version 2 implementation which supports both
local and clustered XVM volumes.
SEE ALSOggd(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)
Page 1
