.\"     Title: ieee1284_claim
.\"    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_CLAIM" "3" "09/18/2007" "" "Functions"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
ieee1284_claim \- claim access to the port
.SH "SYNOPSIS"
.sp
.ft B
.nf
#include <ieee1284.h>
.fi
.ft
.HP 19
.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\&>
.sp -1n
.IP "" 4
Author.
.SH "COPYRIGHT"
Copyright \(co 2001\-2003 Tim Waugh
.br