Hallo, dies ist ein Test.
PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html
Running in File Mode
Relative path: ./../../../../../../usr/man/man9f/ddi_rep_put8.9f
Real path: /usr/share/man/man9f/ddi_rep_put8.9f
Zurück
'\" te .\" Copyright (c) 1996, 2020, Oracle and/or its affiliates. .TH ddi_rep_put8 9F "1 Nov 2005" "Oracle Solaris 11.4" "Kernel Functions" .SH NAME ddi_rep_put8, ddi_rep_put16, ddi_rep_put32, ddi_rep_put64, ddi_rep_putb, ddi_rep_putw, ddi_rep_putl, ddi_rep_putll \- write data to the mapped memory address, device register or allocated DMA memory address .SH SYNOPSIS .LP .nf #include <sys/ddi.h> #include <sys/sunddi.h> \fBvoid\fR \fBddi_rep_put8\fR(\fBddi_acc_handle_t\fR \fIhandle\fR, \fBuint8_t\fR \fI*host_addr\fR, \fBuint8_t\fR \fI*dev_addr\fR, \fBsize_t\fR \fIrepcount\fR, \fBuint_t\fR \fIflags\fR); .fi .LP .nf \fBvoid\fR \fBddi_rep_put16\fR(\fBddi_acc_handle_t\fR \fIhandle\fR, \fBuint16_t\fR \fI*host_addr\fR, \fBuint16_t\fR \fI*dev_addr\fR, \fBsize_t\fR \fIrepcount\fR, \fBuint_t\fR \fIflags\fR); .fi .LP .nf \fBvoid\fR \fBddi_rep_put32\fR(\fBddi_acc_handle_t\fR \fIhandle\fR, \fBuint32_t\fR \fI*host_addr\fR, \fBuint32_t\fR \fI*dev_addr\fR, \fBsize_t\fR \fIrepcount\fR, \fBuint_t\fR \fIflags\fR); .fi .LP .nf \fBvoid\fR \fBddi_rep_put64\fR(\fBddi_acc_handle_t\fR \fIhandle\fR, \fBuint64_t\fR \fI*host_addr\fR, \fBuint64_t\fR \fI*dev_addr\fR,\fBsize_t\fR \fIrepcount\fR, \fBuint_t\fR \fIflags\fR); .fi .SH INTERFACE LEVEL .sp .LP Solaris DDI specific (Solaris DDI). The \fBddi_rep_putb()\fR, \fBddi_rep_putl()\fR, \fBddi_rep_putll()\fR, and \fBddi_rep_putw()\fR functions are obsolete. The \fBddi_rep_put8()\fR function replaces \fBddi_rep_putb()\fR. The \fBddi_rep_put32()\fR function replaces \fBddi_rep_putl()\fR. The \fBddi_rep_put64()\fR function replaces \fBddi_rep_putll()\fR. The \fBddi_rep_put16()\fR function replaces \fBddi_rep_putw()\fR. .SH PARAMETERS .sp .ne 2 .mk .na \fB\fIhandle\fR\fR .ad .br .sp .6 .RS 4n The data access handle returned from setup calls, such as \fBddi_regs_map_setup\fR(9F). .RE .sp .ne 2 .mk .na \fB\fIhost_addr\fR\fR .ad .br .sp .6 .RS 4n Base host address. .RE .sp .ne 2 .mk .na \fB\fIdev_addr\fR\fR .ad .br .sp .6 .RS 4n Base device address. .RE .sp .ne 2 .mk .na \fB\fIrepcount\fR\fR .ad .br .sp .6 .RS 4n Number of data accesses to perform. .RE .sp .ne 2 .mk .na \fB\fIflags\fR\fR .ad .br .sp .6 .RS 4n Device address flags: .sp .ne 2 .mk .na \fB\fBDDI_DEV_AUTOINCR\fR\fR .ad .br .sp .6 .RS 4n Automatically increment the device address, \fIdev_addr\fR, during data accesses. .RE .sp .ne 2 .mk .na \fB\fBDDI_DEV_NO_AUTOINCR\fR\fR .ad .br .sp .6 .RS 4n Do not advance the device address, \fIdev_addr\fR, during data accesses. .RE .RE .SH DESCRIPTION .sp .LP These routines generate multiple writes to the mapped memory or device register. \fIrepcount\fR data is copied from the host address, \fIhost_addr\fR, to the device address, \fIdev_addr\fR. For each input datum, the \fBddi_rep_put8()\fR, \fBddi_rep_put16()\fR, \fBddi_rep_put32()\fR, and \fBddi_rep_put64()\fR functions write 8 bits, 16 bits, 32 bits, and 64 bits of data, respectively, to the device address, \fIdev_addr\fR. \fIdev_addr\fR and \fIhost_addr\fR must be aligned to the datum boundary described by the function. .sp .LP Each individual datum will automatically be translated to maintain a consistent view between the host and the device based on the encoded information in the data access handle. The translation may involve byte-swapping if the host and the device have incompatible endian characteristics. .sp .LP When the \fIflags\fR argument is set to \fBDDI_DEV_AUTOINCR\fR, these functions treat the device address, \fIdev_addr\fR, as a memory buffer location on the device and increment its address on the next input datum. However, when the \fIflags\fR argument is set to \fBDDI_DEV_NO_AUTOINCR\fR, the same device address will be used for every datum access. For example, this flag may be useful when writing to a data register. .SH CONTEXT .sp .LP These functions can be called from user, kernel, or interrupt context. .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Interface Stability T{ \fBddi_rep_putb()\fR, \fBddi_rep_putl()\fR, \fBddi_rep_putll()\fR, and \fBddi_rep_putw()\fR are Obsolete \fBddi_rep_put8()\fR, \fBddi_rep_put16()\fR, \fBddi_rep_put32()\fR, \fBddi_rep_put64()\fR are Committed T} .TE .sp .SH SEE ALSO .sp .LP \fBddi_get8\fR(9F), \fBddi_put8\fR(9F), \fBddi_regs_map_free\fR(9F), \fBddi_regs_map_setup\fR(9F), \fBddi_rep_get8\fR(9F), \fBddi_device_acc_attr\fR(9S)