[fm-discuss] 2007/201 Stability Level Change For FMA I/O Fault Services DDI Interfaces

Cynthia McGuire cindi at sun.com
Fri Apr 6 10:50:02 PDT 2007


I am sponsoring the following fasttrack on behalf of Stephen Hanson. 
This case changes (increases) the stability level for the FMA IO Fault
Service interfaces.  The release binding remains patch.  New man pages 
are also been supplied to align the documentation of the interfaces with 
the actual implementation.

The interfaces as documented in the man pages are already integrated 
into S10U4, Nevada and OpenSolaris.  Plans are underway to update the 
Writing Device Drivers guide and supply man pages.

A standard 1 week timer is set to expire on 04/13/2007 and note that 
this case is externally visible.

Cindi

This information is Copyright 2007 Sun Microsystems
1. Introduction
     1.1. Project/Component Working Name:
          Stability Level Change For FMA I/O Fault Services DDI Interfaces
     1.2. Name of Document Author/Supplier:
          Author:  Stephen Hanson
     1.3  Date of This Document:
         05 April, 2007

4. Technical Description

This case relates to the following FMA I/O Fault Services DDI interfaces

ddi_fm_init()                   - defined in PSARC/2002/288 (updated 
2004/259)
ddi_fm_fini()                   - defined in PSARC/2002/288
ddi_fm_capable()                - defined in PSARC/2002/288
ddi_fm_handler_register()       - defined in PSARC/2002/288
ddi_fm_handler_unregister()     - defined in PSARC/2002/288
ddi_fm_error                    - defined in PSARC/2002/288 (updated 
2004/701)
ddi_fm_acc_err_get()            - defined in PSARC/2002/288
ddi_fm_dma_err_get()            - defined in PSARC/2002/288
ddi_fm_ereport_post()           - defined in PSARC/2002/288
ddi_fm_service_impact()         - defined in PSARC/2002/288
pci_ereport_setup()             - defined in PSARC/2004/391 (updated 
2004/701)
pci_ereport_teardown()          - defined in PSARC/2004/391 (updated 
2004/701)
pci_ereport_post()              - defined in PSARC/2004/391 (updated 
2004/701)
ddi_fm_acc_err_clear()          - defined in PSARC/2006/217
ddi_fm_dma_err_clear()          - defined in PSARC/2006/217
DDI_FM_NOT_CAPABLE              - defined in PSARC/2002/288
DDI_FM_EREPORT_CAPABLE          - defined in PSARC/2002/288
DDI_FM_ACCCHK_CAPABLE           - defined in PSARC/2002/288
DDI_FM_DMACHK_CAPABLE           - defined in PSARC/2002/288
DDI_FM_ERRCB_CAPABLE            - defined in PSARC/2004/259
DDI_FM_OK                       - defined in PSARC/2002/288
DDI_FM_FATAL                    - defined in PSARC/2002/288
DDI_FM_NONFATAL                 - defined in PSARC/2002/288
DDI_FM_UNKNOWN                  - defined in PSARC/2002/288
DDI_FM_ERR_EXPECTED             - defined in PSARC/2002/288
DDI_FM_ERR_UNEXPECTED           - defined in PSARC/2002/288
DDI_FM_ERR_POKE                 - defined in PSARC/2004/701
DDI_FM_ERR_PEEK                 - defined in PSARC/2004/701
DDI_FM_DEVICE                   - defined in PSARC/2006/258
DDI_FM_DEVICE_INVAL_STATE       - defined in PSARC/2006/258
DDI_FM_DEVICE_NO_RESPONSE       - defined in PSARC/2006/258
DDI_FM_DEVICE_STALL             - defined in PSARC/2006/258
DDI_FM_DEVICE_BADINT_LIMIT      - defined in PSARC/2006/258
DDI_FM_DEVICE_INTERN_CORR       - defined in PSARC/2006/258
DDI_FM_DEVICE_INTERN_UNCORR     - defined in PSARC/2006/258


These interfaces were all given the stability level of "Consolidation 
Private". We would now like to increase the stability level to 
"Committed", so that external device driver writers can use these 
interfaces.

Latest manpages for the these interfaces are attached. For completeness 
updated manpages for the following are also included (though these 
changes were already given a stability level of "Evolving").

ddi_dma_attr                    - updated in PSARC/2000/264
ddi_device_acc_attr             - updated in PSARC/2000/264


The full definition of the DDI_FM_DEVICE* ereport events are attached 
and are archived at http://events.central/event/FMA//ereport/io/device.

The pci_ereport_post() function will generate ereports on behalf of the 
driver for any generic pci, pci/x or pci express configuration space 
error bits found. These events are not part of the DDI and the driver 
itself does not need to be aware of them, but we would also like to 
increase their stability level to "Uncommitted".  The definition of 
these ereport events are attached and are archived at

http://events.central/event/FMA//ereport/io/pci,
http://events.central/event/FMA//ereport/io/pcix and
http://events.central/event/FMA//ereport/io/pciex respectively.

6. Resources and Schedule
     6.4. Steering Committee requested information
    	6.4.1. Consolidation C-team Name:
		ON
     6.5. ARC review type: FastTrack
-------------- next part --------------
A non-text attachment was scrubbed...
Name: manpages
Type: application/text
Size: 43051 bytes
Desc: not available
Url : http://oss-beta1.opensolaris.org/pipermail/fm-discuss/attachments/20070406/ad84b0e0/attachment.bin 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://oss-beta1.opensolaris.org/pipermail/fm-discuss/attachments/20070406/ad84b0e0/attachment.html 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://oss-beta1.opensolaris.org/pipermail/fm-discuss/attachments/20070406/ad84b0e0/attachment-0001.html 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://oss-beta1.opensolaris.org/pipermail/fm-discuss/attachments/20070406/ad84b0e0/attachment-0002.html 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://oss-beta1.opensolaris.org/pipermail/fm-discuss/attachments/20070406/ad84b0e0/attachment-0003.html 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://oss-beta1.opensolaris.org/pipermail/fm-discuss/attachments/20070406/ad84b0e0/attachment-0004.html 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://oss-beta1.opensolaris.org/pipermail/fm-discuss/attachments/20070406/ad84b0e0/attachment-0005.html 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://oss-beta1.opensolaris.org/pipermail/fm-discuss/attachments/20070406/ad84b0e0/attachment-0006.html 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://oss-beta1.opensolaris.org/pipermail/fm-discuss/attachments/20070406/ad84b0e0/attachment-0007.html 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://oss-beta1.opensolaris.org/pipermail/fm-discuss/attachments/20070406/ad84b0e0/attachment-0008.html 


More information about the fm-discuss mailing list