Page Comparison

Configure socket's transmit IP IPv4 multicast Time to live (TTL).

Files

net_sock.h/net_sock.c

Prototype

          CPU_BOOLEAN NetSock_CfgTxIP_TTL_Multicast(NET_SOCK_ID  sock_id,
                                                    NET_IP_TTL   ip_ttl
                                                    NET_ERR     *p_err);

Arguments

sock_id

This is the socket ID of socket to configure transmit IP TTL.

...

ip_ttl

Desired transmit IP IPv4 multicast TTL:

NET_IPIPv4_TTL_MIN:  Minimum TTL transmit value (1)
NET_IPIPv4_TTL_MAX:  Maximum TTL transmit value (255)
NET_IPIPv4_TTL_DFLT: Default TTL transmit value (1)
NET_IPIPv4_TTL_NONE: Replace with default TTL 

p_err

perr

Pointer to variable that will receive the return error code from this function:

NET_SOCK_ERR_NONE
NET_SOCK_ERR_NOT_USED
NET_SOCK_ERR_INVALID_STATE
NET_SOCK_ERR_INVALID_OP
NET_SOCK_ERR_API_DIS
NET_INIT_ERR_INITNOT_INCOMPLETECOMPLETED
NET_SOCK_ERR_INVALID_SOCK
NET_CONN_ERR_INVALID_ARG
NET_CONN_ERR_INVALID_CONN
NET_CONN_ERR_NOT_USED
NET_OSERR_ERRFAULT_LOCK_ACQUIRE

Returned Value

DEF_OK,

Socket transmit IP IPv4 multicast TTL successfully configured;

DEF_FAIL,

otherwise.

Required Configuration

Available only if if NET_SOCKIPv4_CFG_FAMILY is configured for IPv4 sockets (see section D-15-1 “NET_SOCK_CFG_FAMILY”EN is enabled (see section IPv4 Layer Configuration).

Notes / Warnings

None.