The constructor of the abs_eap_am_tools_c does nothing special.

The destructor of the abs_eap_am_tools_c class does nothing special.

The cancel_all_timers() function cancels all timers. User should use this in termination of the stack before the adaptation module of tools is deleted.

Adaptation module of tools includes internal attribute eap_timer_queue_c to which this call is directed.

This function de-activated timer queue. You could re-activate timer queue with re_activate_timer_queue function.

The cancel_timer() function cancels the timer id initiated by initializer.

Adaptation module of tools includes internal attribute eap_timer_queue_c to which this call is directed.

The set_timer() function initializes timer to be elapsed after p_time_ms milliseconds. Adaptation module of tools includes internal attribute eap_timer_queue_c to which this call is directed.

Function converts one ascii character to octet.

This function compares two 64-bit integers. If a is bigger function returns positive integer. If b is bigger function returns negative integer. If a == b function returns zero integer.

Get the length of a string.

The configure() function is called after the constructor of the object is successfully executed. During the function call the object could query the configuration. Each derived class must define this function. Needed configuration depends on the implementation.

Function converts AM error value to eap_status_e.

Function converts lovercase ascii characters to uppercase.

Function converts bytes to ascii armored bytes.

Function converts bytes to hex ascii.

Function converts bytes to hex ascii.

Function converts eap_status_e to AM error value.

Function converts hex ascii to bytes.

Function converts hex ascii to bytes.

Function converts unicode characters into UTF8 characters.

Function converts UTF8 characters into unicode characters.

The create_uuid_v5() method creates an UUID version 5 (SHA-1) from the name space UUID and name (RFC 4122). The name space UUID should be in hex format (e.g. 3d813cbb47fb52ba91df831e1593ac29). The name space UUID and name must be in network byte order (little endiann).

The create_uuid_v5_from_mac_address() method creates an UUID version 5 from a MAC address. Uses an internally defined, fixed name space UUID allocated for EAP MAC addresses. The MAC address should be in hex format (little endiann).

This function deletes platform specific tools object. Note this function calls also shutdown() of the allocated tools object. The platform specific module must implement this function.

This function is global proxy for return values with file name and line number. This is used in traces.

This function enters the global mutex. Mutex is needed to synchronize the timer thread and stack call operations. Timer pulse is run parallel to the stack operation. This causes the use of global mutex.

The formatted_print() function traces format string and formatted parameters to file. File is set as a parameter to constructor. This is used in macros EAP_TRACE_DEBUG(object_name, _parameter_list_) and EAP_TRACE_ERROR(object_name, _parameter_list_).

Function returns current value of clock ticks counter.

Function returns count of clock ticks in one second.

The get_crypto() function returns a pointer to object of type eap_am_crypto.

Returns the global mutex. This is used in some assertion tests.

This function returns the current time and date in standard UNIX 32-bit format (seconds since the midnight starting Jan 1, 1970, GMT) according to the sender's internal clock.

The get_hardware_ticks() function returns current value of hardware ticks counter.

Function returns count of hardware ticks in one second.

Returns the value of timer thread activity. Timer thread stops when this functions returns false.

The get_is_valid() function returns the status of the object. True indicates the object is initialized succesfully.

Returns true when timer thread is stopped. Returns false when timer thread is running.

This function checks whether the internal timer queue is empty.

This function returns the resolution of the timer. Each pulse increases time by this value.

Adaptation module of tools includes internal attribute eap_timer_queue_c to which this call is directed.

Gets the current trace mask.

This function returns true when milli second timer is used.

Returns true when timer queue is used. Returns false when timer queue is not used.

This function reads value of environment variable. Note the all environments does not support this, for example Symbian.

This function checks whether the character is space.

This function leaves the global mutex. Timer pulse is run parallel to the stack operation. This causes the use of global mutex.

The memchr function searches the first occurence of character starting from buf. Maximum count bytes are searched.

The memcmp() function compares count bytes from buf1 and buf2.

The memmove() function copies count bytes from src to dest. The implementation must handle overlapping memory areas correctly. Check always the destination is correct memory. This function is low level and cannot check the used memory.

Memory store is visible only during the eap_am_tools_c object is alive. This function add flat data to memory store. You must format your data to eap_tlv_message_data_c object. Data is identified by key parameter. You can set timeout to data. Data will be automatically removed after timeout. Timeout value zero means no timeout is set. Serious WARNING: do use really good key values. Memory store is globally used by all EAP Core objects. Key must be good that other users do not use others data. Add the real data type as a string to the key and other identifiers that separate data between the other users that store same data type to the memory store.

Memory store is visible only during the eap_am_tools_c object is alive. This function gets data from memory store. Data is returned in eap_tlv_message_data_c object. Data is identified by key parameter. Serious WARNING: do use really good key values. Memory store is globally used by all EAP Core objects. Key must be good that other users do not use others data. Add the real data type as a string to the key and other identifiers that separate data between the other users that store same data type to the memory store.

Memory store is visible only during the eap_am_tools_c object is alive. This function removes data from memory store. Data is identified by key parameter. Serious WARNING: do use really good key values. Memory store is globally used by all EAP Core objects. Key must be good that other users do not use others data. Add the real data type as a string to the key and other identifiers that separate data between the other users that store same data type to the memory store.

The memchr function searches the last occurence of character starting from the enf of the buf. Maximum count bytes are searched.

The memset function sets the first count bytes of dest to the character fill_byte. Check always the destination is correct memory. This function is low level and cannot check the used memory.

This function multiplys two 64-bit integers. Returned value is remainder of 2^64, so overflow is not detected.

This function allocates platform specific tools object. Note this function calls also configure() of the allocated tools object. The platform specific module must implement this function.

This function converts string to u32_t value.

Function converts one octet to ascii character.

Function parses NAI to usename and realm. If either is missing the corresponding value will be invalid.

Pulses timer. Time is increased by get_timer_resolution_ms() milli seconds. Timer pulse is run parallel to the stack operation. This causes the use of global mutex.

Adaptation module of tools includes internal attribute eap_timer_queue_c to which this call is directed. Function returns the next sleep time in milli seconds.

This function re-activates timer queue. Symbian AM call this function when AM-tools object is re-used. This can be called after am_cancel_all_timers() function. am_cancel_all_timers() function de-activated timer queue.

Function converts ascii armored bytes to bytes.

This functions allows activation of trace when the error occurs. Look at the set_activate_trace_on_error() and eap_status_return() functions. NOTE the always active traces are only left active. That means set_activate_trace_on_error() function calls set_trace_mask(eap_trace_mask_always).

This function sets the maximum size of trace output file in bytes. Note this is not absolute value. New file is generated when size of trace log file exceeds this limitation.

This function sets the resolution of the timer. The default value is EAP_TIMER_RESOLUTION. Each pulse increases time by this value.

Adaptation module of tools includes internal attribute eap_timer_queue_c to which this call is directed.

This function sets the trace output file name.

This function sets the current trace mask.

This function sets the flag whether to use milli second timer (true) or not (false).

The shutdown() function is called before the destructor of the object is executed. During the function call the object could shutdown the operations, for example cancel timers. Each derived class must define this function.

The sleep function suspends the execution of the current thread for the specified interval.

This function formats string to buffer. Function returns number of written bytes.

Starts the thread to pulse timer. User of tools should call this after the stack is created.

Stops the timer thread. User of tools should call this before the stack is deleted.

Get the length of a string.

The timer_sleep function suspends the execution of the current timer thread for the specified interval. Timer could be set any value. When timer is set to shorter timeout than the smallest current timeout is the timer_sleep() will cancel sleep and the new sleep time could be calculated.

Function runs the timer thread loop. This function calls the pulse_timer() function to increase the elapsed time.

This function traces read configure field and data.

The trace_data() function traces null terminated prefix string and data_length bytes from p_data to file. This is used in macros EAP_TRACE_DATA_DEBUG(object_name, _parameter_list_) and EAP_TRACE_DATA_ERROR(object_name, _parameter_list_).

This function converts u64_struct to u64_t type. This is used in some 64-bit calculations.

This function converts u64_t to u64_struct type. This is used in some 64-bit calculations.

This function xors two 64-bit integers.