ddi_device_zero(9f) [sunos man page]

ddi_device_zero(9F)					   Kernel Functions for Drivers 				       ddi_device_zero(9F)

NAME

       ddi_device_zero - zero fill the device

SYNOPSIS

       #include <sys/ddi.h>
       #include <sys/sunddi.h>

       int ddi_device_zero(ddi_acc_handle_t handle, caddr_t dev_addr, size_t bytecount, ssize_t dev_advcnt, uint_t dev_datasz);

INTERFACE LEVEL

       Solaris DDI specific (Solaris DDI).

PARAMETERS

       handle	       The data access handle returned from setup calls, such as ddi_regs_map_setup(9F).

       dev_addr        Beginning of the device address.

       bytecount       Number of bytes to zero.

       dev_advcnt      Number of  dev_datasz units to advance on every access.

       dev_datasz      The size of each data word. Possible values are defined as: "25">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_zero() function fills the given, bytecount, number of byte of zeroes to the device register or memory.

       The   dev_advcnt  argument  determines  the value of the device address,  dev_addr, on each access.  A value of	0 will use the same device
       address,  dev_addr, on every  access. A positive value increments the device address in the next access while a negative  value	decrements
       the address. The device address is incremented and decremented in  dev_datasz units.

       The dev_datasz argument determines the size of data word on each access.

RETURN VALUES

       ddi_device_zero() returns:

       DDI_SUCCESS     Successfully zeroed the data.

       DDI_FAILURE     The byte count is not a multiple of  dev_datasz.

CONTEXT

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

SEE ALSO

       ddi_regs_map_free(9F), ddi_regs_map_setup(9F)

       Writing Device Drivers

SunOS 5.10							    25 Sep 1996 					       ddi_device_zero(9F)

ddi_device_copy(9F)					   Kernel Functions for Drivers 				       ddi_device_copy(9F)

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 destina-
       tion.

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

SunOS 5.11							    15 Nov 1996 					       ddi_device_copy(9F)