Referencia del Archivo socket.h

manejo de conectores (sockets) y mensajes de red Más...

#include <gnet.h>

Ir al código fuente de este archivo.

Enumeraciones
enum	socket_mensaje {   MSG_NULL, MSG_OK, MSG_ERROR, MSG_LOGIN,   MSG_LOGOUT, MSG_REINICIAR, MSG_APAGAR, MSG_GETDATOS,   MSG_DATOS, MSG_MENSAJE, MSG_USUARIO, MSG_SESION,   MSG_ACTUALIZAR, MSG_ACTUALIZA_SESION, MSG_SUPER_SESION }
	códigos que representan el objetivo de cada mensaje en la red Más...
Funciones
GIOChannel *	socket_obtener_io (GTcpSocket *socket)
	obtiene el canal io asociado a un socket
GTcpSocket *	socket_conectar (const char *ip, int puerto)
	utilizada para conectar un programa al servidor
int	socket_recibir (GIOChannel *io, char *cadena, int *n)
	recibe una cadena de caracteres terminados con \n (siempre)
int	socket_enviar (GIOChannel *io, char *cadena)
	envia una cadena de texto terminada con '\n'
int	socket_enviar_tipo_mensaje (GIOChannel *io, enum socket_mensaje mensaje)
	envia por el canal io un tipo de mensaje
int	socket_enviar_mensaje (GIOChannel *io, enum socket_mensaje mensaje,\int n, char *format,...)
	envia un mensaje completo, debe tener cuidado y enviar siempre NULL como último argumento.
enum socket_mensaje	socket_leer_tipo_mensaje (GIOChannel *io)
	recibe el código de mensaje
void	socket_cerrar (GTcpSocket *socket)
	elimina un socket

---

Descripción detallada

manejo de conectores (sockets) y mensajes de red

---

Documentación de las enumeraciones

enum socket_mensaje

códigos que representan el objetivo de cada mensaje en la red Valores de la enumeración: MSG_NULL  código de error, el mensáje no es válido MSG_OK  confirmación de pedido MSG_ERROR  ocurrió un error o se rechazó el pedido MSG_LOGIN  solicita iniciar una nueva sesión MSG_LOGOUT  abandona su sesión MSG_REINICIAR  se debe reiniciar el equipo MSG_APAGAR  se debe apagar el equipo MSG_GETDATOS  se solicita información del equipo MSG_DATOS  datos del equipo MSG_MENSAJE  se envía una cadena de texto al usuario MSG_USUARIO  información de un usuario de sesión MSG_SESION  se habilita una sesión de uso MSG_ACTUALIZAR  se pide actualizar la sesión de uso MSG_ACTUALIZA_SESION  se aceptó el pedido de sesión MSG_SUPER_SESION  se habilita el uso de tiempo ilimitado

---

Documentación de las funciones

void socket_cerrar (  GTcpSocket *  socket  )

elimina un socket Parámetros: socket  socket a eliminar

GTcpSocket* socket_conectar (  const char *  ip, int  puerto )

utilizada para conectar un programa al servidor Parámetros: ip  host del equipo remoto puerto  numero de servicio/puerto del equipo remoto Devuelve: socket que se conectó al equipo remoto o NULL en caso de error

int socket_enviar (  GIOChannel *  io, char *  cadena )

envia una cadena de texto terminada con '\n' Parámetros: io  canal de comunicación cadena  cadena de texto a enviar Devuelve: 1 en caso de error, 0 si fué exitosa

int socket_enviar_mensaje (  GIOChannel *  io, enum socket_mensaje  mensaje, \int  n, char *  format,   ... )

envia un mensaje completo, debe tener cuidado y enviar siempre NULL como último argumento. Parámetros: io  canal de comunicación mensaje  código de mensaje n  numero de cadenas enviadas format  formato de los argumentos variables Devuelve: 1 en caso de error, 0 si la llamada fué exitosa

int socket_enviar_tipo_mensaje (  GIOChannel *  io, enum socket_mensaje  mensaje )

envia por el canal io un tipo de mensaje Parámetros: io  canal de comunicación mensaje  código del mensaje a enviar Devuelve: 1 en caso de error, 0 en otro caso

enum socket_mensaje socket_leer_tipo_mensaje (  GIOChannel *  io  )

recibe el código de mensaje Parámetros: io  canal de comunicación Devuelve: código del mensaje recibido o _NULL_ como mensaje de error

GIOChannel* socket_obtener_io (  GTcpSocket *  socket  )

obtiene el canal io asociado a un socket Parámetros: socket  socket del cual se debe obtener el canal Devuelve: canal io asociado al socket

int socket_recibir (  GIOChannel *  io, char *  cadena, int *  n )

recibe una cadena de caracteres terminados con \n (siempre) Parámetros: io  canal de comunicación cadena  buffer de almacenamiento (mínimo de 256) n  cantidad de caracteres leidos Devuelve: 1 en caso de error (debería cerrar la conexión), 0 en otro caso

---