Safeguard Management Programming Manual (G06.29+, H06.08+, J06.03+)

Safeguard Management Programming Manual—422086-028
B-1
B
Example of Sharing a Binary
Description Field
The binary description field associated with a user or alias authentication record can be
shared among multiple vendors. The field structure provides subfields for a vendor-ID,
length, and data. Vendors must cooperate on the use of this field. HP assigns and
maintains vendor IDs. Following is an example of code for sharing a user/alias binary
description field among multiple vendors.
Structure vendor will be stored in a binary description field for a Safeguard user/alias
authentication record.
struct vendor
{
char ssid[SSID_LENGTH];
int length;
char info[DATA_LENGTH];
}v[2];
Structure vendor contains:
•
The subsystem ID in the character array ssid.
•
The description data in the character array info.
•
The length of the binary description field.
These values will be determined by the individual vendors.
User/alias binary description data will be stored in buffer BinaryBuf, which is of type
spi_string. spi_string is defined as:
typedef struct {
short length;
char string[2048];
}spi_string;
spi_string BinaryBuf;
The code for sharing the binary description field among multiple vendors is shown in
the following steps:
1. Fill BinaryBuf with the first vendor’s information:
memset((char*)&v[0], ’0’sizeof(v[0]));
strcpy(v[0].ssid, "TANDEM ");
v[0].length = 217;
v[0].info[0] = 2;
v[0].info[1] = 27;
Note. The binary description field is supported only on systems running G06.27 and later
G-series RVUs and H06.06 and later H-series RVUs.