'\" t
.\"     Title: ieee1284_claim
.\"    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_CLAIM" "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_claim \- claim access to the port
.SH "SYNOPSIS"
.sp
.ft B
.nf
#include <ieee1284\&.h>
.fi
.ft
.HP \w'int\ ieee1284_claim('u
.BI "int ieee1284_claim(struct\ parport\ *" "port" ");"
.SH "DESCRIPTION"
.PP
With the exception of
\fBieee1284_get_deviceid\fR(3),
\fBieee1284_claim\fR
must be called on an open port before any other libieee1284 function for accessing a device on it\&.
.SH "RETURN VALUE"
.PP
\fBE1284_OK\fR
.RS 4
Success\&. Note that, unless the
\fBF1284_EXCL\fR
flag was specified to start with, the port should be released within a
\(lqreasonable\(rq
amount of time\&.
.RE
.PP
\fBE1284_NOMEM\fR
.RS 4
There is not enough memory\&.
.RE
.PP
\fBE1284_INVALIDPORT\fR
.RS 4
The
\fIport\fR
parameter is invalid (for instance, it might not have been opened yet)\&.
.RE
.PP
\fBE1284_SYS\fR
.RS 4
There was a problem at the operating system level\&. The global variable
\fIerrno\fR
has been set appropriately\&.
.RE
.SH "SEE ALSO"
.PP
\fBieee1284_release\fR(3)
.SH "AUTHOR"
.PP
\fBTim Waugh\fR <\&twaugh@redhat.com\&>
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2001-2003 Tim Waugh
.br