VLC-Android和VLC几个关键宏定义的分析
在用SourceInsight分析VLC-Android源码过程中,有几个宏定义在源代码中一直没有找到出处,比如 HAVE_DYNAMIC_PLUGINS和__PLUGIN__,以及MODULE_NAME和MODULE_STRING,在网上找了VLC源码的分 析资料都是老版本的,老版本中MODULE_NAME在每一个MODULES模块下面都有定义,MODULE_STRING也有如下宏定义:
- #define STRINGIFY(z) UGLY_KLUDGE(z)
- #define UGLY_KLUDGE(z) #z
- #define MODULE_STRING STRINGIFY(MODULE_NAME)
- # Module name from object or executable file name.
- MODULE_NAME = $$(p="$@"; p="$${p\#\#*/}"; p="$${p\#lib}"; echo "$${p%_plugin*}")
- AM_CPPFLAGS = \
- -DMODULE_NAME=$(MODULE_NAME) \
- -DMODULE_NAME_IS_$(MODULE_NAME) \
- -DMODULE_STRING=\"$(MODULE_NAME)\"
- if HAVE_DYNAMIC_PLUGINS
- AM_CPPFLAGS += -D__PLUGIN__
- endif
- liblive555_plugin_la-live555.lo: live555.cpp
在其下面添加如下代码
- @am__fastdepCXX_TRUE@ echo $(AM_V_CXX) $(CXX) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(liblive555_plugin_la_CPPFLAGS) $(CPPFLAGS)
- $(liblive555_plugin_la_CXXFLAGS) $(CXXFLAGS) -E -o testlive555.txt live555.cpp
VLC-Android输出如下:
- echo @echo " CXX " liblive555_plugin_la-live555.lo;
- /androidApp/android-ndk-r8b/toolchains/arm-linux-androideabi-4.6/prebuilt/linux-x86/bin//arm-linux-androideabi-g++
- --sysroot=/androidApp/android-ndk-r8b/platforms/android-9/arch-arm -DHAVE_CONFIG_H -I. -I../../../modules/demux -I../..
- -DMODULE_NAME=$(p="liblive555_plugin_la-live555.lo"; p="${p##*/}"; p="${p#lib}"; echo "${p%_plugin*}")
- -DMODULE_NAME_IS_$(p="liblive555_plugin_la-live555.lo"; p="${p##*/}"; p="${p#lib}"; echo "${p%_plugin*}")
- -DMODULE_STRING=\"$(p="liblive555_plugin_la-live555.lo"; p="${p##*/}"; p="${p#lib}"; echo "${p%_plugin*}")\"
- -I../../../include -I../../include -I/androidApp/android-ndk-r8b/sources/cxx-stl/gnu-libstdc++/4.6/include
- -I/androidApp/android-ndk-r8b/sources/cxx-stl/gnu-libstdc++/4.6/libs/armeabi-v7a/include
- -I/vlc-android/android/vlc/contrib/arm-linux-androideabi/include
- -I/vlc-android/android/vlc/contrib/arm-linux-androideabi/include/liveMedia
- -I/vlc-android/android/vlc/contrib/arm-linux-androideabi/include/groupsock
- -I/vlc-android/android/vlc/contrib/arm-linux-androideabi/include/BasicUsageEnvironment
- -I/vlc-android/android/vlc/contrib/arm-linux-androideabi/include/UsageEnvironment -g -O2
- -fstrict-aliasing -funsafe-math-optimizations -mlong-calls
- -I/vlc-android/android/vlc/contrib/arm-linux-androideabi/include -Wall -Wextra -Wsign-compare
- -Wundef -Wpointer-arith -Wvolatile-register-var -fvisibility=hidden -ffast-math -funroll-loops
- @echo CXX liblive555_plugin_la-live555.lo
VLC输出如下:
- echo @echo " CXX " liblive555_plugin_la-live555.lo;
- g++ -DHAVE_CONFIG_H -I. -I../..
- -DMODULE_NAME=$(p="liblive555_plugin_la-live555.lo"; p="${p##*/}"; p="${p#lib}"; echo "${p%_plugin*}")
- -DMODULE_NAME_IS_$(p="liblive555_plugin_la-live555.lo"; p="${p##*/}"; p="${p#lib}"; echo "${p%_plugin*}")
- -DMODULE_STRING=\"$(p="liblive555_plugin_la-live555.lo"; p="${p##*/}"; p="${p#lib}"; echo "${p%_plugin*}")\"
- -D__PLUGIN__
- -I../../include -I../../include
- -I/home/vlc/contrib/i486-linux-gnu/include
- -I/home/vlc/contrib/i486-linux-gnu/include/liveMedia
- -I/home/vlc/contrib/i486-linux-gnu/include/groupsock
- -I/home/vlc/contrib/i486-linux-gnu/include/BasicUsageEnvironment
- -I/home/vlc/contrib/i486-linux-gnu/include/UsageEnvironment -g -O2
- -I/home/vlc/contrib/i486-linux-gnu/include -Wall -Wextra -Wsign-compare -Wundef -Wpointer-arith
- -Wvolatile-register-var -fvisibility=hidden -ffast-math -funroll-loops -fomit-frame-pointer
- @echo CXX liblive555_plugin_la-live555.lo
从上面的输出可以看出,gcc的确添加了MODULE_NAME,MODULE_NAME_IS_,MODULE_STRING的宏定义,但是两个还略有 不同,即VLC还添加了__PLUGIN__的宏定义,而VLC-Android没有,这就是VLC-Android和VLC的根本的不同,VLC- Android的各个模块实际上是静态加载的,而VLC的各个模块默认是动态加载的,对于动态加载如网上的很多资料所说,除了main模块调用的实际函数 为导出函数vlc_entry_main,其他模块导出的均为vlc_entry__2_1_0a(本文VLC版本为2.0.4)。而对于静态加载,每一 个模块都有它自己的导出函数,为了验证,同样对live555.cpp文件进行预编译处理,即gcc -E,如上面代码在makefile.in中的配置,注意去掉echo。我们查看两个工程的输出文档testlive555.txt,可以发现如下:
VLC-Android中的该文件内容为:
- extern "C" int vlc_entry__live555 (vlc_set_cb, void *);
- extern "C" int vlc_entry__live555 (vlc_set_cb vlc_set, void *opaque)
- {
- module_t *module;
- module_config_t *config = __null;
- if (vlc_set (opaque, __null, VLC_MODULE_CREATE, &module)) goto error;
- if (vlc_set (opaque, module, VLC_MODULE_NAME, ("live555"))) goto error;
- ...
- extern "C" __attribute__((visibility("default"))) int vlc_entry__2_1_0a (vlc_set_cb, void *);
- extern "C" __attribute__((visibility("default"))) int vlc_entry__2_1_0a (vlc_set_cb vlc_set, void *opaque)
- {
- module_t *module;
- module_config_t *config = __null;
- if (vlc_set (opaque, __null, VLC_MODULE_CREATE, &module)) goto error;
- if (vlc_set (opaque, module, VLC_MODULE_NAME, ("live555"))) goto error;
- ...
说明分析结果为真,实际上代码中也已经有了说明,我们查看vlc/include/vlc_plugin.h中有如下定义
- # define MODULE_SYMBOL 2_1_0a
- # define MODULE_SUFFIX "__2_1_0a"
- #define CONCATENATE( y, z ) CRUDE_HACK( y, z )
- #define CRUDE_HACK( y, z ) y##__##z
- #ifdef __PLUGIN__
- # define __VLC_SYMBOL( symbol ) CONCATENATE( symbol, MODULE_SYMBOL )
- #else
- # define __VLC_SYMBOL( symbol ) CONCATENATE( symbol, MODULE_NAME )
- #endif
即定义了__PLUGIN__,那么就用MODULE_SYMBOL,否则就用MODULE_NAME,那么__PLUGIN__又在哪里定义了呢?为什么VLC-Android和VLC又不同呢,我们回到上面的源头,发现
- if HAVE_DYNAMIC_PLUGINS
- AM_CPPFLAGS += -D__PLUGIN__
- endif
那么这个HAVE_DYNAMIC_PLUGINS又从哪里来呢?这实际上就是VLC-Android和VLC两者的不同,一个有宏定义__PLUGIN__,一个没有宏定义__PLUGIN__。
而实际上HAVE_DYNAMIC_PLUGINS是在运行configure过程中对其进行配置的。
我们在vlc/configure.ac中发现有如下代码:
- dnl Check for dynamic plugins
- LIBDL=""
- have_dynamic_objects="no"
- VLC_SAVE_FLAGS
- AC_SEARCH_LIBS(dlopen, [dl svld], [
- AS_IF([test "$ac_cv_search_dlopen" != "none required"], [
- LIBDL="$ac_cv_search_dlopen"
- ])
- have_dynamic_objects="yes"
- ])
- VLC_RESTORE_FLAGS
- # Windows
- AS_IF([test "${SYS}" = "mingw32"], [
- LIBDL=""
- have_dynamic_objects="yes" #assume we can use shared objects
- ])
- AS_IF([test "${enable_shared}" = "no"], [
- have_dynamic_objects=no
- ])
- AM_CONDITIONAL(HAVE_DYNAMIC_PLUGINS, [test "${have_dynamic_objects}" != "no"])
这就是问题的源头所在了,即在运行configure时是否配置了--enable-shared来决定HAVE_DYNAMIC_PLUGINS为 true还是false,因此我们再去查看运行configure时的配置,在VLC-Android的android目录下的configure.sh 文件中,我们发现了如下代码:
- sh $VLC_SOURCEDIR/configure --host=$TARGET_TUPLE --build=x86_64-unknown-linux $EXTRA_PARAMS \
- --enable-live555 --enable-realrtsp \
- --enable-avformat \
- --enable-swscale \
- --enable-avcodec \
- --enable-opus \
- --enable-opensles \
- --enable-android-surface \
- --enable-mkv \
- --enable-taglib \
- --enable-dvbpsi \
- --disable-vlc --disable-shared \
问题实际上已经浮出水面,这里配置了--disable-shared,而在VLC中我们一般保持默认配置,为此我们再运行vlc目录下的configure --help来查看默认配置选项,在输出的文档中我们发现了如下描诉:
- --enable-shared[=PKGS] build shared libraries [default=yes]
- --enable-static[=PKGS] build static libraries [default=no]
- --with-pic try to use only PIC/non-PIC objects [default=use
- both]
- --enable-fast-install[=PKGS]
- optimize for fast installation [default=yes]
即默认配置为--enable-shared,再结合前面的代码,就可以知道VLC-Android中的HAVE_DYNAMIC_PLUGINS值为 FALSE,而VLC中的HAVE_DYNAMIC_PLUGINS值为TRUE,从而添加了__PLUGIN__的宏定义。以此为源头从而影响了 VLC-Android和VLC后面的一系列不同的代码。