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

  man pages->IRIX man pages -> grio_reserve_file (3x)              
Title
Content
Arch
Section
 

Contents


grio_reserve_file(3X)					 grio_reserve_file(3X)


NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #include <grio.h>
     int grio_reserve_file( int	fd, grio_resv_t	*griorp);

DESCRIPTION    [Toc]    [Back]

     grio_reserve_file tries to	obtain the I/O-rate guarantee specified	by the
     griop structure on	the file associated with fd.

     The contents of the structure pointed to by griop includes	the following
     members:

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

     gr_duration
	  Duration of the guarantee in seconds.

     gr_optime
	  The length of	the rate guarantee time	quantum	in microseconds.

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

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

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

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

	  PROC_SHARE_GUAR  The rate guarantee can be transferred to other
			   processes.

	  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
			   reservation)

	  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.




									Page 1






grio_reserve_file(3X)					 grio_reserve_file(3X)



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


	  REALTIME_SCHED_GUAR
			   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	is a realtime
     file on an	XFS filesystem.	 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 does not exist or already has	a rate
	       guarantee from this process.

     [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.

     [ENOENT]  The specified file does not contain any extents.	It is empty.

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

     [EINVAL]  The input fd or 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
	       invalid.






									Page 2






grio_reserve_file(3X)					 grio_reserve_file(3X)


FILES    [Toc]    [Back]

     /etc/grio_disks

SEE ALSO    [Toc]    [Back]

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


									PPPPaaaaggggeeee 3333
[ Back ]
 Similar pages
Name OS Title
grio_reserve_fs IRIX request a guaranteed rate I/O reservation on a file system
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
ttdt_Save HP-UX request a ToolTalk client to save a file
ttdt_Revert HP-UX request a ToolTalk client to revert a file
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service