Perfiles de configuración mediante el comando netcfg

El comando netcfg, que se describe en la página del comando man netcfg(1M), se usa para configurar propiedades y los valores de los perfiles de red.

Puede usar el comando netcfg para realizar las siguientes tareas:

• Crear o destruir un perfil definido por el usuario.

  ---

  Nota - No es posible crear ni destruir un perfil definido por el sistema.

  ---

• Mostrar todos los perfiles que existen en un sistema y sus valores de propiedad.

• Mostrar todos los valores de la propiedad y recursos para un perfil especificado.

• Mostrar cada propiedad que está asociada a un perfil.

• Definir o modificar una o todas las propiedades de un perfil especificado.

• Exportar la configuración actual de un perfil definido por el usuario en la salida estándar o en un archivo.

  ---

  Nota - No es posible exportar un perfil definido por el sistema.

  ---

• Suprimir cualquier cambio que se haya realizado en un perfil y volver a la configuración anterior para dicho perfil.

• Verificar que un perfil tenga una configuración válida.

Puede utilizar la interfaz de usuario de netcfg en el modo interactivo, el modo de línea de comandos o el modo de archivo de comandos. Como el comando netcfg es jerárquico, se entiende más fácilmente cuando se utiliza en el modo interactivo.

Para el comando netcfg, se utiliza el concepto de un ámbito. Cuando utiliza el comando de forma interactiva, el ámbito en el que se encuentra en cualquier momento dado depende del tipo de perfil y la tarea que está realizando. Cuando escribe el comando netcfg en una ventana del terminal, aparece un indicador en el ámbito global.

Desde aquí, puede utilizar los subcomandos select o create para ver, modificar o crear los siguientes perfiles de nivel superior:

• NCP

• Ubicaciones

• ENM

• WLAN conocidas

Antes de crear o seleccionar un perfil, el indicador interactivo netcfg se muestra en el siguiente formato:

netcfg>

Después de haber creado o seleccionado un perfil, el indicador interactivo netcfg se muestra de la siguiente manera:

netcfg:profile-type:profile-name>

Para obtener instrucciones paso a paso sobre el uso del comando netcfg, consulte el Capítulo 4, Configuración de perfiles de NWAM (tareas). Para obtener más información sobre el uso del comando netcfg, consulte la página del comando man netcfg(1M).

Modo interactivo netcfg

La selección o creación de un perfil de nivel superior mientras trabaja en el modo interactivo netcfg da como resultado un indicador de comandos que aparece en el ámbito de perfil para los perfiles de ubicación y ENM. Por ejemplo:

netcfg> select loc foo
netcfg:loc:foo>

Si se selecciona un NCP, el indicador de comandos se muestra en el ámbito del NCP. Desde el ámbito del NCP, se puede seleccionar o crear una NCU. La selección o creación de una NCU produce un indicador de ámbito de perfil para la NCU seleccionada. En este ámbito, todas las propiedades asociadas con el perfil seleccionado actualmente se pueden ver y definir, como se muestra en el siguiente ejemplo donde el User NCP se ha seleccionado en primer lugar y, luego, se ha creado una NCU en el ámbito del NCP. Esta acción ha producido el ámbito de perfil para la NCU creada recientemente. En este ámbito, se pueden ver o establecer las propiedades de la NCU:

netcfg> select ncp User
netcfg:ncp:User> create ncu phys net2
Created ncu 'net2'.  Walking properties ...
activation-mode (manual) [manual|prioritized]>

En cualquier ámbito determinado, el indicador de comandos muestra el perfil seleccionado actualmente. Todos los cambios realizados al perfil en este ámbito puede ser confirmados, lo que quiere decir que los cambios se guardan en el depósito persistente. Los cambios se confirman implícitamente al salir el ámbito. Si no desea confirmar los cambios que haya realizado en el perfil seleccionado, puede volver a los último cambios confirmados para dicho perfil. Si realiza esta acción, revierte los cambios realizados en el perfil de ese nivel. Los subcomandos revert y cancel funcionan de forma parecida.

Modo de línea de comandos netcfg

En el modo de línea de comandos, cualquier subcomando que afecte un perfil o propiedad seleccionados se debe ejecutar en el ámbito particular en el que existe el perfil o la propiedad seleccionados. Por ejemplo, para obtener el valor de una propiedad de una NCU, se utilizaría el subcomando get en el ámbito de esa NCU particular. Cuando está en el modo interactivo netcfg, es bastante fácil comprender la sintaxis que debe utilizarse para este comando. Sin embargo, en el modo de línea de comandos, la sintaxis puede ser menos obvia.

Por ejemplo, para obtener el valor de una propiedad “foo”, que es un atributo de una NCU denominada myncu en el NCP User, debe utilizar la siguiente sintaxis:

$ netcfg "select ncp User; select ncu ip myncu; get foo"

En este ejemplo, tenga en cuenta la siguiente información:

• Cada ámbito se separa con un punto y coma.

• El subcomando select se emite en cada ámbito, una vez en el ámbito global y una vez en el ámbito de perfil.

• El subcomando get se usa dentro del ámbito en el que existe la propiedad “foo”.

• Se requieren comillas rectas para evitar que el shell las interprete como punto y coma.

Modo de archivo de comandos netcfg

En el modo de archivo de comandos, la información de configuración se obtiene de un archivo. Para producir este archivo, se utiliza el subcomando export. La configuración puede imprimirse en una salida estándar, o bien puede utilizarse la opción -f para especificar un archivo de salida. El subcomando export también se puede usar de modo interactivo. Para obtener más información, consulte Subcomandos admitidos por netcfg.

Subcomandos admitidos por 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 cierto modo, esto se observa en la descripción del subcomando.

• 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 nombre_prop

  Borra el valor de la propiedad especificada.

• commit

  Confirma el 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 verificación 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 plantilla ] tipo_objeto [ clase ] nombre_objeto

  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 destruido 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 finalizar la operación de edición. 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 operación sin confirmar los cambios actuales. O bien, 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. O bien, puede permanecer en el ámbito actual y continuar editando el perfil.

• export [ -d ] [- f archivo_salida ] [ tipo_objeto [ clase ] nombre_objeto ]

  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.

  ---

  Nota - Los perfiles definidos por el sistema, incluidos el NCP automático y las ubicaciones Automatic, NoNet y heredadas, no se pueden exportar.

  ---

• get [ -V ] nombre_prop

  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 [ subcomando ]

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

• list [-a] [tipo_objeto [ clase ] nombre_objeto ]

  Muestra todos los perfiles, los pares de valor-propiedad y los recursos que se utilizarán en el ámbito actual o el especificado. Si se especifica la opción -a, se muestran todas las propiedades, incluidas aquellas que se ignorarán, en función de los ajustes actuales.

• revert

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

• select tipo_objeto [ clase ] nombre_objeto

  Selecciona el objeto especificado.

• set nombre_prop= valor

  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 propiedades de 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]

  “Guía” a 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. Si una propiedad no se utiliza, según los valores especificados anteriormente, no se muestra la propiedad. Por ejemplo, si la propiedad ipv4-addrsrc se establece en static, no se usa la propiedad ipv4-addr, y no se guía ni muestra, al menos que especifique la opción -a.

  Cuando se utiliza, la opción -a repite todas las propiedades disponibles para el objeto o perfil especificado.

  Para delimitar propiedades de 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 interpreten como delimitadores y no es necesario que estén precedidas por una barra diagonal inversa.

  ---

  Nota - Este subcomando es significativo sólo cuando se utiliza en el modo interactivo.

  ---

Para obtener información relacionada con la tarea, consulte el Capítulo 4, Configuración de perfiles de NWAM (tareas).