Dokumentacja struktury gg_session
[Połączenie z serwerem]

---

Opis szczegółowy

Sesja Gadu-Gadu.

Tworzona przez funkcję gg_login(), zwalniana przez gg_free_session().

Pola danych
int	fd
	Obserwowany deskryptor.
int	check
	Informacja o żądaniu odczytu/zapisu (patrz gg_check_t).
int	state
	Aktualny stan połączenia (patrz gg_state_t).
int	error
	Kod błędu dla GG_STATE_ERROR (patrz gg_error_t).
int	type
	Rodzaj sesji (patrz gg_session_t).
int	id
	Identyfikator sesji.
int	timeout
	Czas pozostały do zakończenia stanu.
int(*	callback )(struct gg_session *)
	Funkcja zwrotna.
void(*	destroy )(struct gg_session *)
	Funkcja zwalniania zasobów.
int	async
	Flaga połączenia asynchronicznego.
int	pid
	Numer procesu rozwiązującego nazwę serwera.
int	port
	Port serwera.
int	seq
	Numer sekwencyjny ostatniej wiadomości.
int	last_pong
	Czas otrzymania ostatniej ramki utrzymaniowej.
int	last_event
	Czas otrzymania ostatniego pakietu.
struct gg_event *	event
	Zdarzenie po wywołaniu callback.
uint32_t	proxy_addr
	Adres serwera pośredniczącego.
uint16_t	proxy_port
	Port serwera pośredniczącego.
uint32_t	hub_addr
	Adres huba po rozwiązaniu nazwy.
uint32_t	server_addr
	Adres serwera otrzymany od huba.
uint32_t	client_addr
	Adres gniazda dla połączeń bezpośrednich do wersji Gadu-Gadu 6.x.
uint16_t	client_port
	Port gniazda dla połączeń bezpośrednich do wersji Gadu-Gadu 6.x.
uint32_t	external_addr
	Publiczny adres dla połączeń bezpośrednich do wersji Gadu-Gadu 6.x.
uint16_t	external_port
	Publiczny port dla połączeń bezpośrednich do wersji Gadu-Gadu 6.x.
uin_t	uin
	Własny numer Gadu-Gadu.
char *	password
	Hasło (zwalniane po użyciu).
int	initial_status
	Początkowy status.
int	status
	Aktualny status.
char *	recv_buf
	Bufor na odbierany pakiety.
int	recv_done
	Liczba wczytanych bajtów pakietu.
int	recv_left
	Liczba pozostałych do wczytania bajtów pakietu.
int	protocol_version
	Wersja protokołu.
char *	client_version
	Wersja klienta.
int	last_sysmsg
	Numer ostatniej wiadomości systemowej.
char *	initial_descr
	Początkowy opis statusu.
void *	resolver
	Dane prywatne procesu lub wątku rozwiązującego nazwę serwera.
char *	header_buf
	Bufor na początek nagłówka pakietu.
unsigned int	header_done
	Liczba wczytanych bajtów nagłówka pakietu.
void *	ssl
	Struktura TLS.
void *	ssl_ctx
	Kontekst sesji TLS.
int	image_size
	Maksymalny rozmiar obsługiwanych obrazków w KiB.
char *	userlist_reply
	Bufor z odbieraną listą kontaktów.
int	userlist_blocks
	Liczba części listy kontaktów.
struct gg_image_queue *	images
	Lista wczytywanych obrazków.
int	hash_type
	Rodzaj funkcji skrótu hasła.
char *	send_buf
	Bufor z danymi do wysłania.
int	send_left
	Liczba bajtów do wysłania.
struct gg_dcc7 *	dcc7_list
	Lista połączeń bezpośrednich skojarzonych z sesją.
int	soft_timeout
	Flaga mówiąca, że po przekroczeniu timeout należy wywołać gg_watch_fd().

---

Dokumentacja pól

int fd

Obserwowany deskryptor.

int check

Informacja o żądaniu odczytu/zapisu (patrz gg_check_t).

int state

Aktualny stan połączenia (patrz gg_state_t).

int error

Kod błędu dla GG_STATE_ERROR (patrz gg_error_t).

int type

Rodzaj sesji (patrz gg_session_t).

int id

Identyfikator sesji.

int timeout

Czas pozostały do zakończenia stanu.

int(* callback)(struct gg_session *)

Funkcja zwrotna.

void(* destroy)(struct gg_session *)

Funkcja zwalniania zasobów.

int async

Flaga połączenia asynchronicznego.

int pid

Numer procesu rozwiązującego nazwę serwera.

int port

Port serwera.

int seq

Numer sekwencyjny ostatniej wiadomości.

int last_pong

Czas otrzymania ostatniej ramki utrzymaniowej.

int last_event

Czas otrzymania ostatniego pakietu.

struct gg_event* event [read]

Zdarzenie po wywołaniu callback.

uint32_t proxy_addr

Adres serwera pośredniczącego.

uint16_t proxy_port

Port serwera pośredniczącego.

uint32_t hub_addr

Adres huba po rozwiązaniu nazwy.

uint32_t server_addr

Adres serwera otrzymany od huba.

uint32_t client_addr

Adres gniazda dla połączeń bezpośrednich do wersji Gadu-Gadu 6.x.

uint16_t client_port

Port gniazda dla połączeń bezpośrednich do wersji Gadu-Gadu 6.x.

uint32_t external_addr

Publiczny adres dla połączeń bezpośrednich do wersji Gadu-Gadu 6.x.

uint16_t external_port

Publiczny port dla połączeń bezpośrednich do wersji Gadu-Gadu 6.x.

uin_t uin

Własny numer Gadu-Gadu.

char* password

Hasło (zwalniane po użyciu).

int initial_status

Początkowy status.

int status

Aktualny status.

char* recv_buf

Bufor na odbierany pakiety.

int recv_done

Liczba wczytanych bajtów pakietu.

int recv_left

Liczba pozostałych do wczytania bajtów pakietu.

int protocol_version

Wersja protokołu.

char* client_version

Wersja klienta.

int last_sysmsg

Numer ostatniej wiadomości systemowej.

char* initial_descr

Początkowy opis statusu.

void* resolver

Dane prywatne procesu lub wątku rozwiązującego nazwę serwera.

char* header_buf

Bufor na początek nagłówka pakietu.

unsigned int header_done

Liczba wczytanych bajtów nagłówka pakietu.

void* ssl

Struktura TLS.

void* ssl_ctx

Kontekst sesji TLS.

int image_size

Maksymalny rozmiar obsługiwanych obrazków w KiB.

char* userlist_reply

Bufor z odbieraną listą kontaktów.

int userlist_blocks

Liczba części listy kontaktów.

struct gg_image_queue* images [read]

Lista wczytywanych obrazków.

int hash_type

Rodzaj funkcji skrótu hasła.

char* send_buf

Bufor z danymi do wysłania.

int send_left

Liczba bajtów do wysłania.

struct gg_dcc7* dcc7_list [read]

Lista połączeń bezpośrednich skojarzonych z sesją.

int soft_timeout

Flaga mówiąca, że po przekroczeniu timeout należy wywołać gg_watch_fd().

---

Dokumentacja dla tej struktury została wygenerowana z pliku:

• libgadu.h