.\"     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