Real time embedded FreeRTOS RSS feed 
Homepage FreeRTOS+ Products FreeRTOS Labs Integration Services Contact / Enquiries

FreeRTOS_inet_ntoa()

[FreeRTOS Embedded IP Stack API]

FreeRTOS_sockets.h
void FreeRTOS_inet_ntoa( uint32_t ulIPAddress, uint8_t *pucBuffer )
		

A macro that converts an IP address expressed as a 32-bit number in network byte order to a string in decimal dot notation (for example "192.168.0.200").

The standard Berkeley sockets inet_ntoa() function returns a pointer to a string that is normally stored in a global buffer. FreeRTOS_inet_ntoa() deviates from the normal semantics by instead taking the buffer into which the string is written as a parameter. The deviation is to ensure the macro is re-entrant and thread aware.

Parameters:

ulIPAddress   An IP address expressed as a 32-bit value in network byte order.

pucBuffer   A pointer to a buffer into which the IP address will be written in decimal dot notation.

Example usage:

The example on the FreeRTOS_recvfrom() documentation page demonstrates FreeRTOS_inet_ntoa() being used to print the IP address from which a message was received.

The example on the FreeRTOS_GetAddressConfiguration() documentation page demonstrates FreeRTOS_inet_ntoa() being used to print out the network configuration - including the IP address and net mask of the node, and the IP addresses of the gateway and DNS server respectively.


[ Back to the top ]    [ About FreeRTOS ]    [ FreeRTOS+ Sitemap ]    [ Main FreeRTOS Sitemap ]    [ ]


Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.