2 .\"
3 .\" CDDL HEADER START
4 .\"
5 .\" The contents of this file are subject to the terms of the
6 .\" Common Development and Distribution License (the "License").
7 .\" You may not use this file except in compliance with the License.
8 .\"
9 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10 .\" or http://www.opensolaris.org/os/licensing.
11 .\" See the License for the specific language governing permissions
12 .\" and limitations under the License.
13 .\"
14 .\" When distributing Covered Code, include this CDDL HEADER in each
15 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16 .\" If applicable, add the following below this CDDL HEADER, with the
17 .\" fields enclosed by brackets "[]" replaced with your own identifying
18 .\" information: Portions Copyright [yyyy] [name of copyright owner]
19 .\"
20 .\" CDDL HEADER END
21 .\"
22 .TH interface_cmp 1 "25 March 2010"
23 .SH NAME
24 interface_cmp \- compare shared object interface descriptions
25 .SH SYNOPSIS
26 \fBinterface_cmp [-dot] [-e exfile] old new\fP
27 .LP
28 .SH DESCRIPTION
29 .IX "OS-Net build tools" "interface_cmp" "" "\fBinterface_cmp\fP"
30 The
31 .I interface_cmp
32 command compares the interface definition files for two workspaces
33 and reports versioning inconsistencies. Interface definition
34 files are created by
35 .IR interface_check.
36 .PP
37 .I interface_cmp
38 is typically called from \fBnightly(1)\fP when the \fB-A\fP
39 option is in effect following the creation of a new database by
40 .IR interface_check .
41 To insure symbolic
42 interface consistency between successive software releases, existing
43 version definitions and their symbol association should remain intact.
44 Any discrepancies between the two interface definitions are flagged as
45 errors.
46 .PP
47 Note that version definition inheritance has the effect of causing a
48 symbol to be viewed as existing in multiple definitions. This insures
49 that both version definitions and their inheritance relationship are
50 processed as part of the comparison.
51 .LP
52 .SH OPTIONS
53 .LP
54 The following options are supported:
55 .TP 4
56 .B \-c vertype_module
57 By default,
58 .I interface_cmp
218 The following example uses
219 .I interface_cmp
220 to compare this releases interface definition with a previous
221 builds results:
222 .PP
223 .RS
224 .nf
225 .B % interface_cmp -d -o $SRC/ELF-data.$MACH.ref/interfaces\ \\\\
226 .B \ \ \ \ \ \ \ $SRC/ELF-data.$MACH/interfaces
227 lib/libadm.so.1: SUNW_1.1: added interface: circf(4)
228 lib/libaio.so.1: SUNW_1.1: deleted interface: _aiocancel
229 .fi
230 .RE
231 .sp
232 .PP
233 Note: the above comparison files were doctored in order to provide
234 the example, they do not indicate any real changes that have
235 occurred in the associated system libraries.
236 .br
237 .SH SEE ALSO
238 .BR find_elf(1),
239 .BR interface_check(1),
240 .BR ld(1),
241 .BR ldd(1),
242 .BR elfdump(1),
243 .BR pvs(1).
244 .LP
245 .TZ LLM
|
2 .\"
3 .\" CDDL HEADER START
4 .\"
5 .\" The contents of this file are subject to the terms of the
6 .\" Common Development and Distribution License (the "License").
7 .\" You may not use this file except in compliance with the License.
8 .\"
9 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10 .\" or http://www.opensolaris.org/os/licensing.
11 .\" See the License for the specific language governing permissions
12 .\" and limitations under the License.
13 .\"
14 .\" When distributing Covered Code, include this CDDL HEADER in each
15 .\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16 .\" If applicable, add the following below this CDDL HEADER, with the
17 .\" fields enclosed by brackets "[]" replaced with your own identifying
18 .\" information: Portions Copyright [yyyy] [name of copyright owner]
19 .\"
20 .\" CDDL HEADER END
21 .\"
22 .TH interface_cmp 1ONBLD "25 March 2010"
23 .SH NAME
24 interface_cmp \- compare shared object interface descriptions
25 .SH SYNOPSIS
26 \fBinterface_cmp [-dot] [-e exfile] old new\fP
27 .LP
28 .SH DESCRIPTION
29 .IX "OS-Net build tools" "interface_cmp" "" "\fBinterface_cmp\fP"
30 The
31 .I interface_cmp
32 command compares the interface definition files for two workspaces
33 and reports versioning inconsistencies. Interface definition
34 files are created by
35 .IR interface_check.
36 .PP
37 .I interface_cmp
38 is typically called from \fBnightly(1ONBLD)\fP when the \fB-A\fP
39 option is in effect following the creation of a new database by
40 .IR interface_check .
41 To insure symbolic
42 interface consistency between successive software releases, existing
43 version definitions and their symbol association should remain intact.
44 Any discrepancies between the two interface definitions are flagged as
45 errors.
46 .PP
47 Note that version definition inheritance has the effect of causing a
48 symbol to be viewed as existing in multiple definitions. This insures
49 that both version definitions and their inheritance relationship are
50 processed as part of the comparison.
51 .LP
52 .SH OPTIONS
53 .LP
54 The following options are supported:
55 .TP 4
56 .B \-c vertype_module
57 By default,
58 .I interface_cmp
218 The following example uses
219 .I interface_cmp
220 to compare this releases interface definition with a previous
221 builds results:
222 .PP
223 .RS
224 .nf
225 .B % interface_cmp -d -o $SRC/ELF-data.$MACH.ref/interfaces\ \\\\
226 .B \ \ \ \ \ \ \ $SRC/ELF-data.$MACH/interfaces
227 lib/libadm.so.1: SUNW_1.1: added interface: circf(4)
228 lib/libaio.so.1: SUNW_1.1: deleted interface: _aiocancel
229 .fi
230 .RE
231 .sp
232 .PP
233 Note: the above comparison files were doctored in order to provide
234 the example, they do not indicate any real changes that have
235 occurred in the associated system libraries.
236 .br
237 .SH SEE ALSO
238 .BR find_elf(1ONBLD),
239 .BR interface_check(1ONBLD),
240 .BR ld(1),
241 .BR ldd(1),
242 .BR elfdump(1),
243 .BR pvs(1).
244 .LP
245 .TZ LLM
|