Project

General

Profile

Google Summer of Code 2014 » History » Version 5

Jérémie Galarneau, 02/12/2014 03:03 PM

1 1 Jérémie Galarneau
h1. Google Summer of Code 2014
2
3
Google Summer of Code is a global program that offers students stipends to write code for open source projects. 
4
5
Following a great first experience last year, the LTTng project will participate in GSoC for a second year.
6
7
h1. Guidelines for students applying to GSoC
8
9
Here a few guidelines and advice for aspiring applicants to GSoC:
10
11
* *Submit* your application to Google by *March 21 2014 19:00 UTC*.
12
13
* *Join* the IRC #lttng channel on OFTC (irc://irc.oftc.net/lttng) to discuss your application and project ideas.
14
  Since IRC and the "mailing list":http://lists.lttng.org/cgi-bin/mailman/listinfo/lttng-dev are our usual means of communications, applicants who have shown initiative in communicating with the community will be favored during the applications review. Please refer to the "Contributor''s guide":http://raw.github.com/jgalar/lttng-doc/master/contributor-guide.txt for guidelines on submitting patches.
15
16
* *Subscribe* to the lttng-dev "mailing list":http://lists.lttng.org/cgi-bin/mailman/listinfo/lttng-dev.
17
18
* *Break the ice!* Try submitting a patch for simple issues such as typos, documentation improvements, simple bug fixes (a good starting point would be to look at the LTTng bug tracker: "issues":http://bugs.lttng.org/projects/lttng/issues?sort=priority%2Cid%3Adesc). Or you could try the complete toolchain on some of your personal projects and come up with a problematic situation (performance issue, ease of debugging, etc.) that *your* project idea could potentially solve. Perhaps you have ideas to improve LTTng''s usability? Discuss them with us, you might just have found yourself a summer project! 
19
20
* *Don''t panic!* Some portions of the LTTng project can be quite complex and technically challenging; we don''t expect applicants to be familiar with all the concepts behind the LTTng codebase.
21
22
Additional tips for a successful application: "The DOs and DON’Ts of Google Summer of Code: Student Edition":http://google-opensource.blogspot.de/2011/03/dos-and-donts-of-google-summer-of-code.html
23
24
h1. Project Ideas
25
26
The following ideas are only a starting point for applicants. Feel free to submit your own project idea!
27
28
h2. Android port
29
30
*Brief explanation*:
31
32
Port the LTTng infrastructure to the Android platform. The exact scope of this project will need to be reassessed based on the conclusions of the team currently working on this project as part of their undergrad project at École Polytechnique de Montréal.
33
34
This project presents a number of uncertain technical hurdles but some effort has already been made in most key areas.
35
36
* The userspace part of the LTTng project relies on glibc features not present in Bionic -- Google''s libc implementation used on Android.
37
  - Glibc is now available on Android thanks to the efforts made by the cyborgstack project.
38
39
* System V IPC mechanisms are heavily relied-upon.
40
  - The Ericsson port makes use of temporary files.
41
  - Glibc on Android should provide such mechanisms.
42
43
* Userspace RCU must be ported and tested on the Android platform.
44
  - Ported by Ericsson, not mainlined.
45
46
*Expected results*: A working port of LTTng''s tracers running on an Android device.
47
48
*Complementary information*:
49
http://lists.lttng.org/pipermail/lttng-dev/2012-February/017626.html
50
51
*Skill level*: Hard
52
53
*Prerequisite Knowledge*: C development, Android development
54
55
*Mentors*: Christian Babeux (cbab), Jérémie Galarneau (jgalar)
56 2 Jérémie Galarneau
57
h2. Clang plugin providing automatic application instrumentation
58
59
*Brief explanation:*
60
61
The LTTng userspace tracer relies on static tracepoint probes manually inserted in the traced application’s source code. This project aims at developing a compiler plugin that would automatically instrument an application at build time following a set of criteria.
62
63
At this time, LTTng provides only one solution to the automatic instrumentation problem. By using GCC and LLVM’s -finstrument-functions code generation option and LTTng’s cyg-profile library, it is possible for developers to trace every function entry and exit in their program. While this has proved useful in the past, this mechanism introduces a significant amount of overhead.
64
65
A more refined automatic instrumentation solution is necessary to uphold LTTng’s objective of providing a low-intrusiveness tracing solution. A compiler plugin seems to be one of the most flexible solution to this problem. Such a plug-in could allow the instrumentation of functions whose name match a certain expression, instrumentation of all calls made to a particular library, instrumentation of functions listed in a separate file, etc.
66
67
A natural extension of this project is the development of analysis scripts using the Babeltrace Python API to detect resource leaks, dead code, hot paths and so on.
68 1 Jérémie Galarneau
69 3 Jérémie Galarneau
*Expected results:* A compiler plugin processing rules to automatically instrument an application at build time.
70
71 2 Jérémie Galarneau
*Skill level:* Hard
72 3 Jérémie Galarneau
73 2 Jérémie Galarneau
*Prerequisite Knowledge:* C++ development, C development, Assembly
74 3 Jérémie Galarneau
75 2 Jérémie Galarneau
*Mentors:* Christian Babeux (cbab)
76 4 Jérémie Galarneau
77
h2. Easing the integration of tracepoints in user space applications
78
79
*Brief explanation:*
80
81 1 Jérémie Galarneau
The LTTng userspace tracer relies on static tracepoint probes manually inserted in the traced application’s source code.
82 5 Jérémie Galarneau
83 1 Jérémie Galarneau
The currently privileged instrumentation method consists in creating a C header which contains a description of an LTTng event and declares a tracepoint. This header is then included by the application developer and called the same way a function would.
84 5 Jérémie Galarneau
85 4 Jérémie Galarneau
These tracepoint provider headers contain a significant amount of boilerplate code and impose a maintenance cost which is considered unreasonable by certain application developers. The amount of files to keep in the project’s tree is also greatly increased since each tracepoint has an associated header and, possibly, implementation file (.c).
86 1 Jérémie Galarneau
Recognizing the need for a more streamlined instrumentation approach, we now ship the lttng-gen-tp script as part of lttng-tools. This script can be used to generate the necessary tracepoint headers and implementation files but still requires the developer to manually create tracepoint declaration files.
87 5 Jérémie Galarneau
88 1 Jérémie Galarneau
Discussions with developers have led us to propose a certain number of improvements to lttng-gen-tp as a Google Summer of Code project.
89 5 Jérémie Galarneau
90 1 Jérémie Galarneau
The first improvement we propose is supporting the definition of probes as function signatures using only built-in types.
91 5 Jérémie Galarneau
92 1 Jérémie Galarneau
A slightly more advanced feature would let developers specify which variables they wish to trace. The tool would then analyze the source code and create the appropriate probe signature from the type information. For instance, to create a tracepoint logging variables “session”, “ret” and “len” in a function “create_session”, the user would invoke the tool as:
93 5 Jérémie Galarneau
94
<pre>
95 1 Jérémie Galarneau
gen-tp -a session, ret, len -f create-session -i my_file.c -n my_tracepoint_name
96 5 Jérémie Galarneau
</pre>
97
98 4 Jérémie Galarneau
Finally, we would like to leverage the existing DTrace probe infrastructures currently deployed in some open source projects such as Node.js and PostgreSQL as LTTng providers. This part of the project would also give the student a chance to contribute to other projects that are currently using DTrace to adapt their build systems and add LTTng as a supported tracing back-end.
99
100 1 Jérémie Galarneau
*Expected results:* TBD
101 4 Jérémie Galarneau
102 5 Jérémie Galarneau
*Skill level:* Medium
103 4 Jérémie Galarneau
104
*Prerequisite Knowledge:* C development, Scripting
105
106
*Mentors:* Christian Babeux (cbab), Jérémie Galarneau (jgalar)