Subcomandos netcfg y netadm

El comando netcfg manipula los perfiles de configuración de red de sistema. Se puede invocar el comando netcfg de manera interactiva, con un subcomando individual o especificando un archivo de comando que contenga varios subcomandos. El comando netadm administra los perfiles y también interactúa con nwamd mediante el uso de subcomandos.

Subcomandos de netcfg

Los siguientes subcomandos netcfg se admiten en el modo interactivo y el modo de línea de comandos. Tenga en cuenta que determinados subcomandos tienen semánticas diferentes dentro de cada ámbito. Si un subcomando no se puede utilizar en un modo determinado, esto se observa en la descripción del subcomando. Los subcomandos se clasifican alfabéticamente.

• cancel

  Finaliza la especificación del perfil actual sin conformar los cambios actuales en el almacenamiento persistente y, a continuación, continúa con el ámbito anterior, que está en un nivel superior.

• clear prop-name

  Borra el valor de la propiedad especificada.

• commit

  Confirma la especificación de perfil actual en el almacenamiento persistente. Para que pueda confirmarse, una configuración debe ser correcta. Por lo tanto, esta operación también realiza automáticamente una operación verify en el perfil o el objeto. La operación commit se intenta automáticamente al salir del ámbito actual, utilizando el subcomando end o exit.

• create [ -t template ] object-type [ class ] object-name

  Crea un perfil en memoria con el tipo y el nombre especificados. La opción -t plantilla especifica que el nuevo perfil es idéntico a plantilla, donde plantilla es el nombre de un perfil existente del mismo tipo. Si no se usa la opción -t, el nuevo perfil se crea con los valores predeterminados.

• destroy -a

  Elimina todos los perfiles definidos por el usuario de la memoria y el almacenamiento persistente.

• destroy tipo_objeto [ clase ] nombre_objeto

  Elimina el perfil definido por el usuario especificado de la memoria y el almacenamiento persistente.

  ---

  Precaución - Esta operación es inmediata y no es necesario confirmarla. Un perfil eliminado no se puede revertir.

  ---

• end

  Finaliza la especificación del perfil actual y continúa con el ámbito anterior, que está en un nivel superior. El perfil actual se verifica y confirma antes de que finalice la operación de edición. Si se produce un error en la operación verify o commit, se muestra un mensaje de error. Tendrá la oportunidad de finalizar la operación sin confirmar los cambios actuales. También puede permanecer en el ámbito actual y continuar editando el perfil.

• exit

  Sale de la sesión interactiva netcfg. El perfil actual se verifica y confirma antes de que finalice la sesión actual. En caso de que ocurra un fallo en la operación verify o commit, se mostrará un mensaje de error. Tendrá la oportunidad de finalizar la sesión sin confirmar los cambios actuales. También puede permanecer en el ámbito actual y continuar editando el perfil.

• export [ -d ] [ -f output-file ] [ object-type [ class ] object-name ]

  Imprime la configuración actual en el ámbito actual o especificado en la salida estándar o en un archivo que se especifica con la opción -f. La opción -d genera el subcomando destroy -a como la primera línea de la salida. Este subcomando genera una salida en una forma que es adecuada para usar en un archivo de comandos. Para obtener información sobre cómo exportar y restaurar una configuración de perfil, consulte Exportación y restauración de la configuración de un perfil.

  ---

  Nota - No es posible exportar perfiles definidos por el sistema. Los perfiles definidos por el sistema incluyen los NCP Automatic y DefaultFixed, y las ubicaciones Automatic, NoNet y DefaultFixed

  ---

• get [ -V ] prop-name

  Obtiene el valor actual en memoria de la propiedad especificada. De manera predeterminada, se imprimen el nombre y el valor de la propiedad. Si se especifica la opción -V, sólo se imprime el valor de la propiedad.

• help [ subcommand ]

  Muestra ayuda general o ayuda sobre un asunto específico.

• list [-a] [object-type [ class ] object-name ]

  Muestra todos los perfiles y los pares de valor-propiedad que se utilizarán en el ámbito actual o especificado. Al mostrar las propiedades de un objeto, el comportamiento predeterminado es mostrar sólo las propiedades que se aplican a la configuración especificada. Es decir, si se muestra una NCU de IP para la que ipv4-addrsrc es dhcp , la propiedad ipv4-addr no se muestra. Si se incluye la opción -a, se muestran todas las propiedades, ya sea que se apliquen o no a la configuración actual.

• revert

  Suprime los cambios actuales que se realizaron en un perfil y, luego, vuelve a los valores del almacenamiento persistente.

• select object-type [ class ] object-name

  Selecciona el objeto especificado.

• set prop-name= value

  Establece el valor actual en memoria de la propiedad especificada.

  Si se realiza en el modo de línea de comandos, el cambio también se confirma inmediatamente en el almacenamiento persistente.

  Para delimitar las propiedades con varios valores, se utiliza una coma (,). Si un valor individual de una propiedad especificada contiene una coma, debe estar precedido con una barra diagonal inversa (\). Las comas dentro de las propiedades que sólo incluyen un valor único no se interpretan como delimitadores y no es necesario que estén precedidas por una barra diagonal inversa.

• verify

  Verifica que el objeto o perfil en memoria actual tengan una configuración válida.

• walkprop [-a]

  “Recorre” cada propiedad que está asociada al perfil actual. Para cada propiedad, se muestran el nombre y el valor actual. Se proporciona un indicador para permitirle cambiar el valor actual.

  Para delimitar las propiedades con varios valores, se utiliza una coma (,). Si un valor individual de una propiedad especificada contiene una coma, debe ir precedido por una barra oblicua inversa (\). Las comas dentro de las propiedades que sólo incluyen un valor único no se interpretan como delimitadores y no es necesario que estén precedidas por una barra diagonal inversa.

  De manera predeterminada, sólo se recorren las propiedades necesarias en función de las propiedades ya establecidas. Si ipv4-addrsrc se establece en dhcp, no se recorre ipv4-addr. Si se incluye la opción -a, se procesan en iteración todas las propiedades disponibles para el objeto o perfil especificado.

  ---

  Nota - El subcomando walkprop es significativo cuando se utiliza sólo en modo interactivo.

  ---

Subcomandos netadm

Se admiten los siguientes subcomandos netadm:

• enable [ -p profile-type ] [ -c ncu-class ] profile-name

  Activa el perfil especificado. Si el nombre de perfil no es único, se debe especificar el tipo de perfil. Si el tipo de perfil es ncu y el nombre no es único, por ejemplo, si existen tanto una NCU de enlace como una de interfaz con el mismo nombre, se activan ambas NCU, a menos que se use la opción -c para especificar la clase de NCU.

  El tipo de perfil debe ser uno de los siguientes:

  • ncp

  • ncu

  • loc

  • enm

  • wlan

  La clase de NCU se debe especificar como phys para una NCU de enlace o ip para una NCU de interfaz.

• disable [ -p profile-type ] [ -c ncu-class ] profile-name

  Desactiva el perfil especificado. Si el nombre de perfil no es único, se debe especificar el tipo de perfil para identificar el perfil que se va a desactivar. Si el tipo de perfil es ncu y el nombre no es único, por ejemplo, si existen tanto una ncu de enlace como una de interfaz con el mismo nombre, se desactivan ambas NCU, a menos que se use la opción -c para especificar la clase de NCU.

  El tipo de perfil debe ser uno de los siguientes:

  • ncp

  • ncu

  • loc

  • enm

  • wlan

  La clase de NCU debe estar especificada como phys o ip.

• list [ -x ] [ -p profile-type ] [ -c ncu-class ] [ profile-name ]

  Muestra todos los perfiles disponibles y su estado actual. Si un perfil es especificado por nombre, entonces, sólo se muestra el estado actual de ese perfil. Si el nombre de perfil no es único, se muestran todos los perfiles con el nombre especificado. Como alternativa, el tipo de perfil, la clase de NCU o ambos pueden incluirse para identificar un perfil específico. Si sólo se especifica el tipo de perfil, se muestran todos los perfiles de ese tipo.

  Cuando se muestran los NCP activados, se incluyen todas las NCU que componen ese NCP.

  Si se especifica la opción -x, se incluye en la salida una descripción expandida del estado auxiliar de cada perfil de la lista.

  Entre los valores posibles del estado auxiliar del perfil, se incluyen los siguientes:

  • disabled

    Indica un perfil activado manualmente que no se ha activado.

  • offline

    Indica un perfil activado condicionalmente o activado por el sistema que no se ha activado. Es posible que el perfil no esté activo porque no se cumplen sus condiciones. También es posible que el perfil no esté activo porque se ha activado otro perfil que cumple condiciones más específicas. Esta condición se aplica a los tipos de perfil que deben estar activados de a uno por vez, por ejemplo, el perfil de ubicación.

  • online

    Indica un perfil activado condicionalmente o activado por el sistema cuyas condiciones se han cumplido y que se ha activado correctamente. También puede indicar un perfil activado manualmente que se ha activado correctamente a petición del usuario.

  • maintenance

    Indica que se intentó la activación del perfil, pero que se produjo un fallo.

  • initialized

    Indica que el perfil representa un objeto de configuración válida para el que no se realizó ninguna acción todavía.

  • uninitialized

    Indica que el perfil representa un objeto de configuración que no está presente en el sistema. Por ejemplo, este estado puede indicar una NCU que corresponde a un enlace físico que se haya eliminado del sistema.

• show-events

  Escucha y muestra una secuencia de eventos del daemon de gestión de redes, nwamd.

• scan-wifi link-name

  Inicia una exploración inalámbrica en el enlace que se especifica como link-name.

• select-wifi link-name

  Selecciona una red inalámbrica a la cual conectarse desde los resultados del análisis en el enlace especificado como link-name.

• help

  Muestra un mensaje de uso con una breve descripción de cada subcomando.