The Network Monitoring Specific API provides functions for provide monitoring specific.

Required Header

#include <inm.h>

Overview

This set of functions is used to get information about network information provided by well-known linux functions. To use This kind of APIs, You should create a inm handle using inm_initialize(). After that, you can obtain network information. You should destroy the created inm handle if you do not need it anymore. You can detect IP collision, do dump network status, dump TCP, monitor ethernet, Wi-Fi module state, get network statistics.

Related Features

This API is related with the following features:

http://tizen.org/feature/network.ethernet
http://tizen.org/feature/network.wifi
http://tizen.org/feature/network.telephony
http://tizen.org/feature/network.inm
It is recommended to design feature related codes in your application for reliability.
You can check if a device supports the related features for this API by using System Information, thereby controlling the procedure of your application.
To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.
More details on featuring your application can be found from Feature Element.

Functions
int	inm_set_ethernet_cable_state_changed_cb (inm_h inm, inm_ethernet_cable_state_changed_cb callback, void *user_data)
	Sets a callback called when the Ethernet cable state is changed.
int	inm_unset_ethernet_cable_state_changed_cb (inm_h inm)
	Unsets the callback called when the Ethernet cable state is changed.
int	inm_get_ethernet_cable_state (inm_h inm, inm_ethernet_cable_state_e *state)
	Gets the Ethernet cable state.
int	inm_set_wifi_module_state_changed_cb (inm_h inm, inm_wifi_module_state_changed_cb callback, void *user_data)
	Sets a callback called when the Wi-Fi Module state is changed.
int	inm_unset_wifi_module_state_changed_cb (inm_h inm)
	Unsets the callback called when the Wi-Fi Module state is changed.
int	inm_get_wifi_module_state (inm_h inm, inm_wifi_module_state_e *state)
	Gets the Wi-Fi Module state.
int	inm_set_ip_conflict_cb (inm_h inm, inm_ip_conflict_cb callback, void *user_data)
	Sets the callback called when IP conflict state is changed.
int	inm_unset_ip_conflict_cb (inm_h inm)
	Unsets the callback called when IP conflict state is changed.
int	inm_ip_conflict_detect_is_enabled (inm_h inm, bool *state)
	Checks whether IP conflict detection is enabled.
int	inm_get_ip_conflict_state (inm_h inm, inm_ip_conflict_state_e *state)
	Gets the state of the IP conflict.
int	inm_get_statistics (inm_h inm, inm_connection_type_e connection_type, inm_statistics_type_e statistics_type, unsigned long long *size)
	Gets the statistics information.
int	inm_reset_statistics (inm_h inm, inm_connection_type_e connection_type, inm_statistics_type_e statistics_type)
	Resets the statistics information.
int	inm_set_congestion_level_cb (inm_h inm, inm_congestion_level_cb callback, void *user_data)
	Sets the callback called when the TCP congestion level is updated.
int	inm_unset_congestion_level_cb (inm_h inm)
	Unsets the callback called when the TCP congestion level is updated.
int	inm_get_congestion_level (inm_h inm, inm_congestion_level_e *level)
	Gets the TCP congestion level.
int	inm_set_retry_tx_rate_cb (inm_h inm, inm_retry_tx_rate_cb callback, void *user_data)
	Sets the callback called the TCP TX retry rate is updated.
int	inm_unset_retry_tx_rate_cb (inm_h inm)
	Unsets the callback called when the TCP TX retry rate is updated.
int	inm_get_retry_tx_rate (inm_h inm, int *rate)
	Gets the TCP TX retry rate.
int	inm_set_channel_interference_cb (inm_h inm, inm_channel_interference_cb callback, void *user_data)
	Sets the callback to be called when the channel interference is updated.
int	inm_unset_channel_interference_cb (inm_h inm)
	Unsets the callback called when the channel interference is updated.
int	inm_get_channel_interference (inm_h inm, double *ch_intf)
	Gets the channel interference of the wireless network.
Typedefs
typedef void(*	inm_ethernet_cable_state_changed_cb )(inm_ethernet_cable_state_e state, void *user_data)
	Called when the Ethernet cable state is changed.
typedef void(*	inm_wifi_module_state_changed_cb )(inm_wifi_module_state_e state, void *user_data)
	Called when the Wi-Fi Module state is changed.
typedef void(*	inm_ip_conflict_cb )(char if_name, char ip, inm_ip_conflict_state_e state, void *user_data)
	Called when the IP conflict state is changed.
typedef void(*	inm_congestion_level_cb )(inm_congestion_level_e level, void *user_data)
	Called when the TCP congestion level is updated.
typedef void(*	inm_retry_tx_rate_cb )(int rate, void *user_data)
	Called when the retry TX rate is updated.
typedef void(*	inm_channel_interference_cb )(int freq, double channel_intf, void *user_data)
	Called when the channel interference is updated.

Typedef Documentation

typedef void(* inm_channel_interference_cb)(int freq, double channel_intf, void *user_data)

Called when the channel interference is updated.

Since :: 5.0

Parameters:

[in]	freq	The frequency of wireless network
[in]	channel_intf	The current channel interference
[in]	user_data	The user data passed from the callback registration function

See also:: inm_set_channel_interference_cb(); inm_unset_channel_interference_cb()

typedef void(* inm_congestion_level_cb)(inm_congestion_level_e level, void *user_data)

Called when the TCP congestion level is updated.

Since :: 5.0

Parameters:

[in]	level	The current TCP congestion level
[in]	user_data	The user data passed from the callback registration function

See also:: inm_set_congestion_level_cb(); inm_unset_congestion_level_cb()

typedef void(* inm_ethernet_cable_state_changed_cb)(inm_ethernet_cable_state_e state, void *user_data)

Called when the Ethernet cable state is changed.

Since :: 5.0

Parameters:

[in]	state	The Ethernet cable state
[in]	user_data	The user data passed from the callback registration function

See also:: inm_set_ethernet_cable_state_changed_cb(); inm_unset_ethernet_cable_changed_cb()

typedef void(* inm_ip_conflict_cb)(char *if_name, char *ip, inm_ip_conflict_state_e state, void *user_data)

Called when the IP conflict state is changed.

Since :: 5.0

Remarks:: if_name ip should not be freed. if_name ip is available only in the callback. To use outside the callback, make a copy.

Parameters:

[in]	if_name	The destination interface name causing conflict
[in]	ip	The local ip address causing conflict
[in]	state	The current state
[in]	user_data	The user data passed from the callback registration function

See also:: inm_set_ip_conflict_cb(); inm_unset_ip_conflict_cb()

typedef void(* inm_retry_tx_rate_cb)(int rate, void *user_data)

Called when the retry TX rate is updated.

Since :: 5.0

Parameters:

[in]	rate	The current TCP TX retry rate
[in]	user_data	The user data passed from the callback registration function

See also:: inm_set_retry_tx_rate_cb(); inm_unset_retry_tx_rate_cb()

typedef void(* inm_wifi_module_state_changed_cb)(inm_wifi_module_state_e state, void *user_data)

Called when the Wi-Fi Module state is changed.

Since :: 5.0

Parameters:

[in]	state	The Wi-Fi Module state
[in]	user_data	The user data passed from the callback registration function

See also:: inm_set_wifi_module_state_changed_cb(); inm_unset_wifi_module_state_changed_cb()

Enumeration Type Documentation

enum inm_congestion_level_e

Enumeration for congestion level.

Since :: 5.0

Enumerator:

INM_CONGESTION_LEVEL_VERY_HIGH	Very high TCP congestion
INM_CONGESTION_LEVEL_HIGH	High TCP congestion
INM_CONGESTION_LEVEL_MEDIUM	Medium TCP congestion
INM_CONGESTION_LEVEL_LOW	Low TCP congestion

enum inm_connection_type_e

Enumeration for connection type.

Since :: 5.0

Enumerator:

INM_CONNECTION_TYPE_DISCONNECTED	Disconnected
INM_CONNECTION_TYPE_WIFI	Wi-Fi type
INM_CONNECTION_TYPE_CELLULAR	Cellular type
INM_CONNECTION_TYPE_ETHERNET	Ethernet type
INM_CONNECTION_TYPE_BT	Bluetooth type
INM_CONNECTION_TYPE_NET_PROXY	Proxy type for internet connection

enum inm_ethernet_cable_state_e

Enumeration for the Ethernet cable state.

Since :: 5.0

Enumerator:

INM_ETHERNET_CABLE_STATE_DETACHED	Ethernet cable is detached
INM_ETHERNET_CABLE_STATE_ATTACHED	Ethernet cable is attached

enum inm_ip_conflict_state_e

Enumeration for the state of the IP conflict.

Since :: 5.0

Enumerator:

INM_IP_CONFLICT_STATE_UNKNOWN	Unknown state
INM_IP_CONFLICT_STATE_CONFLICT_NOT_DETECTED	Resolved state
INM_IP_CONFLICT_STATE_CONFLICT_DETECTED	Conflict state

enum inm_statistics_type_e

Enumeration for statistics type.

Since :: 5.0

Enumerator:

INM_STATISTICS_TYPE_LAST_RECEIVED_DATA	Last received data
INM_STATISTICS_TYPE_LAST_SENT_DATA	Last sent data
INM_STATISTICS_TYPE_TOTAL_RECEIVED_DATA	Total received data
INM_STATISTICS_TYPE_TOTAL_SENT_DATA	Total sent data

enum inm_wifi_module_state_e

Enumeration for the Wi-Fi Module state.

Since :: 5.0

Enumerator:

INM_WIFI_MODULE_STATE_DETACHED	Wi-Fi Module is detached
INM_WIFI_MODULE_STATE_ATTACHED	Wi-Fi Module is attached

Function Documentation

int inm_get_channel_interference	(	inm_h	inm,
		double *	ch_intf
	)

Gets the channel interference of the wireless network.

Since :: 5.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/network.get

Parameters:

[in]	inm	The monitoring handle
[out]	ch_intf	The current channel interference

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_PERMISSION_DENIED	Permission Denied
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_get_congestion_level	(	inm_h	inm,
		inm_congestion_level_e *	level
	)

Gets the TCP congestion level.

Since :: 5.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/network.get

Parameters:

[in]	inm	The monitoring handle
[out]	level	The current TCP congestion level

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_PERMISSION_DENIED	Permission Denied
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_get_ethernet_cable_state	(	inm_h	inm,
		inm_ethernet_cable_state_e *	state
	)

Gets the Ethernet cable state.

Since :: 5.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/network.get

Parameters:

[in]	inm	The monitor handle
[out]	state	The Ethernet cable state

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_PERMISSION_DENIED	Permission Denied
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_get_ip_conflict_state	(	inm_h	inm,
		inm_ip_conflict_state_e *	state
	)

Gets the state of the IP conflict.

Since :: 5.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/network.get

Parameters:

[in]	inm	The monitoring handle
[out]	state	The current state of IP conflict

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_PERMISSION_DENIED	Permission Denied
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_get_retry_tx_rate	(	inm_h	inm,
		int *	rate
	)

Gets the TCP TX retry rate.

Since :: 5.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/network.get

Parameters:

[in]	inm	The monitoring handle
[out]	rate	The current TCP TX retry rate

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_PERMISSION_DENIED	Permission Denied
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_get_statistics	(	inm_h	inm,
		inm_connection_type_e	connection_type,
		inm_statistics_type_e	statistics_type,
		unsigned long long *	size
	)

Gets the statistics information.

Since :: 5.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/network.get

Parameters:

[in]	inm	The monitor handle
[in]	connection_type	The type of connection Only INM_CONNECTION_TYPE_WIFI and INM_CONNECTION_TYPE_CELLULAR are supported
[in]	statistics_type	The type of statistics
[out]	size	The received data size of the last cellular packet data connection (bytes)

Returns:: 0 on success, otherwise a negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_PERMISSION_DENIED	Permission Denied
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_get_wifi_module_state	(	inm_h	inm,
		inm_wifi_module_state_e *	state
	)

Gets the Wi-Fi Module state.

Since :: 5.0

Parameters:

[in]	inm	The monitor handle
[out]	state	The Wi-Fi Module state

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_ip_conflict_detect_is_enabled	(	inm_h	inm,
		bool *	state
	)

Checks whether IP conflict detection is enabled.

Since :: 5.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/network.get

Parameters:

[in]	inm	The monitoring handle
[out]	state	`true` if IP conflict detection is enabled, otherwise `false` if IP conflict detection is disabled.

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_PERMISSION_DENIED	Permission Denied
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_reset_statistics	(	inm_h	inm,
		inm_connection_type_e	connection_type,
		inm_statistics_type_e	statistics_type
	)

Resets the statistics information.

Since :: 5.0

Privilege Level:: public

Privilege:: http://tizen.org/privilege/network.set

Parameters:

[in]	inm	The monitor handle
[in]	connection_type	The type of connection Only INM_CONNECTION_TYPE_WIFI and INM_CONNECTION_TYPE_CELLULAR are supported
[in]	statistics_type	The type of statistics

Returns:: 0 on success, otherwise a negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_PERMISSION_DENIED	Permission Denied
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_set_channel_interference_cb	(	inm_h	inm,
		inm_channel_interference_cb	callback,
		void *	user_data
	)

Sets the callback to be called when the channel interference is updated.

Since :: 5.0

Parameters:

[in]	inm	The monitoring handle
[in]	callback	The callback function to be called
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_set_congestion_level_cb	(	inm_h	inm,
		inm_congestion_level_cb	callback,
		void *	user_data
	)

Sets the callback called when the TCP congestion level is updated.

Since :: 5.0

Parameters:

[in]	inm	The monitoring handle
[in]	callback	The callback function to be called
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_set_ethernet_cable_state_changed_cb	(	inm_h	inm,
		inm_ethernet_cable_state_changed_cb	callback,
		void *	user_data
	)

Sets a callback called when the Ethernet cable state is changed.

Since :: 5.0

Parameters:

[in]	inm	The monitor handle
[in]	callback	The callback function to be called
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

See also:: inm_ethernet_cable_state_changed_cb(); inm_unset_ethernet_cable_state_changed_cb()

int inm_set_ip_conflict_cb	(	inm_h	inm,
		inm_ip_conflict_cb	callback,
		void *	user_data
	)

Sets the callback called when IP conflict state is changed.

Since :: 5.0

Parameters:

[in]	inm	The monitoring handle
[in]	callback	The callback function to be called
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_set_retry_tx_rate_cb	(	inm_h	inm,
		inm_retry_tx_rate_cb	callback,
		void *	user_data
	)

Sets the callback called the TCP TX retry rate is updated.

Since :: 5.0

Parameters:

[in]	inm	The monitoring handle
[in]	callback	The callback function to be called
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_set_wifi_module_state_changed_cb	(	inm_h	inm,
		inm_wifi_module_state_changed_cb	callback,
		void *	user_data
	)

Sets a callback called when the Wi-Fi Module state is changed.

Since :: 5.0

Parameters:

[in]	inm	The monitor handle
[in]	callback	The callback function to be called
[in]	user_data	The user data passed to the callback function

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

See also:: inm_wifi_module_state_changed_cb(); inm_unset_wifi_module_state_changed_cb()

int inm_unset_channel_interference_cb ( inm_h inm )

Unsets the callback called when the channel interference is updated.

Since :: 5.0

Parameters:

[in] inm The monitoring handle

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_unset_congestion_level_cb ( inm_h inm )

Unsets the callback called when the TCP congestion level is updated.

Since :: 5.0

Parameters:

[in] inm The monitoring handle

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_unset_ethernet_cable_state_changed_cb ( inm_h inm )

Unsets the callback called when the Ethernet cable state is changed.

Since :: 5.0

Parameters:

[in] inm The monitor handle

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

See also:: inm_ethernet_cable_state_changed_cb(); inm_set_ethernet_cable_state_changed_cb()

int inm_unset_ip_conflict_cb ( inm_h inm )

Unsets the callback called when IP conflict state is changed.

Since :: 5.0

Parameters:

[in] inm The monitoring handle

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_unset_retry_tx_rate_cb ( inm_h inm )

Unsets the callback called when the TCP TX retry rate is updated.

Since :: 5.0

Parameters:

[in] inm The monitoring handle

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

int inm_unset_wifi_module_state_changed_cb ( inm_h inm )

Unsets the callback called when the Wi-Fi Module state is changed.

Since :: 5.0

Parameters:

[in] inm The monitor handle

Returns:: 0 on success, otherwise negative error value

Return values:

INM_ERROR_NONE	Successful
INM_ERROR_INVALID_PARAMETER	Invalid parameter
INM_ERROR_NOT_SUPPORTED	Not supported
INM_ERROR_NOT_INITIALIZED	Not initialized
INM_ERROR_OPERATION_FAILED	Operation failed

See also:: inm_wifi_module_state_changed_cb(); inm_set_wifi_module_state_changed_cb()

Required Header

Overview

Related Features

Functions

Typedefs

Typedef Documentation

Enumeration Type Documentation

Function Documentation