scripts/shlib-symbols

#!/usr/bin/env bash

# Copyright 2016 The Fuchsia Authors
#
# Use of this source code is governed by a MIT-style
# license that can be found in the LICENSE file or at
# https://opensource.org/licenses/MIT

# This script reads the dynamic symbol table of a DSO (ELF file) via nm
# and writes out a sequence of lines for each symbol in the DSO's ABI
# that can be used as C macros.  The macro invocations it writes look like:
#   TYPE(NAME, [ADDRESS,] SIZE)
# The ADDRESS parameter is included only if the script is given the -a switch.
# The SIZE is forced to 0 for functions if the script is given the -z switch.
# The TYPE is one of:
#   COMMON_OBJECT               STT_COMMON symbol
#   UNDEFINED                   SHN_UNDEF symbol
#   UNDEFINED_WEAK_OBJECT       SHN_UNDEF, STB_WEAK, STT_OBJECT symbol
#   UNDEFINED_WEAK              SHN_UNDEF, STB_WEAK, STT_FUNC symbol
#   WEAK_DATA_OBJECT            STB_WEAK, STT_OBJECT symbol
#   WEAK_FUNCTION               STB_WEAK, STT_FUNC symbol
#   FUNCTION                    STB_GLOBAL, STT_FUNC symbol
#   RODATA_OBJECT               STB_GLOBAL, STT_OBJECT symbol in R/O section
#   DATA_OBJECT                 STB_GLOBAL, STT_OBJECT symbol in R/W section
#   BSS_OBJECT                  STB_GLOBAL symbol in SHT_NOBITS section
# (nm actually uses a haphazard combination of ELF symbol details and
# section details to choose its type letters rather than directly using the
# ELF symbol bits consistently.  But the type letters map to these symbol
# details when symbols are defined in the usual ways by a compiler.)

if [ "$(basename $0)" = "sh" ]
then
  set -e
else
  set -o pipefail -e
fi

show_address=false
zero_function_size=false
while [ $# -gt 0 ]; do
  case "$1" in
  -a) show_address=true ;;
  -z) zero_function_size=true ;;
  *) break ;;
  esac
  shift
done

if [ $# -ne 2 ]; then
  echo >&2 "Usage: $0 [-a] [-z] NM DSO"
  exit 2
fi

NM="$1"
DSO="$2"

dump_names() {
  "$NM" -P -g -D -S "$DSO"
}

massage() {
  local read name type addr size
  while read name type addr size; do

    # The numbers are printed in hex, but without a leading "0x" indicator.
    addr="0x$addr"
    if [ -z "$size" ]; then
      size="0x0"
    else
      size="0x$size"
    fi

    case "$name" in
    # Linkers sometimes emit these symbols into .dynsym, but they are useless
    # and should not be consider part of the ABI.
    __bss_start|__bss_start__|__bss_end__|_bss_end__) continue ;;
    __data_start|__end__|_stack|_etext|_edata|_end) continue ;;
    __start_xray_fn_idx|__stop_xray_fn_idx) continue ;;
    __start_xray_instr_map|__stop_xray_instr_map) continue ;;
    esac

    case "$type" in
    C) type=COMMON_OBJECT ;;
    U) type=UNDEFINED ;;
    v) type=UNDEFINED_WEAK_OBJECT ;;
    w) type=UNDEFINED_WEAK ;;
    V) type=WEAK_DATA_OBJECT ;;
    W) type=WEAK_FUNCTION ;;
    T) type=FUNCTION ;;
    R) type=RODATA_OBJECT ;;
    D) type=DATA_OBJECT ;;
    B) type=BSS_OBJECT ;;
    *)
      echo >&2 "$0: Unhandled type '${type}' for symbol '${name}'"
      exit 1
      ;;
    esac

    if $show_address; then
      address_item=", $addr"
    else
      address_item=
    fi

    if $zero_function_size; then
      case $type in
      FUNCTION|WEAK_FUNCTION) size="0x0" ;;
      esac
    fi

    echo "${type}(${name}${address_item}, ${size})"

  done
}

dump_names | massage