Content-type: text/html Man page of allocb_tmpl

allocb_tmpl

Section: Kernel Functions for Drivers (9F)
Updated: 16 Jan 2006
Index Return to Main Contents
 

NAME

allocb_tmpl - allocate a message block using a template  

SYNOPSIS

#include <sys/stream.h>

mblk_t *allocb_tmpl(size_t size, const mblk_t *tmpl);

 

INTERFACE LEVEL

Solaris DDI specific (Solaris DDI)  

PARAMETERS

size

The number of bytes in the message block.

tmpl

The template message block.

 

DESCRIPTION

The allocb_tmpl() function tries to allocate a STREAMS message block using allocb(9F). If the allocation is successful, the db_type field in the data block structure (dblk_t, see datab(9S)), as well as some implementation-private data, are copied from the dblk_t associated with tmpl.

The allocb_tmpl() function should be used when a new STREAMS message block is allocated. This block is then used to contain data derived from another STREAMS message block. The original message is used as the tmpl argument.  

RETURN VALUES

Upon success, allocb_tmpl() returns a pointer to the allocated message block of the same type as tmpl. On failure, allocb_tmpl() returns a NULL pointer.  

CONTEXT

The allocb_tmpl() function can be called from user, interrupt, or kernel context.  

SEE ALSO

allocb(9F), datab(9S), msgb(9S)


 

Index

NAME
SYNOPSIS
INTERFACE LEVEL
PARAMETERS
DESCRIPTION
RETURN VALUES
CONTEXT
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:44 GMT, October 02, 2010