*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> grio_reserve_fs (3x)              


grio_reserve_fs(3X)					   grio_reserve_fs(3X)

NAME    [Toc]    [Back]

     grio_reserve_fs - request a guaranteed rate I/O reservation on a file

SYNOPSIS    [Toc]    [Back]

     #include <grio.h>
     int grio_reserve_fs( dev_t	fs_dev,	grio_resv_t *griorp);

DESCRIPTION    [Toc]    [Back]

     grio_reserve_fs tries to obtain the I/O-rate guarantee specified by the
     griorp structure on the file system built on the device specified by

     The contents of the structure pointed to by griorp	includes the following

	  Start	time of	the guarantee in seconds since January 1, 1970.

	  Duration of the guarantee in seconds.

	  The length of	the rate guarantee time	quantum	in microseconds.

	  The amount of	data guaranteed	to be read/written within the time

	  This is the stream identifier	returned by the	routine	when a rate
	  guarantee has	been established.

	  The flags in this field determine the	characteristics	of the rate
	  guarantee.  The following flags are defined:

			   Only	the calling process can	use the	rate
			   guarantee. If cannot	be transferred to other

	  PROC_SHARE_GUAR  The rate guarantee can be transferred to other

	  FIXED_ROTOR_GUAR Obtain a "rotor" type of guarantee and do not allow
			   the rotoration slot to change once it has been
			   established.	(this is also known as a VOD

									Page 1

grio_reserve_fs(3X)					   grio_reserve_fs(3X)

	  SLIP_ROTOR_GUAR  This	is the same type of rate guarantee as
			   FIXED_ROTOR_GUAR except that	the system will	allow
			   the process's rotation slot to change if necessary.

	  NON_ROTOR_GUAR   Obtain an ordinary type of rate guarantee (nonrotor).

			   Use realtime	scheduling to satisfy the rate
			   guarantee. The process will be suspended if it
			   tries to perform I/O	at a rate greater than its
			   guarantee.If	not specified, the default behavior is
			   to allow the	process	to exceed its guaranteed rate,
			   if there is available device	bandwidth.

	  NON_SCHED_GUAR   Do not enforce the I/O rate scheduling. It is
			   assumed that	the calling process will regulate the
			   rate	at which I/O requests are issued.

DIAGNOSTICS    [Toc]    [Back]

     On	success, a zero	is returned indicating that a rate guarantee has been
     granted and the stream indentifier	of the rate guarantee is returned in
     the gr_stream_id field. In	order to make use of this reservation, a
     grio_associate_file call has to be	made at	a future time when the
     application needs the reservation to be activated.	 If the	desired	rate
     cannot be guaranteed a -1 is returned. In case of success,	the system
     will make every effort to honour the guarantee if the file	system has a
     realtime partition	and is part of an XLV.	The errno variable is set to
     indicate the error.  The following	error codes are	defined:

     [EIO]     The calling process could not communicate with the ggd daemon.

     [EBADF]   The specified file system does not exist.

     [EIO]     The specified start time	is invalid, or there is	an invalid set
	       of flags	specified in the gr_flags field.

     [ENOSPC]  The requested bandwidth could not be guaranteed.	Upon return
	       the gr_opsize and gr_optime fields describe the maximum
	       bandwidth left for reservation. The gr_errordev field contains
	       the name	of the device where the	bandwidth was not available.

     [EPERM]   The process does	not have root permissions or CAP_DEVICE_MGMT

     [EINVAL]  The input griorp	is invalid.

     [EACCESS] All the disks in	the xlv	comprising the file system do not have
	       the same	iosize,	or the iosize of one or	more disks was

									Page 2

grio_reserve_fs(3X)					   grio_reserve_fs(3X)

FILES    [Toc]    [Back]


SEE ALSO    [Toc]    [Back]

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

									PPPPaaaaggggeeee 3333
[ Back ]
 Similar pages
Name OS Title
grio_reserve_file IRIX request a guaranteed rate I/O reservation on a file
grio IRIX guaranteed-rate I/O
grio_bandwidth IRIX determines guaranteed-rate I/O device bandwidth
grio_unreserve_bw IRIX remove an I/O rate guarantee reservation
rapi_reserve Tru64 Make, modify, or delete a Resource ReSerVation Protocol (RSVP) session reservation
rapi_getfd Tru64 Get the file descriptor for the Resource ReSerVation Protocol (RSVP) daemon's socket
aifcresample IRIX perform sampling rate conversion on an AIFF-C file
grio_disks IRIX description of guaranteed I/O rates for disk devices
rlp HP-UX send LP print request to a remote system
wakeupat IRIX request that system power back on at a future time
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service