~ubuntu-branches/debian/sid/upx-ucl/sid

« back to all changes in this revision

Viewing changes to src/stub/util/sstrip/README.1ST

  • Committer: Bazaar Package Importer
  • Author(s): Robert Luberda
  • Date: 2006-06-13 21:23:23 UTC
  • mfrom: (1.3.1 upstream) (3.1.2 edgy)
  • Revision ID: james.westby@ubuntu.com-20060613212323-343yzs4jt6vr5483
* New upstream version.
* Standards-Version: 3.7.2 (no changes).

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
This distribution is a collection of programs that are generally
 
2
unrelated, except in that they all deal with the ELF file format.
 
3
 
 
4
The main purpose of these programs is to be illustrative and
 
5
educational -- to help fellow programmers understand the ELF file
 
6
format and something of how it works under the Linux platform. For the
 
7
most part, these programs have limited real-world utility. (Although I
 
8
myself have found some of these programs quite useful while writing
 
9
the others.)
 
10
 
 
11
Each program is independent. There is no shared code between them, and
 
12
in fact they all take slightly different approaches to handling ELF
 
13
files.
 
14
 
 
15
The table of contents:
 
16
 
 
17
sstrip/
 
18
  sstrip is a small utility that removes everything from an ELF file
 
19
  that is not part of the file's memory image.
 
20
 
 
21
rebind/
 
22
  rebind is another small utility that alters the binding of selected
 
23
  exported symbols in an ELF object file.
 
24
 
 
25
elfls/
 
26
  elfls is a utility that displays an ELF file's program and/or
 
27
  section header tables, which serve as a kind of global roadmap to
 
28
  the file's contents.
 
29
 
 
30
elftoc/
 
31
  elftoc takes an ELF file and generates C code that defines a
 
32
  structure with the same memory image, using the structures and
 
33
  preprocessor symbols defined in <linux/elf.h>.
 
34
 
 
35
ebfc/
 
36
  ebfc is a compiler for a tiny programming language. The compiler can
 
37
  generate ELF executables, object files, and shared libraries.
 
38
 
 
39
tiny/
 
40
  This directory contains a collection of very small ELF executables.
 
41
 
 
42
See the README in each directory for more details.
 
43
 
 
44
The ELF standard is necessary reading if you wish to fully understand
 
45
how all of the programs work. You can download a copy as a Postscript
 
46
document from ftp://tsx.mit.edu/pub/linux/packages/GCC/ELF.doc.tar.gz.
 
47
Alternately, you can obtain a flat-text transcription of this document
 
48
from http://www.muppetlabs.com/~breadbox/software/ELF.txt.
 
49
 
 
50
    These programs are Copyright (C) 1999-2001 by Brian Raiter.
 
51
 
 
52
    These programs are all free software; you can redistribute and/or
 
53
    modify them under the terms of the GNU General Public License as
 
54
    published by the Free Software Foundation; either version 2 of the
 
55
    License, or (at your option) any later version.
 
56
 
 
57
    These programs are distributed in the hope that they will be
 
58
    interesting, but without any warranty; without even the implied
 
59
    warranty of merchantability or fitness for a particular purpose.
 
60
    See the GNU General Public License for more details.
 
61
 
 
62
    You should have received a copy of the GNU General Public License
 
63
    along with this program, in the file COPYING. If not, write to the
 
64
    Free Software Foundation, Inc., 59 Temple Place, Suite 330,
 
65
    Boston, MA 02111-1307 USA.
 
66
 
 
67
Bug reports and general feedback should be directed to the author at
 
68
breadbox@muppetlabs.com.
 
69
 
 
70
Share and enjoy.
 
71
 
 
72
Brian Raiter
 
73
breadbox@muppetlabs.com