1 .\" $Id: ares_timeout.3,v 1.1 1998/08/13 18:07:36 ghudson Exp $
3 .\" Copyright 1998 by the Massachusetts Institute of Technology.
5 .\" Permission to use, copy, modify, and distribute this
6 .\" software and its documentation for any purpose and without
7 .\" fee is hereby granted, provided that the above copyright
8 .\" notice appear in all copies and that both that copyright
9 .\" notice and this permission notice appear in supporting
10 .\" documentation, and that the name of M.I.T. not be used in
11 .\" advertising or publicity pertaining to distribution of the
12 .\" software without specific, written prior permission.
13 .\" M.I.T. makes no representations about the suitability of
14 .\" this software for any purpose. It is provided "as is"
15 .\" without express or implied warranty.
17 .TH ARES_TIMEOUT 3 "25 July 1998"
19 ares_fds \- Get file descriptors to select on for name service
24 .B struct timeval *ares_timeout(ares_channel \fIchannel\fP,
25 .B struct timeval *\fImaxtv\fP, struct timeval *\fItvbuf\fP)
30 function determines the maximum time for which the caller should wait
33 to process timeouts. The parameter
35 specifies a existing maximum timeout, or
37 if the caller does not wish to apply a maximum timeout. The parameter
39 must point to a writable buffer of type
40 .BR "struct timeval" .
45 to have the same value.
47 If no queries have timeouts pending sooner than the given maximum
54 stores the appropriate timeout value into the buffer pointed to by
56 and returns the value of
62 Greg Hudson, MIT Information Systems
64 Copyright 1998 by the Massachusetts Institute of Technology.