Official NixOS Wiki

Network Simulator - ns-3: Difference between revisions

← Older edit
VisualWikitext
Klinger (talk | contribs)
trusted
904 edits
Artturin (talk | contribs)
trusted
23 edits
Improve nix expr for cross compilation combatibility, builds without clang, make the makefile work.
 
Line 3: Line 3:
== Developing with ns-3 ==
== Developing with ns-3 ==
ns-3 heavily relies on way for running simulations (examples, tutorials, etc.), but we can start developing using a simple Makefile and a shell.nix.
ns-3 heavily relies on way for running simulations (examples, tutorials, etc.), but we can start developing using a simple Makefile and a shell.nix.
We will use [https://www.nsnam.org/doxygen/hello-simulator_8cc_source.html hello-simulator.cc] for this example.
We will use [https://www.nsnam.org/docs/release/3.43/doxygen/d4/d87/hello-simulator_8cc_source.html hello-simulator.cc] for this example.


First create a <code>shell.nix</code>, with the requirements to compile our simulation.
First create a <code>shell.nix</code>, with the requirements to compile our simulation.


<syntaxhighlight lang="nix">
<syntaxhighlight lang="nix">
with import <nixpkgs> {};
{
 
  pkgs ? import <nixpkgs> { },
mkShell {
}:
   nativeBuildInputs = [
pkgs.callPackage (
     llvmPackages_latest.clang
   {
     pkg-config
     mkShell,
   ];
     pkg-config,
  buildInputs = [ ns-3 ];
    ns-3,
}
  }:
   mkShell {
    strictDeps = true;
    nativeBuildInputs = [ pkg-config ];
    buildInputs = [ ns-3 ];
  }
) { }
</syntaxhighlight>
</syntaxhighlight>


Then we can create our <code>Makefile</code>, do note the LIBS argument, which is the modules required (not all are build by default, might have to override some settings in ns-3).
Then we can create our <code>Makefile</code>, do note the LIBS argument, which is the modules required (not all are build by default, might have to override some settings in ns-3).


<syntaxhighlight lang=Make>
<syntaxhighlight lang="make">
# the compiler: gcc for C program, define as g++ for C++
CC ?= gcc
CC = clang++
CXX ?= g++
PKG_CONFIG ?= pkg-config


DEBUG=-DNS3_LOG_ENABLE
DEBUG=-DNS3_LOG_ENABLE


LIBS = libns3-dev-core-debug
LIBS = ns3-core


# compiler flags:
# compiler flags:
#  -g    adds debugging information to the executable file
#  -g    adds debugging information to the executable file
#  -Wall turns on most, but not all, compiler warnings
#  -Wall turns on most, but not all, compiler warnings
CFLAGS  = -g -Wall -Wextra $(shell pkg-config --cflags $(LIBS))
CFLAGS  = -g -Wall -Wextra $(shell $(PKG_CONFIG) --cflags $(LIBS))
LDFLAGS=$(shell pkg-config --libs $(LIBS))
LDFLAGS=$(shell $(PKG_CONFIG) --libs $(LIBS))


# the build target executable:
# the build target executable:
Line 41: Line 48:


$(TARGET): $(TARGET).cc
$(TARGET): $(TARGET).cc
$(CC) $(DEBUG) $(CFLAGS) $(LDFLAGS) -o $(TARGET) $(TARGET).cc
$(CXX) $(DEBUG) $(CFLAGS) $(LDFLAGS) -o $(TARGET) $(TARGET).cc


clean:
clean:
Retrieved from "https://wiki.nixos.org/wiki/Network_Simulator_-_ns-3"