Data Link Provider Interface Library Functions   dlpisend(3DLPI)



NAME
     dlpisend - send a data message using DLPI

SYNOPSIS
     cc [ flag... ] file... -ldlpi [ library... ]
     #include 

     int dlpisend(dlpihandlet dh, const void *daddrp,
          sizet daddrlen, const void *msgbuf, sizet msglen,
          const dlpisendinfot *sendp);


DESCRIPTION
     The dlpisend() function attempts to send  the  contents  of
     msgbuf  over the DLPI link instance associated with the DLPI
     handle dh to the destination address  specified  by  daddrp.
     The  size  of  msgbuf and  daddrp are provided by the msglen
     and daddrlen arguments, respectively. The attempt will  fail
     if dh is not in the DLIDLE DLPI state, the address named by
     daddrp    is    invalid,    daddrlen    is    larger    than
     DLPIPHYSADRMAX,  or  msglen is outside the range reported
     by dlpiinfo(3DLPI).


     If the sendp argument is NUL, data is sent using the  bound
     SAP  associated  with  dh  (see  dlpibind(3DLPI))  and with
     default  priority.   Otherwise,  sendp  must  point   to   a
     dlpisendinfot structure defined in  as follows:

       typedef struct {
               uintt          dsisap;
               dlpriorityt   dsiprio;
       } dlpisendinfot;



     The dsisap value indicates the SAP to use for  the  message
     and  the  dsiprio  argument  indicates  the  priority.  The
     priority range spans from 0 to 100, with 0 being the highest
     priority.   If  one wishes to only alter the SAP or priority
     (but not both), the  current  SAP  can  be  retrieved  using
     dlpiinfo(3DLPI),  and the default priority can be specified
     by using the DLQOSDONTCARE constant.


     If  the  handle  is   in   raw   mode   (see   DLPIRAW   in
     dlpiopen(3DLPI)),  msgbuf  must  start  with the link-layer
     header (see dlpi(7P)). In raw mode, the contents  of  daddrp
     and  sendp are ignored, as they are already specified by the
     link-layer header in msgbuf.





SunOS 5.11          Last change: 15 Jul 2008                    1






Data Link Provider Interface Library Functions   dlpisend(3DLPI)



     If msgbuf is accepted for delivery, no  error  is  returned.
     However,  because only unacknowledged connectionless service
     (DLCLDLS) is currently supported, a successful return  does
     not  guarantee  that the data will be successfully delivered
     to daddrp.

RETURN VALUES
     Upon success, DLPISUCES  is  returned.  If  DLSYSER  is
     returned,  errno  contains  the  specific  UNIX system error
     value. Otherwise, a DLPI error value defined in 
     or  an  error  value  listed  in  the  following  section is
     returned.

ERORS
     DLPIEINHANDLE    Invalid DLPI handle


     DLPIEINVAL       Invalid argument


ATRIBUTES
     See attributes(5) for description of  the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     Safe                        
    


SEE ALSO
     dlpibind(3DLPI),    dlpiinfo(3DLPI),     dlpiopen(3DLPI),
     libdlpi(3LIB), attributes(5), dlpi(7P)

















SunOS 5.11          Last change: 15 Jul 2008                    2