Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Anchor10902751090275 NetARP_CacheGetAddrHW() Anchor12642821264282Get the hardware address corresponding to a specific ARP cache’s protocol address. Anchor10902771090277

Files

...

10902781090278net_arp.h/net_arp.c Anchor10902791090279

Prototype

        *p_addr_hw
                                                  NET_ARP_ADDR_LEN   addr_hw_len_buf,
CPU_INT08U *paddr_protocol,

                                                  CPU_INT08U        *p_addr_protocol,
                                                  NET_ARP_ADDR_LEN   addr_protocol_len,
NET_ERR *perr);
HTML Table
summary
classCode_Listing
Table Row (tr)
Table Cell (td)
rowspan5
Anchor
11225371122537
Code Block

          NET_ARP_ADDR_LEN NetARP_CacheGetAddrHW (CPU_INT08U
*paddr_hw
Anchor
11225391122539
Anchor
11225411122541
Anchor
11225431122543
Anchor
11225451122545
Table Row (tr)
Table Row (tr)
Table Row (tr)
Table Row (tr)

...


                                                  NET_ERR           *p_err);

Arguments

p_addr_hw

Pointer to a memory buffer that will receive the hardware address:

...

Hardware address that corresponds to the desired protocol address, if no errors; hardware address cleared to all zeros, otherwise.

Anchor10902901090290addr_hw_len_buf Anchor12508261250826

Size of hardware address memory buffer (in bytes).

Anchor10902911090291 paddrp_addr_protocolanchor12508331250833

Pointer to the specific protocol address.

Anchor10902921090292addr_protocol_lenanchor12508401250840

Length of protocol address (in bytes).

Anchor10902931090293 perr Anchor12508471250847p_err

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

...

...

NET_ARP_ERR_NONE

...

NET_ARP_ERR_NULL_PTR

...

NET_ARP_ERR_INVALID_HW_ADDR_LEN

...

NET_ARP_ERR_INVALID_PROTOCOL_ADDR_LEN

...


...

NET_ARP_ERR_CACHE_NOT_FOUND

...

NET_ARP_ERR_CACHE_PEND

...

Returned Value

Anchor12222451222245Length of returned hardware address, if available; Anchor

122224612222460, otherwise. Anchor12222411222241

Required Configuration

...

1090304Available only if an appropriate network interface layer is present (e.g., Ethernet; see section D-7-3 on page 748). Anchor10903051090305 Notes / Warnings Anchor10903061090306IPv4 is enabled, see IPv4 Layer Configuration

Notes / Warnings

NetARP_CacheGetAddrHW() may be used in conjunction with NetARP_ProbeAddrOnNet() to determine if a specific protocol address is available on the local network.