=head1 NAME

B<lshwconn> - Use this command to display the connection status for CEC, Frame and Firebird nodes.

=head1 SYNOPSIS

B<lshwconn> [B<-h>| B<--help>]

B<lshwconn> [B<-v>| B<--version>]

=head2 PPC (with HMC) specific:

B<lshwconn> [B<-V>| B<--verbose>] I<noderange>

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

B<lshwconn> I<noderange> B<-T> I<tooltype>

=head1 DESCRIPTION

This command is used to display the connection status for CEC, Frame and Firebird nodes. 

=head1 OPTIONS

=over 5

=item B<-h|--help>

Display usage message.

=item B<-V|--verbose>

Verbose output.

=item B<-T>

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

=back


=head1 RETURN VALUE

0 The command completed successfully.

1 An error has occurred.

=head1 EXAMPLES

=over 3

=item 1.

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

 lshwconn cec

Output is similar to:

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

=item 2.

To display connection status for Frame node frame1:

 lshwconn frame1

Output is similar to:

 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

=item 3.

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

 lshwconn cec -T lpar

Output is similar to:

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

To display connection status for Fireblades to hardware server:

 lshwconn blade

Output is similar to:

 blade01: sp=primary,ipadd=70.0.0.21,alt_ipadd=unavailable,state=LINE UP
 blade02: sp=primary,ipadd=70.0.0.22,alt_ipadd=unavailable,state=LINE UP

=back


=head1 FILES

$XCATROOT/bin/lshwconn

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

=head1 NOTES

This command is part of the xCAT software product.


=head1 SEE ALSO

L<rmhwconn(1)|rmhwconn.1>, L<mkhwconn(1)|mkhwconn.1>