www.beck-ipc.com

@CHIP-RTOS C Library V2.06 - TCP/IP API


sendto

Transmit a datagram.

int sendto ( int sd, const char far *bufptr, int bufLen,
             int flags, const struct sockaddr far *toPtr,
             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.

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.   This function will output up to bufLen bytes from the buffer at bufptr to the IP address specified by the sockaddr_in (IPv4) structure or the sockaddr_in6 (IPv6, SC123/SC143 only! ) structure referenced by the toPtr parameter.

This function's prototype takes a pointer to the generic type sockaddr for its toPtr parameter, for compatibility between IPv4 and IPv6 protocols.   The pointer to the sockaddr_in (IPv4) or sockaddr_in6 (IPv6, SC123/SC143 only! ) data structure which is actually used should be cast to a sockaddr type pointer to avoid compiler warnings, "Suspicious pointer conversion".

The MSG_BLOCKING mode will not work if the socket has been put into non-blocking mode using the Set_Blocking_Mode API.

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

    SC12SC13SC11SC1x3
    V1.00V1.00V1.00V0.90

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document