README-es.md edited online with Bitbucket

README-es.md

 
 ![header.png](images/header.png)  
 
+[Verano 2016 - Ive]
 
 La *programación orientada a objetos* (object oriented programming, OOP) es un paradigma de programación que promueve el diseño de programas en el que distintos objetos interactúan entre sí para resolver un problema.   C++ es uno de los lenguajes de programación que promueve la programación orientada a objetos, permitiendo que los programadores creen sus propias clases desde cero o derivadas de otras clases existentes. Algunos otros lenguajes que promueven OOP son Java, Python, javascript y PHP.   
 
 3. **Ether Type**: se utiliza para indicar el tipo de de protocolo utilizado en el **payload**. Uno de los **payloads** posibles es un paquete de IP.
 4. **Payload**: contiene un paquete de IP (en realidad puede contener otras cosas, pero para esta experiencia de laboratorio asumiremos que contiene solo IP).
 
-Dentro del payload, el paquete de IP contiene varios campos, entre ellos:
+Dentro del "payload", el paquete de IP contiene varios campos, entre ellos:
 
 1. Las direcciones **IP fuente y destino**
 2. Los números de **puerto fuente y destino**
 La aplicación que completarás hoy permite a los usuarios analizar el tráfico de red y monitorear las imágenes que están siendo transferidas a través de tu red.
 
 
+La Figura 2 muestra una foto de la interfaz de la aplicación. Cada fila en la tabla es la información de un paquete capturado. La caja de texto bajo la tabla presenta un resumen del paquete seleccionado en la tabla. La lista en el lado derecho presenta las imágenes que han sido capturadas por el sniffer.
+
+
 ---
 
 ![figure2.png](images/figure2.png)
 ---
 
 
-
-
-La Figura 2 muestra una foto de la interfaz de la aplicación. Cada fila en la tabla es la información de un paquete capturado. La caja de texto bajo la tabla presenta un resumen del paquete seleccionado en la tabla. La lista en el lado derecho presenta las imágenes que han sido capturadas por el sniffer.
-
-
 Para crear un sniffer de paquetes puedes usar la librería de *pcap* que provee una interfaz para accesar la data que está pasando a través de la tarjeta de red de tu computadora.  Esta librería contiene una función que devuelve un torrente crudo de los bytes de cada paquete capturado.
 
 La tarea del programador del sniffer es decodificar el torrente en crudo a información legible por humanos.  Afortunadamente esta no va a ser tu tarea, pero tu puedes aprender a hacerlo, si quieres, leyendo el código fuente de este laboratorio.  Tu tarea es seguir los ejercicios de abajo para que puedas proveerle al sniffer los objetos necesarios (Clases) para procesar los paquetes.
 
-### Ejercicio 1: Familiriarizate con la aplicación
+### Ejercicio 1 - Familiarizarte con la aplicación
 
 #### Instrucciones
 
-1. Descarga la carpeta `Classes-SimpleSniffer` a tu computadora escribiendo `git clone http://bitbucket.org/eip-uprrp/classes-simplesniffer` en el terminal.
+1. Carga a `QtCreator` el proyecto `SimpleSniffer`. Hay dos maneras de hacer esto:
 
-2. Para cargar este proyecto necesitas correr `Qt Creator` con privilegios de administrador (root). Para lograr esto, escribe lo siguiente en el terminal:
-`sudo qtcreator Documents/eip/classes-simplesniffer/Classes-SimpleSniffer.pro`.
+    * Utilizando la máquina virtual: Haz doble “click” en el archivo `SimpleSniffer.pro` que se encuentra  en el directorio `/home/eip/labs/classes-simplesniffer` de la máquina virtual.
+    * Descargando la carpeta del proyecto de `Bitbucket`: Utiliza un terminal y escribe el commando `git clone http:/bitbucket.org/eip-uprrp/classes-simplesniffer` para descargar la carpeta `classes-simplesniffer` de `Bitbucket`. En esa carpeta, haz doble “click” en el archivo `SimpleSniffer.pro`.
 
-3. Configura el proyecto.  El proyecto consiste de varios archivos.  En esta experiencia de laboratorio trabajarás con los archivos `ethernet_hdr.h`, `ethernet_packet.h`, `ethernet_packet.cpp`, `ip_packet.h` y `ip_packet.cpp`.
+2. Configura el proyecto.  El proyecto consiste de varios archivos.  En esta experiencia de laboratorio trabajarás con los archivos `ethernet_hdr.h`, `ethernet_packet.h`, `ethernet_packet.cpp`, `ip_packet.h` y `ip_packet.cpp`.
 
-### Ejercicio 2: Completar la clase `ethernet_packet`
+### Ejercicio 2 - Completar la clase `ethernet_packet`
 
-Estudia el archivo `ethernet_hdr.h`. Este archivo contiene la siguiente definición de la estructura de datos que representa un encabezado de Ethernet:
+1. Estudia el archivo `ethernet_hdr.h`. Este archivo contiene la siguiente definición de la estructura de datos que representa un encabezado de Ethernet:
 
-```cpp
-#define ETHER_ADDR_LEN 6
+     #define ETHER_ADDR_LEN 6
 
-struct sniff_ethernet {
+     struct sniff_ethernet {
         u_char  ether_dhost[ETHER_ADDR_LEN];    /* direccion destino */
         u_char  ether_shost[ETHER_ADDR_LEN];    /* direccion fuente */
         u_short ether_type;                     /* IP? ARP? RARP? etc */
-};
-```
-
-El encabezado de Ethernet de arriba es usado para decodificar la parte Ethernet de los datos crudos en cada paquete.  Este se compone de la dirección MAC fuente (`ether_shost`, 6 bytes), la dirección MAC destino (`ether_dhost`, 6 bytes), y el tipo de paquete de Ethernet (`ether_type`, 2 bytes) que es usado para determinar si el paquete es un paquete de IP.
-
-Como sabes, no es una buena idea enseñar este formato de información a un usuario regular.  Tu primer tarea es definir los métodos de la clase de C++ que traducen la información de las direcciones MAC a cadenas de caracteres legibles por humanos.
-
-El siguiente código es la definición de la clase `ethernet_packet`, que se encuentra en el archivo `ethernet_packet.h`:
-
-```cpp
-class ethernet_packet
-{
-
-    sniff_ethernet ethernet ;
-
-    // Devuelve una direccion de 6 bytes MAC en una cadena de caracteres.
-    string mac2string(u_char []) ;
-
-public:
-    ethernet_packet();  // Constructor por defecto
-
-    // Ajusta la variable miembro ether_dhost a los valores
-    // recibidos en el arreglo
-    void setEtherDHost(u_char []) ;
-
-    // Ajusta la variable miembro  ether_shost a los valores
-    // recibidos en el arreglo
-    void setEtherSHost(u_char []) ;
-
-    // Ajusta el ethernet type al valor recibido.
-    void setEtherType(u_short) ;
+     };
 
-    // Devuelve la representación en cadenas de caracteres de las direcciones
-    // Ethernet
-    string getEtherDHost() ;
-    string getEtherSHost() ;
+    El encabezado de Ethernet de arriba es usado para decodificar la parte Ethernet de los datos crudos en cada paquete.  Este se compone de la dirección MAC fuente (`ether_shost`, 6 bytes), la dirección MAC destino (`ether_dhost`, 6 bytes), y el tipo de paquete de Ethernet (`ether_type`, 2 bytes) que es usado para determinar si el paquete es un paquete de IP.
 
-    // Devuelve el tipo de ethernet.
-    u_short getEtherType() ;
+    Como sabes, no es una buena idea enseñar este formato de información a un usuario regular.  Tu primer tarea es definir los métodos de la clase de C++ que traducen la información de las direcciones MAC a cadenas de caracteres legibles por humanos.
 
-};
+2. El siguiente código es la definición de la clase `ethernet_packet`, que se encuentra en el archivo `ethernet_packet.h`:
 
+     class ethernet_packet
+     {
+        sniff_ethernet ethernet ;
 
+        // Devuelve una direccion de 6 bytes MAC en una cadena de caracteres.
+        string mac2string(u_char []) ;
 
-```
+     public:
+        ethernet_packet();  // Constructor por defecto
 
-Nota que cada objeto de clase `ethernet_packet` solo tiene el siguiente atributo:
-* una estructura tipo `sniff_ethernet` llamada `ethernet`
+        // Ajusta la variable miembro ether_dhost a los valores
+        // recibidos en el arreglo
+        void setEtherDHost(u_char []) ;
 
-El resto son métodos que actúan como interfaz al atributo:
+        // Ajusta la variable miembro  ether_shost a los valores
+        // recibidos en el arreglo
+        void setEtherSHost(u_char []) ;
 
-* `void setEtherDHost(u_char [])`: es un *setter* para el campo `ether_dhost` del atributo `ethernet`
+        // Ajusta el ethernet type al valor recibido.
+        void setEtherType(u_short) ;
 
-* `void setEtherSHost(u_char [])`: es un *setter* para el campo `ether_shost` del atributo `ethernet`
+        // Devuelve la representación en cadenas de caracteres de las direcciones
+        // Ethernet
+        string getEtherDHost() ;
+        string getEtherSHost() ;
 
-* `void setEtherType(u_short)`:  es un *setter* para el campo `ether_type` del atributo `ethernet`
+        // Devuelve el tipo de ethernet.
+        u_short getEtherType() ; 
+     };
 
-* `getEtherDHost()` y `getEtherSHost()` son *getters* que devuelven los valores de `ether_dhost` y `ether_shost` en formato legible por humanos, i.e. 6 pares de dígitos hexadecimales (por ejemplo, `e0:f8:47:01:e9:90`).
+     Nota que cada objeto de clase `ethernet_packet` solo tiene el siguiente atributo: una estructura tipo `sniff_ethernet` llamada `ethernet`.
 
-* `getEtherType()` es un *getter*  que devuelve el valor de `ether_type` como *unsigned char*.
+3. El resto son métodos que actúan como interfaz al atributo:
 
-* el método privado `string mac2string(u_char [])` recibe un arreglo de seis *unsigned characters* y devuelve el string correspondiente a su representación hexadecimal. Por ejemplo, si recibe `{ 0x8A, 0x11, 0xAB, 0xFF, 0x12, 0x34}` debe devolver el string `"8A:11:AB:FF:12:34"`.
+     * `void setEtherDHost(u_char [])`: es un *setter* para el campo `ether_dhost` del atributo `ethernet`
+     * `void setEtherSHost(u_char [])`: es un *setter* para el campo `ether_shost` del atributo `ethernet`
+     * `void setEtherType(u_short)`:  es un *setter* para el campo `ether_type` del atributo `ethernet`
+     * `getEtherDHost()` y `getEtherSHost()` son *getters* que devuelven los valores de `ether_dhost` y `ether_shost` en formato legible por humanos, i.e. 6 pares de dígitos hexadecimales (por ejemplo, `e0:f8:47:01:e9:90`).
+     * `getEtherType()` es un *getter*  que devuelve el valor de `ether_type` como *unsigned char*.
+     * el método privado `string mac2string(u_char [])` recibe un arreglo de seis *unsigned characters* y devuelve el string correspondiente a su representación hexadecimal. Por ejemplo, si recibe `{ 0x8A, 0x11, 0xAB, 0xFF, 0x12, 0x34}` debe devolver el string `"8A:11:AB:FF:12:34"`.
 
-Tu tarea en este ejercicio es implementar las siete funciones listadas arriba en el archivo `ethetnet_packet.cpp`. Los encabezados de algunas de la funciones están provistos en el archivo.
+     Tu tarea en este ejercicio es implementar las siete funciones listadas arriba en el archivo `ethetnet_packet.cpp`. Los encabezados de algunas de la funciones están provistos en el archivo.
 
-### Ejercicio 3: Construir la declaración de `ip_packet`
+### Ejercicio 3 - Construir la declaración de `ip_packet`
 
-Estudia las definiciones de las funciones de la clase `ip_packet` que se encuentra en el archivo `ip_packet.cpp`
+1. Estudia las definiciones de las funciones de la clase `ip_packet` que se encuentra en el archivo `ip_packet.cpp`
 
-Tu tarea es crear la *declaración* de la clase `ip_packet` en el archivo `ip_packet.h` tomando como  base  los métodos que aparecen en el archivo `ip_packet.cpp`.  Los atributos de la clase `ip_packet` deben ser:
+2. Tu tarea es crear la *declaración* de la clase `ip_packet` en el archivo `ip_packet.h` tomando como  base  los métodos que aparecen en el archivo `ip_packet.cpp`.  Los atributos de la clase `ip_packet` deben ser:
 
-* dos objetos de clase `string` para almacenar las direcciones de IP fuente y destino
-* una variable de un byte (`char`) para almacenar el tipo de protocolo IP
-* dos variables `unsigned short` para almacenar el puerto fuente y destino
-* un objeto de clase `string` para almacenar la carga (*payload*) del paquete.
+       * dos objetos de clase `string` para almacenar las direcciones de IP fuente y destino
+       * una variable de un byte (`char`) para almacenar el tipo de protocolo IP
+       * dos variables `unsigned short` para almacenar el puerto fuente y destino
+       * un objeto de clase `string` para almacenar la carga (*payload*) del paquete.
 
-En la declaración de la clase `ip_packet` debes especificar que es una **clase derivada** de la clase `ethernet_packet`.
+       En la declaración de la clase `ip_packet` debes especificar que es una **clase derivada** de la clase `ethernet_packet`.
 
 ---
 
 
 ## Entregas
 
-1. Utiliza "Entrega" en Moodle para entregar los archivos `ethernet_packet.cpp` y `ip_packet.h` que completaste. Recuerda utilizar buenas prácticas de programación, incluir el nombre de los programadores y documentar tu programa.
+Utiliza "Entrega" en Moodle para entregar los archivos `ethernet_packet.cpp` y `ip_packet.h` que completaste. Recuerda utilizar buenas prácticas de programación, incluir el nombre de los programadores y documentar tu programa.
 
 ---
 
 
 ## Referencias
 
-[1]http://en.wikipedia.org/wiki/Packet_analyzer
+[1] http://en.wikipedia.org/wiki/Packet_analyzer