add doxygen docs

report/sections/codigo.tex

@@ -0,0 +1,6 @@
+\section{Código}
+\input{sections/codigo/ciclo}
+\input{sections/codigo/builtins}
+\input{sections/codigo/permutar}
+\input{sections/codigo/redireccion}
+\input{sections/codigo/environ}

report/sections/codigo/builtins.tex

@@ -0,0 +1,6 @@
+\newpage
+\subsection{Builtins}
+Los builtins son comandos que son parte del shell, por lo tanto el sistema operativo no los proporciona. Un ejemplo es el comando\
+''exit''. Este comando no existe en el sistema operativo, por lo tanto el shell debe actuar cuando el usuario lo escribe en vez\
+de lanzar un proceso nuevo.
+\lstinputlisting{code/builtins.txt}

report/sections/codigo/ciclo.tex

@@ -0,0 +1,6 @@
+\subsection{Ciclo principal}
+El ciclo principal controla todo la funcionamiento del shell. El ciclo debe correr infinitamente hasta que recibe un señal o un\
+comando de salir(exit). La primera cosa que tiene que hacer en el ciclo es mostrar un mensaje de entrada y esperar que el\
+usuario ingresa un comando. Luego separar la entrada en varios argumentos. Finalmente interpretar los argumentos y decidir que\
+hacer con ellos.
+\lstinputlisting{code/loop.txt}

report/sections/codigo/environ.tex

@@ -0,0 +1,8 @@
+\newpage
+\subsection{Entorno}
+El entorno está controlado por un struct de array de strings de llaves y valores. Se inserta y busca adentro de estos array de llaves\
+para encontrar y usar el variable de entorno. En el shell el struct es usado como un variable global para que se puede accederlo\
+desde cualquier parte del código que se necesita los variables de entorno. Lo mas importante son 2 funciones, set\_array\_list y\
+get\_array\_list. Se usa set\_array\_list para insertar o sobre escribir un variable de entorno. Y el get\_array\_list retorno un\
+valor si se encuentre en el array list basado en la llava pasado a la función como parámetro.
+\lstinputlisting{code/environ.txt}

report/sections/codigo/permutar.tex

@@ -0,0 +1,6 @@
+\newpage
+\subsection{Permutar}
+Permutar es la parte responsable por correr un programa que está en el sistema operativo o en PATH. Para hacer eso\
+primer hacemos un fork donde el hijo permuta la operación y el padre espera que su hijo termina. Luego pasamos un nombre\
+de programa a permutar y sus argumentos al execvp.
+\lstinputlisting{code/launch.txt}

report/sections/codigo/redireccion.tex

@@ -0,0 +1,12 @@
+\newpage
+\subsection{Redireccionamiento}
+Para redireccionar las entradas y salidas se usa 4 comandos principales, dup, dup2, open y close. El primer paso a tomar\
+es duplicar la entrada o salida(stdin, stdout o stderr) con dup. Eso es importante para restaurarlo después. Luego se abre el archivo\
+de salida o entrada usando open y los flags correspondiente a la operación que quiere\
+hacer(O\_RDONLY, O\_WRONLY, O\_CREATE, O\_APPEND o O\_TRUNC). Después, cerra stdin, stdout o stderr. Eso va a dejar su fd disponible para\
+usar. Finalmente hacer una duplicación con dup del fd de archivo de entrad o salida. Eso va a dejar el archivo usando el fd que
+cerramos anteriormente. Ahora todos las cosas mandados al stdin, stdout o stderr van a ser redirigidas al archivo. Para terminar\
+cerramos el archivo usado. Luego usamos dup2 para duplicar la copia original en su fd original. I finalmente cerramos la copia.\
+Para que funciona eso, debe abrir el redireccionamiento antes de llamar los builtins o permutar y cerrarlo después que termina\
+correr los builtins o el proceso hijo.
+\lstinputlisting{code/redirection.txt}

report/sections/conclusiones.tex

@@ -0,0 +1,5 @@
+\section{Conclusiones}
+Lo cosa mas importante que se puede aprender del proyecto es que el shell es un puente entre el usuario y el sistema operativo.\
+El shell es responsable para lanzar programas, interpretar comandos y en shells mas avanzados interpretar un lenguaje de\
+scripting para poder facilitar tareas o automatizarlas. Por lo tanto el shell es una parte integral para el sistema operativo\
+especialmente en sistemas como GNU/Linux o BSD.

report/sections/funcionamiento.tex

@@ -0,0 +1,38 @@
+\section{Funcionamiento}
+El myshellin consiste de 3 partes importantes, los comandos "builtins", permutar y redireccionamiento.
+
+\subsection{Builtins}
+Los builtins son comandos que son proporcionados por el shell en vez de un programa que provee el sistema operativo. Los comandos\
+que proporciona el myshellin son:
+\begin{itemize}
+    \item help \newline \Quad mostrar una mensaje de ayuda de como usar el shell.
+    \item environ \newline \Quad imprimir todos los variables del entorno.
+    \item set \newline \Quad crear o sobre escribir un variable de entorno.
+    \item echo \newline \Quad imprimir un comentario o variable.
+    \item cd \newline \Quad cambiar el directorio donde está trabajando el shell.
+    \item exit \newline \Quad salir del shell.
+\end{itemize}
+
+Cuando el comando que ingreso el usuario no es un builtin el siguiente paso es tratar de permutar un software que proporciona el\
+sistema operativo.
+
+\subsection{Permutar}
+Para permutar un programa de sistema, el proceso de myshellin hace una llamada al fork para crear un proceso hijo. Luego el\
+proceso hijo intenta permutar con el comando execvp. Lo que hace eso es reemplazar el proceso hijo con el proceso del programa\
+que proporciona el sistema operativo como ls, rm, df, du, etc. Mientras que corre el programa el proceso padre espera que\
+termina el proceso hijo antes que puede seguir pidiendo que el usuario ingresa otros comandos.
+
+\newpage
+\subsection{Redireccionamiento}
+Redireccionamiento es el proceso de redirigir los contenidos de una entrada o salida al stdin, stdout o stderr. Por ejemplo\
+se puede redirigir todo el contenidos que se debe imprimir en stdout a un archivo usando el símbolo ``>`` seguido por un nombre\
+de archivo. En el shell existen los siguientes tipos de redireccionamiento:
+\begin{itemize}
+    \item > \newline \Quad redirigir el stdout a un archivo y borrar el contenido anterior si existe el archivo.
+    \item >\null> \newline \Quad redirigir el stdout a un archivo y agregue el el contenido nuevo al final del archivo si existe.
+    \item 1> \newline \Quad redirigir el stdout a un archivo y borrar el contenido anterior si existe el archivo.
+    \item 1>\null> \newline \Quad redirigir el stdout a un archivo y agregue el el contenido nuevo al final del archivo si existe.
+    \item 2> \newline \Quad redirigir el stderr a un archivo y borrar el contenido anterior si existe el archivo.
+    \item 2>\null> \newline \Quad redirigir el stderr a un archivo y agregue el el contenido nuevo al final del archivo si existe.
+    \item < \newline \Quad redirigir el contenido de un archivo al stdin.
+\end{itemize}

report/sections/introduccion.tex

@@ -0,0 +1,3 @@
+\section{Introducción}
+El propósito del proyecto semestral es crear un shell básico para aprender los básicos de que hace un shell en un sistema\
+operativo. Hay varios partes que son importante como la creación de procesos, redireccionamiento y el entorno.