sunos man page for allocb_tmpl

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

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

       allocb_tmpl()  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
       allocb_tmpl() can be called from user or interrupt context.

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

       Writing Device Drivers

       STREAMS Programming Guide

SunOS 5.10							    18 Feb 2003 						   allocb_tmpl(9F)