author | raj@raj-desktop |
Fri, 17 Oct 2008 10:45:44 -0400 | |
changeset 3759 | ca7267da6c4e |
parent 3663 | 457fea62fbdd |
child 3760 | cfc585a0ea16 |
permissions | -rw-r--r-- |
3759 | 1 |
|
657
be551a3b07c6
minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents:
655
diff
changeset
|
2 |
The Network Simulator, Version 3 |
be551a3b07c6
minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents:
655
diff
changeset
|
3 |
-------------------------------- |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
4 |
|
657
be551a3b07c6
minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents:
655
diff
changeset
|
5 |
Table of Contents: |
be551a3b07c6
minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents:
655
diff
changeset
|
6 |
------------------ |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
7 |
|
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
8 |
1) An Open Source project |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
9 |
2) An overview of the ns-3 project |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
10 |
3) Building ns-3 |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
11 |
4) Running ns-3 |
641
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
12 |
5) Getting access to the ns-3 documentation |
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
13 |
6) Working with the development version of ns-3 |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
14 |
|
421 | 15 |
|
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
16 |
1) An Open Source project |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
17 |
------------------------- |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
18 |
|
657
be551a3b07c6
minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents:
655
diff
changeset
|
19 |
ns-3 is an Open Source project. We intend to make this |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
20 |
project a successful collaborative project: we hope that |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
21 |
the missing pieces of the models we have not yet implemented |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
22 |
will be contributed by the community in an open collaboration |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
23 |
process. |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
24 |
|
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
25 |
Contributing to the ns-3 project is still a very informal |
783
abde897006fd
fix small typos
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
697
diff
changeset
|
26 |
process because that process depends heavily on the background |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
27 |
of the people involved, the amount of time they can invest |
657
be551a3b07c6
minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents:
655
diff
changeset
|
28 |
and the type of model they want to work on. |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
29 |
|
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
30 |
Despite this lack of a formal process, there are a number of |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
31 |
steps which naturally stem from the open-source roots of the |
657
be551a3b07c6
minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents:
655
diff
changeset
|
32 |
project. These steps are described in doc/contributing.txt |
263
618a886c7130
Test of commit access with Mercurial cheat sheet
Tom Henderson <tomh@tomh.org>
parents:
217
diff
changeset
|
33 |
|
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
34 |
2) An overview of the ns-3 project |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
35 |
---------------------------------- |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
36 |
|
783
abde897006fd
fix small typos
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
697
diff
changeset
|
37 |
This package contains the latest version of ns-3 which aims |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
38 |
at being a replacement for ns-2. Currently, ns-3 provides a |
2891 | 39 |
number of simple network simulation models: |
40 |
- an ipv4 and tcp and udp stack |
|
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
41 |
- arp support at the bottom of the stack |
2891 | 42 |
- static global and OLSR unicast routing |
43 |
- point-to-point, CSMA, and Wifi links |
|
44 |
- mobility |
|
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
45 |
- OnOff traffic generator |
3
bb3d6a584b09
This is an important bugfix for Bilbo The Hobbit
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
1
diff
changeset
|
46 |
|
657
be551a3b07c6
minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents:
655
diff
changeset
|
47 |
Our focus to date has been on getting an overall software |
be551a3b07c6
minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents:
655
diff
changeset
|
48 |
framework in place. The framework is there to make adding |
be551a3b07c6
minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents:
655
diff
changeset
|
49 |
new models as simple as possible: |
2891 | 50 |
|
51 |
- an extensive callback-based tracing system |
|
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
52 |
|
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
53 |
- simple file trace serialization support is included |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
54 |
to both text and pcap files. |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
55 |
|
2891 | 56 |
- an attribute system for configuring parameters in the |
57 |
models |
|
58 |
||
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
59 |
- adding new MAC-level models simply requires subclassing |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
60 |
the pair of classes NetDevice and Channel. |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
61 |
|
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
62 |
- adding new traffic generation algorithms is also very |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
63 |
simple through the Application and the Socket classes. |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
64 |
|
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
65 |
3) Building ns-3 |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
66 |
---------------- |
7 | 67 |
|
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
68 |
The code for the framework and the default models provided |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
69 |
by ns-3 is built as a set of libraries. User simulations |
657
be551a3b07c6
minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents:
655
diff
changeset
|
70 |
are expected to be written as simple programs that make |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
71 |
use of these ns-3 libraries. |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
72 |
|
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
73 |
To build the set of default libraries and the example |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
74 |
programs included in this package, you need to use the |
3653
b6724ca12da9
update build matrix
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
2891
diff
changeset
|
75 |
tool 'waf'. Detailed information on how use waf is |
b6724ca12da9
update build matrix
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
2891
diff
changeset
|
76 |
included in the file doc/build.txt |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
77 |
|
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
78 |
However, the real quick and dirty way to get started is to |
956
cf63e1cc64be
Update README to mention WAF instead of SCons.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents:
783
diff
changeset
|
79 |
type the command "./waf" the the directory which contains |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
80 |
this README file. The files built will be copied in the |
956
cf63e1cc64be
Update README to mention WAF instead of SCons.
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents:
783
diff
changeset
|
81 |
build/debug or build/optimized. |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
82 |
|
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
83 |
The current codebase is expected to build and run on the |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
84 |
following set of platforms: |
2841
eed8d933cdf0
update platform build matrix and example program.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
1786
diff
changeset
|
85 |
- linux x86 gcc 4.2, 4.1, and, 3.4.6. |
eed8d933cdf0
update platform build matrix and example program.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
1786
diff
changeset
|
86 |
- linux x86_64 gcc 4.1.3, 4.2.1, 3.4.6 |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
87 |
- MacOS X ppc and x86 |
3653
b6724ca12da9
update build matrix
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
2891
diff
changeset
|
88 |
- mingw gcc 3.4.5 (debug only) |
2841
eed8d933cdf0
update platform build matrix and example program.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
1786
diff
changeset
|
89 |
- cygwin gcc 3.4.4 (debug only) |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
90 |
|
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
91 |
The current codebase is expected to fail to build on |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
92 |
the following platforms: |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
93 |
- gcc 3.3 and earlier |
2841
eed8d933cdf0
update platform build matrix and example program.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
1786
diff
changeset
|
94 |
- optimized builds on gcc 3.4.4 and 3.4.5 |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
95 |
- optimized builds on linux x86 gcc 4.0 |
3654
cf7200b67f16
add msvc to set of platforms known to not work
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
3653
diff
changeset
|
96 |
- msvc |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
97 |
|
3653
b6724ca12da9
update build matrix
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
2891
diff
changeset
|
98 |
The following optional features are known to not work on |
b6724ca12da9
update build matrix
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
2891
diff
changeset
|
99 |
these platforms: |
3663
457fea62fbdd
Problem of Python bindings in MinGW has been fixed
Gustavo J. A. M. Carneiro <gjc@inescporto.pt>
parents:
3654
diff
changeset
|
100 |
- mingw: nsc, realtime scheduler |
3653
b6724ca12da9
update build matrix
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
2891
diff
changeset
|
101 |
- cygwin: python bindings, nsc |
b6724ca12da9
update build matrix
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
2891
diff
changeset
|
102 |
|
b6724ca12da9
update build matrix
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
2891
diff
changeset
|
103 |
Other platforms may or may not work: we welcome patches to |
b6724ca12da9
update build matrix
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
2891
diff
changeset
|
104 |
improve the portability of the code to these other platforms. |
217 | 105 |
|
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
106 |
4) Running ns-3 |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
107 |
--------------- |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
108 |
|
657
be551a3b07c6
minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents:
655
diff
changeset
|
109 |
On recent Linux systems, once you have built ns-3, it |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
110 |
should be easy to run the sample programs with the |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
111 |
following command: |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
112 |
|
2841
eed8d933cdf0
update platform build matrix and example program.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
1786
diff
changeset
|
113 |
./waf --run simple-global-routing |
263
618a886c7130
Test of commit access with Mercurial cheat sheet
Tom Henderson <tomh@tomh.org>
parents:
217
diff
changeset
|
114 |
|
2841
eed8d933cdf0
update platform build matrix and example program.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
1786
diff
changeset
|
115 |
That program should generate a simple-global-routing.tr text |
eed8d933cdf0
update platform build matrix and example program.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
1786
diff
changeset
|
116 |
trace file and a set of simple-global-routing-xx-xx.pcap binary |
eed8d933cdf0
update platform build matrix and example program.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
1786
diff
changeset
|
117 |
pcap trace files, which can be read by tcpdump -tt -r filename.pcap |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
118 |
|
641
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
119 |
5) Getting access to the ns-3 documentation |
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
120 |
------------------------------------------- |
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
121 |
|
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
122 |
Once you have verified that your build of ns-3 works by running |
1786 | 123 |
the simple-point-to-point example as outlined in 4) above, it is |
641
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
124 |
quite likely that you will want to get started on reading |
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
125 |
some ns-3 documentation. |
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
126 |
|
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
127 |
All of that documentation should always be available from |
655
f2ee52034178
update the documentation section
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
643
diff
changeset
|
128 |
the ns-3 website: http:://www.nsnam.org/ but we |
f2ee52034178
update the documentation section
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
643
diff
changeset
|
129 |
include some of it in this release for ease of use. |
641
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
130 |
|
655
f2ee52034178
update the documentation section
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
643
diff
changeset
|
131 |
This documentation includes: |
641
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
132 |
|
2891 | 133 |
- a tutorial |
641
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
134 |
|
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
135 |
- a wiki for user-contributed tips: http://www.nsnam.org/wiki/ |
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
136 |
|
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
137 |
- an API documentation generated using doxygen: this is |
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
138 |
a reference manual, most likely not very well suited |
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
139 |
as introductory text: |
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
140 |
http://www.nsnam.org/doxygen/index.html |
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
141 |
|
c55da3a2f496
add reference to architecture document
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
635
diff
changeset
|
142 |
6) Working with the development version of ns-3 |
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
143 |
----------------------------------------------- |
263
618a886c7130
Test of commit access with Mercurial cheat sheet
Tom Henderson <tomh@tomh.org>
parents:
217
diff
changeset
|
144 |
|
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
145 |
If you want to download and use the development version |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
146 |
of ns-3, you need to use the tool 'mercurial'. A quick and |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
147 |
dirty cheat sheet is included in doc/mercurial.txt but |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
148 |
reading through the mercurial tutorials included on the |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
149 |
mercurial website is usually a good idea if you are not |
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
150 |
familiar with it. |
314 | 151 |
|
635
71b92dfe5f55
write README, contributing.txt, reorganize the other documentation files
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
421
diff
changeset
|
152 |
If you have successfully installed mercurial, you can get |
697 | 153 |
a copy of the development version with the following command: |
657
be551a3b07c6
minor changes due to documentation review
Tom Henderson <tomh@tomh.org>
parents:
655
diff
changeset
|
154 |
"hg clone http://code.nsnam.org/ns-3-dev" |