00README revision 20c1c3551cb3b3117591ae38463d16aada597c48
80833bb9a1bf25dcf19e814438a4b311d2e1f4cffuankg# CDDL HEADER START
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic# The contents of this file are subject to the terms of the
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic# Common Development and Distribution License (the "License").
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic# You may not use this file except in compliance with the License.
4da61833a1cbbca94094f9653fd970582b97a72etrawick# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
4da61833a1cbbca94094f9653fd970582b97a72etrawick# See the License for the specific language governing permissions
4da61833a1cbbca94094f9653fd970582b97a72etrawick# and limitations under the License.
4789804be088bcd86ae637a29cdb7fda25169521jailletc# When distributing Covered Code, include this CDDL HEADER in each
4789804be088bcd86ae637a29cdb7fda25169521jailletc# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
4789804be088bcd86ae637a29cdb7fda25169521jailletc# If applicable, add the following below this CDDL HEADER, with the
4789804be088bcd86ae637a29cdb7fda25169521jailletc# fields enclosed by brackets "[]" replaced with your own identifying
e50c3026198fd496f183cda4c32a202925476778covener# information: Portions Copyright [yyyy] [name of copyright owner]
e50c3026198fd496f183cda4c32a202925476778covener# CDDL HEADER END
6c3b9cebb551140fbb25d58bae08b539b3802133ylavic# Copyright (c) 1995, 2010, Oracle and/or its affiliates. All rights reserved.
4f29b65ab4b547ad5dbe506e2d0ff5d12ead9247ylavicThis directory contains sample programs that demonstrate how to use libelf.
4f29b65ab4b547ad5dbe506e2d0ff5d12ead9247ylavicManual pages for libelf routines are located in section 3e: Library Functions.
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavicEach of these sample programs displays, or manipulates information from a ELF
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavicfile. Each program uses libelf differently. To learn more about ELF files
0a0df13b7f1f4f1a74fe295253d89ca3911b301aylavicand their format refer to the "Linker & Libraries Guide", which is part of the
69301145375a889e7e37caf7cc7321ac0f91801erpluem"Software Developer Collection", and the "System V Application Binary
506bfe33206b2fece40ef25f695af39dd4130facjkaluzaThe following source files are provided:
506bfe33206b2fece40ef25f695af39dd4130facjkaluzapcom.c print comment: prints the .comment section of an ELF file.
506bfe33206b2fece40ef25f695af39dd4130facjkaluza Demonstrates how to examine a file opened with
d58a848a016d401b965111e50ef829e1641f7834minfrin elf_begin(ELF_C_READ)
d58a848a016d401b965111e50ef829e1641f7834minfrinacom.c append comment: appends to, or creates a .comment section
2e6f4d654c96c98b761fb012fd25c5d5b1558c44sf within an ELF file. Demonstrates the updating of a file with
2e6f4d654c96c98b761fb012fd25c5d5b1558c44sf elf_begin(ELF_C_RDWR)
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavicdcom.c delete comment: deletes a .comment section from an ELF file.
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic Demonstrates the creation of a ELF file with
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavic elf_begin(ELF_C_WRITE)
17e6c95f3b22d18acdf8380fb26a8d0e10c80767ylavictpcom.c threaded print comment: a threaded version of pcom.c.
e8bd80a4bb88199d2f9a24a50345688e52d9c116ylavic Demonstrates that libelf is MT-Safe and can be used by a
e8bd80a4bb88199d2f9a24a50345688e52d9c116ylavic threaded program.
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavicdispsyms.c print symbols: scans a ELF file for any symbol tables
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic (SHT_SYMTAB, SHT_DYNSYM, or SHT_SUNW_LDYNSYM) and
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic displays the symbol tables contents.
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavicMakefile make file to build the above programs.
d7205b1a86c51c27b71a2c458dc453fd53a261c1covenerBuilding the demos
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener------------------
d7205b1a86c51c27b71a2c458dc453fd53a261c1covenerTo build the programs:
44ff304057225e944e220e981d434a046d14cf06covenerTo test the programs:
5d1ba75b8794925e67591c209085a49279791de9covener % make test