version.c revision 9273:9a0603d78ad3 
1/*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21
22/*
23 * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
24 * Use is subject to license terms.
25 */
26
27/*
28 * String conversion routine for version flag entries.
29 */
30#include	<stdio.h>
31#include	"_conv.h"
32#include	"version_msg.h"
33
34#define	VERFLAGSZ	CONV_EXPN_FIELD_DEF_PREFIX_SIZE + \
35	MSG_VER_FLG_WEAK_SIZE		+ CONV_EXPN_FIELD_DEF_SEP_SIZE + \
36	MSG_VER_FLG_BASE_SIZE		+ CONV_EXPN_FIELD_DEF_SEP_SIZE + \
37	MSG_VER_FLG_INFO_SIZE		+ CONV_EXPN_FIELD_DEF_SEP_SIZE + \
38	CONV_INV_BUFSIZE + CONV_EXPN_FIELD_DEF_SUFFIX_SIZE
39
40/*
41 * Ensure that Conv_ver_flags_buf_t is large enough:
42 *
43 * VERFLAGSZ is the real minimum size of the buffer required by
44 * conv_ver_flags(). However, Conv_ver_flags_buf_t uses CONV_VER_FLAGS_BUFSIZE
45 * to set the buffer size. We do things this way because the definition of
46 * VERFLAGSZ uses information that is not available in the environment of
47 * other programs that include the conv.h header file.
48 */
49#if (CONV_VER_FLAGS_BUFSIZE != VERFLAGSZ) && !defined(__lint)
50#define	REPORT_BUFSIZE VERFLAGSZ
51#include "report_bufsize.h"
52#error "CONV_VER_FLAGS_BUFSIZE does not match VERFLAGSZ"
53#endif
54
55const char *
56conv_ver_flags(Half flags, Conv_fmt_flags_t fmt_flags,
57    Conv_ver_flags_buf_t *ver_flags_buf)
58{
59	static const Val_desc vda[] = {
60		{ VER_FLG_WEAK,		MSG_VER_FLG_WEAK },
61		{ VER_FLG_BASE,		MSG_VER_FLG_BASE },
62		{ VER_FLG_INFO,		MSG_VER_FLG_INFO },
63		{ 0,			0 }
64	};
65	static CONV_EXPN_FIELD_ARG conv_arg = {
66	    NULL, sizeof (ver_flags_buf->buf) };
67
68	if (flags == 0)
69		return (MSG_ORIG(MSG_GBL_NULL));
70
71	conv_arg.buf = ver_flags_buf->buf;
72	conv_arg.oflags = conv_arg.rflags = flags;
73	(void) conv_expn_field(&conv_arg, vda, fmt_flags);
74
75	return ((const char *)ver_flags_buf->buf);
76}
77
78
79/*
80 * Format a version index as contained in a VERSYM section
81 *
82 * entry:
83 *	verndx - Version index to format
84 *	gnuver - If True (non-zero), the version rules used by the
85 *		GNU ld are assumed. If False (0), Solaris ld rules apply.
86 */
87const char *
88conv_ver_index(Versym verndx, int gnuver, Conv_inv_buf_t *inv_buf)
89{
90	const char		*fmt;
91
92	/* Special case versions starting at VER_NDX_LORESERVE */
93	if (verndx == VER_NDX_ELIMINATE)
94		return (MSG_ORIG(MSG_VERSYM_ELIMINATE));
95
96	/*
97	 * The GNU style of versioning uses the top bit of the
98	 * 16-bit version index (0x8000) as a "hidden bit". A
99	 * hidden symbol is supposed to be ignored by the linker.
100	 */
101	if (gnuver && (verndx & 0x8000)) {
102		verndx &= ~0x8000;
103		fmt = MSG_ORIG(MSG_VERSYM_GNUH_FMT);
104	} else {
105		fmt = MSG_ORIG(MSG_VERSYM_FMT);
106	}
107
108	/* format as numeric */
109	(void) snprintf(inv_buf->buf, sizeof (inv_buf->buf),
110	    fmt, EC_HALF(verndx));
111	return (inv_buf->buf);
112}
113