.\" This manpage has been automatically generated by docbook2man
.\" from a DocBook document. This tool can be found at:
.\"
.\" Please send any bug reports, improvements, comments, patches,
.\" etc. to Steve Cheng .
.TH "IA64_SN_PROBE_IO_SLOT" "" "06 October 2005" "" ""
.SH NAME
ia64_sn_probe_io_slot \- test a memory location for readability
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
u64 ia64_sn_probe_io_slot (long \fIpaddr\fB, long \fIsize\fB, void * \fIdata_ptr\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIpaddr\fB\fR
physical address to probe
.TP
\fB\fIsize\fB\fR
number bytes to read (1,2,4,8)
.TP
\fB\fIdata_ptr\fB\fR
address to store value read by probe (-1 returned if probe fails)
.SH "DESCRIPTION"
.PP
This function will probe a physical address to determine if
the address can be read. If reading the address causes a BUS
error, an error is returned. If the probe succeeds, the contents
of the memory location is returned.
.SH "RETURN VALUES"
.PP
0 - probe successful
1 - probe failed (generated MCA)
2 - Bad arg
<0 - PAL error