Descripción de funcionamiento y uso de la librería.

A continuación se desglosan las instrucciones para el desarrollo con esta libería y su posterior uso. \par
\par
\hypertarget{howto_proto}{}\section{Descripción del protocolo}\label{howto_proto}
En las comunicaciones con Sockets hay un problema, es fácil saber la longitud del mensaje que vas a enviar, pero cuesta saber la longitud del mensaje que deseas recibir, ya que la transmisión se puede detener por llegar al fin del mensaje o bien por que hay problemas en la red.

Los sockets de U\-N\-I\-X nos dan una solución, que es usar llamadas no bloqueantes para recibir el mensaje, es decir\-: Si leo de un socket, y no he llenado el buffer donde guardo los datos que recibo de allí, la aplicación no se bloquea esperando recibir la suficiente cantidad de datos. A su vez, se usan llamadas a la función \href{http://linux.die.net/man/2/select}{\tt select()} para comprovar si hay datos disponibles a para leer o la conexión está terminada.

Esto requiere uso de la forks e ir haciendo encuesta (polling) al socket, cosa que consume más recursos del sistema.

Debido a la complejidad añadida que supone hacerlo por esta vía, ya que la librería usa threads que son más ligeros para el sistema y la memoria R\-A\-M; se ha optado por implementar un sencillísimo protocolo de comunicación que no supone gasto de computación y repercute de forma nímia en el rendimiento de la transferencia.

\par
 \hypertarget{howto_plain}{}\subsection{Modo en texto llano}\label{howto_plain}
Este modo transmite los carácteres de texto sin ningún tipo de encriptación, por lo tanto son totalmente visibles para cualquier agente intermedio. Sin embargo, el modo sin encriptación es más rápido y ofrece el doble de velocidad de transferencia aproximadamente. \par
 \hypertarget{howto_send}{}\subsection{Envío/\-Recepción de mensajes}\label{howto_send}
El mensaje se transmite de la siguiente forma\-:


\begin{DoxyEnumerate}
\item Bob le quiere mandar a Alice un mensaje, primero pone el número de carácteres (bytes) que ocupa el mensaje en forma de string terminado con carácter N\-U\-L\-L ('\textbackslash{}0').
\item Bob añade el mensaje íntegro y lo manda todo junto.
\item Alice lee uno a uno los carácteres del socket hasta encontrar un carácter N\-U\-L\-L ('\textbackslash{}0'), entonces lee lo que ha recibido, que es la longitud del mensaje real.
\item Alice pasa a extraer los N bytes que ha leído que recibiría y obtiene el mensaje final. \par
 \par
 \par
 
\end{DoxyEnumerate}\hypertarget{howto_compile}{}\section{Compilación}\label{howto_compile}
A continuación se detallan las opciones e instrucciones necesarias para compilar esta librería. \par
 \hypertarget{howto_flags}{}\subsection{Flags de compilación}\label{howto_flags}
Flags de compilación necesarios\-:
\begin{DoxyItemize}
\item -\/lpthread
\end{DoxyItemize}

\par
 \par
 \par
 \hypertarget{howto_examples}{}\section{Ejemplos}\label{howto_examples}
A continuación se detalla el código para programar una aplicación servidor cliente sencilla \par
 \hypertarget{howto_server}{}\subsection{Programar un cliente}\label{howto_server}
Véase\-: \hyperlink{client_code}{Client} \par
 \par
 