sefdata(4)

NAME
     sefdata - Collects System Error Facility (SEF) data for
     SAM-QFS file systems

SYNOPSIS
     /var/opt/SUNWsamfs/sef/sefdata

     #include "/opt/SUNWsamfs/include/sefvals.h"

     #include "/opt/SUNWsamfs/include/sefstructs.h"

AVAILABILITY
     SUNWsamfs

DESCRIPTION
     The sefdata file contains the data gathered from the log
     sense pages of peripheral tape devices used by SAM-QFS file
     systems.  Each time the SAM-QFS software unloads a cartridge
     from a drive, pertinent log sense pages are obtained from
     the device, and a record is written to the sefdata file.
     Each record consists of a header followed by some number of
     log sense pages.

     The record header has the format of a sef_hdr structure.
     This structure is defined in
     /opt/SUNWsamfs/include/sefstructs.h, and it has the
     following components:

     struct sef_hdr {
         uint_t      sef_magic;          /* magic # for app to sync file posn */
         uint_t      sef_version;        /* version number */
         uint_t      sef_size;           /* size of this record, excl. header */
         uint16_t    sef_eq;             /* equipment number of this device */
         char        sef_devname[128];   /* pathname of device */
         uchar_t     sef_vendor_id[9];   /* vendor id from inquiry */
         uchar_t     sef_product_id[17]; /* product id from inquiry */
         uchar_t     sef_revision[5];    /* revision level from inquiry */
         uchar_t     sef_scsi_type;      /* device type from inquiry */
         vsn_t       sef_vsn;            /* vsn of media that was mounted */
         time_t      sef_timestamp;      /* timestamp of this record */
     }

     The fields of the sef_hdr structure have the following
     meanings:

     Field          Content

     sef_magic      Has the value SEFMAGIC, as defined in
                    /opt/SUNWsamfs/include/sefvals.h.

     sef_version    Has the value SEFVERSION, as defined in
                    /opt/SUNWsamfs/include/sefvals.h.

     sef_size       The size of this record, excluding the
                    header.

     sef_eq         The equipment number of the device, as
                    configured in the mcf file.  For more
                    information, see the mcf(4) man page.

     sef_devname    A character string containing the path name
                    of the device.

     sef_vendor_id  The vendor identification of the device, as
                    obtained from inquiry.

     sef_product_id The product identification of the device, as
                    obtained from inquiry.

     sef_revision   The revision level of the device, as obtained
                    from inquiry.

     sef_scsi_type  The device type, as obtained from inquiry.

     sef_vsn        Volume Serial Name (VSN) of the volume
                    mounted in the device when the data was
                    generated.

     sef_timestamp  Time that this record as written to the data
                    file.

     Following the header in each record is some number of log
     sense pages.  Each log sense page consists of a
     SCSI-standard header followed by triplets of parameter
     codes, control values, and parameter values.  For the exact
     format of the log sense pages returned by the devices in use
     at your site, consult the documentation provided with those
     devices.

FILES
     File                Purpose

     /var/opt/SUNWsamfs/sef/sefdata
                         Contains SEF information.

     /opt/SUNWsamfs/include/sefvals.h
                         Contains values, such as those for
                         SEFMAGIC and SEFVERSION.

     /opt/SUNWsamfs/include/sefstructs.h
                         Contains include files for the SEF
                         header, the SCSI-standard header, and
                         other structures.

SEE ALSO
     Sun Storage Archive Manager Configuration and Administration
     Guide.
     sefreport(1M), sefsysevent(4).