From d0e4dd519180bfde2432e3d17bfb223cce5de5e3 Mon Sep 17 00:00:00 2001
From: sakolish <sakolish@8638fb3e-16cb-4fca-ae20-7b5d299a9bcd>
Date: Wed, 13 Feb 2008 13:54:06 +0000
Subject: [PATCH] Initial draft

git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@459 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
---
 xCAT-client-2.0/pods/man1/getmacs.1.pod | 92 +++++++++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 xCAT-client-2.0/pods/man1/getmacs.1.pod

diff --git a/xCAT-client-2.0/pods/man1/getmacs.1.pod b/xCAT-client-2.0/pods/man1/getmacs.1.pod
new file mode 100644
index 000000000..ce5e1a867
--- /dev/null
+++ b/xCAT-client-2.0/pods/man1/getmacs.1.pod
@@ -0,0 +1,92 @@
+=head1 NAME
+ 
+B<getmacs> - Collects node MAC address.  
+ 
+=head1 SYNOPSIS
+ 
+I<getmacs [-h| --help]>
+
+I<getmacs [-v| --version]>
+
+I<getmacs [-V| --verbose] noderange> [-c][-S server -G gateway -C client] 
+
+
+=head1 DESCRIPTION
+
+The getmacs command collects MAC address from a single or range of nodes.
+
+=head1 OPTIONS
+
+B<-c>          Colon seperated output.
+
+B<-C>          IP address 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, enter: 
+
+I<getmacs lpar4> 
+
+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
+
+
+
+2. To retrieve the MAC address for the HMC-managed partition lpar4 and display trhe result in colon-seperated format, enter: 
+
+I<getmacs lpar4 -c> 
+
+Output is similar to:
+
+lpar4: 
+
+#Type:Location_Code:MAC_Address:Full_Path_Name:Ping_Result:Device_Type:Size_MB:OS:OS_Version:
+
+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 in colon-seperated format, enter: 
+
+I<getmacs lpar4 -c -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:Device_Type:Size_MB:OS:OS_Version:
+
+ent:U9133.55A.10B7D1G-V12-C4-T1:8ee2245cf004:/vdevice/l-lan@30000004:successful:virtual::::
+
+=head1 FILES
+ 
+/opt/xcat/bin/getmac
+
+
+=head1 NOTES
+
+This command is part of the xCAT software product.
+
+
+ 
+
+