User`s manual

sfw_getrev()

SBCSCSI/D1 3-11

sfw_getrev()

NAME

sfw_getrev Ñ Return Firmware Revision String

SYNOPSIS

#include "scsi.h" /* SCSI specific definitions */

#include "ncr.h" /* firmware structure definitions */

#include "ncr710.h" /* hardware/firmware specific definitions */

#include "scsi_err.h" /* error definitions */

UINT sfw_getrev(string_buffer, max_size);

UCHAR *string_buffer; /* revision string is placed here */

UINT max_size; /* number of bytes available in string_buffer */

DESCRIPTION

The sfw_getrev() entry point provides a release ID string that identifies the

Firmware. The calling application provides a pointer to MPU-writable

memory and the number of bytes available there.

Up to max_size bytes are written into the string_buffer. sfw_getrev()

always returns the number of bytes available. If the number of bytes available

is not greater than max_size, then the return value is just the same as the

number of bytes written. A return value of greater than max_size means that

the given number of bytes are available, but that only max_size will have

been written into the buffer.

RETURN VALUE

The number of bytes of Firmware identification that are available.

ERROR CONDITIONS

none