Libevent源码分析-----开篇

   我所分析的Libevent版本是2.0.21版本,是目前最新的稳定版本。看这系列博文中,需要读者有Linux编程的一些基础。因为像POSIX、文件描述符、多线程等等这些概念,我并不会去解释,我默认读者已经熟悉这些概念了。如果读者读过《UNIX环境高级编程》,那就完全没问题了。

        因为Libevent是跨平台的,所以它使用了很多它自己定义的通用跨平台类型,比如evutil_socket_t。此外,Libevent也定义了一些跨平台通用的API,这些都可以在《通用类型和函数》一文中找到。


        相信来看本系列的文章的读者,都不会是刚刚接触Libevent的用户。这里就不说Libevent的优点和怎么安装使用Libevent了。我是想介绍其他东西。

Source Insight:

        这个工具是阅读代码的神器。下面是一个截图。

        Libevent源码分析-----开篇_第1张图片

        正中央是代码窗口。在代码中,如果你想看一下event_assign函数的内部是怎么实现的,那么你不用找到event_assign函数实现文件,然后打开,再Ctrl + F查找。在Source Insight中,你只需用鼠标单击一下event_assign函数。那么就会在下面的那个窗口显示event_assign函数的具体实现。是不是很厉害的功能?

        右边的窗口是文件列表,和其他IDE的功能差不多。

        左边那个窗口功能也是很强大的,特殊是当代码中出现了很多条件宏。在这样的条件下,这个宏会被定义成这样。在那样的条件下,又会定义成那样。左边的窗口可以清楚地看到。


Doxgen工具:

        这是一个可以制作chm文件的工具。

        在Source Insight中,虽然是很容易追踪到某个函数的具体实现(实现都在c文件中,非头文件)。但Libevent的源文件中很少有注释,也没有这个函数的解释。而且Source Insight无法追踪到函数的声明,只能追踪到定义(就是函数的实现)(或许是我对Source Insight还不熟悉,如果有这样的功能,还望大家指出)。

        而由Doxgen工具生成的chm文件是离线把的帮助文档,它会列出函数的说明、参数和返回值。

        怎么用Doxgen工具制作Libevent的离线版帮助文档,可以参考 http://blog.chinaunix.net/uid-12773189-id-3022656.html


do{}while(0)宏:

        在Libevent的源代码中,经常能看到do{}while(0)宏的使用。如果是第一次碰到这种写法,估计都会比较不解。可以参考http://www.cnblogs.com/lanxuezaipiao/p/3535674.html来解惑。


函数调用关系图:

        有时候追踪一个函数,想知道该函数的调用关系图。有一个网站提供了这个关系图。下面举两个例子。

        Libevent源码分析-----开篇_第2张图片

        图中,上面的是event_free函数会调用哪些函数,一颗主调用树。下面的是哪些函数会调用event_free函数,是被调用关系。其中test_event_pending这些是Libevent提供的测试例子的测试函数。下面再给另外一个被调用关系的图:

        Libevent源码分析-----开篇_第3张图片

        有一个不足之处,这个网站并没有和Libevent同步更新,目前提供的最高Libevent版本是2.0.3-alpha


你可能感兴趣的:(Libevent源码分析-----开篇)