=head1 NAME

B<bmcdiscover> - Discover Baseboard Management Controllers (BMCs) using a scan method

=head1 SYNOPSIS

B<bmcdiscover> [B<-?>|B<-h>|B<--help>]

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

B<bmcdiscover> [B<-s> I<scan_method>] [B<-u> I<bmc_user>] [B<-p> I<bmc_passwd>] [B<-z>] [B<-w>] B<--range> I<ip_ranges>

B<bmcdiscover> B<-u> I<bmc_user> B<-p> I<bmc_passwd> B<-i> I<bmc_ip> B<--check>

B<bmcdiscover> [B<-u> I<bmc_user>] [B<-p> I<bmc_passwd>] B<-i> I<bmc_ip> B<--ipsource> 


=head1 DESCRIPTION

The B<bmcdiscover> command will discover Baseboard Management Controllers (BMCs) using a scan mathod.  

The command uses B<nmap> to scan active nodes over a specified IP range.  The IP range format should be a format that is acceptable by B<nmap>. 

The B<bmcdiscover> command can also obtain some information about the BMC. (Check username/password, IP address source, DHCP/static configuration)

Note: The scan method currently support is B<nmap>. 

=head1 OPTIONS

=over 10

=item B<--range>       

Specify one or more IP ranges acceptable to nmap.  IP rance can be hostnames, IP addresses, networks, etc.  A single IP address (10.1.2.3) or an IP range (10.1.2.0/24) can be specified.  If the range is very large, the B<bmcdiscover> command may take a long time to return. 

=item B<-s>            

Scan method  (The only supported scan method at this time is B<nmap>)

=item B<-z>            

List the data returned in xCAT stanza format

=item B<-w>            

Write to the xCAT database.

=item B<-i|--bmcip>    

BMC IP address.

=item B<-u|--bmcuser>  

BMC user name.

=item B<-p|--bmcpasswd>   

BMC user password.

=item B<--check>    

Check BMC administrator User/Password.

=item B<--ipsource>    

Display the BMC IP configuration.

=item B<-h|--help>

Display usage message

=item B<-v|--version>

Display version information

=back

=head1 RETURN VALUE

0  The command completed successfully.

1  An error has occurred.

=head1 EXAMPLES


1. To get all responding BMCs from IP range "10.4.23.100-254" and 50.3.15.1-2":

    bmcdiscover -s nmap --range "10.4.23.100-254 50.3.15.1-2"

Note: Input for IP range can be in the form: scanme.nmap.org, microsoft.com/24, 192.168.0.1; 10.0.0-255.1-254.

2. To get all BMSs in IP range "10.4.22-23.100-254", displayed in xCAT stanza format:

    bmcdiscover -s nmap --range "10.4.22-23.100-254" -z

3. Discover the BMCs and write the discovered-node definitions into the xCAT database and write out the stanza foramt to the console:

    bmcdiscover -s nmap --range "10.4.22-23.100-254" -w -z 

4. To check if the username or password is correct against the BMC:

    bmcdiscover -i 10.4.23.254 -u USERID -p PASSW0RD --check

5. Get BMC IP Address source, DHCP Address or static Address

    bmcdiscover -i 10.4.23.254 -u USERID -p PASSW0RD --ipsource

=head1 SEE ALSO

L<lsslp(1)|lsslp.1>
