_conv.h revision d29b2c4438482eb00488be49a1f5d6835f455546
734N/A/*
734N/A * CDDL HEADER START
734N/A *
734N/A * The contents of this file are subject to the terms of the
734N/A * Common Development and Distribution License (the "License").
734N/A * You may not use this file except in compliance with the License.
734N/A *
734N/A * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
734N/A * or http://www.opensolaris.org/os/licensing.
734N/A * See the License for the specific language governing permissions
734N/A * and limitations under the License.
734N/A *
734N/A * When distributing Covered Code, include this CDDL HEADER in each
734N/A * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
734N/A * If applicable, add the following below this CDDL HEADER, with the
734N/A * fields enclosed by brackets "[]" replaced with your own identifying
734N/A * information: Portions Copyright [yyyy] [name of copyright owner]
734N/A *
734N/A * CDDL HEADER END
734N/A */
734N/A
734N/A/*
734N/A * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
734N/A * Use is subject to license terms.
734N/A */
734N/A
734N/A#ifndef __CONV_DOT_H
734N/A#define __CONV_DOT_H
734N/A
734N/A#pragma ident "%Z%%M% %I% %E% SMI"
734N/A
734N/A/*
734N/A * Local include file for conversion library.
734N/A */
734N/A#include <conv.h>
734N/A
734N/A#ifdef __cplusplus
734N/Aextern "C" {
734N/A#endif
734N/A
734N/A/*
734N/A * Some format strings differ depending on whether they are used for 32-bit
734N/A * or 64-bit values.
734N/A */
734N/A#if defined(_ELF64)
734N/A#define MSG_GBL_FMT_DEC MSG_GBL_FMT_DEC_64
734N/A#define MSG_GBL_FMT_DECS MSG_GBL_FMT_DECS_64
734N/A#define MSG_GBL_FMT_HEX MSG_GBL_FMT_HEX_64
734N/A#define MSG_GBL_FMT_HEXS MSG_GBL_FMT_HEXS_64
734N/A
734N/A#define MSG_SYM_FMT_VAL MSG_SYM_FMT_VAL_64
734N/A#else
734N/A#define MSG_GBL_FMT_DEC MSG_GBL_FMT_DEC_32
734N/A#define MSG_GBL_FMT_DECS MSG_GBL_FMT_DECS_32
734N/A#define MSG_GBL_FMT_HEX MSG_GBL_FMT_HEX_32
734N/A#define MSG_GBL_FMT_HEXS MSG_GBL_FMT_HEXS_32
734N/A
734N/A#define MSG_SYM_FMT_VAL MSG_SYM_FMT_VAL_32
734N/A#endif
734N/A
734N/A
734N/A
734N/A/*
734N/A * Map an integer into a descriptive string.
734N/A *
734N/A * entry:
734N/A * buf - A buffer into which this routine can format
* a result string, if necessary.
* bufsize - sizeof(buf)
* val - The value for which a string is desired.
* flags - CONV_FMT_* values to be passed to conv_invalid_val() if
* necessary. The caller is reponsible for having examined
* the CONV_FMT_ALT_* part of flags and passing the proper
* msg array.
* num_msg - # of Msg entries in msg.
* msg - Array of num_msg Msg items corresponding to the possible
* strings corresponding to val.
*
* exit:
* If val lies in the range [0-(num_msg-1)], then the string
* corresponding to it is returned. If val is outside the range,
* conv_invalid_val() is called to format an ASCII representation
* of it into string, and that is returned.
*
* note:
* Ideally, this would be a function defined in globals.c.
* However, it uses the MSG_ORIG macro, which uses an array
* that is local to each module. Hence, this is a static function,
* defined by this macro. Once defined by a module, the routine
* is called normally.
*/
#define DEFINE_conv_map2str \
static \
const char * \
conv_map2str(Conv_inv_buf_t *inv_buf, int val, Conv_fmt_flags_t flags, \
int num_msg, const Msg *msg) \
{ \
if ((val >= 0) && (val < num_msg)) \
return (MSG_ORIG(msg[val])); \
\
/* If we get here, it's an unknown value */ \
return (conv_invalid_val(inv_buf, val, flags)); \
}
/* # of elements in an array */
#define ARRAY_NELTS(arr) (sizeof (arr) / sizeof (*arr))
#ifdef __cplusplus
}
#endif
#endif /* __CONV_DOT_H */