Kernel Functions for Drivers                       miocpullup(9F)



NAME
     miocpullup - Prepare the payload of an MIOCTL  message  for
     access

SYNOPSIS
     #include 
     #include 



     int miocpullup(mblkt *mp, sizet size);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

PARAMETERS
     mp      MIOCTL message.


     size    Number of bytes to prepare.


DESCRIPTION
     The miocpullup() function prepares the payload of the speci-
     fied MIOCTL message for access by ensuring that it consists
     of at least size bytes of data.


     If the MIOCTL message is transparent, or its total  payload
     is  less  than size bytes, an error is returned.  Otherwise,
     the payload is concatenated as necessary to provide contigu-
     ous  access  to  at  least  size bytes of data. As a special
     case, if size is zero,  miocpullup()  returns  successfully,
     even if no payload exists.

RETURN VALUES
     Zero is returned on success. Otherwise  an  errno  value  is
     returned indicating the problem.

CONTEXT
     This function can be called from user, kernel  or  interrupt
     context.

SEE ALSO
     STREAMS Programming Guide









SunOS 5.11          Last change: 9 June 2004                    1