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)