Index: lib/libpkix/include/pkix_util.h |
=================================================================== |
old mode 100755 |
new mode 100644 |
--- a/lib/libpkix/include/pkix_util.h |
+++ b/lib/libpkix/include/pkix_util.h |
@@ -58,23 +58,23 @@ extern "C" { |
* entries will then be logged using the specified Loggers. If multiple |
* Loggers are specified, every log entry will be logged with each of them. |
* |
* XXX Maybe give some guidance somewhere on how much detail each logging |
* level should have and where component boundaries should be. Maybe in |
* Implementor's Guide or Programmer's Guide. |
*/ |
-#define PKIX_LOGGER_LEVEL_TRACE 5 |
-#define PKIX_LOGGER_LEVEL_DEBUG 4 |
-#define PKIX_LOGGER_LEVEL_WARNING 3 |
-#define PKIX_LOGGER_LEVEL_ERROR 2 |
-#define PKIX_LOGGER_LEVEL_FATALERROR 1 |
+#define PKIX_LOGGER_LEVEL_TRACE 5 |
+#define PKIX_LOGGER_LEVEL_DEBUG 4 |
+#define PKIX_LOGGER_LEVEL_WARNING 3 |
+#define PKIX_LOGGER_LEVEL_ERROR 2 |
+#define PKIX_LOGGER_LEVEL_FATALERROR 1 |
-#define PKIX_LOGGER_LEVEL_MAX 5 |
+#define PKIX_LOGGER_LEVEL_MAX 5 |
/* |
* FUNCTION: PKIX_Logger_LogCallback |
* DESCRIPTION: |
* |
* This callback function logs a log entry containing the String pointed to |
* by "message", the integer value of logLevel, and the String pointed to by |
* "logComponent". A log entry can be associated with a particular log |
@@ -103,23 +103,21 @@ extern "C" { |
* |
* Multiple threads must be able to safely call this function without |
* 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. |
* Returns a Fatal Error if the 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); |
+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 |
@@ -137,22 +135,19 @@ typedef PKIX_Error * |
* Platform-specific context pointer. |
* THREAD SAFETY: |
* 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_Create( |
- PKIX_Logger_LogCallback callback, |
- PKIX_PL_Object *loggerContext, |
- PKIX_Logger **pLogger, |
- void *plContext); |
+PKIX_Error *PKIX_Logger_Create(PKIX_Logger_LogCallback callback, |
+ PKIX_PL_Object *loggerContext, |
+ PKIX_Logger **pLogger, void *plContext); |
/* |
* FUNCTION: PKIX_Logger_GetLogCallback |
* DESCRIPTION: |
* |
* Retrieves a pointer to "logger's" Log callback function and puts it in |
* "pCallback". |
* |
@@ -166,21 +161,19 @@ PKIX_Logger_Create( |
* Platform-specific context pointer. |
* THREAD SAFETY: |
* 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_GetLogCallback( |
- PKIX_Logger *logger, |
- PKIX_Logger_LogCallback *pCallback, |
- void *plContext); |
+PKIX_Error *PKIX_Logger_GetLogCallback(PKIX_Logger *logger, |
+ PKIX_Logger_LogCallback *pCallback, |
+ void *plContext); |
/* |
* FUNCTION: PKIX_Logger_GetLoggerContext |
* DESCRIPTION: |
* |
* Retrieves a pointer to a PKIX_PL_Object representing the context (if any) |
* of the Logger pointed to by "logger" and stores it at "pLoggerContext". |
* |
@@ -193,21 +186,19 @@ PKIX_Logger_GetLogCallback( |
* Platform-specific context pointer. |
* THREAD SAFETY: |
* 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_GetLoggerContext( |
- PKIX_Logger *logger, |
- PKIX_PL_Object **pLoggerContext, |
- void *plContext); |
+PKIX_Error *PKIX_Logger_GetLoggerContext(PKIX_Logger *logger, |
+ PKIX_PL_Object **pLoggerContext, |
+ void *plContext); |
/* |
* FUNCTION: PKIX_Logger_GetMaxLoggingLevel |
* DESCRIPTION: |
* |
* Retrieves a pointer to a PKIX_UInt32 representing the maximum logging |
* 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 |
@@ -224,21 +215,19 @@ PKIX_Logger_GetLoggerContext( |
* 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( |
- PKIX_Logger *logger, |
- PKIX_UInt32 *pLevel, |
- void *plContext); |
+PKIX_Error *PKIX_Logger_GetMaxLoggingLevel(PKIX_Logger *logger, |
+ PKIX_UInt32 *pLevel, |
+ void *plContext); |
/* |
* FUNCTION: PKIX_Logger_SetMaxLoggingLevel |
* DESCRIPTION: |
* |
* Sets the maximum logging level of the Logger pointed to by "logger" with |
* the integer value of "level". |
* |
@@ -253,21 +242,18 @@ PKIX_Logger_GetMaxLoggingLevel( |
* THREAD SAFETY: |
* Not Thread Safe - assumes exclusive access to "logger" |
* (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_SetMaxLoggingLevel( |
- PKIX_Logger *logger, |
- PKIX_UInt32 level, |
- void *plContext); |
+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 |
@@ -284,21 +270,19 @@ PKIX_Logger_SetMaxLoggingLevel( |
* 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_GetLoggingComponent( |
- PKIX_Logger *logger, |
- PKIX_ERRORCLASS *pComponent, |
- void *plContext); |
+PKIX_Error *PKIX_Logger_GetLoggingComponent(PKIX_Logger *logger, |
+ PKIX_ERRORCLASS *pComponent, |
+ void *plContext); |
/* |
* FUNCTION: PKIX_Logger_SetLoggingComponent |
* DESCRIPTION: |
* |
* Sets the logging component of the Logger pointed to by "logger" with the |
* PKIXERRORNUM pointed to by "component". To match a small set of components, |
* create a Logger for each. |
@@ -314,21 +298,19 @@ PKIX_Logger_GetLoggingComponent( |
* THREAD SAFETY: |
* Not Thread Safe - assumes exclusive access to "logger" |
* (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); |
+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 being used, this |
* function stores an empty List at "pLoggers". |
@@ -343,20 +325,18 @@ PKIX_Logger_SetLoggingComponent( |
* 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_GetLoggers( |
- PKIX_List **pLoggers, /* list of PKIX_Logger */ |
- void *plContext); |
+PKIX_Error *PKIX_GetLoggers(PKIX_List **pLoggers, /* list of PKIX_Logger */ |
+ void *plContext); |
/* |
* FUNCTION: PKIX_SetLoggers |
* DESCRIPTION: |
* |
* Sets the Loggers to be used by libpkix to the List of Loggers pointed to |
* by "loggers". If "loggers" is NULL, no Loggers will be used. |
* |
@@ -368,20 +348,18 @@ PKIX_GetLoggers( |
* THREAD SAFETY: |
* Not 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_SetLoggers( |
- PKIX_List *loggers, /* list of PKIX_Logger */ |
- void *plContext); |
+PKIX_Error *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 used by |
* libpkix. |
* |
@@ -393,20 +371,17 @@ PKIX_SetLoggers( |
* THREAD SAFETY: |
* Not 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_AddLogger( |
- PKIX_Logger *logger, |
- void *plContext); |
+PKIX_Error *PKIX_AddLogger(PKIX_Logger *logger, void *plContext); |
/* Functions pertaining to the PKIX_Error type */ |
/* Error |
* |
* An Error object is returned by a function upon encountering some error |
* condition. Each Error is associated with an errorCode specified in pkixt.h. |
* The remaining components of an Error are optional. An Error's description |
@@ -457,78 +432,67 @@ PKIX_AddLogger( |
* 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, |
- PKIX_ERRORCODE errCode, |
- PKIX_Error **pError, |
- void *plContext); |
+PKIX_Error *PKIX_Error_Create(PKIX_ERRORCLASS errClass, PKIX_Error *cause, |
+ PKIX_PL_Object *info, PKIX_ERRORCODE errCode, |
+ PKIX_Error **pError, void *plContext); |
/* |
* FUNCTION: PKIX_Error_GetErrorClass |
* DESCRIPTION: |
* |
- * Retrieves the error class of the Error pointed to by "error" and |
+ * 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. |
* 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_GetErrorClass( |
- PKIX_Error *error, |
- PKIX_ERRORCLASS *pClass, |
- void *plContext); |
+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 |
+ * Retrieves the error code of the Error pointed to by "error" and |
* stores it at "pCode". Supported error codes are defined in pkixt.h. |
* |
* 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. |
* 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_GetErrorCode( |
- PKIX_Error *error, |
- PKIX_ERRORCODE *pCode, |
- void *plContext); |
+PKIX_Error *PKIX_Error_GetErrorCode(PKIX_Error *error, PKIX_ERRORCODE *pCode, |
+ void *plContext); |
/* |
* FUNCTION: PKIX_Error_GetCause |
* DESCRIPTION: |
* |
* Retrieves the cause of the Error pointed to by "error" and stores it at |
* "pCause". If no cause was specified, NULL will be stored at "pCause". |
* |
@@ -541,21 +505,18 @@ PKIX_Error_GetErrorCode( |
* 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_GetCause( |
- PKIX_Error *error, |
- PKIX_Error **pCause, |
- void *plContext); |
+PKIX_Error *PKIX_Error_GetCause(PKIX_Error *error, PKIX_Error **pCause, |
+ void *plContext); |
/* |
* FUNCTION: PKIX_Error_GetSupplementaryInfo |
* DESCRIPTION: |
* |
* Retrieves the supplementary info of the Error pointed to by "error" and |
* stores it at "pInfo". |
* |
@@ -568,21 +529,19 @@ PKIX_Error_GetCause( |
* 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_GetSupplementaryInfo( |
- PKIX_Error *error, |
- PKIX_PL_Object **pInfo, |
- void *plContext); |
+PKIX_Error *PKIX_Error_GetSupplementaryInfo(PKIX_Error *error, |
+ PKIX_PL_Object **pInfo, |
+ void *plContext); |
/* |
* FUNCTION: PKIX_Error_GetDescription |
* DESCRIPTION: |
* |
* Retrieves the description of the Error pointed to by "error" and stores it |
* at "pDesc". If no description was specified, NULL will be stored at |
* "pDesc". |
@@ -596,21 +555,18 @@ PKIX_Error_GetSupplementaryInfo( |
* 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_GetDescription( |
- PKIX_Error *error, |
- PKIX_PL_String **pDesc, |
- void *plContext); |
+PKIX_Error *PKIX_Error_GetDescription(PKIX_Error *error, PKIX_PL_String **pDesc, |
+ void *plContext); |
/* PKIX_List |
* |
* Represents a collection of items. NULL is considered a valid item. |
*/ |
/* |
* FUNCTION: PKIX_List_Create |
@@ -626,20 +582,17 @@ PKIX_Error_GetDescription( |
* "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 a Fatal Error if the function fails in an unrecoverable way. |
*/ |
-PKIX_Error * |
-PKIX_List_Create( |
- PKIX_List **pList, |
- void *plContext); |
+PKIX_Error *PKIX_List_Create(PKIX_List **pList, void *plContext); |
/* |
* FUNCTION: PKIX_List_SetImmutable |
* DESCRIPTION: |
* |
* Sets the List pointed to by "list" to be immutable. If a caller tries to |
* change a List after it has been marked immutable (i.e. by calling |
* PKIX_List_AppendItem, PKIX_List_InsertItem, PKIX_List_SetItem, or |
@@ -652,20 +605,17 @@ PKIX_List_Create( |
* 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_SetImmutable( |
- PKIX_List *list, |
- void *plContext); |
+PKIX_Error *PKIX_List_SetImmutable(PKIX_List *list, void *plContext); |
/* |
* FUNCTION: PKIX_List_IsImmutable |
* DESCRIPTION: |
* |
* Checks whether the List pointed to by "list" is immutable and stores |
* the Boolean result at "pImmutable". If a caller tries to change a List |
* after it has been marked immutable (i.e. by calling PKIX_List_AppendItem, |
@@ -682,21 +632,18 @@ PKIX_List_SetImmutable( |
* 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 Fatal Error if the function fails in an unrecoverable way. |
*/ |
-PKIX_Error * |
-PKIX_List_IsImmutable( |
- PKIX_List *list, |
- PKIX_Boolean *pImmutable, |
- void *plContext); |
+PKIX_Error *PKIX_List_IsImmutable(PKIX_List *list, PKIX_Boolean *pImmutable, |
+ void *plContext); |
/* |
* FUNCTION: PKIX_List_GetLength |
* DESCRIPTION: |
* |
* Retrieves the length of the List pointed to by "list" and stores it at |
* "pLength". |
* |
@@ -709,21 +656,18 @@ PKIX_List_IsImmutable( |
* 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 Fatal Error if the function fails in an unrecoverable way. |
*/ |
-PKIX_Error * |
-PKIX_List_GetLength( |
- PKIX_List *list, |
- PKIX_UInt32 *pLength, |
- void *plContext); |
+PKIX_Error *PKIX_List_GetLength(PKIX_List *list, PKIX_UInt32 *pLength, |
+ void *plContext); |
/* |
* FUNCTION: PKIX_List_IsEmpty |
* DESCRIPTION: |
* |
* Checks whether the List pointed to by "list" is empty and stores |
* the Boolean result at "pEmpty". |
* |
@@ -736,21 +680,18 @@ PKIX_List_GetLength( |
* 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 Fatal Error if the function fails in an unrecoverable way. |
*/ |
-PKIX_Error * |
-PKIX_List_IsEmpty( |
- PKIX_List *list, |
- PKIX_Boolean *pEmpty, |
- void *plContext); |
+PKIX_Error *PKIX_List_IsEmpty(PKIX_List *list, PKIX_Boolean *pEmpty, |
+ void *plContext); |
/* |
* FUNCTION: PKIX_List_AppendItem |
* DESCRIPTION: |
* |
* Appends the Object pointed to by "item" after the last non-NULL item in |
* List pointed to by "list", if any. Note that a List may validly contain |
* NULL items. Appending "c" into the List ("a", NULL, "b", NULL) will result |
@@ -765,21 +706,18 @@ PKIX_List_IsEmpty( |
* 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); |
+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 the List pointed to by "list" |
* at the given "index". The index counts from zero and must be less than the |
* List's length. Existing list entries at or after this index will be moved |
@@ -798,22 +736,18 @@ PKIX_List_AppendItem( |
* 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_InsertItem( |
- PKIX_List *list, |
- PKIX_UInt32 index, |
- PKIX_PL_Object *item, |
- void *plContext); |
+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 counts from |
* zero and must be less than the list's length. Increments the reference |
* count on the returned object, if non-NULL. |
@@ -829,22 +763,18 @@ PKIX_List_InsertItem( |
* 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 Fatal Error if the function fails in an unrecoverable way. |
*/ |
-PKIX_Error * |
-PKIX_List_GetItem( |
- PKIX_List *list, |
- PKIX_UInt32 index, |
- PKIX_PL_Object **pItem, |
- void *plContext); |
+PKIX_Error *PKIX_List_GetItem(PKIX_List *list, PKIX_UInt32 index, |
+ PKIX_PL_Object **pItem, void *plContext); |
/* |
* FUNCTION: PKIX_List_SetItem |
* DESCRIPTION: |
* |
* Sets the item at "index" of the List pointed to by "list" with the Object |
* pointed to by "item". The index counts from zero and must be less than the |
* List's length. The previous entry at this index will have its reference |
@@ -862,22 +792,18 @@ PKIX_List_GetItem( |
* 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); |
+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" from the List pointed to by "list". The index |
* counts from zero and must be less than the List's length. Note that this |
* function does not destroy the List. It simply decrements the reference |
* count of the item at "index" in the List, deletes that item from the list |
@@ -894,21 +820,18 @@ PKIX_List_SetItem( |
* 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_DeleteItem( |
- PKIX_List *list, |
- PKIX_UInt32 index, |
- void *plContext); |
+PKIX_Error *PKIX_List_DeleteItem(PKIX_List *list, PKIX_UInt32 index, |
+ void *plContext); |
/* |
* FUNCTION: PKIX_List_ReverseList |
* DESCRIPTION: |
* |
* Creates a new List whose elements are in the reverse order as the elements |
* 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". |
@@ -923,19 +846,16 @@ PKIX_List_DeleteItem( |
* 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 Fatal Error if the function fails in an unrecoverable way. |
*/ |
-PKIX_Error * |
-PKIX_List_ReverseList( |
- PKIX_List *list, |
- PKIX_List **pReversedList, |
- void *plContext); |
+PKIX_Error *PKIX_List_ReverseList(PKIX_List *list, PKIX_List **pReversedList, |
+ void *plContext); |
#ifdef __cplusplus |
} |
#endif |
#endif /* _PKIX_UTIL_H */ |