Instruction Manual

SWID Server Interface
Software Identification (SWID) User’s Guide—527243-004
6-6
Using SWID as a Server
The fptver field indicates the version of the fingerprint to be computed. The following
table gives the possible values for fptver:
The fpttype field indicates the type of the fingerprint to be computed. The following
table gives the possible values for fpttype:
If the file does not exist, SWID replies with ReplyLen = 0 and Reply Error = 0.
If filename is invalid, SWID replies with ReplyLen = 0 and Reply Error = 13.
The rectype of the SWID-TO-REC is determined by the switches used during startup
and remains the same during the life of the server. The rectype is either default or
dv.
Value Meaning
-1 SWID computes the latest (max) version of the fingerprint that is supported by
the current version of SWID based on the file code.
0 SWID computes the same fingerprint as the original fingerprint for a file. If the
original fingerprint is not available or is suppressed, SWID computes the latest
version of the fingerprint. If the original fingerprint version is higher than the
latest (max) version supported by the current version of SWID for the file code,
the fingerprint is not computed and error -1 (perror -1 and serror 3) is returned
(perror and serror are fields in the FO-REC record structure.)
The fingerprint returned when a value of 0 is specified is defined as the
DEFAULT VERSION.
1 SWID returns the Version 1 fingerprint. It is available for all file codes, and is
the same as the fingerprints computed by SWID T9298AAI.
2 SWID returns the Version 2 fingerprint. This fingerprint is available for file
codes 100 and 800, file code 180 ZREG files, and file code 0 OSIMAGE files.
For other file codes, error -1 (perror -1 and serror 1) is returned.
other values Error -1 (perror -1 and serror 1) is returned.
Value Meaning
0
Ordinary fingerprint. Applies to all file codes. Also defined as the
DEFAULT TYPE.
1
This fingerprint type applies to file code 100 and 800 loadfiles when
fingerprint Version 2 or higher is requested, and to file code 700
executable ELF files when fingerprint Version 1 or higher is requested.
This fingerprint type is not applicable to code 700 COFF files. If a file
is not a code 100, 700 (ELF format), or 800 file, error -1 (perror -1 and
serror 2) is returned. perror and serror are fields in the FO-REC record
structure).
63
Invalid file format fingerprint. Applies only to code 0 OSIMAGE files
and other code 0 files. If a file is not a code 0 file, error -1 (perror -1
and serror 2) is returned.
other
values
Error -1 (perror -1 and serror 2) is returned.