1

#ifndef REMOTE_POOL_H

     2

#define REMOTE_POOL_H

     3

     4

#include "remote_node.h"

     5

     6

// maximum number of nodes in a remote pool

     7

#define REMOTE_POOL_MAX 8

     8

     9

// how many bytes long each line in a pool file may be

    10

#define POOL_FILE_LINE_LENGTH 512

    11

    12

struct remote_pool {

    13

    // the remote_nodes are part of this struct

    14

    struct remote_node nodes[REMOTE_POOL_MAX];

    15

};

    16

    17

/*

    18

 * Initialize the given remote_pool

    19

 */

    20

void remote_pool_init (struct remote_pool *pool_info);

    21

    22

/*

    23

 * Add a remote_node to the pool, see remote_node_init

    24

 */

    25

int remote_pool_add (struct remote_pool *pool_info, const char *addr_spec);

    26

    27

/*

    28

 * Adds remote_nodes to the pool based on the contents of the given file

    29

 *

    30

 * The format for the file is a set of "<hostname>:<portname>" lines, see

    31

 * parse_hostport in common.h. Blank lines are skipped, and any comments

    32

 * prefixed with a '#' char is ignored. Whitespace inside lines is also

    33

 * ignored.

    34

 *

    35

 * Returns however many nodes were added (possibly zero), or -1 on error

    36

 */

    37

int remote_pool_load (struct remote_pool *pool_info, const char *filename);

    38

    39

/*

    40

 * Choose a remote_node from the pool

    41

 *

    42

 * Attempts to pick the one that's least busy

    43

 */

    44

struct remote_node *remote_pool_get (struct remote_pool *pool_info);

    45

    46

/*

    47

 * Get the number of remote render nodes in this pool

    48

 */

    49

int remote_pool_size (struct remote_pool *pool_info);

    50

    51

#endif /* REMOTE_POOL_H */