Browse Source

Rafa: anadiendo diags a README

Rafael Arce Nazario 8 years ago
parent
commit
6ae9e9dfac
2 changed files with 24 additions and 5 deletions
  1. 15
    5
      README-en.md
  2. 9
    0
      README-es.md

+ 15
- 5
README-en.md View File

@@ -41,7 +41,7 @@ To see an example of a class, take a look at the documentation of the `Bird` cla
41 41
 
42 42
 A class is a description of the data and processes of an object. The class’s declaration establishes the attributes that each of the objects of the class will have, and the methods that it can invoke.
43 43
 
44
-If it isn't specified otherwise, the attributes and methods defined in a class will be private. This means that the variables can only be accessed and changed by the methods of the class (*constructors*, *setters*, and *getters*, among others).
44
+The attributes and methods of a class can have one the following levels of access: private, protected and public. An object's **public** data members can be read or modified by any function that has access to the object (including external functions). An object's **private** data members can only be read or modified through the object's **member** functions .  Unless specified otherwise, the attributes and methods defined in a class will be **private**.  Protected members allow read/write access from member functions and those of inherited classes. 
45 45
 
46 46
 The following is the skeleton of the declaration of a class:
47 47
 
@@ -81,13 +81,13 @@ Computers communicate with each other through the Internet Protocol (IP). When a
81 81
 
82 82
 The Internet packets must also specify the application that is sending the information and the application that must receive it. We can think of the Internet addresses like home postal mail addresses, and that the applications that send and receive the information are the persons that send and receive postal letters.  To send a letter via postal mail, the recipient of the letter must be specified. This corresponds to the application that receives the information.  To identify the source and destination application, the Internet protocol uses what is known as *port numbers*. This way, looking the packet information, the source and destination addresses and ports can be identified.
83 83
 
84
-For instance, when your lab computer communicates with the server for Moodle, the packets that carry the information from your computer to the web server contains the source address, which is the address of the lab computer, and the destination address which is the Moodle server.  The source port is the port of your web browser and the destination port is the port of the Moodle web server.
84
+For instance, when your lab computer communicates with the Moodle server, the packets that carry the information from your computer to the web server contain the source address, which is the address of the lab computer, and the destination address which is the Moodle server.  The source port is the port of your web browser and the destination port is the port of the Moodle web server.
85 85
 
86
-The Internet addresses occupy 4 bytes (32 bits), and usually are presented to users as strings of 4 decimal values. Each decimal value between 0 and 255 is the decimal representation of one of the 4 bytes:  "(0-255).(0-255).(0-255).(0-255)". Some examples of IP addresses are: `10.0.1.10`, `192.168.10.11`, `136.145.54.10`.
86
+Internet addresses occupy 4 bytes (32 bits), and usually are presented to users as strings of 4 decimal values. Each decimal value between 0 and 255 is the decimal representation of one of the 4 bytes:  "(0-255).(0-255).(0-255).(0-255)". Some examples of IP addresses are: `10.0.1.10`, `192.168.10.11`, `136.145.54.10`.
87 87
 
88
-Port numbers are composed of 2 bytes or 16 bits.  Therefore port numbers range from 0-65535. There are ports numbers assigned to known application services such as number 22 for ssh, 23 for telnet, 25 for smtp, 80 for http, and so on.
88
+Port numbers are composed of 2 bytes or 16 bits and range from 0-65535. There are ports numbers assigned to known application services such as number 22 for ssh, 23 for telnet, 25 for smtp, 80 for http, and so on.
89 89
 
90
-To complicate things a little bit, each computer network card has an unique identifier that is used for the communication between you computer and the network device that routes the network traffic from the Internet and local network to your computer and vice-versa (*Ethernet protocol*).  This unique identifier is known as the Hardware address (a.k.a *Multiple Access Controll (MAC) address*), is represented using 6 bytes (48 bits), and is presented to the users as strings of 6 hexadecimal values (each pair of hexadecimal digits corresponds to 1 byte). Each hex value is the hex representation of the 6 bytes: "(00-ff):(00-ff):(00-ff):(00-ff):(00-ff):(00-ff)".  Some examples of MAC addresses are: `e0:f8:47:01:e9:90` and `70:ad:60:ff:fe:dd:79:d8`.
90
+To complicate things a little bit, each computer network card has an unique identifier that is used for the communication between your computer and the network device that routes the network traffic from the Internet and local network to your computer and vice-versa (*Ethernet protocol*).  This unique identifier is known as the Hardware address (a.k.a *Multiple Access Controll (MAC) address*), is represented using 6 bytes (48 bits), and is presented to the users as strings of 6 hexadecimal values (each pair of hexadecimal digits corresponds to 1 byte). Each hex value is the hex representation of the 6 bytes: "(00-ff):(00-ff):(00-ff):(00-ff):(00-ff):(00-ff)".  Some examples of MAC addresses are: `e0:f8:47:01:e9:90` and `70:ad:60:ff:fe:dd:79:d8`.
91 91
 
92 92
 ---
93 93
 
@@ -130,6 +130,16 @@ For the purposes of this lab, we will think of TIP packets as being a *specializ
130 130
 
131 131
 ---
132 132
 
133
+!INCLUDE "../../eip-diagnostic/simple-sniffer/en/diag-simple-sniffer-02.html"
134
+<br>
135
+
136
+
137
+
138
+---
139
+
140
+---
141
+
142
+
133 143
 
134 144
 ## Laboratory Session:
135 145
 

+ 9
- 0
README-es.md View File

@@ -134,6 +134,15 @@ En esta experiencia de laboratorio completarás un sniffer de paquetes sencillo
134 134
 
135 135
 En este laboratorio, pensaremos en los paquetes de IP como una *especialización* de los paquetes de Ethernet.  Por lo tanto, implementarás la clase de paquetes IP como derivada de la clase de los paquetes Ethernet (usando herencia). De este modo, la clase para paquetes IP tendrá todos los miembros de datos y métodos de la clase de paquetes de Ethernet (por ejemplo, dirección MAC de fuente y destino) en adición de los datos y métodos particulares a los paquetes de IP (por ejemplo, los puertos de fuente y destino).
136 136
 
137
+
138
+---
139
+
140
+---
141
+
142
+!INCLUDE "../../eip-diagnostic/simple-sniffer/es/diag-simple-sniffer-02.html"
143
+<br>
144
+
145
+
137 146
 ---
138 147
 
139 148
 ---