1# 2# CDDL HEADER START 3# 4# The contents of this file are subject to the terms of the 5# Common Development and Distribution License (the "License"). 6# You may not use this file except in compliance with the License. 7# 8# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9# or http://www.opensolaris.org/os/licensing. 10# See the License for the specific language governing permissions 11# and limitations under the License. 12# 13# When distributing Covered Code, include this CDDL HEADER in each 14# file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15# If applicable, add the following below this CDDL HEADER, with the 16# fields enclosed by brackets "[]" replaced with your own identifying 17# information: Portions Copyright [yyyy] [name of copyright owner] 18# 19# CDDL HEADER END 20# 21 22# 23# Copyright 2007 Sun Microsystems, Inc. All rights reserved. 24# Use is subject to license terms. 25# 26# ident "%Z%%M% %I% %E% SMI" 27# 28# Generic interface definition for usr/src/cmd/sgs/liblddbg. 29# 30# For information regarding the establishment of versioned definitions see: 31# The Linker and Libraries Manual (version 2.5 or greater) 32# This is part of the Developers Guide in the Answerbook. Specifically refer 33# to Chapter 2 under section "Defining Additional Symbols" through section 34# "Reducing Symbol Scope", and Chapter 5 "Versioning". 35# 36# For specific OSNET rules for the modification (evolution) of these version 37# definitions see: 38# Policy for Shared Library Version Names and Interface Definitions 39 40 41SUNWprivate_4.61 { 42 global: 43 dbg_desc = NODIRECT; # interposed - ld.so.1(1) 44 dbg_print = NODIRECT; # interposed - ld(1) and ld.so.1(1) 45 46 Dbg_args_files; 47 Dbg_args_flags; 48 Dbg_audit_ignore; 49 Dbg_audit_interface; 50 Dbg_audit_lib; 51 Dbg_audit_object; 52 Dbg_audit_symval; 53 Dbg_audit_skip; 54 Dbg_audit_terminate; 55 Dbg_audit_version; 56 57 Dbg_setup; 58 59 Dbg32_bind_global; 60 Dbg64_bind_global; 61 Dbg32_bind_plt_summary; 62 Dbg64_bind_plt_summary; 63 Dbg64_bind_pltpad_from; 64 Dbg64_bind_pltpad_to; 65 Dbg32_bind_reject; 66 Dbg64_bind_reject; 67 Dbg32_bind_weak; 68 Dbg64_bind_weak; 69 70 Dbg32_cap_hw_candidate; 71 Dbg64_cap_hw_candidate; 72 Dbg32_cap_hw_filter; 73 Dbg64_cap_hw_filter; 74 Dbg32_cap_mapfile; 75 Dbg64_cap_mapfile; 76 Dbg32_cap_sec_entry; 77 Dbg64_cap_sec_entry; 78 Dbg32_cap_sec_title; 79 Dbg64_cap_sec_title; 80 Dbg32_cap_val_hw1; 81 Dbg64_cap_val_hw1; 82 83 Dbg32_demangle_name; 84 Dbg64_demangle_name; 85 86 Dbg32_ent_print; 87 Dbg64_ent_print; 88 89 Dbg32_file_analyze; 90 Dbg64_file_analyze; 91 Dbg32_file_aout; 92 Dbg64_file_aout; 93 Dbg32_file_ar; 94 Dbg64_file_ar; 95 Dbg32_file_ar_rescan; 96 Dbg64_file_ar_rescan; 97 Dbg32_file_bind_entry; 98 Dbg64_file_bind_entry; 99 Dbg32_file_bindings; 100 Dbg64_file_bindings; 101 Dbg32_file_cntl; 102 Dbg64_file_cntl; 103 Dbg32_file_config_dis; 104 Dbg64_file_config_dis; 105 Dbg32_file_config_obj; 106 Dbg64_file_config_obj; 107 Dbg32_file_del_rescan; 108 Dbg64_file_del_rescan; 109 Dbg32_file_delete; 110 Dbg64_file_delete; 111 Dbg32_file_dlclose; 112 Dbg64_file_dlclose; 113 Dbg32_file_dldump; 114 Dbg64_file_dldump; 115 Dbg32_file_dlopen; 116 Dbg64_file_dlopen; 117 Dbg32_file_elf; 118 Dbg64_file_elf; 119 Dbg32_file_cleanup; 120 Dbg64_file_cleanup; 121 Dbg32_file_filtee; 122 Dbg64_file_filtee; 123 Dbg32_file_filter; 124 Dbg64_file_filter; 125 Dbg32_file_fixname; 126 Dbg64_file_fixname; 127 Dbg32_file_generic; 128 Dbg64_file_generic; 129 Dbg32_file_hdl_action; 130 Dbg64_file_hdl_action; 131 Dbg32_file_hdl_collect; 132 Dbg64_file_hdl_collect; 133 Dbg32_file_hdl_title; 134 Dbg64_file_hdl_title; 135 Dbg32_file_lazyload; 136 Dbg64_file_lazyload; 137 Dbg32_file_ldso; 138 Dbg64_file_ldso; 139 Dbg32_file_mode_promote; 140 Dbg64_file_mode_promote; 141 Dbg32_file_modified; 142 Dbg64_file_modified; 143 Dbg32_file_needed; 144 Dbg64_file_needed; 145 Dbg32_file_output; 146 Dbg64_file_output; 147 Dbg32_file_preload; 148 Dbg64_file_preload; 149 Dbg32_file_prot; 150 Dbg64_file_prot; 151 Dbg32_file_rejected; 152 Dbg64_file_rejected; 153 Dbg32_file_reuse; 154 Dbg64_file_reuse; 155 Dbg32_file_skip; 156 Dbg64_file_skip; 157 158 Dbg32_got_display; 159 Dbg64_got_display; 160 161 Dbg32_libs_audit; 162 Dbg64_libs_audit; 163 Dbg32_libs_find; 164 Dbg64_libs_find; 165 Dbg32_libs_found; 166 Dbg64_libs_found; 167 Dbg32_libs_ignore; 168 Dbg64_libs_ignore; 169 Dbg32_libs_init; 170 Dbg64_libs_init; 171 Dbg32_libs_l; 172 Dbg64_libs_l; 173 Dbg32_libs_path; 174 Dbg64_libs_path; 175 Dbg32_libs_req; 176 Dbg64_libs_req; 177 Dbg32_libs_update; 178 Dbg64_libs_update; 179 Dbg32_libs_yp; 180 Dbg64_libs_yp; 181 Dbg32_libs_ylu; 182 Dbg64_libs_ylu; 183 184 Dbg32_map_dash; 185 Dbg64_map_dash; 186 Dbg32_map_ent; 187 Dbg64_map_ent; 188 Dbg32_map_parse; 189 Dbg64_map_parse; 190 Dbg32_map_pipe; 191 Dbg64_map_pipe; 192 Dbg32_map_set_atsign; 193 Dbg64_map_set_atsign; 194 Dbg32_map_seg; 195 Dbg64_map_seg; 196 Dbg32_map_set_equal; 197 Dbg64_map_set_equal; 198 Dbg32_map_size_new; 199 Dbg64_map_size_new; 200 Dbg32_map_size_old; 201 Dbg64_map_size_old; 202 Dbg32_map_sort_fini; 203 Dbg64_map_sort_fini; 204 Dbg32_map_sort_orig; 205 Dbg64_map_sort_orig; 206 Dbg32_map_symbol; 207 Dbg64_map_symbol; 208 Dbg32_map_version; 209 Dbg64_map_version; 210 211 Dbg32_move_adjexpandreloc; 212 Dbg64_move_adjexpandreloc; 213 Dbg32_move_adjmovereloc; 214 Dbg64_move_adjmovereloc; 215 Dbg32_move_data; 216 Dbg64_move_data; 217 Dbg32_move_entry1; 218 Dbg64_move_entry1; 219 Dbg32_move_entry2; 220 Dbg64_move_entry2; 221 Dbg32_move_expand; 222 Dbg64_move_expand; 223 Dbg32_move_input; 224 Dbg64_move_input; 225 Dbg32_move_outmove; 226 Dbg64_move_outmove; 227 Dbg32_move_outsctadj; 228 Dbg64_move_outsctadj; 229 Dbg32_move_parexpn; 230 Dbg64_move_parexpn; 231 232 Dbg32_reloc_apply_reg; 233 Dbg64_reloc_apply_reg; 234 Dbg32_reloc_apply_val; 235 Dbg64_reloc_apply_val; 236 Dbg32_reloc_ars_entry; 237 Dbg64_reloc_ars_entry; 238 Dbg32_reloc_copy; 239 Dbg64_reloc_copy; 240 Dbg32_reloc_discard; 241 Dbg64_reloc_discard; 242 Dbg32_reloc_doact; 243 Dbg64_reloc_doact; 244 Dbg32_reloc_doact_title; 245 Dbg64_reloc_doact_title; 246 Dbg32_reloc_dooutrel; 247 Dbg64_reloc_dooutrel; 248 Dbg32_reloc_entry; 249 Dbg64_reloc_entry; 250 Dbg32_reloc_error; 251 Dbg64_reloc_error; 252 Dbg32_reloc_generate; 253 Dbg64_reloc_generate; 254 Dbg32_reloc_in; 255 Dbg64_reloc_in; 256 Dbg32_reloc_ors_entry; 257 Dbg64_reloc_ors_entry; 258 Dbg32_reloc_out; 259 Dbg64_reloc_out; 260 Dbg32_reloc_proc; 261 Dbg64_reloc_proc; 262 Dbg32_reloc_run; 263 Dbg64_reloc_run; 264 Dbg32_reloc_sloppycomdat; 265 Dbg64_reloc_sloppycomdat; 266 Dbg32_reloc_transition; 267 Dbg64_reloc_transition; 268 269 Dbg32_sec_added; 270 Dbg64_sec_added; 271 Dbg32_sec_created; 272 Dbg64_sec_created; 273 Dbg32_sec_discarded; 274 Dbg64_sec_discarded; 275 Dbg32_sec_group; 276 Dbg64_sec_group; 277 Dbg32_sec_in; 278 Dbg64_sec_in; 279 Dbg32_sec_order_error; 280 Dbg64_sec_order_error; 281 Dbg32_sec_order_list; 282 Dbg64_sec_order_list; 283 Dbg32_sec_strtab; 284 Dbg64_sec_strtab; 285 286 Dbg32_seg_entry; 287 Dbg64_seg_entry; 288 Dbg32_seg_list; 289 Dbg64_seg_list; 290 Dbg32_seg_os; 291 Dbg64_seg_os; 292 Dbg32_seg_title; 293 Dbg64_seg_title; 294 295 Dbg32_shdr_modified; 296 Dbg64_shdr_modified; 297 298 Dbg32_statistics_ar; 299 Dbg64_statistics_ar; 300 Dbg32_statistics_ld; 301 Dbg64_statistics_ld; 302 303 Dbg32_support_action; 304 Dbg64_support_action; 305 Dbg32_support_load; 306 Dbg64_support_load; 307 Dbg32_support_req; 308 Dbg64_support_req; 309 310 Dbg32_syminfo_entry; 311 Dbg64_syminfo_entry; 312 Dbg32_syminfo_title; 313 Dbg64_syminfo_title; 314 315 Dbg32_syms_ar_checking; 316 Dbg64_syms_ar_checking; 317 Dbg32_syms_ar_entry; 318 Dbg64_syms_ar_entry; 319 Dbg32_syms_ar_resolve; 320 Dbg64_syms_ar_resolve; 321 Dbg32_syms_ar_title; 322 Dbg64_syms_ar_title; 323 Dbg32_syms_created; 324 Dbg64_syms_created; 325 Dbg32_syms_discarded; 326 Dbg64_syms_discarded; 327 Dbg32_syms_dlsym; 328 Dbg64_syms_dlsym; 329 Dbg32_syms_dup_sort_addr; 330 Dbg64_syms_dup_sort_addr; 331 Dbg32_syms_entered; 332 Dbg64_syms_entered; 333 Dbg32_syms_entry; 334 Dbg64_syms_entry; 335 Dbg32_syms_global; 336 Dbg64_syms_global; 337 Dbg32_syms_ignore; 338 Dbg64_syms_ignore; 339 Dbg32_syms_ignore_gnuver; 340 Dbg64_syms_ignore_gnuver; 341 Dbg32_syms_lazy_rescan; 342 Dbg64_syms_lazy_rescan; 343 Dbg32_syms_lookup; 344 Dbg64_syms_lookup; 345 Dbg32_syms_lookup_aout; 346 Dbg32_syms_new; 347 Dbg64_syms_new; 348 Dbg32_syms_old; 349 Dbg64_syms_old; 350 Dbg32_syms_process; 351 Dbg64_syms_process; 352 Dbg32_syms_reduce; 353 Dbg64_syms_reduce; 354 Dbg32_syms_reloc; 355 Dbg64_syms_reloc; 356 Dbg32_syms_resolved; 357 Dbg64_syms_resolved; 358 Dbg32_syms_resolving; 359 Dbg64_syms_resolving; 360 Dbg32_syms_sec_entry; 361 Dbg64_syms_sec_entry; 362 Dbg32_syms_sec_title; 363 Dbg64_syms_sec_title; 364 Dbg32_syms_spec_title; 365 Dbg64_syms_spec_title; 366 Dbg32_syms_updated; 367 Dbg64_syms_updated; 368 Dbg32_syms_up_title; 369 Dbg64_syms_up_title; 370 371 Dbg_tls_modactivity; 372 Dbg_tls_static_block; 373 Dbg_tls_static_resv; 374 375 Dbg32_util_broadcast; 376 Dbg64_util_broadcast; 377 Dbg32_util_call_array; 378 Dbg64_util_call_array; 379 Dbg32_util_call_fini; 380 Dbg64_util_call_fini; 381 Dbg32_util_call_init; 382 Dbg64_util_call_init; 383 Dbg32_util_call_main; 384 Dbg64_util_call_main; 385 Dbg32_util_collect; 386 Dbg64_util_collect; 387 Dbg32_util_dbnotify; 388 Dbg64_util_dbnotify; 389 Dbg32_util_edge_in; 390 Dbg64_util_edge_in; 391 Dbg32_util_edge_out; 392 Dbg64_util_edge_out; 393 Dbg32_util_lcinterface; 394 Dbg64_util_lcinterface; 395 Dbg32_util_intoolate; 396 Dbg64_util_intoolate; 397 Dbg32_util_nl; 398 Dbg64_util_nl; 399 Dbg32_util_no_init; 400 Dbg64_util_no_init; 401 Dbg32_util_scc_entry; 402 Dbg64_util_scc_entry; 403 Dbg32_util_scc_title; 404 Dbg64_util_scc_title; 405 Dbg32_util_str; 406 Dbg64_util_str; 407 Dbg32_util_wait; 408 Dbg64_util_wait; 409 410 Dbg32_unused_file; 411 Dbg64_unused_file; 412 Dbg32_unused_lcinterface; 413 Dbg64_unused_lcinterface; 414 Dbg32_unused_sec; 415 Dbg64_unused_sec; 416 Dbg32_unused_unref; 417 Dbg64_unused_unref; 418 419 Dbg32_ver_avail_entry; 420 Dbg64_ver_avail_entry; 421 Dbg32_ver_avail_title; 422 Dbg64_ver_avail_title; 423 Dbg32_ver_def_title; 424 Dbg64_ver_def_title; 425 Dbg32_ver_desc_entry; 426 Dbg64_ver_desc_entry; 427 Dbg32_ver_need_entry; 428 Dbg64_ver_need_entry; 429 Dbg32_ver_need_title; 430 Dbg64_ver_need_title; 431 Dbg32_ver_nointerface; 432 Dbg64_ver_nointerface; 433 Dbg32_ver_symbol; 434 Dbg64_ver_symbol; 435 436} SUNWprivate_3.23; 437 438 439# The following interfaces are used by various parts of the link-editors and 440# elfdump(1). The link-editors are always packaged together but there 441# seems to be a variety of old elfdump's lying around. elfdump only uses 442# this interface, and thus by separating in from the ever changing Dbg_* 443# interfaces we can provide a stable versioning environment for this utility. 444 445SUNWprivate_3.23 { 446 global: 447 Elf_syminfo_entry; 448 Elf_syminfo_title; 449 450 Elf32_cap_entry; 451 Elf64_cap_entry; 452 Elf32_cap_title; 453 Elf64_cap_title; 454 455 Elf32_demangle_name; 456 Elf64_demangle_name; 457 Elf32_dyn_entry; 458 Elf64_dyn_entry; 459 Elf32_dyn_null_entry; 460 Elf64_dyn_null_entry; 461 Elf32_dyn_title; 462 Elf64_dyn_title; 463 464 Elf32_ehdr; 465 Elf64_ehdr; 466 467 Elf32_got_entry; 468 Elf64_got_entry; 469 Elf32_got_title; 470 Elf64_got_title; 471 472 Elf32_phdr; 473 Elf64_phdr; 474 475 Elf32_reloc_apply_reg; 476 Elf64_reloc_apply_reg; 477 Elf32_reloc_apply_val; 478 Elf64_reloc_apply_val; 479 Elf32_reloc_entry_1; 480 Elf64_reloc_entry_1; 481 Elf32_reloc_entry_2; 482 Elf64_reloc_entry_2; 483 Elf32_reloc_title; 484 Elf64_reloc_title; 485 486 Elf32_shdr; 487 Elf64_shdr; 488 489 Elf32_syms_table_title; 490 Elf64_syms_table_title; 491 Elf32_syms_table_entry; 492 Elf64_syms_table_entry; 493 494 Elf32_ver_def_title; 495 Elf64_ver_def_title; 496 Elf32_ver_line_1; 497 Elf64_ver_line_1; 498 Elf32_ver_line_2; 499 Elf64_ver_line_2; 500 Elf32_ver_line_3; 501 Elf64_ver_line_3; 502 Elf32_ver_line_4; 503 Elf64_ver_line_4; 504 Elf32_ver_line_5; 505 Elf64_ver_line_5; 506 Elf32_ver_need_title; 507 Elf64_ver_need_title; 508 509 local: 510 *; 511}; 512 513# The following functions must be provided by our caller, or one of the callers 514# dependencies. When used with ld.so.1 all functions are provided from ld.so.1, 515# but when used with ld, many of the functions fall back to libc. Presently we 516# don't build liblddbg with a libc dependency simply to avoid having to load it 517# with ld.so.1 which already offers the required interfaces (from libc_pic.a). 518# Distinguishing between `parent' and `extern' symbols offers a small 519# performance advantage with direct bindings, but this is mainly a test of what 520# we're capable of doing, rather than an admission that its really worth it :-). 521 522{ 523 _dgettext = FUNCTION extern; 524 _close = FUNCTION extern; 525 _open = FUNCTION extern; 526 _write = FUNCTION extern; 527 dlopen = FUNCTION extern; 528 dlsym = FUNCTION extern; 529 free = FUNCTION parent; 530 malloc = FUNCTION parent; 531 memcpy = FUNCTION extern; 532 qsort = FUNCTION extern; 533 snprintf = FUNCTION extern; 534 sprintf = FUNCTION extern; 535 strcat = FUNCTION extern; 536 strcmp = FUNCTION extern; 537 strcpy = FUNCTION extern; 538 strlen = FUNCTION extern; 539 strrchr = FUNCTION extern; 540 strtok_r = FUNCTION extern; 541}; 542