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 599f63845Sab * Common Development and Distribution License (the "License"). 699f63845Sab * 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 */ 21bebb829dSRod Evans 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 */ 267c478bd9Sstevel@tonic-gate 277c478bd9Sstevel@tonic-gate #ifndef _ELFCAP_DOT_H 287c478bd9Sstevel@tonic-gate #define _ELFCAP_DOT_H 297c478bd9Sstevel@tonic-gate 307c478bd9Sstevel@tonic-gate #include <sys/types.h> 317c478bd9Sstevel@tonic-gate 327c478bd9Sstevel@tonic-gate #ifdef __cplusplus 337c478bd9Sstevel@tonic-gate extern "C" { 347c478bd9Sstevel@tonic-gate #endif 357c478bd9Sstevel@tonic-gate 36*69112eddSAli Bahrami /* 37*69112eddSAli Bahrami * Type used to represent capability bitmasks. This 32-bit type cannot be 38*69112eddSAli Bahrami * widened without breaking the ability to use them in ELFCLASS32 objects. 39*69112eddSAli Bahrami */ 40*69112eddSAli Bahrami typedef uint32_t elfcap_mask_t; 41*69112eddSAli Bahrami 427c478bd9Sstevel@tonic-gate /* 4399f63845Sab * The elfcap code handles mappings to and from several string styles. 4499f63845Sab * The caller uses elfcap_style_t to specify the style to use. 45*69112eddSAli Bahrami * 46*69112eddSAli Bahrami * The bottom 16 bits are used to represent styles, and the upper 16 47*69112eddSAli Bahrami * bits are used for flags to modify default behavior. 4899f63845Sab */ 49*69112eddSAli Bahrami #define ELFCAP_STYLE_MASK(_style) (_style & 0xff) 50*69112eddSAli Bahrami 5199f63845Sab typedef enum { 5299f63845Sab ELFCAP_STYLE_FULL = 1, /* Full formal name (e.g. AV_386_SSE) */ 5399f63845Sab ELFCAP_STYLE_UC = 2, /* Informal upper case (e.g. SSE) */ 54*69112eddSAli Bahrami ELFCAP_STYLE_LC = 3, /* Informal lower case (e.g. sse) */ 55*69112eddSAli Bahrami 56*69112eddSAli Bahrami ELFCAP_STYLE_F_ICMP = 0x0100 /* Use case insensitive strcmp */ 5799f63845Sab } elfcap_style_t; 5899f63845Sab 5999f63845Sab /* 6099f63845Sab * String descriptor: Contains the string and strlen(string). elfcap can 6199f63845Sab * be used in contexts (ld.so.1) where we do not want to make calls to 6299f63845Sab * string processing functions, so the length is calculated at compile time. 637c478bd9Sstevel@tonic-gate */ 647c478bd9Sstevel@tonic-gate typedef struct { 6599f63845Sab const char *s_str; 6699f63845Sab size_t s_len; 6799f63845Sab } elfcap_str_t; 6899f63845Sab 6999f63845Sab /* 7099f63845Sab * Capabilities descriptor: This maps the integer bit value 7199f63845Sab * (c_val) to/from the various strings that represent it. 7299f63845Sab * 7399f63845Sab * c_val is normally expected to be a non-zero power of 2 7499f63845Sab * value (i.e. a single set bit). The value 0 is special, and 7599f63845Sab * used to represent a "reserved" placeholder in an array of 7699f63845Sab * capabilities. These reserved values have NULL string pointers, 7799f63845Sab * and are intended to be ignored by the processing code. 7899f63845Sab */ 7999f63845Sab typedef struct { 80*69112eddSAli Bahrami elfcap_mask_t c_val; /* Bit value */ 8199f63845Sab elfcap_str_t c_full; /* ELFCAP_STYLE_FULL */ 8299f63845Sab elfcap_str_t c_uc; /* ELFCAP_STYLE_UC */ 8399f63845Sab elfcap_str_t c_lc; /* ELFCAP_STYLE_LC */ 8499f63845Sab } elfcap_desc_t; 8599f63845Sab 8699f63845Sab /* 8799f63845Sab * Valid format values: The various formats in which a generated 8899f63845Sab * string representing bitmap values can be displayed. 8999f63845Sab * 9099f63845Sab * This must be kept in sync with the format[] array in elfcap.c. 9199f63845Sab */ 9299f63845Sab typedef enum { 9399f63845Sab ELFCAP_FMT_SNGSPACE = 0, 9499f63845Sab ELFCAP_FMT_DBLSPACE = 1, 9599f63845Sab ELFCAP_FMT_PIPSPACE = 2 9699f63845Sab } elfcap_fmt_t; 977c478bd9Sstevel@tonic-gate 987c478bd9Sstevel@tonic-gate /* 9999f63845Sab * Error codes: 1007c478bd9Sstevel@tonic-gate */ 10199f63845Sab typedef enum { 10299f63845Sab ELFCAP_ERR_NONE = 0, /* no error */ 10399f63845Sab ELFCAP_ERR_BUFOVFL = 1, /* buffer overfow */ 10499f63845Sab ELFCAP_ERR_INVFMT = 2, /* invalid format */ 10599f63845Sab ELFCAP_ERR_UNKTAG = 3, /* unknown capabilities tag */ 10699f63845Sab ELFCAP_ERR_UNKMACH = 4, /* unknown machine type */ 10799f63845Sab ELFCAP_ERR_INVSTYLE = 5 /* unknown style */ 10899f63845Sab } elfcap_err_t; 10999f63845Sab 1107c478bd9Sstevel@tonic-gate 1117c478bd9Sstevel@tonic-gate /* 11299f63845Sab * # of each type of capability known to the system. These values 1134a8d0ea7SAli Bahrami * must be kept in sync with the arrays found in elfcap.c. 1147c478bd9Sstevel@tonic-gate */ 115bebb829dSRod Evans #define ELFCAP_NUM_SF1 3 116b1593d50SJason Beloro #define ELFCAP_NUM_HW1_SPARC 17 117a50a8b93SKuriakose Kuruvilla #define ELFCAP_NUM_HW1_386 28 11899f63845Sab 1197c478bd9Sstevel@tonic-gate 12099f63845Sab /* 12199f63845Sab * Given a capability section tag and value, call the proper underlying 12299f63845Sab * "to str" function to generate the string description. 12399f63845Sab */ 12499f63845Sab extern elfcap_err_t elfcap_tag_to_str(elfcap_style_t, uint64_t, 125*69112eddSAli Bahrami elfcap_mask_t, char *, size_t, elfcap_fmt_t, ushort_t); 1267c478bd9Sstevel@tonic-gate 1277c478bd9Sstevel@tonic-gate /* 12899f63845Sab * The functions that convert from a specific capability value to 12999f63845Sab * a string representation all use the same common prototype. 1307c478bd9Sstevel@tonic-gate */ 131*69112eddSAli Bahrami typedef elfcap_err_t elfcap_to_str_func_t(elfcap_style_t, elfcap_mask_t, char *, 13299f63845Sab size_t, elfcap_fmt_t, ushort_t); 1337c478bd9Sstevel@tonic-gate 13499f63845Sab extern elfcap_to_str_func_t elfcap_hw1_to_str; 135*69112eddSAli Bahrami extern elfcap_to_str_func_t elfcap_hw2_to_str; 13699f63845Sab extern elfcap_to_str_func_t elfcap_sf1_to_str; 1377c478bd9Sstevel@tonic-gate 13899f63845Sab /* 13999f63845Sab * The reverse mapping: Given a string representation, turn it back into 14099f63845Sab * integer form. 14199f63845Sab */ 142*69112eddSAli Bahrami typedef elfcap_mask_t elfcap_from_str_func_t(elfcap_style_t, 14399f63845Sab const char *, ushort_t mach); 14499f63845Sab 145*69112eddSAli Bahrami /* 146*69112eddSAli Bahrami * Given a capability section tag and string, call the proper underlying 147*69112eddSAli Bahrami * "from str" function to generate the numeric value. 148*69112eddSAli Bahrami */ 149*69112eddSAli Bahrami extern elfcap_mask_t elfcap_tag_from_str(elfcap_style_t, uint64_t, 150*69112eddSAli Bahrami const char *, ushort_t); 151*69112eddSAli Bahrami 15299f63845Sab extern elfcap_from_str_func_t elfcap_hw1_from_str; 153*69112eddSAli Bahrami extern elfcap_from_str_func_t elfcap_hw2_from_str; 15499f63845Sab extern elfcap_from_str_func_t elfcap_sf1_from_str; 15599f63845Sab 15699f63845Sab /* 15799f63845Sab * These functions give access to the individual descriptor arrays. 15899f63845Sab * The caller is allowed to copy and use the string pointers contained 15999f63845Sab * in the descriptors, but must not alter them. Functions are used instead 16099f63845Sab * of making the arrays directly visible to preclude copy relocations in 16199f63845Sab * non-pic code. 16299f63845Sab */ 16399f63845Sab extern const elfcap_desc_t *elfcap_getdesc_hw1_sparc(void); 16499f63845Sab extern const elfcap_desc_t *elfcap_getdesc_hw1_386(void); 16599f63845Sab extern const elfcap_desc_t *elfcap_getdesc_sf1(void); 1667c478bd9Sstevel@tonic-gate 1677c478bd9Sstevel@tonic-gate #ifdef __cplusplus 1687c478bd9Sstevel@tonic-gate } 1697c478bd9Sstevel@tonic-gate #endif 1707c478bd9Sstevel@tonic-gate 1717c478bd9Sstevel@tonic-gate #endif /* _ELFCAP_DOT_H */ 172