Kernel Functions for Drivers                        dlbindack(9F)



NAME
     dlbindack, dlphysaddrack, dlokack, dlerrorack,  dluderrorind
     - DLPI device driver helper functions

SYNOPSIS
     #include 



     void dlokack(queuet *wq, mblkt *mp, tuscalart correctprimitive);


     void dlerrorack(queuet *wq, mblkt *mp, tuscalart errorprimitive,
          tuscalart error, tuscalart unixerrno);


     void dlbindack(queuet *wq, mblkt *mp, tscalart sap, const void *addrp,
          tuscalart addrlen, tuscalart maxconind,  tuscalart xidtest);


     void dlphysaddrack(queuet *wq, mblkt *mp, const void *addrp,
          tuscalart addrlen);


     void dluderrorind(queuet *wq, mblkt *mp, const void *addrp,
          tuscalart addrlen, tuscalart error, tuscalart unixerrno);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

PARAMETERS
     wq                   Streams write queue.


     mp                   Pointer to the bind request message.


     sap                  Service access point being requested.


     addrp                Pointer  to  the  dlpi   layer   source
                          address.


     addrlen              Size of the dlpi layer address  pointed
                          to by addr.


     maxconind            Maximum number of  DLCONECTIND  mes-
                          sages  allowed  to  be  outstanding per
                          stream.



SunOS 5.11          Last change: 16 Jan 2006                    1






Kernel Functions for Drivers                        dlbindack(9F)



     xidtest              The XID and TEST responses supported.


     correctprimitive    Identifies the DL primitive  completing
                          successfully.


     errorprimitive      Identifies the DL primitive in error.


     error                DLPI error associated with the  failure
                          in the DLPI request.


     unixerrno           Corresponding UNIX  system  error  that
                          can  be  associated with the failure in
                          the DLPI request.


DESCRIPTION
     All functions described in this manpage take  a  pointer  to
     the message passed to the DLPI provider (mblkt) and attempt
     to reuse it in formulating the MPROTO reply. If the message
     block  is  too small to be reused, it is freed and a new one
     is allocated.


     All functions reply upstream using  qreply(9F).  The  write-
     side queue pointer must be provided.


     The dlokack() function provides the successfull acknowledge-
     ment  DLOKACK  message  reply  to the DLPI provider and is
     used to complete many of the DLPI requests in the DLPI  con-
     sumer.


     The dlerrorack() function provides  the  unsuccessfull  ack-
     nowledgement  DLERORACK  message reply to the DLPI() pro-
     vider and is used for error completions  were  required  for
     DLPI requests in the DLPI consumer.


     The dlbindack() function provides  the  DLBINDACK  message
     reply  to  the  DLPI  provider  and  is used to complete the
     DLBINDREQ processing in the DLPI consumer.


     The dlphysaddrack() function provides the ()DLPHYSADRACK
     message reply used to complete the DLPHYSADRACK process-
     ing.




SunOS 5.11          Last change: 16 Jan 2006                    2






Kernel Functions for Drivers                        dlbindack(9F)



     The dluderrorind() function provides the DLUDERORIND mes-
     sage reply used to complete an unsuccessful DLUNITDATAREQ.

RETURN VALUES
     None.

NOTES
     These functions are not required if you are  are  writing  a
     DLPI device driver using gld(7D).

CONTEXT
     All DLPI helper functions can be called  from  user,  inter-
     rupt, or kernel context.

SEE ALSO
     gld(7D), dlpi(7P), qreply(9F)


     Writing Device Drivers


     STREAMS Programming Guide

































SunOS 5.11          Last change: 16 Jan 2006                    3