Project

General

Profile

Google Summer of Code 2013 » History » Version 64

Christian Babeux, 03/14/2013 04:31 PM

1 1 Christian Babeux
h1. Google Summer of Code 2013
2 3 Christian Babeux
3 50 Christian Babeux
Google Summer of Code is a global program that offers students stipends to write code for open source projects. 
4
5
This would be the first year of participation for the LTTng project.
6
7 52 Christian Babeux
h1. Guidelines for students applying to GSoC
8 51 Christian Babeux
9 53 Christian Babeux
Here a few guidelines and advices for aspiring applicants to GSoC:
10
11 55 Christian Babeux
* Submit your application to Google by May 3 2013 19:00 UTC.
12
13 60 Christian Babeux
* Join the IRC #lttng channel on OFTC (irc://irc.oftc.net/lttng) to discuss on your application and project ideas.
14 58 Christian Babeux
  Since IRC and the mailing list are our usual means of communications, applicants who have shown initiative in communicating with the community will be favoured in the applications review.
15 55 Christian Babeux
16 59 Christian Babeux
* Subscribe to the lttng-dev "mailing list":http://lists.lttng.org/cgi-bin/mailman/listinfo/lttng-dev.
17
18 61 Christian Babeux
* Impress us! Try submitting a patch for simple issues such as typos, documentation, simple bug (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 whole toolchain on some of your personal projects and come up with a problematic situation (performance issue, ease of debugging, etc.) where *your* project idea using tracing could potentially solve.
19
20 63 Christian Babeux
* Don''t panic! Some portion of the LTTng project can be quite intricate and technically challenging, we don''t expect applicants to be familiar with all the concepts behind the various LTTng codebases.
21 53 Christian Babeux
22 14 Christian Babeux
h1. Project Ideas
23 2 Christian Babeux
24 13 Christian Babeux
h2. Babeltrace python bindings
25 3 Christian Babeux
26 4 Christian Babeux
*Brief explanation*:
27 2 Christian Babeux
28
Provide Python bindings to the Babeltrace APIs to provide a complete CTF reading/writting infrastructure to Python programmers.
29 1 Christian Babeux
30 41 Christian Babeux
Most of the public Babeltrace API is currently mapped using SWIG. However, a more “Pythonic” set of wrapper classes will make trace reading and writing more accessible than using the current native API. The production and interpretation of CTF traces in a high level language such as Python will ease the development of custom trace analysis solutions. It will also provide a convenient language in which to implement trace conversion plugins.
31 4 Christian Babeux
32 41 Christian Babeux
*Expected results*: A set of "Pythonic" bindings, tests, code examples and documentation. 
33 4 Christian Babeux
34
*Complementary information*:
35
36
The Common Trace Format (CTF) specifies a trace format based on the requirements of the industry (through collaboration with the Multicore Association) and the Linux community.
37 6 Christian Babeux
38 4 Christian Babeux
Babeltrace is a trace conversion library that aims to provide a convenient to read and convert trace files between different formats. It currently supports CTF, which is the trace format outputted by the LTTng 2.0 tracers and provides the CTF reference implementation.
39
40
*Skill level*: Easy - Medium
41 5 Christian Babeux
42 4 Christian Babeux
*Prerequisite Knowledge*: Python, OO development
43 5 Christian Babeux
44 34 Christian Babeux
*Mentors*: Jérémie Galarneau (jgalar)
45 7 Christian Babeux
46 13 Christian Babeux
h2. Trace probe support in C++
47 7 Christian Babeux
48
*Brief explanation*:
49
50 12 Christian Babeux
The LTTng userspace tracing relies on the instrumentation of target applications with tracepoint probes. Currently, the only way to use tracepoints in C++ applications is by compiling a stand-alone C library linked to liblttng-ust which is then linked to the target C++ application. 
51
52
While this method is functional, it introduces significant development time overhead and confusion for new users. This project aims at making the UST tracepoint probe code compatible with popular C++ compilers to enable direct compilation of the providers with the application. The necessary modifications should not be too complex but are an excellent introductory project.
53 7 Christian Babeux
54 43 Christian Babeux
*Expected results*: Probe can be compiled in a C++ application. Examples and documentation of the usage of probes in C++.
55 7 Christian Babeux
56
*Complementary information*:
57 9 Christian Babeux
58 8 Christian Babeux
Issue #338
59 7 Christian Babeux
60
*Skill level*: Easy - Medium
61
62
*Prerequisite Knowledge*: C++ development, C development, build environments
63
64 35 Christian Babeux
*Mentors*: Jérémie Galarneau (jgalar)
65 10 Christian Babeux
66 13 Christian Babeux
h2. Development of an strace-like wrapper
67 10 Christian Babeux
68
*Brief explanation*:
69
70 44 Christian Babeux
The LTTng kernel tracer should provide all the functionality required to emulate the behaviour of the strace utility. The goal of this project is the development of an strace drop-in replacement based on the LTTng tracing toolchain that shall provide the user with the functionality of strace and the performance characteristics of the LTTng kernel tracer. This should ensure backward compatibility with tools based on the strace output format.
71 11 Christian Babeux
72 10 Christian Babeux
This should be implemented as a Babeltrace trace converter plug-in used in “live mode” -- an upcoming Babeltrace feature currently being developped by Julien Desfossez. The resulting plug-in will enable seamless interoperability between CTF and strace-based tools.
73
74 44 Christian Babeux
*Expected results*: A wrapper/script or an additional command line switch to the lttng binary mimicking strace behavior. Tests and documentation of the new functionality.
75 10 Christian Babeux
76
*Complementary information*:
77
78
Issue #15
79
80
*Skill level*: Medium
81 11 Christian Babeux
82 10 Christian Babeux
*Prerequisite Knowledge*:  C development, scripting
83 11 Christian Babeux
84 36 Christian Babeux
*Mentors*: Julien Desfossez (jdesfossez), David Goulet (dgoulet)
85 15 Christian Babeux
86 17 Christian Babeux
h2. Improvement of liblttng-ust-libc-wrapper''s coverage of libc''s functions
87 18 Christian Babeux
88 15 Christian Babeux
*Brief explanation*:
89
90
liblttng-ust-libc-wrapper is a library that currently provides a wrapper around libc to instrument malloc() and free() with UST tracepoint probes. This project aims to provide a full coverage of the standard libc functions.
91
92
This library is typically “LD_PRELOAD”-ed when debugging an application to override malloc() and free() symbols. The underlying libc symbol is then looked-up and called. The resulting trace can then be analyzed to identify memory allocation issues. Gaining a better libc coverage will provide LTTng users with even better debugging capabilities.
93
94
As an extension to this project, one could also develop a tool to automatically generate static tracepoints for arbitrary libraries from the header files.
95
96 46 Christian Babeux
*Expected results*: A patchset implementing instrumentation in libc functions. Trace samples of program with their libc completely instrumented. Documentation and tests.
97 16 Christian Babeux
98 15 Christian Babeux
*Skill level*: Easy - Hard
99 16 Christian Babeux
100 15 Christian Babeux
*Prerequisite Knowledge*: C development, parser knowledge, scripting
101 16 Christian Babeux
102 37 Christian Babeux
*Mentors*: Christian Babeux (cbab)
103 19 Christian Babeux
104
h2. Dynamic instrumentation support in UST
105
106
*Brief explanation*:
107
108
The current UST tracer relies on static tracepoint probes manually inserted in the traced application’s source code. This project aims at providing dynamic instrumentation capabilities in arbitrary applications.
109
110
The Dyninst project already provides a great API to dynamically modify code which may come in handy in this project. This is a great opportunity to initiate a collaboration between both projects.
111
112 47 Christian Babeux
*Expected results*: TBD (Depends on the proposed approach to dynamically instrument userspace applications)
113 19 Christian Babeux
114
*Skill level*: Hard
115
116
*Prerequisite Knowledge*: C++ development, C development, Assembly
117
118 38 Christian Babeux
*Mentors*: Christian Babeux (cbab), Yannick Brosseau (scientist)
119 20 Christian Babeux
120
h2. Android port
121
122
*Brief explanation*:
123
124 28 Christian Babeux
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.
125 20 Christian Babeux
126
This project presents a number of uncertain technical hurdles but some effort has already been made in most key areas.
127
128 25 Christian Babeux
* The userspace part of the LTTng project relies on glibc features not present in Bionic -- Google''s libc implementation used on Android.
129
  - Glibc is now available on Android thanks to the efforts made by the cyborgstack project.
130 26 Christian Babeux
131 20 Christian Babeux
* System V IPC mechanisms are heavily relied-upon.
132 24 Christian Babeux
  - The Ericsson port makes use of temporary files.
133
  - Glibc on Android should provide such mechanisms.
134 26 Christian Babeux
135 24 Christian Babeux
* Userspace RCU must be ported and tested on the Android platform.
136
  - Ported by Ericsson, not mainlined.
137 20 Christian Babeux
138 48 Christian Babeux
*Expected results*: A working port of the kernel or userspace tracer running on an Android device.
139 20 Christian Babeux
140
*Complementary information*:
141
http://lists.lttng.org/pipermail/lttng-dev/2012-February/017626.html
142
143
*Skill level*: Hard
144
145
*Prerequisite Knowledge*: C development, kernel internals, Android development
146
147 39 Christian Babeux
*Mentors*: Christian Babeux (cbab), Jérémie Galarneau (jgalar), Yannick Brosseau (scientist)
148 22 Christian Babeux
149
h2. Instrumenting Open Source projects using UST
150
151
*Brief explanation*:
152
153 1 Christian Babeux
This project has a broad goal of instrumenting popular open source applications that have demanding performance constraints and that would benefit by using LTTng''s tracing infrastructure. Wine is just one example of such a project. Perhaps other projects could benefit from LTTng and provide a great test-bed that will drive wider adoption of LTTng in open source projects.
154 23 Christian Babeux
155 22 Christian Babeux
This project represents a great opportunity to instigate a collaboration between multiple open source projects. The intern will get the chance to experience the complete process of understanding an open source project''s codebase and contributing to its evolution.
156
157 49 Christian Babeux
*Expected results*: A patchset instrumenting the proposed open source project.
158 22 Christian Babeux
159 49 Christian Babeux
*Skill level*: Easy - Hard
160 22 Christian Babeux
161
*Prerequisite Knowledge*: Project dependent
162
163 40 Christian Babeux
*Mentors*: Yannick Brosseau (scientist)