Skip to content

Commit cdedc7a

Browse files
committed
documentation: Update tutorial references to 3.30 release
1 parent 72f34b0 commit cdedc7a

File tree

1 file changed

+25
-25
lines changed

1 file changed

+25
-25
lines changed

doc/tutorial/source/getting-started.rst

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -68,14 +68,14 @@ You may want to take this opportunity to explore the |ns3| wiki
6868
a bit, or the main web site at https://www.nsnam.org, since there is a
6969
wealth of information there.
7070

71-
As of the most recent |ns3| release (ns-3.29), the following tools
71+
As of the most recent |ns3| release (ns-3.30), the following tools
7272
are needed to get started with |ns3|:
7373

7474
============ ===========================================================
7575
Prerequisite Package/version
7676
============ ===========================================================
7777
C++ compiler ``clang++`` or ``g++`` (g++ version 4.9 or greater)
78-
Python ``python2`` version >= 2.7.10, or ``python3`` version >=3.4
78+
Python ``python2`` version >= 2.7.10 and ``python3`` version >=3.4
7979
Git any recent version (to access |ns3| from `GitLab.com <https://gitlab.com/nsnam/ns-3-dev/>`_)
8080
tar any recent version (to unpack an `ns-3 release <https://www.nsnam.org/releases/>`_)
8181
bunzip2 any recent version (to uncompress an |ns3| release)
@@ -112,22 +112,22 @@ get a copy of a release by typing the following into your Linux shell
112112
$ cd
113113
$ mkdir workspace
114114
$ cd workspace
115-
$ wget https://www.nsnam.org/release/ns-allinone-3.29.tar.bz2
116-
$ tar xjf ns-allinone-3.29.tar.bz2
115+
$ wget https://www.nsnam.org/release/ns-allinone-3.30.tar.bz2
116+
$ tar xjf ns-allinone-3.30.tar.bz2
117117

118118
Notice the use above of the ``wget`` utility, which is a command-line
119119
tool to fetch objects from the web; if you do not have this installed,
120120
you can use a browser for this step.
121121

122122
Following these steps, if you change into the directory
123-
``ns-allinone-3.29``, you should see a number of files and directories
123+
``ns-allinone-3.30``, you should see a number of files and directories
124124

125125
.. sourcecode:: text
126126

127-
$ cd ns-allinone-3.29
127+
$ cd ns-allinone-3.30
128128
$ ls
129-
bake constants.py ns-3.29 README
130-
build.py netanim-3.108 pybindgen-0.17.0.post58+ngcf00cc0 util.py
129+
bake constants.py ns-3.30 README
130+
build.py netanim-3.108 pybindgen-0.20.0 util.py
131131

132132
You are now ready to build the base |ns3| distribution and may skip ahead
133133
to the section on building |ns3|.
@@ -177,7 +177,7 @@ release number:
177177

178178
.. sourcecode:: bash
179179

180-
$ python download.py -n ns-3.29
180+
$ python download.py -n ns-3.30
181181

182182
After this step, the additional repositories of |ns3|, bake, pybindgen,
183183
and netanim will be downloaded to the ``ns-3-allinone`` directory.
@@ -204,7 +204,7 @@ In recent |ns3| releases, Bake has been included in the release
204204
tarball. The configuration file included in the released version
205205
will allow one to download any software that was current at the
206206
time of the release. That is, for example, the version of Bake that
207-
is distributed with the ``ns-3.29`` release can be used to fetch components
207+
is distributed with the ``ns-3.30`` release can be used to fetch components
208208
for that |ns3| release or earlier, but can't be used to fetch components
209209
for later releases (unless the ``bakeconf.xml`` package description file
210210
is updated).
@@ -246,10 +246,10 @@ distribution of your choice.
246246

247247
There are a few configuration targets available:
248248

249-
1. ``ns-3.29``: the module corresponding to the release; it will download
249+
1. ``ns-3.30``: the module corresponding to the release; it will download
250250
components similar to the release tarball.
251251
2. ``ns-3-dev``: a similar module but using the development code tree
252-
3. ``ns-allinone-3.29``: the module that includes other optional features
252+
3. ``ns-allinone-3.30``: the module that includes other optional features
253253
such as Click routing, Openflow for |ns3|, and the Network Simulation
254254
Cradle
255255
4. ``ns-3-allinone``: similar to the released version of the allinone
@@ -267,7 +267,7 @@ code either by inspection of the repository list or by going to the
267267
`"ns-3 Releases"
268268
<https://www.nsnam.org/releases>`_
269269
web page and clicking on the latest release link. We'll proceed in
270-
this tutorial example with ``ns-3.29``.
270+
this tutorial example with ``ns-3.30``.
271271

272272
We are now going to use the bake tool to pull down the various pieces of
273273
|ns3| you will be using. First, we'll say a word about running bake.
@@ -295,7 +295,7 @@ Step into the workspace directory and type the following into your shell:
295295

296296
.. sourcecode:: bash
297297

298-
$ ./bake.py configure -e ns-3.29
298+
$ ./bake.py configure -e ns-3.30
299299

300300
Next, we'll ask bake to check whether we have enough tools to download
301301
various components. Type:
@@ -343,9 +343,9 @@ should yield something like:
343343
>> Searching for system dependency python-dev - OK
344344
>> Searching for system dependency qt - OK
345345
>> Searching for system dependency g++ - OK
346-
>> Downloading pybindgen-0.19.0.post4+ng823d8b2 (target directory:pybindgen) - OK
346+
>> Downloading pybindgen-0.20.0 (target directory:pybindgen) - OK
347347
>> Downloading netanim-3.108 - OK
348-
>> Downloading ns-3.29 - OK
348+
>> Downloading ns-3.30 - OK
349349

350350
The above suggests that three sources have been downloaded. Check the
351351
``source`` directory now and type ``ls``; one should see:
@@ -354,7 +354,7 @@ The above suggests that three sources have been downloaded. Check the
354354

355355
$ cd source
356356
$ ls
357-
netanim-3.108 ns-3.29 pybindgen
357+
netanim-3.108 ns-3.30 pybindgen
358358

359359
You are now ready to build the |ns3| distribution.
360360

@@ -385,7 +385,7 @@ native |ns3| build system, Waf, to be introduced later in this tutorial.
385385

386386
If you downloaded
387387
using a tarball you should have a directory called something like
388-
``ns-allinone-3.29`` under your ``~/workspace`` directory.
388+
``ns-allinone-3.30`` under your ``~/workspace`` directory.
389389
Type the following:
390390

391391
.. sourcecode:: bash
@@ -404,7 +404,7 @@ script builds the various pieces you downloaded. First, the script will
404404
attempt to build the netanim animator, then the pybindgen bindings generator,
405405
and finally |ns3|. Eventually you should see the following::
406406

407-
Waf: Leaving directory '/path/to/workspace/ns-allinone-3.29/ns-3.29/build'
407+
Waf: Leaving directory '/path/to/workspace/ns-allinone-3.30/ns-3.30/build'
408408
'build' finished successfully (6m25.032s)
409409
410410
Modules built:
@@ -426,7 +426,7 @@ and finally |ns3|. Eventually you should see the following::
426426
Modules not built (see ns-3 tutorial for explanation):
427427
brite click openflow
428428

429-
Leaving directory ./ns-3.29
429+
Leaving directory ./ns-3.30
430430

431431
Regarding the portion about modules not built::
432432

@@ -453,9 +453,9 @@ and you should see something like:
453453

454454
.. sourcecode:: text
455455

456-
>> Building pybindgen-0.19.0.post4+ng823d8b2 - OK
456+
>> Building pybindgen-0.20.0 - OK
457457
>> Building netanim-3.108 - OK
458-
>> Building ns-3.29 - OK
458+
>> Building ns-3.30 - OK
459459

460460
*Hint: you can also perform both steps, download and build, by calling ``bake.py deploy``.*
461461

@@ -541,8 +541,8 @@ output that looks similar to the following::
541541
Checking for compilation flag -fvisibility=hidden support : ok
542542
Checking for compilation flag -Wno-array-bounds support : ok
543543
Checking for pybindgen location : ../pybindgen (guessed)
544-
Checking for python module 'pybindgen' : 0.19.0.post4+g823d8b2
545-
Checking for pybindgen version : 0.19.0.post4+g823d8b2
544+
Checking for python module 'pybindgen' : 0.20.0
545+
Checking for pybindgen version : 0.20.0
546546
Checking for code snippet : yes
547547
Checking for types uint64_t and unsigned long equivalence : no
548548
Checking for code snippet : no
@@ -657,7 +657,7 @@ for an already configured project:
657657
.. sourcecode:: bash
658658

659659
$ ./waf --check-profile
660-
Waf: Entering directory \`/path/to/ns-3-allinone/ns-3.29/build\'
660+
Waf: Entering directory \`/path/to/ns-3-allinone/ns-3.30/build\'
661661
Build profile: debug
662662

663663
The build.py script discussed above supports also the ``--enable-examples``

0 commit comments

Comments
 (0)