Print this page 
4630 clean stale references to ddi_iopb_alloc and ddi_iopb_free
4634 undocument scsi_hba_attach() and ddi_dma_lim(9s)
Split Close
Expand all
Collapse all
          --- old/usr/src/uts/common/sys/sunddi.h
          +++ new/usr/src/uts/common/sys/sunddi.h
↓ open down ↓ 1211 lines elided ↑ open up ↑ 
1212 1212   * (both for I/O, as described by the handle, and the IU, via, e.g.
1213 1213   * a call to ddi_dma_kvaddrp), and one mapping may have been
1214 1214   * used to modify the memory object, this function must be called
1215 1215   * to ensure that the modification of the memory object is
1216 1216   * complete, as well as possibly to inform other mappings of
1217 1217   * the object that any cached references to the object are
1218 1218   * now stale (and flush or invalidate these stale cache references
1219 1219   * as necessary).
1220 1220   *
1221 1221   * The function ddi_dma_sync() provides the general interface with
1222      - * respect to this capability. Generally, ddi_dma_free() (below) may
1223      - * be used in preference to ddi_dma_sync() as ddi_dma_free() calls
     1222 + * respect to this capability. Generally, ddi_dma_unbind_handle()
     1223 + * (below) may be used in preference to ddi_dma_sync() as it calls
1224 1224   * ddi_dma_sync().
1225 1225   *
1226 1226   * Returns 0 if all caches that exist and are specified by cache_flags
1227 1227   * are successfully operated on, else -1.
1228 1228   *
1229 1229   * The argument offset specifies an offset into the mapping of the mapped
1230 1230   * object in which to perform the synchronization. It will be silently
1231 1231   * truncated to the granularity of underlying cache line sizes as
1232 1232   * appropriate.
1233 1233   *
↓ open down ↓ 4 lines elided ↑ open up ↑ 
1238 1238   * sizes  as appropriate.
1239 1239   *
1240 1240   * The argument flags specifies what to synchronize (the device's view of
1241 1241   * the object or the cpu's view of the object).
1242 1242   *
1243 1243   * Inquiring minds want to know when ddi_dma_sync should be used:
1244 1244   *
1245 1245   * +    When an object is mapped for dma, assume that an
1246 1246   *      implicit ddi_dma_sync() is done for you.
1247 1247   *
1248      - * +    When an object is unmapped (ddi_dma_free()), assume
     1248 + * +    When an object is unmapped (ddi_dma_unbind_handle()), assume
1249 1249   *      that an implicit ddi_dma_sync() is done for you.
1250 1250   *
1251 1251   * +    At any time between the two times above that the
1252 1252   *      memory object may have been modified by either
1253 1253   *      the DMA device or a processor and you wish that
1254 1254   *      the change be noticed by the master that didn't
1255 1255   *      do the modifying.
1256 1256   *
1257 1257   * Clearly, only the third case above requires the use of ddi_dma_sync.
1258 1258   *
↓ open down ↓ 1028 lines elided ↑ open up ↑ 
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX