1

#ifndef IRC_CONN_H

     2

#define IRC_CONN_H

     3

     4

/*

     5

 * Per-connection IRC setup and state/protocol handling.

     6

 */

     7

     8

#include "sock.h"

     9

#include "line_proto.h"

    10

#include "irc_line.h"

    11

#include "error.h"

    12

    13

/*

    14

 * A connection to an IRC server.

    15

 */

    16

struct irc_conn {

    17

    /* We are a line-based protocol */

    18

    struct line_proto *lp;

    19

};

    20

    21

// XXX: this should probably be slightly reworked

    22

struct irc_conn_config {

    23

    /* Nickname to use on that server */

    24

    const char *nickname;

    25

    26

    /* Username to supply */

    27

    const char *username;

    28

    29

    /* Realname to supply */

    30

    const char *realname;

    31

};

    32

    33

/*

    34

 * Create a new irc_conn using the given sock_stream, which should be connected to an IRC server. The parameters given

    35

 * in \a config will be used to identify with the IRC server.

    36

 *

    37

 * On success, the resulting irc_conn is returned via *conn with SUCCESS. Otherwise, -ERR_* and error info is returned

    38

 * via *err.

    39

 */

    40

err_t irc_conn_create (struct irc_conn **conn, struct sock_stream *sock, const struct irc_conn_config *config, struct error_info *err);

    41

    42

/*

    43

 * Send an IRC message directly

    44

 */

    45

err_t irc_conn_send (struct irc_conn *conn, const struct irc_line *line);

    46

    47

/*

    48

 * Send a NICK message

    49

 */

    50

err_t irc_conn_NICK (struct irc_conn *conn, const char *nickname);

    51

    52

/*

    53

 * Send a USER message

    54

 */

    55

err_t irc_conn_USER (struct irc_conn *conn, const char *username, const char *realname);

    56

    57

    58

#endif /* IRC_CONN_H */