xref: /onnv-gate/usr/src/stand/lib/crypto/README (revision 0:68f95e015346)
1*0Sstevel@tonic-gate#
2*0Sstevel@tonic-gate# CDDL HEADER START
3*0Sstevel@tonic-gate#
4*0Sstevel@tonic-gate# The contents of this file are subject to the terms of the
5*0Sstevel@tonic-gate# Common Development and Distribution License, Version 1.0 only
6*0Sstevel@tonic-gate# (the "License").  You may not use this file except in compliance
7*0Sstevel@tonic-gate# with the License.
8*0Sstevel@tonic-gate#
9*0Sstevel@tonic-gate# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10*0Sstevel@tonic-gate# or http://www.opensolaris.org/os/licensing.
11*0Sstevel@tonic-gate# See the License for the specific language governing permissions
12*0Sstevel@tonic-gate# and limitations under the License.
13*0Sstevel@tonic-gate#
14*0Sstevel@tonic-gate# When distributing Covered Code, include this CDDL HEADER in each
15*0Sstevel@tonic-gate# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16*0Sstevel@tonic-gate# If applicable, add the following below this CDDL HEADER, with the
17*0Sstevel@tonic-gate# fields enclosed by brackets "[]" replaced with your own identifying
18*0Sstevel@tonic-gate# information: Portions Copyright [yyyy] [name of copyright owner]
19*0Sstevel@tonic-gate#
20*0Sstevel@tonic-gate# CDDL HEADER END
21*0Sstevel@tonic-gate#
22*0Sstevel@tonic-gate#
23*0Sstevel@tonic-gate# Copyright 2003 Sun Microsystems, Inc.  All rights reserved.
24*0Sstevel@tonic-gate# Use is subject to license terms.
25*0Sstevel@tonic-gate#
26*0Sstevel@tonic-gate# ident	"%Z%%M%	%I%	%E% SMI"
27*0Sstevel@tonic-gate#
28*0Sstevel@tonic-gate	In order to determine which object files aren't used in building the
29*0Sstevel@tonic-gatestandalone boot applications, first build the standalone libraries
30*0Sstevel@tonic-gate
31*0Sstevel@tonic-gate	$ cd $SRC/stand/lib ; make install
32*0Sstevel@tonic-gate
33*0Sstevel@tonic-gateNext, collect some information from the linking process:
34*0Sstevel@tonic-gate
35*0Sstevel@tonic-gate	$ cd $SRC/psm/stand/boot/`uname -p`/`uname -m`
36*0Sstevel@tonic-gate	$ rm -f *.bin *boot *boot.elf
37*0Sstevel@tonic-gate	$ LD_OPTIONS="-Dbindings,files,symbols" make all > /dev/null 2> ld.debug
38*0Sstevel@tonic-gate
39*0Sstevel@tonic-gateThe following sort of information ends up in ld.debug (note that the debugging
40*0Sstevel@tonic-gateoutput from the link-editor is not considered a 'stable interface' and may
41*0Sstevel@tonic-gatechange in the future):
42*0Sstevel@tonic-gate
43*0Sstevel@tonic-gate	debug:
44*0Sstevel@tonic-gate	debug: file=/.../proto/root_sparc/stand/lib/libcrypto.a(cryptlib.o)  [ ET_REL ]
45*0Sstevel@tonic-gate	debug:
46*0Sstevel@tonic-gate	debug: symbol table processing; input file=/.../proto/root_sparc/stand/lib/libcrypto.a(cryptlib.o)  [ ET_REL ]
47*0Sstevel@tonic-gate	debug: symbol[1]=cryptlib.c
48*0Sstevel@tonic-gate	...
49*0Sstevel@tonic-gate
50*0Sstevel@tonic-gateNow run the following script
51*0Sstevel@tonic-gate
52*0Sstevel@tonic-gate	#!/bin/sh -
53*0Sstevel@tonic-gate
54*0Sstevel@tonic-gate	for obj in	$SRC/stand/lib/crypto/objs/*.o	\
55*0Sstevel@tonic-gate			$SRC/stand/lib/fs/*/objs/*.o	\
56*0Sstevel@tonic-gate			$SRC/stand/lib/sa/objs/*.o	\
57*0Sstevel@tonic-gate			$SRC/stand/lib/ssl/objs/*.o	\
58*0Sstevel@tonic-gate			$SRC/stand/lib/wanboot/objs/*.o
59*0Sstevel@tonic-gate	do
60*0Sstevel@tonic-gate		f=`basename $obj`
61*0Sstevel@tonic-gate		if egrep "^debug: file=.*\($f\)" ld.debug > /dev/null
62*0Sstevel@tonic-gate		then
63*0Sstevel@tonic-gate			:
64*0Sstevel@tonic-gate		else
65*0Sstevel@tonic-gate			echo $obj
66*0Sstevel@tonic-gate		fi
67*0Sstevel@tonic-gate	done
68*0Sstevel@tonic-gate
69*0Sstevel@tonic-gateto determine which of the .o files appears in none of the loader debug output
70*0Sstevel@tonic-gate(and therefore is unused).
71