%META:TOPICINFO{author="MarvChiang" date="1108183528" format="1.0" version="1.9"}%
%META:TOPICPARENT{name="WebHome"}%
<h2><a name="Proposed_Timeline"> </a> Proposed Timeline </h2>

<table>
<tr>

<td width=100><u><b>Date</b></u></td>  <td><u><b>Weight</b></u></td>  <td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<u><b>Project</b></u><br></td>
</tr>

<tr>
<td valign=top bgcolor=CCDDFF><b>2005-1-19</b></td> 
<td align=center valign=top bgcolor=DDFFCC>4%</td>  
<td bgcolor=FFFFCC><ul><li>Projects 0 and 1</li>
				 <li>Install Linux (Fedora Core 3) on desktop and laptop.</li>
				 <li>Download, build and install WINE.</li></ul></td>
</tr>

<tr>
<td valign=top bgcolor=CCDDFF><b>2005-1-21</b></td>
<td align=center valign=top bgcolor=DDFFCC>1%</td>
<td bgcolor=FFFFCC><ul><li>  Initial schedule</li>
				 <li>Submit progress report to TA.</li></ul></td>
</tr>



<tr>
<td valign=top bgcolor=CCDDFF><b>2005-2-2</b></td>
<td align=center valign=top bgcolor=DDFFCC>5%</td>
<td bgcolor=FFFFCC><ul><li>  Finish project 2</li>
				 <li>Research DLLs and choose one.</li></ul></td>
</tr>

<tr>
<td valign=top bgcolor=CCDDFF><b>2005-2-11</b></td>
<td align=center valign=top bgcolor=DDFFCC>7%</td>
<td bgcolor=FFFFCC><ul><li>  Design winsock conformance test.</li>
				 <li>Determine common uses of DLL and pick 2-3 functions to test.</li>
				 <li>Come up as many test cases as possible.</li></ul></td>
</tr>

<tr>
<td valign=top bgcolor=CCDDFF><b>2005-2-18</b></td>
<td align=center valign=top bgcolor=DDFFCC>6%</td>
<td bgcolor=FFFFCC><ul><li>  Get the expected results.</li>
				 <li>Develop wine32 app with test cases and run it on Windows XP.</li>
				 <li>Record all the outputs.</li></ul></td>
</tr>

<tr>
<td valign=top bgcolor=CCDDFF><b>2005-2-25</b></td>
<td align=center valign=top bgcolor=DDFFCC>7%</td>
<td bgcolor=FFFFCC><ul><li>  Run tests on Linux.</li>
				 <li>Run the same tests on Linux.</li>
				 <li>Compare the outputs.</li></ul></td>
</tr>

<tr>
<td valign=top bgcolor=CCDDFF><b>2005-3-4</b></td>
<td align=center valign=top bgcolor=DDFFCC>3%</td>
<td bgcolor=FFFFCC><ul><li>  Submit conformance test and bug report to wineHQ.</li>
				 <li>Add more test cases if necessary and resubmit.</li></ul></td>
</tr>

<tr>
<td valign=top bgcolor=CCDDFF><b>2005-3-17</b></td>
<td align=center valign=top bgcolor=DDFFCC>7%</td>
<td bgcolor=FFFFCC><ul><li>  Winsock conformance test demo.</li>
			  <li>Conformance test accepted into wineHQ CVS.</li></ul></td>
</tr>

</table>


<h2> Incremental Progress </h2>
<strong>2005-01-19:</strong>
<ul>
<li> Installed Fedora Core 3 on a desktop and laptop
</li>
<li> Downloaded, Installed, and Built WINE
</li>
<li> Successfully ran notepad.exe.so
</li>
</ul>

<strong>2005-01-20:</strong>
<ul><li>  Began initial stages of Project 2</li>
				 <li>Ran conformance test suite under WINE.</li>
				 <li>Got more errors and "Test failed" cases than expected - debugging.</li>
</ul>

<strong>2005-01-21:</strong>
<ul><li>  Created initial schedule</li>
				 <li>Submitted progress report to TA.</li></ul>

<p />
<strong>2005-01-28:</strong>
<ul>
<li>Researched DLLs and chose Winsock DLL.
</li>
<li>Chose single thread, non-blocking I/O
</li>
</uL>

<p />
<strong>2005-02-03:</strong>
<ul>
<li> Ran conformance test. Didn't get the same results as Dan, but the errors seem to be unrelated to what we're doing. Here's the output of 'grep "Test failed" log | sed 's/:.*//' | uniq -c | sort':
</li>
<pre>
	  13 generated.c
		1 url.c
		2 typelib.c
		3 file.c
</pre>
<li> Logfile for conformance test (laptop):
<a href="http://www.seas.ucla.edu/~marvin/log">conformance log</a>
</li>
</ul>

<strong>2005-02-11:</strong>
<ul>
 
<li>Decided on which Winsock APIs to test.  We are using the
  following functions because they are fundamental for creating
  the client/server Winsock model.  We may decide to expand to 
  more interesting fucntions if we get a chance.  We will be using
  multi-threaded asynchronous connection using these APIs.
</li>
<pre>
	- int WSAStartup( WORD wVersionRequested, LPWSADATA lpWSAData );
	- SOCKET socket( int af, int type, int protocol );
	- int bind( SOCKET s, const struct sockaddr* name, int namelen );
	- int listen( SOCKET s, int backlog );
	- SOCKET accept( SOCKET s, struct sockaddr* addr, int* addrlen );
	- int connect( SOCKET s, const struct sockaddr* name, int namelen );
	- int send( SOCKET s, const char* buf, int len, int flags );
	- int recv( SOCKET s, char* buf, int len, int flags );
</pre>


<li>
Test cases for WSAStartup():

<pre>
1. Request the following Winsock versions for WORD wVersionRequested:
	a. 1.0
	b. 1.1
	c. 2.0
	
	Using the different combinations, generate the error code 
WSAVERNOTSUPPORTED, and proper version requests.

2. Pass in a bad pointer for lpWSAData, and generate WSAEFAULT error.
3. Remove the Windows Sockets DLL file to attempt to generate the
	WSASYSNOTREADY error.
4. Instantiate two network operations to generate WSAEINPROGRESS
	error and possibly the WSAEPROCLIM error.
5. Record multiple successful calls and verify return code 0.
</pre>
</li>



<li>
Test cases for socket():
<pre>
  1 Success  - return socket descriptor(no way to verify except that
	 it's != INVALID_SOCKET)
	  a. TCP
	  b. UDP
  2. Fail  - return INVALID_SOCKET 
	  a. WAStartup was not called(or failed)
	  b. invalid address
	  c. no more socket descriptors(will try to implement but may not
		  be able to)
	  d. no more buffer(same as above)
	  e. invalid protocol
</pre>
</li>


<li>
Test cases for bind():
<pre>
  1. Successful Bind
		a. TCP
		b. UDP
  2. Error
		a. return SOCKET_ERROR
			i.	invalud SOCKET descriptor
			ii.  invalid sockaddr struct
			iii. invalid namelen
			iv. unsuccessful WAStartup called
			v.  tried to open UDP when SO_BROADCAST is not enabled
			vi. address is already bound to another process
			vii. invalud address
			viii. socket already bound to another address
			ix.  too many connections/not enough buffer -> not sure if this can be done yet
</pre>
</li>


<li>
Test cases for listen():
<pre>
  1 success - return 0
	  a. TCP
	  b. UDP
  2. fail - return SOCKET_ERROR
	  a. WAStartup not called successfully
	  b. socket's local address is already in use
	  c. socket not bound with bind()
	  d. socket is already connected
	  e. no more socket descriptors available
	  f.  No more buffer space
	  g. invalid descriptor
</pre>
</li>


<li>
Test cases for accept():
<pre>
1. Success - returns a value of type SOCKET (descriptor for new socket)
	  a. TCP
	  b. UDP
2. Failure - returns a value of INVALID_SOCKET
	  a. Call before initialization, generating WSANOTINITIALISED error.
	  b. Use a small addrlen for WSAEFAULT error.
	  c. Call during a blocking sockets call to get WSAEINTR error.
	  d. Simulate network failure to get WSAENETDOWN error.
	  e. Use an invalid socket to generate WSAEOPNOTSUPP error.
	  f. Flood the buffer to generate WSAENOBUFS error.
</pre>
</li>


<li>
Test cases for connect():
<pre>
  1. Success - 0 returned
	  a. TCP
	  b. UDP
  2. Fail - SOCKET_ERROR returned
	  a. WAStartup not called successfully
	  b. socket's local address already in use
	  c. invalid address
	  d. invalud namelen
	  e. socket parameter is a listening socket
	  f. socket already connected
	  g. no buffer space
	  h. invalid descriptor
</pre>
</li>








<li>
Test cases for send():
<pre>
1. Success - returns number of bytes received(!= SOCKET_ERROR)
	  a. TCP
	  b. UDP
2. Failure 
	  a. Pass invalid socket descriptor to generate WSAENOTSOCK error.
	  b. Call the fucntion before initialization to generate WSANOTINITIALIZED.
	  c. Create an extremely large input buffer to generate WSAEMSGIZE error.
	  d. Simulate network failure for errors WSAENETDOWN, WSAECONNRESET, WSETIMEDOUT
	  e. Call during blocking Windows call in progress to get WSAEINPROGRESS.
</pre>
</li>


<li>
Test cases for recv():
<pre>
  1. Success - returns number of bytes received(!= SOCKET_ERROR)
	  a. TCP
	  b. UDP
  for each try to test cases where you get 0 byte(connection closed) and non-0 bytes received
  2. Fail - returns SOCKET_ERROR
	  a.  WAStartup was not called successfullly
	  b.  socket not connected
	  c.  buf not allocated properly
	  d.  invalid descriptor
	  e.  socket was marked 'non-blocking' even though recv() will block 
	  f.	message was too large(truncated)
	  g.  bind was not successfully called earlier
</pre>
</li>





</ul>

<h2> Grade Spreadsheet </h2>
	
	* [[%ATTACHURL%/wine1_status.xls][wine1_status.xls]]: WINE 1 - Grade File

%META:FILEATTACHMENT{name="wine1_status.xls" attr="" comment="WINE 1 - Grade File" date="1108186049" path="C:\Documents and Settings\Mogs\Desktop\wine1_status.xls" size="15360" user="MarvChiang" version="1.2"}%