=head1 NAME

B<getmacs> - Collects node MAC address.

=head1 SYNOPSIS

I<getmacs [-h| --help]>

I<getmacs [-v| --version]>

I<getmacs noderange> [-F filter]

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


=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.

=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 -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 notified 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 -G specified.

B<-h>          Display usage message.

B<-S>          The IP address of the machine to ping.  The default is to read from xCAT databse if no -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:

I<getmacs lpar4>

Output is similar to:

# Type     MAC_Address  Phys_Port_Loc  Adapter  Port_Group  Phys_Port  Logical_Port  VLan  VSwitch  Curr_Conn_Speed

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:

I<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:

I<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.

I<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:

I<getmacs lpar4 -d -D -S 9.3.6.49 -G 9.3.6.1 -C 9.3.6.234>

#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

=head1 FILES

/opt/xcat/bin/getmacs


=head1 SEE ALSO

L<makedhcp(8)|makedhcp.8>