.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "CCIO_IO_PDIR_ENTRY" "" "06 October 2005" "" ""

.SH NAME
ccio_io_pdir_entry \- Initialize an I/O Pdir.
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
void CCIO_INLINE ccio_io_pdir_entry  (u64 * \fIpdir_ptr\fB, space_t \fIsid\fB, void * \fIvba\fB, unsigned long \fIhints\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIpdir_ptr\fB\fR
A pointer into I/O Pdir.
.TP
\fB\fIsid\fB\fR
The Space Identifier.
.TP
\fB\fIvba\fB\fR
The virtual address.
.TP
\fB\fIhints\fB\fR
The DMA Hint.
.SH "DESCRIPTION"
.PP
Given a virtual address (vba, arg2) and space id, (sid, arg1),
load the I/O PDIR entry pointed to by pdir_ptr (arg0). Each IO Pdir
entry consists of 8 bytes as shown below (MSB == bit 0):
.SH "WORD 0"
.PP
+------+----------------+-----------------------------------------------+
| Phys | Virtual Index  |               Phys                            |
| 0:3  |     0:11       |               4:19                            |
|4 bits|   12 bits      |              16 bits                          |
+------+----------------+-----------------------------------------------+
.SH "WORD 1"
.PP
+-----------------------+-----------------------------------------------+
|      Phys    |  Rsvd  | Prefetch |Update |Rsvd  |Lock  |Safe  |Valid  |
|     20:39    |        | Enable   |Enable |      |Enable|DMA   |       |
|    20 bits   | 5 bits | 1 bit    |1 bit  |2 bits|1 bit |1 bit |1 bit  |
+-----------------------+-----------------------------------------------+
.PP
The virtual index field is filled with the results of the LCI
(Load Coherence Index) instruction.  The 8 bits used for the virtual
.SH "INDEX ARE BITS 12"
.PP
19 of the value returned by LCI.