=head1 NAME B - Collects node MAC address. =head1 SYNOPSIS I I I [-f][-d][-S server -G gateway -C client] =head1 DESCRIPTION The getmacs command collects MAC address from a single or range of nodes. Note than 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). =head1 OPTIONS B<-C> IP address of the partition. B<-d> Display MAC only. The default is to write the first adapter MAC to the xCAT database. B<-f> Force immediate shutdown of the partition. B<-G> Gateway IP address of the partition specified with the -C option. B<-h> Display usage message. B<-S> The IP address of the machine to ping. 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 adapter MAC to the xCAT database, enter: I 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 virtual 2. To retrieve the MAC address for the HMC-managed partition lpar4 and display the result only, enter: I Output is similar to: lpar4: #Type Location Code MAC Address Full Path Name Ping Result ent U9133.55A.10B7D1G-V12-C4-T1 8ee2245cf004 /vdevice/l-lan@30000004 virtual 3. To retrieve the MAC address while performing a ping test for the HMC-managed partition lpar4 and display the result only, enter: I #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/getmac =head1 NOTES This command is part of the xCAT software product.