From 07d51d6e5ef74bf1d369976ad3f705f3d89f9071 Mon Sep 17 00:00:00 2001
From: immarvin <yangsbj@cn.ibm.com>
Date: Thu, 17 Jul 2014 08:03:58 -0700
Subject: [PATCH] add comment for servicemap subroutine

---
 perl-xCAT/xCAT/Utils.pm     | 7 +++++++
 xCAT/postscripts/xcatlib.sh | 5 +++++
 2 files changed, 12 insertions(+)

diff --git a/perl-xCAT/xCAT/Utils.pm b/perl-xCAT/xCAT/Utils.pm
index 8d75343d4..1180656e2 100644
--- a/perl-xCAT/xCAT/Utils.pm
+++ b/perl-xCAT/xCAT/Utils.pm
@@ -3605,6 +3605,13 @@ sub servicemap{
   #"service manager name(SYSVinit/systemd) $svcmgrtype" 
   #=> ["list of possible service file names for the specified $svcname under the specified $svcmgrtype "]
   # }
+  #
+  #
+  # if there are more than 1 possible service names for a service among 
+  # different os distributions and os releases, the service should be 
+  # specified in %svchash with structure 
+  # (general service name) => {list of possible service names}
+  #
   my %svchash=(
      "dhcp"  =>    ["dhcp3-server","dhcpd","isc-dhcp-server"],
      "nfs"   =>    ["nfsserver","nfs-server","nfs","nfs-kernel-server"],
diff --git a/xCAT/postscripts/xcatlib.sh b/xCAT/postscripts/xcatlib.sh
index 65b8984db..ff17a7b6d 100644
--- a/xCAT/postscripts/xcatlib.sh
+++ b/xCAT/postscripts/xcatlib.sh
@@ -273,6 +273,11 @@ function servicemap {
    local svcmgrtype=$2
    local svclistname=   
 
+  # if there are more than 1 possible service names for a service among 
+  # different os distributions and os releases, the service should be 
+  # specified with structure 
+  # INIT_(general service name) = "list of possible service names"
+  #  
    INIT_dhcp="dhcp3-server dhcpd isc-dhcp-server";
 
    INIT_nfs="nfsserver nfs-server nfs nfs-kernel-server";