Configuration de profils à l'aide de la commande netcfg

La commande netcfg, décrite dans la page de manuel netcfg(1M), permet de configurer les propriétés et valeurs des profils réseau.

Vous pouvez utiliser la commande netcfg pour effectuer les tâches suivantes :

• Création ou modification d'un profil défini par l'utilisateur

  ---

  Remarque - Vous ne pouvez pas créer ni détruire un profil défini par le système.

  ---

• Création de la liste de tous les profils qui existent sur un système et de leurs valeurs de propriété

• Création de la liste de toutes les valeurs de propriété et des ressources d'un profil spécifié

• Affichage de chaque propriété associée à un profil

• Définition ou modification d'une ou de toutes les propriétés d'un profil spécifié

• Exportation de la configuration actuelle d'un profil défini par l'utilisateur vers la sortie standard ou un fichier

  ---

  Remarque - Vous ne pouvez pas exporter un profil défini par le système.

  ---

• Suppression de toutes les modifications qui ont été apportées à un profil et rétablissement de la configuration précédente de ce profil

• Vérification de la configuration correcte d'un profil

Vous pouvez utiliser l'interface utilisateur netcfg en mode interactif, mode ligne de commande ou mode fichier de commande. Dans la mesure où la commande netcfg est hiérarchique, elle est mieux comprise lorsqu'elle est utilisée en mode interactif.

Le concept de portée est utilisé pour la commande netcfg. Lorsque vous utilisez la commande en mode interactif, la portée dans laquelle vous vous trouvez à un moment donné dépend du type de profil et de la tâche que vous effectuez. Lorsque vous saisissez la commande netcfg dans une fenêtre de terminal, une invite s'affiche au niveau de la portée générale.

A partir de là, vous pouvez utiliser les sous-commandes select ou create pour afficher, modifier ou créer les profils de haut niveau suivants :

• NCP

• Emplacements

• ENM

• WLAN connus

Avant de créer ou de sélectionner un profil, l'invite interactive netcfg s'affiche au format suivant :

netcfg>

Une fois un profil créé ou sélectionné, l'invite interactive netcfg s'affiche comme suit :

netcfg:profile-type:profile-name>

Pour obtenir des instructions détaillées sur l'utilisation de la commande netcfg, reportez-vous au Chapitre 4, Configuration de profil NWAM (tâches). Pour plus d'informations sur la commande netcfg, reportez-vous à la page de manuel netcfg(1M).

Mode interactif netcfg

La sélection ou la création d'un profil de haut niveau en mode interactif netcfg génère une invite de commande qui s'affiche dans la portée des profils d'emplacement et ENM. Par exemple :

netcfg> select loc foo
netcfg:loc:foo>

Si un NCP est sélectionné, l'invite de commande s'affiche dans la portée NCP. Dans la portée NCP, il est possible de sélectionner ou de créer une NCU. La sélection ou la création d'une NCU génère une invite de portée de profil pour la NCU sélectionnée. Dans cette portée, toutes les propriétés associées au profil sélectionné peuvent être affichées et définies, comme indiqué dans l'exemple suivant où le NCP User a été sélectionné en premier, puis une NCU a été créée dans la portée NCP. Cette action a généré la portée de profil pour la nouvelle NCU. Dans cette portée, les propriétés de la NCU peuvent être affichées ou définies :

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

Dans une portée donnée, l'invite de commande indique le profil sélectionné. Toutes les modifications que vous apportez au profil dans cette portée peuvent être validées, ce qui signifie qu'elles sont enregistrées dans le référentiel permanent. Les modifications sont validées implicitement lorsque vous sortez de la portée. Si vous ne souhaitez pas valider les modifications que vous avez apportées au profil sélectionné, vous pouvez rétablir le dernier état validé pour ce profil. Cette action restaure toutes les modifications que vous avez apportées au profil à ce niveau. Les sous-commandes reset et cancel fonctionnent de la même manière.

Mode de ligne de commande netcfg

En mode ligne de commande, les sous-commandes qui ont une incidence sur une propriété ou un profil sélectionné doivent être exécutées dans la portée particulière où la propriété ou le profil sélectionné existe. Par exemple, pour obtenir la valeur d'une propriété d'une NCU, vous devez exécuter la sous-commande get dans la portée de cette NCU particulière. En mode interactif netcfg, il est relativement facile de comprendre la syntaxe à utiliser pour cette commande. Toutefois, en mode ligne de commande, la syntaxe risque d'être moins évidente.

Par exemple, pour obtenir la valeur d'une propriété "foo", attribut d'une NCU appelée myncu dans le NCP User, vous devez utiliser la syntaxe suivante :

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

Dans cet exemple, notez les informations suivantes :

• Les portées sont séparées par un point-virgule.

• La sous-commande select est émise à chaque portée, une fois à la portée générale et une fois à la portée de profil.

• La sous-commande get est utilisée dans la portée dans laquelle la propriété "foo" existe.

• Des guillemets droits sont requis pour éviter que le shell n'interprète les points-virgules.

Mode fichier de commande netcfg

En mode fichier de commande, les informations de configuration sont extraites d'un fichier. La sous-commande export permet de générer ce fichier. La configuration peut alors être imprimée sur la sortie standard ou l'option -f peut être utilisée pour spécifier un fichier de sortie. La sous-commande export peut également être utilisée de façon interactive. Pour plus d'informations, reportez-vous à la section Sous-commandes netcfg prises en charge .

Sous-commandes netcfg prises en charge

Les sous-commandes netcfg suivantes sont prises en charge en mode interactif et en mode ligne de commande. Notez que certaines sous-commandes n'ont pas la même sémantique dans chaque portée. Si une sous-commande ne peut pas être utilisée dans un certain mode, elle a été notée dans la description de la sous-commande.

• cancel

  Met fin à la spécification de profil actuelle sans valider les modifications du stockage persistant, puis passe à la portée suivante, située un niveau plus haut.

• clear prop-name

  Efface la valeur de la propriété spécifiée.

• commit

  Valide le profil dans le stockage persistant. La configuration doit être correcte pour être validée. Par conséquent, cette opération exécute également automatiquement une commande verify sur le profil ou l'objet. L'opération commit s'effectue automatiquement dès que vous quittez la portée actuelle à l'aide de la sous-commande end ou exit.

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

  Crée un profil en mémoire avec le type et le nom spécifié. L'option -t template spécifie que le nouveau profil est identique à template, où template est le nom d'un profil existant du même type. Si l'option -t n'est pas utilisée, le nouveau profil est créé avec les valeurs par défaut.

• destroy -a

  Supprime tous les profils définis par l'utilisateur de la mémoire et du stockage persistant.

• destroy object-type [ class ] object-name

  Supprime le profil défini par l'utilisateur spécifié dans la mémoire et le stockage persistant.

  ---

  Attention - Cette opération est immédiate et n'a pas besoin d'être validée. La destruction d'un profil ne peut pas être annulée.

  ---

• end

  Met fin à la spécification de profil actuelle et procède à la portée suivante, située un niveau plus haut. Le profil actuel est vérifié et validé avant que ne prenne fin l'opération de modification. Si l'une des opérations, verify ou commit, échoue, un message d'erreur s'affiche. Vous avez alors la possibilité de mettre fin à l'opération sans valider les modifications en cours. Vous pouvez également rester dans la portée actuelle et poursuivre la modification du profil.

• exit

  Quitte la session interactive netcfg. Le profil actuel est vérifié et validé avant que la session en cours ne se termine. Si l'une des opérations, verify ou commit, échoue, un message d'erreur s'affiche. Vous avez alors la possibilité de mettre fin à la session sans valider les modifications en cours. Vous pouvez également rester dans la portée actuelle et poursuivre la modification du profil.

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

  Imprime la configuration actuelle à la portée actuelle ou spécifiée sur la sortie standard ou dans un fichier spécifié avec l'option -f. L'option -d génère la sous-commande destroy -a en tant que la première ligne de la sortie. Cette sous-commande génère une sortie dans un format adapté pour une utilisation dans un fichier de commandes.

  ---

  Remarque - Les profils définis par le système (NCP automatique et emplacements Automatique, NoNet et Hérité) ne peuvent pas être exportés.

  ---

• get [ -V ] prop-name

  Obtient la valeur actuelle en mémoire de la propriété spécifiée. Par défaut, la valeur et le nom de la propriété sont imprimés. Si l'option - V est spécifiée, seule la valeur de la propriété est imprimée.

• help [ subcommand ]

  Affiche l'aide générale ou l'aide sur un sujet spécifique.

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

  Répertorie tous les profils, paires propriété-valeur et ressources qui seront utilisés dans la portée actuelle ou spécifiée. Si l'option -a est spécifiée, toutes les propriétés sont répertoriées, y compris celles qui seront ignorées, en fonction des paramètres en cours.

• revert

  Supprime les modifications en cours qui ont été apportées à un profil, puis rétablit les valeurs à partir du stockage persistant.

• select object-type [ class ] object-name

  Sélectionne l'objet spécifié.

• set prop-name= value

  Définit la valeur actuelle en mémoire de la propriété spécifiée.

  Si elle est effectuée en mode ligne de commande, la modification est également validée immédiatement dans le stockage persistant.

  Le séparateur des propriétés à valeurs multiples est une virgule (,). Si une valeur spécifique d'une propriété donnée contient une virgule, elle doit être précédée d'une barre oblique inverse (\). Les virgules dans les propriétés à valeur unique ne sont pas interprétées comme des séparateurs et n'ont pas besoin d'être précédées d'une barre oblique inverse.

• verify

  Vérifie que la configuration de l'objet ou du profil en mémoire actuel est correcte.

• walkprop [-a]

  "Parcourt" chaque propriété associée au profil en cours. Pour chaque propriété, le nom et la valeur en cours sont affichés. Une invite est fournie pour vous permettre de modifier la valeur en cours. Si une propriété n'est pas utilisée, en fonction des valeurs définies précédemment, elle n'est pas affichée. Par exemple, si la propriété ipv4-addrsrc est définie sur static, la propriété ipv4-addr n'est pas utilisée, et n'est pas parcourue ni répertoriée, sauf si vous spécifiez l'option -a.

  Lorsqu'elle est utilisée, l'option -a itère toutes les propriétés disponibles pour l'objet ou le profil spécifié.

  Le séparateur des propriétés à valeurs multiples est une virgule (,). Si une valeur individuelle d'une propriété donnée contient une virgule, elle doit être précédée d'une barre oblique inverse (\). Les virgules dans les propriétés à valeur unique ne sont pas interprétées comme des séparateurs et n'ont pas besoin d'être précédées d'une barre oblique inverse.

  ---

  Remarque - Cette sous-commande est utile lorsqu'elle est utilisée en mode interactif uniquement.

  ---

Pour obtenir des informations relatives aux tâches, reportez-vous au Chapitre 4, Configuration de profil NWAM (tâches).