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