ifup - ativar uma interface de rede
ifdown - desativar uma interface de rede
ifquery - analisar a configuração da interface
SINTAXE
ifup [-nv] [--no-act] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS]
-a|IFACE...
ifup -h|--help
ifup -V|--version
ifdown [-nv] [--no-act] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS]
-a|IFACE...
ifquery [-nv] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS] IFACE...
ifquery -l|--list [-nv] [--verbose] [-i FILE|--interfaces=FILE] [--state-dir=DIR] [--allow CLASS]
[-a|IFACE...]
ifquery --state [--state-dir=DIR] [--allow CLASS] [-a|IFACE...]
DESCRIÇÃO
Os comandos ifup e ifdown podem ser usados para configurar (ou, respectivamente, desconfigurar) interfaces de rede com base nas definições de interface no arquivo /etc/network/interfaces. O comando ifquery pode ser usado para analisar as configurações das interfaces.
OPÇÕES
Um resumo das opções está incluído abaixo.
-a, --all
Se fornecido para ifup, afeta todas as interfaces marcadas como automáticas. As interfaces são ativadas na ordem em que são definidas em /etc/network/interfaces. Combinado com --allow, atua em todas as interfaces de uma classe especificada. Se fornecido para ifdown, afeta todas as interfaces definidas. As interfaces são desativadas na ordem em que estão atualmente listadas no arquivo de estado. Apenas as interfaces definidas em /etc/network/interfaces serão desativadas.
-f, --force
Força a configuração ou desconfiguração da interface.
--ignore-errors
Se algum dos comandos ou scripts falhar, continue.
-h, --help
Mostra um resumo das opções.
--allow=CLASS
Permite apenas que as interfaces listadas em uma linha allow-CLASS em /etc/network/interfaces sejam processadas.
-i FILE, --interfaces=FILE
Lê as definições de interface do FILE em vez de /etc/network/interfaces.
--state-dir=DIR
Mantém o estado da interface em DIR em vez de em /run/network.
-X PATTERN, --exclude=PATTERN
Exclui interfaces da lista de interfaces a serem processadas pelo PATTERN. O PATTERN usa uma sintaxe de glob padrão do shell. Se curingas do shell não forem usados, ele deve corresponder ao nome exato da interface. Esta opção pode ser especificada várias vezes, resultando em mais de um padrão sendo excluído.
-o OPTION=VALUE
Define OPTION para VALUE como se estivesse em /etc/network/interfaces.
-n, --no-act
Não configure nenhuma interface ou execute nenhum dos comandos "up" ou "down".
--no-mappings
Não execute nenhum mapeamento. Consulte interfaces(5) para obter mais informações sobre o recurso de mapeamento.
--no-scripts
Não execute nenhum script em /etc/network/if-*.d/
--no-loopback
Desabilita o tratamento especial da interface de loopback. Por padrão, a interface de loopback (lo no Linux) é predefinida internamente como uma interface automática, portanto, ela é ativada em ifup -a automaticamente. No caso de o dispositivo de loopback ser redefinido pelo usuário, a interface é configurada apenas uma vez. Se, no entanto, outra interface também for definida como loopback, ela será configurada como de costume. Especificar esta opção desabilita este comportamento, para que a interface de loopback não seja configurada automaticamente.
-V, --version
Mostra informações de direitos autorais e versão.
-v, --verbose
Mostra os comandos conforme são executados.
-l, --list
Para ifquery, liste todas as interfaces que correspondem à classe especificada. Se nenhuma classe for especificada, imprime todas as interfaces listadas como automáticas.
--state
Para ifquery, despeje o estado das interfaces. Quando nenhuma interface for especificada, liste todas as interfaces ativadas juntamente com as interfaces lógicas atribuídas a elas e saia com um código de status indicando sucesso. Se uma ou mais interfaces forem especificadas, exiba o estado dessas interfaces apenas; um código de sucesso é retornado se todas as interfaces fornecidas como argumentos estiverem ativadas. Caso contrário, 0 é retornado.
EXEMPLOS
ifup -a
Ativa todas as interfaces definidas com a palavra-chave "auto" em /etc/network/interfaces
ifup eth0
Ativa a interface eth0
ifup eth0=home
Ativa a interface eth0 como interface lógica "home"
ifdown -a
Desativa todas as interfaces que estão atualmente ativas.
ifquery -l
Imprime os nomes de todas as interfaces especificadas com a palavra-chave "auto".
ifquery -l --allow=hotplug
Imprime os nomes de todas as interfaces especificadas com a palavra-chave "allow-hotplug".
ifquery eth0
Exibe as opções da interface conforme especificadas na configuração ifupdown. Cada par chave-valor é impresso em uma linha separada, usando ": " como separador.
NOTAS
ifup, ifdown e ifquery são, na verdade, o mesmo programa chamado por nomes diferentes.
O programa não configura interfaces de rede diretamente; ele executa utilitários de baixo nível, como ip, para realizar o trabalho.
Quando invocado, ifdown verifica se ifup ainda está em execução. Nesse caso, SIGTERM é enviado para ifup.
Durante a desconfiguração da interface, ifdown ignora erros da mesma forma que se --ignore-errors tivesse sido especificado.
ARQUIVOS
/etc/network/interfaces
definições de interfaces de rede. Consulte interfaces(5) para obter mais informações.
/run/network/ifstate
estado atual das interfaces de rede
CONCORRÊNCIA
Ifupdown usa bloqueio por interface para garantir que chamadas simultâneas de ifup e ifdown para a mesma interface sejam executadas em série. No entanto, chamadas para interfaces diferentes poderão ser executadas em paralelo.
STATUS DE SAÍDA
Para ifup e ifdown, o status de saída será 0 se todas as interfaces especificadas tiverem sido (des)configuradas com sucesso, 1 se houver algum erro. O resultado desses comandos é idempotente; executar ifup em uma interface que já está ativa resultará em um status de saída de 0 e, da mesma forma, executar ifdown em uma interface que não está ativa também resultará em um status de saída de 0.
ifquery normalmente retorna com status de saída 0 se uma interface com uma estrofe "iface" correspondente existir, 1
se não houver estrofe correspondente. ifquery --state também retornará com status de saída 1 se a interface especificada for conhecida, mas não estiver ativa.
BUGS/LIMITAÇÕES CONHECIDAS
O programa mantém registros de se as interfaces de rede estão ativas ou inativas. Em circunstâncias excepcionais, esses registros podem se tornar inconsistentes com os estados reais das interfaces. Por exemplo, uma interface que foi ativada usando ifup e posteriormente desconfigurada usando ifconfig
ainda será registrada como ativa. Para corrigir isso, você pode usar a opção --force para forçar ifup ou ifdown a
executar comandos de configuração ou desconfiguração, independentemente do que considera ser o estado atual da
interface.
O arquivo /run/network/ifstate deve ser gravável para que ifup ou ifdown funcionem corretamente. Se esse local não for gravável (por exemplo, porque o sistema de arquivos raiz está montado em modo somente leitura para
recuperação do sistema), então /run/network/ifstate deve ser transformado em um link simbólico para um local gravável. Se
isso não for possível, você pode usar a opção --force para executar comandos de configuração ou
desconfiguração sem atualizar o arquivo.
Observe que o programa não é executado automaticamente: ifup sozinho não ativa interfaces que aparecem como resultado da instalação de hardware, e ifdown sozinho não desativa interfaces
que desaparecem como resultado da remoção de hardware. Para automatizar a configuração de redes
interfaces, você precisa instalar outros pacotes, como udev(7) ou ifplugd(8).
AUTORES
O conjunto de ferramentas ifupdown foi criado por Anthony Towns <_>, atualmente mantido por
Santiago Ruano Rincón <_> e Josue Ortega <_>.
Muitos outros ajudaram a desenvolver ifupdown ao longo do tempo, veja /usr/share/doc/ifupdown/changelog.Debian.gz para obter um histórico completo.