=head1 NAME

B<getmacs> - Collects node MAC address.

=head1 SYNOPSIS

=head2 Common:

B<getmacs> [B<-h>| B<--help> | B<-v>| B<--version>]

=head2 PPC specific:

B<getmacs> I<noderange> [B<-F> I<filter>]

B<getmacs> I<noderange> [B<-V>| B<--verbose>] [B<-f>] [B<-d>] [B<--arp>] | [B<-D> [B<-S> I<server>] [B<-G> I<gateway>] [B<-C> I<client>] [B<--hfi>] [B<-o>]]

=head2 blade specific:

B<getmacs> I<noderange> [B<-V>| B<--verbose>] [B<-d>] [B<--arp>]

=head1 DESCRIPTION

The getmacs command collects MAC address from a single or range of nodes.
Note that on AIX systems, the returned MAC address is not colon-seperated (for example 8ee2245cf004), while on Linux systems the MAC address is colon-seperated (for example 8e:e2:24:5c:f0:04).
If no ping test performed,  getmacs writes the first adapter MAC to the xCAT database.  If ping test performed, getmacs will write the first successfully pinged MAC to xCAT database.

For PPC (without HMC, using Direct FSP Management) specific:

If users run "B<getmacs> I<noderange>" directly for P7 IH LPARs, it will return the HIF MAC addresses which are owned by the LPARs. If run B<getmacs> with ping test by default, it will return the physical mac address. If run getmacs with ping test using B<--hfi>, it will return the HFI MAC address.

Note: If network adapters are physically assigned to LPARs, getmacs cannot read the MAC addresses unless perform ping test, since there is no HMC command to read them and getmacs has to login to open formware. And if the LPARs has never been activated before, getmacs need to be performed with the option "B<-D>" to get theirs MAC addresses.

=head1 OPTIONS

B<--arp>          

Read MAC address with ARP protocal.

B<-C>          

Specify the IP address of the partition for ping test. The default is to read from xCAT database if no B<-C> specified. 

B<-d>          

Display MAC only. The default is to write the first valid adapter MAC to the xCAT database.

B<-D>          

Perform ping test.  Please be aware that in this way, the lpars will be reset.

B<-f>          

Force immediate shutdown of the partition.

B<-F>          

Specify filters to select the correct adapter.  Acceptable filters are Type, MAC_Address, Phys_Port_Loc, Adapter, Port_Group, Phys_Port, Logical_Port, VLan, VSwitch, Curr_Conn_Speed.

B<-G>          

Gateway IP address of the partition.  The default is to read from xCAT database if no B<-G> specified.

B<-h>          

Display usage message.

B<--hfi>       

Read HFI MAC address.  This option mush be used with [B<-D>] option to perform ping test.

B<-o>          

Read MAC address when the lpar is in openfirmware state.  This option mush be used with [B<-D>] option to perform ping test. Before use B<-o>, the lpar must be in openfirmware state.

B<-S>          

The IP address of the machine to ping.  The default is to read from xCAT databse if no B<-S> specified.

B<-v>          

Command Version.

B<-V>         

Verbose output.


=head1 RETURN VALUE

  0 The command completed successfully.

  1 An error has occurred.


=head1 EXAMPLES

1. To retrieve the MAC address for the HMC-managed partition lpar4 and write the first valid adapter MAC to the xCAT database, enter:
 
 getmacs lpar4

Output is similar to:

 lpar4:
 #Type  MAC_Address  Phys_Port_Loc  Adapter  Port_Group  Phys_Port  Logical_Port  VLan  VSwitch  Curr_Conn_Speed
 hea  7607DFB07F02  N/A  N/A  N/A  N/A  N/A  1  ETHERNET0  N/A
 ent U78A1.001.99203B5-P1-T6   00145eb55788 /lhea@23c00614/ethernet@23e00514 unsuccessful physical


2. To retrieve the MAC address with ARP protocal:

 getmacs lpar4 --arp

Output is similar to:

 lpar4:
 #IP           MAC_Address
 192.168.0.10  00145eb55788


3. To retrieve the MAC address for the HMC-managed partition lpar4 and display the result only, enter:

 getmacs lpar4 -d

Output is similar to:

 lpar4:
 #Type  MAC_Address  Phys_Port_Loc  Adapter  Port_Group  Phys_Port  Logical_Port  VLan  VSwitch  Curr_Conn_Speed
 hea  7607DFB07F02  N/A  N/A  N/A  N/A  N/A  1  ETHERNET0  N/A
 ent U78A1.001.99203B5-P1-T6   00145eb55788 /lhea@23c00614/ethernet@23e00514 unsuccessful physical



4. To retrieve the MAC address for the HMC-managed partition lpar4 with filter Type=hea,VSwitch=ETHERNET0.

 getmacs lpar4 -F Type=hea,VSwitch=ETHERNET0

Output is similar to:

 lpar4:
 #Type  MAC_Address  Phys_Port_Loc  Adapter  Port_Group  Phys_Port  Logical_Port  VLan  VSwitch  Curr_Conn_Speed
 hea  7607DFB07F02  N/A  N/A  N/A  N/A  N/A  1  ETHERNET0  N/A



5. To retrieve the MAC address while performing a ping test for the HMC-managed partition lpar4 and display the result only, enter:

 getmacs lpar4 -d -D -S 9.3.6.49 -G 9.3.6.1 -C 9.3.6.234

Output is similar to:

 lpar4:
 #Type  Location Code   MAC Address      Full Path Name  Ping Result
 ent U9133.55A.10B7D1G-V12-C4-T1 8e:e2:24:5c:f0:04 /vdevice/l-lan@30000004 successful virtual

6. To retrieve the MAC address for P7 IH LPARl using Direct FSP Management without ping test and display the result only, enter:

 getmacs c250f07c04ap01 -d

Output is similar to:

 c250f07c04ap01:
 #Type  Phys_Port_Loc  MAC_Address  Adapter  Port_Group  Phys_Port  Logical_Port  VLan  VSwitch  Curr_Conn_Speed
 HFI  N/A  02:00:02:00:00:04:|02:00:02:00:00:05:|02:00:02:00:00:06  N/A  N/A  N/A  N/A  N/A  N/A  N/A

7.  To retrieve the HFI MAC address for P7 IH LPARl using Direct FSP Management ping test and display the result only, enter:

 getmacs c250f07c07ap01 -d -D --hfi

Output is similar to:

 c250f07c07ap01:
 # Type  Location Code   MAC Address      Full Path Name  Ping Result
 hfi-ent U78A9.001.0123456-P1 020004200004 /hfi-iohub@300000000000000/hfi-ethernet@0 unsuccessful physical
 hfi-ent U78A9.001.0123456-P1 020004200004 /hfi-iohub@300000000000000/hfi-ethernet@1 unsuccessful physical

=head1 FILES

/opt/xcat/bin/getmacs


=head1 SEE ALSO

L<makedhcp(8)|makedhcp.8>






