Voir la source de 20170116:TP:C:TCP:Client

[[category:EPITA:TP:20162017]]

== Introduction ==

The goal of this session is to write a simple application that fetch a web-pages using only socket.

=== Assignements ===

The tutorial must be commit to your git repo as usual, here is the directory structure:

* <tt>20170116_TCP_client/</tt>
** <tt>AUTHORS</tt>
** <tt>Makefile</tt>
** <tt>get_page.c</tt>

Your code is in a single file <tt>get_page.c</tt> and your <tt>Makefile</tt> is able to build the binary file <tt>get_page</tt> with the usual flags.

== Minimal HTTP Query ==

Here is a simple test in order to access a web-page, I choose to visit http://perdu.com :

<source lang="html4strict">
> nc perdu.com 80
GET http://perdu.com HTTP/1.0

HTTP/1.1 200 OK
Date: Fri, 15 Jan 2016 13:29:25 GMT
Server: Apache
Last-Modified: Tue, 02 Mar 2010 18:52:21 GMT
ETag: "cc-480d5dd98a340"
Accept-Ranges: bytes
Content-Length: 204
Vary: Accept-Encoding
Connection: close
Content-Type: text/html

<html><head><title>Vous Etes Perdu ?</title></head><body><h1>Perdu sur l'Internet ?</h1>
<h2>Pas de panique, on va vous aider</h2>
<strong><pre>    * <----- vous &ecirc;tes ici</pre></strong></body></html>
</source>

As you can see, the query start with the keyword <tt>GET</tt> followed by the ''u.r.l.''and the protocol version (we use <tt>1.0</tt> that requires less work for our query.) What you can't see is that the line are terminated by the sequence <tt>\n\r</tt>, so the C string of my query looks like:

<source lang="C">
char *query = "GET http://perdu.com HTTP/1.0\n\r\n\r";
</source>

So, our first exercise is to build the query string and compute it's size:

* '''Implement the following function:'''
<source lang="C">
char* build_query(const char *url, size_t *len);
</source>

<tt>build_query(url, &len)</tt> take the <tt>url</tt> string, builds the query string, returns the pointer to the string, this pointer must be freeable using <tt>free(3)</tt>. The functions also puts the length of the query (number of characters without the terminating <tt>'\0'</tt>) in the pointed variable <tt>len</tt>.

== Connexion to the server ==

=== Getting the IP address ===

First, in order to connect to a server we need to get its IP address. Lots of code samples use <tt>gethostbyname(2)</tt> but this function is now deprecated and we must use <tt>getaddrinfo(3)</tt> (as presented in the lecture). Here is some code:

<source lang="C">
  struct addrinfo hints;
  struct addrinfo *result, *rp;

  // hints describes what we want
  // first fill the structure with 0s
  memset(&hints, 0, sizeof (struct addrinfo));
  // We only want IPv4, use AF_UNSPEC if you don't care which one
  hints.ai_family = AF_INET;
  // We want TCP
  hints.ai_socktype = SOCK_STREAM;
  hints.ai_flags = 0;
  hints.ai_protocol = 0;

  // name and port are strings (domaine name and port, obviously)
  // result will contain the result
  addrinfo_error = getaddrinfo(name, port, &hints, &result);

  // Error management
  if ( addrinfo_error != 0 ) {
    errx(EXIT_FAILURE, "Fail getting address for %s on port %s: %s",
	 name, port, gai_strerror(addrinfo_error));
  }
</source>

<tt>result</tt> is a linked list of <tt>struct addrinfo</tt> (the next field is <tt>ai_next</tt>.) We now need to try each answer in the list and see if we succeed to connect.

=== Let's do It ! ===

* '''Write the following function:'''
<source lang="C">
void get_page(const char *name, const char *url, const char *port);
</source>

<tt>get_page(name, url, port)</tt> connects to the machine <tt>name</tt> on port <tt>port</tt>, build a query for the URL <tt>url</tt>, send it, read the answer and write it to the standard output.

You have to manage all communication aspects, properly first you need to send the query, then read everything send by the server and outputs it to <tt>STDOUT_FILENO</tt>, beware, the server will probably close the stream once it has send all he want, the answer is finished also when the server sends two ends of line (<tt>"\n\r\n\r"</tt>.)

Here is an example of main:

<source lang="C">
int main() {
  get_page("perdu.com", "http://perdu.com", "80");
  return 0;
}
</source>

And the output of the full program:

<source lang="html4strict">
> ./get_page 
HTTP/1.1 200 OK
Date: Fri, 15 Jan 2016 15:17:58 GMT
Server: Apache
Last-Modified: Tue, 02 Mar 2010 18:52:21 GMT
ETag: "cc-480d5dd98a340"
Accept-Ranges: bytes
Content-Length: 204
Vary: Accept-Encoding
Connection: close
Content-Type: text/html

<html><head><title>Vous Etes Perdu ?</title></head><body><h1>Perdu sur l'Internet ?</h1>
<h2>Pas de panique, on va vous aider</h2>
<strong><pre>    * <----- vous &ecirc;tes ici</pre></strong></body></html>
Connexion closed by the server
</source>

''New lines are just here for presentation, you can have a different output … ''

Here is a list of man pages you need to read:

* <tt>asprintf(3)</tt>
* <tt>bind(2)</tt>
* <tt>close(2)</tt>
* <tt>connect(2)</tt>
* <tt>getaddrinfo(3)</tt>
* <tt>memset(3)</tt>
* <tt>read(2)</tt>
* <tt>socket(2)</tt>
* <tt>strncmp(3)</tt>
* <tt>write(2)</tt>