Commande rmpath

Objectif

Supprime du système un chemin d'accès à une unité compatible MPIO.

Syntaxe

rmpath [ -l Nom ] [ -p Parent ] [ -w Connexion ] [ -i PathID ]

rmpath [ -l Nom ] [ -p Parent ] [ -w Connexion ] [ -d ] [ -g ]

rmpath -h

Descriptif

La commande rmpath annule la configuration, et éventuellement la définition, d'un ou de plusieurs chemins associés à l'unité cible spécifiée (-l Nom). L'ensemble des chemins supprimés est déterminé par la combinaison des indicateurs -l Nom, -p Parentet -w Connexion . Si la commande renvoie tous les chemins d'accès associés à l'unité en cours d'annulation de configuration ou de définition, la commande s'arrête en générant un message d'erreur alors qu'elle n'a pas encore annulé la configuration ni la définition des chemins. Dans ce cas, vous devez plutôt utiliser la commande rmdev pour annuler la configuration ou la définition de l'unité cible elle-même.

L'action par défaut annule la configuration de chaque chemin d'accès spécifié, mais ne la supprime pas complètement du système. Si l'indicateur -d est spécifié, la commande rmpath annule la configuration (si nécessaire) et supprime ou supprime la ou les définitions de chemin du système.

Après exécution de la commande rmpath, un message d'état s'affiche. Lors de l'annulation de la configuration de chemins, il est possible que cette commande puisse annuler la configuration de certains chemins et non d'autres (par exemple, les chemins qui sont en cours d'exécution d'E-S ne peuvent pas être déconfigurés).

La commande rmpath fournit un message d'état sur les résultats de l'opération. Ces messages sont créés dans l'un des formats suivants :

path [ defined | deleted ]: Ce message s'affiche lorsqu'un chemin unique a été correctement déconfiguré ou non défini. Si le chemin est correctement configuré, le message path available s'affiche. Si le chemin n'est pas correctement configuré et qu'aucun code d'erreur explicite n'est renvoyé par la méthode, le message path defined s'affiche.
paths [defined | deleted]: Ce message s'affiche si plusieurs chemins ont été identifiés et si la configuration et la définition de tous les chemins d'accès ont été annulées. Si l'indicateur -d n'est pas spécifié, le message sera paths defined. Si l'indicateur -d est spécifié, le message sera paths deleted.
some paths [ defined | deleted ]: Ce message s'affiche si plusieurs chemins ont été identifiés et si la configuration et la définition de certains chemins d'accès ont été annulées. Si l'indicateur -d n'est pas spécifié, le message sera some paths defined. Si l'indicateur'-d est spécifié, le message sera some paths deleted.
no paths processed: Ce message est généré si aucun chemin d'accès ne répond aux critères de sélection.

Indicateurs

Article	Descriptif
-d	Indique que les chemins d'accès spécifiés doivent être supprimés du système.
-g	Force l'exécution de l'opération de suppression de chemin sur une unité verrouillée.
-h	Affiche le message d'utilisation de la commande.
-i PathID	Indique l'ID de chemin associé au chemin à supprimer et est utilisé pour identifier un chemin de manière unique.
-l Nom	Spécifie le nom d'unité logique de l'unité cible dont le chemin d'accès doit être supprimé. Les chemins à supprimer sont qualifiés via les indicateurs -p et -w .
-p Parent	Indique le nom d'unité logique de l'unité parent à utiliser dans la qualification des chemins d'accès à supprimer. Etant donné que tous les chemins d'accès à une unité ne peuvent pas être supprimés par cette commande, cet indicateur, l'indicateur -w ou les deux doivent être spécifiés.
-w Connexion	Indique les informations de connexion à utiliser dans la qualification des chemins d'accès à supprimer. Etant donné que tous les chemins d'accès à une unité ne peuvent pas être supprimés par cette commande, cet indicateur, l'indicateur -p ou les deux doivent être spécifiés.

Security

Contrôle des privilèges: seuls l'utilisateur root et les membres du groupe de systèmes ont un accès en exécution à cette commande.

Evénements d'audit :

Evénement	Informations
DEV_Change	rmpath, Unconfigure, < arguments de la méthode unconfigure >
DEV_Change	rmpath, Undefine, < arguments de méthode undefine >

Exemples

Pour annuler la configuration du chemin d'accès de scsi0 à hdisk1 lors de la connexion 5,0, entrez:
```
rmpath -l hdisk1 -p scsi0 -w "5,0"
```
Le message généré doit ressembler à ce qui suit :
```
path defined
```
Pour annuler la configuration de tous les chemins d'accès entre scsi0 et hdisk1, tapez :
```
rmpath -l hdisk1 -p scsi0
```
Si la configuration de tous les chemins d'accès est annulée, le message généré doit ressembler à ce qui suit :
```
paths defined
```
En revanche, si la configuration de certains chemins d'accès est annulée, le message généré doit ressembler à ce qui suit :
```
some paths defined
```
Pour annuler la définition de chemin entre scsi0 et hdisk1 lors de la connexion 5,0, entrez:
```
rmpath -d -l hdisk1 -p scsi0 -w "5,0"
```
Le message généré doit ressembler à ce qui suit :
```
path deleted
```
Pour annuler la configuration de tous les chemins d'accès entre scsi0 et hdisk1, tapez :
```
rmpath -d -l hdisk1 -p scsi0
```
Le message généré doit ressembler à ce qui suit :
```
paths deleted
```

Fichiers

Article	Descriptif
/usr/sbin/rmpath	Contient la commande rmpath .