1064a68cb2df87330818c2de09d2f54eda7bcb78
4 * This file is a library of computational functions for RackTables.
9 $loclist[1] = 'interior';
11 $loclist['front'] = 0;
12 $loclist['interior'] = 1;
14 $template[0] = array (TRUE, TRUE, TRUE);
15 $template[1] = array (TRUE, TRUE, FALSE);
16 $template[2] = array (FALSE, TRUE, TRUE);
17 $template[3] = array (TRUE, FALSE, FALSE);
18 $template[4] = array (FALSE, TRUE, FALSE);
19 $template[5] = array (FALSE, FALSE, TRUE);
20 $templateWidth[0] = 3;
21 $templateWidth[1] = 2;
22 $templateWidth[2] = 2;
23 $templateWidth[3] = 1;
24 $templateWidth[4] = 1;
25 $templateWidth[5] = 1;
27 // Objects of some types should be explicitly shown as
28 // anonymous (labelless). This function is a single place where the
29 // decision about displayed name is made.
30 function displayedName ($objectData)
32 if ($objectData['name'] != '')
33 return $objectData['name'];
34 elseif (in_array ($objectData['objtype_id'], explode (',', getConfigVar ('NAMEFUL_OBJTYPES'))))
35 return "ANONYMOUS " . $objectData['objtype_name'];
37 return "[${objectData['objtype_name']}]";
40 // This function finds height of solid rectangle of atoms, which are all
41 // assigned to the same object. Rectangle base is defined by specified
43 function rectHeight ($rackData, $startRow, $template_idx)
46 // The first met object_id is used to match all the folowing IDs.
51 for ($locidx = 0; $locidx < 3; $locidx++
)
53 // At least one value in template is TRUE, but the following block
54 // can meet 'skipped' atoms. Let's ensure we have something after processing
56 if ($template[$template_idx][$locidx])
58 if (isset ($rackData[$startRow - $height][$locidx]['skipped']))
60 if (isset ($rackData[$startRow - $height][$locidx]['rowspan']))
62 if (isset ($rackData[$startRow - $height][$locidx]['colspan']))
64 if ($rackData[$startRow - $height][$locidx]['state'] != 'T')
67 $object_id = $rackData[$startRow - $height][$locidx]['object_id'];
68 if ($object_id != $rackData[$startRow - $height][$locidx]['object_id'])
72 // If the first row can't offer anything, bail out.
73 if ($height == 0 and $object_id == 0)
77 while ($startRow - $height > 0);
78 # echo "for startRow==${startRow} and template==(" . ($template[$template_idx][0] ? 'T' : 'F');
79 # echo ', ' . ($template[$template_idx][1] ? 'T' : 'F') . ', ' . ($template[$template_idx][2] ? 'T' : 'F');
80 # echo ") height==${height}<br>\n";
84 // This function marks atoms to be avoided by rectHeight() and assigns rowspan/colspan
86 function markSpan (&$rackData, $startRow, $maxheight, $template_idx)
88 global $template, $templateWidth;
90 for ($height = 0; $height < $maxheight; $height++
)
92 for ($locidx = 0; $locidx < 3; $locidx++
)
94 if ($template[$template_idx][$locidx])
96 // Add colspan/rowspan to the first row met and mark the following ones to skip.
97 // Explicitly show even single-cell spanned atoms, because rectHeight()
98 // is expeciting this data for correct calculation.
100 $rackData[$startRow - $height][$locidx]['skipped'] = TRUE;
103 $colspan = $templateWidth[$template_idx];
105 $rackData[$startRow - $height][$locidx]['colspan'] = $colspan;
107 $rackData[$startRow - $height][$locidx]['rowspan'] = $maxheight;
115 // This function sets rowspan/solspan/skipped atom attributes for renderRack()
116 // What we actually have to do is to find _all_ possible rectangles for each unit
117 // and then select the widest of those with the maximal square.
118 function markAllSpans (&$rackData = NULL)
120 if ($rackData == NULL)
122 showError ('Invalid rackData', __FUNCTION__
);
125 for ($i = $rackData['height']; $i > 0; $i--)
126 while (markBestSpan ($rackData, $i));
129 // Calculate height of 6 possible span templates (array is presorted by width
130 // descending) and mark the best (if any).
131 function markBestSpan (&$rackData, $i)
133 global $template, $templateWidth;
134 for ($j = 0; $j < 6; $j++
)
136 $height[$j] = rectHeight ($rackData, $i, $j);
137 $square[$j] = $height[$j] * $templateWidth[$j];
139 // find the widest rectangle of those with maximal height
140 $maxsquare = max ($square);
143 $best_template_index = 0;
144 for ($j = 0; $j < 6; $j++
)
145 if ($square[$j] == $maxsquare)
147 $best_template_index = $j;
148 $bestheight = $height[$j];
151 // distribute span marks
152 markSpan ($rackData, $i, $bestheight, $best_template_index);
156 function delRow ($row_id = 0)
160 showError ('Not all required args are present.', __FUNCTION__
);
163 if (!isset ($_REQUEST['confirmed']) ||
$_REQUEST['confirmed'] != 'true')
165 echo "Press <a href='?op=del_row&row_id=${row_id}&confirmed=true'>here</a> to confirm rack row deletion.";
169 echo 'Deleting rack row information: ';
170 $result = $dbxlink->query ("update RackRow set deleted = 'yes' where id=${row_id} limit 1");
171 if ($result->rowCount() != 1)
173 showError ('Marked ' . $result.rowCount() . ' rows as deleted, but expected 1', __FUNCTION__
);
177 recordHistory ('RackRow', "id = ${row_id}");
178 echo "Information was deleted. You may return to <a href='?op=list_rows&editmode=on'>rack row list</a>.";
181 function delRack ($rack_id = 0)
185 showError ('Not all required args are present.', __FUNCTION__
);
188 if (!isset ($_REQUEST['confirmed']) ||
$_REQUEST['confirmed'] != 'true')
190 echo "Press <a href='?op=del_rack&rack_id=${rack_id}&confirmed=true'>here</a> to confirm rack deletion.";
194 echo 'Deleting rack information: ';
195 $result = $dbxlink->query ("update Rack set deleted = 'yes' where id=${rack_id} limit 1");
196 if ($result->rowCount() != 1)
198 showError ('Marked ' . $result.rowCount() . ' rows as deleted, but expected 1', __FUNCTION__
);
202 recordHistory ('Rack', "id = ${rack_id}");
203 echo "Information was deleted. You may return to <a href='?op=list_racks&editmode=on'>rack list</a>.";
206 function delObject ($object_id = 0)
210 showError ('Not all required args are present.', __FUNCTION__
);
213 if (!isset ($_REQUEST['confirmed']) ||
$_REQUEST['confirmed'] != 'true')
215 echo "Press <a href='?op=del_object&object_id=${object_id}&confirmed=true'>here</a> to confirm object deletion.";
219 echo 'Deleting object information: ';
220 $result = $dbxlink->query ("update RackObject set deleted = 'yes' where id=${object_id} limit 1");
221 if ($result->rowCount() != 1)
223 showError ('Marked ' . $result.rowCount() . ' rows as deleted, but expected 1', __FUNCTION__
);
227 recordHistory ('RackObject', "id = ${object_id}");
228 echo "Information was deleted. You may return to <a href='?op=list_objects&editmode=on'>object list</a>.";
231 // We can mount 'F' atoms and unmount our own 'T' atoms.
232 function applyObjectMountMask (&$rackData, $object_id)
234 for ($unit_no = $rackData['height']; $unit_no > 0; $unit_no--)
235 for ($locidx = 0; $locidx < 3; $locidx++
)
236 switch ($rackData[$unit_no][$locidx]['state'])
239 $rackData[$unit_no][$locidx]['enabled'] = TRUE;
242 $rackData[$unit_no][$locidx]['enabled'] = ($rackData[$unit_no][$locidx]['object_id'] == $object_id);
245 $rackData[$unit_no][$locidx]['enabled'] = FALSE;
249 // Design change means transition between 'F' and 'A' and back.
250 function applyRackDesignMask (&$rackData)
252 for ($unit_no = $rackData['height']; $unit_no > 0; $unit_no--)
253 for ($locidx = 0; $locidx < 3; $locidx++
)
254 switch ($rackData[$unit_no][$locidx]['state'])
258 $rackData[$unit_no][$locidx]['enabled'] = TRUE;
261 $rackData[$unit_no][$locidx]['enabled'] = FALSE;
265 // The same for 'F' and 'U'.
266 function applyRackProblemMask (&$rackData)
268 for ($unit_no = $rackData['height']; $unit_no > 0; $unit_no--)
269 for ($locidx = 0; $locidx < 3; $locidx++
)
270 switch ($rackData[$unit_no][$locidx]['state'])
274 $rackData[$unit_no][$locidx]['enabled'] = TRUE;
277 $rackData[$unit_no][$locidx]['enabled'] = FALSE;
281 // This mask should allow toggling 'T' and 'W' on object's rackspace.
282 function applyObjectProblemMask (&$rackData)
284 for ($unit_no = $rackData['height']; $unit_no > 0; $unit_no--)
285 for ($locidx = 0; $locidx < 3; $locidx++
)
286 switch ($rackData[$unit_no][$locidx]['state'])
290 $rackData[$unit_no][$locidx]['enabled'] = ($rackData[$unit_no][$locidx]['object_id'] == $object_id);
293 $rackData[$unit_no][$locidx]['enabled'] = FALSE;
297 // This function highlights specified object (and removes previous highlight).
298 function highlightObject (&$rackData, $object_id)
300 for ($unit_no = $rackData['height']; $unit_no > 0; $unit_no--)
301 for ($locidx = 0; $locidx < 3; $locidx++
)
304 $rackData[$unit_no][$locidx]['state'] == 'T' and
305 $rackData[$unit_no][$locidx]['object_id'] == $object_id
307 $rackData[$unit_no][$locidx]['hl'] = 'h';
309 unset ($rackData[$unit_no][$locidx]['hl']);
312 // This function marks atoms to selected or not depending on their current state.
313 function markupAtomGrid (&$data, $checked_state)
315 for ($unit_no = $data['height']; $unit_no > 0; $unit_no--)
316 for ($locidx = 0; $locidx < 3; $locidx++
)
318 if (!($data[$unit_no][$locidx]['enabled'] === TRUE))
320 if ($data[$unit_no][$locidx]['state'] == $checked_state)
321 $data[$unit_no][$locidx]['checked'] = ' checked';
323 $data[$unit_no][$locidx]['checked'] = '';
327 // This function is almost a clone of processGridForm(), but doesn't save anything to database
328 // Return value is the changed rack data.
329 // Here we assume that correct filter has already been applied, so we just
330 // set or unset checkbox inputs w/o changing atom state.
331 function mergeGridFormToRack (&$rackData)
333 $rack_id = $rackData['id'];
334 for ($unit_no = $rackData['height']; $unit_no > 0; $unit_no--)
335 for ($locidx = 0; $locidx < 3; $locidx++
)
337 if ($rackData[$unit_no][$locidx]['enabled'] != TRUE)
339 $inputname = "atom_${rack_id}_${unit_no}_${locidx}";
340 if (isset ($_REQUEST[$inputname]) and $_REQUEST[$inputname] == 'on')
341 $rackData[$unit_no][$locidx]['checked'] = ' checked';
343 $rackData[$unit_no][$locidx]['checked'] = '';
347 function binMaskFromDec ($maskL)
350 for ($i=0; $i<$maskL; $i++
)
355 for ($i=$maskL; $i<32; $i++
)
362 function binInvMaskFromDec ($maskL)
365 for ($i=0; $i<$maskL; $i++
)
369 for ($i=$maskL; $i<32; $i++
)
377 function addRange ($range='', $name='', $is_bcast = FALSE, $taglist = array())
379 // $range is in x.x.x.x/x format, split into ip/mask vars
380 $rangeArray = explode('/', $range);
381 if (count ($rangeArray) != 2)
382 return "Invalid IP subnet '${range}'";
383 $ip = $rangeArray[0];
384 $mask = $rangeArray[1];
386 if (empty ($ip) or empty ($mask))
387 return "Invalid IP subnet '${range}'";
389 $maskL = ip2long($mask);
390 if ($ipL == -1 ||
$ipL === FALSE)
391 return 'Bad ip address';
392 if ($mask < 32 && $mask > 0)
396 $maskB = decbin($maskL);
397 if (strlen($maskB)!=32)
401 foreach( str_split ($maskB) as $digit)
414 $binmask = binMaskFromDec($maskL);
415 $ipL = $ipL & $binmask;
419 "id, ip, mask, name ".
423 $result = useSelectBlade ($query);
425 while ($row = $result->fetch (PDO
::FETCH_ASSOC
))
427 $otherip = $row['ip'];
428 $othermask = binMaskFromDec($row['mask']);
429 // echo "checking $otherip & $othermask ".($otherip & $othermask)." == $ipL & $othermask ".($ipL & $othermask)." ".decbin($otherip)." ".decbin($othermask)." ".decbin($otherip & $othermask)." ".decbin($ipL)." ".decbin($othermask)." ".decbin($ipL & $othermask)."\n";
430 // echo "checking $otherip & $binmask ".($otherip & $binmask)." == $ipL & $binmask ".($ipL & $binmask)." ".decbin($otherip)." ".decbin($binmask)." ".decbin($otherip & $binmask)." ".decbin($ipL)." ".decbin($binmask)." ".decbin($ipL & $binmask)."\n";
433 if (($otherip & $othermask) == ($ipL & $othermask))
434 return "This subnet intersects with ".long2ip($row['ip'])."/${row['mask']}";
435 if (($otherip & $binmask) == ($ipL & $binmask))
436 return "This subnet intersects with ".long2ip($row['ip'])."/${row['mask']}";
438 $result->closeCursor();
440 $result = useInsertBlade
445 'ip' => sprintf ('%u', $ipL),
446 'mask' => "'${maskL}'",
447 'name' => "'${name}'"
451 if ($is_bcast and $maskL < 31)
453 $network_addr = long2ip ($ipL);
454 $broadcast_addr = long2ip ($ipL |
binInvMaskFromDec ($maskL));
455 updateAddress ($network_addr, 'network', 'yes');
456 updateAddress ($broadcast_addr, 'broadcast', 'yes');
458 if (!count ($taglist))
460 if (($result = useSelectBlade ('select last_insert_id()')) == NULL)
461 return 'Query #3 failed in ' . __FUNCTION__
;
462 $row = $result->fetch (PDO
::FETCH_NUM
);
465 foreach ($taglist as $tag_id)
471 'target_realm' => "'ipv4net'",
472 'target_id' => $netid,
480 return "Experienced ${errcount} errors adding tags for the network";
483 function getIPRange ($id = 0)
488 "id as IPRanges_id, ".
489 "INET_NTOA(ip) as IPRanges_ip, ".
490 "mask as IPRanges_mask, ".
491 "name as IPRanges_name ".
494 $result = useSelectBlade ($query);
496 $row = $result->fetch (PDO
::FETCH_ASSOC
);
499 $ret['id'] = $row['IPRanges_id'];
500 $ret['ip'] = $row['IPRanges_ip'];
501 $ret['ip_bin'] = ip2long ($row['IPRanges_ip']);
502 $ret['mask_bin'] = binMaskFromDec($row['IPRanges_mask']);
503 $ret['mask_bin_inv'] = binInvMaskFromDec($row['IPRanges_mask']);
504 $ret['name'] = $row['IPRanges_name'];
505 $ret['mask'] = $row['IPRanges_mask'];
506 $ret['addrlist'] = array();
507 $result->closeCursor();
509 // We risk losing some significant bits in an unsigned 32bit integer,
510 // unless it is converted to a string.
511 $db_first = "'" . sprintf ('%u', 0x00000000 +
$ret['ip_bin'] & $ret['mask_bin']) . "'";
512 $db_last = "'" . sprintf ('%u', 0x00000000 +
$ret['ip_bin'] |
($ret['mask_bin_inv'])) . "'";
514 // Don't try to build up the whole structure in a single pass. Request
515 // the list of user comments and reservations and merge allocations in
516 // at a latter point.
518 "select INET_NTOA(ip) as ip, name, reserved from IPAddress " .
519 "where ip between ${db_first} and ${db_last} " .
520 "and (reserved = 'yes' or name != '')";
521 $result = $dbxlink->query ($query);
522 while ($row = $result->fetch (PDO
::FETCH_ASSOC
))
524 $ip_bin = ip2long ($row['ip']);
525 $ret['addrlist'][$ip_bin] = $row;
527 foreach (array ('ip', 'name', 'reserved') as $cname)
528 $tmp[$cname] = $row[$cname];
529 $tmp['references'] = array();
530 $tmp['lbrefs'] = array();
531 $tmp['rsrefs'] = array();
532 $ret['addrlist'][$ip_bin] = $tmp;
534 $result->closeCursor();
538 "select INET_NTOA(ipb.ip) as ip, ro.id as object_id, " .
539 "ro.name as object_name, ipb.name, ipb.type, objtype_id, " .
540 "dict_value as objtype_name from " .
541 "IPBonds as ipb inner join RackObject as ro on ipb.object_id = ro.id " .
542 "left join Dictionary on objtype_id=dict_key natural join Chapter " .
543 "where ip between ${db_first} and ${db_last} " .
544 "and chapter_name = 'RackObjectType'" .
545 "order by ipb.type, object_name";
546 $result = useSelectBlade ($query);
547 while ($row = $result->fetch (PDO
::FETCH_ASSOC
))
549 $ip_bin = ip2long ($row['ip']);
550 if (!isset ($ret['addrlist'][$ip_bin]))
552 $ret['addrlist'][$ip_bin] = array();
553 $ret['addrlist'][$ip_bin]['ip'] = $row['ip'];
554 $ret['addrlist'][$ip_bin]['name'] = '';
555 $ret['addrlist'][$ip_bin]['reserved'] = 'no';
556 $ret['addrlist'][$ip_bin]['references'] = array();
557 $ret['addrlist'][$ip_bin]['lbrefs'] = array();
558 $ret['addrlist'][$ip_bin]['rsrefs'] = array();
561 foreach (array ('object_id', 'type', 'name') as $cname)
562 $tmp[$cname] = $row[$cname];
563 $quasiobject['name'] = $row['object_name'];
564 $quasiobject['objtype_id'] = $row['objtype_id'];
565 $quasiobject['objtype_name'] = $row['objtype_name'];
566 $tmp['object_name'] = displayedName ($quasiobject);
567 $ret['addrlist'][$ip_bin]['references'][] = $tmp;
569 $result->closeCursor();
572 $query = "select vs_id, inet_ntoa(vip) as ip, vport, proto, " .
573 "object_id, objtype_id, ro.name, dict_value as objtype_name from " .
574 "IPVirtualService as vs inner join IPLoadBalancer as lb on vs.id = lb.vs_id " .
575 "inner join RackObject as ro on lb.object_id = ro.id " .
576 "left join Dictionary on objtype_id=dict_key " .
577 "natural join Chapter " .
578 "where vip between ${db_first} and ${db_last} " .
579 "and chapter_name = 'RackObjectType'" .
580 "order by vport, proto, ro.name, object_id";
581 $result = useSelectBlade ($query);
582 while ($row = $result->fetch (PDO
::FETCH_ASSOC
))
584 $ip_bin = ip2long ($row['ip']);
585 if (!isset ($ret['addrlist'][$ip_bin]))
587 $ret['addrlist'][$ip_bin] = array();
588 $ret['addrlist'][$ip_bin]['ip'] = $row['ip'];
589 $ret['addrlist'][$ip_bin]['name'] = '';
590 $ret['addrlist'][$ip_bin]['reserved'] = 'no';
591 $ret['addrlist'][$ip_bin]['references'] = array();
592 $ret['addrlist'][$ip_bin]['lbrefs'] = array();
593 $ret['addrlist'][$ip_bin]['rsrefs'] = array();
595 $tmp = $qbject = array();
596 foreach (array ('object_id', 'vport', 'proto', 'vs_id') as $cname)
597 $tmp[$cname] = $row[$cname];
598 foreach (array ('name', 'objtype_id', 'objtype_name') as $cname)
599 $qobject[$cname] = $row[$cname];
600 $tmp['object_name'] = displayedName ($qobject);
601 $ret['addrlist'][$ip_bin]['lbrefs'][] = $tmp;
603 $result->closeCursor();
606 $query = "select inet_ntoa(rsip) as ip, rsport, rspool_id, rsp.name as rspool_name from " .
607 "IPRealServer as rs inner join IPRSPool as rsp on rs.rspool_id = rsp.id " .
608 "where rsip between ${db_first} and ${db_last} " .
609 "order by ip, rsport, rspool_id";
610 $result = useSelectBlade ($query);
611 while ($row = $result->fetch (PDO
::FETCH_ASSOC
))
613 $ip_bin = ip2long ($row['ip']);
614 if (!isset ($ret['addrlist'][$ip_bin]))
616 $ret['addrlist'][$ip_bin] = array();
617 $ret['addrlist'][$ip_bin]['ip'] = $row['ip'];
618 $ret['addrlist'][$ip_bin]['name'] = '';
619 $ret['addrlist'][$ip_bin]['reserved'] = 'no';
620 $ret['addrlist'][$ip_bin]['references'] = array();
621 $ret['addrlist'][$ip_bin]['lbrefs'] = array();
622 $ret['addrlist'][$ip_bin]['rsrefs'] = array();
625 foreach (array ('rspool_id', 'rsport', 'rspool_name') as $cname)
626 $tmp[$cname] = $row[$cname];
627 $ret['addrlist'][$ip_bin]['rsrefs'][] = $tmp;
633 // Don't require any records in IPAddress, but if there is one,
634 // merge the data between getting allocation list. Collect enough data
635 // to call displayedName() ourselves.
636 function getIPAddress ($ip=0)
639 $ret['bonds'] = array();
640 // FIXME: below two aren't neither filled in with data nor rendered (ticket:23)
641 $ret['outpf'] = array();
642 $ret['inpf'] = array();
643 $ret['vslist'] = array();
644 $ret['rslist'] = array();
647 $ret['reserved'] = 'no';
653 "where ip = INET_ATON('$ip') and (reserved = 'yes' or name != '')";
654 $result = $dbxlink->query ($query);
657 showError ('Query #1 failed', __FUNCTION__
);
660 if ($row = $result->fetch (PDO
::FETCH_ASSOC
))
663 $ret['name'] = $row['name'];
664 $ret['reserved'] = $row['reserved'];
666 $result->closeCursor();
671 "IPBonds.object_id as object_id, ".
672 "IPBonds.name as name, ".
673 "IPBonds.type as type, ".
674 "objtype_id, dict_value as objtype_name, " .
675 "RackObject.name as object_name ".
676 "from IPBonds join RackObject on IPBonds.object_id=RackObject.id ".
677 "left join Dictionary on objtype_id=dict_key natural join Chapter " .
678 "where IPBonds.ip=INET_ATON('$ip') ".
679 "and chapter_name = 'RackObjectType' " .
680 "order by RackObject.id, IPBonds.name";
681 $result = $dbxlink->query ($query);
683 while ($row = $result->fetch (PDO
::FETCH_ASSOC
))
685 $ret['bonds'][$count]['object_id'] = $row['object_id'];
686 $ret['bonds'][$count]['name'] = $row['name'];
687 $ret['bonds'][$count]['type'] = $row['type'];
689 $qo['name'] = $row['object_name'];
690 $qo['objtype_id'] = $row['objtype_id'];
691 $qo['objtype_name'] = $row['objtype_name'];
692 $ret['bonds'][$count]['object_name'] = displayedName ($qo);
696 $result->closeCursor();
699 $query = "select id, vport, proto, name from IPVirtualService where vip = inet_aton('${ip}')";
700 $result = $dbxlink->query ($query);
701 while ($row = $result->fetch (PDO
::FETCH_ASSOC
))
705 $ret['vslist'][] = $new;
707 $result->closeCursor();
710 $query = "select inservice, rsport, IPRSPool.id as pool_id, IPRSPool.name as poolname from " .
711 "IPRealServer inner join IPRSPool on rspool_id = IPRSPool.id " .
712 "where rsip = inet_aton('${ip}')";
713 $result = $dbxlink->query ($query);
714 while ($row = $result->fetch (PDO
::FETCH_ASSOC
))
718 $ret['rslist'][] = $new;
720 $result->closeCursor();
726 function bindIpToObject ($ip='', $object_id=0, $name='', $type='')
730 $range = getRangeByIp($ip);
732 return 'Non-existant ip address. Try adding IP range first';
734 $result = useInsertBlade
739 'ip' => "INET_ATON('$ip')",
740 'object_id' => "'${object_id}'",
741 'name' => "'${name}'",
742 'type' => "'${type}'"
745 return $result ?
'' : 'useInsertBlade() failed in bindIpToObject()';
748 // This function looks up 'has_problems' flag for 'T' atoms
749 // and modifies 'hl' key. May be, this should be better done
750 // in getRackData(). We don't honour 'skipped' key, because
751 // the function is also used for thumb creation.
752 function markupObjectProblems (&$rackData)
754 for ($i = $rackData['height']; $i > 0; $i--)
755 for ($locidx = 0; $locidx < 3; $locidx++
)
756 if ($rackData[$i][$locidx]['state'] == 'T')
758 $object = getObjectInfo ($rackData[$i][$locidx]['object_id']);
759 if ($object['has_problems'] == 'yes')
761 // Object can be already highlighted.
762 if (isset ($rackData[$i][$locidx]['hl']))
763 $rackData[$i][$locidx]['hl'] = $rackData[$i][$locidx]['hl'] . 'w';
765 $rackData[$i][$locidx]['hl'] = 'w';
770 function search_cmpObj ($a, $b)
772 return ($a['score'] > $b['score'] ?
-1 : 1);
775 // This function performs search and then calculates score for each result.
776 // Given previous search results in $objects argument, it adds new results
777 // to the array and updates score for existing results, if it is greater than
779 function mergeSearchResults (&$objects, $terms, $fieldname)
783 "select name, label, asset_no, barcode, ro.id, dict_key as objtype_id, " .
784 "dict_value as objtype_name, asset_no from RackObject as ro inner join Dictionary " .
785 "on objtype_id = dict_key natural join Chapter where chapter_name = 'RackObjectType' and ";
787 foreach (explode (' ', $terms) as $term)
789 if ($count) $query .= ' or ';
790 $query .= "${fieldname} like '%$term%'";
793 $result = useSelectBlade ($query);
794 // FIXME: this dead call was executed 4 times per 1 object search!
795 // $typeList = getObjectTypeList();
796 $clist = array ('id', 'name', 'label', 'asset_no', 'barcode', 'objtype_id', 'objtype_name');
797 while ($row = $result->fetch(PDO
::FETCH_ASSOC
))
799 foreach ($clist as $cname)
800 $object[$cname] = $row[$cname];
801 $object['score'] = 0;
802 $object['dname'] = displayedName ($object);
803 unset ($object['objtype_id']);
804 foreach (explode (' ', $terms) as $term)
805 if (strstr ($object['name'], $term))
806 $object['score'] +
= 1;
807 unset ($object['name']);
808 if (!isset ($objects[$row['id']]))
809 $objects[$row['id']] = $object;
810 elseif ($objects[$row['id']]['score'] < $object['score'])
811 $objects[$row['id']]['score'] = $object['score'];
816 function getObjectSearchResults ($terms)
819 mergeSearchResults ($objects, $terms, 'name');
820 mergeSearchResults ($objects, $terms, 'label');
821 mergeSearchResults ($objects, $terms, 'asset_no');
822 mergeSearchResults ($objects, $terms, 'barcode');
823 if (count ($objects) == 1)
824 usort ($objects, 'search_cmpObj');
828 // This function removes all colons and dots from a string.
829 function l2addressForDatabase ($string)
833 $pieces = explode (':', $string);
834 // This workaround is for SunOS ifconfig.
835 foreach ($pieces as &$byte)
836 if (strlen ($byte) == 1)
838 // And this workaround is for PHP.
840 $string = implode ('', $pieces);
841 $pieces = explode ('.', $string);
842 $string = implode ('', $pieces);
843 $string = strtoupper ($string);
847 function l2addressFromDatabase ($string)
849 switch (strlen ($string))
853 $ret = implode (':', str_split ($string, 2));
862 // The following 2 functions return previous and next rack IDs for
863 // a given rack ID. The order of racks is the same as in renderRackspace()
865 function getPrevIDforRack ($row_id = 0, $rack_id = 0)
867 if ($row_id <= 0 or $rack_id <= 0)
869 showError ('Invalid arguments passed', __FUNCTION__
);
872 $rackList = getRacksForRow ($row_id);
873 doubleLink ($rackList);
874 if (isset ($rackList[$rack_id]['prev_key']))
875 return $rackList[$rack_id]['prev_key'];
879 function getNextIDforRack ($row_id = 0, $rack_id = 0)
881 if ($row_id <= 0 or $rack_id <= 0)
883 showError ('Invalid arguments passed', __FUNCTION__
);
886 $rackList = getRacksForRow ($row_id);
887 doubleLink ($rackList);
888 if (isset ($rackList[$rack_id]['next_key']))
889 return $rackList[$rack_id]['next_key'];
893 // This function finds previous and next array keys for each array key and
894 // modifies its argument accordingly.
895 function doubleLink (&$array)
898 foreach (array_keys ($array) as $key)
902 $array[$key]['prev_key'] = $prev_key;
903 $array[$prev_key]['next_key'] = $key;
909 // After applying usort() to a rack list we will lose original array keys.
910 // This function restores the keys so they are equal to rack IDs.
911 function restoreRackIDs ($racks)
914 foreach ($racks as $rack)
915 $ret[$rack['id']] = $rack;
919 function sortTokenize ($a, $b)
925 $a = ereg_replace('[^a-zA-Z0-9]',' ',$a);
926 $a = ereg_replace('([0-9])([a-zA-Z])','\\1 \\2',$a);
927 $a = ereg_replace('([a-zA-Z])([0-9])','\\1 \\2',$a);
934 $b = ereg_replace('[^a-zA-Z0-9]',' ',$b);
935 $b = ereg_replace('([0-9])([a-zA-Z])','\\1 \\2',$b);
936 $b = ereg_replace('([a-zA-Z])([0-9])','\\1 \\2',$b);
941 $ar = explode(' ', $a);
942 $br = explode(' ', $b);
943 for ($i=0; $i<count($ar) && $i<count($br); $i++
)
946 if (is_numeric($ar[$i]) and is_numeric($br[$i]))
947 $ret = ($ar[$i]==$br[$i])?
0:($ar[$i]<$br[$i]?
-1:1);
949 $ret = strcasecmp($ar[$i], $br[$i]);
960 function sortByName ($a, $b)
962 return sortTokenize($a['name'], $b['name']);
965 function sortRacks ($a, $b)
967 return sortTokenize($a['row_name'] . ': ' . $a['name'], $b['row_name'] . ': ' . $b['name']);
975 function neq ($a, $b)
980 function countRefsOfType ($refs, $type, $eq)
983 foreach ($refs as $ref)
985 if ($eq($ref['type'], $type))
991 function sortEmptyPorts ($a, $b)
993 $objname_cmp = sortTokenize($a['Object_name'], $b['Object_name']);
994 if ($objname_cmp == 0)
996 return sortTokenize($a['Port_name'], $b['Port_name']);
1001 function sortObjectAddressesAndNames ($a, $b)
1003 $objname_cmp = sortTokenize($a['object_name'], $b['object_name']);
1004 if ($objname_cmp == 0)
1006 $name_a = (isset ($a['port_name'])) ?
$a['port_name'] : '';
1007 $name_b = (isset ($b['port_name'])) ?
$b['port_name'] : '';
1008 $objname_cmp = sortTokenize($name_a, $name_b);
1009 if ($objname_cmp == 0)
1010 sortTokenize($a['ip'], $b['ip']);
1011 return $objname_cmp;
1013 return $objname_cmp;
1018 function sortAddresses ($a, $b)
1020 $name_cmp = sortTokenize($a['name'], $b['name']);
1023 return sortTokenize($a['ip'], $b['ip']);
1028 // This function expands port compat list into a matrix.
1029 function buildPortCompatMatrixFromList ($portTypeList, $portCompatList)
1032 // Create type matrix and markup compatible types.
1033 foreach (array_keys ($portTypeList) as $type1)
1034 foreach (array_keys ($portTypeList) as $type2)
1035 $matrix[$type1][$type2] = FALSE;
1036 foreach ($portCompatList as $pair)
1037 $matrix[$pair['type1']][$pair['type2']] = TRUE;
1041 function newPortForwarding($object_id, $localip, $localport, $remoteip, $remoteport, $proto, $description)
1045 $range = getRangeByIp($localip);
1047 return "$localip: Non existant ip";
1049 $range = getRangeByIp($remoteip);
1051 return "$remoteip: Non existant ip";
1053 if ( ($localport <= 0) or ($localport >= 65536) )
1054 return "$localport: invaild port";
1056 if ( ($remoteport <= 0) or ($remoteport >= 65536) )
1057 return "$remoteport: invaild port";
1060 "insert into PortForwarding set object_id='$object_id', localip=INET_ATON('$localip'), remoteip=INET_ATON('$remoteip'), localport='$localport', remoteport='$remoteport', proto='$proto', description='$description'";
1061 $result = $dbxlink->exec ($query);
1066 function deletePortForwarding($object_id, $localip, $localport, $remoteip, $remoteport, $proto)
1071 "delete from PortForwarding where object_id='$object_id' and localip=INET_ATON('$localip') and remoteip=INET_ATON('$remoteip') and localport='$localport' and remoteport='$remoteport' and proto='$proto'";
1072 $result = $dbxlink->exec ($query);
1076 function updatePortForwarding($object_id, $localip, $localport, $remoteip, $remoteport, $proto, $description)
1081 "update PortForwarding set description='$description' where object_id='$object_id' and localip=INET_ATON('$localip') and remoteip=INET_ATON('$remoteip') and localport='$localport' and remoteport='$remoteport' and proto='$proto'";
1082 $result = $dbxlink->exec ($query);
1086 function getObjectForwards($object_id)
1091 $ret['out'] = array();
1092 $ret['in'] = array();
1095 "dict_value as proto, ".
1096 "proto as proto_bin, ".
1097 "INET_NTOA(localip) as localip, ".
1099 "INET_NTOA(remoteip) as remoteip, ".
1101 "ipa1.name as local_addr_name, " .
1102 "ipa2.name as remote_addr_name, " .
1104 "from PortForwarding inner join Dictionary on proto = dict_key natural join Chapter ".
1105 "left join IPAddress as ipa1 on PortForwarding.localip = ipa1.ip " .
1106 "left join IPAddress as ipa2 on PortForwarding.remoteip = ipa2.ip " .
1107 "where object_id='$object_id' and chapter_name = 'Protocols' ".
1108 "order by localip, localport, proto, remoteip, remoteport";
1109 $result2 = $dbxlink->query ($query);
1111 while ($row = $result2->fetch (PDO
::FETCH_ASSOC
))
1113 foreach (array ('proto', 'proto_bin', 'localport', 'localip', 'remoteport', 'remoteip', 'description', 'local_addr_name', 'remote_addr_name') as $cname)
1114 $ret['out'][$count][$cname] = $row[$cname];
1117 $result2->closeCursor();
1121 "dict_value as proto, ".
1122 "proto as proto_bin, ".
1123 "INET_NTOA(localip) as localip, ".
1125 "INET_NTOA(remoteip) as remoteip, ".
1127 "PortForwarding.object_id as object_id, ".
1128 "RackObject.name as object_name, ".
1130 "from ((PortForwarding join IPBonds on remoteip=IPBonds.ip) join RackObject on PortForwarding.object_id=RackObject.id) inner join Dictionary on proto = dict_key natural join Chapter ".
1131 "where IPBonds.object_id='$object_id' and chapter_name = 'Protocols' ".
1132 "order by remoteip, remoteport, proto, localip, localport";
1133 $result3 = $dbxlink->query ($query);
1135 while ($row = $result3->fetch (PDO
::FETCH_ASSOC
))
1137 foreach (array ('proto', 'proto_bin', 'localport', 'localip', 'remoteport', 'remoteip', 'object_id', 'object_name', 'description') as $cname)
1138 $ret['in'][$count][$cname] = $row[$cname];
1141 $result3->closeCursor();
1146 // This function returns an array of single element of object's FQDN attribute,
1147 // if FQDN is set. The next choice is object's common name, if it looks like a
1148 // hostname. Otherwise an array of all 'regular' IP addresses of the
1149 // object is returned (which may appear 0 and more elements long).
1150 function findAllEndpoints ($object_id, $fallback = '')
1152 $values = getAttrValues ($object_id);
1153 foreach ($values as $record)
1154 if ($record['name'] == 'FQDN' && !empty ($record['value']))
1155 return array ($record['value']);
1156 $addresses = getObjectAddresses ($object_id);
1158 foreach ($addresses as $idx => $address)
1159 if ($address['type'] == 'regular')
1160 $regular[] = $address['ip'];
1161 if (!count ($regular) && !empty ($fallback))
1162 return array ($fallback);
1166 // Some records in the dictionary may be written as plain text or as Wiki
1167 // link in the following syntax:
1169 // 2. [[word URL]] // FIXME: this isn't working
1170 // 3. [[word word word | URL]]
1171 // This function parses the line and returns text suitable for either A
1172 // (rendering <A HREF>) or O (for <OPTION>).
1173 function parseWikiLink ($line, $which, $strip_optgroup = FALSE)
1175 if (preg_match ('/^\[\[.+\]\]$/', $line) == 0)
1177 if ($strip_optgroup)
1178 return ereg_replace ('^.+\^', '', $line);
1182 $line = preg_replace ('/^\[\[(.+)\]\]$/', '$1', $line);
1183 $s = explode ('|', $line);
1184 $o_value = trim ($s[0]);
1185 if ($strip_optgroup)
1186 $o_value = ereg_replace ('^.+\^', '', $o_value);
1187 $a_value = trim ($s[1]);
1189 return "<a href='${a_value}'>${o_value}</a>";
1194 function buildVServiceName ($vsinfo = NULL)
1196 if ($vsinfo == NULL)
1198 showError ('NULL argument', __FUNCTION__
);
1201 return $vsinfo['vip'] . ':' . $vsinfo['vport'] . '/' . $vsinfo['proto'];
1204 // rackspace usage for a single rack
1205 // (T + W + U) / (height * 3 - A)
1206 function getRSUforRack ($data = NULL)
1210 showError ('Invalid argument', __FUNCTION__
);
1213 $counter = array ('A' => 0, 'U' => 0, 'T' => 0, 'W' => 0, 'F' => 0);
1214 for ($unit_no = $data['height']; $unit_no > 0; $unit_no--)
1215 for ($locidx = 0; $locidx < 3; $locidx++
)
1216 $counter[$data[$unit_no][$locidx]['state']]++
;
1217 return ($counter['T'] +
$counter['W'] +
$counter['U']) / ($counter['T'] +
$counter['W'] +
$counter['U'] +
$counter['F']);
1221 function getRSUforRackRow ($rowData = NULL)
1223 if ($rowData === NULL)
1225 showError ('Invalid argument', __FUNCTION__
);
1228 if (!count ($rowData))
1230 $counter = array ('A' => 0, 'U' => 0, 'T' => 0, 'W' => 0, 'F' => 0);
1232 foreach (array_keys ($rowData) as $rack_id)
1234 $data = getRackData ($rack_id);
1235 $total_height +
= $data['height'];
1236 for ($unit_no = $data['height']; $unit_no > 0; $unit_no--)
1237 for ($locidx = 0; $locidx < 3; $locidx++
)
1238 $counter[$data[$unit_no][$locidx]['state']]++
;
1240 return ($counter['T'] +
$counter['W'] +
$counter['U']) / ($counter['T'] +
$counter['W'] +
$counter['U'] +
$counter['F']);
1243 function getObjectCount ($rackData)
1246 for ($i = $rackData['height']; $i > 0; $i--)
1247 for ($locidx = 0; $locidx < 3; $locidx++
)
1250 $rackData[$i][$locidx]['state'] == 'T' and
1251 !in_array ($rackData[$i][$locidx]['object_id'], $objects)
1253 $objects[] = $rackData[$i][$locidx]['object_id'];
1254 return count ($objects);
1257 // Perform substitutions and return resulting string
1258 function apply_macros ($macros, $subject)
1261 foreach ($macros as $search => $replace)
1262 $ret = str_replace ($search, $replace, $ret);
1266 // Make sure the string is always wrapped with LF characters
1267 function lf_wrap ($str)
1269 $ret = trim ($str, "\r\n");
1275 // Adopted from Mantis BTS code.
1276 function string_insert_hrefs ($s)
1278 if (getConfigVar ('DETECT_URLS') != 'yes')
1280 # Find any URL in a string and replace it by a clickable link
1281 $s = preg_replace( '/(([[:alpha:]][-+.[:alnum:]]*):\/\/(%[[:digit:]A-Fa-f]{2}|[-_.!~*\';\/?%^\\\\:@&={\|}+$#\(\),\[\][:alnum:]])+)/se',
1282 "'<a href=\"'.rtrim('\\1','.').'\">\\1</a> [<a href=\"'.rtrim('\\1','.').'\" target=\"_blank\">^</a>]'",
1284 $s = preg_replace( '/\b' . email_regex_simple() . '\b/i',
1285 '<a href="mailto:\0">\0</a>',
1291 function email_regex_simple ()
1293 return "(([a-z0-9!#*+\/=?^_{|}~-]+(?:\.[a-z0-9!#*+\/=?^_{|}~-]+)*)" . # recipient
1294 "\@((?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?))"; # @domain
1297 // Parse AUTOPORTS_CONFIG and return a list of generated pairs (port_type, port_name)
1298 // for the requested object_type_id.
1299 function getAutoPorts ($type_id)
1302 $typemap = explode (';', str_replace (' ', '', getConfigVar ('AUTOPORTS_CONFIG')));
1303 foreach ($typemap as $equation)
1305 $tmp = explode ('=', $equation);
1306 if (count ($tmp) != 2)
1308 $objtype_id = $tmp[0];
1309 if ($objtype_id != $type_id)
1311 $portlist = $tmp[1];
1312 foreach (explode ('+', $portlist) as $product)
1314 $tmp = explode ('*', $product);
1315 if (count ($tmp) != 3)
1318 $port_type = $tmp[1];
1320 for ($i = 0; $i < $nports; $i++
)
1321 $ret[] = array ('type' => $port_type, 'name' => @sprintf
($format, $i));
1327 // Find if a particular tag id exists on the tree, then attach the
1328 // given child tag to it. If the parent tag doesn't exist, return FALSE.
1329 function attachChildTag (&$tree, $parent_id, $child_id, $child_info)
1331 foreach ($tree as $tagid => $taginfo)
1333 if ($tagid == $parent_id)
1335 $tree[$tagid]['kids'][$child_id] = $child_info;
1338 elseif (attachChildTag ($tree[$tagid]['kids'], $parent_id, $child_id, $child_info))
1344 // Build a tree from the tag list and return it.
1345 function getTagTree ()
1348 $mytaglist = $taglist;
1350 while (count ($mytaglist) > 0)
1353 foreach ($mytaglist as $tagid => $taginfo)
1355 $taginfo['kids'] = array();
1356 if ($taginfo['parent_id'] == NULL)
1358 $ret[$tagid] = $taginfo;
1360 unset ($mytaglist[$tagid]);
1362 elseif (attachChildTag ($ret, $taginfo['parent_id'], $tagid, $taginfo))
1365 unset ($mytaglist[$tagid]);
1368 if (!$picked) // Only orphaned items on the list.
1374 function serializeTags ($trail)
1378 foreach ($trail as $taginfo)
1380 $ret .= $comma . $taginfo['tag'];
1386 // a helper for getTrailExpansion()
1387 function traceTrail ($tree, $trail)
1389 // For each tag find its path from the root, then combine items
1390 // of all paths and add them to the trail, if they aren't there yet.
1392 foreach ($tree as $taginfo1)
1395 foreach ($trail as $taginfo2)
1396 if ($taginfo1['id'] == $taginfo2['id'])
1401 if (count ($taginfo1['kids']) > 0)
1403 $subsearch = traceTrail ($taginfo1['kids'], $trail);
1404 if (count ($subsearch))
1407 $ret = array_merge ($ret, $subsearch);
1416 // For each tag add all its parent tags onto the list. Don't expect anything
1417 // except user's tags on the trail.
1418 function getTrailExpansion ($trail)
1421 return traceTrail ($tagtree, $trail);
1424 // Return the list of missing implicit tags.
1425 function getImplicitTags ($oldtags)
1428 $newtags = getTrailExpansion ($oldtags);
1429 foreach ($newtags as $newtag)
1431 $already_exists = FALSE;
1432 foreach ($oldtags as $oldtag)
1433 if ($newtag['id'] == $oldtag['id'])
1435 $already_exists = TRUE;
1438 if ($already_exists)
1440 $ret[] = array ('id' => $newtag['id'], 'tag' => $newtag['tag'], 'parent_id' => $newtag['parent_id']);
1445 // Minimize the trail: exclude all implicit tags and return the resulting trail.
1446 function getExplicitTagsOnly ($trail, $tree = NULL)
1452 foreach ($tree as $taginfo)
1454 if (isset ($taginfo['kids']))
1456 $harvest = getExplicitTagsOnly ($trail, $taginfo['kids']);
1457 if (count ($harvest) > 0)
1459 $ret = array_merge ($ret, $harvest);
1463 // This tag isn't implicit, test is for being explicit.
1464 foreach ($trail as $testtag)
1465 if ($taginfo['id'] == $testtag['id'])
1474 // Maximize the trail: for each tag add all tags, for which it is direct or indirect parent.
1475 // Unlike other functions, this one accepts and returns a list of integer tag IDs, not
1476 // a list of tag structures.
1477 function complementByKids ($idlist, $tree = NULL, $getall = FALSE)
1482 $getallkids = $getall;
1484 foreach ($tree as $taginfo)
1486 foreach ($idlist as $test_id)
1487 if ($getall or $taginfo['id'] == $test_id)
1489 $ret[] = $taginfo['id'];
1490 // Once matched node makes all sub-nodes match, but don't make
1491 // a mistake of matching every other node at the current level.
1495 if (isset ($taginfo['kids']))
1496 $ret = array_merge ($ret, complementByKids ($idlist, $taginfo['kids'], $getallkids));
1497 $getallkids = FALSE;
1502 function loadRackObjectAutoTags()
1504 assertUIntArg ('object_id');
1505 $object_id = $_REQUEST['object_id'];
1506 $oinfo = getObjectInfo ($object_id);
1508 $ret[] = array ('tag' => '$id_' . $_REQUEST['object_id']);
1509 $ret[] = array ('tag' => '$any_object');
1513 function loadIPv4PrefixAutoTags()
1515 assertUIntArg ('id');
1516 $subnet = getIPRange ($_REQUEST['id']);
1518 $ret[] = array ('tag' => '$id_' . $_REQUEST['id']);
1519 $ret[] = array ('tag' => '$ipv4net-' . str_replace ('.', '-', $subnet['ip']) . '-' . $subnet['mask']);
1520 // FIXME: find and list tags for all parent networks
1521 $ret[] = array ('tag' => '$any_ipv4net');
1522 $ret[] = array ('tag' => '$any_net');
1526 function loadRackAutoTags()
1528 assertUIntArg ('rack_id');
1530 $ret[] = array ('tag' => '$id_' . $_REQUEST['rack_id']);
1531 $ret[] = array ('tag' => '$any_rack');
1535 function loadIPv4AddressAutoTags()
1537 assertIPv4Arg ('ip');
1539 $ret[] = array ('tag' => '$ipv4net-' . str_replace ('.', '-', $subnet['ip']) . '-32');
1540 // FIXME: find and list tags for all parent networks
1541 $ret[] = array ('tag' => '$any_ipv4net');
1542 $ret[] = array ('tag' => '$any_net');
1546 function loadIPv4VSAutoTags()
1548 assertUIntArg ('id');
1550 $ret[] = array ('tag' => '$id_' . $_REQUEST['id']);
1551 $ret[] = array ('tag' => '$any_ipv4vs');
1552 $ret[] = array ('tag' => '$any_vs');
1556 function loadIPv4RSPoolAutoTags()
1558 assertUIntArg ('pool_id');
1560 $ret[] = array ('tag' => '$id_' . $_REQUEST['pool_id']);
1561 $ret[] = array ('tag' => '$any_ipv4rspool');
1562 $ret[] = array ('tag' => '$any_rspool');
1566 function getGlobalAutoTags()
1568 global $remote_username, $accounts;
1571 foreach ($accounts as $a)
1572 if ($a['user_name'] == $remote_username)
1574 $user_id = $a['user_id'];
1577 $ret[] = array ('tag' => '$username_' . $remote_username);
1578 $ret[] = array ('tag' => '$userid_' . $user_id);
1582 // Build a tag trail from supplied tag id list and return it.
1583 function buildTrailFromIds ($tagidlist)
1587 foreach ($tagidlist as $tag_id)
1588 if (isset ($taglist[$tag_id]))
1589 $ret[] = $taglist[$tag_id];
1593 // Process a given tag tree and return only meaningful branches. The resulting
1594 // (sub)tree will have refcnt leaves on every last branch.
1595 function getObjectiveTagTree ($tree, $realm)
1598 foreach ($tree as $taginfo)
1600 $subsearch = array();
1602 if (count ($taginfo['kids']))
1604 $subsearch = getObjectiveTagTree ($taginfo['kids'], $realm);
1605 $pick = count ($subsearch) > 0;
1607 elseif (isset ($taginfo['refcnt'][$realm]))
1613 'id' => $taginfo['id'],
1614 'tag' => $taginfo['tag'],
1615 'parent_id' => $taginfo['parent_id'],
1616 'refcnt' => $taginfo['refcnt'],
1617 'kids' => $subsearch
1623 function getStringFromTrail ($trail)
1627 foreach ($trail as $tag)
1629 $str .= $comma . $tag['id'];