Referencia del Archivo login.h

Programa Login. Más...

#include "util.h"
#include "socket.h"

Ir al código fuente de este archivo.

Tipos definidos
typedef login	Login
	Módulo login.
Funciones
int	login_iniciar (Login *data, int argc, char *argv[])
	inicializa todos los recursos del Login
int	login_iniciar_identificar (Login *data)
	Se indentifica ante el programa Servidor.
int	login_cargar_opciones (Login *data)
	interpreta las opciones del archivo de configuración
int	login_conectar_al_servidor (Login *data)
	Se conecta e identifica ante el programa servidor.
void	login_mostrar_error_conexion (Login *data, char *ip, int puerto)
	imprime un cuadro de dialogo con el fallo de conexión (bloquea la ventana principal)
void	login_iniciar_ventana (Login *data)
	genera la ventana principal, donde se debe ingresar nombre y password
void	login_iniciar_ventana_crear_componentes (Login *data)
	inicializa los componentes de la primer ventana
void	login_iniciar_ventana_conectar (Login *data)
	interconecta eventos y señales
void	login_ingresar (GtkWidget *widget, gpointer *_data)
	envia el legajo y contraseñas para ingresar
void	login_salida_con_error (Login *data, char *detalle)
	Muestra un mensaje de fallo grave y aborta el programa.
void	login_signal (int num)
	gestor de señales como SIGPIPE o SIGINT param num identificador numérico de la señal capturada
int	login_ejecutar_gestor (Login *data, int tiempo)
	ejecuta el gestor de sesión (gnome, xfce, kde etc).
void	login_termino_gestor (GPid pid, gint status, gpointer _data)
	gestiona la salida del programa gestor, cierra el proceso en base a su pid y termina la ejecución del programa.
void	login_terminar_sesion (Login *data)
	termina la sesión de uso
void	login_actualizar_sesion (GtkWidget *widget, gpointer *_data)
	solicita al servidor una nueva sesión
void	login_solicitar_nueva_sesion (Login *data)
	pide al servidor una renovación de sesión
void	login_crear_reloj (Login *data, int tiempo)
	genera, conecta y muestra un reloj para el usuario de sesión
gint	login_reloj_actualizar (gpointer _data)
	descuenta un segundo del reloj de sesión y lo actualiza
void	login_mostrar_menu (GtkWidget *widget, gpointer *_data)
	despliega el menú de opciones
void	login_acerca_de (GtkWidget *widget, gpointer *_data)
	muestra el cuadro de dialogo con los créditos del programa
gboolean	login_atender_servidor (GIOChannel *io, GIOCondition cond,\gpointer data)
	Procesa un evento producido por el programa Servidor.
void	login_atender_mensaje (Login *data, GIOChannel *io)
	atiene un MENSAJE de aviso enviado por el servidor
void	login_atender_logout (Login *data, GIOChannel *io)
	atiende el pedido de fin de sesión (LOGOUT) enviado por el servidor
void	login_atender_reiniciar (Login *data, GIOChannel *io)
	atiende el pedido REINICIAR equipo enviado por el servidor
void	login_atender_apagar (Login *data, GIOChannel *io)
	atiende el pedido APAGAR equipo enviado por el servidor
void	login_atender_error (Login *data, GIOChannel *io)
	le informan un mensaje de error, lo muestra en pantalla
void	login_atender_actualiza_sesion (Login *data, GIOChannel *io)
	recibe la notificación de actualización de sesión
void	login_atender_sesion (Login *data, GIOChannel *io)
	atiende el mensaje SESION que indica la habilitación por parte del programa Servidor
void	login_atender_super_sesion (Login *data, GIOChannel *io)
	recibe un permiso de sesión ilimitada
void	login_deshabilitar_renovacion (Login *data)
	Altera el estado del botón `Renovar sesión` del menú principal.

---

Descripción detallada

Programa Login.

---

Documentación de las funciones

void login_acerca_de (  GtkWidget *  widget, gpointer *  _data )

muestra el cuadro de dialogo con los créditos del programa Parámetros: widget  ventana a bloquear _data  Login principal

void login_actualizar_sesion (  GtkWidget *  widget, gpointer *  _data )

solicita al servidor una nueva sesión Parámetros: widget  componente que genera el evento _data  Login principal

void login_atender_actualiza_sesion (  Login *  data, GIOChannel *  io )

recibe la notificación de actualización de sesión Parámetros: data  Login principal io  canal io asociado al programa servidor

void login_atender_apagar (  Login *  data, GIOChannel *  io )

atiende el pedido APAGAR equipo enviado por el servidor Parámetros: data  Login principal io  canal asociado al programa servidor

void login_atender_error (  Login *  data, GIOChannel *  io )

le informan un mensaje de error, lo muestra en pantalla Parámetros: data  Login principal io  canal io asociado al programa servidor

void login_atender_logout (  Login *  data, GIOChannel *  io )

atiende el pedido de fin de sesión (LOGOUT) enviado por el servidor Parámetros: data  Login principal io  canal asociado al programa servidor

void login_atender_mensaje (  Login *  data, GIOChannel *  io )

atiene un MENSAJE de aviso enviado por el servidor Parámetros: data  Login principal io  canal asociado al programa servidor

void login_atender_reiniciar (  Login *  data, GIOChannel *  io )

atiende el pedido REINICIAR equipo enviado por el servidor Parámetros: data  Login principal io  canal asociado al programa servidor

gboolean login_atender_servidor (  GIOChannel *  io, GIOCondition  cond, \gpointer  _data )

Procesa un evento producido por el programa Servidor. Parámetros: io  canal de comunicación cond  estado del canal _data  Login principal Devuelve: parámetro interno de la biblioteca, TRUE indica que se deben seguir atendiendo próximos eventos para asociados a ese canal.

void login_atender_sesion (  Login *  data, GIOChannel *  io )

atiende el mensaje SESION que indica la habilitación por parte del programa Servidor Parámetros: data  Login principal io  canal asociado al programa servidor

void login_atender_super_sesion (  Login *  data, GIOChannel *  io )

recibe un permiso de sesión ilimitada Parámetros: data  Login principal io  canal io asociado al programa servidor

int login_cargar_opciones (  Login *  data  )

interpreta las opciones del archivo de configuración Parámetros: data  Login principal Devuelve: 1 en caso de error, 0 si tiene éxito

int login_conectar_al_servidor (  Login *  data  )

Se conecta e identifica ante el programa servidor. Parámetros: data  Login principal Devuelve: 1 en caso de error, 0 si tiene éxito

void login_crear_reloj (  Login *  data, int  tiempo )

genera, conecta y muestra un reloj para el usuario de sesión Parámetros: data  Login principal tiempo  cantidad de segundos que durará la primer sesión

void login_deshabilitar_renovacion (  Login *  data  )

Altera el estado del botón `Renovar sesión` del menú principal. Parámetros: data  módulo principal

int login_ejecutar_gestor (  Login *  data, int  tiempo )

ejecuta el gestor de sesión (gnome, xfce, kde etc). Parámetros: data  Login principal tiempo  cantidad de segundos que dura esta primer sesión Devuelve: 1 si no encuentra el gestor, 0 en otro caso

void login_ingresar (  GtkWidget *  widget, gpointer *  _data )

envia el legajo y contraseñas para ingresar Parámetros: widget  componente que generó la señal _data  Login principal

int login_iniciar (  Login *  data, int  argc, char *  argv[] )

inicializa todos los recursos del Login Parámetros: data  Login principal argc  cantidad de parámetros recibidos desde el intérprete de ordenes argv  cadenas de texto asociadas a cada parámetro Devuelve: 1 en caso de error, 0 en otro caso

int login_iniciar_identificar (  Login *  data  )

Se indentifica ante el programa Servidor. Parámetros: data  Login principal Devuelve: 1 en caso de rechazo, 0 si puede continuar

void login_iniciar_ventana (  Login *  data  )

genera la ventana principal, donde se debe ingresar nombre y password Parámetros: data  Login principal

void login_iniciar_ventana_conectar (  Login *  data  )

interconecta eventos y señales Parámetros: data  Login principal

void login_iniciar_ventana_crear_componentes (  Login *  data  )

inicializa los componentes de la primer ventana Parámetros: data  Login principal

void login_mostrar_error_conexion (  Login *  data, char *  ip, int  puerto )

imprime un cuadro de dialogo con el fallo de conexión (bloquea la ventana principal) Parámetros: data  Login principal ip  ip del equipo al que se desea conectar puerto  número de servidor del equipo al que se desea conectar

void login_mostrar_menu (  GtkWidget *  widget, gpointer *  _data )

despliega el menú de opciones Parámetros: widget  boton que activa la señal _data  Login principal

gint login_reloj_actualizar (  gpointer  _data  )

descuenta un segundo del reloj de sesión y lo actualiza Parámetros: _data  Login principal

void login_salida_con_error (  Login *  data, char *  detalle )

Muestra un mensaje de fallo grave y aborta el programa. Parámetros: data  Login principal detalle  una descripción mas detallada del problema

void login_solicitar_nueva_sesion (  Login *  data  )

pide al servidor una renovación de sesión Parámetros: data  Login principal

void login_terminar_sesion (  Login *  data  )

termina la sesión de uso Parámetros: data  Login principal

void login_termino_gestor (  GPid  pid, gint  status, gpointer  _data )

gestiona la salida del programa gestor, cierra el proceso en base a su pid y termina la ejecución del programa. Parámetros: pid  identificador de proceso asignado al escritorio status  estado de salida _data  Login principal

---