INTRODUCTION“UNIX NETWORK PROGRAMMING” Vol 1, Third Edition by Richard Stevens
Read: Chapters 1,2, 3, 4
Communications
Client
Ex: TCP/IP
Server
Example:
Telnet client on local machine to Telnet server on a remote machine
Client and server are “user” processes TCP and IP are normally part on the “kernel” protocol stack
1
Aside on compiling programs in linux:
To compile a program in Linux (not using make) for example the program intro/byteorder.c on p. 78 gcc byteorder.c This places the executable in a default file a.out gcc -o byteorder byteorder.c Places executable in byteorder ; can run by . / byteorder
2
Linux Configuration Tip:
Instead of having to type . / program every time you run a “program” what you can do is in .bash_profile in your /root directory add to the path line. Path = . :
Add this
Now you can just type program instead of ./program since . is now included in your path (From a security standpoint this is a bad thing to do, thus it is not already there for you.) On another Linux subject: To switch from one default text login screen to another (not in the graphics GUI x windows) Alt Alt Alt etc
3
}
F1 F2 F3
Default screen A second screen A third screen
Now Figure 2.18 page 61
4
Example: a simple daytime client:
What this example client program does is connect to a server and gets the date and time if we run: . / daytimetcpcli reachable_IP_address for example: 127.0.0.1 Gets date & time back printed out on screen (However this will not run unless we have a daytime server running on port 13. We can do this by using server code later in this lecture or by in a config file turning on the daytime daemon which is off by default in our linux install.) Details: Line 1 : Includes a bunch on code (unp.h) in appendix D.1 (pages 899-912) with commonly used stuff like MAXLINE (on line 6 of program).
Line 2-3: Allows values to be passed to our program for example an IP address is considered to be the second value.
5
6
7
Continued:
Line 8 : Line 10-11: If you do not have an IP value stop. Your first use of the sockets application programming interface calling the function “socket.” •This creates an Internet (AF_ INET) stream (SOCK_STREAM) socket => means TCP socket. •Function returns an integer descriptor used to identify this particular socket in later code. •Failure calls a function err_sys in our unp.h code Function bzero clears out by filling with zeros the structure servaddr We fill in the structure member servaddr.sin_family with the type AF_INET meaning internet type. We set servaddr.sin_port to the port number 13. This is “well-known” daytime port on TCP/IP hosts. Call function htons “ Host To Network Short” to convert the decimal value into format we need.
8
Line 12: Line 13: Line 14: [ Fig 2.13 ]
Line 15-16 :
Call function inet_pton “Presentation to numeric” to convert ASCII value input in command line to format needed. Put result in servaddr.sin_addr If return error value of a negative number, call err_sys function Connect function establishes TCP connection with server specified by the socket address structure pointed to by &servaddr which we set in line 15 Read server’s reply to an enquiry on port 13, display result using function fputs TCP is a BYTE-Stream Protocol with no “record” boundaries. Therefore for TCP socket always need to code read in a loop which terminates on 0 or end. Exit terminates program. TCP socket is closed automatically
Line 17-18 : Lines 19-25 :
Line 26:
9
Error Handling:
Stevens defines wrapper functions to perform function call, test of return value and error handling. Stevens indicates one of his wrapper functions with an upper case letter.
10
11
12
Line 10:
Creates the TCP socket. Now we are using the wrapper function with a capital S. Instead of sockfd we put returned integer descriptor in listenfd. Otherwise identical to Fig 1.5 client code line 10.
Line 11-15: Bind the servers port 13 to the socket by filling in internet socket address structure. Line 11: Line 12: Line 13: Function bzero clears out by filling with zeros the structure servddr. Fill in the structure member servaddr.sin_family with type AF_INET meaning internet type. Fill in the structure member servaddr.sin_addr.s_addr with the IP address INADDR _ ANY This allows server to accept a client connection on any interface. Use function htonl which is host to network long to convert declimal value into format needed. Set structure member servaddr.sin_ port to port number 13 Use function bind on socket pointed to by listenfd to assign a local protocol address to the socket.
Line 14: Line 15:
13
Line 16:
Using the function listen the socket is converted into one that accepts incoming connections from clients. The Three Steps: •Socket •Bind •Listen •Are used to prepare a TCP server “Listening Descriptor” which is listenfd in our example. •The constant LISTENQ is from header “unp.h” and specifies max number of client connections. For ( ; ; ) { } This loops forever We wait at line 18 until a client has connected to us and the TCP 3 way handshake has occurred. => Function accept returns description connfd which is the “connected descriptor.” Function time returns time. Function ctime converts to human readable form. snprintf adds a return and line feed. Function write sends result back to client. Server closes connection with client by calling close.
14
Line 17-21:
Line 19: Line 20: Line 21: Line 22:
Simple Daytime Server
To run this server and then client in directory with the source code. . /daytimetcpsrv & puts in background mode shows . / daytimetcpsrv is running shows no longer running
. /daytimetcpcli 127.0.0.1 ps kill ps
↵
15
Internet Requests For Comments (RFC)
RFC documents are definitions of the protocols and policies of the internet. RFCs contain all the nuts and bolts information. Examples: • RFC 793 • RFC 768 • RFC 791 Transmission Control Protocol User Datagram Protocol Internet Protocol 1981 1980 1981
You can get your own copies and do keyword searches at: http://www.cis.ohio-state.edu/hypertext/information/rfc.html
16
Socket Pair
The socket pair for a TCP connection is the 4- tuple that defines the two end points Local Local Foreign Foreign IP TCP IP TCP Address Port Address Port
A socket pair uniquely identities every TCP connection on an internet. We extend this same concept to UDP.
17
Chapter 4 Elementary TCP Sockets
Examine a TCP client and server:
• First server starts, later the client that connects to server is started.
• In this example the client sends a request to the server. • Server then processes the request and sends a response back to the client. • Continues until client closes its end of the connection by sending end of the connection by sending end of file notification to server. • Server then closes its end of the connection.
18
19
Socket Function
Specifies type of communication protocol desired (ie. TCP using IPV4)
• Family specifies protocol family. AF_INET is IPV4
• • • Socket type is for example SOCK_STREAM for TCP, SOCK_DGRAM for UDP. Protocol argument is usually 0. (Always 0 for us) On success socket function returns a non-negative integer value. This returned value is called a socket descriptor or sockfd.
20
21
Connect Function
Used by TCP client to establish a connection with a TCP server. Causes a Client to send SYN [Fig. connect ] • sockfd is the socket descriptor returned by socket function. • 2nd & 3rd arguments are a pointer to a socket address structure and its size. • The socket address structure must contain IP address and port number of server.
[See fig. 1.5 again for how we set this in our example] • Connect function initiates TCP’s 3-way handshake • Connect moves from CLOSED state to SYN_SENT state and then with success on to ESTABLISHED [ Fig. 2.2 & 2.4 ]
22
23
24
Generic versus our specific use of Sockets API
Applications using sockets must specify IP addresses and port numbers to the kernel The generic (not just for IP) data type for doing this is the sockaddr structure: struct sockaddr { uint8_t sa_family_t char sa_len sa_family sa_data[14]
/*address family: AF_XXX value*/ /*protocol specific address*/
The generic sockets application programming interface (API) functions like bind require this structure because this is how they were first defined: int bind(int, sockaddr *, socklen_t);
25
The specific form of the sockaddr structure that is used for the TCP/IP socket addresses is the sockaddr_in structure.
Comparing the generic structure with the one we need for TCP/IP: sa_family sa_data BLOB (14 bytes) 4 BYTES INTERNET ADDRESS 8 BYTES UNUSED
sockaddr
FAMILY 2 BYTES 2 BYTES
sockaddr_in
FAMILY
PORT
This requires that any calls to these functions must cast the pointer to the protocol specific socket address structure (our TCP/IP stuff) to be a pointer to a generic socket address structure (the original generic stuff).
26
For example: struct sockaddr_in serv bind (sockfd, (struct sockaddr *) &serv, sizeof(serv)); Since serv is type sockaddr_in and we must use type sockaddr Stevens defines in unp.h: SA is equal to the string “struct sockaddr” just to pretty up the book! (See page 9) So when Stevens does the following he is casting the pointer to the Protocol specific structure we want to use into the generic structure we must use if we want to use the old already defined functions. bind (sockfd, (SA *) &serv, sizeof(serv));
27
Bind Function
Assigns a local protocol address to a socket. For example a 32 bit IPV4 address along with a 16 bit port number.
[ Fig. Bind ]
• Second argument is pointer to a protocol-specific address (ie IPV4) • Third argument is size of this address structure. • Servers bind to a port when they start. If a TCP client or server does not do this, Kernel chooses an “Ephemeral” Port for the socket when either connect or listen is called.
[ Fig. 2.10 ] (slide #30)
•bind allows us to specify the IP address, the port both or neither. •In bind, if we specify a port number of 0 kernel chooses an “ephemeral” Port. •We can sometimes not specify a IP address so we can receive from any IP address:
Example from Fig. 1.9 where we do not specify an IP address
struck sockaddr_in servaddr servaddr.sin_addr.s_addr = htonl (INADDR_ANY)
This constant is defined 0
28
29
30
Listen Function
Call By Servers: 1. Converts unconnected socked into a passive socket, meaning kernel should accept incoming connection requests. Moves socket from CLOSED to LISTEN in Fig 2.4 2. Second argument specifics maximum number of connections kernel should queue for this socket.
31
Accept Function
Called By TCP Server: Returns next completed connection from front of completed connection queue.
32
Close Function
Closes a socket and terminates TCP connection
33
34
35
Example:
Modify Fig 1.9 to print out IP address and port of the client. [ Figure. 3.2 with Fig. 4.11] Lines 7&8 len will be size of socket address structure. cliaddr is new to hold client protocol address ( IP + Port ). Lines 19 Lines 20 Lines 21-23 Set len to size of protocol address. New 2nd & 3rd arguments in Accept. Use inet_ntop to convert 32 Bit IP address in the socket address in the socket address structure into dotted decimal ASCII string. Use ntohs to convert 16 Bit port number from network BYTE order to host BYTE order.
Note: You will want to use this idea in your programs. There are details on: inet_ntop in § 3.7 ntohs in § 3.4
36
37
38
39 