ixp_listen.3 (1457B)
1 .TH "IXP_LISTEN" 3 "2010 Jun" "libixp Manual" 2 3 .SH NAME 4 .P 5 ixp_listen, IxpConn 6 7 .SH SYNOPSIS 8 .nf 9 #include <ixp.h> 10 11 IxpConn *ixp_listen(IxpServer *srv, int fd, void *aux, void (*read)(IxpConn *), void (*close)(IxpConn *)); 12 13 typedef struct IxpConn IxpConn; 14 struct IxpConn { 15 IxpServer* srv; 16 void* aux; /* Arbitrary pointer, to be used by handlers. */ 17 int fd; /* The file descriptor of the connection. */ 18 void (*read)(IxpConn *); 19 void (*close)(IxpConn *); 20 char closed; /* Non-zero when IfdR has been closed. */ 21 22 /* Private members */ 23 ... 24 } 25 .fi 26 27 .SH PARAMETERS 28 .TP 29 fs 30 The file descriptor on which to listen. 31 .TP 32 aux 33 A piece of data to store in the connection's 34 IauxR member of the IxpConn data structure. 35 .TP 36 read 37 The function called when the connection has 38 data available to read. 39 .TP 40 close 41 A cleanup function called when the 42 connection is closed. 43 44 .SH DESCRIPTION 45 .P 46 Starts the server IsrvR listening on IfdR. The optional 47 IreadR and IcloseR callbacks are called with the IxpConn 48 structure for the connection as their sole argument. 49 50 .SH RETURN VALUE 51 .P 52 Returns the connection's new IxpConn data structure. 53 54 .SH SEE ALSO 55 .P 56 ixp_serverloop(3), ixp_serve9conn(3), ixp_hangup(3) 57 58 59 .\" man code generated by txt2tags 2.5 (http://txt2tags.sf.net) 60 .\" cmdline: txt2tags -o- ixp_listen.man3 61