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 */ 21*bebb829dSRod Evans 227c478bd9Sstevel@tonic-gate /* 23*bebb829dSRod Evans * Copyright 2008 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 367c478bd9Sstevel@tonic-gate /* 3799f63845Sab * The elfcap code handles mappings to and from several string styles. 3899f63845Sab * The caller uses elfcap_style_t to specify the style to use. 3999f63845Sab */ 4099f63845Sab typedef enum { 4199f63845Sab ELFCAP_STYLE_FULL = 1, /* Full formal name (e.g. AV_386_SSE) */ 4299f63845Sab ELFCAP_STYLE_UC = 2, /* Informal upper case (e.g. SSE) */ 4399f63845Sab ELFCAP_STYLE_LC = 3 /* Informal lower case (e.g. sse) */ 4499f63845Sab } elfcap_style_t; 4599f63845Sab 4699f63845Sab /* 4799f63845Sab * String descriptor: Contains the string and strlen(string). elfcap can 4899f63845Sab * be used in contexts (ld.so.1) where we do not want to make calls to 4999f63845Sab * string processing functions, so the length is calculated at compile time. 507c478bd9Sstevel@tonic-gate */ 517c478bd9Sstevel@tonic-gate typedef struct { 5299f63845Sab const char *s_str; 5399f63845Sab size_t s_len; 5499f63845Sab } elfcap_str_t; 5599f63845Sab 5699f63845Sab /* 5799f63845Sab * Capabilities descriptor: This maps the integer bit value 5899f63845Sab * (c_val) to/from the various strings that represent it. 5999f63845Sab * 6099f63845Sab * c_val is normally expected to be a non-zero power of 2 6199f63845Sab * value (i.e. a single set bit). The value 0 is special, and 6299f63845Sab * used to represent a "reserved" placeholder in an array of 6399f63845Sab * capabilities. These reserved values have NULL string pointers, 6499f63845Sab * and are intended to be ignored by the processing code. 6599f63845Sab */ 6699f63845Sab typedef struct { 6799f63845Sab uint64_t c_val; /* Bit value */ 6899f63845Sab elfcap_str_t c_full; /* ELFCAP_STYLE_FULL */ 6999f63845Sab elfcap_str_t c_uc; /* ELFCAP_STYLE_UC */ 7099f63845Sab elfcap_str_t c_lc; /* ELFCAP_STYLE_LC */ 7199f63845Sab } elfcap_desc_t; 7299f63845Sab 7399f63845Sab /* 7499f63845Sab * Valid format values: The various formats in which a generated 7599f63845Sab * string representing bitmap values can be displayed. 7699f63845Sab * 7799f63845Sab * This must be kept in sync with the format[] array in elfcap.c. 7899f63845Sab */ 7999f63845Sab typedef enum { 8099f63845Sab ELFCAP_FMT_SNGSPACE = 0, 8199f63845Sab ELFCAP_FMT_DBLSPACE = 1, 8299f63845Sab ELFCAP_FMT_PIPSPACE = 2 8399f63845Sab } elfcap_fmt_t; 847c478bd9Sstevel@tonic-gate 857c478bd9Sstevel@tonic-gate /* 8699f63845Sab * Error codes: 877c478bd9Sstevel@tonic-gate */ 8899f63845Sab typedef enum { 8999f63845Sab ELFCAP_ERR_NONE = 0, /* no error */ 9099f63845Sab ELFCAP_ERR_BUFOVFL = 1, /* buffer overfow */ 9199f63845Sab ELFCAP_ERR_INVFMT = 2, /* invalid format */ 9299f63845Sab ELFCAP_ERR_UNKTAG = 3, /* unknown capabilities tag */ 9399f63845Sab ELFCAP_ERR_UNKMACH = 4, /* unknown machine type */ 9499f63845Sab ELFCAP_ERR_INVSTYLE = 5 /* unknown style */ 9599f63845Sab } elfcap_err_t; 9699f63845Sab 977c478bd9Sstevel@tonic-gate 987c478bd9Sstevel@tonic-gate /* 9999f63845Sab * # of each type of capability known to the system. These values 10099f63845Sab * must be kept in sync with the arrays found in elfcap.c 1017c478bd9Sstevel@tonic-gate */ 102*bebb829dSRod Evans #define ELFCAP_NUM_SF1 3 10399f63845Sab #define ELFCAP_NUM_HW1_SPARC 16 10499f63845Sab #define ELFCAP_NUM_HW1_386 25 10599f63845Sab 1067c478bd9Sstevel@tonic-gate 10799f63845Sab /* 10899f63845Sab * Given a capability section tag and value, call the proper underlying 10999f63845Sab * "to str" function to generate the string description. 11099f63845Sab */ 11199f63845Sab extern elfcap_err_t elfcap_tag_to_str(elfcap_style_t, uint64_t, 11299f63845Sab uint64_t, char *, size_t, elfcap_fmt_t, ushort_t); 1137c478bd9Sstevel@tonic-gate 1147c478bd9Sstevel@tonic-gate /* 11599f63845Sab * The functions that convert from a specific capability value to 11699f63845Sab * a string representation all use the same common prototype. 1177c478bd9Sstevel@tonic-gate */ 11899f63845Sab typedef elfcap_err_t elfcap_to_str_func_t(elfcap_style_t, uint64_t, char *, 11999f63845Sab size_t, elfcap_fmt_t, ushort_t); 1207c478bd9Sstevel@tonic-gate 12199f63845Sab extern elfcap_to_str_func_t elfcap_hw1_to_str; 12299f63845Sab extern elfcap_to_str_func_t elfcap_sf1_to_str; 1237c478bd9Sstevel@tonic-gate 12499f63845Sab /* 12599f63845Sab * The reverse mapping: Given a string representation, turn it back into 12699f63845Sab * integer form. 12799f63845Sab */ 12899f63845Sab typedef uint64_t elfcap_from_str_func_t(elfcap_style_t, 12999f63845Sab const char *, ushort_t mach); 13099f63845Sab 13199f63845Sab extern elfcap_from_str_func_t elfcap_hw1_from_str; 13299f63845Sab extern elfcap_from_str_func_t elfcap_sf1_from_str; 13399f63845Sab 13499f63845Sab /* 13599f63845Sab * These functions give access to the individual descriptor arrays. 13699f63845Sab * The caller is allowed to copy and use the string pointers contained 13799f63845Sab * in the descriptors, but must not alter them. Functions are used instead 13899f63845Sab * of making the arrays directly visible to preclude copy relocations in 13999f63845Sab * non-pic code. 14099f63845Sab */ 14199f63845Sab extern const elfcap_desc_t *elfcap_getdesc_hw1_sparc(void); 14299f63845Sab extern const elfcap_desc_t *elfcap_getdesc_hw1_386(void); 14399f63845Sab extern const elfcap_desc_t *elfcap_getdesc_sf1(void); 1447c478bd9Sstevel@tonic-gate 1457c478bd9Sstevel@tonic-gate #ifdef __cplusplus 1467c478bd9Sstevel@tonic-gate } 1477c478bd9Sstevel@tonic-gate #endif 1487c478bd9Sstevel@tonic-gate 1497c478bd9Sstevel@tonic-gate #endif /* _ELFCAP_DOT_H */ 150