Devuelve entradas de registro de errores.
#include <diag/diag.h>
int error_log_get ( option, criteria, err_data )
int option;
char *criteria;
struct errdata *err_data;
La subrutina error_log_get permite a la aplicación de diagnóstico (DA) consultar las entradas en el registro de errores.
Detalles de la implementación
La opción NVRAMEL solo está soportada en la plataforma basada en el procesador POWER ®:
| Parámetro |
Descripción |
| opción |
Describe la operación que se va a realizar. Se definen los valores siguientes:
- INIC
- Inicializa la recuperación del registro de errores.
- SUBSEQ
- Obtiene la siguiente entrada de registro de errores.
- TERMI
- Finaliza la recuperación del registro de errores.
- NVRAMEL
- Utilice el registro de errores de NVRAM como origen para la recuperación del registro de errores. Solo están disponibles los siguientes miembros de struct errdata cuando el registro de errores se obtiene de NVRAM:
- time_stamp
- id_error
- recurso
- long_datos_detallado
- datos_detalles
Nota: Esta opción sólo está soportada en la plataforma basada en el procesador POWER ®.
- INIT_IGNORE_LRA
- Intializa la recuperación del registro de errores y no se detiene cuando se alcanza una entrada REPLACED_FRU. Además, se pueden devolver entradas REPLACED_FRU en el parámetro err_data. Las llamadas SUBSEQ que siguen a INIT_IGNORE_LRA tampoco se detienen cuando se alcanza una entrada REPLACED_FRU.
- INIT_NEW_ONLY
- Inicializa la recuperación del registro de errores y devuelve la primera entrada del registro de errores que coincide con los criterios que no han sido analizados previamente por los diagnósticos.
- SUBSEQ_NEW_ONLY
- Obtiene la siguiente entrada de registro de errores que coincide con los criterios que no han sido analizados previamente por los diagnósticos.
|
| criterios |
Se utiliza con la opción INIT para especificar para qué dispositivo se deben obtener los datos del registro de errores y hasta qué punto se debe realizar la búsqueda. Este parámetro se puede establecer en cualquier opción válida utilizada por el mandato errpt . Cuando se utiliza con la opción NVRAMEL , puede ser una lista de nombres de recursos (con el conmutador -N ) o un ID de error (con el conmutador -j ), pero no ambos.
|
| estructurar datos de error |
Tipo de datos que contiene los siguientes datos rellenados para que los utilice el DA.
struct errdata {
unsigned sequence; /* sequence number of entry */
unsigned time_stamp; /* entry time stamp */
unsigned err_id; /* error ID code */
char *machine_id; /* machine ID */
char *node_id; /* node */
char *class; /* H=hardware, S=software */
char *type; /* PERM,TEMP,PERF,PEND,UNKN */
char *resource; /* Configured device name */
char *vpd_data; /* VPD info */
char *conn_where; /* connwhere field of CuDv */
char *location; /* location field of CuDv */
unsigned detail_data_len; /* length of detail data */
char *detail_data; /* detail data */
|
Los valores de retorno dependen de la opción realizada:
| Valor de retorno |
Descripción |
| init |
- 0
- Sin error
- 1
- Error-entrada de registro disponible
- -1
- Error al obtener datos
|
| SUBSEQ |
- 0
- No hay más entradas disponibles
- 1
- Error-entrada de registro disponible
0: |
| TERMI |
- 0
- Terminación satisfactoria
|
| NVRAMEL |
- 0
- No hay entradas que coincidan con los criterios
- 1
- Error-entrada de registro disponible
- -1
- Error al acceder a NVRAM
- -2
- Criterios no válidos
0: |
| INIT_IGNORE_LRA |
- 0
- Ningún error
- 1
- Error-entrada de registro disponible
- -1
- Error al obtener datos
|
| INIT_NEW_ONLY |
- 0
- Ningún error
- 1
- Entrada de registro de errores disponible y no se ha omitido ninguna entrada analizada anteriormente.
- 2
- Se ha omitido la entrada de registro de errores disponible y al menos una entrada analizada anteriormente.
|
| SUBSEQ_NEW_ONLY |
- 0
- No hay más entradas disponibles
- 1
- Entrada de registro de errores disponible y no se ha omitido ninguna entrada analizada anteriormente.
- 2
- Se ha omitido la entrada de registro de errores disponible y al menos una entrada analizada anteriormente.
|