2006-09-05 09:50:45 +00:00
|
|
|
Explain the cmake build system for wireshark
|
|
|
|
|
|
|
|
$Id$
|
2006-09-05 09:27:22 +00:00
|
|
|
|
|
|
|
Notice
|
|
|
|
|
2009-09-11 13:30:01 +00:00
|
|
|
To find out the current state of the cmake implementaion for
|
|
|
|
Wireshark, please take a look at "What needs to be done?" below.
|
2006-09-05 09:27:22 +00:00
|
|
|
Basically this is an experiment and if we find out that it works
|
|
|
|
and we like cmake more than autofoo we might switch one day.
|
|
|
|
|
|
|
|
Table of contents
|
|
|
|
=================
|
|
|
|
|
|
|
|
How to get started with cmake?
|
|
|
|
Why cmake?
|
|
|
|
Why not cmake?
|
|
|
|
What needs to be done?
|
2006-09-05 12:04:46 +00:00
|
|
|
Links regarding cmake
|
2006-09-05 09:27:22 +00:00
|
|
|
|
|
|
|
How to get started with cmake?
|
|
|
|
==============================
|
|
|
|
|
|
|
|
You can find documentation on cmake at: http://www.cmake.org/
|
|
|
|
|
|
|
|
cmake is designed to support out of tree builds. So much so, that
|
|
|
|
in tree builds do not work properly in all cases.
|
|
|
|
|
|
|
|
How to do out of tree build (Unix/Linux):
|
|
|
|
1) Install cmake.
|
2009-09-11 13:30:01 +00:00
|
|
|
2) Assuming, you are in the top directory of the wireshark source
|
2006-09-05 09:27:22 +00:00
|
|
|
cd ..
|
2009-09-11 13:30:01 +00:00
|
|
|
3) mkdir build
|
|
|
|
4) cd build
|
|
|
|
5) cmake ../<Name_of_WS_source_dir>
|
|
|
|
6) make
|
2006-09-05 09:27:22 +00:00
|
|
|
|
2009-09-23 19:41:08 +00:00
|
|
|
Note 1:
|
|
|
|
in step 5), you may override the defaults for features:
|
|
|
|
cmake -DENABLE_CAP=OFF ../<Name_of_WS_source_dir>
|
|
|
|
will disable the capabilities check.
|
|
|
|
|
|
|
|
Note 2:
|
|
|
|
On OS X, you may want to run cmake like this:
|
|
|
|
cmake -DENABLE_CAP=OFF -G "Unix Makefiles"
|
|
|
|
|
2009-12-29 12:12:26 +00:00
|
|
|
Note 3:
|
|
|
|
After running cmake, you can always run "make help" to see
|
|
|
|
a list of all possible make targets.
|
|
|
|
|
2006-09-05 09:27:22 +00:00
|
|
|
Why cmake?
|
|
|
|
==========
|
|
|
|
- Can create project files for some MS and Apple IDEs.
|
|
|
|
- Fast
|
|
|
|
- Easier to understand/learn
|
2009-09-11 13:30:01 +00:00
|
|
|
- Doesn't create any files in the source tree in case
|
|
|
|
of out of tree builds
|
|
|
|
- One build infrastructure even including Windows
|
2006-09-05 09:27:22 +00:00
|
|
|
...
|
|
|
|
|
|
|
|
Why not cmake?
|
|
|
|
==============
|
|
|
|
- Lots of work to do
|
|
|
|
- Everyone who wants to build from source needs cmake
|
|
|
|
- Current state of documentation isn't really better than
|
|
|
|
autofoo documentation, in some respect it's even worse
|
|
|
|
(you need to buy a book to get an explanation as to how
|
|
|
|
cmake really works).
|
|
|
|
...
|
|
|
|
|
2009-09-11 13:30:01 +00:00
|
|
|
What works?
|
|
|
|
===========
|
2006-09-05 09:27:22 +00:00
|
|
|
|
2009-10-09 20:14:56 +00:00
|
|
|
All the executables now build from clean source on:
|
2010-03-07 19:40:25 +00:00
|
|
|
* 32bit openSUSE 11.2
|
2010-06-03 13:04:22 +00:00
|
|
|
* 64bit FedoraXXX
|
2009-10-09 20:14:56 +00:00
|
|
|
* 32bit Ubuntu 9.04
|
2010-06-06 06:09:26 +00:00
|
|
|
* 32bit Ubuntu 10.04
|
2006-09-05 09:27:22 +00:00
|
|
|
|
2009-09-11 13:30:01 +00:00
|
|
|
What needs to be done?
|
|
|
|
======================
|
2006-09-05 09:27:22 +00:00
|
|
|
|
2009-10-09 20:14:56 +00:00
|
|
|
- Add asn1 autogen target (assigned: krj)
|
2010-03-07 19:40:25 +00:00
|
|
|
- Redo glib2 find modules.
|
2009-09-11 13:30:01 +00:00
|
|
|
- Add back platform specific objects.
|
|
|
|
- Fix places in the cmake files marked as todo.
|
|
|
|
- Add back (working) install target.
|
2009-09-23 04:41:14 +00:00
|
|
|
Currently, directories are created with user umask
|
2009-09-11 13:30:01 +00:00
|
|
|
- Build source package (using CPack).
|
|
|
|
- Build rpm package (using CPack).
|
2009-09-30 14:06:11 +00:00
|
|
|
- Build dpkg package (using CPack).
|
2009-09-11 13:30:01 +00:00
|
|
|
- Add back checkAPI target.
|
|
|
|
- Test and add support for other platforms (BSDs, OSX,
|
|
|
|
Solaris, Win32, Win64, ...)
|
|
|
|
...
|
2006-09-05 09:27:22 +00:00
|
|
|
|
2006-09-05 12:04:46 +00:00
|
|
|
Links regarding cmake
|
|
|
|
=====================
|
|
|
|
The home page of the cmake project
|
|
|
|
http://www.cmake.org/
|
|
|
|
|
|
|
|
The home page of the cmake project documentation
|
|
|
|
http://www.cmake.org/Wiki/CMake
|
|
|
|
|
|
|
|
About cmake in general and why KDE4 uses it
|
|
|
|
http://lwn.net/Articles/188693/
|
|
|
|
|
2009-09-11 13:30:01 +00:00
|
|
|
Introductory/tutorial presentation
|
|
|
|
http://ait.web.psi.ch/services/linux/hpc/hpc_user_cookbook/tools/cmake/docs/Cmake_VM_2007.pdf
|
|
|
|
|
2006-09-05 12:04:46 +00:00
|
|
|
Introductory arcticle in Linux Journal
|
|
|
|
http://www.linuxjournal.com/node/6700/print
|
|
|
|
|
|
|
|
Useful variables
|
|
|
|
http://www.cmake.org/Wiki/CMake_Useful_Variables
|
|
|
|
|
|
|
|
cmake FAQ
|
|
|
|
http://www.cmake.org/Wiki/CMake_FAQ
|
|
|
|
|
2006-09-06 22:14:20 +00:00
|
|
|
Additional cmake modules
|
|
|
|
http://code.google.com/p/cmake-modules/
|