irc_track.h

Go to the documentation of this file.

/* irc_track.h - (optionally) track users and channels
 * libsrsirc - a lightweight serious IRC lib - (C) 2012-15, Timo Buhrmester
 * See README for contact-, COPYING for license information. */

#ifndef LIBSRSIRC_IRC_TRACK_H
#define LIBSRSIRC_IRC_TRACK_H 1


#include <libsrsirc/defs.h>

struct chanrep {
        const char *name; 
        const char *topic; 
        const char *topicnick; 
        uint64_t tscreate; 
        uint64_t tstopic; 
        void *tag; 
};

struct userrep {
        const char *modepfx;
        const char *nick; 
        const char *uname;  //XXX rly?
        const char *host; 
        const char *fname; 
        size_t nchans; 
        void *tag; 
};

typedef struct chanrep chanrep;

typedef struct userrep userrep;


/* the results of these functions (i.e. the strings pointed to by the various
 * members of the structs above) are only valid until the next time irc_read
 * is called.  if you need persistence, copy the data. */

size_t irc_num_chans(irc *ctx);

size_t irc_all_chans(irc *ctx, chanrep *chanarr, size_t chanarr_cnt);

chanrep *irc_chan(irc *ctx, chanrep *dest, const char *name);

bool irc_tag_chan(irc *ctx, const char *chnam, void *tag, bool autofree);

size_t irc_num_users(irc *ctx);

size_t irc_all_users(irc *ctx, userrep *userarr, size_t userarr_cnt);

userrep *irc_user(irc *ctx, userrep *dest, const char *ident);

bool irc_tag_user(irc *ctx, const char *ident, void *tag, bool autofree);


size_t irc_num_members(irc *ctx, const char *chnam);

size_t irc_all_members(irc *ctx, const char *chnam, userrep *userarr,
    size_t userarr_cnt);


userrep *irc_member(irc *ctx, userrep *dest, const char *chnam, const char *ident);

/* for debugging */

void lsi_trk_dump(irc *ctx, bool full);

#endif /* LIBSRSIRC_IRC_TRACK_H */