librtasevent_src/rtas_srcfru.c File Reference

RTAS SRC/FRU sections routines. More...

#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <errno.h>
#include "librtasevent.h"
#include "rtas_event.h"
#include "rtas_src_codes.c"

Functions
static struct rtas_fru_hdr *	parse_fru_id_scn (struct rtas_event *re)
	Parse a FRU Identity Substructure.
static struct rtas_fru_hdr *	parse_fru_pe_scn (struct rtas_event *re)
	parse a FRU Power Enclosure Identity Substructure
static struct rtas_fru_hdr *	parse_fru_mr_scn (struct rtas_event *re)
	parse a FRU Manufacturing Replaceable Unit Substructure
int	parse_src_scn (struct rtas_event *re)
	parse a version 6 rtas SRC section
struct rtas_src_scn *	rtas_get_src_scn (struct rtas_event *re)
	retrieve the RTAS src section for a RTAS event
static int	print_fru_hdr (struct rtas_fru_hdr *fruhdr, int verbosity)
	print the contents of a FRU header
static int	print_fru_priority (char priority)
	decode the FRU prority level and print a description of it.
static int	print_fru_id_scn (struct rtas_fru_hdr *fruhdr, int verbosity)
static int	print_fru_pe_scn (struct rtas_fru_hdr *fruhdr, int verbosity)
static int	print_fru_mr_scn (struct rtas_fru_hdr *fruhdr, int verbosity)
int	print_re_fru_scn (struct rtas_fru_scn *fru, int verbosity, int count)
	print the contents of an FRU section
int	print_src_refcode (struct rtas_src_scn *src)
	print a detailed description of the SRC reference code
int	print_re_src_scn (struct scn_header *shdr, int verbosity)
	print the contents of a SRC section

---

Detailed Description

Copyright (C) 2005 IBM Corporation Common Public License Version 1.0 (see COPYRIGHT)

Author:

Nathan Fontenot <nfont@austin.ibm.com>

---

Function Documentation

static struct rtas_fru_hdr* parse_fru_id_scn

(

struct rtas_event *

re

)

[static, read]

parse_fru_id_scn

Parameters:

re

rtas_event pointer

Returns:

pointer to parsed rtas_fru_id_scn, NULL on failure

References rtas_fru_id_scn::ccin, fruid_has_ccin, fruid_has_part_no, fruid_has_proc_id, fruid_has_serial_no, rtas_event::offset, rtas_fru_id_scn::part_no, rtas_fru_id_scn::procedure_id, RE_EVENT_OFFSET, RE_FRU_HDR_OFFSET, RE_FRU_HDR_SZ, rtas_copy(), and rtas_fru_id_scn::serial_no.

Referenced by parse_src_scn().

static struct rtas_fru_hdr* parse_fru_mr_scn

(

struct rtas_event *

re

)

[static, read]

parse_fru_mr_scn

Parameters:

re

rtas_event pointer

Returns:

pointer to parsed rtas_fru_mr_scn, NULL on failure

References rtas_fru_mr_scn::fruhdr, rtas_fru_hdr::length, RE_FRU_HDR_OFFSET, RE_FRU_HDR_SZ, and rtas_copy().

Referenced by parse_src_scn().

static struct rtas_fru_hdr* parse_fru_pe_scn

(

struct rtas_event *

re

)

[static, read]

parse_fru_pe_scn

Parameters:

re

rtas_event pointer

Returns:

pointer to parsed rtas_fru_pe_scn, NULL on failure

References rtas_fru_pe_scn::fruhdr, rtas_fru_hdr::length, RE_FRU_HDR_OFFSET, RE_FRU_HDR_SZ, and rtas_copy().

Referenced by parse_src_scn().

int parse_src_scn

(

struct rtas_event *

re

)

parse_v6_src_scn

Parameters:

	re	rtas_event pointer
	src_start	pointer to beginning of SRC section

Returns:

0 on success, !0 on failure

References add_re_scn(), rtas_event::buffer, cleanup_rtas_event(), rtas_src_scn::fru_scns, rtas_fru_scn::length, rtas_fru_scn::loc_code, rtas_fru_scn::loc_code_length, rtas_fru_scn::next, rtas_fru_hdr::next, rtas_event::offset, parse_fru_id_scn(), parse_fru_mr_scn(), parse_fru_pe_scn(), scn_header::raw_offset, RE_FRU_SCN_SZ, re_scn_id(), RE_SHDR_OFFSET, RE_SRC_SCN_SZ, RE_SRC_SUBSCN_SZ, rtas_copy(), rtas_src_scn::shdr, src_subscns_included, rtas_src_scn::subscn_length, rtas_fru_scn::subscns, and rtas_src_scn::v6hdr.

Referenced by parse_v6_rtas_event().

static int print_fru_hdr	(	struct rtas_fru_hdr *	fruhdr,
		int	verbosity
	)			[static]

print_fru_hdr

Parameters:

	fruhdr	pointer to fru_hdr to print
	verbosity	verbose level

Returns:

the number of bytes printed

References rtas_fru_hdr::flags, rtas_fru_hdr::id, rtas_fru_hdr::length, PRNT_FMT_R, and rtas_print().

Referenced by print_fru_id_scn(), print_fru_mr_scn(), and print_fru_pe_scn().

static int print_fru_id_scn	(	struct rtas_fru_hdr *	fruhdr,
		int	verbosity
	)			[static]

print_fru_id_scn print the contents of a FRU Identity substructure

Parameters:

	fruhdr	pointer to the fru_hdr of the FRU ID section to print
	verbosity	verbose level

Returns:

the number of bytes printed

References rtas_fru_id_scn::ccin, rtas_fru_hdr::flags, rtas_fru_id_scn::fruhdr, fruid_has_ccin, fruid_has_part_no, fruid_has_proc_id, fruid_has_serial_no, rtas_fru_id_scn::part_no, print_fru_hdr(), print_scn_title(), PRNT_FMT, rtas_fru_id_scn::procedure_id, RTAS_FRUID_COMP_CODE, RTAS_FRUID_COMP_CONFIG_ERROR, RTAS_FRUID_COMP_EXTERNAL, RTAS_FRUID_COMP_EXTERNAL_CODE, RTAS_FRUID_COMP_HARDWARE, RTAS_FRUID_COMP_MAINT_REQUIRED, RTAS_FRUID_COMP_MASK, RTAS_FRUID_COMP_SYMBOLIC, RTAS_FRUID_COMP_TOOL, rtas_print(), and rtas_fru_id_scn::serial_no.

Referenced by print_re_fru_scn().

static int print_fru_mr_scn	(	struct rtas_fru_hdr *	fruhdr,
		int	verbosity
	)			[static]

print_fru_mr_scn print the contents of a FRU Manufacturing Replaceable substructure

Parameters:

	fruhdr	pointer to the fru_hdr of the FRU MR section to print
	verbosity	verbose level

Returns:

the number of bytes printed

References frumr_num_callouts, fru_mru::id, rtas_fru_mr_scn::mrus, print_fru_hdr(), print_scn_title(), fru_mru::priority, and rtas_print().

Referenced by print_re_fru_scn().

static int print_fru_pe_scn	(	struct rtas_fru_hdr *	fruhdr,
		int	verbosity
	)			[static]

print_fru_pe_scn print the contents of a FRU Power Enclosure substructure

Parameters:

	fruhdr	pointer to the fru_hdr of the FRU PE section to print
	verbosity	verbose level

Returns:

the number of bytes printed

References rtas_fru_pe_scn::pce_mtms, rtas_fru_pe_scn::pce_name, print_fru_hdr(), print_mtms(), print_scn_title(), and rtas_print().

Referenced by print_re_fru_scn().

static int print_fru_priority

(

char

priority

)

[static]

print_fru_priority

Parameters:

priority

Returns:

the number of bytes printed

References RTAS_FRU_PRIORITY_HIGH, RTAS_FRU_PRIORITY_LOW, RTAS_FRU_PRIORITY_MEDIUM, RTAS_FRU_PRIORITY_MEDIUM_A, RTAS_FRU_PRIORITY_MEDIUM_B, RTAS_FRU_PRIORITY_MEDIUM_C, and rtas_print().

Referenced by print_re_fru_scn().

int print_re_fru_scn	(	struct rtas_fru_scn *	fru,
		int	verbosity,
		int	count
	)

print_re_fru_scn

Parameters:

	res	rtas_event_scn pointer for a fru section
	verbosity	verbose level of output
	count	current fru section number that we are printing

Returns:

number of bytes written

References rtas_fru_scn::fru_id_included, rtas_fru_scn::fru_subscn_included, rtas_fru_hdr::id, rtas_fru_scn::length, rtas_fru_scn::loc_code, rtas_fru_scn::loc_code_length, rtas_fru_hdr::next, print_fru_id_scn(), print_fru_mr_scn(), print_fru_pe_scn(), print_fru_priority(), print_scn_title(), rtas_fru_scn::priority, PRNT_FMT_2, PRNT_FMT_R, rtas_print(), rtas_fru_scn::subscns, and rtas_fru_scn::type.

Referenced by print_re_src_scn().

int print_re_src_scn	(	struct scn_header *	shdr,
		int	verbosity
	)

print_re_src_scn

Parameters:

	res	rtas_event_scn pointer for SRC section
	verbosity	verbose level of output

Returns:

number of bytes written

References rtas_src_scn::ext_refcode2, rtas_src_scn::ext_refcode3, rtas_src_scn::ext_refcode4, rtas_src_scn::ext_refcode5, rtas_src_scn::ext_refcode6, rtas_src_scn::ext_refcode7, rtas_src_scn::ext_refcode8, rtas_src_scn::ext_refcode9, rtas_src_scn::fru_scns, rtas_v6_hdr::id, rtas_fru_scn::next, print_raw_data(), print_re_fru_scn(), print_src_refcode(), print_v6_hdr(), PRNT_FMT_2, PRNT_FMT_R, rtas_print(), RTAS_PSRC_SCN, RTAS_PSRC_SCN_ID, RTAS_SSRC_SCN, scn_header::scn_id, rtas_src_scn::src_platform_data, src_subscns_included, rtas_src_scn::subscn_id, rtas_src_scn::subscn_length, rtas_src_scn::subscn_platform_data, rtas_src_scn::v6hdr, and rtas_src_scn::version.

int print_src_refcode

(

struct rtas_src_scn *

src

)

print_src_refcode

Parameters:

src

rtas_v6_src_scn pointer

Returns:

number of bytes written

References src_code::id, rtas_src_scn::primary_refcode, rtas_print(), and src_codes.

Referenced by print_re_src_scn().

struct rtas_src_scn* rtas_get_src_scn

(

struct rtas_event *

re

)

[read]

rtas_get_src_scn

Parameters:

re

rtas_event pointer

Returns:

rtas_event_scn pointer for a SRC section

References get_re_scn(), and RTAS_PSRC_SCN.