Skip to the content.

⚠️ This document is auto-generated and may drift as symbols change. The first table lists the T symbols nm -gC --defined-only reports for the built libmmt_core.so; the public column is derived from membership in the installed public headers (src/mmt_core/public_include/*.h), not from the symbol table. The protocol-plugin tables at the end list what nm -D --defined-only reports for each plugin. Regenerate/check with: bash scripts/validate-exported-symbols.sh [--write] — the doc-validators CI job runs it on every PR (issue #187, Task 0.7).

Here is the complete list of the functions libmmt_core.so exports, followed by the export sets of the protocol plugins.

Since issue #533, MMTAPI is the export marker: the core objects are compiled with -fvisibility=hidden (rules/common.mk, the #533 block at the end of the file) and MMTAPI carries visibility("default") inside the SDK build (src/mmt_core/public_include/mmt_exports.h). A core symbol is exported only when it is declared MMTAPI. The public = N rows are private-header internals that libmmt_tcpip resolves after dlopen() (src/mmt_core/private_include/hash_utils.h, hashmap.h, packet_processing.h). They stay MMTAPI while libmmt_tcpip needs them (#534 hid the plugins’ own internals and left these in place). The four MMT_DPI_PROFILE_* objects are exported R (read-only data) symbols, so this T table does not list them. Tests that call hidden internals link libmmt_core.a (tools/phase0/tests/static_core_link.sh). hex2int, str_combine, str_copy, str_get_indexes_n, str_hex2str and str_sub_n (called by libmmt_tcpip) and mmt_log_event/mmt_log_write (called by libmmt_tmobile) are exported on purpose for the plugins, although no core object calls them: src/mmt_core/src/mmt_init.c references them so that a consumer linking libmmt_core.a (the STATIC_LINK mode of 5Greplay and NetworkFuzzer) holds them too, and tools/ci/check-static-link.sh fails when a plugin imports a core symbol such a consumer lacks (issue #675). Since issue #66 the five mmt_log_* functions are public = Y: their header, src/mmt_core/public_include/mmt_log.h, is installed for out-of-tree plugins (opt-in, no other installed header includes it), with no symbol added or removed. scripts/validate-exported-symbols.sh also fails when nm -D --defined-only lists more symbols than the MMTAPI declarations in src/mmt_core/{public,private}_include/*.h plus 5, any symbol that is not one of those declarations, or misses one of them.

Deprecation note (2026-09, #149): The following 3 public ABI symbols are exported (nm -D local_install/dpi/lib/libmmt_core.so | grep ' T ' confirms) but have 0 callers outside their definition/headers (grep -r <symbol> src sdk/tests sdk/examples tests examples shows only declaration+definition). They are now marked __attribute__((deprecated)) in src/mmt_core/public_include/mmt_core.h:1143,998,715 (and mirrored in sdk/include/mmt_core.h) and are scheduled for removal in release 2.0.0 — recorded in CHANGELOG.md (issue #232): setDataLinkType (obsolete, @obsolete since long), get_attribute_extracted_data_encap_index (redundant with get_attribute_extracted_data_at_index), mmt_print_all_protocols (debug helper, prefer iterate_through_protocols).

Deprecation note (2026-09, #237): mmt_search_irc_ssl_detect_ninty_percent_but_very_fast (libmmt_tcpip) keeps its exported symbol for ABI stability but is now __attribute__((deprecated)) in src/mmt_tcpip/lib/protocols/proto_irc.c:359-360. It is declared MMTAPI there, so it stays exported from the hidden-visibility plugin (issue #534) until its removal. Use the correctly named alias mmt_search_irc_ssl_detect (same signature and behaviour, defined alongside at src/mmt_tcpip/lib/protocols/proto_irc.c:340). The misspelled name is scheduled for removal in release 2.0.0.

Deprecation note (2026-10, #541): 30 public libmmt_core functions have no known caller: none in the SDK (src/, src/examples/), none in the user documentation (docs/*.md, README.md), and none in the public main branches of the three known consumers, mmt-probe, mmt-security and 5Greplay. Functions added during the 2026 modernization are not counted (enable/disable_port_classify_payload_confirm, set_tcp_reassembly_limit). The 30 now carry __attribute__((deprecated("no known caller (issue #541); removal in 2.0.0"))) in extraction_lib.h, data_defs.h, mmt_core.h and mmt_utils.h. Their exports and signatures are unchanged, so the ABI does not change. The 30 are general_short_extraction; the six get_attr_* accessors (get_attr_data, get_attr_data_len, get_attr_id, get_attr_offset, get_attr_protocol_index, get_attr_status); get_classification_threshold; get_last_activity_time; get_protocol_stack_name; get_session_outoforder_count; the twelve uncalled get_session_total_* counters (byte_count, data_byte_count, data_cap_volume, data_packet_count, dl_cap_byte_count, dl_cap_packet_count, dl_data_packet_count, packet_cap_count, packet_count, ul_cap_byte_count, ul_cap_packet_count, ul_data_packet_count); hex2dec; hex2str; htoi; is_protocol_attribute; mmt_attr_fprintf; mmt_strcmp; and str_print_array. The three mmt_utils.h functions that were already deprecated in favour of their _n variants (str_hex2int, str_sub, str_get_indexes) now name 2.0.0 as their removal release as well. The consumer check could only read public code, so the removal waits for confirmation from those consumers’ maintainers (docs/DECISIONS.md, 2026-10-30 entry).

Symbol table

# symbol public
1 char2int Y
2 clear_map_space N
3 close_extraction Y
4 debug_extracted_attributes_printout_handler Y
5 delete_key_value N
6 delete_map_space N
7 delete_session_from_protocol_context N
8 disable_hostname_classify Y
9 disable_ip_address_classify Y
10 disable_mmt_reassembly Y
11 disable_port_classify Y
12 disable_port_classify_payload_confirm Y
13 disable_protocol_analysis Y
14 disable_protocol_classification Y
15 disable_protocol_statistics Y
16 enable_hostname_classify Y
17 enable_ip_address_classify Y
18 enable_mmt_reassembly Y
19 enable_port_classify Y
20 enable_port_classify_payload_confirm Y
21 enable_protocol_analysis Y
22 enable_protocol_classification Y
23 enable_protocol_statistics Y
24 find_key_value N
25 fire_attribute_event Y
26 fire_evasion_event Y
27 general_byte_to_byte_extraction Y
28 general_char_extraction Y
29 general_int_extraction Y
30 general_int_extraction_with_ordering_change Y
31 general_short_extraction Y
32 general_short_extraction_with_ordering_change Y
33 get_active_session_count Y
34 get_application_name Y
35 get_attr_data Y
36 get_attr_data_len Y
37 get_attr_data_type Y
38 get_attr_id Y
39 get_attr_offset Y
40 get_attr_protocol_id Y
41 get_attr_protocol_index Y
42 get_attr_scope Y
43 get_attr_status Y
44 get_attribute_data_type Y
45 get_attribute_extracted_data Y
46 get_attribute_extracted_data_at_index Y
47 get_attribute_extracted_data_by_name Y
48 get_attribute_extracted_data_encap_index Y
49 get_attribute_id_by_protocol_and_attribute_names Y
50 get_attribute_id_by_protocol_id_and_attribute_name Y
51 get_attribute_name_by_protocol_and_attribute_ids Y
52 get_attribute_scope Y
53 get_children_stats Y
54 get_classification_max_depth Y
55 get_classification_method_name Y
56 get_classification_threshold Y
57 get_data_link_type Y
58 get_data_size_by_data_type Y
59 get_data_size_by_proto_and_field_ids Y
60 get_extracted_attribute Y
61 get_extracted_attribute_at_index Y
62 get_extracted_attribute_at_index_by_name Y
63 get_extracted_attribute_by_name Y
64 get_field_position_by_protocol_and_field_ids Y
65 get_last_activity_time Y
66 get_packet_offset_at_index Y
67 get_proto_attribute_id Y
68 get_proto_attribute_length Y
69 get_proto_attribute_name Y
70 get_proto_attribute_position Y
71 get_proto_attribute_scope Y
72 get_proto_attribute_type Y
73 get_proto_session_data Y
74 get_proto_session_data_from_packet Y
75 get_protocol_id_at_index Y
76 get_protocol_id_by_name Y
77 get_protocol_index_by_id Y
78 get_protocol_index_by_name Y
79 get_protocol_name_by_id Y
80 get_protocol_stack_name Y
81 get_protocol_stats Y
82 get_protocol_stats_path Y
83 get_protocol_struct_by_id Y
84 get_protocol_struct_for_registration_if_free Y
85 get_session_byte_count Y
86 get_session_classification_method Y
87 get_session_content_class_id Y
88 get_session_content_flags Y
89 get_session_content_type_id Y
90 get_session_data_byte_count Y
91 get_session_data_cap_volume Y
92 get_session_data_packet_count Y
93 get_session_dl_byte_count Y
94 get_session_dl_cap_byte_count Y
95 get_session_dl_cap_packet_count Y
96 get_session_dl_data_byte_count Y
97 get_session_dl_data_packet_count Y
98 get_session_dl_packet_count Y
99 get_session_from_packet Y
100 get_session_from_protocol_context_by_session_key N
101 get_session_handler Y
102 get_session_id Y
103 get_session_id_from_packet Y
104 get_session_init_time Y
105 get_session_last_activity_time Y
106 get_session_last_data_packet_time_by_direction Y
107 get_session_last_packet_direction Y
108 get_session_next Y
109 get_session_outoforder_count Y
110 get_session_packet_cap_count Y
111 get_session_packet_count Y
112 get_session_parent Y
113 get_session_previous Y
114 get_session_proto_path_direction Y
115 get_session_protocol_hierarchy Y
116 get_session_protocol_index Y
117 get_session_retransmission_count Y
118 get_session_rtt Y
119 get_session_setup_direction Y
120 get_session_total_byte_count Y
121 get_session_total_data_byte_count Y
122 get_session_total_data_cap_volume Y
123 get_session_total_data_packet_count Y
124 get_session_total_dl_byte_count Y
125 get_session_total_dl_cap_byte_count Y
126 get_session_total_dl_cap_packet_count Y
127 get_session_total_dl_data_byte_count Y
128 get_session_total_dl_data_packet_count Y
129 get_session_total_dl_packet_count Y
130 get_session_total_packet_cap_count Y
131 get_session_total_packet_count Y
132 get_session_total_ul_byte_count Y
133 get_session_total_ul_cap_byte_count Y
134 get_session_total_ul_cap_packet_count Y
135 get_session_total_ul_data_byte_count Y
136 get_session_total_ul_data_packet_count Y
137 get_session_total_ul_packet_count Y
138 get_session_ul_byte_count Y
139 get_session_ul_cap_byte_count Y
140 get_session_ul_cap_packet_count Y
141 get_session_ul_data_byte_count Y
142 get_session_ul_data_packet_count Y
143 get_session_ul_packet_count Y
144 get_user_session_context Y
145 get_user_session_context_from_packet Y
146 has_registered_attribute_handler Y
147 hashmap_get N
148 hashmap_insert_kv N
149 hashmap_remove N
150 hashmap_walk N
151 hex2char Y
152 hex2dec Y
153 hex2int Y
154 hex2str Y
155 htoi Y
156 init_extraction Y
157 init_map_space N
158 init_protocol_struct_for_registration Y
159 insert_key_value N
160 insert_session_into_protocol_context N
161 invalidate_packet_offset_cache Y
162 is_free_protocol_id_for_registractionl Y
163 is_free_protocol_id_for_registration Y
164 is_protocol_attribute Y
165 is_registered_attribute Y
166 is_registered_attribute_handler Y
167 is_registered_packet_handler Y
168 is_registered_protocol Y
169 is_valid_proto_attribute Y
170 is_valid_protocol_id Y
171 iterate_through_mmt_handlers Y
172 iterate_through_protocol_attributes Y
173 iterate_through_protocols Y
174 mapspace_iteration_callback N
175 mmt_application_class Y
176 mmt_application_class_name Y
177 mmt_apply_dpi_profile Y
178 mmt_apply_dpi_profile_by_name Y
179 mmt_arena_alloc Y
180 mmt_arena_create Y
181 mmt_arena_destroy Y
182 mmt_arena_reset Y
183 mmt_attr_format Y
184 mmt_attr_fprintf Y
185 mmt_attr_sprintf Y
186 mmt_close_handler Y
187 mmt_content_class_by_flags Y
188 mmt_content_class_by_type Y
189 mmt_content_class_name_by_flags Y
190 mmt_content_class_name_by_type Y
191 mmt_drop_packet Y
192 mmt_free Y
193 mmt_inet_ntop Y
194 mmt_init_handler Y
195 mmt_load_dpi_profiles_file Y
196 mmt_log_event Y
197 mmt_log_get_level Y
198 mmt_log_get_stats Y
199 mmt_log_set_level Y
200 mmt_log_write Y
201 mmt_malloc Y
202 mmt_packet_scratch_adopt Y
203 mmt_print_all_protocols Y
204 mmt_print_info Y
205 mmt_realloc Y
206 mmt_register_class_provider Y
207 mmt_strcasecmp Y
208 mmt_strcmp Y
209 mmt_strncasecmp Y
210 mmt_strncmp Y
211 mmt_strnstr N
212 mmt_tcp_reasm_stat_drop N
213 mmt_tcp_reasm_stat_live N
214 mmt_tcp_reasm_stat_move N
215 mmt_tcp_reasm_stat_visit N
216 mmt_tolower Y
217 mmt_toupper Y
218 mmt_version Y
219 packet_process Y
220 process_packet_handler Y
221 process_session_timer_handler Y
222 proto_hierarchy_to_str Y
223 proto_hierarchy_to_str_with_size Y
224 protocol_sessions_iteration_callback N
225 register_attribute_handler Y
226 register_attribute_handler_by_name Y
227 register_attribute_with_protocol Y
228 register_classification_function Y
229 register_classification_function_full Y
230 register_classification_function_with_parent_protocol Y
231 register_evasion_handler Y
232 register_extraction_attribute Y
233 register_extraction_attribute_by_name Y
234 register_packet_handler Y
235 register_pre_post_analysis_functions Y
236 register_pre_post_classification_functions Y
237 register_proto_context_init_cleanup_function Y
238 register_protocol Y
239 register_protocol_stack Y
240 register_protocol_stack_full Y
241 register_session_data_analysis_function Y
242 register_session_data_analysis_function_full Y
243 register_session_data_analysis_function_with_protocol Y
244 register_session_data_cleanup_function Y
245 register_session_data_initialization_function Y
246 register_session_equal_function Y
247 register_session_hash_function Y
248 register_session_timeout_handler Y
249 register_session_timer_handler Y
250 register_sessionizer_function Y
251 reset_statistics Y
252 setDataLinkType Y
253 set_classification_max_depth Y
254 set_classified_proto Y
255 set_default_session_timed_out Y
256 set_fragment_in_packet Y
257 set_fragment_in_session Y
258 set_fragmented_packet_in_session Y
259 set_live_session_timed_out Y
260 set_long_session_timed_out Y
261 set_proto_session_data Y
262 set_session_timeout_delay Y
263 set_short_session_timed_out Y
264 set_tcp_reassembly_budget Y
265 set_tcp_reassembly_limit Y
266 set_user_session_context Y
267 set_user_session_context_for_packet Y
268 short_time_diff Y
269 silent_extraction Y
270 str_combine Y
271 str_compare Y
272 str_copy Y
273 str_get_indexes Y
274 str_get_indexes_n Y
275 str_hex2int Y
276 str_hex2int_n Y
277 str_hex2str Y
278 str_index Y
279 str_print_array Y
280 str_replace Y
281 str_sub Y
282 str_sub_n Y
283 str_subvalue Y
284 unregister_attribute_handler Y
285 unregister_attribute_handler_by_name Y
286 unregister_extraction_attribute Y
287 unregister_extraction_attribute_by_name Y
288 unregister_packet_handler Y
289 unregister_protocol_by_id Y
290 unregister_protocol_by_name Y
291 unregister_protocol_stack Y
292 update_protocol Y

Protocol plugins

Since issue #534 the protocol plugins are built like the core: their objects are compiled with -fvisibility=hidden (rules/common.mk, the #534 block at the end of the file), so a plugin exports only what is declared MMTAPI: the entry points init_proto/cleanup_proto that plugins_engine.c looks up with dlsym(), and the functions the plugin’s installed headers declare. Everything else, such as the protocol classifiers, the attribute extractors and the vendored llhttp parser, stays inside the library and its static archive. Tests that call a hidden plugin internal link that archive (tools/phase0/tests/static_core_link.sh, mmt_static_plugin_link).

scripts/validate-exported-symbols.sh compares each table below with the built library and fails when they differ, naming every symbol added or removed (the loader’s _init/_fini and the linker’s _edata/_end/ __bss_start are not listed). A change to a plugin’s export set is recorded by regenerating these tables with --write in the same pull request; the prose above each table is kept as written.

libmmt_tcpip

init_proto, cleanup_proto, init_tcpip_plugin and cleanup_tcpip_plugin are declared in src/mmt_tcpip/include/mmt_tcpip_plugin.h; the six get_content_class_* / get_application_class_* lookups are declared in src/mmt_tcpip/include/mmt_tcpip.h and defined in src/mmt_tcpip/lib/mmt_tcpip_classes.c (issue #537 moved them out of static inline header bodies). Since Montimage/mmt-probe#18 (#62) a consumer does not link -lmmt_tcpip for them: the installed mmt_tcpip.h forwards each one inline to libmmt_core (mmt_class_provider.h), and the plugin keeps the six exports for binaries built against v1.10.0. The misspelled mmt_search_irc_ssl_detect_ninty_percent_but_very_fast stays exported until 2.0.0 (the #237 note above).

symbol
cleanup_proto
cleanup_tcpip_plugin
get_application_class_by_protocol_id
get_application_class_name_by_protocol_id
get_content_class_by_content_flags
get_content_class_by_content_type
get_content_class_name_by_content_flags
get_content_class_name_by_content_type
init_proto
init_tcpip_plugin
mmt_search_irc_ssl_detect_ninty_percent_but_very_fast

libmmt_tmobile

init_proto and cleanup_proto are declared in src/mmt_mobile/mmt_mobile_internal.h, the s1ap_entities_* functions in src/mmt_mobile/include/proto_s1ap.h, and update_ngap_data in src/mmt_mobile/include/proto_ngap.h (5Greplay calls it to rewrite NGAP attributes). The asn1c runtime has been hidden since #443.

symbol
cleanup_proto
init_proto
s1ap_entities_count
s1ap_entities_reset
s1ap_entities_update
update_ngap_data

libmmt_business_app

init_proto and cleanup_proto are declared in src/mmt_business_app/mmt_business_app_internal.h.

symbol
cleanup_proto
init_proto

libmmt_tdicom

Every symbol is declared in src/mmt_dicom/include/dicom.h.

symbol
cleanup_proto
dicom_stack_classification
init_dicom_proto_struct
init_proto
mmt_check_dicom
mmt_check_dicom_hdr
mmt_check_dicom_payload
mmt_check_dicom_tcp