beautypg.com

In file, Out file, Files to be fingerprinted – HP Integrity NonStop H-Series User Manual

Page 24: Error reporting

background image

Running SWID

Software Identification (SWID) User’s Guide527243-004

2 -6

IN File

When executed, the SWID process runs under the Guardian user ID of the invoker
unless the PROGID has been set. Any file access requested by SWID is controlled by
Guardian. (If SWID tries to open a file that does not allow the user read access, SWID
receives a security error 48.)

IN File

SWID must have read access to the IN file. SWID abends if it gets an I/O error on the
IN file and opens the IN file in read-only, shared mode.

OUT File

SWID opens its OUT file in read-write exclusive mode. SWID abends if it cannot open
its OUT file. SWID output is described in further detail in

Section 5, SWID Formatted

Output

.

Files to Be Fingerprinted

SWID can fingerprint any file in the Enscribe file system. However, it cannot fingerprint
files in the SQL file system, compression files (code 991), and self-extracting object
files.

swid opens the file to be fingerprinted in read-only shared mode for structured access.

When a file is protected by Safeguard software, SWID gets an error trying to open the
file if the SWID process user ID has no read access to the file.

In the case of an audited file, SWID does not get an error because it opens the input
files in read-only, shared mode.

In the case of partitioned files, when a primary partition file is input to SWID, it
computes the fingerprint by reading the primary as well as all secondary partitions.
However, when a secondary partitioned file is input to SWID, it computes the
fingerprint by reading only that partition.

Error Reporting

SWID does not log any messages into the Event Management Service (EMS). SWID
logs errors into its own OUT file like any other NonStop utility program.

If SWID encounters an error, it outputs a meaningful error message in place of the
fingerprint. The text message consists of two parts: one that reflects the error and

Note.

Set

the PROGID to change the SWID process access ID to super ID, so that SWID can

read and compute the fingerprint of any file on the system.

SWID requires only read access to

files.

Note. SWID cannot compute a fingerprint for a key-sequenced file if any of the alternate key
files do not exist.

This manual is related to the following products: