From f641e76a05478029cf38b3009d98f6b2c442a435 Mon Sep 17 00:00:00 2001
From: xdrm-brackets <doowap31@gmail.com>
Date: Tue, 14 Feb 2017 09:33:48 +0100
Subject: [PATCH] Thread implementation ALMOST finished

---
 .server.c.swp | Bin 0 -> 20480 bytes
 .server.h.swp | Bin 0 -> 12288 bytes
 lib.c         |   2 +-
 lib.h         |   3 ++
 lib.o         | Bin 11760 -> 11760 bytes
 makefile      |   2 +-
 server.c      | 145 +++++++++++++++++++++++++++++++++++++-------------
 server.h      |  16 ++++++
 server.o      | Bin 6968 -> 8792 bytes
 9 files changed, 130 insertions(+), 38 deletions(-)
 create mode 100644 .server.c.swp
 create mode 100644 .server.h.swp

diff --git a/.server.c.swp b/.server.c.swp
new file mode 100644
index 0000000000000000000000000000000000000000..84be80d476f94e5db77656994ddb107a4144dd08
GIT binary patch
literal 20480
zcmeI2dyHIF9mj70OQ*DjR{W=$cv#%+%y#xM+bykqkkEINK4_Mu)$L}uJ9B3Dc4zM$
z@4d5+HZ2<UFAG*kYE+=m#2BiP`au8iA3`l?D83RjMv#`65R}9}zzToq=bU@*%-vmT
zi>;B6GucmO=iYPA<NG_m-#Pc3Gt_<W_MKu?XRpQQ7R&n5Gbi^wbMZE-rNy!)%l=r$
zkZ+epWf-XYm-y&(Rl62?wM(RkE+3heVb>-ZjPgj=uoHHwJDrZ#6-)(XC+G-kU4it+
zrQcclk2#u~MggP16)8{;D;=vBS}S@A-75X<Ew_n}F6qCbM@=H5fKk9GU=%P47zK<1
zMggOMQQ*U&Kv=upx}T<87dK~f{5@yJ_YLvy<b8bOjQiKezi*AdADwYO{%O990!9I&
zfKk9GU=%P47zK<1MggOMQNSo*6!<?VV3#dxPR6nd^C_JD|K$Du&6_RjZ}3-m1D=QH
z;3@E74|GE-d<quB#YL9&5BM2;4UWNA;X!x+LRbYKgB#%NLd$vtj==+P6soWR=E5rr
zEbF)MD|ivk!3*#-OhOSh!A59@#qj1$mURLC46ne;@DrGVe%J<E;S;b3&eQJG@Dv<}
zBXA$|!EV?EJ)rcth)%D=%kT&IJ-h@*VG>5+0BnV2Fds7Tn|YKElduO?!%FCd0(8Ry
z`1OsJbpj5;Ubq)}LBJ>BR#*ay;TE_V7QsST05`#W$iO@}Ki9Heg<rr|z=3VB5PtU&
z%la{#fXCpAP=Ib&3U9IC^CFys$KX+T1il4dhHcOZ*TEckg9V_M;52+2PQnxLI6Me@
z;BI)0g{BK|9$tlC!cjN@nf3qer@hO{bhV3t6@#Krx@F<Zpys)OR1TG?`HmY_vMufH
z?c69yXIz%Wvesak$hMZn&{QacoT&KTm}m{ww3hd~EqM`oMUsx^quY5=syfmQi%u;s
z+|U~dvUa)b7o)44f#Viyo*(9NYbnlgWmqIpEqm9N;`Uve@5zg{S;^JoxoO$<bn|qk
zt4nN^VO*SW)OniBVLFkVbi!;wrO4Ez?|Xi>g)dq6b&G1D<GG?{f37aW7L~}UWTTpk
z_3K4PLF5i;eX>0{vD0?#VJUPb0^O{PRzR#5lfJae*|Htlfma$$X|SPxOW*d-Zr1f{
z7gR$`*iP7`k_(kwWpnkm>lqY#$yQW6U+1cA7leMPHkHL30d~!cmgrcJD9egnuZ9gn
z(`uo$4@EelDpqvdvYez<wm)1S!*)T(o%)he#|?D}s+mH4rlnF>Wk@n?G2F04F}h3{
zwYUH>E>8G%4STdVOChi9d!@*UEXCGBzZm93DnXzMLR2iXMTVu3R8HDBr4ie2_P&9h
z?!mYL+G=YBl?;8`4JwjkUfm6?jC!O!>A|W#`a({O+1097%8J;WqFn^eLFrZW{hUzd
zZ9J;fet(Z*sd_0CN+#_ajw@0=61S4Bv)y$<$F5ScPK&_Tt_u|go7vmSCoF5+bIR>B
zU3L16+KIE#rL+xjkLCw=^JQ4~UD2)Fxm5K6nXNiOC|%XK#0xOkMs-U>w;XpkX^*yB
zqnjM?95)-4?*{|UU|#I%-?2mGLPyUE2bH_UTE5p&%gLyUfx57KxyVI*1JxRyfeqsx
z9$;dj%vAF|`e1eH+PLA$lpD@23_%V<hCjR5Y?bo0L0VFvS-Lx~Qh~-FrK&O(-xqcu
z>{3Ydjlxbtp%VTY%52+=>>{D^(`=U)k@a#ZXKEX&JJqm=I|fQsUHlz6akuZ4WI$*h
zPNHeab6rUV2$lTV!j%)TlyQZc8Ffa{gBB$*Ba^xrg#vCSu`(%kWln6MGUX)OM(l|T
z$WVpQaqCh&pkj0!q@oxd*S!}XsfY<FM(lCvE>i)qj+JeODA^RV<4#fbgzJSPs)gAD
z-iRv#*PF=cqR2`Q8=1@y;*P4~C@_wQj{d2NPn!_)sh+4@A(QT!O~=sxDa&u#yrF+<
zTN@oO8d%GoD;YIWpPOp5n%2%)$@S0^rH@odWK0cKNle^1YqZKVQ;W&S_fp=;SeuGE
zx<4efEz6<$a5f%57~)&hAf`u~Xc*T6XG5fpMpwrBc4+U{X&txZjp<I+>`mI?Cq|sA
z%!+8NRU?d(Pt3~*90h7UGDTOf!GPJD^3<pafzG?)xcF0b3VU5<?ojg2JgMVk9J(5F
zhi14-*+dOfg^u@{L8Oz5$ssygR?mm%X!;>SrS|buguMFs0&~4-xvK7|+Z#u3ZNQ|9
zs_N)SyGGdc&>N%GC7~`R{V++GxNI~*TBFm5v3d}SA&C!;Gjf$tIh4cFkDpbZ6a*#P
ztz>z6e4s##Z)q*l#oDwAVqNT5Gdi`dQ=>fHiInqPRrPl|QOHZO4febJ0Yl#!5l@_S
zp#x(?My?K~TEG(}#-N_YT#<esdtW27XojI8%+;HZ>E6ujqX3f{n3MUHXa--5c&Ixs
zx(~;FYei1<MKcdZLp^J0)|M;LT+JS;N;OQX0U-*-%0ZjGHlL2<@ocP5PXklQm2wn%
zrSqI<B-e8wRqFDnCtVZiQq!Cup600bjM>aI)IZ9Uyj$pLApegK3`P^2+X-IPdRZp3
z=+2QAOTGUu=Ux2kpx*zJ{rlH>pFac7!YMco0gQlzGL&Elc7b~Tf15mBgA4Fe_$GV<
zRNlwIe2fA{0i%FXz$jo8FbWt2i~>dhqkvJsC@@0-waDC94^Hpss8wdx<(o?>EHcLl
z)dDk1U(ph?J<Qv1^sXPR;3vz5YE3X%l+x?>>c%x)m||USbF?h4)*DpAF0%|LUA80y
zYjJwdvatvk@5{Z94ZI28VIe(fsoud;OCqTz_o)qoWOr1_qu&3&&wj7kYgX_7rPvVv
z;(h*)@E!O9d>+*M{ynfAHo->N0Ppf{{}*@`o`xU5X?PeO0uOdW4;0`X_V%BE$6*TY
zgF)C2pMibQ3;$$4|9LnG_rnp`58GfXtb;Z1X;=-b;0{;`y|4m$pa9)44{n6H@OSq9
ze+b9GgI;)-J^nwzb8r?;!9LgvcfnG4oBjN^;4J(c&cJb~fP~$!1m0mk{~WvkKY|l*
z5Im^DC>(%&@NrlQ-@^vqg;Ve(JPg_{u}#dEQNSo*6fg>W&=t7)?Gba5>BDrAY1STi
zP%o*;;XrFy?ZGiqOC4HL)3q6!*3oUXX&r>N&k=&*_zAt~t~aI3F)4FQ>N3YC)#f9w
zK5S6WIwob#NnJ*}#_dEzb54o_SO24PQc3hn4rS;QP|;b1D>`Asv8d?ORD8Z+_F1b#
z<fB#rK46EfE`1Jg=7<m-=TIX8$9>9bK+wm-;(<aRd{XUG$0MZebFNe!tDSL%jIM0`
E8z>B`8vp<R

literal 0
HcmV?d00001

diff --git a/.server.h.swp b/.server.h.swp
new file mode 100644
index 0000000000000000000000000000000000000000..27f88d6e3579f1adc50c70bce38dc791f7a679f9
GIT binary patch
literal 12288
zcmeI2%WG3X6o;qcCeW(rKQK+G3n97j0SeJVG?50hLedtYNSNF^Nya9V%gm$?O6}hu
zh)Wl4&028b!i7uS`PgY)>sDO)yLs5=Vx?Wyo`H|aoS8Xu<|CVssb!Z+clp)K6^3?(
zv6HW!-+%jan!Uv5^}w{#H6#2L>1;H=PwTI1iO_YzeO3&@kH!*u1!-5X#cL>+iDojY
z<Jk=xD4TYnXQf${Ce!?9Mw%o8WZ*ysx~`tSHnn*9(#34FK9!v2=gux3Xe%uu17v^<
zkO4A42FL&zAOmFJ|1jXf3AT-^oETnbX4p@}`r(i|GC&5%02v?yWPl8i0Wv@a$N(82
z17zR`8V~_vFD4mVo<i~X&wup$|Ho;@zJt%;6Zi-|fH$BAo`7xe5R}0zm;saE*D1!n
zfgSJ_ya(^VYtRGFz+<oh*1#%gg7aVpb$kIm@D%u<2Kx0KLBCWo86X2>fDDiUGC&5%
z02v?y$G|{Jrlby3ow3A)LpE=)g;!KV3)eN$@+bpKc!x}cEi7T3aLVUOJ1(kip+!R)
zyWAG*w^~YSXCLqzd^5Y1<DSR;j&?$6%NOR##eAW{h3{0|{z($Lrja73I{vprIX-B+
ziNq)oYWMh3zFf-Ryi=^e2}^A8Q8r;3)ioo+P?{V|B%(@{4&?f1U^~$Zbd20aC<9sN
z)|syFHv35n#oML%(n9Ipe3Uk&wBPCmk|$fLmT4yOMca*CA0C)#&hCv$V{|7L)6yy6
zDIJ@@19fjuPiz9K1DrUPIa(amY-91RR@McvATFhJBNh}U6evQvSRC8?7aTv%1*(6M
c{;eSj8+o--EH4$y)wwDj{i-^=*7wGK1MH;<D*ylh

literal 0
HcmV?d00001

diff --git a/lib.c b/lib.c
index b31696b..7a99d7a 100644
--- a/lib.c
+++ b/lib.c
@@ -74,7 +74,7 @@ int xbind(const int port){
 	=========================================================*/
 	DEBUG&& debug("xbind", "listen for client");
 
-	if( listen(xsocket, 1) < 0 ){
+	if( listen(xsocket, maxClients) < 0 ){
 		DEBUG&& printf("error\n");
 		return -1;
 	}
diff --git a/lib.h b/lib.h
index ff7423c..18719c6 100644
--- a/lib.h
+++ b/lib.h
@@ -10,6 +10,9 @@
 	#define DEBUG		0x1
 	#define DEBUG_LEN	40
 
+	// constants
+	#define maxClients	0x4
+
 
 	#include <stdio.h>
 	#include <stdlib.h>
diff --git a/lib.o b/lib.o
index 7cdc95f12e149773fcb631756a20e849c99e1799..d63143052f3b8e58e1698ba7b765d18680df7601 100644
GIT binary patch
delta 804
zcmZ9IKS&!<9LM{ME!EiO&yYOcWX{W-MIwhFN|%a5J%SYKA`}Nbf?zO2LR<uw;1Dbw
zj9+Lebx;dJ6shUap;Kw6t|G<3L5g$`{1;RtTOZ_?<sCfU@%?=6`+o1PC$A^>zY;z4
zeTqH7;nQ(=p?>s*27;Mfb|$}2oX^bp2<=hF?39<wdc~O{h9htM50Pq!!Wiiia`!>=
ziSZs(d#7486uR8>RG=9TX_TlLywLJ*oWIoa2~a|i0hw@U8R>*0ci1dzW*(J<kb_L2
z(F}en`if~)qc^B4ddf5Z&}apQA&BtYaO5X$IMSRelnjS{qh<(MWan0M?(kR9?|e!p
zTdn{08PRSb-*P&j(PNA#THtTTG@3&}(T_|s8a={hw?nHqP|g<51kLFKnGT(!-xQcO
z+oLBM{{_z!a*fk_jqagh3i^Yp>CzX}RZ|c~(xG*XCxwi&z0LErZu|}<<y@eabmbDy
z)zF+WqLv863BA@RO`~85RlQ=ls`@~^pW@7Ns03-d^bejb<RTYbwly1Dhh<T*MIcPr
ku}76!w*{5_j-JPlsDWr|h&-fI!-4k^)Skutjnr%U52<c~0RR91

delta 811
zcmZ9JO-LJ26otJJ@wXva#K&`E#$={l1f~H&-KbgU5Z%<S1Q+cz2>ziB5kwF{5L6H$
z9z;O}g<`c}X&hQgDX37|RiV;_?%IL~Zc0)LqKnc8x!Jsd;mw@yoAd6><OlKtZ;pt_
z^C(nTlNuWy9G}cgq(<@O-s9?_C+^s=n;FcY$KMR;k5k-R^dAyB0{z}bVBb#-NHhxh
zuB>>3c&$-utvYX!Zgi3(zGB>>(M!H>*YXo823=b2g2IAgkYSrvkPO@MEt?CPIgM;s
z$OKbpbR4IO_A@=u=sy$`z2upXHM#}E5LAaY!<Kv8aIQId%o#R)N6rv(mYu(vbAexq
ze&Stf*(!av*9bNVxyEU;Mz4@ibcUbp)#wz`ioRf)(&z<tn{3*|nQ{(!CTLD8C}PtM
z;t?S~vhzc8zQR>>o6{SOzDG79=qC;$4t+pDwS{0rZF-5msE|*&bB|{%z4bcgl=BU_
zs3S{%^j33L5i|v!n^kydcG4))rcm8WrlY#g)b(dvn>H;&S`OvmT0+iq!|(Fqwx!)B
rk+p>HPZ?fW-AXN3f|kAN`;`@RhhVIQo*^0Q@T~`sdr<G~#2(RqaNvf&

diff --git a/makefile b/makefile
index 7ca2720..25aff58 100644
--- a/makefile
+++ b/makefile
@@ -1,4 +1,4 @@
-CC=-Werror -g
+CC=-Werror -g -pthread
 
 
 client.o: client.h client.c
diff --git a/server.c b/server.c
index e90e20a..b5e9ba4 100644
--- a/server.c
+++ b/server.c
@@ -6,19 +6,17 @@ int main(int argc, char* argv[]){
 
 	/* [1] Initialisation
 	=========================================================*/
-	/* (1) Socket info */
-	// Client
+	/* (1) Client address + port */
 	struct sockaddr_in addr_client;
-	char client_ip[20];
-	int port; // chosen port
-	// Socket
+	int port;
+
+	/* (2) Sockets */
 	int listensock, datasock;
 
+	/* (3) Struct to send arguments to threadable process */
+	pthread_arg_wrapper built_args = {0, 0};
+
 
-	/* (2) Misc. information */
-	char* to_send = (char*) malloc( BUFSIZE * sizeof(char) );
-	char* to_recv = (char*) malloc( BUFSIZE * sizeof(char) );
-	int bytes; // transfer count
 
 
 	/* [2] Manage arguments
@@ -37,18 +35,6 @@ int main(int argc, char* argv[]){
 		return 1;
 	}
 
-	/* (3) Manage optional @message argument */
-	if( argc >= 3 ){
-
-		if( strlen(argv[2]) > BUFSIZE || sscanf(argv[2], "%s", to_send) <= 0 ){
-			printf("argument error: message must be a string (max: %d characters long)\n", BUFSIZE);
-			return 1;
-		}
-
-	}else
-		strcpy(to_send, "server default message");
-
-
 
 
 	/* [3] Create socket
@@ -63,20 +49,103 @@ int main(int argc, char* argv[]){
 	}
 
 
-	/* [4] Wait for client
+	/* [4] Wait for clients indefinately
 	=========================================================*/
-	/* (1) Listen to incoming connection */
-	datasock = xlisten(listensock, &addr_client);
+	int i, index = -1; // thread index
+	while( 1 ){
+
+		/* (1) Listen for incoming connection */
+		index = -1;
+		DEBUG&& debug("server", "wait for client");
+		datasock = xlisten(listensock, &addr_client);
+
+		/* (2) Manage error */
+		if( datasock == -1 ){
+			DEBUG&& printf("error\n");
+			continue;
+		}
+
+		DEBUG&& printf("done\n");
+
+
+		/* (3) Search for a free manager */
+		DEBUG&& debug("server", "finding free thread");
+		for( i = 0 ; i < maxClients ; i++ )
+
+			if( a_managers[i] == 0 ){
+				index = i;
+				break;
+			}
+
+
+		/* (4) If we haven't found a free manager -> do nothing (john snow) */
+		if( index == -1 ){
+			DEBUG&& printf("not found\n");
+			continue;
+		}
+
+		DEBUG&& printf("found\n");
+
+		/* (5) Build thread arguments */
+		built_args.socket = datasock;
+		built_args.index  = index;
+
+		/* (6) Processing client connection on a new thread */
+		pthread_create(&managers[index], NULL, manageClient, (void*)(intptr_t) &built_args);
+
+		/* (7) Mark the manager as active */
+		a_managers[index] = 1;
+		
 
-	/* (2) Manage error */
-	if( datasock == -1 ){
-		perror("erreur connection client");
-		exit(1);
 	}
 
+	/* [5] Wait for all threads to end
+	=========================================================*/
+	/* (1) Wait for all threads to end properly */
+	for( i = 0 ; i < maxClients ; i++ )
+		pthread_join(managers[i], NULL);
+
+	/* (2) Close listening socket */
+	close(listensock);
+
+	return 0;
+}
 
 
-	/* [5] Wait for data
+
+
+
+
+
+
+
+
+void* manageClient(void* pthread_args){
+
+
+	/* [1] Initialization
+	=========================================================*/
+	/* (1) Initialize socket data */
+	struct sockaddr_in addr_client;
+	char* to_send = (char*) malloc( BUFSIZE * sizeof(char) );
+	char* to_recv = (char*) malloc( BUFSIZE * sizeof(char) );
+	int bytes; // transfer count
+	char client_ip[20];
+
+	/* (2) Fetch arguments */
+	pthread_arg_wrapper* arguments = (pthread_arg_wrapper*) (intptr_t) pthread_args;
+
+	// get client_socket
+	int datasock     = arguments->socket;
+	int thread_index = arguments->index;
+
+	strcpy(to_send, "server default response"); 
+
+
+	DEBUG&& debug("thread", "starting thread");
+	DEBUG&& printf("success[%d]\n", thread_index);
+
+	/* [2] Wait for data
 	=========================================================*/
 	/* (1) wait/read data */
 	bytes = xread(datasock, to_recv, BUFSIZE);
@@ -92,9 +161,10 @@ int main(int argc, char* argv[]){
 	inet_ntop(AF_INET, &(addr_client.sin_addr), client_ip, 20);
 
 	printf("*** received '%s' (%d bytes) from %s:%d\n", to_recv, bytes, client_ip, ntohs(addr_client.sin_port));
-	
 
-	/* [6] Send response
+
+
+	/* [3] Send response
 	=========================================================*/
 	/* (1) Send response */
 	bytes = xwrite(datasock, to_send);
@@ -106,10 +176,13 @@ int main(int argc, char* argv[]){
 	}
 
 
-	/* [6] Close socket
-	=========================================================*/
-	close(datasock);
-	close(listensock);
 
-	return 0;
+	/* [4] End process
+	=========================================================*/
+	/* (1) Close data socket */
+	close(datasock);
+
+	/* (2) Mark manager as inactive again */
+	managers[thread_index] = 0;
+
 }
diff --git a/server.h b/server.h
index 085b371..1dcad0f 100644
--- a/server.h
+++ b/server.h
@@ -14,9 +14,25 @@
 	#include <sys/socket.h>
 	#include <netinet/in.h>
 	#include <errno.h>
+	#include <pthread.h>
 
 
 	#include "lib.h"
 
+	// DEFINITIONS
+	typedef struct{
+		int socket;
+		int index;
+	} pthread_arg_wrapper;
+	
+
+	// VARIABLES
+	static pthread_t managers[maxClients];       // containa THREADS
+	static int a_managers[maxClients] = {0}; // contains THREADS actifs
+
+	/************************************************
+	****                Signatures               ****
+	************************************************/
+	void* manageClient(void* pthread_args);
 
 #endif
diff --git a/server.o b/server.o
index 868c4a5b2661239c80ee2a7ed2b193172cb8daad..b91c6576f48562e00bd65d7b7ac15d1e499daf03 100644
GIT binary patch
literal 8792
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

literal 6968
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
K0=?W+|NjLyMIuxH