3 * $Id: chan.h,v 1.2 1999/07/26 23:27:42 mdw Exp $
7 * (c) 1999 Straylight/Edgeware
10 /*----- Licensing notice --------------------------------------------------*
12 * This file is part of the `fw' port forwarder.
14 * `fw' is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License as published by
16 * the Free Software Foundation; either version 2 of the License, or
17 * (at your option) any later version.
19 * `fw' is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU General Public License for more details.
24 * You should have received a copy of the GNU General Public License
25 * along with `fw'; if not, write to the Free Software Foundation,
26 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
29 /*----- Revision history --------------------------------------------------*
32 * Revision 1.2 1999/07/26 23:27:42 mdw
33 * Change copyright notice.
35 * Revision 1.1.1.1 1999/07/01 08:56:23 mdw
47 /*----- Header files ------------------------------------------------------*/
51 /*----- Magic numbers -----------------------------------------------------*/
53 #define CHAN_BUFSZ 4096
55 /*----- Data structures ---------------------------------------------------*/
58 unsigned base
, len
; /* Base and length of data */
59 unsigned f
; /* Various interesting flags */
60 void (*func
)(void */
*p*/
); /* Function to call on closure */
61 void *p
; /* Argument to pass function */
62 sel_file r
, w
; /* Reader and writer selectors */
63 char buf
[CHAN_BUFSZ
]; /* The actual data buffer */
66 #define CHANF_CLOSE 1u /* Close channel when buffer empty */
67 #define CHANF_READY 2u /* The channel destination exists */
69 /*----- Functions provided ------------------------------------------------*/
71 /* --- @chan_close@ --- *
73 * Arguments: @chan *c@ = pointer to channel
77 * Use: Closes down a channel prematurely.
80 extern void chan_close(chan */
*c*/
);
82 /* --- @chan_dest@ --- *
84 * Arguments: @chan *c@ = pointer to channel
85 * @int fd@ = destination file descriptor for channel
89 * Use: Sets the channel's destination so it knows where to put
93 extern void chan_dest(chan */
*c*/
, int /*fd*/);
95 /* --- @chan_open@ --- *
97 * Arguments: @chan *c@ = pointer to channel to open
98 * @int from, to@ = source and destination file descriptors
99 * @void (*func)(void *p)@ = function to call on closure
100 * @void *p@ = argument to pass to function
104 * Use: Opens a channel. Data is copied from the source to the
105 * destination. The @to@ argument may be @-1@ if the file
106 * descriptor isn't known yet.
109 extern void chan_open(chan */
*c*/
, int /*from*/, int /*to*/,
110 void (*/
*func*/
)(void */
*p*/
), void */
*p*/
);
112 /*----- That's all, folks -------------------------------------------------*/