getrbuf man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

getrbuf(9F)		 Kernel Functions for Drivers		   getrbuf(9F)

NAME
       getrbuf - get a raw buffer header

SYNOPSIS
       #include <sys/buf.h>
       #include <sys/kmem.h>
       #include <sys/ddi.h>

       struct buf *getrbuf(int sleepflag);

INTERFACE LEVEL
       Architecture independent level 1 (DDI/DKI).

PARAMETERS
       sleepflag       Indicates whether driver should sleep for free space.

DESCRIPTION
       The  getrbuf()  function allocates the space for a buffer header to the
       caller. It is used in cases where a  block  driver  is  performing  raw
       (character  interface)  I/O and needs to set up a buffer header that is
       not associated with the buffer cache.

       The getrbuf() function calls kmem_alloc(9F) to perform the memory allo‐
       cation.	kmem_alloc()requires the information included in the sleepflag
       argument. If sleepflag is set to KM_SLEEP, the driver may  sleep	 until
       the  space  is  freed up. If sleepflag is set to KM_NOSLEEP, the driver
       will not sleep.	In either case, a pointer to the  allocated  space  is
       returned or NULL to indicate that no space was available.

RETURN VALUES
       The  getrbuf()  function	 returns  a  pointer  to  the allocated buffer
       header, or NULL if no space is available.

CONTEXT
       The getrbuf() function can be called from user,	interrupt,  or	kernel
       context.	 (Drivers  must not allow getrbuf() to sleep if called from an
       interrupt routine.)

SEE ALSO
       bioinit(9F), freerbuf(9F), kmem_alloc(9F), kmem_free(9F)

       Writing Device Drivers

SunOS 5.10			  16 Jan 2006			   getrbuf(9F)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net