Sous-commandes netcfg et netadm

La commande netcfg permet de manipuler les profils de configuration réseau du système. La commande netcfg peut être appelée interactivement, avec une sous-commande propre ou en indiquant un fichier de commandes qui contient une série de sous-commandes. La commande netadm permet d'administrer les profils et interagit également avec la commande nwamd à l'aide des sous-commandes.

Sous-commandes netcfg

Les sous-commandes netcfg suivantes sont prises en charge en mode interactif et en mode ligne de commande. Notez que certaines sous-commandes ont une sémantique différente dans chaque étendue. Si une sous-commande ne peut pas être utilisée dans un certain mode, la description de la sous-commande le mentionne. Les sous-commandes apparaissent dans l'ordre alphabétique.

• cancel

  Met fin à la spécification de profil actuelle sans valider les modifications dans le stockage persistant, puis passe à l'étendue suivante, située un niveau plus haut.

• clear prop-name

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

• commit

  Valide la spécification de profil actuelle dans le stockage persistant. La configuration doit être correcte pour être validée. Par conséquent, cette opération exécute également automatiquement une opération verify sur le profil ou l'objet. L'opération commit s'effectue automatiquement dès que vous quittez l'étendue 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 suppression d'un profil ne peut pas être annulée.

  ---

• end

  Met fin à la spécification de profil actuelle et passe à l'étendue 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 l'étendue 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 l'étendue actuelle et poursuivre la modification du profil.

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

  Imprime la configuration actuelle à l'étendue 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. Pour plus d'informations sur l'exportation et la restauration d'une configuration de profil, reportez-vous à la section Exportation et restauration d'une configuration de profil.

  ---

  Remarque - Vous ne pouvez pas exporter de profil défini par le système. Les profils définis par le système incluent les NCP Automatic et DefaultFixed et les emplacements Automatic, NoNet et DefaultFixed.

  ---

• 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 l'étendue en cours ou spécifiée. Lors de l'établissement de la liste des propriétés d'un objet, le comportement par défaut consiste à ne répertorier que les propriétés qui s'appliquent à la configuration indiquée. C'est-à-dire que si vous générez une liste pour une NCU IP dont la valeur ipv4-addrsrc est dhcp, la propriété ipv4-addr n'est pas incluse dans la liste. Si vous ajoutez l'option -a, toutes les propriétés sont répertoriées, qu'elles s'appliquent aux paramètres actuels ou non.

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

  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.

  Par défaut, seules les propriétés requises en fonction de propriétés déjà définies sont parcourues. Si la propriété ipv4-addrsrc est définie sur dhcp, la propriété ipv4-addr n'est pas parcourue. Lorsqu'elle est incluse, l'option -a itère toutes les propriétés disponibles pour l'objet ou le profil spécifié.

  ---

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

  ---

Sous-commandes netadm

Les sous-commandes netadm suivantes sont prises en charge :

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

  Active le profil spécifié. Si le nom de profil n'est pas unique, le type de profil doit être spécifié. Si le type de profil est ncu et que le nom n'est pas unique (par exemple, s'il existe une NCU de lien et une NCU d'interface portant le même nom), les deux NCU sont activées, sauf si l'option -c est utilisée pour indiquer la classe NCU.

  Le type du profil doit être l'un des types suivants :

  • ncp

  • ncu

  • loc

  • enm

  • wlan

  La classe NCU doit être spécifiée en tant que phys pour une NCU de lien ou ip pour une NCU d'interface.

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

  Désactive le profil spécifié. Si le nom de profil n'est pas unique, le type de profil doit être spécifié pour identifier le profil à désactiver. Si le type de profil est ncu et que le nom n'est pas unique (par exemple, s'il existe une NCU de lien et une ncu d'interface portant le même nom), les deux NCU sont activées, sauf si l'option -c est utilisée pour indiquer la classe NCU.

  Le type du profil doit être l'un des types suivants :

  • ncp

  • ncu

  • loc

  • enm

  • wlan

  La classe NCU doit être spécifiée en tant que phys ou ip.

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

  Répertorie tous les profils disponibles et leur état actuel. Si un profil est spécifié par son nom, seul l'état actuel de ce profil est répertorié. Si le nom du profil n'est pas unique, tous les profils portant ce nom sont répertoriés. Le type de profil ou la classe NCU ou les deux peuvent également être inclus pour identifier un profil spécifique. Si seul le type de profil est spécifié, tous les profils de ce type sont répertoriés.

  Lorsque le NCP activé est inclus dans la liste, toutes les NCU qui le constituent le sont aussi.

  Si l'option -x est spécifiée, une description détaillée de l'état auxiliaire de chaque profil répertorié est également incluse dans la sortie.

  Les valeurs d'état auxiliaire de profil possibles sont les suivantes :

  • disabled

    Indique un profil activé manuellement qui n'a pas été activé.

  • offline

    Indique un profil activé conditionnellement ou par le système qui n'a pas été activé. Le profil peut ne pas être actif parce que ses conditions n'ont pas été vérifiées. Le profil peut également ne pas être actif parce qu'un autre profil, dont les conditions plus spécifiques sont vérifiées, a été activé. Cette condition s'applique aux types de profils qui doivent être activés séparément, tels que le profil d'emplacements.

  • online

    Indique un profil activé conditionnellement ou par le système dont les conditions sont vérifiées et qui a été activé. Peut également indiquer un profil activé manuellement qui a été activé à la demande de l'utilisateur.

  • maintenance

    Indique que la tentative d'activation du profil a échoué.

  • initialized

    Indique que le profil représente un objet de configuration correct pour lequel aucune action n'a encore été entreprise.

  • uninitialized

    Indique que le profil représente un objet de configuration absent du système. Par exemple, cet état peut indiquer une NCU correspondant à un lien physique supprimé du système.

• show-events

  Ecoute et affiche un flux d'événements depuis le démon de gestion réseau, nwamd.

• scan-wifi link-name

  Lance une analyse sans fil sur le lien spécifié en tant que link_name.

• select-wifi link-name

  Sélectionne un réseau sans fil auquel se connecter à partir des résultats de l'analyse sur le lien spécifié en tant que link-name.

• help

  Affiche un message d'utilisation avec une brève description de chaque sous-commande.