1/*
2 * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
3 *
4 * @APPLE_LICENSE_HEADER_START@
5 *
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. Please obtain a copy of the License at
10 * http://www.opensource.apple.com/apsl/ and read it before using this
11 * file.
12 *
13 * The Original Code and all software distributed under the License are
14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 * Please see the License for the specific language governing rights and
19 * limitations under the License.
20 *
21 * @APPLE_LICENSE_HEADER_END@
22 */
23/* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
24/*
25 * Copyright (c) 1990, 1982, 1985, 1986, 1988, 1993, 1994
26 *	The Regents of the University of California.  All rights reserved.
27 *
28 * Redistribution and use in source and binary forms, with or without
29 * modification, are permitted provided that the following conditions
30 * are met:
31 * 1. Redistributions of source code must retain the above copyright
32 *    notice, this list of conditions and the following disclaimer.
33 * 2. Redistributions in binary form must reproduce the above copyright
34 *    notice, this list of conditions and the following disclaimer in the
35 *    documentation and/or other materials provided with the distribution.
36 * 3. All advertising materials mentioning features or use of this software
37 *    must display the following acknowledgement:
38 *	This product includes software developed by the University of
39 *	California, Berkeley and its contributors.
40 * 4. Neither the name of the University nor the names of its contributors
41 *    may be used to endorse or promote products derived from this software
42 *    without specific prior written permission.
43 *
44 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
45 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
46 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
47 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
48 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
49 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
50 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
51 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
52 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
53 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
54 * SUCH DAMAGE.
55 *
56 *	@(#)ranlib.h	8.1 (Berkeley) 6/2/93
57 */
58#ifndef _RANLIB_H_
59#define _RANLIB_H_
60
61#include <sys/types.h>		/* off_t */
62
63/*
64 * There are two known orders of table of contents for archives.  The first is
65 * the order ranlib(1) originally produced and still produces without any
66 * options.  This table of contents has the archive member name "__.SYMDEF"
67 * This order has the ranlib structures in the order the objects appear in the
68 * archive and the symbol names of those objects in the order of symbol table.
69 * The second know order is sorted by symbol name and is produced with the -s
70 * option to ranlib(1).  This table of contents has the archive member name
71 * "__.SYMDEF SORTED" and many programs (notably the 1.0 version of ld(1) can't
72 * tell the difference between names because of the imbedded blank in the name
73 * and works with either table of contents).  This second order is used by the
74 * post 1.0 link editor to produce faster linking.  The original 1.0 version of
75 * ranlib(1) gets confused when it is run on a archive with the second type of
76 * table of contents because it and ar(1) which it uses use different ways to
77 * determined the member name (ar(1) treats all blanks in the name as
78 * significant and ranlib(1) only checks for the first one).
79 */
80#define SYMDEF		"__.SYMDEF"
81#define SYMDEF_SORTED	"__.SYMDEF SORTED"
82
83#define	RANLIBMAG	"__.SYMDEF"	/* archive file name */
84#define	RANLIBSKEW	3		/* creation time offset */
85
86/*
87 * Structure of the __.SYMDEF table of contents for an archive.
88 * __.SYMDEF begins with a long giving the size in bytes of the ranlib
89 * structures which immediately follow, and then continues with a string
90 * table consisting of a long giving the number of bytes of strings which
91 * follow and then the strings themselves.  The ran_strx fields index the
92 * string table whose first byte is numbered 0.
93 */
94struct	ranlib {
95	union {
96		off_t	ran_strx;	/* string table index of */
97		char	*ran_name;	/* symbol defined by */
98	} ran_un;
99	off_t	ran_off;		/* library member at this offset */
100};
101#endif /* ! _RANLIB_H_ */
102