[netcf-devel] [PATCH 2/3] * src/dutil_linux.h (aug_get_mac): more extensive comment

David Lutterkort lutter at redhat.com
Fri Sep 4 23:27:15 UTC 2009


---
 src/dutil_linux.h |   11 +++++++++--
 1 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/dutil_linux.h b/src/dutil_linux.h
index 085c2f9..af76c3e 100644
--- a/src/dutil_linux.h
+++ b/src/dutil_linux.h
@@ -26,8 +26,15 @@
 /* Returns a list of all interfaces with MAC address MAC */
 int aug_match_mac(struct netcf *ncf, const char *mac, char ***matches);
 
-/* Get the MAC address of the interface INTF */
-int aug_get_mac(struct netcf *ncf, const char *intf, const char **mac);
+/* Get the MAC address of the interface NAME
+ *
+ * Returns 1 if the MAC for NAME was found, 0 if none was found, and a
+ * negative value on error. MAC is only set to a non-NULL value when the
+ * MAC for NAME was found; in all other cases it is set to NULL. The
+ * returned MAC address will be all lowercase.
+ */
+int aug_get_mac(struct netcf *ncf, const char *name, const char **mac);
+
 
 /* Add an 'alias NAME bonding' to an appropriate file in /etc/modprobe.d,
  * if none exists yet. If we need to create a new one, it goes into the
-- 
1.6.2.5



More information about the netcf-devel mailing list