Etablissement de la liste des informations de configuration des profils sur un système

La commande netcfg peut être utilisée avec la sous-commande list pour obtenir la liste de tous les profils, des paires propriété-valeur et des ressources qui existent au niveau de l'étendue actuelle ou spécifiée. Utilisez la sous-commande list pour interroger le système pour obtenir des informations générales sur tous les profils ou pour récupérer des informations spécifiques sur un profil particulier. La sous-commande list peut être utilisée en mode interactif ou en mode ligne de commande.

Pour plus d'informations sur les sous-commandes netcfg, reportez-vous à la section Sous-commandes netcfg.

Si vous avez besoin d'obtenir des informations sur les profils et leur état actuel, utilisez la commande netadm avec la sous-commande list. Pour plus d'informations, reportez-vous à la section Affichage de l'état actuel d'un profil.

Etablissement de la liste de toutes les informations de configuration des profils sur un système

La commande netcfg list répertorie tous les profils définis par le système et par l'utilisateur d'un système. Notez que l'utilisation de la sous-commande list sans aucune option affiche tous les profils de niveau supérieur qui sont dans un système. La commande ne répertorie pas l'état de chaque profil. Pour afficher la liste des profils et leur état (en ligne ou hors ligne), utilisez la commande netadm list.

Vous pouvez répertorier tous les profils de niveau supérieur sur un système à l'aide de la sous-commande list.

$ netcfg list
NCPs:
        DefaultFixed
        Automatic
        User
Locations:
        Automatic
        NoNet
        home
        office
        DefaultFixed
ENMs:
        myvpn
        testenm
WLANs:
        workwifi
        coffeeshop
        homewifi

Dans cet exemple, les profils suivants sont répertoriés :

• NCP

  Les NCP suivants sont répertoriés :

  • NCP DefaultFixed : profil fixe défini par le système

  • NCP Automatic : profil réactif défini par le système

  • NCP User : NCP réactif défini par l'utilisateur

• Emplacements

  Les profils d'emplacement suivants sont répertoriés :

  • Emplacements définis par le système :

    • Automatic

    • NoNet

    • DefaultFixed

  • Emplacements réactifs définis par l'utilisateur :

    • home

    • office

• ENM

  Les ENM suivants sont répertoriés :

  • myvpn : ENM pour une application VPN installée et configurée

  • testenm : ENM permettant de tester le fonctionnement des ENM

• WLAN

  Les WLAN suivants sont répertoriés :

  • workwifi : WLAN du bureau

  • coffeeshop : WLAN du café local

  • homewifi : WLAN du réseau sans fil au domicile de l'utilisateur

  ---

  Remarque - Seuls les profils définis par l'utilisateur peuvent être créés, modifiés ou supprimés.

  ---

Création d'une liste de toutes les valeurs de propriétés pour un profil spécifique

Utilisez la commande netcfg avec la sous-commande list pour obtenir la liste de toutes les valeurs des propriétés d'un profil spécifié.

La syntaxe de la sous-commande list est la suivante :

$ netcfg list [ object-type [ class ] object-name ]

Exemple 2-8 Création d'une liste de toutes les valeurs de propriété d'une NCU

Par exemple, pour créer une liste de toutes les valeurs de propriétés d'une NCU IP dans le NCP User, vous devez taper la commande suivante :

$ netcfg "select ncp User; list ncu ip net0"
NCU:net0
        type                    interface
        class                   ip
        parent                  "User"
        enabled                 true
        ip-version              ipv4
        ipv4-addrsrc            dhcp
        ipv6-addrsrc            dhcp,autoconf

Exemple 2-9 Création d'une liste de toutes les valeurs de propriété d'un ENM

Dans l'exemple suivant, toutes les propriétés pour un ENM nommé myenm sont répertoriées.

$ list enm myenm
ENM:myenm
activation-mode manual
enabled         true
start           "/usr/local/bin/myenm start"
stop            "/bin/alt_stop"

Dans cet exemple, la sortie de la sous-commande list affiche les informations suivantes :

• La propriété activation-mode de cet ENM est définie sur manual.

• L'ENM est activé.

• Les propriétés de méthode start et stop ont été spécifiées plutôt que d'utiliser un FMRI.

Obtention de la valeur d'une propriété spécifique

Vous pouvez utiliser la commande netcfg avec la sous-commande get pour obtenir et répertorier la valeur spécifique d'une propriété donnée. Cette sous-commande peut être utilisée dans le mode interactif ou le mode ligne de commande.

La syntaxe de la sous-commande get est comme suit :

netcfg get [ -V ] prop-name

Pour obtenir la valeur de la propriété ip-version d'une unité monétaire nationale nommée myncu, qui est une partie du NCP User, vous devez taper la commande suivante. Par exemple :

$ netcfg "select ncp User; select ncu ip myncu; get -V ip-version"
ipv4

Si l'option -V est utilisée avec la sous-commande get, seule la valeur de la propriété est affichée, comme illustré ici :

netcfg:ncp:User:ncu:net0> get -V activation-mode
manual

Dans le cas contraire, la propriété et sa valeur s'affichent. Par exemple :

netcfg:ncp:User:ncu:net0> get activation-mode
activation-mode        manual

Obtention interactive d'une seule valeur de propriété

Cette procédure décrit comment obtenir et répertorier une valeur de propriété unique à l'aide de la commande netcfg get en mode interactif netcfg. Dans cette procédure, certains de ces exemples montrent comment obtenir une seule valeur de propriété pour une NCU dans le NCP user. Ces exemples sont utilisés à des fins de démonstration uniquement. Les informations que vous fournissez lorsque vous utilisez cette commande peuvent varier, selon le profil et la valeur de la propriété que vous tentez d'obtenir.

Si vous souhaitez afficher toutes les valeurs des propriétés d'un profil, vous pouvez aussi utiliser la sous-commande walkprop. Cette sous-commande vous guide à travers toutes les propriétés d'un profil donné, une par une, ce qui vous permet de modifier une ou l'ensemble des propriétés du profil. Pour plus d'informations, reportez-vous à la section Affichage et modification de valeurs de propriétés à l'aide de la sous-commande walkprop.

1. Lancez une session netcfg en mode interactif.

   $ netcfg
   netcfg>

2. Sélectionnez le profil ou l'objet de configuration qui contient la valeur de la propriété que vous souhaitez obtenir.

   netcfg> select object-type [ class ] object-name

   ---

   Remarque - Le paramètre class est applicable uniquement si vous sélectionnez une NCU. En outre, le paramètre class doit être spécifié si les NCU de classe phys et ip partagent le même nom. Cependant, si le nom de NCU est unique, le paramètre class n'est pas obligatoire.

   ---

   Par exemple, pour sélectionner le NCP User, vous devez taper :

   netcfg> select NCP User

   Dans cet exemple, la sélection du NCP User déplace la session interactive dans l'étendue de l'objet sélectionné.

3. (Facultatif) Affichez les composants du profil.

   netcfg:ncp:User> list
   ncp:User
           management-type    reactive
   NCUs:
           phys    net0
           ip      net0

4. Sélectionnez l'objet qui contient la valeur de la propriété que vous souhaitez obtenir.

   Dans l'exemple suivant, le lien (phys) NCU net0 dans le NCP User est sélectionné :

   netcfg:ncp:User> select ncu phys net0

   La sélection de la NCU net0 déplace la session interactive vers l'étendue de l'objet et charge les propriétés en cours de la NCU à partir de la mémoire.

5. Obtenez la valeur de propriété spécifiée.

   netcfg:ncp:User:ncu:net0> get property-value

   Par exemple, pour obtenir la valeur de la propriété activation-mode, tapez :

   netcfg:ncp:User:ncu:net0> get activation-mode
           activation-mode         manual

Étapes suivantes

A ce stade, vous pouvez définir une nouvelle valeur pour la propriété en utilisant la sous-commande set, ou vous pouvez quitter la session interactive sans effectuer de modifications. Notez que si vous modifiez une valeur de propriété tout en étant en mode interactif, vous devez utiliser la sous-commande commit ou exit pour enregistrer vos modifications. Pour plus d'informations sur la définition d'une valeur de propriété en mode interactif netcfg, reportez-vous à la section Définition et modification des valeurs de propriétés pour un profil.

Affichage et modification de valeurs de propriétés à l'aide de la sous-commande walkprop

La sous-commande walkprop peut être utilisée de façon interactive pour afficher les propriétés d'un profil. Cette sous-commande vous guide à travers un profil, une propriété à la fois, en affichant le nom et la valeur actuelle de chaque propriété. Une invite de commande interactive est également affichée que vous pouvez utiliser pour modifier la valeur en cours de la propriété spécifiée. 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. Pour plus d'informations sur les sous-commandes netcfg, reportez-vous à la section Sous-commandes netcfg.

Exemple 2-10 Affichage et modification des valeurs de propriétés pour un profil spécifique

Dans l'exemple suivant, la propriété activation-mode pour l'emplacement test-loc est affichée, puis modifiée en utilisant la sous-commande walkprop. Notez que lorsque vous utilisez la sous-commande walkprop , il n'est pas nécessaire d'utiliser la sous-commande set pour définir la valeur de la propriété.

$ netcfg
netcfg> select loc test-loc
netcfg:loc:test-loc> list
loc:test-loc
        activation-mode                 manual
        enabled                         false
        nameservices                    dns
        nameservices-config-file        "/etc/nsswitch.dns"
        dns-nameservice-configsrc       dhcp
        nfsv4-domain                    "Central.example.com"
netcfg:loc:test-loc> walkprop
activation-mode (manual) [manual|conditional-any|conditional-all]> conditional-all
conditions> advertised-domain is example.com 
nameservices (dns) [dns|files|nis|ldap]>
nameservices-config-file ("/etc/nsswitch.dns")>
dns-nameservice-configsrc (dhcp) [manual|dhcp]>
nfsv4-domain ("Central.example.com")>
ipfilter-config-file>
ipfilter-v6-config-file>
ipnat-config-file>
ippool-config-file>
ike-config-file>
ipsecpolicy-config-file>
netcfg:loc:test-loc> list
loc:test-loc
        activation-mode                 conditional-all
        conditions                      "advertised-domain is example.com"
        enabled                         false
        nameservices                    dns
        nameservices-config-file        "/etc/nsswitch.dns"
        dns-nameservice-configsrc       dhcp
        nfsv4-domain                    "Central.example.com"
netcfg:loc:test-loc> commit
Committed changes
netcfg:loc:test-loc> end
netcfg> exit
$