Mandato lspath
Propósito
Muestra información acerca de las vías de acceso a un dispositivo con capacidad MPIO (E/S de multivía).
Sintaxis
lspath [ -dev Nombre_dispositivo ] [ -pdev Padre ] [ -status Estado ] [ -conn Conexión ] [ -field Nombre_campo ] [ -fmt Delimitador ]
lspath -dev Nombre_dispositivo -pdev Padre [ -conn Conexión ] -lsattr [ -attr Atributo... ]
lspath -dev Nombre_dispositivo -pdev Padre [ -conn Conexión ] -range -attr Atributo
Descripción
El mandato lspath muestra uno de los tres tipos
de información acerca vías de acceso a un dispositivo con capacidad MPIO. Muestra el estado operativo
de una o más vías de acceso a un único dispositivo o muestra uno o más atributos
de un única vía de acceso a un único dispositivo con capacidad MPIO.
La primera sintaxis muestra el estado operativo de una o más vías de acceso a un dispositivo
con capacidad MPIO en particular. La segunda sintaxis muestra uno o más atributos
de una única vía de acceso en un dispositivo con capacidad MPIO en particular.
Finalmente, la tercera sintaxis muestra el posible rango de dispositivos de un atributo
para una única vía de acceso a un dispositivo con capacidad MPIO.
Visualización del estado de la vía de acceso con el mandato lspath
Cuando se visualiza el estado de la vía de acceso, el conjunto de vías de acceso a mostrar
se obtiene buscando en la base de datos del dispositivo de configuración aquellas vías de acceso
que coincidan con el siguiente criterio:
- El nombre del dispositivo de destino coincide con el dispositivo especificado con el
distintivo -dev. Si el distintivo no está presente, -dev, el dispositivo
de destino no se utilizará en el criterio.
- El nombre de dispositivo padre coincide con el dispositivo especificado con el distintivo -pdev. Si el dispositivo -pdev no está presente, no se utilizará el
padre en el criterio.
- La conexión coincide con la conexión especificada con el distintivo -conn. Si el distintivo -conn no está presente,
la conexión no se utilizará en el criterio.
- El estado de la vía de acceso coincide con el estado especificado mediante el distintivo -status. Si el distintivo -status no está presente,
no se utilizará el estado de la vía de acceso en el criterio.
Si no se especifica ninguno de los distintivos -dev, -pdev, -conn o -status, entonces se mostrarán
todas las vías de acceso conocidas en el sistema.
Por omisión, este mandato mostrará la información en formato de columnas.
Cuando no se especifica ningún distintivo que califique qué vías de acceso mostrar, el formato de la
salida será:
estado dispositivo padre
Los posibles valores que pueden aparecer en la columna estado son:
- habilitada
- Indica que la vía de acceso está configurada y funciona. Será tenida en cuenta
cuando se seleccionen las vías de acceso para E/S.
- inhabilitada
- Indica que la vía de acceso está configurada pero no funciona en la actualidad.
Se ha inhabilitado manualmente y no será tenida en cuenta cuando se seleccionen las vías de acceso
para E/S.
- anómala
- Indica que la vía de acceso está configurada pero tiene fallos de E/S que hacen
no sea posible utilizarla. No será tenida en cuenta cuando se seleccionen las vías de acceso
para E/S.
- definido
- Indica que la vía de acceso no se ha configurado en el controlador de dispositivos.
- falta
- Indica que la vía de acceso ha sido definida en un arranque anterior, pero no se ha detectado
en el arranque más reciente del sistema.
- detectada
- Indica que la vía de acceso ha sido detectada en el arranque más reciente
del sistema, pero por alguna razón no ha sido configurada. Una vía de acceso sólo debería tener
este estado durante el arranque por lo que este nunca debería aparecer como resultado del
mandato lspath.
Visualización de atributos de vías de acceso con el mandato lspath
Al visualizar los atributos de una vía de acceso, la vía de acceso
debe estar calificada al completo.
Es posible mostrar varios atributos de una vía de acceso, pero los atributos que pertenezcan
a varias vías no pueden mostrarse en una única invocación del mandato lspath. Por lo tanto, además de los distintivos -lsattr, -dev y -pdev,
son necesarios los distintivos -conn para identificar de forma exclusiva
una única vía de acceso. Por ejemplo:
- si sólo hay una vía de acceso entre un dispositivo y un padre en particular, no será necesario especificar
el distintivo -conn
- si hay varías vías de acceso entre un dispositivo y un padre en particular, será necesario especificar
el distintivo -conn
Además, no se permite el distintivo -status.
Por omisión, este mandato mostrará la información en formato de columnas.
atributo valor descripción conf_usuario
Distintivos
| -attr Atributo |
Identifica el atributo especifico en la lista. El 'Atributo' es el nombre de un atributo específico. Cuando se proporciona
un distintivo, sólo se muestra el atributo identificado. Es posible utilizar
instancias de este distintivo para listar varios atributos. Si este distintivo
no se especifica, se listarán todos los atributos identificados con
el dispositivo. |
| -lsattr |
Muestra los nombres de atributos, valores actuales, descripciones
y valores de distintivos configurables por el usuario de una vía de acceso específica. |
| -dev Nombre |
Especifica el nombre del dispositivo lógico del dispositivo de destino
cuya información de vía de acceso va a mostrarse. |
| -field Nombres_campos |
Especifica la lista de campos a mostrar. Los siguientes
campos están soportados:
- status
- Estado de la vía
- name
- Nombre del dispositivo
- parent
- Nombre del dispositivo padre
- conn
- Conexión de la vía de acceso.
|
| -fmt Delimitador |
Especifica un carácter delimitador para separar los campos de la salida. |
| -pdev Padre |
Indica el nombre de dispositivo lógico del dispositivo padre
de la o las vías a mostrar. |
| -range |
Muestra los valores legales de un nombre de atributo. El distintivo -range lista los valores de atributos en una columna
vertical como se muestra a continuación:
Valor1
Valor2
.
.
ValorN
El distintivo -range muestra los valores de los atributos
de rango x...n(+i) donde x es el inicio del rango, n es el final e i
es el incremento. |
| -status Estado |
El distintivo -status Estado indica el estado a utilizar a la hora de calificar las vías de acceso que se van
a mostrar. Al mostrar la información de la vía de acceso, los valores permitidos
de este distintivo son:
- enabled
- Muestra vías de acceso enabled (habilitadas) para la selección
de vías de acceso MPIO.
- disabled
- Muestra vías de acceso disabled (inhabilitadas) para la selección
de vías de acceso MPIO.
- failed
- Muestra las vías de acceso failed (anómalas) debido a errores de E/S.
- available
- Muestra las vías de acceso cuyo path_status sea PATH_AVAILABLE (es decir, vías de acceso que estén configuradas en el sistema, incluye aquellas
vías de acceso en estado enabled, disabled y failed).
- defined
- Muestra las vías de acceso cuyo path_status sea PATH_DEFINED.
- missing
- Muestra las vías de acceso cuyo path_status sea PATH_MISSING.
|
| -conn Conexión |
Indica la información de conexión a utilizar a la hora de calificar
las vías de acceso que se van a mostrar. |
Estado de salida
| Código de retorno |
Descripción |
| 1 |
Valor de estado no válido. |
Ejemplos
- Para mostrar, son encabezados de columnas, el conjunto de vías de acceso cuyo estado operativo está inhabilitado,
entre:
lspath -status disabled
El sistema mostrará un mensaje
similar al siguiente:
disabled hdisk1 scsi1
disabled hdisk2 scsi1
disabled hdisk23 scsi8
disabled hdisk25 scsi8
- Para mostrar el conjunto de vías de acceso cuyo estado operativo es anómalo, entre:
lspath -status failed
El sistema mostrará un mensaje
similar al siguiente:
failed hdisk1 scsi1
failed hdisk2 scsi1
failed hdisk23 scsi8
failed hdisk25 scsi8
- Si el dispositivo de destino es un disco SCSI, para mostrar todos los atributos de la vía de acceso
al padre scsi0 en la conexión 5,0, utilice el mandato:
lspath -dev hdisk10 -pdev scsi0 -conn "5,0" -lsattr
El sistema mostrará un mensaje similar al siguiente:
weight 1 Order of path failover selection true
Información relacionada
El mandato lsmap, el mandato mkpath, el mandato chpath y el mandato rmpath.