'\" t
.\"     Title: ieee1284_find_ports
.\"    Author: Tim Waugh <twaugh@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 04/07/2024
.\"    Manual: Functions
.\"    Source: [FIXME: source]
.\"  Language: English
.\"
.TH "IEEE1284_FIND_PORTS" "3" "04/07/2024" "[FIXME: source]" "Functions"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ieee1284_find_ports \- find ports on the system
.SH "SYNOPSIS"
.sp
.ft B
.nf
#include <ieee1284\&.h>
.fi
.ft
.HP \w'int\ ieee1284_find_ports('u
.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\*(Aqs 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\&>
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2001-2003 Tim Waugh
.br