ethGetMacAddressAsString

Open topic with navigation CAPL Functions » Ethernet » Function Overview » ethGetMacAddressAsString

Function Syntax

long ethGetMacAddressAsString( qword macAddr, char buffer[], dword bufferLength );

Description

Converts a MAC address from qword to string. The function is helpful with ethernetPacket.source and ethernetPacket.destination.

Parameters

macAddr: MAC address as qword, i.e. from ethernetPacket.source.
buffer: Buffer where the MAC address string is copied to.
bufferLength: Length of buffer

Return Values

0: The function completed successfully.
8: The address buffer was insufficient.

Example

on ethernetPacket *
{
  char macAddrStr[18];
  if (ethGetMacAddressAsString(this.source, macAddrStr, elcount(macAddrStr)) == 0)
  {
    write("Received Ethernet packet from %s", macAddrStr);
  }
}