ifup: activa una interfaz de red
ifdown: desactiva una interfaz de red
ifquery: analiza la configuración de la interfaz
SINOPSIS
ifup [-nv] [--no-act] [--verbose] [-i ARCHIVO|--interfaces=ARCHIVO] [--state-dir=DIR] [--allow CLASE]
-a|INTERFAZ...
ifup -h|--help
ifup -V|--version
ifdown [-nv] [--no-act] [--verbose] [-i ARCHIVO|--interfaces=ARCHIVO] [--state-dir=DIR] [--allow CLASE]
-a|INTERFAZ...
ifquery [-nv] [--verbose] [-i ARCHIVO|--interfaces=ARCHIVO] [--state-dir=DIR] [--allow CLASE] INTERFAZ...
ifquery -l|--list [-nv] [--verbose] [-i ARCHIVO|--interfaces=ARCHIVO] [--state-dir=DIR] [--allow CLASE]
[-a|INTERFAZ...]
ifquery --state [--state-dir=DIR] [--allow CLASE] [-a|INTERFAZ...]
DESCRIPCIÓN
Los comandos ifup e ifdown se pueden utilizar para configurar (o, respectivamente, reconfigurar) interfaces de red basándose en las definiciones de las interfaces en el archivo /etc/network/interfaces. El comando ifquery se puede utilizar para analizar la configuración de las interfaces.
OPCIONES
A continuación, se incluye un resumen de las opciones.
-a, --all
Si se proporciona a ifup, afecta a todas las interfaces marcadas como automáticas. Las interfaces se activan en el orden en que se definen en /etc/network/interfaces. Combinado con --allow, actúa sobre todas las interfaces de una clase especificada. Si se proporciona a ifdown, afecta a todas las interfaces definidas. Las interfaces se desactivan en el orden en que se enumeran actualmente en el archivo de estado. Solo se desactivarán las interfaces definidas en /etc/network/interfaces.
-f, --force
Fuerza la configuración o reconfiguración de la interfaz.
--ignore-errors
Si alguno de los comandos o scripts falla, continúa.
-h, --help
Muestra un resumen de las opciones.
--allow=CLASE
Solo permite que se actúe sobre las interfaces que figuran en una línea allow-CLASE en /etc/network/interfaces.
-i ARCHIVO, --interfaces=ARCHIVO
Lee las definiciones de la interfaz desde ARCHIVO en lugar de desde /etc/network/interfaces.
--state-dir=DIR
Mantiene el estado de la interfaz en DIR en lugar de en /run/network.
-X PATRÓN, --exclude=PATRÓN
Excluye las interfaces de la lista de interfaces sobre las que se va a operar mediante el PATRÓN. El PATRÓN utiliza una sintaxis de comodín de shell estándar. Si no se utilizan comodines de shell, debe coincidir con el nombre exacto de la interfaz. Esta opción se puede especificar varias veces, lo que da como resultado que se excluyan más de un patrón.
-o OPCIÓN=VALOR
Establece OPCIÓN en VALOR como si estuviera en /etc/network/interfaces.
-n, --no-act
No configure ninguna interfaz ni ejecute ningún comando "up" o "down".
--no-mappings
No ejecute ningún mapeo. Consulte interfaces(5) para obtener más información sobre la función de mapeo.
--no-scripts
No ejecute ningún script en /etc/network/if-*.d/
--no-loopback
Deshabilita el manejo especial de la interfaz de bucle. De forma predeterminada, la interfaz de bucle (lo en Linux) se define internamente como una interfaz automática, por lo que se activa automáticamente en ifup -a. En el caso de que el dispositivo de bucle sea redefinido por el usuario, la interfaz se configura solo una vez. Sin embargo, si otra interfaz también se define como bucle, se configura como de costumbre. Especificar esta opción deshabilita este comportamiento, por lo que la interfaz de bucle no se configurará automáticamente.
-V, --version
Muestra la información de copyright y la versión.
-v, --verbose
Muestra los comandos a medida que se ejecutan.
-l, --list
Para ifquery, enumera todas las interfaces que coincidan con la clase especificada. Si no se especifica ninguna clase, imprime todas las interfaces enumeradas como automáticas.
--state
Para ifquery, muestra el estado de las interfaces. Cuando no se especifican interfaces, enumera todas las interfaces que se activaron juntas con las interfaces lógicas asignadas a ellas y sale con un código de estado que indica éxito. Si se especifica una o más interfaces, muestra el estado de solo estas interfaces; se devuelve un código de éxito si todas las interfaces dadas como argumentos están activadas. De lo contrario, se devuelve 0.
EJEMPLOS
ifup -a
Activa todas las interfaces definidas con la palabra clave "auto" en /etc/network/interfaces
ifup eth0
Activa la interfaz eth0
ifup eth0=home
Activa la interfaz eth0 como interfaz lógica "home"
ifdown -a
Desactiva todas las interfaces que están actualmente activas.
ifquery -l
Imprime los nombres de todas las interfaces especificadas con la palabra clave "auto".
ifquery -l --allow=hotplug
Imprime los nombres de todas las interfaces especificadas con la palabra clave "allow-hotplug".
ifquery eth0
Muestra las opciones de la interfaz según lo especificado en la configuración de ifupdown. Cada par clave-valor se imprime en una línea individual utilizando ": " como separador.
NOTAS
ifup, ifdown e ifquery son en realidad el mismo programa al que se llama con diferentes nombres.
El programa no configura las interfaces de red directamente; ejecuta utilidades de bajo nivel como ip para hacer su trabajo.
Cuando se invoca, ifdown comprueba si ifup sigue en ejecución. En ese caso, se envía una señal SIGTERM a ifup.
Durante la desconfiguración de la interfaz, ifdown ignora los errores de la misma manera que si se hubiera especificado --ignore-errors.
ARCHIVOS
/etc/network/interfaces
definiciones de interfaces de red. Consulte interfaces(5) para obtener más información.
/run/network/ifstate
estado actual de las interfaces de red
CONCURRENCIA
Ifupdown utiliza el bloqueo por interfaz para garantizar que las llamadas concurrentes de ifup e ifdown a la misma interfaz se ejecuten en serie. Sin embargo, las llamadas a diferentes interfaces podrán ejecutarse en paralelo.
ESTADO DE SALIDA
Para ifup e ifdown, el estado de salida será 0 si todas las interfaces dadas se han (des)configurado correctamente, 1 si se produjo algún error. El resultado de estos comandos es idempotente; ejecutar ifup en una interfaz que ya está activa dará como resultado un estado de salida de 0, y de manera similar, ejecutar ifdown en una interfaz que no está activa también dará como resultado un estado de salida de 0.
ifquery normalmente devolverá un estado de salida de 0 si existe una interfaz con una sección de configuración coincidente, 1 si no existe ninguna sección coincidente. ifquery --state también devolverá un estado de salida de 1 si la interfaz dada se conocía pero no estaba activa.
ERRORES/LIMITACIONES CONOCIDAS
El programa mantiene registros de si las interfaces de red están activas o desactivadas. En circunstancias excepcionales, estos registros pueden volverse inconsistentes con el estado real de las interfaces. Por ejemplo, una interfaz que se activó usando ifup y luego se desconfiguró usando ifconfig
seguirá registrada como activa. Para solucionarlo, puede usar la opción --force para forzar que ifup o ifdown
ejecuten los comandos de configuración o desconfiguración, independientemente de lo que considere el estado actual de la
interfaz.
El archivo /run/network/ifstate debe ser de escritura para que ifup o ifdown funcionen correctamente. Si esa ubicación no es de escritura (por ejemplo, porque el sistema de archivos raíz se monta en modo de solo lectura para la
recuperación del sistema), entonces /run/network/ifstate debe convertirse en un enlace simbólico a una ubicación de escritura. Si
esto no es posible, puede usar la opción --force para ejecutar los comandos de configuración o desconfiguración sin actualizar el archivo.
Tenga en cuenta que el programa no se ejecuta automáticamente: ifup por sí solo no activa las interfaces que aparecen como resultado de la instalación de hardware, y ifdown por sí solo no desactiva las interfaces
que desaparecen como resultado de la eliminación de hardware. Para automatizar la configuración de las interfaces de red, debe instalar otros paquetes, como udev(7) o ifplugd(8).
AUTORES
La suite ifupdown fue creada por Anthony Towns <_>, actualmente mantenida por
Santiago Ruano Rincón <_> y Josue Ortega <_>
Muchas otras personas han ayudado a desarrollar ifupdown a lo largo del tiempo, consulte /usr/share/doc/ifupdown/changelog.Debian.gz para obtener un historial completo.