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 2008 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.62 { 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_genstr_compress; 276 Dbg64_sec_genstr_compress; 277 Dbg32_sec_group; 278 Dbg64_sec_group; 279 Dbg32_sec_in; 280 Dbg64_sec_in; 281 Dbg32_sec_order_error; 282 Dbg64_sec_order_error; 283 Dbg32_sec_order_list; 284 Dbg64_sec_order_list; 285 Dbg32_sec_strtab; 286 Dbg64_sec_strtab; 287 Dbg32_sec_unsup_strmerge; 288 Dbg64_sec_unsup_strmerge; 289 290 Dbg32_seg_entry; 291 Dbg64_seg_entry; 292 Dbg32_seg_list; 293 Dbg64_seg_list; 294 Dbg32_seg_os; 295 Dbg64_seg_os; 296 Dbg32_seg_title; 297 Dbg64_seg_title; 298 299 Dbg32_shdr_modified; 300 Dbg64_shdr_modified; 301 302 Dbg32_statistics_ar; 303 Dbg64_statistics_ar; 304 Dbg32_statistics_ld; 305 Dbg64_statistics_ld; 306 307 Dbg32_support_action; 308 Dbg64_support_action; 309 Dbg32_support_load; 310 Dbg64_support_load; 311 Dbg32_support_req; 312 Dbg64_support_req; 313 314 Dbg32_syminfo_entry; 315 Dbg64_syminfo_entry; 316 Dbg32_syminfo_title; 317 Dbg64_syminfo_title; 318 319 Dbg32_syms_ar_checking; 320 Dbg64_syms_ar_checking; 321 Dbg32_syms_ar_entry; 322 Dbg64_syms_ar_entry; 323 Dbg32_syms_ar_resolve; 324 Dbg64_syms_ar_resolve; 325 Dbg32_syms_ar_title; 326 Dbg64_syms_ar_title; 327 Dbg32_syms_created; 328 Dbg64_syms_created; 329 Dbg32_syms_discarded; 330 Dbg64_syms_discarded; 331 Dbg32_syms_dlsym; 332 Dbg64_syms_dlsym; 333 Dbg32_syms_dup_sort_addr; 334 Dbg64_syms_dup_sort_addr; 335 Dbg32_syms_entered; 336 Dbg64_syms_entered; 337 Dbg32_syms_entry; 338 Dbg64_syms_entry; 339 Dbg32_syms_global; 340 Dbg64_syms_global; 341 Dbg32_syms_ignore; 342 Dbg64_syms_ignore; 343 Dbg32_syms_ignore_gnuver; 344 Dbg64_syms_ignore_gnuver; 345 Dbg32_syms_lazy_rescan; 346 Dbg64_syms_lazy_rescan; 347 Dbg32_syms_lookup; 348 Dbg64_syms_lookup; 349 Dbg32_syms_lookup_aout; 350 Dbg32_syms_new; 351 Dbg64_syms_new; 352 Dbg32_syms_old; 353 Dbg64_syms_old; 354 Dbg32_syms_process; 355 Dbg64_syms_process; 356 Dbg32_syms_reduce; 357 Dbg64_syms_reduce; 358 Dbg32_syms_reloc; 359 Dbg64_syms_reloc; 360 Dbg32_syms_resolved; 361 Dbg64_syms_resolved; 362 Dbg32_syms_resolving; 363 Dbg64_syms_resolving; 364 Dbg32_syms_sec_entry; 365 Dbg64_syms_sec_entry; 366 Dbg32_syms_sec_title; 367 Dbg64_syms_sec_title; 368 Dbg32_syms_spec_title; 369 Dbg64_syms_spec_title; 370 Dbg32_syms_updated; 371 Dbg64_syms_updated; 372 Dbg32_syms_up_title; 373 Dbg64_syms_up_title; 374 375 Dbg_tls_modactivity; 376 Dbg_tls_static_block; 377 Dbg_tls_static_resv; 378 379 Dbg32_util_broadcast; 380 Dbg64_util_broadcast; 381 Dbg32_util_call_array; 382 Dbg64_util_call_array; 383 Dbg32_util_call_fini; 384 Dbg64_util_call_fini; 385 Dbg32_util_call_init; 386 Dbg64_util_call_init; 387 Dbg32_util_call_main; 388 Dbg64_util_call_main; 389 Dbg32_util_collect; 390 Dbg64_util_collect; 391 Dbg32_util_dbnotify; 392 Dbg64_util_dbnotify; 393 Dbg32_util_edge_in; 394 Dbg64_util_edge_in; 395 Dbg32_util_edge_out; 396 Dbg64_util_edge_out; 397 Dbg32_util_lcinterface; 398 Dbg64_util_lcinterface; 399 Dbg32_util_intoolate; 400 Dbg64_util_intoolate; 401 Dbg32_util_nl; 402 Dbg64_util_nl; 403 Dbg32_util_no_init; 404 Dbg64_util_no_init; 405 Dbg32_util_scc_entry; 406 Dbg64_util_scc_entry; 407 Dbg32_util_scc_title; 408 Dbg64_util_scc_title; 409 Dbg32_util_str; 410 Dbg64_util_str; 411 Dbg32_util_wait; 412 Dbg64_util_wait; 413 414 Dbg32_unused_file; 415 Dbg64_unused_file; 416 Dbg32_unused_lcinterface; 417 Dbg64_unused_lcinterface; 418 Dbg32_unused_path; 419 Dbg64_unused_path; 420 Dbg32_unused_sec; 421 Dbg64_unused_sec; 422 Dbg32_unused_unref; 423 Dbg64_unused_unref; 424 425 Dbg32_ver_avail_entry; 426 Dbg64_ver_avail_entry; 427 Dbg32_ver_avail_title; 428 Dbg64_ver_avail_title; 429 Dbg32_ver_def_title; 430 Dbg64_ver_def_title; 431 Dbg32_ver_desc_entry; 432 Dbg64_ver_desc_entry; 433 Dbg32_ver_need_entry; 434 Dbg64_ver_need_entry; 435 Dbg32_ver_need_title; 436 Dbg64_ver_need_title; 437 Dbg32_ver_nointerface; 438 Dbg64_ver_nointerface; 439 Dbg32_ver_symbol; 440 Dbg64_ver_symbol; 441 442} SUNWprivate_3.23; 443 444 445# The following interfaces are used by various parts of the link-editors and 446# elfdump(1). The link-editors are always packaged together but there 447# seems to be a variety of old elfdump's lying around. elfdump only uses 448# this interface, and thus by separating in from the ever changing Dbg_* 449# interfaces we can provide a stable versioning environment for this utility. 450 451SUNWprivate_3.23 { 452 global: 453 Elf_syminfo_entry; 454 Elf_syminfo_title; 455 456 Elf32_cap_entry; 457 Elf64_cap_entry; 458 Elf32_cap_title; 459 Elf64_cap_title; 460 461 Elf32_demangle_name; 462 Elf64_demangle_name; 463 Elf32_dyn_entry; 464 Elf64_dyn_entry; 465 Elf32_dyn_null_entry; 466 Elf64_dyn_null_entry; 467 Elf32_dyn_title; 468 Elf64_dyn_title; 469 470 Elf32_ehdr; 471 Elf64_ehdr; 472 473 Elf32_got_entry; 474 Elf64_got_entry; 475 Elf32_got_title; 476 Elf64_got_title; 477 478 Elf32_phdr; 479 Elf64_phdr; 480 481 Elf32_reloc_apply_reg; 482 Elf64_reloc_apply_reg; 483 Elf32_reloc_apply_val; 484 Elf64_reloc_apply_val; 485 Elf32_reloc_entry_1; 486 Elf64_reloc_entry_1; 487 Elf32_reloc_entry_2; 488 Elf64_reloc_entry_2; 489 Elf32_reloc_title; 490 Elf64_reloc_title; 491 492 Elf32_shdr; 493 Elf64_shdr; 494 495 Elf32_syms_table_title; 496 Elf64_syms_table_title; 497 Elf32_syms_table_entry; 498 Elf64_syms_table_entry; 499 500 Elf32_ver_def_title; 501 Elf64_ver_def_title; 502 Elf32_ver_line_1; 503 Elf64_ver_line_1; 504 Elf32_ver_line_2; 505 Elf64_ver_line_2; 506 Elf32_ver_line_3; 507 Elf64_ver_line_3; 508 Elf32_ver_line_4; 509 Elf64_ver_line_4; 510 Elf32_ver_line_5; 511 Elf64_ver_line_5; 512 Elf32_ver_need_title; 513 Elf64_ver_need_title; 514 515 local: 516 *; 517}; 518 519# The following functions must be provided by our caller, or one of the callers 520# dependencies. When used with ld.so.1 all functions are provided from ld.so.1, 521# but when used with ld, many of the functions fall back to libc. Presently we 522# don't build liblddbg with a libc dependency simply to avoid having to load it 523# with ld.so.1 which already offers the required interfaces (from libc_pic.a). 524# Distinguishing between `parent' and `extern' symbols offers a small 525# performance advantage with direct bindings, but this is mainly a test of what 526# we're capable of doing, rather than an admission that its really worth it :-). 527 528{ 529 _close = FUNCTION extern; 530 _open = FUNCTION extern; 531 _write = FUNCTION extern; 532 dgettext = FUNCTION extern; 533 dlopen = FUNCTION extern; 534 dlsym = FUNCTION extern; 535 free = FUNCTION parent; 536 malloc = FUNCTION parent; 537 memcpy = FUNCTION extern; 538 qsort = FUNCTION extern; 539 snprintf = FUNCTION extern; 540 sprintf = FUNCTION extern; 541 strcat = FUNCTION extern; 542 strcmp = FUNCTION extern; 543 strcpy = FUNCTION extern; 544 strlen = FUNCTION extern; 545 strrchr = FUNCTION extern; 546 strtok_r = FUNCTION extern; 547}; 548