Home | History | Annotate | Download | only in aout
      1 /* ranlib.h -- archive library index member definition for GNU.
      2    Copyright (C) 1990-2014 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
     64