The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

ddi_device_copy (9)
  • >> ddi_device_copy (9) ( Solaris man: Ядро )
  •  

    NAME

    ddi_device_copy - copy data from one device register to another device register
     
    

    SYNOPSIS

    #include <sys/ddi.h> 
    #include <sys/sunddi.h>
    
    
    
    int ddi_device_copy(ddi_acc_handle_t src_handle, caddr_t src_addr, 
        ssize_t src_advcnt, ddi_acc_handle_t dest_handle,
        caddr_t dest_addr, ssize_t dest_advcnt, 
        size_t bytecount, uint_t dev_datasz);
    

     

    INTERFACE LEVEL

    Solaris DDI specific (Solaris DDI).  

    PARAMETERS

    src_handle

    The data access handle of the source device.

    src_addr

    Base data source address.

    src_advcnt

    Number of dev_datasz units to advance on every access.

    dest_handle

    The data access handle of the destination device.

    dest_addr

    Base data destination address.

    dest_advcnt

    Number of dev_datasz units to advance on every access.

    bytecount

    Number of bytes to transfer.

    dev_datasz

    The size of each data word. Possible values are defined as:

    DDI_DATA_SZ01_ACC

    1 byte data size

    DDI_DATA_SZ02_ACC

    2 bytes data size

    DDI_DATA_SZ04_ACC

    4 bytes data size

    DDI_DATA_SZ08_ACC

    8 bytes data size

     

    DESCRIPTION

    ddi_device_copy() copies bytecount bytes from the source address, src_addr, to the destination address, dest_addr. The attributes encoded in the access handles, src_handle and dest_handle, govern how data is actually copied from the source to the destination. Only matching data sizes between the source and destination are supported.

    Data will automatically be translated to maintain a consistent view between the source and the destination. The translation may involve byte-swapping if the source and the destination devices have incompatible endian characteristics.

    The src_advcnt and dest_advcnt arguments specifies the number of dev_datasz units to advance with each access to the device addresses. A value of 0 will use the same source and destination device address on every access. A positive value increments the corresponding device address by certain number of data size units in the next access. On the other hand, a negative value decrements the device address.

    The dev_datasz argument determines the size of the data word on each access. The data size must be the same between the source and destination.  

    RETURN VALUES

    ddi_device_copy() returns:

    DDI_SUCCESS

    Successfully transferred the data.

    DDI_FAILURE

    The byte count is not a multiple dev_datasz.

     

    CONTEXT

    ddi_device_copy() can be called from user, kernel, or interrupt context.  

    SEE ALSO

    ddi_regs_map_free(9F), ddi_regs_map_setup(9F)

    Writing Device Drivers


     

    Index

    NAME
    SYNOPSIS
    INTERFACE LEVEL
    PARAMETERS
    DESCRIPTION
    RETURN VALUES
    CONTEXT
    SEE ALSO


    Поиск по тексту MAN-ов: 




    Партнёры:
    PostgresPro
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2024 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру