GSoC2013UnitTestingAllen < Dev

---+!! Unit Testing - Allen

%STARTINCLUDE%
   * Student: %MAINWEB%.AllenZhong
   * Mentors: %MAINWEB%.RahulKumar, %MAINWEB%.HarlanStenn
   * !GSoC: [[https://www.google-melange.com/gsoc/project/google/gsoc2013/astroprofundis/48001][GSoC Project Page]]

%STOPINCLUDE%

%TOC%

---++ Summary

__Related Items:__ UnitTestFramework, UnitTestingNotes, [[GSoC2013UnitTestingAllenWeeklyUpdates][WeeklyUpdates]], [[https://www.mainframe.cx/~ckuethe/ntp/][OpenNTPD with adjtime/adjfreq tuning]], [[LeapSecondTest]]

We use adjtime() to set time, this is implemented as adjtimex() in Linux kernel (kernel/time/ntp.c); there's also a function to set frequency as adjfreq() may needed in ntpd (ntp_loopfilter.c), these codes are not covered by our existing unit tests.

Writing tests for adjtime() may be difficult for it is a syscall on many mornden OSes, so the detailed implemention is not part of NTP, this is one of the first problems I need to solve. After writing some unit tests, testing and studying those two method is another major part of this project, some scripts will be writen to collect data from running ntpd clients and servers.
---++ Tasks
   * Get to familiar with google test framework
   * Write unit test for adjtime() and adjfreq()
   * Test mainly adjtime() and adjfreq() as client and server
   * Study how those two methods works with NTP and how are the differ from each other
   * ...

---++ Timeline

%EDITTABLE{}%
| *Date* | *Task* | *Description* | *% Done* |
| 05-27 | Community Bonding | Read documents and set up proper environment, do some sample tests for preparation. | %ICON{choice-yes}% |
| 06-17 | Coding Begins | Begin coding for the !GSoC project, write simple tests for adjtime() and ntp_adjtime(), test as client. | %ICON{choice-yes}% |
| 06-28 | A Short Travel | A short travel in weekends for a meeting, will be offline for less than 72 hours. | %ICON{choice-yes}% |
| 07-05 | Server Testing | Write more tests and do them when NTP runs as a server. | %ICON{choice-yes}% |
| 07-20 | Documetation | Cleanup former work and write documents for them, prepare for midterm evals | %ICON{choice-yes}% |
| 07-29 | BO Midterm Evals | Mentors and students can begin submitting mid-term evaluations. | %ICON{choice-yes}% |
| 08-02 | EO Midterm Evals | Mid-term evaluations deadline. Begin testing of adjfreq(). | %ICON{choice-yes}% |
| 08-09 | A Short Travel | A planned short travel for about 1 week, the work will continue during this but not full days. | %ICON{choice-yes}% |
| 08-14 | More Tests | Testing of leap-second functions. | %ICON{choice-yes}% |
| 08-25 | Analysis & Buffer | Analysis the testing results and do more tests if needed, this period is also a buffer for any unexpeted time usage. | |
| 09-16 | Wrap-up | Suggested "Pencils Down" date. Finishing documents and analysising. | |
| 09-23 | Firm "Pencils Down" | Mentors, students and organization administrators can begin submitting final evaluations to Google. | |
| 09-27 | Final Evaluation | Final Evaluations Deadline | |
| 09-27 | Code Samples | Students begin uploading code samples | |
| 10-01 | Final Results | Final Results Announced | |

---++ Discussion and Comments

%COMMENT{type="above"}%
This topic: Dev > WebHome > GoogleSummerOfCode > GSoC2013UnitTestingAllen
Topic revision: r9 - 2013-08-23 - 06:43:34 - AllenZhong