.\"     Title: ieee1284_find_ports

.\"    Author: Tim Waugh <twaugh@redhat.com>

.\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>

.\"      Date: 09/18/2007

.\"    Manual: Functions

.\"    Source: 

.\"

.TH "IEEE1284_FIND_PORTS" "3" "09/18/2007" "" "Functions"

.\" disable hyphenation

.nh

.\" disable justification (adjust text to left margin only)

.ad l

.SH "NAME"

ieee1284_find_ports \- find ports on the system

.SH "SYNOPSIS"

.sp

.ft B

.nf

#include <ieee1284.h>

.fi

.ft

.HP 24

.BI "int ieee1284_find_ports(struct\ parport_list\ *" "list" ", int\ " "flags" ");"

.SH "DESCRIPTION"

.PP

This function should be called before the other libieee1284 functions. This gives the library a chance to look around and see what's available, and gives the program a chance to choose a port to use.

.PP

The

\fIlist\fR

is a pointer to a

parport_list

structure that will be filled in on success.

.PP

There are no

\fIflags\fR

defined; use zero for this parameter.

.SH "RETURN VALUE"

.PP

\fBE1284_OK\fR

.RS 4

Success.

\fIlist\fR

is filled in and must be destroyed using

\fBieee1284_free_ports\fR(3).

.RE

.PP

\fBE1284_NOMEM\fR

.RS 4

There is not enough memory available.

.RE

.PP

\fBE1284_NOTIMPL\fR

.RS 4

One or more of the supplied flags is not supported in this implementation.

.RE

.SH "AUTHOR"

.PP

\fBTim Waugh\fR <\&twaugh@redhat.com\&>

.sp -1n

.IP "" 4

Author.

.SH "COPYRIGHT"

Copyright \(co 2001\-2003 Tim Waugh

.br