X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=recv.h;h=c48a6b3664e6e2466756ac28159daf1281730791;hp=7555dfb4130010898145bb6bb89b679a5e69e78a;hb=9c00a79ed817c854ed10ee6bd1b908df8dc13a2f;hpb=63aab30b55d5809704a2d0e1c4e8de20e8228d7d diff --git a/recv.h b/recv.h index 7555dfb4..c48a6b36 100644 --- a/recv.h +++ b/recv.h @@ -1,5 +1,5 @@ /* - * Copyright (C) 2005-2011 Andre Noll + * Copyright (C) 2005-2013 Andre Noll * * Licensed under the GPL v2. For licencing details see COPYING. */ @@ -20,6 +20,21 @@ struct receiver_node { struct task task; /** The receiver node is always the root of the buffer tree. */ struct btr_node *btrn; + /** Each receiver node maintains a buffer pool for the received data. */ + struct btr_pool *btrp; + /** + * The file descriptor to receive the stream. + * + * The pre_select function of the receiver adds this file descriptor to + * the set of file descriptors which are watched for readability or + * writability, depending on the state of the connection (if any). + * + * If \a fd is readable, the post_select function of the receiver reads + * data from this fd into the buffer pool area of \a btrp. + * + * \sa \ref receiver. + */ + int fd; }; /** @@ -93,17 +108,26 @@ struct receiver { * Evaluate the result from select(). * * This hook gets called after the call to select(). It should check - * all file descriptors which were added to any of the the fd sets - * during the previous call to pre_select. According to the result, it - * may then use any non-blocking I/O to establish a connection or to + * all file descriptors which were added to any of the fd sets during + * the previous call to pre_select. According to the result, it may + * then use any non-blocking I/O to establish a connection or to * receive the audio data. * * \sa select(2), struct receiver. */ void (*post_select)(struct sched *s, struct task *t); + /** New variant, see sched.h. */ + int (*new_post_select)(struct sched *s, struct task *t); /** The two help texts of this receiver. */ struct ggo_help help; + /** + * Answer a buffer tree query. + * + * This optional function pointer is used for inter node communications + * of the buffer tree nodes. See \ref btr_command_handler for details. + */ + btr_command_handler execute; }; /** Define an array of all available receivers. */ @@ -111,6 +135,7 @@ struct receiver { HTTP_RECEIVER \ DCCP_RECEIVER \ UDP_RECEIVER \ + AFH_RECEIVER \ {.name = NULL}}; /** Iterate over all available receivers. */ @@ -128,6 +153,7 @@ extern void dccp_recv_init(struct receiver *r); #define DCCP_RECEIVER {.name = "dccp", .init = dccp_recv_init}, extern void udp_recv_init(struct receiver *r); #define UDP_RECEIVER {.name = "udp", .init = udp_recv_init}, +#define AFH_RECEIVER /* not active by default */ extern struct receiver receivers[]; /** \endcond receiver */