
##########
lshwconn.1
##########

.. highlight:: perl


****
NAME
****


\ **lshwconn**\  - Use this command to display the connection status for CEC and Frame nodes.


********
SYNOPSIS
********


\ **lshwconn**\  [\ **-h**\ | \ **-**\ **-help**\ ]

\ **lshwconn**\  [\ **-v**\ | \ **-**\ **-version**\ ]

PPC (with HMC) specific:
========================


\ **lshwconn**\  [\ **-V**\ | \ **-**\ **-verbose**\ ] \ *noderange*\


PPC (without HMC, using FSPAPI) specific:
=========================================


\ **lshwconn**\  \ *noderange*\  \ **-T**\  \ *tooltype*\



***********
DESCRIPTION
***********


This command is used to display the connection status for CEC and Frame node.


*******
OPTIONS
*******



\ **-h|-**\ **-help**\

 Display usage message.



\ **-V|-**\ **-verbose**\

 Verbose output.



\ **-T**\

 The tooltype is used to communicate to the CEC/Frame. The value could be lpar or fnm. The tooltype value lpar is for xCAT and fnm is for CNM.




************
RETURN VALUE
************


0 The command completed successfully.

1 An error has occurred.


********
EXAMPLES
********



1.

 To display connection status for all CEC nodes in node group CEC:


 .. code-block:: perl

   lshwconn cec


 Output is similar to:


 .. code-block:: perl

   cec1: ipaddr=192.168.200.245,alt_ipaddr=unavailable,state=Connected
   cec2: Connection not found




2.

 To display connection status for Frame node frame1:


 .. code-block:: perl

   lshwconn frame1


 Output is similar to:


 .. code-block:: perl

   frame1: side=a,ipaddr=192.168.200.247,alt_ipaddr=unavailable,state=Connected
   frame1: side=b,ipaddr=192.168.200.248,alt_ipaddr=unavailable,state=Connected




3.

 To display connection status for all CEC nodes in node group CEC to hardware server, and using lpar tooltype:


 .. code-block:: perl

   lshwconn cec -T lpar


 Output is similar to:


 .. code-block:: perl

   cec1: sp=primary,ipadd=40.3.7.1,alt_ipadd=unavailable,state=LINE UP
   cec2: Connection not found





*****
FILES
*****


$XCATROOT/bin/lshwconn

(The XCATROOT environment variable is set when xCAT is installed. The
default value is "/opt/xcat".)


*****
NOTES
*****


This command is part of the xCAT software product.


********
SEE ALSO
********


rmhwconn(1)|rmhwconn.1, mkhwconn(1)|mkhwconn.1

