.\" 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 "PARPORT_DEVICE_COORDS" "" "06 October 2005" "" ""

.SH NAME
parport_device_coords \- convert canonical device number
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int parport_device_coords  (int \fIdevnum\fB, int * \fIparport\fB, int * \fImux\fB, int * \fIdaisy\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIdevnum\fB\fR
device number
.TP
\fB\fIparport\fB\fR
pointer to storage for parallel port number
.TP
\fB\fImux\fB\fR
pointer to storage for multiplexor port number
.TP
\fB\fIdaisy\fB\fR
pointer to storage for daisy chain address
.SH "DESCRIPTION"
.PP
This function converts a device number into its coordinates in
terms of which parallel port in the system it is attached to,
which multiplexor port it is attached to if there is a
multiplexor on that port, and which daisy chain address it has
if it is in a daisy chain.
.PP
The caller must allocate storage for \fIparport\fR, \fImux\fR, and
\fIdaisy\fR\&.
.PP
If there is no device with the specified device number, -ENXIO
is returned.  Otherwise, the values pointed to by \fIparport\fR,
\fImux\fR, and \fIdaisy\fR are set to the coordinates of the device,
with -1 for coordinates with no value.
.PP
This function is not actually very useful, but this interface
was suggested by IEEE 1284.3.