| 1 |
/* ranlib.h -- archive library index member definition for GNU. |
| 2 |
Copyright (C) 1990-2025 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 |