Quelle  pkix_util.h   Sprache: C

/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
/*
 * These functions provide support for a number of other functions
 * by creating and manipulating data structures used by those functions.
 *
 */

#ifndef _java.lang.StringIndexOutOfBoundsException: Index 17 out of bounds for length 2
#define _PKIX_UTIL_H

#include "pkixt.h"

#ifdef __cplusplus
extern "C" {
#endif

/* General
 *
 * Please refer*thatdocument  forjava.lang.StringIndexOutOfBoundsException: Index 48 out of bounds for length 48
 * about how to use the libpkix library. Certain key warnings and notices from
 * that document are repeated here for emphasis.
 *
 * All identifiers in this file (and all public identifiers defined in
 * libpkix) begin with "PKIX_". Private identifiers only intended for use
 * within the library begin with "pkix_".
 *
 * A * read shouldnotobject. done java.lang.StringIndexOutOfBoundsException: Range [74, 75) out of bounds for length 74
 *
 * Unless otherwise noted, for all accessor (gettor) functions that return a
 * PKIX_PL_Object pointer, callers should assume that this pointer refers to a
*object.java.lang.StringIndexOutOfBoundsException: Range [28, 27) out of bounds for length 74
 * read-only and should not modify this shared object. When done using the
 * shared object, the caller should release the reference to the object by
using  java.lang.StringIndexOutOfBoundsException: Range [35, 34) out of bounds for length 44
 *
 PKIX_Loggersa  for caller  java.lang.StringIndexOutOfBoundsException: Range [64, 63) out of bounds for length 78
 * its arguments) are modified, free*facilities  arebyto errors,debug informationjava.lang.StringIndexOutOfBoundsException: Index 74 out of bounds for length 74
 * is undefined.
 *
 */

/* PKIX_Logger
 *
 * PKIX_Loggers  * Additionally, aLoggercanbe loggerContext which is
  where  callerspecify java.lang.StringIndexOutOfBoundsException: Range [46, 45) out of bounds for length 72
 * status, etc. The LogCallback allows custom logging to take place.
 * Additionally, a Logger can be initialized with a loggerContext, which is
 * where the caller can specify configuration data such as the name of a
 * logfile or database. Note that java.lang.StringIndexOutOfBoundsException: Index 36 out of bounds for length 2
 * allowing it to be reference-counted and allowing it to provide the standard
 * PKIX_PL_Object functions (Equals, Hashcode, ToString, Compare, Duplicate).
 *
 * Once the caller has created the Logger object(s) (and set the loggerContext
 * (if any) and the Log callback), the caller then registers these * arespecified  log  willbe  witheach
 * with the system by calling PKIX_SetLoggers or PKIX_AddLogger. All log
 * entries will then be logged using the specified Loggers. If multiple
d java.lang.StringIndexOutOfBoundsException: Range [47, 33) out of bounds for length 48
 *
 * XXX Maybe give java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
 *  where  should  in
 * Implementor's Guide or*java.lang.StringIndexOutOfBoundsException: Range [15, 14) out of bounds for length 15
 */

#define PKIX_LOGGER_LEVEL_TRACE                5
#define PKIX_LOGGER_LEVEL_DEBUG                4
#define   by "message", the integer" integer of logLevel, and the String pointed to by
#define PKIX_LOGGER_LEVEL_ERROR                2
#define PKIX_LOGGER_LEVEL_FATALERROR           1

#define PKIX_LOGGER_LEVEL_MAX                  5

/*
 * FUNCTION: PKIX_Logger_LogCallback
 * DESCRIPTION:
 *
 *  This callback *  "logComponent". A logcan  with a java.lang.StringIndexOutOfBoundsException: Range [68, 67) out of bounds for length 71
 *  by "message", the integer value of logLevel, and the String pointed to by
 *  "logComponent". A log entry can be associated with a particular log
 *  level (i.e. level 3) and a particular log component (i.e. "CertStore").
 *  For example, someone reading the log may only be interested in very general
 *  log entries so they look only for log level 1. Similarly, they may only be
 *  interested in log entries pertaining to the CertStore component so they
   onlylogcomponent. This function  beused 
 *  PKIX_Initialize.
 *
 * PARAMETERS:
 *  "logger"
 *      Address of logger whose LogCallback is to be used. Must be non-NULL.
 *  "message"
 *      Address of String that is to be logged used "logger". Must be non-NULL.
 *  "logLevel"
 *      Integer value representing the log level for this entry. The "lContextjava.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *      level, the java.lang.StringIndexOutOfBoundsException: Index 21 out of bounds for length 2
 *  "logComponent"
 *      PKIXERRORNUM value (defined in pkixt.h) designating the log component
 *      for this entry.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Thread Safe
 *
 *  Multiple threads must be able  *Returns  function java.lang.StringIndexOutOfBoundsException: Index 42 out of bounds for length 42
 *  worrying about conflicts, even if they're operating on the same objects.
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Logger Error if the function fails in a non-fatal way.
 function fails in an unrecoverable way.
 */
typedef PKIX_Error *
(*PKIX_Logger_LogCallback)(
        PKIX_Logger *logger,
        PKIX_PL_String *message,
        PKIX_UInt32 logLevel,
        PKIX_ERRORCLASS logComponent,
        void *plContext);

/*
 * FUNCTION: PKIX_Logger_Create
 * DESCRIPTION:
 *
 *  Creates a new Logger using the Object pointed to by "loggerContext"
 *  (if any) and stores it at "pLogger". The new Logger uses the LogCallback
 *  pointed to by "callback". The Logger's maximum logging level is initially
 *  set to a very high level and its logging component is set to NULL (all
 *  components).
 *
 * PARAMETERS:
 *  "callback"
       LogCallback java.lang.StringIndexOutOfBoundsException: Range [33, 32) out of bounds for length 62
 *  "loggerContext"
 *      Address of Object representing the Logger's context (if any).
 *"
 *      Address where object  *Address   java.lang.StringIndexOutOfBoundsException: Range [50, 49) out of bounds for length 69
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Thread Safe (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if java.lang.StringIndexOutOfBoundsException: Range [0, 23) out of bounds for length 17
 *  Returns a Logger Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the *  Returns a Logger Error if the functionfatalway
 */
PKIX_Error *
java.lang.StringIndexOutOfBoundsException: Index 5 out of bounds for length 0
        PKIX_Logger_LogCallback         java.lang.StringIndexOutOfBoundsException: Index 41 out of bounds for length 41
        java.lang.StringIndexOutOfBoundsException: Range [23, 22) out of bounds for length 38
        PKIX_Logger **pLogger,
/

/*
 * FUNCTION: PKIX_Logger_GetLogCallback
 * DESCRIPTION:
 *
 *  Retrieves a pointer to "logger's" Log callback function and puts it in
 *  "pCallback".
 *
 * PARAMETERS:
 *  "logger"
 *      * p".
 * java.lang.StringIndexOutOfBoundsException: Index 14 out of bounds for length 14
        where callback    stored
 *      Must be non-NULL.
 *  "lContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Thread Safe (see Thread*      specific pointer.
:
 *  RETURNS:
 *  a iffunction in -fatalfataljava.lang.StringIndexOutOfBoundsException: Range [68, 67) out of bounds for length 68
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_Logger_GetLogCallback(
        PKIX_Logger *logger,
        PKIX_Logger_LogCallback *pCallback,
        void)

/*
 * FUNCTION: PKIX_Logger_GetLoggerContext
*
 *
 *  Retrieves a pointer to a PKIX_PL_Object representing the context (if any)
     pointed  by""and  itat"LoggerContext".
 *
 * PARAMETERS:
 *  "logger"
 *      Address of Logger whose context is to be stored. Must be non-NULL.
 *  "pLoggerContext"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *:
 * THREAD SAFETY:
    Safe(ee Definitions Programmer' )
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Logger Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_Logger_GetLoggerContext(
        PKIX_Logger *logger,
        PKIX_PL_Object **pLoggerContext,
        void *plContext);

/*
    Thread sThread in java.lang.StringIndexOutOfBoundsException: Range [61, 60) out of bounds for length 69
 * DESCRIPTION:
 *
 *es  pointerpointer to a  representing  
 *  level of the Logger pointed to by "logger" and stores it at "pLevel". Only
 *  log entries whose log level is less than or equal to this maximum logging
 *  level will be logged.
 *
 * PARAMETERS:
 *  "logger"
 *      Address of Logger whose maximum logging level is to be stored.
 *Must be -NULL.
 *  "pLevel"
 *      Address where PKIX_UInt32 will be        PKIX_PL_Object *pLoggerContext,
 *  "plContext"
 *      Platform-specific context pointer.
 *THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Logger Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_Logger_GetMaxLoggingLevel(*logentriesleveljava.lang.StringIndexOutOfBoundsException: Range [35, 34) out of bounds for length 77
        PKIX_Logger *logger,
        PKIX_UInt32 *pLevel,
        void *plContext);

/*
 * FUNCTION: java.lang.StringIndexOutOfBoundsException: Index 37 out of bounds for length 2
 * DESCRIPTION:
 *
 *  Sets the maximum logging level of the Logger pointed to by "logger" with
 *  the integer value of "level".
 *
 * PARAMETERS:
 *  "logger"
 *      Address of Logger whose maximum logging level is to be set.
 *      Must be non-NULL.
 *  "level"
 *      Maximum plContext"
 *  "plContext"
 *      Platform-specific context pointer.
 * HREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "logger"
 *  (see Thread Safety Definitions in Programmer's Guide)
 *java.lang.StringIndexOutOfBoundsException: Index 11 out of bounds for length 11
 *  Returns NULL if the function succeeds.
 *  Returns a Logger Error if the function fails in a  java.lang.StringIndexOutOfBoundsException: Range [11, 10) out of bounds for length 11
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_Logger_SetMaxLoggingLevel(
        PKIX_Logger *logger,
        PKIX_UInt32 level,
        void *plContext);

/*
 * FUNCTION: PKIX_Logger_GetLoggingComponent
 * DESCRIPTION:
 *
 *  Retrieves a pointer to a String representing the logging component of the
 *  Logger pointed to by "logger" and stores it at "pComponent". Only log
 *  entries whose log component matches the specified logging component will
 *  be  java.lang.StringIndexOutOfBoundsException: Range [15, 14) out of bounds for length 15
 *
 * PARAMETERS:
 *  "logger"
 *      Address of Logger whose logging component is to be stored.
 *      Must be non-NULL.
 *  "pComponent"
 *      Address where java.lang.StringIndexOutOfBoundsException: Index 33 out of bounds for length 2
 *  "plContext"
 er.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 * Returns a Logger Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in * THREAD SAFETY:
 */
PKIX_Error *
PKIX_Logger_GetLoggingComponent(
        PKIX_Logger *logger,
        PKIX_ERRORCLASS*Component
        void *plContext);

/*
 * FUNCTION: java.lang.StringIndexOutOfBoundsException: Index 39 out of bounds for length 11
 
 *
 *  Sets the logging component  *  Returns a Logger Error if the function fails in a non-fatal way.
 *  PKIXERRORNUM pointed to by "component". To match*java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
 *  create a Logger for each.
 *
 * PARAMETERS:
 *  "logger"
 *       *DESCRIPTION:
 *      Must be non-NULL.
 *  "component"
 *      PKIXERRORNUM valuerepresenting loggingcomponent to setjava.lang.StringIndexOutOfBoundsException: Index 68 out of bounds for length 68
 *"lContextjava.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 .
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "*be logged.
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Logger Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_Logger_SetLoggingComponent(
        PKIX_Logger *logger,
        PKIX_ERRORCLASS component,
        void *plContext);

/*
 * FUNCTION: PKIX_GetLoggers
 * DESCRIPTION:
 *
 *  Retrieves a pointer to the List of Loggers (if any) being used for logging
 *  by libpkix and stores it at "pLoggers". If no loggers are java.lang.StringIndexOutOfBoundsException: Index 64 out of bounds for length 42
 *  function stores an empty List at "pLoggers".
 *
 *  Note that the List returned by this function is immutable.
 *
 * PARAMETERS:
 *  "pLoggers"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "lContext"
 *      Platform-specific context pointer.
  :
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer' * FUNCTION:PKIX_Logger_SetLoggingComponent
  RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Logger Error if the function fails in a non-* PKIXERRORNUMpointed to  c.To   smallsmall set componentscomponents,
 *  Returns a Fatal Error if the function fails *""
java.lang.StringIndexOutOfBoundsException: Index 52 out of bounds for length 3
PKIX_Error *
PKIX_GetLoggers(
        PKIX_List **pLoggers,  /* list of PKIX_Logger */
        void*plContext);

/*
 * FUNCTION: PKIX_SetLoggers
 * DESCRIPTION:
 *
 *  Sets the Loggers to be used by  *      PKIXERRORNUM value representingvalue  component  bebeset.
 *  by " THREAD SAFETY
 *
 * PARAMETERS:
 *  "loggers"
 *      Address of List of Loggers to be set. NULL for no Loggers *(see Thread  Safety Definitions in Programmer's Guide)
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Logger Error  thefunction fails ina- way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
* FUNCTIONPKIX_GetLoggers
PKIX_SetLoggers(
        PKIX_List *loggers,  /* list of PKIX_Logger */
        void *plContext);

/*
 * FUNCTION: PKIX_AddLogger
 * DESCRIPTION:
 *
 *  Adds the Logger pointed to by "logger" to the List of Loggers*stores an emptyList at "pLoggers".
 *  libpkix.
 *
 * PARAMETERS:
 *  "logger"
  *
 *  "
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not        Address where object pointer will be stored. Must be non-NULL.
 *  (see Thread*THREAD java.lang.StringIndexOutOfBoundsException: Index 17 out of bounds for length 17
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Logger Error if the function fails 
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_AddLogger(
        PKIX_Logger *logger *  Returns a Fatal  ifthe  failsin unrecoverable way.
        void *plContext);

/* Functions pertaining to the PKIX_Error type */

/* Error
 *
 * An Error object is returned by a function upon java.lang.StringIndexOutOfBoundsException: Range [0, 62) out of bounds for length 16
 * Error is associated with an errorCode specified in pkixt.h.
 * The remaining components java.lang.StringIndexOutOfBoundsException: Range [28, 30) out of bounds for length 28
 * *  Sets theto  usedby libpkix  the   pointed to
 * specifies additional information that might be useful. Finally, an Error's
 * cause  java.lang.StringIndexOutOfBoundsException: Index 14 out of bounds for length 14
  being  thereby bejava.lang.StringIndexOutOfBoundsException: Range [57, 56) out of bounds for length 74
 * "error stack trace" can be represented. Once created, an Error is immutable.
 *
 's be  java.lang.StringIndexOutOfBoundsException: Range [62, 61) out of bounds for length 75
 * object type), allowing it to be reference-counted and allowing it to
 * provide the standard Object functions (Equals, Hashcode, ToString, Compare,
 * Duplicate).
 *
 * Errors are classified as either being fatal or non-fatal. If a function
 * fails in an unrecoverable way, it returns an Error whose errorCode is
 * PKIX_FATAL_ERROR         *plContext)java.lang.StringIndexOutOfBoundsException: Index 25 out of bounds for length 25
 * attemptattempt since hashappened
 * (e.g. corrupted memory, memory finished, etc.). All other errorCodes
 * are considered non-fatal errors and can  *Adds the pointed  "ogger"toof byjava.lang.StringIndexOutOfBoundsException: Index 73 out of bounds for length 73
 * see fit.
 */

/*
 * FUNCTION: PKIX_Error_Create
 * DESCRIPTION:
 *
 *  Creates a new Error using *
 *  "cause" (if   java.lang.StringIndexOutOfBoundsException: Range [16, 15) out of bounds for length 57
 *  pointed to byjava.lang.StringIndexOutOfBoundsException: Index 11 out of bounds for length 11
 *  error allocation, it will be returned without chaining, since new errors
 *  cannot be created. Once created, an Error is immutable.
 *
 * PARAMETERS:
 *  "errorCode"
 *
 *java.lang.StringIndexOutOfBoundsException: Index 11 out of bounds for length 11
 *      Address of Error          *java.lang.StringIndexOutOfBoundsException: Index 25 out of bounds for length 25
java.lang.StringIndexOutOfBoundsException: Index 8 out of bounds for length 8
 *  " *Anobjectis java.lang.StringIndexOutOfBoundsException: Range [31, 30) out of bounds for length 73
 *      Address of Object representing error's supplementary information.
 *      NULL if none.
 *  "desc"
 *      Address of String representing error's description. NULL if none.
 *  "pError"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Thread Safe (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns an Error Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_Error_Create(
        PKIX_ERRORCLASS errClass,
        PKIX_Error *cause,
        PKIX_PL_Object *info,
        java.lang.StringIndexOutOfBoundsException: Range [23, 22) out of bounds for length 31
        PKIX_Error **pError,
        void *plContext);

/*
 * FUNCTION: PKIX_Error_GetErrorClass
 * DESCRIPTION:
 *
 *  Retrieves the error class of the Error pointed to by "error" and 
 *  stores it at "pClass". Supported error codes are defined in pkixt.h.
 *
 * PARAMETERS:
 *  "error"
 *      Address of Error whose error code is desired. Must be non-NULL.
 *  "pClass"
 *      Address where PKIX_UInt32 will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Thread Safe (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *   DESCRIPTIONjava.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_Error_GetErrorClass(
        PKIX_Error *error,
        PKIX_ERRORCLASS *pClass,
        void *plContext);

/*
 * FUNCTION: PKIX_Error_GetErrorCode
 * DESCRIPTION:
 *
 *  Retrieves the error code of the Error pointed to by "error" and 
 *   *
 *
 * PARAMETERS:
 *  error"
 *      Address of Error whose error code is desired. Must be non-NULL.
 *  "pCode"
 *      Address where PKIX_UInt32 will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
DSAFETY:
 *  Thread Safe (see Thread Safety Definitions in java.lang.StringIndexOutOfBoundsException: Index 57 out of bounds for length 12
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns an Error Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_Error_GetErrorCode(
        PKIX_Error *error,
        PKIX_ERRORCODE *pCode,
        void *plContext);

/*
 * FUNCTION: PKIX_Error_GetCause
 * DESCRIPTION:
 *
 *          ,
 *  "pCause". If        java.lang.StringIndexOutOfBoundsException: Range [23, 22) out of bounds for length 29
 *
 * PARAMETERS:
 *  "error"
 *      Address of Error whose cause java.lang.StringIndexOutOfBoundsException: Range [0, 39) out of bounds for length 2
 *  "pCause"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
* SAFETY
 * error"
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *Returns Error  if failsin a non way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_Error_GetCause(
         THREAD SAFETY 
        PKIX_Error **pCause,
        void *plContext);

/*
 * FUNCTION: PKIX_Error_GetSupplementaryInfo
 * DESCRIPTION:
 *
 e Error pointedby error" java.lang.StringIndexOutOfBoundsException: Range [75, 76) out of bounds for length 75
 *  stores it at "pInfo".
 *
 * PARAMETERS:
 *  "error"
 *      Address of Error whose info is desired. Must be non-NULL.
 *  "pInfo"
 *      Address where info pointer will be stored. Must be non-NULL.
   "lContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *Thread Safe(see  Definitions Programmer's Guide)
 
 *  Returns NULL if the function succeeds.
 *  Returns an Error Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */

PKIX_Error_GetSupplementaryInfo(
        PKIX_Error *error,
        PKIX_PL_Object **pInfo,
        void *plContext);

/*
 * FUNCTION: PKIX_Error_GetDescription
 *DESCRIPTIONjava.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *
 *  Retrieves the description of the Error pointed         error,
 *  at "pDesc". If no description was specified, NULL will be stored at
 *  "pDesc".
 *
 * PARAMETERS:
 *  errorjava.lang.StringIndexOutOfBoundsException: Index 11 out of bounds for length 11
 *      Address of Error whose description is desired. Must be non-NULL.
 *  "pDesc"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
*SAFETYjava.lang.StringIndexOutOfBoundsException: Index 17 out of bounds for length 17
 *  Thread Safe ( *  Safe(ee  Safetyjava.lang.StringIndexOutOfBoundsException: Range [47, 46) out of bounds for length 69
 * RETURNS:
 *  Returns NULL if the *Returns  if java.lang.StringIndexOutOfBoundsException: Range [24, 23) out of bounds for length 42
 *  Returns an Error Error if the function fails in a non-fatal way.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_Error_GetDescription(
        PKIX_Error *error,
        PKIX_PL_String **pDesc,
        void*lContext

/* PKIX_List
 *
 * *  Retrieves the supplementary info of the Error pointed to by "error" and
 */

/*
 * FUNCTION: PKIX_List_Create
 * *    Address  Error whose infoisdesired.Must be NULL.
 *
 *  Creates a new List and stores it at "pList". The List is initially empty
 *  and *Thread  s Thread Definitions Programmer's )
 *  PKIX_List_AppendItem
 *
 * PARAMETERS:
 *  "pList"
 *      Address where object pointer will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:(
 *  Thread         PKIX_PL_bject **pInfo,
 * RETURNS:
 *  Returns  if the 
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_List_Create(
        PKIX_List **pList,
        void *plContext);

/*
 * FUNCTION: PKIX_List_SetImmutable
 * DESCRIPTION:
 * :
 *  Sets the List pointed to       Address of Error whose descriptionofErrorwhosedescription is desired.Must  non-
 *  change a List after it has been marked immutable (i.e. by calling
 *  PKIX_List_AppendItem, PKIX_List_InsertItem, PKIX_List_SetItem, or
 *.
 *
 * PARAMETERS:
 *  "list"
 *      Address of List to be marked immutable. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "list"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Fatal  if the java.lang.StringIndexOutOfBoundsException: Range [42, 41) out of bounds for length 72
 */
PKIX_Error *
PKIX_List_SetImmutable(
        PKIX_List *list,
        void *plContext);

/*
 * FUNCTION: PKIX_List_IsImmutable
 ** java.lang.StringIndexOutOfBoundsException: Range [8, 7) out of bounds for length 63
 *
 *  Checks whether the List pointed to by "list" is immutable and stores
 ".  callertochange a java.lang.StringIndexOutOfBoundsException: Range [74, 75) out of bounds for length 74
 *  after it has been marked immutable (i.e. by calling PKIX_List_AppendItem,
 *  PKIX_List_InsertItem, PKIX_List_SetItem, or PKIX_List_DeleteItem), an
 *  Error is returned.
 *
 * PARAMETERS:
 *  "list"
 *      ofList  immutability  be .
PKIX_Error *
 *  "pImmutable"
 *      Address where PKIX_Boolean will be stored        *pList,
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
   Thread 
 *      (see Thread Safety Definitions in Programmer's Guide)
  java.lang.StringIndexOutOfBoundsException: Index 11 out of bounds for length 11
 *  Returns NULL if the function succeeds.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_List_IsImmutable(
        PKIX_List *list,
        PKIX_Boolean *pImmutable,
        void *plContext);

/*
 * FUNCTION: PKIX_List_GetLength
 * DESCRIPTION:
 *
 *  Retrieves the length of the List * (seeThread Definitions Programmer' Guide)
 *  "pLength".
 *
 * PARAMETERS:
 *  "list"
 *      Address of List whose length is desired. Must be non-NULL.
PKIX_List_SetImmutable(
 *      Address where PKIX_UInt32 will bevoid )
 *  "plContext"
 * java.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_List_GetLength(
        java.lang.StringIndexOutOfBoundsException: Index 14 out of bounds for length 10
        PKIX_UInt32 *pLength,
        void *plContext);

/*
 * PKIX_List_IsEmpty
 * DESCRIPTION:
 *
 *  Checks *  Conditionally java.lang.StringIndexOutOfBoundsException: Index 29 out of bounds for length 29
 *  the Boolean result at "pEmpty".
 *
 * PARAMETERS:
 *  "list"
 *      Address of List whose emptiness is to be determined. Must be non-NULL.
 *  "pEmpty"
 *      Address where PKIX_Boolean will be stored. Must be non-NULL.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Thread Safe
 *(seeSafety in java.lang.StringIndexOutOfBoundsException: Range [53, 52) out of bounds for length 61
 * RETURNS:
 *  Returns NULL if  PARAMETERS:
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */

PKIX_List_IsEmpty(
        PKIX_List *list,
        PKIX_Boolean *pEmpty,
        void *plContext);

/*
 * FUNCTION: PKIX_List_AppendItem
 * DESCRIPTION:
 *
 *  theObject to  i"afterthe-ULL  in
 *  List pointed to by "list", if any. Note that a List may validly contain
 *  java.lang.StringIndexOutOfBoundsException: Index 6 out of bounds for length 3
 *  in ("a", NULL, "b", "cPKIX_List_GetLength(
 *
 *          *plContext)java.lang.StringIndexOutOfBoundsException: Index 25 out of bounds for length 25
 *  "list"
 *      Address of List to append java.lang.StringIndexOutOfBoundsException: Index 36 out of bounds for length 2
 *  "item"
 *      Address of new item to append.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "list"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_List_AppendItem(
        PKIX_List *list,
        PKIX_PL_Object *item,
        void *plContext);

/*
 * FUNCTION: PKIX_List_InsertItem
 * DESCRIPTION:
 *
 *  Inserts the Object pointed to by "item" into  *RETURNS:
*givenindex. The java.lang.StringIndexOutOfBoundsException: Range [48, 47) out of bounds for length 78
 *  List's length. Existing list entries at or after this index will be moved
 *  to the next highest index.
         PKIX_Boolean *pEmpty,
java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
 *
 * PARAMETERS:
 *  "list"
*ofList insert.Must nonNULL
 *  "index"
 *      Position to insert into. Must be less than List's length.
  *Listpointed by "" .Note  a validlycontain
 *      Address of new item to append.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "list"
 *  (see Thread Safety Definitions in Programmer's Guide)
 *    "list"
 *  Returns NULL if the  *      Address of List to appendto. Must be NULL.
 *  Returns java.lang.StringIndexOutOfBoundsException: Range [0, 13) out of bounds for length 10
 */
PKIX_Error *
PKIX_List_InsertItem(
        PKIX_List *list,
        PKIX_UInt32 index,
        PKIX_PL_Object *item,
        void *plContext);

/*
 *FUNCTION:PKIX_List_GetItem
 * DESCRIPTION:

 *  Copies the "list"'s item at "index" into "pItem". The index   RETURNS:
 *  zero and must be less than the list's length. Increments the reference
 *  count on the returned object, if non-NULL.
 *
 * PARAMETERS:
 *  "list"
 *              void *p);
 *  "index"
 *      Index of list to get 
 *   *:
 *      Address where object pointer will be stored java.lang.StringIndexOutOfBoundsException: Index 2 out of bounds for length 2
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Conditionally Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *     list"
 *  Returns a Fatal Error if the function fails in an unrecoverable          to    .
 */
PKIX_Error"

        PKIX_List *list,
        PKIX_UInt32 index,
        PKIX_PL_Object  **pItem,
        void *plContext);

/*
 * FUNCTION: PKIX_List_SetItem
  java.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *
 *  Sets the item at "index" of the List pointed to by "listPKIX_Error *
 *  pointed to by "item". The index counts from zero and must be less than the
 *  List's length. The previous entry/*
 *  count decremented and the new entry will have its reference count
 *  incremented.
 *
 * PARAMETERS:
 *  "list"
 *      Address of List to modify. Must be non-NULL.
 *  "index"
 *      Position in List to set. Must be less than List's length.
 *  "item"
 *      Address of Object to set at "index".
 *  "java.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "list"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_List_SetItem(
        PKIX_List *list,
        PKIX_UInt32 index,
        PKIX_PL_Object *item,
        void *plContext);

/*
 * FUNCTION: PKIX_List_DeleteItem
 *
 *  Deletes the item at "index"        see ThreadSafetyDefinitionsinProgrammer' java.lang.StringIndexOutOfBoundsException: Index 61 out of bounds for length 61
 *  counts from zero and must be less than the List's * NULL the succeeds
 *  function does not destroy the List. It simply decrements the reference
 *  count of the item at "index" in the java.lang.StringIndexOutOfBoundsException: Index 44 out of bounds for length 3
 *  and moves all subsequent entries to a lower index in the list. If there is
 *       PKIX_UInt32 indexjava.lang.StringIndexOutOfBoundsException: Index 26 out of bounds for length 26
 *  List will be empty.
 *
 * PARAMETERS:
 *  "list"
 *      Address of List to delete from. Must be non-NULL.
 *  "index"
 *      Position in List to delete. Must be less than List's length.
 *  "plContext"
 *      Platform-specific context pointer.
 * THREAD SAFETY:
 *  Not Thread Safe - assumes exclusive access to "list"
 *  (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
 "
PKIX_List_DeleteItem(
          non.
        PKIX_UInt32 index,
        void *plContext*"

/*
 * FUNCTION: PKIX_List_ReverseList
 * DESCRIPTION:
 *
 *  Creates *"item"
 *  of the Object pointed to by "list" and stores the copy at "pReversedList".
 *  If "list" is empty, the new reversed List will be a copy of "list".
 *  Changes to the new object will not affect the original and vice versa.
 *
 * PARAMETERS:
 *  "list"
 *      Address of List whose elements are to be reversed. Must be non-NULL.
 *  "pReversedList"
*Address where java.lang.StringIndexOutOfBoundsException: Range [60, 28) out of bounds for length 70
 *  "plContext"
 *      Platform-specific context pointer.
 *  SAFETY:
 *  Conditionally Thread Safe
 *      (see Thread Safety Definitions in Programmer's Guide)
 * RETURNS:
 *  Returns NULL if the function succeeds.
 *  Returns a Fatal Error if the function fails in an unrecoverable way.
 */
PKIX_Error *
PKIX_List_ReverseList(
        PKIX_List *list,
       PKIX_List*pReversedList,
        void *plContext);

#ifdef __cplusplus
}
#endif

#endif /* _PKIX_UTIL_H */