Ns2 Manual

  • View
    76

  • Download
    6

Embed Size (px)

Text of Ns2 Manual

The ns Manual (formerly ns Notes and Documentation)1The VINT Project A Collaboration between researchers at UC Berkeley, LBL, USC/ISI, and Xerox PARC. Kevin Fall kfall@ee.lbl.gov , Editor Kannan Varadhan kannan@catarina.usc.edu , Editor

January 5, 2009

ns c is LBNLs Network Simulator [24]. The simulator is written in C++; it uses OTcl as a command and conguration interface. ns v2 has three substantial changes from ns v1: (1) the more complex objects in ns v1 have been decomposed into simpler components for greater exibility and composability; (2) the conguration interface is now OTcl, an object oriented version of Tcl; and (3) the interface code to the OTcl interpreter is separate from the main simulator. Ns documentation is available in html, Postscript, and PDF formats. See http://www.isi.edu/nsnam/ns/ns-documentation. html for pointers to these.

1 The VINT project is a joint effort by people from UC Berkeley, USC/ISI, LBL, and Xerox PARC. The project is supported by the Defense Advanced Research Projects Agency (DARPA) at LBL under DARPA grant DABT63-96-C-0105, at USC/ISI under DARPA grant ABT63-96-C-0054, at Xerox PARC under DARPA grant DABT63-96-C-0105. Any opinions, ndings, and conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reect the views of the DARPA.

Contents1 2 Introduction Undocumented Facilities 2 6

I3

Interface to the InterpreterOTcl Linkage 3.1 Concept Overview . . . . . . . . . . . . . . . . . . . . 3.2 Code Overview . . . . . . . . . . . . . . . . . . . . . . 3.3 Class Tcl . . . . . . . . . . . . . . . . . . . . . . . . . 3.3.1 Obtain a Reference to the class Tcl instance . . . 3.3.2 Invoking OTcl Procedures . . . . . . . . . . . . 3.3.3 Passing Results to/from the Interpreter . . . . . . 3.3.4 Error Reporting and Exit . . . . . . . . . . . . . 3.3.5 Hash Functions within the Interpreter . . . . . . 3.3.6 Other Operations on the Interpreter . . . . . . . 3.4 Class TclObject . . . . . . . . . . . . . . . . . . . . . . 3.4.1 Creating and Destroying TclObjects . . . . . . . 3.4.2 Variable Bindings . . . . . . . . . . . . . . . . . 3.4.3 Variable Tracing . . . . . . . . . . . . . . . . . 3.4.4 commandMethods: Denition and Invocation . 3.5 Class TclClass . . . . . . . . . . . . . . . . . . . . . . . 3.5.1 How to Bind Static C++ Class Member Variables 3.6 Class TclCommand . . . . . . . . . . . . . . . . . . . . 3.7 Class EmbeddedTcl . . . . . . . . . . . . . . . . . . . . 3.8 Class InstVar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

89 9 10 10 11 11 11 12 12 13 13 14 15 17 18 20 21 23 24 25

II4

Simulator BasicsThe Class Simulator 4.1 Simulator Initialization . . . . . . . . . . . . . . . 4.2 Schedulers and Events . . . . . . . . . . . . . . . 4.2.1 The List Scheduler . . . . . . . . . . . . . 4.2.2 the heap scheduler . . . . . . . . . . . . . 4.2.3 The Calendar Queue Scheduler . . . . . . 4.2.4 The Real-Time Scheduler . . . . . . . . . 4.2.5 Precision of the scheduler clock used in ns 4.3 Other Methods . . . . . . . . . . . . . . . . . . . 4.4 Commands at a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2728 28 28 29 30 30 30 31 31 32

1

5

Nodes and Packet Forwarding 5.1 Node Basics . . . . . . . . . . . . . . . . . 5.2 Node Methods: Conguring the Node . . . 5.3 Node Conguration Interface . . . . . . . . 5.4 The Classier . . . . . . . . . . . . . . . . 5.4.1 Address Classiers . . . . . . . . . 5.4.2 Multicast Classiers . . . . . . . . 5.4.3 MultiPath Classier . . . . . . . . 5.4.4 Hash Classier . . . . . . . . . . . 5.4.5 Replicator . . . . . . . . . . . . . . 5.5 Routing Module and Classier Organization 5.5.1 Routing Module . . . . . . . . . . 5.5.2 Node Interface . . . . . . . . . . . 5.6 Commands at a glance . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

. . . . . . . . . . . . .

35 35 37 39 40 43 44 45 45 47 48 48 50 51 53 54 56 56 57 60 60 61 62 63 64 68 68 68 70 71 71 72 75 75 76 77 77 78 78 78 79 80 82 86 86 86 87 88 88 88

6

Links: Simple Links 6.1 Instance Procedures for Links and SimpleLinks 6.2 Connectors . . . . . . . . . . . . . . . . . . . 6.3 Object hierarchy . . . . . . . . . . . . . . . . . 6.4 Commands at a glance . . . . . . . . . . . . . Queue Management and Packet Scheduling 7.1 The C++ Queue Class . . . . . . . . . . 7.1.1 Queue blocking . . . . . . . . . 7.1.2 PacketQueue Class . . . . . . . 7.2 Example: Drop Tail . . . . . . . . . . . 7.3 Different types of Queue objects . . . . 7.4 Commands at a glance . . . . . . . . . 7.5 Queue/JoBS . . . . . . . . . . . . . . . 7.5.1 The JoBS algorithm . . . . . . 7.5.2 Conguration . . . . . . . . . . 7.5.3 Tracing . . . . . . . . . . . . . 7.5.4 Variables . . . . . . . . . . . . 7.5.5 Commands at a glance . . . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

7

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

. . . . . . . . . . . .

8

Delays and Links 8.1 The LinkDelay Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8.2 Commands at a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Differentiated Services Module in ns 9.1 Overview . . . . . . . . . . . . . . . . 9.2 Implementation . . . . . . . . . . . . . 9.2.1 RED queue in DiffServ module 9.2.2 Edge and core routers . . . . . . 9.2.3 Policy . . . . . . . . . . . . . . 9.3 Conguration . . . . . . . . . . . . . . 9.4 Commands at a glance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .