@CHIP-RTOS C Library V2.06 - TCP/IP API
sendto_iface
Transmit a datagram via specified interface. int sendto_face ( int sd, const char far *bufptr, int bufLen,
int flags, const struct sockaddr far *toPtr,
DevUserIfaceHandle DevHandlePtr,
int *error ); Parameters
sd
- Socket descriptor.
bufptr
- Pointer to output buffer containing
characters to be transmitted.
bufLen
- Maximum characters to output from bufptr
.
flags
- Wait option:
- MSG_BLOCKING
- Wait for data send to complete.
- MSG_DONTWAIT
- Don't wait for data send to complete.
toPtr
- Data destination, pointer to a
sockaddr_in
(IPv4) or
sockaddr_in6
(IPv6, SC123/SC143 only!
) data structure.
DevHandlePtr
- Driver handle pointer
Device handle,
which caller must fill in prior to call. TCPIP send the packet via this specified
Device handle.
error
- Output parameter: Failure
code, 0 on success.
Return Value
- -1: Failure, see error value reported
otherwise: Count of bytes transfered into the socket send queue.
Comments
- This API function applies only to UDP sockets and works similiar than the
sendto function.
It is required, when the user wants to send a datagram with a multicast destination
address via a specified device interface.
It is not necessary to use this function, if the packet should by send via
the default ethernet interface of the IPC@CHIP.
The existing API function sendto function
does this by default, if a the multicast destination address is specified.
SC1x3 Comments- The actual library function reached here is named
sendto_ipstackV2
. The name change
occurs due to a macro in the library header file.
See Also
RTOS API
- This library function invokes a RTOS software interrupt.
Refer to this RTOS API function's
documentation
for more details.
Supported since or modified in @CHIP-RTOS version-
SC12 | SC13 | SC11 | SC1x3 |
-
V1.21 | V1.21 | V1.21 | V1.10 |
This API List
List of C Libraries
@CHIP-RTOS Main Index
End of document
|