diff src/gpf/inc/ind2str.h @ 0:4e78acac3d88

src/{condat,cs,gpf,nucleus}: import from Selenite
author Mychaela Falconia <falcon@freecalypso.org>
date Fri, 16 Oct 2020 06:23:26 +0000
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/gpf/inc/ind2str.h	Fri Oct 16 06:23:26 2020 +0000
@@ -0,0 +1,124 @@
+/* 
++----------------------------------------------------------------------------- 
+|  Project :  STR2IND
+|  Modul   :  ind2str.h
++----------------------------------------------------------------------------- 
+|  Copyright 2002 Texas Instruments Berlin, AG 
+|                 All rights reserved. 
+| 
+|                 This file is confidential and a trade secret of Texas 
+|                 Instruments Berlin, AG 
+|                 The receipt of or possession of this file does not convey 
+|                 any rights to reproduce or disclose its contents or to 
+|                 manufacture, use, or sell anything it may describe, in 
+|                 whole, or in part, without the specific written consent of 
+|                 Texas Instruments Berlin, AG. 
++----------------------------------------------------------------------------- 
+|  Purpose :  This Module defines interface of the ind2str library. The
+|             main purpose of this library is the translation of an trace
+|             index to a complete trace string.
++----------------------------------------------------------------------------- 
+*/ 
+
+#ifndef IND2STR_H
+#define IND2STR_H
+
+
+/*==== CONSTANTS ==================================================*/
+#define IND2STR_OK                      0
+#define IND2STR_FILE_NOT_FOUND         -1
+#define IND2STR_WRONGFILEFORMAT        -2
+#define IND2STR_INDEXOUTOFBOUNDS       -3
+#define IND2STR_PARAMCOUNTOUTOFBOUNDS  -4
+#define IND2STR_NOTINITIALISED         -5
+#define IND2STR_ACCESSVIOLATION        -6
+#define IND2STR_INTERNAL_ERROR         -7
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+
+/*-----------------------------------------------------------------------------
+|  Function    : ind2str_Init()
++------------------------------------------------------------------------------
+|  Description : Initialises the library: opens the file containing the trace
+|                mapping table, build the internal representation , closes the
+|                the file after reading.
+|
+|  Parameters  : tableFile  - the mapping table file name
+|                 
+|  Return      : success or failure
++------------------------------------------------------------------------------
+*/
+signed char ind2str_Init(char * tableFile);
+
+
+/*-----------------------------------------------------------------------------
+|  Function    : ind2str_Exit()
++------------------------------------------------------------------------------
+|  Description : De-initialises the library: closes the file containing the
+|                trace mapping table, frees allocated memory.
+|
+|  Parameters  : 
+|                 
+|  Return      : 
++------------------------------------------------------------------------------
+*/
+void ind2str_Exit(void);
+
+
+/*-----------------------------------------------------------------------------
+|  Function    : ind2str_Version()
++------------------------------------------------------------------------------
+|  Description : Returns the version (build date) of the table. The table must
+|                be initialized before.
+|
+|  Parameters  : 
+|                 
+|  Return      : The version of the table or 0.
++------------------------------------------------------------------------------
+*/
+unsigned long ind2str_Version(void);
+
+
+/*-----------------------------------------------------------------------------
+|  Function    : ind2str_VersionNoInit()
++------------------------------------------------------------------------------
+|  Description : Returns the version (build date) of the table. The table does
+|                not need to be initialized before.
+|
+|  Parameters  : fileName - the name of the file, that contains a table
+|                 
+|  Return      : The version of the table or 0.
++------------------------------------------------------------------------------
+*/
+unsigned long ind2str_VersionNoInit(char * fileName);
+
+
+/*-----------------------------------------------------------------------------
+|  Function    : ind2str
++------------------------------------------------------------------------------
+|  Description : Transforms a trace index string into a trace string, according
+|                to the trace mapping table.
+|
+|  Parameters  : dst - destination string
+|
+|                src - source string
+|                            
+|
+|  Return      : The number of characters printed to the destination string.
+|                
++------------------------------------------------------------------------------
+*/
+int ind2str(char * dst, char * src);
+
+
+#ifdef __cplusplus
+}
+#endif
+
+
+#endif /* IND2STR_H */
+