1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
|
/* Connection queues
Copyright (C) 1995 Free Software Foundation, Inc.
Written by Miles Bader <miles@gnu.ai.mit.edu>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2, or (at
your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
#ifndef __CONNQ_H__
#define __CONNQ_H__
#include <errno.h>
/* Unknown types */
struct connq;
struct connq_request;
struct sock;
/* Create a new listening queue, returning it in CQ. The resulting queue
will be of zero length, that is it won't allow connections unless someone
is already listening (change this with connq_set_length). */
error_t connq_create (struct connq **cq);
/* Wait for a connection attempt to be made on CQ, and return the connecting
socket in SOCK, and a request tag in REQ. If REQ is NULL, the request is
left in the queue, otherwise connq_request_complete must be called on REQ
to allow the requesting thread to continue. If NOBLOCK is true,
EWOULDBLOCK is returned when there are no immediate connections
available. CQ should be unlocked. */
error_t connq_listen (struct connq *cq, int noblock,
struct connq_request **req, struct sock **sock);
/* Return the error code ERR to the thread that made the listen request REQ,
returned from a previous connq_listen. */
void connq_request_complete (struct connq_request *req, error_t err);
/* Set CQ's queue length to LENGTH. Any sockets already waiting for a
connections that are past the new length will fail with ECONNREFUSED. */
error_t connq_set_length (struct connq *cq, int length);
/* Try to connect SOCK with the socket listening on CQ. If NOBLOCK is true,
then return EWOULDBLOCK immediately when there are no immediate
connections available. Neither SOCK nor CQ should be locked. */
error_t connq_connect (struct connq *cq, int noblock, struct sock *sock);
/* Interrupt any threads waiting on CQ, both listeners and connectors, and
make them return with EINTR. */
void connq_interrupt (struct connq *cq);
/* Interrupt any threads that are attempting to connect SOCK to CQ, and make
them return with EINTR. */
void connq_interrupt_sock (struct connq *cq, struct sock *sock);
#endif /* __CONNQ_H__ */
|
