grio_associate_file(3X)				       grio_associate_file(3X)

NAME    [Toc]    [Back]

     grio_associate_file - associate a grio stream id with a specific file

SYNOPSIS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     /etc/grio_disks

SEE ALSO    [Toc]    [Back]

     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)


									PPPPaaaaggggeeee 1111