⚠️ This document is auto-generated and may drift as symbols change. The first table lists the
Tsymbolsnm -gC --defined-onlyreports for the builtlibmmt_core.so; thepubliccolumn 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 whatnm -D --defined-onlyreports 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 examplesshows only declaration+definition). They are now marked__attribute__((deprecated))insrc/mmt_core/public_include/mmt_core.h:1143,998,715(and mirrored insdk/include/mmt_core.h) and are scheduled for removal in release 2.0.0 — recorded inCHANGELOG.md(issue #232):setDataLinkType(obsolete, @obsolete since long),get_attribute_extracted_data_encap_index(redundant withget_attribute_extracted_data_at_index),mmt_print_all_protocols(debug helper, preferiterate_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))insrc/mmt_tcpip/lib/protocols/proto_irc.c:359-360. It is declaredMMTAPIthere, so it stays exported from the hidden-visibility plugin (issue #534) until its removal. Use the correctly named aliasmmt_search_irc_ssl_detect(same signature and behaviour, defined alongside atsrc/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_corefunctions have no known caller: none in the SDK (src/,src/examples/), none in the user documentation (docs/*.md,README.md), and none in the publicmainbranches 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")))inextraction_lib.h,data_defs.h,mmt_core.handmmt_utils.h. Their exports and signatures are unchanged, so the ABI does not change. The 30 aregeneral_short_extraction; the sixget_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 uncalledget_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; andstr_print_array. The threemmt_utils.hfunctions that were already deprecated in favour of their_nvariants (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 |