Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 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).