mii-tool: fixed warning: "initialization discards qualifiers from pointer target"
[oss-qm-packages.git] / man / pt_BR / route.8
blobc440974dca00e258a014182fd90fed0e0d0dd162
1 .TH ROUTE 8 "27 Jan 1996" "net-tools" "Manual do Programador Linux"
2 .SH NOME
3 route \- mostra / manipula a tabela de roteamento IP
4 .SH SINOPSE
5 .B route
6 .RB [ \-vnee ]
7 .TP
8 .B route 
9 .RB [ \-v ] 
10 .B add 
11 .RB [ \-net | \-host ] 
12 Alvo 
13 .RB [ netmask 
14 Nm] 
15 .RB [ gw 
16 Gw] 
17 .RB [ metric 
18 N] 
19 .RB [ mss 
20 M] 
21 .RB [ window 
22 W] 
23 .RB [ irtt 
25 .RB [ reject ]
26 .RB [ mod ]
27 .RB [ dyn ] 
28 .RB [ reinstate ] 
29 .RB [[ dev ] 
30 If]
31 .TP
32 .B route 
33 .RB [ \-v ] 
34 .B del 
35 .RB [ \-net | \-host ] 
36 Alvo 
37 .RB [ gw 
38 Gw] 
39 .RB [ netmask 
40 Nm] 
41 .RB [ metric 
42 N] 
43 .RB [[ dev ]
44 If]
45 .TP
46 .B route 
47 .RB [ \-V ] 
48 .RB [ \-\-version ]
49 .RB [ \-h ]
50 .RB [ \--help ]
51 .SH DESCRICAO
52 .B Route
53 manipula a tabela de roteamento IP do kernel. Seu principal uso é
54 configurar rotas estáticas para hosts ou redes especificadas através de
55 uma interface, após a mesma ter sido configurada com o programa 
56 .BR ifconfig (8)
59 .SH OPÇÕES
60 .TP
61 .B \-v
62 flag para detalhamento (não usada).
64 .TP
65 .B \-n
66 mostra endereços numéricos, sem tentar resolver o nomes simbólicos das
67 máquinas. Útil se você esta tentando determinar por que a rota para o seu
68 servidor de nomes sumiu.
70 .TP
71 .B \-e
72 use o formato 
73 .BR netstat (8)
74 na apresentação da tabela de roteamento.
75 .B \-ee 
76 produzira uma linha bem grande com todos os parâmetros da tabela de roteamento.
78 .TP
79 .B \-net
81 .B Alvo
82 é o endereço de uma rede (encontrado no arquivo
83 .I /etc/networks
84 pela função 
85 .BR getnetbyname (2) 
88 .TP
89 .B -host
90 é o endereço de uma máquina (descoberto com a função 
91 .BR gethostbyname (2)
94 .TP 
95 .B (nenhum) 
96 displays the kernel routing table. The layout can be changed with
97 mostra a tabela de roteamento do kernel. O layout pode ser alterado com
98 .B \-e
100 .B \-ee
104 .B del
105 remove uma rota.
107 .TP 
108 .B add 
109 adiciona uma rota.
112 .B Alvo
113 A máquina ou rede destino. Você pode fornecer endereços IP em formato
114 decimal separado por pontos ou nomes de máquinas/redes.
117 .B netmask Nm
118 modificador para especificar a mascara de rede da rota a ser adicionada.
119 Somente faz sentido para uma rota para uma rede e quanto o endereço
120 .B Alvo
121 é valido com relação a mascara especificada. Se nenhuma mascara de rede
122 for especificada, o comando
123 .B route
124 descobre-a, desta forma, para a maioria das configurações normais você não
125 precisa especificar uma mascara de rede.
128 .B gw Gw
129 Quaisquer pacotes IP para a rede/máquina destino serão roteadas através
130 do gateway/roteador especificado.
131 .B NOTA:
132 O gateway especificado deve ser alcançável antes deste comando. Isto
133 normalmente significa que você terá que configurar uma rota estática para
134 o gateway antes de emitir este comando. Se você especificar o endereço
135 de uma de suas interfaces locais, isto será usado para decidir sobre
136 qual interface deve ser usada para rotear os pacotes. Isto esta disponível
137 para manter compatibilidade com os sistemas baseados em BSD.
140 .B metric M
141 Configura o campo de métrica na tabela de roteamento, usado em daemons
142 para roteamento dinâmico.
144 .TP 
145 .B mss M
146 Especifica o Tamanho Máximo do Segmento TCP em Bytes (MSS) para conexões
147 TCP através desta rota. Isto é normalmente usado somente para otimização
148 fina de configurações de roteamento. 
150 .TP 
151 .B window W 
152 Especifica o tamanho da janela TCP para conexões TCP através desta rota.
153 Tipicamente somente usado para redes AX.25 e em drivers incapazes de
154 de tratar frames back to back.
157 .B irtt I
158 Especifica o tempo de ida e volta inicial (irtt) para conexões TCP através
159 desta rota. Tipicamente usado somente em redes AX.25. O numero é especificado
160 em milisegundos (1-12000). Se omitido o default da RFC 1122 de 300ms é usado.
163 .B reject
164 Instala uma rota de bloqueio, que forçará falha na procura por esta rota.
165 Exemplo de utilização: bloquear rotas antes do uso da rota default.
166 Isto não é firewalling.
169 .B mod, dyn, reinstate
170 Instala uma rota modificada ou dinâmica. Ambas as flags são geralmente somente
171 configuradas por um daemon de roteamento. Somente para propósitos de diagnostico.
174 .B dev If
175 Força a associação da rota com o dispositivo especificado, pois o kernel
176 de outra forma tentara determinar o dispositivo por conta própria
177 (através da checagem de rotas e especificações de dispositivos já existentes
178 e onde a rota esta adicionada).
180 If 
181 .B dev If
182 é a última opção na linha de comando, a palavra
183 .B dev
184 pode ser omitida, pois é o default. De outra forma a ordem dos outros
185 modificadores do route (metric - netmask - gw - dev) não importa.
187 .SH EXEMPLOS
189 .B route add -net 127.0.0.0
190 Adiciona a entrada para a interface loopback normal, usando mascara igual
191 a 255.0.0.0 (rede classe A, determinada a partir do endereço de destino),
192 associada ao dispositivo "lo" (assumindo que este dispositivo tenha sido
193 previamente configurado com o
194 .BR ifconfig (8)). 
196 .TP 
197 .B route add -net 192.56.76.0 netmask 255.255.255.0 dev eth0
198 Adiciona uma rota para a rede 192.56.76.x através da interface "eth0". O 
199 modificador de mascara classe C não é realmente necessário aqui por que
200 192.* é um endereço IP de classe C. A palavra "dev" pode ser omitida aqui.
203 .B route add default gw mango-gw
204 Adiciona uma rota default (que será usada se nenhuma outra rota for encontrada).
205 Todos os pacotes que usarem esta rota serão passados para a máquina "mango-gw".
206 O dispositivo que será utilizado para esta rota depende de como é possível
207 alcançar "mango-gw" - a rota estática para "mango-gw" terá que ser configurada
208 previamente.
211 .B route add ipx4 sl0
212 Adiciona uma rota para a máquina "ipx4" através da interface SLIP (assumindo
213 que "ipx4" é a máquina SLIP).
216 .B route add -net 192.57.66.0 netmask 255.255.255.0 gw ipx4
217 Este comando adiciona a rede "192.57.66.x" para ser alcançada através da
218 rota anterior através da interface SLIP.
221 .B route add -net 224.0.0.0 netmask 240.0.0.0 dev eth0
222 Isto é bem obscura, documentada para que as pessoas saibam como usá-la. 
223 Configura para que todas as rotas IP classe D (multicast) vão através da
224 interface "eth0". Esta é a linha de configuração normal a ser usada com
225 um kernel multicast.
228 .B route add 10.0.0.0 netmask 255.0.0.0 reject
229 Esta instala uma rota de rejeição para a rede privada "10.x.x.x"
232 .SH SAÍDA
233 A saída da tabela de roteamento do kernel é organizada nas seguintes colunas
235 .B Destino     
236 A rede ou máquina de destino.
238 .B Roteador
239 A máquina roteador ou '*' se nenhuma estiver configurada.
241 .B Mascara Genérica
242 A mascara para a rede destino. '255.255.255.255' para uma máquina de destino,
243 '0.0.0.0' para a rota
244 .B default
247 .B Flags 
248 Os flags possíveis são
250 .B U
251 (rota esta
252 .BR Up )
254 .B H
255 (alvo é uma
256 .BR máquina )
258 .B G
259 (use
260 .BR roteador )
262 .B R
263 .RB ( reinstate
264 rota para roteamento dinâmico)
266 .B D
267 Instalada
268 .RB ( Dinamicamente
269 por um daemon ou por redirecionamento)
271 .B M
272 .RB ( Modificada
273 por daemon de roteamento ou redirecionamento)
275 .B !
276 Rota
277 .RB ( rejeitada
280 .B Metric 
281 A 'distância' até o alvo (geralmente contada em hops). Não é utilizada pelos
282 kernels recentes, somente daemons de roteamento podem usa-la.
284 .B Ref    
285 Numero de referências a esta rota. Não usado no kernel do Linux, sempre 0.
287 .B Uso
288 Contagem de procuras por esta rota. Nos kernels recentes estes números são
289 bem baixos, pois os sockets tem seu próprio cache e não precisam procurar
290 por rotas.
292 .B Iface
293 Interface através da qual os pacotes IP serão enviados.
295 .B MSS 
296 Tamanho máximo de segmento default para conexões TCP através desta rota.
298 .B Window  
299 Tamanho de janela default para conexões TCP através desta rota.
301 .B irtt
302 RTT (Tempo de Ida e Volta) Inicial. O kernel usa isto para inferir os melhores
303 parâmetros do protocolo TCP sem esperar por respostas (possivelmente lentas).
305 .SH ARQUIVOS
306 .I /proc/net/route
308 .I /etc/networks
310 .I /etc/hosts
312 .I /etc/init.d/network
314 .SH VEJA TAMBÉM
315 .I ifconfig(8), netstat(8), arp(8)
317 .SH HISTÓRICO
318 .B Route
319 para o linux foi originalmente escrito por Fred N. van Kempen,
320 <waltje@uwalt.nl.mugnet.org> e depois modificado por Johannes Stille e
321 Linus Torvalds para a versão pl15. Alan Cox adicionou as opções para
322 mss e window no kernel 1.1.22. O suporte a irtt (compartilhado com o
323 netstat) foi feito por Bernd Eckenfels.
324 .SH TRADUÇÃO
325 Arnaldo Carvalho de Melo <acme@conectiva.com.br> - 13/04/1998
326 .SH BUGS
327 nenhum :)