'\" t
.\"     Title: ieee1284_set_timeout
.\"    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_SET_TIMEOUT" "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_set_timeout \- modify inactivity timeout
.SH "SYNOPSIS"
.sp
.ft B
.nf
#include <ieee1284\&.h>
.fi
.ft
.HP \w'struct\ timeval\ *ieee1284_set_timeout('u
.BI "struct timeval *ieee1284_set_timeout(struct\ parport\ *" "port" ", struct\ timeval\ *" "timeout" ");"
.SH "DESCRIPTION"
.PP
This function sets a new value for the inactivity timeout (used for block transfer functions), and returns the old value\&.
.PP
The
\fIport\fR
must be claimed\&.
.PP
The
\fItimeout\fR
parameter may be
\fBNULL\fR, in which case the old value is left unchanged\&.
.SH "RETURN VALUE"
.PP
This function returns a pointer to a
struct timeval
representing the old value\&. This uses the same storage as the
\fIport\fR
structure, and so is not valid after closing the port\&.
.SH "NOTES"
.PP
Note that this is an inactivity time\-out, not an absolute time\-out\&. During a data transfer, if the peripheral is inactive for the length of time specified then the host gives up\&.
.PP
It is also advisory; no guarantee is made that the transfer will ever complete\&.
.SH "AUTHOR"
.PP
\fBTim Waugh\fR <\&twaugh@redhat.com\&>
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2001-2003 Tim Waugh
.br