What is Direct Code Execution?
Direct Code Execution (DCE) is a framework for ns-3 that provides facilities to execute, within ns-3, existing implementations of userspace and kernelspace network protocols or applications without source code changes. For example, instead of using ns-3's implementation of a ping-like application, you can use the real ping application. You can also use the Linux networking stack in simulations.
- 25th March, 2016: DCE 1.8 released.
- 16th September, 2015: DCE 1.7 released.
- 6th February, 2015: DCE 1.5 released.
- 18th September, 2014: DCE 1.4 released.
- 18th June, 2014: DCE 1.3 released.
- 21st December, 2013: DCE 1.2 released.
- 1st September, 2013: DCE 1.1 released.
- 14th May, 2013: DCE 1.0 released!
- 23rd April, 2013: nightly build, code coverage measurement, regression tests added by Jenkins CI.
- 23rd April, 2013: DCE 1.0 rc-1 released
Why use Direct Code Execution?
- If you don't want to maintain multiple implementations of a single protocol, or reimplement complicated protocols such as OSPF or BGP routing,
- If you want to debug and test your code within a controlled environment,
- If you want to create a miniature network (let's say, a model of an ISP network) in a single node,
DCE promises to help for these use cases!
How to use it?
- Quick start.
bake will take care of your DCE installation. See the Quick start guide for more detail.
- How can I use my own application in ns-3?
The first step to using your applications on DCE is recompiling your executable with special compile/link flags. A Position Independent Executable (PIE) is required to run over DCE. The detailed instructions are available in User's guide.
- What should I do if my application doesn't run on DCE?
If the issue is in your application, you can debug your code with gdb. The instructions are also available in User's guide.
- How can I extend DCE ?
DCE provides much of the POSIX API, but not a complete implementation. If your application uses unsupported system calls, socket options, or libc functions, you can extend DCE so that your applications are able to run over DCE. More information is available in the document. Patches to extend DCE for more applications are encouraged.
- How can I learn more about DCE?
All of DCE related information is listed in this page. Other detailed documents are also available.