Merge branch 'vendor/GCC44'
[dragonfly.git] / contrib / binutils-2.22 / include / aout / ranlib.h
1 /* ranlib.h -- archive library index member definition for GNU.
2    Copyright 1990, 1991, 2010 Free Software Foundation, Inc.
3
4    This program is free software; you can redistribute it and/or modify
5    it under the terms of the GNU General Public License as published by
6    the Free Software Foundation; either version 3 of the License, or
7    (at your option) any later version.
8
9    This program is distributed in the hope that it will be useful,
10    but WITHOUT ANY WARRANTY; without even the implied warranty of
11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12    GNU General Public License for more details.
13
14    You should have received a copy of the GNU General Public License
15    along with this program; if not, write to the Free Software
16    Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
17    MA 02110-1301, USA.  */
18
19 /* The Symdef member of an archive contains two things:
20    a table that maps symbol-string offsets to file offsets,
21    and a symbol-string table.  All the symbol names are
22    run together (each with trailing null) in the symbol-string
23    table.  There is a single longword bytecount on the front
24    of each of these tables.  Thus if we have two symbols,
25    "foo" and "_bar", that are in archive members at offsets
26    200 and 900, it would look like this:
27         16              ; byte count of index table
28         0               ; offset of "foo" in string table
29         200             ; offset of foo-module in file
30         4               ; offset of "bar" in string table
31         900             ; offset of bar-module in file
32         9               ; byte count of string table
33         "foo\0_bar\0"   ; string table  */
34
35 #define RANLIBMAG       "__.SYMDEF"     /* Archive file name containing index */
36 #define RANLIBSKEW      3               /* Creation time offset */
37
38 /* Format of __.SYMDEF:
39    First, a longword containing the size of the 'symdef' data that follows.
40    Second, zero or more 'symdef' structures.
41    Third, a longword containing the length of symbol name strings.
42    Fourth, zero or more symbol name strings (each followed by a null).  */
43
44 struct symdef
45   {
46     union
47       {
48         unsigned long string_offset;    /* In the file */
49         char *name;                     /* In memory, sometimes */
50       } s;
51     /* this points to the front of the file header (AKA member header --
52        a struct ar_hdr), not to the front of the file or into the file).
53        in other words it only tells you which file to read */       
54     unsigned long file_offset;
55   };
56
57 /* Compatability with BSD code */
58
59 #define ranlib  symdef
60 #define ran_un  s
61 #define ran_strx string_offset
62 #define ran_name name
63 #define ran_off file_offset