X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/mLib/blobdiff_plain/97f65b001294338abed02a7b132d6be6517b3f1d..7527ed0bc3b9987d6b468cf76cb8f55f1b4ff4db:/conn.h diff --git a/conn.h b/conn.h index 7362b65..58a96a8 100644 --- a/conn.h +++ b/conn.h @@ -1,10 +1,10 @@ /* -*-c-*- * - * $Id: conn.h,v 1.1 1999/05/14 21:01:14 mdw Exp $ + * $Id: conn.h,v 1.5 1999/12/10 23:42:04 mdw Exp $ * * Nonblocking connect handling * - * (c) 1999 Mark Wooding + * (c) 1999 Straylight/Edgeware */ /*----- Licensing notice --------------------------------------------------* @@ -30,13 +30,26 @@ /*----- Revision history --------------------------------------------------* * * $Log: conn.h,v $ + * Revision 1.5 1999/12/10 23:42:04 mdw + * Change header file guard names. + * + * Revision 1.4 1999/05/26 21:08:01 mdw + * Remove redundant structure member. + * + * Revision 1.3 1999/05/23 12:12:46 mdw + * Interface change to make the `conn' selector useful for generic stream + * sockets rather than just IPv4 ones. + * + * Revision 1.2 1999/05/15 10:33:32 mdw + * Fix copyright notices. + * * Revision 1.1 1999/05/14 21:01:14 mdw * Integrated `select' handling bits from the background resolver project. * */ -#ifndef CONN_H -#define CONN_H +#ifndef MLIB_CONN_H +#define MLIB_CONN_H #ifdef __cplusplus extern "C" { @@ -44,7 +57,10 @@ /*----- Header files ------------------------------------------------------*/ -#ifndef SEL_H +#include +#include + +#ifndef MLIB_SEL_H # include "sel.h" #endif @@ -64,29 +80,25 @@ typedef struct conn { * * Arguments: @conn *c@ = pointer to connection block * @sel_state *s@ = pointer to select state to attach to - * @unsigned long saddr@ = source IP address - * @unsigned short sport@ = source port - * @unsigned long daddr@ = destination IP address - * @unsigned short dport@ = destination port + * @int fd@ = file descriptor of socket to connect + * @struct sockaddr *dst@ = destination address + * @int dsz@ = size of destination address * @void (*func)(int fd, void *p) = handler function * @void *p@ = argument for the handler function * * Returns: --- * - * Use: Sets up a nonblocking connect job. The source address and - * port can be zero if you don't care. When the connection - * completes, the handler function is called with the connected - * socket as an argument. If the connect fails rather than - * completes, the handler is informed of this by being passed a - * negative file descriptor. In either case, the select job is - * then removed. + * Use: Sets up a nonblocking connect job. The socket should already + * be bound if you care about that sort of thing. When the + * connection completes, the handler function is called with the + * connected socket as an argument. If the connect fails rather + * than completes, the socket is closed, and the handler is + * informed of this by being passed a negative file descriptor. + * In either case, the select job is then removed. */ -extern void conn_init(conn */*c*/, sel_state */*s*/, - unsigned long /*saddr*/, - unsigned short /*sport*/, - unsigned long /*daddr*/, - unsigned long /*dport*/, +extern void conn_init(conn */*c*/, sel_state */*s*/, int /*fd*/, + struct sockaddr */*dst*/, int /*dsz*/, void (*/*func*/)(int /*fd*/, void */*p*/), void */*p*/);