Translated for portuguese by the students of the inter-institutional doctorate program of IME-USP/UTFPR-CM.
Traduzido para o portugu<67>s pelos alunos do programa de doutorado inter institucional do Instituto de Matem<65>tica e Estat<61>stica da Universidade de S<>o Paulo --- IME-USP em parceria com a Universidade Tecnol<6F>gica Federal do Paran<61> - Campus Campo Mour<75>o --- UTFPR-CM:
* Frank Helbert (frank@ime.usp.br);
* Luiz Arthur Feitosa dos Santos (luizsan@ime.usp.br);
H<EFBFBD> v<>rios recursos importantes que um usu<73>rio do |ns3| deve conhecer. O principal est<73> em http://www.nsnam.org e fornece acesso a informa<6D><61>es b<>sicas sobre o |ns3|. A documenta<74><61>o detalhada esta dispon<6F>vel no s<>tio principal atrav<61>s do endere<72>o http://www.nsnam.org/documentation/. Nesta p<>gina, tamb<6D>m podem ser encontrados documentos relacionados a arquitetura do sistema.
There is a Wiki that complements the main |ns3| web site which you will
find at http://www.nsnam.org/wiki/. You will find user and developer
FAQs there, as well as troubleshooting guides, third-party contributed code,
papers, etc.
Tamb<EFBFBD>m existe um *Wiki* que completa o s<>tio do |ns3| e pode ser encontrado em http://www.nsnam.org/wiki/. Nesta p<>gina s<>o encontradas perguntas freq<65>entes - FAQs (do ingl<67>s, *Frequently Asked Questions*) para usu<73>rios e desenvolvedores, guias para resolu<6C><75>o de problemas, c<>digo de terceiros, artigos, etc.
..
The source code may be found and browsed at http://code.nsnam.org/.
There you will find the current development tree in the repository named
``ns-3-dev``. Past releases and experimental repositories of the core
developers may also be found there.
O c<>digo fonte tamb<6D>m pode ser encontrado e explorado em http://code.nsnam.org/. Neste encontra-se a <20>rvore de c<>digo em desenvolvimento em um reposit<69>rio chamado ``ns-3-dev``. Reposit<69>rios antigos e experimentais do n<>cleo de desenvolvimento podem ser encontrados neste s<>tio tamb<6D>m.
Mercurial
*********
..
Complex software systems need some way to manage the organization and
changes to the underlying code and documentation. There are many ways to
perform this feat, and you may have heard of some of the systems that are
currently used to do this. The Concurrent Version System (CVS) is probably
the most well known.
Sistemas complexos precisam gerenciar a organiza<7A><61>o e altera<72><61>es do c<>digo, bem como a documenta<74><61>o. Existem v<>rias maneiras de fazer isto e o leitor provavelmente j<> ouviu falar de algumas. O *Concurrent Version System (CVS)* --- em portugu<67>s, Sistema de Vers<72>es Concorrentes --- <20> provavelmente o mais conhecido.
..
The |ns3| project uses Mercurial as its source code management system.
Although you do not need to know much about Mercurial in order to complete
this tutorial, we recommend becoming familiar with Mercurial and using it
to access the source code. Mercurial has a web site at
http://www.selenic.com/mercurial/,
from which you can get binary or source releases of this Software
Configuration Management (SCM) system. Selenic (the developer of Mercurial)
O |ns3| utiliza o Mercurial para isto. Embora n<>o seja necess<73>rio conhecer muito sobre o Mercurial para entender este tutorial, recomenda-se a familiariza<7A><61>o com o uso da ferramenta para acessar o c<>digo fonte do sistema. O Mercurial tem um s<>tio em http://www.selenic.com/mercurial/, no qual pode-se baixar diretamente os execut<75>veis ou o c<>digo fonte deste sistema de *Software Configuration Management (SCM)* --- em portugu<67>s, Software de Gerenciamento de Configura<72><61>o. Selenic (o desenvolvedor do Mercurial), tamb<6D>m fornece tutoriais em http://www.selenic.com/mercurial/wiki/index.cgi/Tutorial/, e um guia r<>pido em http://www.selenic.com/mercurial/wiki/index.cgi/QuickStart/.
..
You can also find vital information about using Mercurial and |ns3|
on the main |ns3| web site.
Informa<EFBFBD><EFBFBD>es vitais de como usar o Mercurial e o |ns3| s<>o encontradas no s<>tio principal do projeto.
Waf
***
..
Once you have source code downloaded to your local system, you will need
to compile that source to produce usable programs. Just as in the case of
source code management, there are many tools available to perform this
function. Probably the most well known of these tools is ``make``. Along
with being the most well known, ``make`` is probably the most difficult to
use in a very large and highly configurable system. Because of this, many
alternatives have been developed. Recently these systems have been developed
using the Python language.
Uma vez baixado o c<>digo fonte para o seu sistema de arquivos local, ser<65> necess<73>rio compilar estes fontes para criar os execut<75>veis. Para esta tarefa existem v<>rias ferramentas dispon<6F>veis. Provavelmente a mais conhecida <20> o Make. Al<41>m de mais conhecido, tamb<6D>m deve ser o mais dif<69>cil de usar em grandes sistemas e com muitas op<6F><70>es de configura<72><61>o. Por este motivo, muitas alternativas foram desenvolvidas, utilizando principalmente a linguagem Python.
..
The build system Waf is used on the |ns3| project. It is one
of the new generation of Python-based build systems. You will not need to
understand any Python to build the existing |ns3| system, and will
only have to understand a tiny and intuitively obvious subset of Python in
order to extend the system in most cases.
O Waf <20> utilizado para gerar os bin<69>rios no projeto |ns3|. Ele faz parte da nova gera<72><61>o de sistemas de compila<6C><61>o e contru<72><75>o baseados em Python. O leitor n<>o precisa entender nada de Python para compilar o |ns3|, e ter<65> que entender um pequeno e intuitivo subconjunto da linguagem se quiser estender o sistema.
..
For those interested in the gory details of Waf, the main web site can be
found at http://code.google.com/p/waf/.
Para os interessados em mais detalhes sobre o Waf, basta acessar o s<>tio http://code.google.com/p/waf/.
.. Development Environment
Ambiente de Desenvolvimento
***************************
..
As mentioned above, scripting in |ns3| is done in C++ or Python.
As of ns-3.2, most of the |ns3| API is available in Python, but the
models are written in C++ in either case. A working
knowledge of C++ and object-oriented concepts is assumed in this document.
We will take some time to review some of the more advanced concepts or
possibly unfamiliar language features, idioms and design patterns as they
appear. We don't want this tutorial to devolve into a C++ tutorial, though,
so we do expect a basic command of the language. There are an almost
unimaginable number of sources of information on C++ available on the web or
in print.
Como mencionado anteriormente, a programa<6D><61>o no |ns3| <20> feita em C++ ou Python. A partir do ns-3.2, a maioria das APIs j<> est<73>o dispon<6F>veis em Python, mas os modelos continuam sendo escritos em C++. Considera-se que o leitor possui conhecimento b<>sico de C++ e conceitos de orienta<74><61>o a objetos neste documento. Somente ser<65>o revistos conceitos avan<61>ados, poss<73>veis caracter<65>sticas pouco utilizadas da linguagem, dialetos e padr<64>es de desenvolvimento. O objetivo n<>o <20> tornar este um tutorial de C++, embora seja necess<73>rio saber o b<>sico da linguagem. Para isto, existe um n<>mero muito grande de fontes de informa<6D><61>o na Web e em materiais impressos (livros, tutoriais, revistas, etc).
..
If you are new to C++, you may want to find a tutorial- or cookbook-based
book or web site and work through at least the basic features of the language
before proceeding. For instance, `this tutorial
<http://www.cplusplus.com/doc/tutorial/>`_.
Se voc<6F><20> inexperiente em C++, pode encontrar tutoriais, livros e s<>tios Web para obter o m<>nimo de conhecimento sobre a linguagem antes de continuar. Por exemplo, pode utilizar `este tutorial <http://www.cplusplus.com/doc/tutorial/>`_.
..
The |ns3| system uses several components of the GNU "toolchain"
for development. A
software toolchain is the set of programming tools available in the given
environment. For a quick review of what is included in the GNU toolchain see,
GNU binutils, and gdb. However, we do not use the GNU build system tools,
neither make nor autotools. We use Waf for these functions.
O |ns3| utiliza v<>rios componentes do conjunto de ferramentas GNU --- `"GNU toolchain"` --- para o desenvolvimento. Um `software toolchain`<20> um conjunto de ferramentas de programa<6D><61>o para um determinado ambiente. Para uma breve vis<69>o do que consiste o `GNU toolchain` veja http://en.wikipedia.org/wiki/GNU_toolchain. O |ns3| usa o `gcc`, `GNU binutils` e `gdb`. Por<6F>m, n<>o usa as ferramentas GNU para compilar o sistema, nem o Make e nem o Autotools. Para estas fun<75><6E>es <20> utilizado o Waf.
..
Typically an |ns3| author will work in Linux or a Linux-like
environment. For those running under Windows, there do exist environments
which simulate the Linux environment to various degrees. The |ns3|
project supports development in the Cygwin environment for
these users. See http://www.cygwin.com/
for details on downloading (MinGW is presently not officially supported,
although some of the project maintainers to work with it). Cygwin provides
many of the popular Linux system commands. It can, however, sometimes be
problematic due to the way it actually does its emulation, and sometimes
interactions with other Windows software can cause problems.
Normalmente um usu<73>rio do |ns3| ir<69> trabalhar no Linux ou um ambiente baseado nele. Para aqueles que usam Windows, existem ambientes que simulam o Linux em v<>rios n<>veis. Para estes usu<73>rios, o projeto |ns3| fornece suporte ao ambiente Cygwin. Veja o s<>tio http://www.cygwin.com/ para detalhes de como baix<69>-lo (o MinGW n<>o <20> suportado oficialmente, embora alguns mantenedores do projeto trabalhem com ele). O Cygwin fornece v<>rios comandos populares do Linux, entretanto podemos ter problemas com a emula<6C><61>o, <20>s vezes a intera<72><61>o com outros programas do Windows pode causar problemas.
..
If you do use Cygwin or MinGW; and use Logitech products, we will save you
quite a bit of heartburn right off the bat and encourage you to take a look
at the `MinGW FAQ
<http://oldwiki.mingw.org/index.php/FAQ>`_.
Se voc<6F> usa o Cygwin ou MinGW e usa produtos da Logitech, evite dores de cabe<62>a e d<> uma olhada em `MinGW FAQ <http://oldwiki.mingw.org/index.php/FAQ>`_.
..
Search for "Logitech" and read the FAQ entry, "why does make often
crash creating a sh.exe.stackdump file when I try to compile my source code."
Believe it or not, the ``Logitech Process Monitor`` insinuates itself into
every DLL in the system when it is running. It can cause your Cygwin or
MinGW DLLs to die in mysterious ways and often prevents debuggers from
running. Beware of Logitech software when using Cygwin.
Busque por "Logitech" e leia a entrada com o assunto: "why does make often crash creating a sh.exe.stackdump file when I try to compile my source code.". Acredite ou n<>o, o ``Logitech Process Monitor`` influencia todas as DLLs do sistema. Isto pode ocasionar problemas misteriosos durante a execu<63><75>o do Cygwin ou do MinGW. Muita cautela quando utilizar software da Logitech junto com o Cygwin.
..
Another alternative to Cygwin is to install a virtual machine environment
such as VMware server and install a Linux virtual machine.
Uma alternativa ao Cygwin <20> instalar um ambiente de m<>quina virtual, tal como o VMware server e criar uma m<>quina virtual Linux.
.. Socket Programming
Programando com Soquetes (Sockets)
**********************************
..
We will assume a basic facility with the Berkeley Sockets API in the examples
used in this tutorial. If you are new to sockets, we recommend reviewing the
API and some common usage cases. For a good overview of programming TCP/IP
sockets we recommend `TCP/IP Sockets in C, Donahoo and Calvert
Neste tutorial assume-se, nos exemplos utilizados, que o leitor est<73> familiarizado com as funcionalidades b<>sicas da API dos soquetes de Berkeley. Se este n<>o for o caso, recomendamos a leitura das APIs e alguns casos de uso comuns. Uma API --- do Ingl<67>s, `Application Programming Interface` --- <20> um <20> um conjunto de rotinas e padr<64>es estabelecidos por um software para a utiliza<7A><61>o das suas funcionalidades. Para uma boa vis<69>o geral sobre a programa<6D><61>o de soquetes TCP/IP sugerimos `TCP/IP Sockets in C, Donahoo and Calvert
that covers material you may need to understand if you look at the multicast
examples in the distribution.
Se o leitor entender os primeiros quatro cap<61>tulos do livro (ou para aqueles que n<>o t<>m acesso ao livro, os exemplos de cliente e servidor de eco mostrado no s<>tio anterior) estar<61> apto para compreender o tutorial. Existe tamb<6D>m um livro sobre soquetes multidifus<75>o, `Multicast Sockets, Makofske and Almeroth <http://www.elsevier.com/wps/find/bookdescription.cws_home/700736/description#description>`_. que <20> um material que cobre o necess<73>rio sobre multidifus<75>o caso o leitor se interesse.
