/* include/libgadu.h.  Generated from libgadu.h.in by configure.  */

/* $Id: libgadu.h.in,v 1.5.2.1 2007-04-21 23:44:25 wojtekka Exp $ */

/*

 *  (C) Copyright 2001-2003 Wojtek Kaniewski <wojtekka@irc.pl>

 *                          Robert J. Wo�ny <speedy@ziew.org>

 *                          Arkadiusz Mi�kiewicz <arekm@pld-linux.org>

 *                          Tomasz Chili� <chilek@chilan.com>

 *                          Piotr Wysocki <wysek@linux.bydg.org>

 *                          Dawid Jarosz <dawjar@poczta.onet.pl>

 *

 *  This program is free software; you can redistribute it and/or modify

 *  it under the terms of the GNU Lesser General Public License Version

 *  2.1 as published by the Free Software Foundation.

 *

 *  This program is distributed in the hope that it will be useful,

 *  but WITHOUT ANY WARRANTY; without even the implied warranty of

 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 *  GNU Lesser General Public License for more details.

 *

 *  You should have received a copy of the GNU Lesser General Public

 *  License along with this program; if not, write to the Free Software

 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307,

 *  USA.

 */

#ifndef __GG_LIBGADU_H

#define __GG_LIBGADU_H

#ifdef __cplusplus

#ifdef _WIN32

#pragma pack(push, 1)

#endif

extern "C" {

#endif

#include <sys/types.h>

#include <stdio.h>

#include <stdarg.h>

/* Defined if libgadu was compiled for bigendian machine. */

#define GG_CONFIG_BIGENDIAN 

/* Defined if this machine has gethostbyname_r(). */

/* #undef GG_CONFIG_HAVE_GETHOSTBYNAME_R */

/* Defined if libgadu was compiled and linked with pthread support. */

/* #undef GG_CONFIG_HAVE_PTHREAD */

/* Defined if this machine has C99-compiliant vsnprintf(). */

#define GG_CONFIG_HAVE_C99_VSNPRINTF 

/* Defined if this machine has va_copy(). */

#define GG_CONFIG_HAVE_VA_COPY 

/* Defined if this machine has __va_copy(). */

#define GG_CONFIG_HAVE___VA_COPY 

/* Defined if this machine supports long long. */

#define GG_CONFIG_HAVE_LONG_LONG 

/* Defined if libgadu was compiled and linked with TLS support. */

#define GG_CONFIG_HAVE_OPENSSL 

/* Defined if uintX_t types are defined in <stdint.h>. */

#define GG_CONFIG_HAVE_STDINT_H 

/* Defined if uintX_t types are defined in <inttypes.h>. */

/* #undef GG_CONFIG_HAVE_INTTYPES_H */

/* Defined if uintX_t types are defined in <sys/inttypes.h>. */

/* #undef GG_CONFIG_HAVE_SYS_INTTYPES_H */

/* Defined if uintX_t types are defined in <sys/int_types.h>. */

/* #undef GG_CONFIG_HAVE_SYS_INT_TYPES_H */

/* Defined if uintX_t types are defined in <sys/types.h>. */

/* #undef GG_CONFIG_HAVE_SYS_TYPES_H */

#ifdef GG_CONFIG_HAVE_OPENSSL

#include <openssl/ssl.h>

#endif

#ifdef GG_CONFIG_HAVE_STDINT_H

#include <stdint.h>

#else

#  ifdef GG_CONFIG_HAVE_INTTYPES_H

#  include <inttypes.h>

#  else

#    ifdef GG_CONFIG_HAVE_SYS_INTTYPES_H

#    include <sys/inttypes.h>

#    else

#      ifdef GG_CONFIG_HAVE_SYS_INT_TYPES_H

#      include <sys/int_types.h>

#      else

#        ifdef GG_CONFIG_HAVE_SYS_TYPES_H

#        include <sys/types.h>

#        else

#ifndef __AC_STDINT_H

#define __AC_STDINT_H

/* ISO C 9X: 7.18 Integer types <stdint.h> */

typedef unsigned char   uint8_t;

typedef unsigned short uint16_t;

typedef unsigned int   uint32_t;

#ifndef __CYGWIN__

#define __int8_t_defined

typedef   signed char    int8_t;

typedef   signed short  int16_t;

typedef   signed int    int32_t;

#endif

#endif /* __AC_STDINT_H */

#        endif

#      endif

#    endif

#  endif

#endif

/*

 * typedef uin_t

 *

 * typ reprezentuj�cy numer osoby.

 */

typedef uint32_t uin_t;

/*

 * og� struktura opisuj�ca r� sesje. przydatna w klientach.

 */

#define gg_common_head(x) \

	int fd;			/* podgl�dany deskryptor */ \

	int check;		/* sprawdzamy zapis czy odczyt */ \

	int state;		/* aktualny stan maszynki */ \

	int error;		/* kod b�� dla GG_STATE_ERROR */ \

	int type;		/* rodzaj sesji */ \

	int id;			/* identyfikator */ \

	int timeout;		/* sugerowany timeout w sekundach */ \

	int (*callback)(x*); 	/* callback przy zmianach */ \

	void (*destroy)(x*); 	/* funkcja niszczenia */

struct gg_common {

	gg_common_head(struct gg_common)

};

struct gg_image_queue;

/*

 * struct gg_session

 *

 * struktura opisuj�ca dan� sesj�tworzona przez gg_login(), zwalniana

 * przez gg_free_session().

 */

struct gg_session {

	gg_common_head(struct gg_session)

	int async;      	/* czy po��czenie jest asynchroniczne */

	int pid;        	/* pid procesu resolvera */

	int port;       	/* port, z kt� si��czymy */

	int seq;        	/* numer sekwencyjny ostatniej wiadomo�ci */

	int last_pong;  	/* czas otrzymania ostatniego ping/pong */

	int last_event;		/* czas otrzymania ostatniego pakietu */

	struct gg_event *event;	/* zdarzenie po ->callback() */

	uint32_t proxy_addr;	/* adres proxy, keszowany */

	uint16_t proxy_port;	/* port proxy */

	uint32_t hub_addr;	/* adres huba po resolvni�u */

	uint32_t server_addr;	/* adres serwera, od huba */

	uint32_t client_addr;	/* adres klienta */

	uint16_t client_port;	/* port, na kt� klient s�ucha */

	uint32_t external_addr;	/* adres zewnetrzny klienta */

	uint16_t external_port;	/* port zewnetrzny klienta */

	uin_t uin;		/* numerek klienta */

	char *password;		/* i jego has�o. zwalniane automagicznie */

	int initial_status;	/* pocz�tkowy stan klienta */

	int status;		/* aktualny stan klienta */

	char *recv_buf;		/* bufor na otrzymywane pakiety */

	int recv_done;		/* ile ju� wczytano do bufora */

	int recv_left;		/* i ile jeszcze trzeba wczyta�/

	int protocol_version;	/* wersja u�ywanego protoko�u */

	char *client_version;	/* wersja u�ywanego klienta */

	int last_sysmsg;	/* ostatnia wiadomo��ystemowa */

	char *initial_descr;	/* pocz�tkowy opis stanu klienta */

	void *resolver;		/* wska�nik na informacje resolvera */

	char *header_buf;	/* bufor na pocz�tek nag�� */

	unsigned int header_done;/* ile ju� mamy */

#ifdef GG_CONFIG_HAVE_OPENSSL

	SSL *ssl;		/* sesja TLS */

	SSL_CTX *ssl_ctx;	/* kontekst sesji? */

#else

	void *ssl;		/* zachowujemy ABI */

	void *ssl_ctx;

#endif

	int image_size;		/* maksymalny rozmiar obrazk� KiB */

	char *userlist_reply;	/* fragment odpowiedzi listy kontakt�/

	int userlist_blocks;	/* na ile kawa�k�odzielono list�ontakt�/

	struct gg_image_queue *images;	/* aktualnie wczytywane obrazki */

};

/*

 * struct gg_http

 *

 * og� struktura opisuj�ca stan wszystkich operacji HTTP. tworzona

 * przez gg_http_connect(), zwalniana przez gg_http_free().

 */

struct gg_http {

	gg_common_head(struct gg_http)

	int async;              /* czy po��czenie asynchroniczne */

	int pid;                /* pid procesu resolvera */

	int port;               /* port, z kt� si��czymy */

	char *query;            /* bufor zapytania http */

	char *header;           /* bufor nag�� */

	int header_size;        /* rozmiar wczytanego nag�� */

	char *body;             /* bufor otrzymanych informacji */

	unsigned int body_size; /* oczekiwana ilo��nformacji */

	void *data;             /* dane danej operacji http */

	char *user_data;	/* dane u�ytkownika, nie s� zwalniane przez gg_http_free() */

	void *resolver;		/* wska�nik na informacje resolvera */

	unsigned int body_done;	/* ile ju� tre�ci odebrano? */

};

#ifdef __GNUC__

#define GG_PACKED __attribute__ ((packed))

#else

#define GG_PACKED

#endif

#define GG_MAX_PATH 276

/*

 * struct gg_file_info

 *

 * odpowiednik windowsowej struktury WIN32_FIND_DATA niezb�ej przy

 * wysy�aniu plik� */

struct gg_file_info {

	uint32_t mode;			/* dwFileAttributes */

	uint32_t ctime[2];		/* ftCreationTime */

	uint32_t atime[2];		/* ftLastAccessTime */

	uint32_t mtime[2];		/* ftLastWriteTime */

	uint32_t size_hi;		/* nFileSizeHigh */

	uint32_t size;			/* nFileSizeLow */

	uint32_t reserved0;		/* dwReserved0 */

	uint32_t reserved1;		/* dwReserved1 */

	unsigned char filename[GG_MAX_PATH - 14];	/* cFileName */

	unsigned char short_filename[14];		/* cAlternateFileName */

} GG_PACKED;

/*

 * struct gg_dcc

 *

 * struktura opisuj�ca nas�uchuj�ce gniazdo po��cze��y klientami.

 * tworzona przez gg_dcc_socket_create(), zwalniana przez gg_dcc_free().

 */

struct gg_dcc {

	gg_common_head(struct gg_dcc)

	struct gg_event *event;	/* opis zdarzenia */

	int active;		/* czy to my si��czymy? */

	int port;		/* port, na kt� siedzi */

	uin_t uin;		/* uin klienta */

	uin_t peer_uin;		/* uin drugiej strony */

	int file_fd;		/* deskryptor pliku */

	unsigned int offset;	/* offset w pliku */

	unsigned int chunk_size;/* rozmiar kawa�ka */

	unsigned int chunk_offset;/* offset w aktualnym kawa�ku */

	struct gg_file_info file_info;

				/* informacje o pliku */

	int established;	/* po��czenie ustanowione */

	char *voice_buf;	/* bufor na pakiet po��czenia g�osowego */

	int incoming;		/* po��czenie przychodz�ce */

	char *chunk_buf;	/* bufor na kawa�ek danych */

	uint32_t remote_addr;	/* adres drugiej strony */

	uint16_t remote_port;	/* port drugiej strony */

};

/*

 * enum gg_session_t

 *

 * rodzaje sesji.

 */

enum gg_session_t {

	GG_SESSION_GG = 1,	/* po��czenie z serwerem gg */

	GG_SESSION_HTTP,	/* og� sesja http */

	GG_SESSION_SEARCH,	/* szukanie */

	GG_SESSION_REGISTER,	/* rejestrowanie */

	GG_SESSION_REMIND,	/* przypominanie has�a */

	GG_SESSION_PASSWD,	/* zmiana has�a */

	GG_SESSION_CHANGE,	/* zmiana informacji o sobie */

	GG_SESSION_DCC,		/* og� po��czenie DCC */

	GG_SESSION_DCC_SOCKET,	/* nas�uchuj�cy socket */

	GG_SESSION_DCC_SEND,	/* wysy�anie pliku */

	GG_SESSION_DCC_GET,	/* odbieranie pliku */

	GG_SESSION_DCC_VOICE,	/* rozmowa g�osowa */

	GG_SESSION_USERLIST_GET,	/* pobieranie userlisty */

	GG_SESSION_USERLIST_PUT,	/* wysy�anie userlisty */

	GG_SESSION_UNREGISTER,	/* usuwanie konta */

	GG_SESSION_USERLIST_REMOVE,	/* usuwanie userlisty */

	GG_SESSION_TOKEN,	/* pobieranie tokenu */

	GG_SESSION_USER0 = 256,	/* zdefiniowana dla u�ytkownika */

	GG_SESSION_USER1,	/* j.w. */

	GG_SESSION_USER2,	/* j.w. */

	GG_SESSION_USER3,	/* j.w. */

	GG_SESSION_USER4,	/* j.w. */

	GG_SESSION_USER5,	/* j.w. */

	GG_SESSION_USER6,	/* j.w. */

	GG_SESSION_USER7	/* j.w. */

};

/*

 * enum gg_state_t

 *

 * opisuje stan asynchronicznej maszyny.

 */

enum gg_state_t {

		/* wsp� */

	GG_STATE_IDLE = 0,		/* nie powinno wyst�pi�*/

	GG_STATE_RESOLVING,             /* wywo�a� gethostbyname() */

	GG_STATE_CONNECTING,            /* wywo�a� connect() */

	GG_STATE_READING_DATA,		/* czeka na dane http */

	GG_STATE_ERROR,			/* wyst�pi� b��d. kod w x->error */

		/* gg_session */

	GG_STATE_CONNECTING_HUB,	/* wywo�a� connect() na huba */

	GG_STATE_CONNECTING_GG,         /* wywo�a� connect() na serwer */

	GG_STATE_READING_KEY,           /* czeka na klucz */

	GG_STATE_READING_REPLY,         /* czeka na odpowied� */

	GG_STATE_CONNECTED,             /* po��czy� si�/

		/* gg_http */

	GG_STATE_SENDING_QUERY,		/* wysy�a zapytanie http */

	GG_STATE_READING_HEADER,	/* czeka na nag�� http */

	GG_STATE_PARSING,               /* przetwarza dane */

	GG_STATE_DONE,                  /* sko�� */

		/* gg_dcc */

	GG_STATE_LISTENING,		/* czeka na po��czenia */

	GG_STATE_READING_UIN_1,		/* czeka na uin peera */

	GG_STATE_READING_UIN_2,		/* czeka na sw�in */

	GG_STATE_SENDING_ACK,		/* wysy�a potwierdzenie dcc */

	GG_STATE_READING_ACK,		/* czeka na potwierdzenie dcc */

	GG_STATE_READING_REQUEST,	/* czeka na komend�/

	GG_STATE_SENDING_REQUEST,	/* wysy�a komend�/

	GG_STATE_SENDING_FILE_INFO,	/* wysy�a informacje o pliku */

	GG_STATE_READING_PRE_FILE_INFO,	/* czeka na pakiet przed file_info */

	GG_STATE_READING_FILE_INFO,	/* czeka na informacje o pliku */

	GG_STATE_SENDING_FILE_ACK,	/* wysy�a potwierdzenie pliku */

	GG_STATE_READING_FILE_ACK,	/* czeka na potwierdzenie pliku */

	GG_STATE_SENDING_FILE_HEADER,	/* wysy�a nag�� pliku */

	GG_STATE_READING_FILE_HEADER,	/* czeka na nag�� */

	GG_STATE_GETTING_FILE,		/* odbiera plik */

	GG_STATE_SENDING_FILE,		/* wysy�a plik */

	GG_STATE_READING_VOICE_ACK,	/* czeka na potwierdzenie voip */

	GG_STATE_READING_VOICE_HEADER,	/* czeka na rodzaj bloku voip */

	GG_STATE_READING_VOICE_SIZE,	/* czeka na rozmiar bloku voip */

	GG_STATE_READING_VOICE_DATA,	/* czeka na dane voip */

	GG_STATE_SENDING_VOICE_ACK,	/* wysy�a potwierdzenie voip */

	GG_STATE_SENDING_VOICE_REQUEST,	/* wysy�a ��danie voip */

	GG_STATE_READING_TYPE,		/* czeka na typ po��czenia */

	/* nowe. bez sensu jest to API. */

	GG_STATE_TLS_NEGOTIATION	/* negocjuje po��czenie TLS */

};

/*

 * enum gg_check_t

 *

 * informuje, co proces klienta powinien sprawdzi�a deskryptorze danego

 * po��czenia.

 */

enum gg_check_t {

	GG_CHECK_NONE = 0,		/* nic. nie powinno wyst�pi�/

	GG_CHECK_WRITE = 1,		/* sprawdzamy mo�liwo��apisu */

	GG_CHECK_READ = 2		/* sprawdzamy mo�liwo��dczytu */

};

/*

 * struct gg_login_params

 *

 * parametry gg_login(). przeniesiono do struktury, �eby unikn��roblem�* z ci�g�ymi zmianami API, gdy dodano co� nowego do protoko�u.

 */

struct gg_login_params {

	uin_t uin;			/* numerek */

	char *password;			/* has�o */

	int async;			/* asynchroniczne sockety? */

	int status;			/* pocz�tkowy status klienta */

	char *status_descr;		/* opis statusu */

	uint32_t server_addr;		/* adres serwera gg */

	uint16_t server_port;		/* port serwera gg */

	uint32_t client_addr;		/* adres dcc klienta */

	uint16_t client_port;		/* port dcc klienta */

	int protocol_version;		/* wersja protoko�u */

	char *client_version;		/* wersja klienta */

	int has_audio;			/* czy ma d�wi� */

	int last_sysmsg;		/* ostatnia wiadomo��ystemowa */

	uint32_t external_addr;		/* adres widziany na zewnatrz */

	uint16_t external_port;		/* port widziany na zewnatrz */

	int tls;			/* czy ��czymy po TLS? */

	int image_size;			/* maksymalny rozmiar obrazka w KiB */

	int era_omnix;			/* czy udawa�lienta era omnix? */

	char dummy[6 * sizeof(int)];	/* miejsce na kolejnych 6 zmiennych,

					 * �eby z dodaniem parametru nie

					 * zmienia� si�ozmiar struktury */

};

struct gg_session *gg_login(const struct gg_login_params *p);

void gg_free_session(struct gg_session *sess);

void gg_logoff(struct gg_session *sess);

int gg_change_status(struct gg_session *sess, int status);

int gg_change_status_descr(struct gg_session *sess, int status, const char *descr);

int gg_change_status_descr_time(struct gg_session *sess, int status, const char *descr, int time);

int gg_send_message(struct gg_session *sess, int msgclass, uin_t recipient, const unsigned char *message);

int gg_send_message_richtext(struct gg_session *sess, int msgclass, uin_t recipient, const unsigned char *message, const unsigned char *format, int formatlen);

int gg_send_message_confer(struct gg_session *sess, int msgclass, int recipients_count, uin_t *recipients, const unsigned char *message);

int gg_send_message_confer_richtext(struct gg_session *sess, int msgclass, int recipients_count, uin_t *recipients, const unsigned char *message, const unsigned char *format, int formatlen);

int gg_send_message_ctcp(struct gg_session *sess, int msgclass, uin_t recipient, const unsigned char *message, int message_len);

int gg_ping(struct gg_session *sess);

int gg_userlist_request(struct gg_session *sess, char type, const char *request);

int gg_image_request(struct gg_session *sess, uin_t recipient, int size, uint32_t crc32);

int gg_image_reply(struct gg_session *sess, uin_t recipient, const char *filename, const char *image, int size);

uint32_t gg_crc32(uint32_t crc, const unsigned char *buf, int len);

struct gg_image_queue {

	uin_t sender;			/* nadawca obrazka */

	uint32_t size;			/* rozmiar */

	uint32_t crc32;			/* suma kontrolna */

	char *filename;			/* nazwa pliku */

	char *image;			/* bufor z obrazem */

	uint32_t done;			/* ile ju� wczytano */

	struct gg_image_queue *next;	/* nast�y na li�cie */

};

/*

 * enum gg_event_t

 *

 * rodzaje zdarze�*/

enum gg_event_t {

	GG_EVENT_NONE = 0,		/* nic si�ie wydarzy�o */

	GG_EVENT_MSG,			/* otrzymano wiadomo��/

	GG_EVENT_NOTIFY,		/* kto� si�ojawi� */

	GG_EVENT_NOTIFY_DESCR,		/* kto� si�ojawi� z opisem */

	GG_EVENT_STATUS,		/* kto� zmieni� stan */

	GG_EVENT_ACK,			/* potwierdzenie wys�ania wiadomo�ci */

	GG_EVENT_PONG,			/* pakiet pong */

	GG_EVENT_CONN_FAILED,		/* po��czenie si�ie uda�o */

	GG_EVENT_CONN_SUCCESS,		/* po��czenie si�owiod�o */

	GG_EVENT_DISCONNECT,		/* serwer zrywa po��czenie */

	GG_EVENT_DCC_NEW,		/* nowe po��czenie mi�y klientami */

	GG_EVENT_DCC_ERROR,		/* b��d po��czenia mi�y klientami */

	GG_EVENT_DCC_DONE,		/* zako�no po��czenie */

	GG_EVENT_DCC_CLIENT_ACCEPT,	/* moment akceptacji klienta */

	GG_EVENT_DCC_CALLBACK,		/* klient si�o��czy� na ��danie */

	GG_EVENT_DCC_NEED_FILE_INFO,	/* nale�y wype�ni�ile_info */

	GG_EVENT_DCC_NEED_FILE_ACK,	/* czeka na potwierdzenie pliku */

	GG_EVENT_DCC_NEED_VOICE_ACK,	/* czeka na potwierdzenie rozmowy */

	GG_EVENT_DCC_VOICE_DATA, 	/* ramka danych rozmowy g�osowej */

	GG_EVENT_PUBDIR50_SEARCH_REPLY,	/* odpowiedz wyszukiwania */

	GG_EVENT_PUBDIR50_READ,		/* odczytano w�asne dane z katalogu */

	GG_EVENT_PUBDIR50_WRITE,	/* wpisano w�asne dane do katalogu */

	GG_EVENT_STATUS60,		/* kto� zmieni� stan w GG 6.0 */

	GG_EVENT_NOTIFY60,		/* kto� si�ojawi� w GG 6.0 */

	GG_EVENT_USERLIST,		/* odpowied� listy kontakt� GG 6.0 */

	GG_EVENT_IMAGE_REQUEST,		/* pro�ba o wys�anie obrazka GG 6.0 */

	GG_EVENT_IMAGE_REPLY,		/* podes�any obrazek GG 6.0 */

	GG_EVENT_DCC_ACK		/* potwierdzenie transmisji */

};

#define GG_EVENT_SEARCH50_REPLY GG_EVENT_PUBDIR50_SEARCH_REPLY

/*

 * enum gg_failure_t

 *

 * okre�la pow�ieudanego po��czenia.

 */

enum gg_failure_t {

	GG_FAILURE_RESOLVING = 1,	/* nie znaleziono serwera */

	GG_FAILURE_CONNECTING,		/* nie mo�na si�o��czy�/

	GG_FAILURE_INVALID,		/* serwer zwr� nieprawid�owe dane */

	GG_FAILURE_READING,		/* zerwano po��czenie podczas odczytu */

	GG_FAILURE_WRITING,		/* zerwano po��czenie podczas zapisu */

	GG_FAILURE_PASSWORD,		/* nieprawid�owe has�o */

	GG_FAILURE_404, 		/* XXX nieu�ywane */

	GG_FAILURE_TLS,			/* b��d negocjacji TLS */

	GG_FAILURE_NEED_EMAIL, 		/* serwer roz��czy� nas z pro�b� o zmian�maila */

	GG_FAILURE_INTRUDER,		/* za du�o pr�o��czenia si� nieprawid�owym has�em */

	GG_FAILURE_UNAVAILABLE		/* serwery s� wy��czone */

};

/*

 * enum gg_error_t

 *

 * okre�la rodzaj b�� wywo�anego przez dan� operacj�nie zawiera

 * przesadnie szczeg�ych informacji o powodzie b��, by nie komplikowa�* obs�ugi b��w. je�li wymagana jest wi�za dok�adno��nale�y sprawdzi�* zawarto��miennej errno.

 */

enum gg_error_t {

	GG_ERROR_RESOLVING = 1,		/* b��d znajdowania hosta */

	GG_ERROR_CONNECTING,		/* b��d �aczenia si�/

	GG_ERROR_READING,		/* b��d odczytu */

	GG_ERROR_WRITING,		/* b��d wysy�ania */

	GG_ERROR_DCC_HANDSHAKE,		/* b��d negocjacji */

	GG_ERROR_DCC_FILE,		/* b��d odczytu/zapisu pliku */

	GG_ERROR_DCC_EOF,		/* plik si�ko��? */

	GG_ERROR_DCC_NET,		/* b��d wysy�ania/odbierania */

	GG_ERROR_DCC_REFUSED 		/* po��czenie odrzucone przez usera */

};

/*

 * struktury dotycz�ce wyszukiwania w GG 5.0. NIE NALE�Y SI�DO NICH

 * ODWO�YWA�BEZPO�REDNIO! do dost� do nich s�u�� funkcje gg_pubdir50_*()

 */

struct gg_pubdir50_entry {

	int num;

	char *field;

	char *value;

};

struct gg_pubdir50_s {

	int count;

	uin_t next;

	int type;

	uint32_t seq;

	struct gg_pubdir50_entry *entries;

	int entries_count;

};

/*

 * typedef gg_pubdir_50_t

 *

 * typ opisuj�cy zapytanie lub wynik zapytania katalogu publicznego

 * z protoko�u GG 5.0. nie nale�y si�dwo�ywa�ezpo�rednio do jego

 * p�- s�u�� do tego funkcje gg_pubdir50_*()

 */

typedef struct gg_pubdir50_s *gg_pubdir50_t;

/*

 * struct gg_event

 *

 * struktura opisuj�ca rodzaj zdarzenia. wychodzi z gg_watch_fd() lub

 * z gg_dcc_watch_fd()

 */

struct gg_event {

	int type;	/* rodzaj zdarzenia -- gg_event_t */

	union {		/* @event */

		struct gg_notify_reply *notify;	/* informacje o li�cie kontakt�- GG_EVENT_NOTIFY */

		enum gg_failure_t failure;	/* b��d po��czenia -- GG_EVENT_FAILURE */

		struct gg_dcc *dcc_new;		/* nowe po��czenie bezpo�rednie -- GG_EVENT_DCC_NEW */

		int dcc_error;			/* b��d po��czenia bezpo�redniego -- GG_EVENT_DCC_ERROR */

		gg_pubdir50_t pubdir50;		/* wynik operacji zwi�zanej z katalogiem publicznym -- GG_EVENT_PUBDIR50_* */

		struct {			/* @msg odebrano wiadomo��- GG_EVENT_MSG */

			uin_t sender;		/* numer nadawcy */

			int msgclass;		/* klasa wiadomo�ci */

			time_t time;		/* czas nadania */

			unsigned char *message;	/* tre��iadomo�ci */

			int recipients_count;	/* ilo��dbiorc�onferencji */

			uin_t *recipients;	/* odbiorcy konferencji */

			int formats_length;	/* d�ugo��nformacji o formatowaniu tekstu */

			void *formats;		/* informacje o formatowaniu tekstu */

		} msg;

		struct {			/* @notify_descr informacje o li�cie kontakt� opisami stanu -- GG_EVENT_NOTIFY_DESCR */

			struct gg_notify_reply *notify;	/* informacje o li�cie kontakt�/

			char *descr;		/* opis stanu */

		} notify_descr;

		struct {			/* @status zmiana stanu -- GG_EVENT_STATUS */

			uin_t uin;		/* numer */

			uint32_t status;	/* nowy stan */

			char *descr;		/* opis stanu */

		} status;

		struct {			/* @status60 zmiana stanu -- GG_EVENT_STATUS60 */

			uin_t uin;		/* numer */

			int status;	/* nowy stan */

			uint32_t remote_ip;	/* adres ip */

			uint16_t remote_port;	/* port */

			int version;	/* wersja klienta */

			int image_size;	/* maksymalny rozmiar grafiki w KiB */

			char *descr;		/* opis stanu */

			time_t time;		/* czas powrotu */

		} status60;

		struct {			/* @notify60 informacja o li�cie kontakt�- GG_EVENT_NOTIFY60 */

			uin_t uin;		/* numer */

			int status;	/* stan */

			uint32_t remote_ip;	/* adres ip */

			uint16_t remote_port;	/* port */

			int version;	/* wersja klienta */

			int image_size;	/* maksymalny rozmiar grafiki w KiB */

			char *descr;		/* opis stanu */

			time_t time;		/* czas powrotu */

		} *notify60;

		struct {			/* @ack potwierdzenie wiadomo�ci -- GG_EVENT_ACK */

			uin_t recipient;	/* numer odbiorcy */

			int status;		/* stan dor�enia wiadomo�ci */

			int seq;		/* numer sekwencyjny wiadomo�ci */

		} ack;

		struct {			/* @dcc_voice_data otrzymano dane d�wi�we -- GG_EVENT_DCC_VOICE_DATA */

			uint8_t *data;		/* dane d�wi�we */

			int length;		/* ilo��anych d�wi�wych */

		} dcc_voice_data;

		struct {			/* @userlist odpowied� listy kontakt�erwera */

			char type;		/* rodzaj odpowiedzi */

			char *reply;		/* tre��dpowiedzi */

		} userlist;

		struct {			/* @image_request pro�ba o obrazek */

			uin_t sender;		/* nadawca pro�by */

			uint32_t size;		/* rozmiar obrazka */

			uint32_t crc32;		/* suma kontrolna */

		} image_request;

		struct {			/* @image_reply odpowied� z obrazkiem */

			uin_t sender;		/* nadawca odpowiedzi */

			uint32_t size;		/* rozmiar obrazka */

			uint32_t crc32;		/* suma kontrolna */

			char *filename;		/* nazwa pliku */

			char *image;		/* bufor z obrazkiem */

		} image_reply;

	} event;

};

struct gg_event *gg_watch_fd(struct gg_session *sess);

void gg_event_free(struct gg_event *e);

#define gg_free_event gg_event_free

/*

 * funkcje obs�ugi listy kontakt� */

int gg_notify_ex(struct gg_session *sess, uin_t *userlist, char *types, int count);

int gg_notify(struct gg_session *sess, uin_t *userlist, int count);

int gg_add_notify_ex(struct gg_session *sess, uin_t uin, char type);

int gg_add_notify(struct gg_session *sess, uin_t uin);

int gg_remove_notify_ex(struct gg_session *sess, uin_t uin, char type);

int gg_remove_notify(struct gg_session *sess, uin_t uin);

/*

 * funkcje obs�ugi http.

 */

struct gg_http *gg_http_connect(const char *hostname, int port, int async, const char *method, const char *path, const char *header);

int gg_http_watch_fd(struct gg_http *h);

void gg_http_stop(struct gg_http *h);

void gg_http_free(struct gg_http *h);

void gg_http_free_fields(struct gg_http *h);

#define gg_free_http gg_http_free

/*

 * struktury opisuj�ca kryteria wyszukiwania dla gg_search(). nieaktualne,

 * zast�pione przez gg_pubdir50_t. pozostawiono je dla zachowania ABI.

 */

struct gg_search_request {

	int active;

	unsigned int start;

	char *nickname;

	char *first_name;

	char *last_name;

	char *city;

	int gender;

	int min_birth;

	int max_birth;

	char *email;

	char *phone;

	uin_t uin;

};

struct gg_search {

	int count;

	struct gg_search_result *results;

};

struct gg_search_result {

	uin_t uin;

	char *first_name;

	char *last_name;

	char *nickname;

	int born;

	int gender;

	char *city;

	int active;

};

#define GG_GENDER_NONE 0

#define GG_GENDER_FEMALE 1

#define GG_GENDER_MALE 2

/*

 * funkcje wyszukiwania.

 */

struct gg_http *gg_search(const struct gg_search_request *r, int async);

int gg_search_watch_fd(struct gg_http *f);

void gg_free_search(struct gg_http *f);

#define gg_search_free gg_free_search

const struct gg_search_request *gg_search_request_mode_0(char *nickname, char *first_name, char *last_name, char *city, int gender, int min_birth, int max_birth, int active, int start);