Referencia del Archivo util.h

Diversas funciones generales. Más...

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <sys/types.h>
#include <signal.h>
#include <gtk/gtk.h>
#include <time.h>
#include "config.h"
#include "opciones.h"
#include "socket.h"

Ir al código fuente de este archivo.

Funciones
int	bibliotecas_iniciar (int argc, char *argv[], int con_gtk)
	inicia la bibliotecas utilizadas por todos los módulos
void	bibliotecas_terminar (void)
	llamadas realizadas en común por todos los módulos del proyecto
int	leer_opciones (DuplaOpciones *opciones, int n, char *ruta)
	carga todos los parámetros de configuración de una archivo en el vector opciones
void	leer_opciones_cargar (char *buffer, DuplaOpciones *opciones, int n)
	intenta identificar una linea de configuración y decodificarla en una zona de memoria
void	quitar_barra_n (char *buffer)
	elimina el caracter especial ' ' (salto de linea) de una cadena
int	util_exec (const char *comando, GPid *pid, gboolean limpiar, char *msg)
	ejecuta un comando en 2do plano
void	mostrar_dialogo (GtkMessageType tipo, gchar *mensaje)
	muesta un dialogo de información
void	mostrar_dialogo_bloqueante (GtkWidget *ventana, GtkMessageType tipo,\char *mensaje, gboolean auto_cerrar)
	muestra un dialogo de texto bloqueando alguna ventana del programa
void	mostrar_creditos (GtkWidget *ventana)
	despliega un dialogo de créditos, con información acerca del proyecto
int	control_de_acceso (GtkWidget *ventana, char *codigo)
	muestra un cuadro de dialogo solicitando el código del administrador
int	dialogo_de_mensaje (GtkWidget *ventana_padre, char *codigo)
	muestra un cuadro de dialogo para ingresar un texto
void	quitar_guion (char *buffer)
	elimina el caracter especial '-' del legajo ingresado.

---

Descripción detallada

Diversas funciones generales.

---

Documentación de las funciones

int bibliotecas_iniciar (  int  argc, char *  argv[], int  con_gtk )

inicia la bibliotecas utilizadas por todos los módulos Parámetros: argc  cantidad de argumentos enviados por el intérprete de órdenes argv  argumentos de programa con_gtk  indica si el programa utiliza interfaces de GTK Devuelve: 1 en caso de error

int control_de_acceso (  GtkWidget *  ventana_padre, char *  codigo )

muestra un cuadro de dialogo solicitando el código del administrador Parámetros: ventana_padre  ventana padre a bloquear codigo  valor ingresado en el dialogo cifrado bajo MD5 (válido unicamente si se contesta OK) Devuelve: 0 si el usuario acepta el ingreso de contraseña, 1 en otro caso

int dialogo_de_mensaje (  GtkWidget *  ventana_padre, char *  codigo )

muestra un cuadro de dialogo para ingresar un texto Parámetros: ventana_padre  ventana padre a bloquear mensaje  ingresado en el cuadro de dialogo (512 catacteres como máximo) Devuelve: 0 si el usuario acepta enviar el mensaje, 1 en otro caso

int leer_opciones (  DuplaOpciones *  opciones, int  n, char *  ruta )

carga todos los parámetros de configuración de una archivo en el vector opciones Parámetros: opciones  venctor de duplas (NombreOpcion - Valor) n  cantidad de duplas dentro del vector opciones ruta  ruta del archivo con los parámetros de configuración Devuelve: 1 en caso de error

void leer_opciones_cargar (  char *  buffer, DuplaOpciones *  opciones, int  n )

intenta identificar una linea de configuración y decodificarla en una zona de memoria Parámetros: buffer  cadena que representa la opciones. opciones  vector de duplas 'NombreOpcion - valor', de donde se obtienen los identificadores de opciones válidas (NombreOpcion) y un espacio de almacenamiento para el valor obtenido (Valor) n  cantidad de opciones válidas

void mostrar_creditos (  GtkWidget *  ventana  )

despliega un dialogo de créditos, con información acerca del proyecto Parámetros: ventana

void mostrar_dialogo (  GtkMessageType  tipo, gchar *  mensaje )

muesta un dialogo de información Parámetros: tipo  tipo de mensaje (GTK_MESSAGE_INFO, GTK_MESSAGE_WARNING, GTK_MESSAGE_ERROR). mensaje  cadena de texto mostrada en el dialogo

void mostrar_dialogo_bloqueante (  GtkWidget *  ventana, GtkMessageType  tipo, \char *  mensaje, gboolean  auto_cerrar )

muestra un dialogo de texto bloqueando alguna ventana del programa Parámetros: ventana  ventana que deshabilita el dialogo (generalmente se utiliza la ventana principal del programa). tipo  tipo de mensaje (GTK_MESSAGE_INFO, GTK_MESSAGE_ERROR etc). mensaje  cadena de texto a mostrar auto_cerrar  indica si el programa debe cerrar la ventana automáticamente luego de 30 segundos

void quitar_barra_n (  char *  buffer  )

elimina el caracter especial ' ' (salto de linea) de una cadena Parámetros: buffer  cadena que contiene el caracter ' '. Cuidado, no debe enviar una cadena de texto constante.

void quitar_guion (  char *  buffer  )

elimina el caracter especial '-' del legajo ingresado. Parámetros: buffer  contiene el legajo ingresado.

int util_exec (  const char *  comando, GPid *  pid, gboolean  limpiar, char *  msg )

ejecuta un comando en 2do plano Parámetros: comando  comando a ejecutar pid  identificador / manejador del proceso creado limpiar  elimina automáticamente el vínculo con el proceso hijo cuando este termina (ver 'man waitpid') msg  un descripción de fallo en caso de no poder ejecutar el programa Devuelve: 1 en caso de error

---