xref: /titanic_52/usr/src/common/elfcap/elfcap.c (revision 69112edd987c28fa551d4f8d9362a84a45365f17)
17c478bd9Sstevel@tonic-gate /*
27c478bd9Sstevel@tonic-gate  * CDDL HEADER START
37c478bd9Sstevel@tonic-gate  *
47c478bd9Sstevel@tonic-gate  * The contents of this file are subject to the terms of the
51820c2cdShyw  * Common Development and Distribution License (the "License").
61820c2cdShyw  * You may not use this file except in compliance with the License.
77c478bd9Sstevel@tonic-gate  *
87c478bd9Sstevel@tonic-gate  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
97c478bd9Sstevel@tonic-gate  * or http://www.opensolaris.org/os/licensing.
107c478bd9Sstevel@tonic-gate  * See the License for the specific language governing permissions
117c478bd9Sstevel@tonic-gate  * and limitations under the License.
127c478bd9Sstevel@tonic-gate  *
137c478bd9Sstevel@tonic-gate  * When distributing Covered Code, include this CDDL HEADER in each
147c478bd9Sstevel@tonic-gate  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
157c478bd9Sstevel@tonic-gate  * If applicable, add the following below this CDDL HEADER, with the
167c478bd9Sstevel@tonic-gate  * fields enclosed by brackets "[]" replaced with your own identifying
177c478bd9Sstevel@tonic-gate  * information: Portions Copyright [yyyy] [name of copyright owner]
187c478bd9Sstevel@tonic-gate  *
197c478bd9Sstevel@tonic-gate  * CDDL HEADER END
207c478bd9Sstevel@tonic-gate  */
21ae115bc7Smrj 
227c478bd9Sstevel@tonic-gate /*
23*69112eddSAli Bahrami  * Copyright 2010 Sun Microsystems, Inc.  All rights reserved.
247c478bd9Sstevel@tonic-gate  * Use is subject to license terms.
257c478bd9Sstevel@tonic-gate  */
26ae115bc7Smrj 
277c478bd9Sstevel@tonic-gate /* LINTLIBRARY */
287c478bd9Sstevel@tonic-gate 
297c478bd9Sstevel@tonic-gate /*
307c478bd9Sstevel@tonic-gate  * String conversion routine for hardware capabilities types.
317c478bd9Sstevel@tonic-gate  */
327c478bd9Sstevel@tonic-gate #include	<strings.h>
337c478bd9Sstevel@tonic-gate #include	<stdio.h>
347c478bd9Sstevel@tonic-gate #include	<ctype.h>
357c478bd9Sstevel@tonic-gate #include	<sys/machelf.h>
367c478bd9Sstevel@tonic-gate #include	<sys/elf.h>
377c478bd9Sstevel@tonic-gate #include	<sys/auxv_SPARC.h>
387c478bd9Sstevel@tonic-gate #include	<sys/auxv_386.h>
397c478bd9Sstevel@tonic-gate #include	<elfcap.h>
407c478bd9Sstevel@tonic-gate 
417c478bd9Sstevel@tonic-gate /*
4299f63845Sab196087  * Given a literal string, generate an initialization for an
4399f63845Sab196087  * elfcap_str_t value.
447c478bd9Sstevel@tonic-gate  */
4599f63845Sab196087 #define	STRDESC(_str) { _str, sizeof (_str) - 1 }
467c478bd9Sstevel@tonic-gate 
477c478bd9Sstevel@tonic-gate /*
4899f63845Sab196087  * The items in the elfcap_desc_t arrays are required to be
4999f63845Sab196087  * ordered so that the array index is related to the
5099f63845Sab196087  * c_val field as:
517c478bd9Sstevel@tonic-gate  *
5299f63845Sab196087  *	array[ndx].c_val = 2^ndx
5399f63845Sab196087  *
5499f63845Sab196087  * meaning that
5599f63845Sab196087  *
5699f63845Sab196087  *	array[0].c_val = 2^0 = 1
5799f63845Sab196087  *	array[1].c_val = 2^1 = 2
5899f63845Sab196087  *	array[2].c_val = 2^2 = 4
5999f63845Sab196087  *	.
6099f63845Sab196087  *	.
6199f63845Sab196087  *	.
6299f63845Sab196087  *
6399f63845Sab196087  * Since 0 is not a valid value for the c_val field, we use it to
6499f63845Sab196087  * mark an array entry that is a placeholder. This can happen if there
6599f63845Sab196087  * is a hole in the assigned bits.
6699f63845Sab196087  *
6799f63845Sab196087  * The RESERVED_ELFCAP_DESC macro is used to reserve such holes.
687c478bd9Sstevel@tonic-gate  */
6999f63845Sab196087 #define	RESERVED_ELFCAP_DESC { 0, { NULL, 0 }, { NULL, 0 }, { NULL, 0 } }
707c478bd9Sstevel@tonic-gate 
717c478bd9Sstevel@tonic-gate /*
7299f63845Sab196087  * Define separators for output string processing. This must be kept in
7399f63845Sab196087  * sync with the elfcap_fmt_t values in elfcap.h.
7499f63845Sab196087  */
7599f63845Sab196087 static const elfcap_str_t format[] = {
7699f63845Sab196087 	STRDESC(" "),			/* ELFCAP_FMT_SNGSPACE */
7799f63845Sab196087 	STRDESC("  "),			/* ELFCAP_FMT_DBLSPACE */
7899f63845Sab196087 	STRDESC(" | ")			/* ELFCAP_FMT_PIPSPACE */
7999f63845Sab196087 };
8099f63845Sab196087 #define	FORMAT_NELTS	(sizeof (format) / sizeof (format[0]))
8199f63845Sab196087 
8299f63845Sab196087 
8399f63845Sab196087 
8499f63845Sab196087 /*
8599f63845Sab196087  * Define all known software capabilities in all the supported styles.
8699f63845Sab196087  * Order the capabilities by their numeric value. See SF1_SUNW_
877c478bd9Sstevel@tonic-gate  * values in sys/elf.h.
887c478bd9Sstevel@tonic-gate  */
8999f63845Sab196087 static const elfcap_desc_t sf1[ELFCAP_NUM_SF1] = {
9099f63845Sab196087 	{						/* 0x00000001 */
9199f63845Sab196087 		SF1_SUNW_FPKNWN, STRDESC("SF1_SUNW_FPKNWN"),
9299f63845Sab196087 		STRDESC("FPKNWN"), STRDESC("fpknwn")
9399f63845Sab196087 	},
9499f63845Sab196087 	{						/* 0x00000002 */
9599f63845Sab196087 		SF1_SUNW_FPUSED, STRDESC("SF1_SUNW_FPUSED"),
9699f63845Sab196087 		STRDESC("FPUSED"), STRDESC("fpused"),
97bebb829dSRod Evans 	},
98bebb829dSRod Evans 	{						/* 0x00000004 */
99bebb829dSRod Evans 		SF1_SUNW_ADDR32, STRDESC("SF1_SUNW_ADDR32"),
100bebb829dSRod Evans 		STRDESC("ADDR32"), STRDESC("addr32"),
10199f63845Sab196087 	}
1027c478bd9Sstevel@tonic-gate };
1037c478bd9Sstevel@tonic-gate 
1041820c2cdShyw 
1057c478bd9Sstevel@tonic-gate 
1067c478bd9Sstevel@tonic-gate /*
1077c478bd9Sstevel@tonic-gate  * Order the SPARC hardware capabilities to match their numeric value.  See
1087c478bd9Sstevel@tonic-gate  * AV_SPARC_ values in sys/auxv_SPARC.h.
1097c478bd9Sstevel@tonic-gate  */
11099f63845Sab196087 static const elfcap_desc_t hw1_sparc[ELFCAP_NUM_HW1_SPARC] = {
11199f63845Sab196087 	{						/* 0x00000001 */
11299f63845Sab196087 		AV_SPARC_MUL32, STRDESC("AV_SPARC_MUL32"),
11399f63845Sab196087 		STRDESC("MUL32"), STRDESC("mul32"),
11499f63845Sab196087 	},
11599f63845Sab196087 	{						/* 0x00000002 */
11699f63845Sab196087 		AV_SPARC_DIV32, STRDESC("AV_SPARC_DIV32"),
11799f63845Sab196087 		STRDESC("DIV32"), STRDESC("div32"),
11899f63845Sab196087 	},
11999f63845Sab196087 	{						/* 0x00000004 */
12099f63845Sab196087 		AV_SPARC_FSMULD, STRDESC("AV_SPARC_FSMULD"),
12199f63845Sab196087 		STRDESC("FSMULD"), STRDESC("fsmuld"),
12299f63845Sab196087 	},
12399f63845Sab196087 	{						/* 0x00000008 */
12499f63845Sab196087 		AV_SPARC_V8PLUS, STRDESC("AV_SPARC_V8PLUS"),
12599f63845Sab196087 		STRDESC("V8PLUS"), STRDESC("v8plus"),
12699f63845Sab196087 	},
12799f63845Sab196087 	{						/* 0x00000010 */
12899f63845Sab196087 		AV_SPARC_POPC, STRDESC("AV_SPARC_POPC"),
12999f63845Sab196087 		STRDESC("POPC"), STRDESC("popc"),
13099f63845Sab196087 	},
13199f63845Sab196087 	{						/* 0x00000020 */
13299f63845Sab196087 		AV_SPARC_VIS, STRDESC("AV_SPARC_VIS"),
13399f63845Sab196087 		STRDESC("VIS"), STRDESC("vis"),
13499f63845Sab196087 	},
13599f63845Sab196087 	{						/* 0x00000040 */
13699f63845Sab196087 		AV_SPARC_VIS2, STRDESC("AV_SPARC_VIS2"),
13799f63845Sab196087 		STRDESC("VIS2"), STRDESC("vis2"),
13899f63845Sab196087 	},
13999f63845Sab196087 	{						/* 0x00000080 */
14099f63845Sab196087 		AV_SPARC_ASI_BLK_INIT, STRDESC("AV_SPARC_ASI_BLK_INIT"),
14199f63845Sab196087 		STRDESC("ASI_BLK_INIT"), STRDESC("asi_blk_init"),
14299f63845Sab196087 	},
14399f63845Sab196087 	{						/* 0x00000100 */
14499f63845Sab196087 		AV_SPARC_FMAF, STRDESC("AV_SPARC_FMAF"),
14599f63845Sab196087 		STRDESC("FMAF"), STRDESC("fmaf"),
14699f63845Sab196087 	},
1479d0d62adSJason Beloro 	RESERVED_ELFCAP_DESC,				/* 0x00000200 */
1482f0fcb93SJason Beloro 	{						/* 0x00000400 */
1492f0fcb93SJason Beloro 		AV_SPARC_VIS3, STRDESC("AV_SPARC_VIS3"),
1502f0fcb93SJason Beloro 		STRDESC("VIS3"), STRDESC("vis3"),
1512f0fcb93SJason Beloro 	},
1522f0fcb93SJason Beloro 	{						/* 0x00000800 */
1532f0fcb93SJason Beloro 		AV_SPARC_HPC, STRDESC("AV_SPARC_HPC"),
1542f0fcb93SJason Beloro 		STRDESC("HPC"), STRDESC("hpc"),
1552f0fcb93SJason Beloro 	},
1562f0fcb93SJason Beloro 	{						/* 0x00001000 */
1572f0fcb93SJason Beloro 		AV_SPARC_RANDOM, STRDESC("AV_SPARC_RANDOM"),
1582f0fcb93SJason Beloro 		STRDESC("RANDOM"), STRDESC("random"),
1592f0fcb93SJason Beloro 	},
1602f0fcb93SJason Beloro 	{						/* 0x00002000 */
1612f0fcb93SJason Beloro 		AV_SPARC_TRANS, STRDESC("AV_SPARC_TRANS"),
1622f0fcb93SJason Beloro 		STRDESC("TRANS"), STRDESC("trans"),
1632f0fcb93SJason Beloro 	},
16499f63845Sab196087 	{						/* 0x00004000 */
16599f63845Sab196087 		AV_SPARC_FJFMAU, STRDESC("AV_SPARC_FJFMAU"),
16699f63845Sab196087 		STRDESC("FJFMAU"), STRDESC("fjfmau"),
16799f63845Sab196087 	},
16899f63845Sab196087 	{						/* 0x00008000 */
16999f63845Sab196087 		AV_SPARC_IMA, STRDESC("AV_SPARC_IMA"),
17099f63845Sab196087 		STRDESC("IMA"), STRDESC("ima"),
171b1593d50SJason Beloro 	},
172b1593d50SJason Beloro 	{						/* 0x00010000 */
173b1593d50SJason Beloro 		AV_SPARC_ASI_CACHE_SPARING,
174b1593d50SJason Beloro 		STRDESC("AV_SPARC_ASI_CACHE_SPARING"),
175b1593d50SJason Beloro 		STRDESC("CSPARE"), STRDESC("cspare"),
17699f63845Sab196087 	}
1777c478bd9Sstevel@tonic-gate };
1787c478bd9Sstevel@tonic-gate 
17999f63845Sab196087 
1807c478bd9Sstevel@tonic-gate 
1817c478bd9Sstevel@tonic-gate /*
1827c478bd9Sstevel@tonic-gate  * Order the Intel hardware capabilities to match their numeric value.  See
1837c478bd9Sstevel@tonic-gate  * AV_386_ values in sys/auxv_386.h.
1847c478bd9Sstevel@tonic-gate  */
18599f63845Sab196087 static const elfcap_desc_t hw1_386[ELFCAP_NUM_HW1_386] = {
18699f63845Sab196087 	{						/* 0x00000001 */
18799f63845Sab196087 		AV_386_FPU, STRDESC("AV_386_FPU"),
18899f63845Sab196087 		STRDESC("FPU"), STRDESC("fpu"),
18999f63845Sab196087 	},
19099f63845Sab196087 	{						/* 0x00000002 */
19199f63845Sab196087 		AV_386_TSC, STRDESC("AV_386_TSC"),
19299f63845Sab196087 		STRDESC("TSC"), STRDESC("tsc"),
19399f63845Sab196087 	},
19499f63845Sab196087 	{						/* 0x00000004 */
19599f63845Sab196087 		AV_386_CX8, STRDESC("AV_386_CX8"),
19699f63845Sab196087 		STRDESC("CX8"), STRDESC("cx8"),
19799f63845Sab196087 	},
19899f63845Sab196087 	{						/* 0x00000008 */
19999f63845Sab196087 		AV_386_SEP, STRDESC("AV_386_SEP"),
20099f63845Sab196087 		STRDESC("SEP"), STRDESC("sep"),
20199f63845Sab196087 	},
20299f63845Sab196087 	{						/* 0x00000010 */
20399f63845Sab196087 		AV_386_AMD_SYSC, STRDESC("AV_386_AMD_SYSC"),
20499f63845Sab196087 		STRDESC("AMD_SYSC"), STRDESC("amd_sysc"),
20599f63845Sab196087 	},
20699f63845Sab196087 	{						/* 0x00000020 */
20799f63845Sab196087 		AV_386_CMOV, STRDESC("AV_386_CMOV"),
20899f63845Sab196087 		STRDESC("CMOV"), STRDESC("cmov"),
20999f63845Sab196087 	},
21099f63845Sab196087 	{						/* 0x00000040 */
21199f63845Sab196087 		AV_386_MMX, STRDESC("AV_386_MMX"),
21299f63845Sab196087 		STRDESC("MMX"), STRDESC("mmx"),
21399f63845Sab196087 	},
21499f63845Sab196087 	{						/* 0x00000080 */
21599f63845Sab196087 		AV_386_AMD_MMX, STRDESC("AV_386_AMD_MMX"),
21699f63845Sab196087 		STRDESC("AMD_MMX"), STRDESC("amd_mmx"),
21799f63845Sab196087 	},
21899f63845Sab196087 	{						/* 0x00000100 */
21999f63845Sab196087 		AV_386_AMD_3DNow, STRDESC("AV_386_AMD_3DNow"),
22099f63845Sab196087 		STRDESC("AMD_3DNow"), STRDESC("amd_3dnow"),
22199f63845Sab196087 	},
22299f63845Sab196087 	{						/* 0x00000200 */
22399f63845Sab196087 		AV_386_AMD_3DNowx, STRDESC("AV_386_AMD_3DNowx"),
22499f63845Sab196087 		STRDESC("AMD_3DNowx"), STRDESC("amd_3dnowx"),
22599f63845Sab196087 	},
22699f63845Sab196087 	{						/* 0x00000400 */
22799f63845Sab196087 		AV_386_FXSR, STRDESC("AV_386_FXSR"),
22899f63845Sab196087 		STRDESC("FXSR"), STRDESC("fxsr"),
22999f63845Sab196087 	},
23099f63845Sab196087 	{						/* 0x00000800 */
23199f63845Sab196087 		AV_386_SSE, STRDESC("AV_386_SSE"),
23299f63845Sab196087 		STRDESC("SSE"), STRDESC("sse"),
23399f63845Sab196087 	},
23499f63845Sab196087 	{						/* 0x00001000 */
23599f63845Sab196087 		AV_386_SSE2, STRDESC("AV_386_SSE2"),
23699f63845Sab196087 		STRDESC("SSE2"), STRDESC("sse2"),
23799f63845Sab196087 	},
23899f63845Sab196087 	{						/* 0x00002000 */
23999f63845Sab196087 		AV_386_PAUSE, STRDESC("AV_386_PAUSE"),
24099f63845Sab196087 		STRDESC("PAUSE"), STRDESC("pause"),
24199f63845Sab196087 	},
24299f63845Sab196087 	{						/* 0x00004000 */
24399f63845Sab196087 		AV_386_SSE3, STRDESC("AV_386_SSE3"),
24499f63845Sab196087 		STRDESC("SSE3"), STRDESC("sse3"),
24599f63845Sab196087 	},
24699f63845Sab196087 	{						/* 0x00008000 */
24799f63845Sab196087 		AV_386_MON, STRDESC("AV_386_MON"),
24899f63845Sab196087 		STRDESC("MON"), STRDESC("mon"),
24999f63845Sab196087 	},
25099f63845Sab196087 	{						/* 0x00010000 */
25199f63845Sab196087 		AV_386_CX16, STRDESC("AV_386_CX16"),
25299f63845Sab196087 		STRDESC("CX16"), STRDESC("cx16"),
25399f63845Sab196087 	},
25499f63845Sab196087 	{						/* 0x00020000 */
25599f63845Sab196087 		AV_386_AHF, STRDESC("AV_386_AHF"),
25699f63845Sab196087 		STRDESC("AHF"), STRDESC("ahf"),
25799f63845Sab196087 	},
25899f63845Sab196087 	{						/* 0x00040000 */
25999f63845Sab196087 		AV_386_TSCP, STRDESC("AV_386_TSCP"),
26099f63845Sab196087 		STRDESC("TSCP"), STRDESC("tscp"),
26199f63845Sab196087 	},
26299f63845Sab196087 	{						/* 0x00080000 */
26399f63845Sab196087 		AV_386_AMD_SSE4A, STRDESC("AV_386_AMD_SSE4A"),
26499f63845Sab196087 		STRDESC("AMD_SSE4A"), STRDESC("amd_sse4a"),
26599f63845Sab196087 	},
26699f63845Sab196087 	{						/* 0x00100000 */
26799f63845Sab196087 		AV_386_POPCNT, STRDESC("AV_386_POPCNT"),
26899f63845Sab196087 		STRDESC("POPCNT"), STRDESC("popcnt"),
26999f63845Sab196087 	},
27099f63845Sab196087 	{						/* 0x00200000 */
27199f63845Sab196087 		AV_386_AMD_LZCNT, STRDESC("AV_386_AMD_LZCNT"),
27299f63845Sab196087 		STRDESC("AMD_LZCNT"), STRDESC("amd_lzcnt"),
27399f63845Sab196087 	},
27499f63845Sab196087 	{						/* 0x00400000 */
27599f63845Sab196087 		AV_386_SSSE3, STRDESC("AV_386_SSSE3"),
27699f63845Sab196087 		STRDESC("SSSE3"), STRDESC("ssse3"),
27799f63845Sab196087 	},
27899f63845Sab196087 	{						/* 0x00800000 */
27999f63845Sab196087 		AV_386_SSE4_1, STRDESC("AV_386_SSE4_1"),
28099f63845Sab196087 		STRDESC("SSE4.1"), STRDESC("sse4.1"),
28199f63845Sab196087 	},
28299f63845Sab196087 	{						/* 0x01000000 */
28399f63845Sab196087 		AV_386_SSE4_2, STRDESC("AV_386_SSE4_2"),
28499f63845Sab196087 		STRDESC("SSE4.2"), STRDESC("sse4.2"),
2855087e485SKrishnendu Sadhukhan - Sun Microsystems 	},
2865087e485SKrishnendu Sadhukhan - Sun Microsystems 	{						/* 0x02000000 */
2875087e485SKrishnendu Sadhukhan - Sun Microsystems 		AV_386_MOVBE, STRDESC("AV_386_MOVBE"),
2885087e485SKrishnendu Sadhukhan - Sun Microsystems 		STRDESC("MOVBE"), STRDESC("movbe"),
289a50a8b93SKuriakose Kuruvilla 	},
290a50a8b93SKuriakose Kuruvilla 	{						/* 0x04000000 */
291a50a8b93SKuriakose Kuruvilla 		AV_386_AES, STRDESC("AV_386_AES"),
292a50a8b93SKuriakose Kuruvilla 		STRDESC("AES"), STRDESC("aes"),
293a50a8b93SKuriakose Kuruvilla 	},
294a50a8b93SKuriakose Kuruvilla 	{						/* 0x08000000 */
295a50a8b93SKuriakose Kuruvilla 		AV_386_PCLMULQDQ, STRDESC("AV_386_PCLMULQDQ"),
296a50a8b93SKuriakose Kuruvilla 		STRDESC("PCLMULQDQ"), STRDESC("pclmulqdq"),
29799f63845Sab196087 	}
2987c478bd9Sstevel@tonic-gate };
2997c478bd9Sstevel@tonic-gate 
3007c478bd9Sstevel@tonic-gate /*
301ae115bc7Smrj  * Concatenate a token to the string buffer.  This can be a capabilities token
3027c478bd9Sstevel@tonic-gate  * or a separator token.
3037c478bd9Sstevel@tonic-gate  */
30499f63845Sab196087 static elfcap_err_t
30599f63845Sab196087 token(char **ostr, size_t *olen, const elfcap_str_t *nstr)
3067c478bd9Sstevel@tonic-gate {
30799f63845Sab196087 	if (*olen < nstr->s_len)
30899f63845Sab196087 		return (ELFCAP_ERR_BUFOVFL);
3097c478bd9Sstevel@tonic-gate 
31099f63845Sab196087 	(void) strcat(*ostr, nstr->s_str);
31199f63845Sab196087 	*ostr += nstr->s_len;
31299f63845Sab196087 	*olen -= nstr->s_len;
3137c478bd9Sstevel@tonic-gate 
31499f63845Sab196087 	return (ELFCAP_ERR_NONE);
3157c478bd9Sstevel@tonic-gate }
3167c478bd9Sstevel@tonic-gate 
31799f63845Sab196087 static elfcap_err_t
31899f63845Sab196087 get_str_desc(elfcap_style_t style, const elfcap_desc_t *cdp,
31999f63845Sab196087     const elfcap_str_t **ret_str)
32099f63845Sab196087 {
321*69112eddSAli Bahrami 	switch (ELFCAP_STYLE_MASK(style)) {
32299f63845Sab196087 	case ELFCAP_STYLE_FULL:
32399f63845Sab196087 		*ret_str = &cdp->c_full;
32499f63845Sab196087 		break;
32599f63845Sab196087 	case ELFCAP_STYLE_UC:
32699f63845Sab196087 		*ret_str = &cdp->c_uc;
32799f63845Sab196087 		break;
32899f63845Sab196087 	case ELFCAP_STYLE_LC:
32999f63845Sab196087 		*ret_str = &cdp->c_lc;
33099f63845Sab196087 		break;
33199f63845Sab196087 	default:
33299f63845Sab196087 		return (ELFCAP_ERR_INVSTYLE);
33399f63845Sab196087 	}
33499f63845Sab196087 
33599f63845Sab196087 	return (ELFCAP_ERR_NONE);
33699f63845Sab196087 }
33799f63845Sab196087 
33899f63845Sab196087 
3397c478bd9Sstevel@tonic-gate /*
3407c478bd9Sstevel@tonic-gate  * Expand a capabilities value into the strings defined in the associated
3417c478bd9Sstevel@tonic-gate  * capabilities descriptor.
3427c478bd9Sstevel@tonic-gate  */
34399f63845Sab196087 static elfcap_err_t
344*69112eddSAli Bahrami expand(elfcap_style_t style, elfcap_mask_t val, const elfcap_desc_t *cdp,
34599f63845Sab196087     uint_t cnum, char *str, size_t slen, elfcap_fmt_t fmt)
3467c478bd9Sstevel@tonic-gate {
34799f63845Sab196087 	uint_t			cnt;
3487c478bd9Sstevel@tonic-gate 	int			follow = 0, err;
34999f63845Sab196087 	const elfcap_str_t	*nstr;
3507c478bd9Sstevel@tonic-gate 
3517c478bd9Sstevel@tonic-gate 	if (val == 0)
35299f63845Sab196087 		return (ELFCAP_ERR_NONE);
3537c478bd9Sstevel@tonic-gate 
35499f63845Sab196087 	for (cnt = cnum; cnt > 0; cnt--) {
35599f63845Sab196087 		uint_t mask = cdp[cnt - 1].c_val;
35699f63845Sab196087 
35799f63845Sab196087 		if ((val & mask) != 0) {
3587c478bd9Sstevel@tonic-gate 			if (follow++ && ((err = token(&str, &slen,
35999f63845Sab196087 			    &format[fmt])) != ELFCAP_ERR_NONE))
3607c478bd9Sstevel@tonic-gate 				return (err);
3617c478bd9Sstevel@tonic-gate 
36299f63845Sab196087 			err = get_str_desc(style, &cdp[cnt - 1], &nstr);
36399f63845Sab196087 			if (err != ELFCAP_ERR_NONE)
36499f63845Sab196087 				return (err);
36599f63845Sab196087 			if ((err = token(&str, &slen, nstr)) != ELFCAP_ERR_NONE)
3667c478bd9Sstevel@tonic-gate 				return (err);
3677c478bd9Sstevel@tonic-gate 
3687c478bd9Sstevel@tonic-gate 			val = val & ~mask;
3697c478bd9Sstevel@tonic-gate 		}
3707c478bd9Sstevel@tonic-gate 	}
3717c478bd9Sstevel@tonic-gate 
3727c478bd9Sstevel@tonic-gate 	/*
3737c478bd9Sstevel@tonic-gate 	 * If there are any unknown bits remaining display the numeric value.
3747c478bd9Sstevel@tonic-gate 	 */
3757c478bd9Sstevel@tonic-gate 	if (val) {
37699f63845Sab196087 		if (follow && ((err = token(&str, &slen, &format[fmt])) !=
37799f63845Sab196087 		    ELFCAP_ERR_NONE))
3787c478bd9Sstevel@tonic-gate 			return (err);
3797c478bd9Sstevel@tonic-gate 
380*69112eddSAli Bahrami 		(void) snprintf(str, slen, "0x%x", val);
3817c478bd9Sstevel@tonic-gate 	}
38299f63845Sab196087 	return (ELFCAP_ERR_NONE);
3837c478bd9Sstevel@tonic-gate }
3847c478bd9Sstevel@tonic-gate 
3857c478bd9Sstevel@tonic-gate /*
3867c478bd9Sstevel@tonic-gate  * Expand a CA_SUNW_HW_1 value.
3877c478bd9Sstevel@tonic-gate  */
38899f63845Sab196087 elfcap_err_t
389*69112eddSAli Bahrami elfcap_hw1_to_str(elfcap_style_t style, elfcap_mask_t val, char *str,
39099f63845Sab196087     size_t len, elfcap_fmt_t fmt, ushort_t mach)
3917c478bd9Sstevel@tonic-gate {
3927c478bd9Sstevel@tonic-gate 	/*
3937c478bd9Sstevel@tonic-gate 	 * Initialize the string buffer, and validate the format request.
3947c478bd9Sstevel@tonic-gate 	 */
3957c478bd9Sstevel@tonic-gate 	*str = '\0';
39699f63845Sab196087 	if ((fmt < 0) || (fmt >= FORMAT_NELTS))
39799f63845Sab196087 		return (ELFCAP_ERR_INVFMT);
3987c478bd9Sstevel@tonic-gate 
3997c478bd9Sstevel@tonic-gate 	if ((mach == EM_386) || (mach == EM_IA_64) || (mach == EM_AMD64))
40099f63845Sab196087 		return (expand(style, val, &hw1_386[0], ELFCAP_NUM_HW1_386,
40199f63845Sab196087 		    str, len, fmt));
4027c478bd9Sstevel@tonic-gate 
4037c478bd9Sstevel@tonic-gate 	if ((mach == EM_SPARC) || (mach == EM_SPARC32PLUS) ||
4047c478bd9Sstevel@tonic-gate 	    (mach == EM_SPARCV9))
40599f63845Sab196087 		return (expand(style, val, hw1_sparc, ELFCAP_NUM_HW1_SPARC,
40699f63845Sab196087 		    str, len, fmt));
4077c478bd9Sstevel@tonic-gate 
40899f63845Sab196087 	return (ELFCAP_ERR_UNKMACH);
4097c478bd9Sstevel@tonic-gate }
4107c478bd9Sstevel@tonic-gate 
4117c478bd9Sstevel@tonic-gate /*
412*69112eddSAli Bahrami  * Expand a CA_SUNW_HW_2 value.  Presently, there are no values, this routine
413*69112eddSAli Bahrami  * is simply a place holder for future development.
414*69112eddSAli Bahrami  */
415*69112eddSAli Bahrami elfcap_err_t
416*69112eddSAli Bahrami /* ARGSUSED0 */
417*69112eddSAli Bahrami elfcap_hw2_to_str(elfcap_style_t style, elfcap_mask_t val, char *str,
418*69112eddSAli Bahrami     size_t len, elfcap_fmt_t fmt, ushort_t mach)
419*69112eddSAli Bahrami {
420*69112eddSAli Bahrami 	/*
421*69112eddSAli Bahrami 	 * Initialize the string buffer, and validate the format request.
422*69112eddSAli Bahrami 	 */
423*69112eddSAli Bahrami 	*str = '\0';
424*69112eddSAli Bahrami 	if ((fmt < 0) || (fmt >= FORMAT_NELTS))
425*69112eddSAli Bahrami 		return (ELFCAP_ERR_INVFMT);
426*69112eddSAli Bahrami 
427*69112eddSAli Bahrami 	return (expand(style, val, NULL, 0, str, len, fmt));
428*69112eddSAli Bahrami }
429*69112eddSAli Bahrami 
430*69112eddSAli Bahrami /*
4317c478bd9Sstevel@tonic-gate  * Expand a CA_SUNW_SF_1 value.  Note, that at present these capabilities are
4327c478bd9Sstevel@tonic-gate  * common across all platforms.  The use of "mach" is therefore redundant, but
43399f63845Sab196087  * is retained for compatibility with the interface of elfcap_hw1_to_str(), and
4347c478bd9Sstevel@tonic-gate  * possible future expansion.
4357c478bd9Sstevel@tonic-gate  */
43699f63845Sab196087 elfcap_err_t
4377c478bd9Sstevel@tonic-gate /* ARGSUSED4 */
438*69112eddSAli Bahrami elfcap_sf1_to_str(elfcap_style_t style, elfcap_mask_t val, char *str,
43999f63845Sab196087     size_t len, elfcap_fmt_t fmt, ushort_t mach)
4407c478bd9Sstevel@tonic-gate {
4417c478bd9Sstevel@tonic-gate 	/*
4427c478bd9Sstevel@tonic-gate 	 * Initialize the string buffer, and validate the format request.
4437c478bd9Sstevel@tonic-gate 	 */
4447c478bd9Sstevel@tonic-gate 	*str = '\0';
44599f63845Sab196087 	if ((fmt < 0) || (fmt >= FORMAT_NELTS))
44699f63845Sab196087 		return (ELFCAP_ERR_INVFMT);
4477c478bd9Sstevel@tonic-gate 
44899f63845Sab196087 	return (expand(style, val, &sf1[0], ELFCAP_NUM_SF1, str, len, fmt));
4497c478bd9Sstevel@tonic-gate }
4507c478bd9Sstevel@tonic-gate 
4517c478bd9Sstevel@tonic-gate /*
45299f63845Sab196087  * Given a capability tag type and value, map it to a string representation.
4537c478bd9Sstevel@tonic-gate  */
45499f63845Sab196087 elfcap_err_t
455*69112eddSAli Bahrami elfcap_tag_to_str(elfcap_style_t style, uint64_t tag, elfcap_mask_t val,
45699f63845Sab196087     char *str, size_t len, elfcap_fmt_t fmt, ushort_t mach)
4577c478bd9Sstevel@tonic-gate {
458*69112eddSAli Bahrami 	switch (tag) {
459*69112eddSAli Bahrami 	case CA_SUNW_HW_1:
46099f63845Sab196087 		return (elfcap_hw1_to_str(style, val, str, len, fmt, mach));
461*69112eddSAli Bahrami 
462*69112eddSAli Bahrami 	case CA_SUNW_SF_1:
46399f63845Sab196087 		return (elfcap_sf1_to_str(style, val, str, len, fmt, mach));
4647c478bd9Sstevel@tonic-gate 
465*69112eddSAli Bahrami 	case CA_SUNW_HW_2:
466*69112eddSAli Bahrami 		return (elfcap_hw2_to_str(style, val, str, len, fmt, mach));
467*69112eddSAli Bahrami 
468*69112eddSAli Bahrami 	}
469*69112eddSAli Bahrami 
47099f63845Sab196087 	return (ELFCAP_ERR_UNKTAG);
4717c478bd9Sstevel@tonic-gate }
4727c478bd9Sstevel@tonic-gate 
4737c478bd9Sstevel@tonic-gate /*
4747c478bd9Sstevel@tonic-gate  * Determine a capabilities value from a capabilities string.
4757c478bd9Sstevel@tonic-gate  */
476*69112eddSAli Bahrami static elfcap_mask_t
47799f63845Sab196087 value(elfcap_style_t style, const char *str, const elfcap_desc_t *cdp,
47899f63845Sab196087     uint_t cnum)
4797c478bd9Sstevel@tonic-gate {
48099f63845Sab196087 	const elfcap_str_t	*nstr;
4817c478bd9Sstevel@tonic-gate 	uint_t	num;
48299f63845Sab196087 	int	err;
4837c478bd9Sstevel@tonic-gate 
4847c478bd9Sstevel@tonic-gate 	for (num = 0; num < cnum; num++) {
48599f63845Sab196087 		/*
48699f63845Sab196087 		 * Skip "reserved" bits. These are unassigned bits in the
48799f63845Sab196087 		 * middle of the assigned range.
48899f63845Sab196087 		 */
48999f63845Sab196087 		if (cdp[num].c_val == 0)
49099f63845Sab196087 			continue;
49199f63845Sab196087 
49299f63845Sab196087 		if ((err = get_str_desc(style, &cdp[num], &nstr)) != 0)
49399f63845Sab196087 			return (err);
494*69112eddSAli Bahrami 		if (style & ELFCAP_STYLE_F_ICMP) {
495*69112eddSAli Bahrami 			if (strcasecmp(str, nstr->s_str) == 0)
496*69112eddSAli Bahrami 				return (cdp[num].c_val);
497*69112eddSAli Bahrami 		} else {
49899f63845Sab196087 			if (strcmp(str, nstr->s_str) == 0)
4997c478bd9Sstevel@tonic-gate 				return (cdp[num].c_val);
5007c478bd9Sstevel@tonic-gate 		}
501*69112eddSAli Bahrami 	}
502*69112eddSAli Bahrami 
5037c478bd9Sstevel@tonic-gate 	return (0);
5047c478bd9Sstevel@tonic-gate }
5057c478bd9Sstevel@tonic-gate 
506*69112eddSAli Bahrami elfcap_mask_t
50799f63845Sab196087 elfcap_sf1_from_str(elfcap_style_t style, const char *str, ushort_t mach)
5087c478bd9Sstevel@tonic-gate {
50999f63845Sab196087 	return (value(style, str, &sf1[0], ELFCAP_NUM_SF1));
5107c478bd9Sstevel@tonic-gate }
5117c478bd9Sstevel@tonic-gate 
512*69112eddSAli Bahrami elfcap_mask_t
51399f63845Sab196087 elfcap_hw1_from_str(elfcap_style_t style, const char *str, ushort_t mach)
5147c478bd9Sstevel@tonic-gate {
5157c478bd9Sstevel@tonic-gate 	if ((mach == EM_386) || (mach == EM_IA_64) || (mach == EM_AMD64))
51699f63845Sab196087 		return (value(style, str, &hw1_386[0], ELFCAP_NUM_HW1_386));
5177c478bd9Sstevel@tonic-gate 
5187c478bd9Sstevel@tonic-gate 	if ((mach == EM_SPARC) || (mach == EM_SPARC32PLUS) ||
5197c478bd9Sstevel@tonic-gate 	    (mach == EM_SPARCV9))
52099f63845Sab196087 		return (value(style, str, hw1_sparc, ELFCAP_NUM_HW1_SPARC));
5217c478bd9Sstevel@tonic-gate 
5227c478bd9Sstevel@tonic-gate 	return (0);
5237c478bd9Sstevel@tonic-gate }
524*69112eddSAli Bahrami elfcap_mask_t
525*69112eddSAli Bahrami /* ARGSUSED0 */
526*69112eddSAli Bahrami elfcap_hw2_from_str(elfcap_style_t style, const char *str, ushort_t mach)
527*69112eddSAli Bahrami {
528*69112eddSAli Bahrami 	return (0);
529*69112eddSAli Bahrami }
530*69112eddSAli Bahrami 
531*69112eddSAli Bahrami /*
532*69112eddSAli Bahrami  * Given a capability tag type and value, return the capabilities values
533*69112eddSAli Bahrami  * contained in the string.
534*69112eddSAli Bahrami  */
535*69112eddSAli Bahrami elfcap_mask_t
536*69112eddSAli Bahrami elfcap_tag_from_str(elfcap_style_t style, uint64_t tag, const char *str,
537*69112eddSAli Bahrami     ushort_t mach)
538*69112eddSAli Bahrami {
539*69112eddSAli Bahrami 	switch (tag) {
540*69112eddSAli Bahrami 	case CA_SUNW_HW_1:
541*69112eddSAli Bahrami 		return (elfcap_hw1_from_str(style, str, mach));
542*69112eddSAli Bahrami 
543*69112eddSAli Bahrami 	case CA_SUNW_SF_1:
544*69112eddSAli Bahrami 		return (elfcap_sf1_from_str(style, str, mach));
545*69112eddSAli Bahrami 
546*69112eddSAli Bahrami 	case CA_SUNW_HW_2:
547*69112eddSAli Bahrami 		return (elfcap_hw2_from_str(style, str, mach));
548*69112eddSAli Bahrami 	}
549*69112eddSAli Bahrami 
550*69112eddSAli Bahrami 	return (0);
551*69112eddSAli Bahrami }
55299f63845Sab196087 
55399f63845Sab196087 /*
55499f63845Sab196087  * These functions allow the caller to get direct access to the
55599f63845Sab196087  * cap descriptors.
55699f63845Sab196087  */
55799f63845Sab196087 const elfcap_desc_t *
55899f63845Sab196087 elfcap_getdesc_hw1_sparc(void)
55999f63845Sab196087 {
56099f63845Sab196087 	return (hw1_sparc);
56199f63845Sab196087 }
56299f63845Sab196087 
56399f63845Sab196087 const elfcap_desc_t *
56499f63845Sab196087 elfcap_getdesc_hw1_386(void)
56599f63845Sab196087 {
56699f63845Sab196087 	return (hw1_386);
56799f63845Sab196087 }
56899f63845Sab196087 
56999f63845Sab196087 const elfcap_desc_t *
57099f63845Sab196087 elfcap_getdesc_sf1(void)
57199f63845Sab196087 {
57299f63845Sab196087 	return (sf1);
57399f63845Sab196087 }
574