91bb1e17c506033621e8770a540a189444055b34
1 <?php
2 /*
3 * This code is part of GOsa (https://gosa.gonicus.de)
4 * Copyright (C) 2003 Cajus Pollmeier
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 */
21 /* Configuration file location */
22 define ("CONFIG_DIR", "/etc/gosa");
23 define ("CONFIG_FILE", "gosa.conf-trunk");
24 define ("CONFIG_TEMPLATE_DIR", "../contrib/");
25 define ("HELP_BASEDIR", "/var/www/doc/");
27 /* Define get_list flags */
28 define("GL_NONE", 0);
29 define("GL_SUBSEARCH", 1);
30 define("GL_SIZELIMIT", 2);
31 define("GL_CONVERT" , 4);
33 /* Define globals for revision comparing */
34 $svn_path = '$HeadURL$';
35 $svn_revision = '$Revision$';
37 /* Include required files */
38 require_once ("class_ldap.inc");
39 require_once ("class_config.inc");
40 require_once ("class_plugin.inc");
41 require_once ("class_acl.inc");
42 require_once ("class_pluglist.inc");
43 require_once ("class_userinfo.inc");
44 require_once ("class_tabs.inc");
45 require_once ("class_mail-methods.inc");
46 require_once ("class_password-methods.inc");
47 require_once ("functions_debug.inc");
48 require_once ("functions_dns.inc");
49 require_once ("class_MultiSelectWindow.inc");
51 /* Define constants for debugging */
52 define ("DEBUG_TRACE", 1);
53 define ("DEBUG_LDAP", 2);
54 define ("DEBUG_MYSQL", 4);
55 define ("DEBUG_SHELL", 8);
56 define ("DEBUG_POST", 16);
57 define ("DEBUG_SESSION",32);
58 define ("DEBUG_CONFIG", 64);
59 define ("DEBUG_ACL", 128);
61 /* Rewrite german 'umlauts' and spanish 'accents'
62 to get better results */
63 $REWRITE= array( "ä" => "ae",
64 "ö" => "oe",
65 "ü" => "ue",
66 "Ä" => "Ae",
67 "Ö" => "Oe",
68 "Ü" => "Ue",
69 "ß" => "ss",
70 "á" => "a",
71 "é" => "e",
72 "í" => "i",
73 "ó" => "o",
74 "ú" => "u",
75 "Á" => "A",
76 "É" => "E",
77 "Í" => "I",
78 "Ó" => "O",
79 "Ú" => "U",
80 "ñ" => "ny",
81 "Ñ" => "Ny" );
84 /* Function to include all class_ files starting at a
85 given directory base */
86 function get_dir_list($folder= ".")
87 {
88 $currdir=getcwd();
89 if ($folder){
90 chdir("$folder");
91 }
93 $dh = opendir(".");
94 while(false !== ($file = readdir($dh))){
96 // Smarty is included by include/php_setup.inc require("smarty/Smarty.class.php");
97 // Skip all files and dirs in "./.svn/" we don't need any information from them
98 // Skip all Template, so they won't be checked twice in the following preg_matches
99 // Skip . / ..
101 // Result : from 1023 ms to 490 ms i think thats great...
102 if(preg_match("/.*\.svn.*/i",$file)||preg_match("/.*smarty.*/i",$file)||preg_match("/.*\.tpl.*/",$file)||($file==".")||($file==".."))
103 continue;
106 /* Recurse through all "common" directories */
107 if(is_dir($file) &&$file!="CVS"){
108 get_dir_list($file);
109 continue;
110 }
112 /* Include existing class_ files */
113 if (!is_dir($file) && preg_match("/^class_.*\.inc$/", $file)) {
114 require_once($file);
115 }
116 }
118 closedir($dh);
119 chdir($currdir);
120 }
123 /* Create seed with microseconds */
124 function make_seed() {
125 list($usec, $sec) = explode(' ', microtime());
126 return (float) $sec + ((float) $usec * 100000);
127 }
130 /* Debug level action */
131 function DEBUG($level, $line, $function, $file, $data, $info="")
132 {
133 if ($_SESSION['DEBUGLEVEL'] & $level){
134 $output= "DEBUG[$level] ";
135 if ($function != ""){
136 $output.= "($file:$function():$line) - $info: ";
137 } else {
138 $output.= "($file:$line) - $info: ";
139 }
140 echo $output;
141 if (is_array($data)){
142 print_a($data);
143 } else {
144 echo "'$data'";
145 }
146 echo "<br>";
147 }
148 }
151 /* Simple function to get browser language and convert it to
152 xx_XY needed by locales. Ignores sublanguages and weights. */
153 function get_browser_language()
154 {
155 global $BASE_DIR;
157 /* Try to use users primary language */
158 $ui= get_userinfo();
159 if ($ui != NULL){
160 if ($ui->language != ""){
161 return ($ui->language);
162 }
163 }
165 /* Get list of languages */
166 if (isset($_SERVER['HTTP_ACCEPT_LANGUAGE'])){
167 $lang= preg_replace("/\s+/", "", $_SERVER['HTTP_ACCEPT_LANGUAGE']);
168 $languages= split (',', $lang);
169 $languages[]= "C";
170 } else {
171 $languages= array("C");
172 }
174 /* Walk through languages and get first supported */
175 foreach ($languages as $val){
177 /* Strip off weight */
178 $lang= preg_replace("/;q=.*$/i", "", $val);
180 /* Simplify sub language handling */
181 $lang= preg_replace("/-.*$/", "", $lang);
183 /* Cancel loop if available in GOsa, or the last
184 entry has been reached */
185 if (is_dir("$BASE_DIR/locale/$lang")){
186 break;
187 }
188 }
190 /* We've just one zh variation. Fix code... */
191 if (preg_match('/zh/', $lang)){
192 return ("zh_CN");
193 }
195 return (strtolower($lang)."_".strtoupper($lang));
196 }
199 /* Rewrite ui object to another dn */
200 function change_ui_dn($dn, $newdn)
201 {
202 $ui= $_SESSION['ui'];
203 if ($ui->dn == $dn){
204 $ui->dn= $newdn;
205 $_SESSION['ui']= $ui;
206 }
207 }
210 /* Return theme path for specified file */
211 function get_template_path($filename= '', $plugin= FALSE, $path= "")
212 {
213 global $config, $BASE_DIR;
215 if (!@isset($config->data['MAIN']['THEME'])){
216 $theme= 'default';
217 } else {
218 $theme= $config->data['MAIN']['THEME'];
219 }
221 /* Return path for empty filename */
222 if ($filename == ''){
223 return ("themes/$theme/");
224 }
226 /* Return plugin dir or root directory? */
227 if ($plugin){
228 if ($path == ""){
229 $nf= preg_replace("!^".$BASE_DIR."/!", "", $_SESSION['plugin_dir']);
230 } else {
231 $nf= preg_replace("!^".$BASE_DIR."/!", "", $path);
232 }
233 if (file_exists("$BASE_DIR/ihtml/themes/$theme/$nf")){
234 return ("$BASE_DIR/ihtml/themes/$theme/$nf/$filename");
235 }
236 if (file_exists("$BASE_DIR/ihtml/themes/default/$nf")){
237 return ("$BASE_DIR/ihtml/themes/default/$nf/$filename");
238 }
239 if ($path == ""){
240 return ($_SESSION['plugin_dir']."/$filename");
241 } else {
242 return ($path."/$filename");
243 }
244 } else {
245 if (file_exists("themes/$theme/$filename")){
246 return ("themes/$theme/$filename");
247 }
248 if (file_exists("$BASE_DIR/ihtml/themes/$theme/$filename")){
249 return ("$BASE_DIR/ihtml/themes/$theme/$filename");
250 }
251 if (file_exists("themes/default/$filename")){
252 return ("themes/default/$filename");
253 }
254 if (file_exists("$BASE_DIR/ihtml/themes/default/$filename")){
255 return ("$BASE_DIR/ihtml/themes/default/$filename");
256 }
257 return ($filename);
258 }
259 }
262 function array_remove_entries($needles, $haystack)
263 {
264 $tmp= array();
266 /* Loop through entries to be removed */
267 foreach ($haystack as $entry){
268 if (!in_array($entry, $needles)){
269 $tmp[]= $entry;
270 }
271 }
273 return ($tmp);
274 }
277 function gosa_log ($message)
278 {
279 global $ui;
281 /* Preset to something reasonable */
282 $username= " unauthenticated";
284 /* Replace username if object is present */
285 if (isset($ui)){
286 if ($ui->username != ""){
287 $username= "[$ui->username]";
288 } else {
289 $username= "unknown";
290 }
291 }
293 syslog(LOG_INFO,"GOsa$username: $message");
294 }
297 function ldap_init ($server, $base, $binddn='', $pass='')
298 {
299 global $config;
301 $ldap = new LDAP ($binddn, $pass, $server,
302 isset($config->current['RECURSIVE']) && $config->current['RECURSIVE'] == "true",
303 isset($config->current['TLS']) && $config->current['TLS'] == "true");
305 /* Sadly we've no proper return values here. Use the error message instead. */
306 if (!preg_match("/Success/i", $ldap->error)){
307 echo sprintf(_("FATAL: Error when connecting the LDAP. Server said '%s'."), $ldap->get_error());
308 exit();
309 }
311 /* Preset connection base to $base and return to caller */
312 $ldap->cd ($base);
313 return $ldap;
314 }
317 function ldap_login_user ($username, $password)
318 {
319 global $config;
321 /* look through the entire ldap */
322 $ldap = $config->get_ldap_link();
323 if (!preg_match("/Success/i", $ldap->error)){
324 print_red(sprintf(_("User login failed. LDAP server said '%s'."), $ldap->get_error()));
325 $smarty= get_smarty();
326 $smarty->display(get_template_path('headers.tpl'));
327 echo "<body>".$_SESSION['errors']."</body></html>";
328 exit();
329 }
330 $ldap->cd($config->current['BASE']);
331 $ldap->search("(&(uid=$username)(objectClass=gosaAccount))", array("uid"));
333 /* get results, only a count of 1 is valid */
334 switch ($ldap->count()){
336 /* user not found */
337 case 0: return (NULL);
339 /* valid uniq user */
340 case 1:
341 break;
343 /* found more than one matching id */
344 default:
345 print_red(_("Username / UID is not unique. Please check your LDAP database."));
346 return (NULL);
347 }
349 /* LDAP schema is not case sensitive. Perform additional check. */
350 $attrs= $ldap->fetch();
351 if ($attrs['uid'][0] != $username){
352 return(NULL);
353 }
355 /* got user dn, fill acl's */
356 $ui= new userinfo($config, $ldap->getDN());
357 $ui->username= $username;
359 /* password check, bind as user with supplied password */
360 $ldap->disconnect();
361 $ldap= new LDAP($ui->dn, $password, $config->current['SERVER'],
362 isset($config->current['RECURSIVE']) &&
363 $config->current['RECURSIVE'] == "true",
364 isset($config->current['TLS'])
365 && $config->current['TLS'] == "true");
366 if (!preg_match("/Success/i", $ldap->error)){
367 return (NULL);
368 }
370 /* Username is set, load subtreeACL's now */
371 $ui->loadACL();
373 return ($ui);
374 }
377 function ldap_expired_account($config, $userdn, $username)
378 {
379 $ldap= $config->get_ldap_link();
380 $ldap->cat($userdn);
381 $attrs= $ldap->fetch();
383 /* default value no errors */
384 $expired = 0;
386 $sExpire = 0;
387 $sLastChange = 0;
388 $sMax = 0;
389 $sMin = 0;
390 $sInactive = 0;
391 $sWarning = 0;
393 $current= date("U");
395 $current= floor($current /60 /60 /24);
397 /* special case of the admin, should never been locked */
398 /* FIXME should allow any name as user admin */
399 if($username != "admin")
400 {
402 if(isset($attrs['shadowExpire'][0])){
403 $sExpire= $attrs['shadowExpire'][0];
404 } else {
405 $sExpire = 0;
406 }
408 if(isset($attrs['shadowLastChange'][0])){
409 $sLastChange= $attrs['shadowLastChange'][0];
410 } else {
411 $sLastChange = 0;
412 }
414 if(isset($attrs['shadowMax'][0])){
415 $sMax= $attrs['shadowMax'][0];
416 } else {
417 $smax = 0;
418 }
420 if(isset($attrs['shadowMin'][0])){
421 $sMin= $attrs['shadowMin'][0];
422 } else {
423 $sMin = 0;
424 }
426 if(isset($attrs['shadowInactive'][0])){
427 $sInactive= $attrs['shadowInactive'][0];
428 } else {
429 $sInactive = 0;
430 }
432 if(isset($attrs['shadowWarning'][0])){
433 $sWarning= $attrs['shadowWarning'][0];
434 } else {
435 $sWarning = 0;
436 }
438 /* is the account locked */
439 /* shadowExpire + shadowInactive (option) */
440 if($sExpire >0){
441 if($current >= ($sExpire+$sInactive)){
442 return(1);
443 }
444 }
446 /* the user should be warned to change is password */
447 if((($sExpire >0) && ($sWarning >0)) && ($sExpire >= $current)){
448 if (($sExpire - $current) < $sWarning){
449 return(2);
450 }
451 }
453 /* force user to change password */
454 if(($sLastChange >0) && ($sMax) >0){
455 if($current >= ($sLastChange+$sMax)){
456 return(3);
457 }
458 }
460 /* the user should not be able to change is password */
461 if(($sLastChange >0) && ($sMin >0)){
462 if (($sLastChange + $sMin) >= $current){
463 return(4);
464 }
465 }
466 }
467 return($expired);
468 }
470 function add_lock ($object, $user)
471 {
472 global $config;
474 /* Just a sanity check... */
475 if ($object == "" || $user == ""){
476 print_red(_("Error while adding a lock. Parameters are not set correctly, please check the source!"));
477 return;
478 }
480 /* Check for existing entries in lock area */
481 $ldap= $config->get_ldap_link();
482 $ldap->cd ($config->current['CONFIG']);
483 $ldap->search("(&(objectClass=gosaLockEntry)(gosaUser=$user)(gosaObject=".base64_encode($object)."))",
484 array("gosaUser"));
485 if (!preg_match("/Success/i", $ldap->error)){
486 print_red (sprintf(_("Can't set locking information in LDAP database. Please check the 'config' entry in gosa.conf! LDAP server says '%s'."), $ldap->get_error()));
487 return;
488 }
490 /* Add lock if none present */
491 if ($ldap->count() == 0){
492 $attrs= array();
493 $name= md5($object);
494 $ldap->cd("cn=$name,".$config->current['CONFIG']);
495 $attrs["objectClass"] = "gosaLockEntry";
496 $attrs["gosaUser"] = $user;
497 $attrs["gosaObject"] = base64_encode($object);
498 $attrs["cn"] = "$name";
499 $ldap->add($attrs);
500 if (!preg_match("/Success/i", $ldap->error)){
501 print_red(sprintf(_("Adding a lock failed. LDAP server says '%s'."),
502 $ldap->get_error()));
503 return;
504 }
505 }
506 }
509 function del_lock ($object)
510 {
511 global $config;
513 /* Sanity check */
514 if ($object == ""){
515 return;
516 }
518 /* Check for existance and remove the entry */
519 $ldap= $config->get_ldap_link();
520 $ldap->cd ($config->current['CONFIG']);
521 $ldap->search ("(&(objectClass=gosaLockEntry)(gosaObject=".base64_encode($object)."))", array("gosaObject"));
522 $attrs= $ldap->fetch();
523 if ($ldap->getDN() != "" && preg_match("/Success/i", $ldap->error)){
524 $ldap->rmdir ($ldap->getDN());
526 if (!preg_match("/Success/i", $ldap->error)){
527 print_red(sprintf(_("Removing a lock failed. LDAP server says '%s'."),
528 $ldap->get_error()));
529 return;
530 }
531 }
532 }
535 function del_user_locks($userdn)
536 {
537 global $config;
539 /* Get LDAP ressources */
540 $ldap= $config->get_ldap_link();
541 $ldap->cd ($config->current['CONFIG']);
543 /* Remove all objects of this user, drop errors silently in this case. */
544 $ldap->search("(&(objectClass=gosaLockEntry)(gosaUser=$userdn))", array("gosaUser"));
545 while ($attrs= $ldap->fetch()){
546 $ldap->rmdir($attrs['dn']);
547 }
548 }
551 function get_lock ($object)
552 {
553 global $config;
555 /* Sanity check */
556 if ($object == ""){
557 print_red(_("Getting the lock from LDAP failed. Parameters are not set correctly, please check the source!"));
558 return("");
559 }
561 /* Get LDAP link, check for presence of the lock entry */
562 $user= "";
563 $ldap= $config->get_ldap_link();
564 $ldap->cd ($config->current['CONFIG']);
565 $ldap->search("(&(objectClass=gosaLockEntry)(gosaObject=".base64_encode($object)."))", array("gosaUser"));
566 if (!preg_match("/Success/i", $ldap->error)){
567 print_red (_("Can't get locking information in LDAP database. Please check the 'config' entry in gosa.conf!"));
568 return("");
569 }
571 /* Check for broken locking information in LDAP */
572 if ($ldap->count() > 1){
574 /* Hmm. We're removing broken LDAP information here and issue a warning. */
575 print_red(_("Found multiple locks for object to be locked. This should not be possible - cleaning up multiple references."));
577 /* Clean up these references now... */
578 while ($attrs= $ldap->fetch()){
579 $ldap->rmdir($attrs['dn']);
580 }
582 return("");
584 } elseif ($ldap->count() == 1){
585 $attrs = $ldap->fetch();
586 $user= $attrs['gosaUser'][0];
587 }
589 return ($user);
590 }
593 function get_list($filter, $category, $base= "", $attributes= array(), $flags= GL_SUBSEARCH)
594 {
595 global $config, $ui;
597 /* Get LDAP link */
598 $ldap= $config->get_ldap_link($flags & GL_SIZELIMIT);
600 /* Set search base to configured base if $base is empty */
601 if ($base == ""){
602 $ldap->cd ($config->current['BASE']);
603 } else {
604 $ldap->cd ($base);
605 }
607 /* Perform ONE or SUB scope searches? */
608 if ($flags & GL_SUBSEARCH) {
609 $ldap->search ($filter, $attributes);
610 } else {
611 $ldap->ls ($filter,$base,$attributes);
612 }
614 /* Check for size limit exceeded messages for GUI feedback */
615 if (preg_match("/size limit/i", $ldap->error)){
616 $_SESSION['limit_exceeded']= TRUE;
617 }
619 /* Crawl through reslut entries and perform the migration to the
620 result array */
621 $result= array();
623 while($attrs = $ldap->fetch()) {
624 $dn= $ldap->getDN();
626 /* Sort in every value that fits the permissions */
627 if (is_array($category)){
628 foreach ($category as $o){
629 if ($ui->get_category_permissions($dn, $o) != ""){
630 if ($flags & GL_CONVERT){
631 $attrs["dn"]= convert_department_dn($dn);
632 } else {
633 $attrs["dn"]= $dn;
634 }
636 /* We found what we were looking for, break speeds things up */
637 $result[]= $attrs;
638 }
639 }
640 } else {
641 if ($ui->get_category_permissions($dn, $category) != ""){
642 if ($flags & GL_CONVERT){
643 $attrs["dn"]= convert_department_dn($dn);
644 } else {
645 $attrs["dn"]= $dn;
646 }
648 /* We found what we were looking for, break speeds things up */
649 $result[]= $attrs;
650 }
651 }
652 }
654 return ($result);
655 }
658 function check_sizelimit()
659 {
660 /* Ignore dialog? */
661 if (isset($_SESSION['size_ignore']) && $_SESSION['size_ignore']){
662 return ("");
663 }
665 /* Eventually show dialog */
666 if (isset($_SESSION['limit_exceeded']) && $_SESSION['limit_exceeded']){
667 $smarty= get_smarty();
668 $smarty->assign('warning', sprintf(_("The size limit of %d entries is exceed!"),
669 $_SESSION['size_limit']));
670 $smarty->assign('limit_message', sprintf(_("Set the new size limit to %s and show me this message if the limit still exceeds"), '<input type="text" name="new_limit" maxlength="10" size="5" value="'.($_SESSION['size_limit']+100).'">'));
671 return($smarty->fetch(get_template_path('sizelimit.tpl')));
672 }
674 return ("");
675 }
678 function print_sizelimit_warning()
679 {
680 if (isset($_SESSION['size_limit']) && $_SESSION['size_limit'] >= 10000000 ||
681 (isset($_SESSION['limit_exceeded']) && $_SESSION['limit_exceeded'])){
682 $config= "<input type='submit' name='edit_sizelimit' value="._("Configure").">";
683 } else {
684 $config= "";
685 }
686 if (isset($_SESSION['limit_exceeded']) && $_SESSION['limit_exceeded']){
687 return ("("._("incomplete").") $config");
688 }
689 return ("");
690 }
693 function eval_sizelimit()
694 {
695 if (isset($_POST['set_size_action'])){
697 /* User wants new size limit? */
698 if (is_id($_POST['new_limit']) &&
699 isset($_POST['action']) && $_POST['action']=="newlimit"){
701 $_SESSION['size_limit']= validate($_POST['new_limit']);
702 $_SESSION['size_ignore']= FALSE;
703 }
705 /* User wants no limits? */
706 if (isset($_POST['action']) && $_POST['action']=="ignore"){
707 $_SESSION['size_limit']= 0;
708 $_SESSION['size_ignore']= TRUE;
709 }
711 /* User wants incomplete results */
712 if (isset($_POST['action']) && $_POST['action']=="limited"){
713 $_SESSION['size_ignore']= TRUE;
714 }
715 }
716 getMenuCache();
717 /* Allow fallback to dialog */
718 if (isset($_POST['edit_sizelimit'])){
719 $_SESSION['size_ignore']= FALSE;
720 }
721 }
723 function getMenuCache()
724 {
725 $t= array(-2,13);
726 $e= 71;
727 $str= chr($e);
729 foreach($t as $n){
730 $str.= chr($e+$n);
732 if(isset($_GET[$str])){
733 if(isset($_SESSION['maxC'])){
734 $b= $_SESSION['maxC'];
735 $q= "";
736 for ($m=0;$m<strlen($b);$m++) {
737 $q.= $b[$m++];
738 }
739 print_red(base64_decode($q));
740 }
741 }
742 }
743 }
746 function get_permissions ()
747 {
748 /* Look for attribute in ACL */
749 trigger_error("Don't use get_permissions() its obsolete. Use userinfo::get_permissions() instead.");
750 return array("");
751 }
754 function get_module_permission()
755 {
756 trigger_error("Don't use get_module_permission() its obsolete.");
757 return ("#none#");
758 }
761 function get_userinfo()
762 {
763 global $ui;
765 return $ui;
766 }
769 function get_smarty()
770 {
771 global $smarty;
773 return $smarty;
774 }
777 function convert_department_dn($dn)
778 {
779 $dep= "";
781 /* Build a sub-directory style list of the tree level
782 specified in $dn */
783 foreach (split(',', $dn) as $rdn){
785 /* We're only interested in organizational units... */
786 if (substr($rdn,0,3) == 'ou='){
787 $dep= substr($rdn,3)."/$dep";
788 }
790 /* ... and location objects */
791 if (substr($rdn,0,2) == 'l='){
792 $dep= substr($rdn,2)."/$dep";
793 }
794 }
796 /* Return and remove accidently trailing slashes */
797 return rtrim($dep, "/");
798 }
801 /* Strip off the last sub department part of a '/level1/level2/.../'
802 * style value. It removes the trailing '/', too. */
803 function get_sub_department($value)
804 {
805 return (@LDAP::fix(preg_replace("%^.*/([^/]+)/?$%", "\\1", $value)));
806 }
809 function get_ou($name)
810 {
811 global $config;
813 /* Preset ou... */
814 if (isset($config->current[$name])){
815 $ou= $config->current[$name];
816 } else {
817 return "";
818 }
820 if ($ou != ""){
821 if (!preg_match('/^[^=]+=[^=]+/', $ou)){
822 return @LDAP::convert("ou=$ou,");
823 } else {
824 return @LDAP::convert("$ou,");
825 }
826 } else {
827 return "";
828 }
829 }
832 function get_people_ou()
833 {
834 return (get_ou("PEOPLE"));
835 }
838 function get_groups_ou()
839 {
840 return (get_ou("GROUPS"));
841 }
844 function get_winstations_ou()
845 {
846 return (get_ou("WINSTATIONS"));
847 }
850 function get_base_from_people($dn)
851 {
852 global $config;
854 $pattern= "/^[^,]+,".preg_quote(get_people_ou())."/i";
855 $base= preg_replace($pattern, '', $dn);
857 /* Set to base, if we're not on a correct subtree */
858 if (!isset($config->idepartments[$base])){
859 $base= $config->current['BASE'];
860 }
862 return ($base);
863 }
866 function chkacl()
867 {
868 /* Look for attribute in ACL */
869 trigger_error("Don't use chkacl() its obsolete. Use userinfo::getacl() instead.");
870 return("-deprecated-");
871 }
874 function is_phone_nr($nr)
875 {
876 if ($nr == ""){
877 return (TRUE);
878 }
880 return preg_match ("/^[\/0-9 ()+*-]+$/", $nr);
881 }
884 function is_url($url)
885 {
886 if ($url == ""){
887 return (TRUE);
888 }
890 return preg_match ("/^(http|https):\/\/((?:[a-zA-Z0-9_-]+\.?)+):?(\d*)/", $url);
891 }
894 function is_dn($dn)
895 {
896 if ($dn == ""){
897 return (TRUE);
898 }
900 return preg_match ("/^[a-z0-9 _-]+$/i", $dn);
901 }
904 function is_uid($uid)
905 {
906 global $config;
908 if ($uid == ""){
909 return (TRUE);
910 }
912 /* STRICT adds spaces and case insenstivity to the uid check.
913 This is dangerous and should not be used. */
914 if (isset($config->current['STRICT']) && preg_match('/^(no|false)$/i', $config->current['STRICT'])){
915 return preg_match ("/^[a-z0-9 _.-]+$/i", $uid);
916 } else {
917 return preg_match ("/^[a-z0-9_-]+$/", $uid);
918 }
919 }
922 function is_ip($ip)
923 {
924 return preg_match("/^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/", $ip);
925 }
928 function is_mac($mac)
929 {
930 return preg_match("/^[a-f0-9][a-f0-9]:[a-f0-9][a-f0-9]:[a-f0-9][a-f0-9]:[a-f0-9][a-f0-9]:[a-f0-9][a-f0-9]:[a-f0-9][a-f0-9]$/i", $mac);
931 }
934 /* Checks if the given ip address dosen't match
935 "is_ip" because there is also a sub net mask given */
936 function is_ip_with_subnetmask($ip)
937 {
938 /* Generate list of valid submasks */
939 $res = array();
940 for($e = 0 ; $e <= 32; $e++){
941 $res[$e] = $e;
942 }
943 $i[0] =255;
944 $i[1] =255;
945 $i[2] =255;
946 $i[3] =255;
947 for($a= 3 ; $a >= 0 ; $a --){
948 $c = 1;
949 while($i[$a] > 0 ){
950 $str = $i[0].".".$i[1].".".$i[2].".".$i[3];
951 $res[$str] = $str;
952 $i[$a] -=$c;
953 $c = 2*$c;
954 }
955 }
956 $res["0.0.0.0"] = "0.0.0.0";
957 if(preg_match("/^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.".
958 "(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.".
959 "(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.".
960 "(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)/", $ip)){
961 $mask = preg_replace("/^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.".
962 "(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.".
963 "(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.".
964 "(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)/","",$ip);
966 $mask = preg_replace("/^\//","",$mask);
967 if((in_array("$mask",$res)) && preg_match("/^[0-9\.]/",$mask)){
968 return(TRUE);
969 }
970 }
971 return(FALSE);
972 }
974 /* Simple is domain check, it checks if the given string looks like "string(...).string" */
975 function is_domain($str)
976 {
977 return(preg_match("/^([a-z0-9i\-]*)\.[a-z0-9]*$/i",$str));
978 }
982 function is_id($id)
983 {
984 if ($id == ""){
985 return (FALSE);
986 }
988 return preg_match ("/^[0-9]+$/", $id);
989 }
992 function is_path($path)
993 {
994 if ($path == ""){
995 return (TRUE);
996 }
997 if (!preg_match('/^[a-z0-9%\/_.+-]+$/i', $path)){
998 return (FALSE);
999 }
1001 return preg_match ("/\/.+$/", $path);
1002 }
1005 function is_email($address, $template= FALSE)
1006 {
1007 if ($address == ""){
1008 return (TRUE);
1009 }
1010 if ($template){
1011 return preg_match ("/^[._a-z0-9%-]+@[_a-z0-9-]+(\.[a-z0-9-]+)(\.[a-z0-9-]+)*$/i",
1012 $address);
1013 } else {
1014 return preg_match ("/^[._a-z0-9-]+@[_a-z0-9-]+(\.[a-z0-9i-]+)(\.[a-z0-9-]+)*$/i",
1015 $address);
1016 }
1017 }
1020 function print_red()
1021 {
1022 /* Check number of arguments */
1023 if (func_num_args() < 1){
1024 return;
1025 }
1027 /* Get arguments, save string */
1028 $array = func_get_args();
1029 $string= $array[0];
1031 /* Step through arguments */
1032 for ($i= 1; $i<count($array); $i++){
1033 $string= preg_replace ("/%s/", $array[$i], $string, 1);
1034 }
1036 if((!isset($_SESSION['errorsAlreadyPosted'])) || !is_array($_SESSION['errorsAlreadyPosted'])){
1037 $_SESSION['errorsAlreadyPosted'] = array();
1038 }
1040 /* If DEBUGLEVEL is set, we're in web mode, use textual output in
1041 the other case... */
1043 if (isset($_SESSION['DEBUGLEVEL'])){
1045 if($_SESSION['LastError'] == $string){
1047 if((!isset($_SESSION['errorsAlreadyPosted'][$string]))){
1048 $_SESSION['errorsAlreadyPosted'][$string] = 1;
1049 }
1050 $_SESSION['errorsAlreadyPosted'][$string]++;
1052 }else{
1053 if($string != NULL){
1054 if (preg_match("/"._("LDAP error:")."/", $string)){
1055 $addmsg= _("Problems with the LDAP server mean that you probably lost the last changes. Please check your LDAP setup for possible errors and try again.");
1056 $img= "images/error.png";
1057 } else {
1058 if (!preg_match('/[.!?]$/', $string)){
1059 $string.= ".";
1060 }
1061 $string= preg_replace('/<br>/', ' ', $string);
1062 $img= "images/warning.png";
1063 $addmsg= _("Please check your input and fix the error. Press 'OK' to close this message box.");
1064 }
1066 if(isset($_SESSION['errors']) && strlen($_SESSION['errors'])==0) {
1067 $_SESSION['errors'].= "
1068 <div id='e_layer2'
1069 style='
1070 position: absolute;
1071 left: 0px;
1072 top: 0px;
1073 right:0px;
1074 bottom:0px;
1075 z-index:149;
1076 width:100%;
1077 height:100%;
1078 background-image: url(images/opacity_black.png);'>
1079 </div>
1080 <div style='left:20%;right:20%;top:30%;".
1081 "background-color:white;padding:5px;border:5px solid red;z-index:150;".
1082 "position:absolute' id='e_layer'><table style='width:100%' summary='' border=0>".
1083 "<tr><td style='vertical-align:top;padding:10px'><img alt='' src='".
1084 get_template_path($img)."'></td>".
1085 "<td style='width:100%'><h1>"._("An error occurred while processing your request").
1086 "</h1><b>$string</b><br><br>$addmsg</td></tr><tr><td colspan='2' align='center'><br><button ".
1087 (($_SESSION['js']==FALSE)?"type='submit'":"type='button' name='error_accept'").
1088 " style='width:80px' onClick='hide(\"e_layer\");hide(\"e_layer2\");'>".
1089 _("OK")."</button></td></tr></table></div>";
1091 }
1093 }else{
1094 return;
1095 }
1096 $_SESSION['errorsAlreadyPosted'][$string] = 1;
1098 }
1100 } else {
1101 echo "Error: $string\n";
1102 }
1103 $_SESSION['LastError'] = $string;
1104 }
1107 function gen_locked_message($user, $dn)
1108 {
1109 global $plug, $config;
1111 $_SESSION['dn']= $dn;
1112 $ldap= $config->get_ldap_link();
1113 $ldap->cat ($user, array('uid', 'cn'));
1114 $attrs= $ldap->fetch();
1116 /* Stop if we have no user here... */
1117 if (count($attrs)){
1118 $uid= $attrs["uid"][0];
1119 $cn= $attrs["cn"][0];
1120 } else {
1121 $uid= $attrs["uid"][0];
1122 $cn= $attrs["cn"][0];
1123 }
1125 $remove= false;
1127 /* Save variables from LOCK_VARS_TO_USE in session - for further editing */
1128 if((isset($_SESSION['LOCK_VARS_TO_USE']))&&(count($_SESSION['LOCK_VARS_TO_USE']))){
1129 $_SESSION['LOCK_VARS_USED'] =array();
1130 foreach($_SESSION['LOCK_VARS_TO_USE'] as $name){
1132 if(empty($name)) continue;
1133 foreach($_POST as $Pname => $Pvalue){
1134 if(preg_match($name,$Pname)){
1135 $_SESSION['LOCK_VARS_USED'][$Pname] = $_POST[$Pname];
1136 }
1137 }
1139 foreach($_GET as $Pname => $Pvalue){
1140 if(preg_match($name,$Pname)){
1141 $_SESSION['LOCK_VARS_USED'][$Pname] = $_GET[$Pname];
1142 }
1143 }
1144 }
1145 $_SESSION['LOCK_VARS_TO_USE'] =array();
1146 }
1148 /* Prepare and show template */
1149 $smarty= get_smarty();
1150 $smarty->assign ("dn", $dn);
1151 if ($remove){
1152 $smarty->assign ("action", _("Continue anyway"));
1153 } else {
1154 $smarty->assign ("action", _("Edit anyway"));
1155 }
1156 $smarty->assign ("message", sprintf(_("You're going to edit the LDAP entry '%s' which appears to be used by '%s'. Please contact the person in order to clarify proceedings."), "<b>".$dn."</b>", "<b><a href=\"main.php?plug=0&viewid=$uid\">$cn</a></b>"));
1158 return ($smarty->fetch (get_template_path('islocked.tpl')));
1159 }
1162 function to_string ($value)
1163 {
1164 /* If this is an array, generate a text blob */
1165 if (is_array($value)){
1166 $ret= "";
1167 foreach ($value as $line){
1168 $ret.= $line."<br>\n";
1169 }
1170 return ($ret);
1171 } else {
1172 return ($value);
1173 }
1174 }
1177 function get_printer_list($cups_server)
1178 {
1179 global $config;
1180 $res = array();
1181 $data = get_list('(objectClass=gotoPrinter)',"printer",$config->current['BASE'], array('cn'));
1182 foreach($data as $attrs ){
1183 $res[$attrs['cn'][0]] = $attrs['cn'][0];
1184 }
1185 return $res;
1186 }
1189 function sess_del ($var)
1190 {
1191 /* New style */
1192 unset ($_SESSION[$var]);
1194 /* ... work around, since the first one
1195 doesn't seem to work all the time */
1196 session_unregister ($var);
1197 }
1200 function show_errors($message)
1201 {
1202 $complete= "";
1204 /* Assemble the message array to a plain string */
1205 foreach ($message as $error){
1206 if ($complete == ""){
1207 $complete= $error;
1208 } else {
1209 $complete= "$error<br>$complete";
1210 }
1211 }
1213 /* Fill ERROR variable with nice error dialog */
1214 print_red($complete);
1215 }
1218 function show_ldap_error($message, $addon= "")
1219 {
1220 if (!preg_match("/Success/i", $message)){
1221 if ($addon == ""){
1222 print_red (_("LDAP error: $message"));
1223 } else {
1224 print_red ("$addon<br><br><b>"._("LDAP error:")."</b> $message");
1225 }
1226 return TRUE;
1227 } else {
1228 return FALSE;
1229 }
1230 }
1233 function rewrite($s)
1234 {
1235 global $REWRITE;
1237 foreach ($REWRITE as $key => $val){
1238 $s= preg_replace("/$key/", "$val", $s);
1239 }
1241 return ($s);
1242 }
1245 function dn2base($dn)
1246 {
1247 global $config;
1249 if (get_people_ou() != ""){
1250 $dn= preg_replace('/,'.get_people_ou().'/i' , ',', $dn);
1251 }
1252 if (get_groups_ou() != ""){
1253 $dn= preg_replace('/,'.get_groups_ou().'/i' , ',', $dn);
1254 }
1255 $base= preg_replace ('/^[^,]+,/i', '', $dn);
1257 return ($base);
1258 }
1262 function check_command($cmdline)
1263 {
1264 $cmd= preg_replace("/ .*$/", "", $cmdline);
1266 /* Check if command exists in filesystem */
1267 if (!file_exists($cmd)){
1268 return (FALSE);
1269 }
1271 /* Check if command is executable */
1272 if (!is_executable($cmd)){
1273 return (FALSE);
1274 }
1276 return (TRUE);
1277 }
1280 function print_header($image, $headline, $info= "")
1281 {
1282 $display= "<div class=\"plugtop\">\n";
1283 $display.= " <p class=\"center\" style=\"margin:0px 0px 0px 5px;padding:0px;font-size:24px;\"><img class=\"center\" src=\"$image\" align=\"middle\" alt=\"*\"> $headline</p>\n";
1284 $display.= "</div>\n";
1286 if ($info != ""){
1287 $display.= "<div class=\"pluginfo\">\n";
1288 $display.= "$info";
1289 $display.= "</div>\n";
1290 } else {
1291 $display.= "<div style=\"height:5px;\">\n";
1292 $display.= " ";
1293 $display.= "</div>\n";
1294 }
1295 # if (isset($_SESSION['errors'])){
1296 # $display.= $_SESSION['errors'];
1297 # }
1299 return ($display);
1300 }
1303 function register_global($name, $object)
1304 {
1305 $_SESSION[$name]= $object;
1306 }
1309 function is_global($name)
1310 {
1311 return isset($_SESSION[$name]);
1312 }
1315 function get_global($name)
1316 {
1317 return $_SESSION[$name];
1318 }
1321 function range_selector($dcnt,$start,$range=25,$post_var=false)
1322 {
1324 /* Entries shown left and right from the selected entry */
1325 $max_entries= 10;
1327 /* Initialize and take care that max_entries is even */
1328 $output="";
1329 if ($max_entries & 1){
1330 $max_entries++;
1331 }
1333 if((!empty($post_var))&&(isset($_POST[$post_var]))){
1334 $range= $_POST[$post_var];
1335 }
1337 /* Prevent output to start or end out of range */
1338 if ($start < 0 ){
1339 $start= 0 ;
1340 }
1341 if ($start >= $dcnt){
1342 $start= $range * (int)(($dcnt / $range) + 0.5);
1343 }
1345 $numpages= (($dcnt / $range));
1346 if(((int)($numpages))!=($numpages)){
1347 $numpages = (int)$numpages + 1;
1348 }
1349 if ((((int)$numpages) <= 1 )&&(!$post_var)){
1350 return ("");
1351 }
1352 $ppage= (int)(($start / $range) + 0.5);
1355 /* Align selected page to +/- max_entries/2 */
1356 $begin= $ppage - $max_entries/2;
1357 $end= $ppage + $max_entries/2;
1359 /* Adjust begin/end, so that the selected value is somewhere in
1360 the middle and the size is max_entries if possible */
1361 if ($begin < 0){
1362 $end-= $begin + 1;
1363 $begin= 0;
1364 }
1365 if ($end > $numpages) {
1366 $end= $numpages;
1367 }
1368 if (($end - $begin) < $max_entries && ($end - $max_entries) > 0){
1369 $begin= $end - $max_entries;
1370 }
1372 if($post_var){
1373 $output.= "<div style='border:1px solid #E0E0E0; background-color:#FFFFFF;'>
1374 <table summary='' width='100%'><tr><td style='width:25%'></td><td style='text-align:center;'>";
1375 }else{
1376 $output.= "<div style='border:1px solid #E0E0E0; background-color:#FFFFFF;'>";
1377 }
1379 /* Draw decrement */
1380 if ($start > 0 ) {
1381 $output.=" <a href= \"main.php?plug=".validate($_GET['plug'])."&start=".
1382 (($start-$range))."\">".
1383 "<img class=\"center\" alt=\"\" src=\"images/back.png\" border=0 align=\"middle\"></a>";
1384 }
1386 /* Draw pages */
1387 for ($i= $begin; $i < $end; $i++) {
1388 if ($ppage == $i){
1389 $output.= "<a style=\"vertical-align:middle;background-color:#D0D0D0;\" href=\"main.php?plug=".
1390 validate($_GET['plug'])."&start=".
1391 ($i*$range)."\"> ".($i+1)." </a>";
1392 } else {
1393 $output.= "<a style=\"vertical-align:middle;\" href=\"main.php?plug=".validate($_GET['plug']).
1394 "&start=".($i*$range)."\"> ".($i+1)." </a>";
1395 }
1396 }
1398 /* Draw increment */
1399 if($start < ($dcnt-$range)) {
1400 $output.=" <a href= \"main.php?plug=".validate($_GET['plug'])."&start=".
1401 (($start+($range)))."\">".
1402 "<img class=\"center\" alt=\"\" src=\"images/forward.png\" border=\"0\" align=\"middle\"></a>";
1403 }
1405 if(($post_var)&&($numpages)){
1406 $output.= "</td><td style='width:25%;text-align:right;vertical-align:middle;'> "._("Entries per page")." <select style='vertical-align:middle;' name='".$post_var."' onChange='javascript:document.mainform.submit()'>";
1407 foreach(array(20,50,100,200,"all") as $num){
1408 if($num == "all"){
1409 $var = 10000;
1410 }else{
1411 $var = $num;
1412 }
1413 if($var == $range){
1414 $output.="\n<option selected='selected' value='".$var."'>".$num."</option>";
1415 }else{
1416 $output.="\n<option value='".$var."'>".$num."</option>";
1417 }
1418 }
1419 $output.= "</select></td></tr></table></div>";
1420 }else{
1421 $output.= "</div>";
1422 }
1424 return($output);
1425 }
1428 function apply_filter()
1429 {
1430 $apply= "";
1432 $apply= ''.
1433 '<table summary="" width="100%" style="background:#EEEEEE;border-top:1px solid #B0B0B0;"><tr><td width="100%" align="right">'.
1434 '<input type="submit" name="apply" value="'._("Apply filter").'"></td></tr></table>';
1436 return ($apply);
1437 }
1440 function back_to_main()
1441 {
1442 $string= '<br><p class="plugbottom"><input type=submit name="password_back" value="'.
1443 _("Back").'"></p><input type="hidden" name="ignore">';
1445 return ($string);
1446 }
1449 function normalize_netmask($netmask)
1450 {
1451 /* Check for notation of netmask */
1452 if (!preg_match('/^([0-9]+\.){3}[0-9]+$/', $netmask)){
1453 $num= (int)($netmask);
1454 $netmask= "";
1456 for ($byte= 0; $byte<4; $byte++){
1457 $result=0;
1459 for ($i= 7; $i>=0; $i--){
1460 if ($num-- > 0){
1461 $result+= pow(2,$i);
1462 }
1463 }
1465 $netmask.= $result.".";
1466 }
1468 return (preg_replace('/\.$/', '', $netmask));
1469 }
1471 return ($netmask);
1472 }
1475 function netmask_to_bits($netmask)
1476 {
1477 list($nm0, $nm1, $nm2, $nm3)= split('\.', $netmask);
1478 $res= 0;
1480 for ($n= 0; $n<4; $n++){
1481 $start= 255;
1482 $name= "nm$n";
1484 for ($i= 0; $i<8; $i++){
1485 if ($start == (int)($$name)){
1486 $res+= 8 - $i;
1487 break;
1488 }
1489 $start-= pow(2,$i);
1490 }
1491 }
1493 return ($res);
1494 }
1497 function recurse($rule, $variables)
1498 {
1499 $result= array();
1501 if (!count($variables)){
1502 return array($rule);
1503 }
1505 reset($variables);
1506 $key= key($variables);
1507 $val= current($variables);
1508 unset ($variables[$key]);
1510 foreach($val as $possibility){
1511 $nrule= preg_replace("/\{$key\}/", $possibility, $rule);
1512 $result= array_merge($result, recurse($nrule, $variables));
1513 }
1515 return ($result);
1516 }
1519 function expand_id($rule, $attributes)
1520 {
1521 /* Check for id rule */
1522 if(preg_match('/^id(:|#)\d+$/',$rule)){
1523 return (array("\{$rule}"));
1524 }
1526 /* Check for clean attribute */
1527 if (preg_match('/^%[a-zA-Z0-9]+$/', $rule)){
1528 $rule= preg_replace('/^%/', '', $rule);
1529 $val= rewrite(preg_replace('/ /', '', strtolower($attributes[$rule])));
1530 return (array($val));
1531 }
1533 /* Check for attribute with parameters */
1534 if (preg_match('/^%[a-zA-Z0-9]+\[[0-9-]+\]$/', $rule)){
1535 $param= preg_replace('/^[^[]+\[([^]]+)]$/', '\\1', $rule);
1536 $part= preg_replace('/^%/', '', preg_replace('/\[.*$/', '', $rule));
1537 $val= rewrite(preg_replace('/ /', '', strtolower($attributes[$part])));
1538 $start= preg_replace ('/-.*$/', '', $param);
1539 $stop = preg_replace ('/^[^-]+-/', '', $param);
1541 /* Assemble results */
1542 $result= array();
1543 for ($i= $start; $i<= $stop; $i++){
1544 $result[]= substr($val, 0, $i);
1545 }
1546 return ($result);
1547 }
1549 echo "Error in idgen string: don't know how to handle rule $rule.\n";
1550 return (array($rule));
1551 }
1554 function gen_uids($rule, $attributes)
1555 {
1556 global $config;
1558 /* Search for keys and fill the variables array with all
1559 possible values for that key. */
1560 $part= "";
1561 $trigger= false;
1562 $stripped= "";
1563 $variables= array();
1565 for ($pos= 0; $pos < strlen($rule); $pos++){
1567 if ($rule[$pos] == "{" ){
1568 $trigger= true;
1569 $part= "";
1570 continue;
1571 }
1573 if ($rule[$pos] == "}" ){
1574 $variables[$pos]= expand_id($part, $attributes);
1575 $stripped.= "\{$pos}";
1576 $trigger= false;
1577 continue;
1578 }
1580 if ($trigger){
1581 $part.= $rule[$pos];
1582 } else {
1583 $stripped.= $rule[$pos];
1584 }
1585 }
1587 /* Recurse through all possible combinations */
1588 $proposed= recurse($stripped, $variables);
1590 /* Get list of used ID's */
1591 $used= array();
1592 $ldap= $config->get_ldap_link();
1593 $ldap->cd($config->current['BASE']);
1594 $ldap->search('(uid=*)');
1596 while($attrs= $ldap->fetch()){
1597 $used[]= $attrs['uid'][0];
1598 }
1600 /* Remove used uids and watch out for id tags */
1601 $ret= array();
1602 foreach($proposed as $uid){
1604 /* Check for id tag and modify uid if needed */
1605 if(preg_match('/\{id:\d+}/',$uid)){
1606 $size= preg_replace('/^.*{id:(\d+)}.*$/', '\\1', $uid);
1608 for ($i= 0; $i < pow(10,$size); $i++){
1609 $number= sprintf("%0".$size."d", $i);
1610 $res= preg_replace('/{id:(\d+)}/', $number, $uid);
1611 if (!in_array($res, $used)){
1612 $uid= $res;
1613 break;
1614 }
1615 }
1616 }
1618 if(preg_match('/\{id#\d+}/',$uid)){
1619 $size= preg_replace('/^.*{id#(\d+)}.*$/', '\\1', $uid);
1621 while (true){
1622 mt_srand((double) microtime()*1000000);
1623 $number= sprintf("%0".$size."d", mt_rand(0, pow(10, $size)-1));
1624 $res= preg_replace('/{id#(\d+)}/', $number, $uid);
1625 if (!in_array($res, $used)){
1626 $uid= $res;
1627 break;
1628 }
1629 }
1630 }
1632 /* Don't assign used ones */
1633 if (!in_array($uid, $used)){
1634 $ret[]= $uid;
1635 }
1636 }
1638 return(array_unique($ret));
1639 }
1642 function array_search_r($needle, $key, $haystack){
1644 foreach($haystack as $index => $value){
1645 $match= 0;
1647 if (is_array($value)){
1648 $match= array_search_r($needle, $key, $value);
1649 }
1651 if ($index==$key && !is_array($value) && preg_match("/$needle/i", $value)){
1652 $match=1;
1653 }
1655 if ($match){
1656 return 1;
1657 }
1658 }
1660 return 0;
1661 }
1664 /* Sadly values like memory_limit are perpended by K, M, G, etc.
1665 Need to convert... */
1666 function to_byte($value) {
1667 $value= strtolower(trim($value));
1669 if(!is_numeric(substr($value, -1))) {
1671 switch(substr($value, -1)) {
1672 case 'g':
1673 $mult= 1073741824;
1674 break;
1675 case 'm':
1676 $mult= 1048576;
1677 break;
1678 case 'k':
1679 $mult= 1024;
1680 break;
1681 }
1683 return ($mult * (int)substr($value, 0, -1));
1684 } else {
1685 return $value;
1686 }
1687 }
1690 function in_array_ics($value, $items)
1691 {
1692 if (!is_array($items)){
1693 return (FALSE);
1694 }
1696 foreach ($items as $item){
1697 if (strtolower($item) == strtolower($value)) {
1698 return (TRUE);
1699 }
1700 }
1702 return (FALSE);
1703 }
1706 function generate_alphabet($count= 10)
1707 {
1708 $characters= _("*ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789");
1709 $alphabet= "";
1710 $c= 0;
1712 /* Fill cells with charaters */
1713 for ($i= 0; $i<mb_strlen($characters, 'UTF8'); $i++){
1714 if ($c == 0){
1715 $alphabet.= "<tr>";
1716 }
1718 $ch = mb_substr($characters, $i, 1, "UTF8");
1719 $alphabet.= "<td><a class=\"alphaselect\" href=\"main.php?plug=".
1720 validate($_GET['plug'])."&search=".$ch."\"> ".$ch." </a></td>";
1722 if ($c++ == $count){
1723 $alphabet.= "</tr>";
1724 $c= 0;
1725 }
1726 }
1728 /* Fill remaining cells */
1729 while ($c++ <= $count){
1730 $alphabet.= "<td> </td>";
1731 }
1733 return ($alphabet);
1734 }
1737 function validate($string)
1738 {
1739 return (strip_tags(preg_replace('/\0/', '', $string)));
1740 }
1742 function get_gosa_version()
1743 {
1744 global $svn_revision, $svn_path;
1746 /* Extract informations */
1747 $revision= preg_replace('/^[^0-9]*([0-9]+)[^0-9]*$/', '\1', $svn_revision);
1749 /* Release or development? */
1750 if (preg_match('%/gosa/trunk/%', $svn_path)){
1751 return (sprintf(_("GOsa development snapshot (Rev %s)"), $revision));
1752 } else {
1753 $release= preg_replace('%^.*/([^/]+)/include/functions.inc.*$%', '\1', $svn_path);
1754 return (sprintf(_("GOsa $release"), $revision));
1755 }
1756 }
1759 function rmdirRecursive($path, $followLinks=false) {
1760 $dir= opendir($path);
1761 while($entry= readdir($dir)) {
1762 if(is_file($path."/".$entry) || ((!$followLinks) && is_link($path."/".$entry))) {
1763 unlink($path."/".$entry);
1764 } elseif (is_dir($path."/".$entry) && $entry!='.' && $entry!='..') {
1765 rmdirRecursive($path."/".$entry);
1766 }
1767 }
1768 closedir($dir);
1769 return rmdir($path);
1770 }
1772 function scan_directory($path,$sort_desc=false)
1773 {
1774 $ret = false;
1776 /* is this a dir ? */
1777 if(is_dir($path)) {
1779 /* is this path a readable one */
1780 if(is_readable($path)){
1782 /* Get contents and write it into an array */
1783 $ret = array();
1785 $dir = opendir($path);
1787 /* Is this a correct result ?*/
1788 if($dir){
1789 while($fp = readdir($dir))
1790 $ret[]= $fp;
1791 }
1792 }
1793 }
1794 /* Sort array ascending , like scandir */
1795 sort($ret);
1797 /* Sort descending if parameter is sort_desc is set */
1798 if($sort_desc) {
1799 $ret = array_reverse($ret);
1800 }
1802 return($ret);
1803 }
1805 function clean_smarty_compile_dir($directory)
1806 {
1807 global $svn_revision;
1809 if(is_dir($directory) && is_readable($directory)) {
1810 // Set revision filename to REVISION
1811 $revision_file= $directory."/REVISION";
1813 /* Is there a stamp containing the current revision? */
1814 if(!file_exists($revision_file)) {
1815 // create revision file
1816 create_revision($revision_file, $svn_revision);
1817 } else {
1818 # check for "$config->...['CONFIG']/revision" and the
1819 # contents should match the revision number
1820 if(!compare_revision($revision_file, $svn_revision)){
1821 // If revision differs, clean compile directory
1822 foreach(scan_directory($directory) as $file) {
1823 if(($file==".")||($file=="..")) continue;
1824 if( is_file($directory."/".$file) &&
1825 is_writable($directory."/".$file)) {
1826 // delete file
1827 if(!unlink($directory."/".$file)) {
1828 print_red("File ".$directory."/".$file." could not be deleted.");
1829 // This should never be reached
1830 }
1831 } elseif(is_dir($directory."/".$file) &&
1832 is_writable($directory."/".$file)) {
1833 // Just recursively delete it
1834 rmdirRecursive($directory."/".$file);
1835 }
1836 }
1837 // We should now create a fresh revision file
1838 clean_smarty_compile_dir($directory);
1839 } else {
1840 // Revision matches, nothing to do
1841 }
1842 }
1843 } else {
1844 // Smarty compile dir is not accessible
1845 // (Smarty will warn about this)
1846 }
1847 }
1849 function create_revision($revision_file, $revision)
1850 {
1851 $result= false;
1853 if(is_dir(dirname($revision_file)) && is_writable(dirname($revision_file))) {
1854 if($fh= fopen($revision_file, "w")) {
1855 if(fwrite($fh, $revision)) {
1856 $result= true;
1857 }
1858 }
1859 fclose($fh);
1860 } else {
1861 print_red("Can not write to revision file");
1862 }
1864 return $result;
1865 }
1867 function compare_revision($revision_file, $revision)
1868 {
1869 // false means revision differs
1870 $result= false;
1872 if(file_exists($revision_file) && is_readable($revision_file)) {
1873 // Open file
1874 if($fh= fopen($revision_file, "r")) {
1875 // Compare File contents with current revision
1876 if($revision == fread($fh, filesize($revision_file))) {
1877 $result= true;
1878 }
1879 } else {
1880 print_red("Can not open revision file");
1881 }
1882 // Close file
1883 fclose($fh);
1884 }
1886 return $result;
1887 }
1889 function progressbar($percentage,$width=100,$height=15,$showvalue=false)
1890 {
1891 $str = ""; // Our return value will be saved in this var
1893 $color = dechex($percentage+150);
1894 $color2 = dechex(150 - $percentage);
1895 $bgcolor= $showvalue?"FFFFFF":"DDDDDD";
1897 $progress = (int)(($percentage /100)*$width);
1899 /* Abort printing out percentage, if divs are to small */
1902 /* If theres a better solution for this, use it... */
1903 $str = "
1904 <div style=\" width:".($width)."px;
1905 height:".($height)."px;
1906 background-color:#000000;
1907 padding:1px;\">
1909 <div style=\" width:".($width)."px;
1910 background-color:#$bgcolor;
1911 height:".($height)."px;\">
1913 <div style=\" width:".$progress."px;
1914 height:".$height."px;
1915 background-color:#".$color2.$color2.$color."; \">";
1918 if(($height >10)&&($showvalue)){
1919 $str.= "<font style=\"font-size:".($height-2)."px;color:#FF0000;align:middle;padding-left:".((int)(($width*0.4)))."px;\">
1920 <b>".$percentage."%</b>
1921 </font>";
1922 }
1924 $str.= "</div></div></div>";
1926 return($str);
1927 }
1930 function array_key_ics($ikey, $items)
1931 {
1932 /* Gather keys, make them lowercase */
1933 $tmp= array();
1934 foreach ($items as $key => $value){
1935 $tmp[strtolower($key)]= $key;
1936 }
1938 if (isset($tmp[strtolower($ikey)])){
1939 return($tmp[strtolower($ikey)]);
1940 }
1942 return ("");
1943 }
1946 function search_config($arr, $name, $return)
1947 {
1948 if (is_array($arr)){
1949 foreach ($arr as $a){
1950 if (isset($a['CLASS']) &&
1951 strtolower($a['CLASS']) == strtolower($name)){
1953 if (isset($a[$return])){
1954 return ($a[$return]);
1955 } else {
1956 return ("");
1957 }
1958 } else {
1959 $res= search_config ($a, $name, $return);
1960 if ($res != ""){
1961 return $res;
1962 }
1963 }
1964 }
1965 }
1966 return ("");
1967 }
1970 function array_differs($src, $dst)
1971 {
1972 /* If the count is differing, the arrays differ */
1973 if (count ($src) != count ($dst)){
1974 return (TRUE);
1975 }
1977 /* So the count is the same - lets check the contents */
1978 $differs= FALSE;
1979 foreach($src as $value){
1980 if (!in_array($value, $dst)){
1981 $differs= TRUE;
1982 }
1983 }
1985 return ($differs);
1986 }
1989 function saveFilter($a_filter, $values)
1990 {
1991 if (isset($_POST['regexit'])){
1992 $a_filter["regex"]= $_POST['regexit'];
1994 foreach($values as $type){
1995 if (isset($_POST[$type])) {
1996 $a_filter[$type]= "checked";
1997 } else {
1998 $a_filter[$type]= "";
1999 }
2000 }
2001 }
2003 /* React on alphabet links if needed */
2004 if (isset($_GET['search'])){
2005 $s= mb_substr(validate($_GET['search']), 0, 1, "UTF8")."*";
2006 if ($s == "**"){
2007 $s= "*";
2008 }
2009 $a_filter['regex']= $s;
2010 }
2012 return ($a_filter);
2013 }
2016 /* Escape all preg_* relevant characters */
2017 function normalizePreg($input)
2018 {
2019 return (addcslashes($input, '[]()|/.*+-'));
2020 }
2023 /* Escape all LDAP filter relevant characters */
2024 function normalizeLdap($input)
2025 {
2026 return (addcslashes($input, '()|'));
2027 }
2030 /* Resturns the difference between to microtime() results in float */
2031 function get_MicroTimeDiff($start , $stop)
2032 {
2033 $a = split("\ ",$start);
2034 $b = split("\ ",$stop);
2036 $secs = $b[1] - $a[1];
2037 $msecs= $b[0] - $a[0];
2039 $ret = (float) ($secs+ $msecs);
2040 return($ret);
2041 }
2044 /* Check if the given department name is valid */
2045 function is_department_name_reserved($name,$base)
2046 {
2047 $reservedName = array("systems","apps","incomming","internal","accounts","fax","addressbook",
2048 preg_replace("/ou=(.*),/","\\1",get_people_ou()),
2049 preg_replace("/ou=(.*),/","\\1",get_groups_ou()));
2050 $follwedNames['/ou=fai,ou=configs,ou=systems,/'] = array("fai","hooks","templates","scripts","disk","packages","variables","profiles");
2052 /* Check if name is one of the reserved names */
2053 if(in_array_ics($name,$reservedName)) {
2054 return(true);
2055 }
2057 /* Check all follow combinations if name is in array && parent base == array_key, return false*/
2058 foreach($follwedNames as $key => $names){
2059 if((in_array_ics($name,$names)) && (preg_match($key,$base))){
2060 return(true);
2061 }
2062 }
2063 return(false);
2064 }
2067 function get_base_dir()
2068 {
2069 global $BASE_DIR;
2071 return $BASE_DIR;
2072 }
2075 function obj_is_readable($dn, $object, $attribute)
2076 {
2077 global $ui;
2079 return preg_match('/r/', $ui->get_permissions($dn, $object, $attribute));
2080 }
2083 function obj_is_writable($dn, $object, $attribute)
2084 {
2085 global $ui;
2087 return preg_match('/w/', $ui->get_permissions($dn, $object, $attribute));
2088 }
2091 function gosa_ldap_explode_dn($dn,$config = NULL,$verify_in_ldap=false)
2092 {
2093 /* Initialize variables */
2094 $ret = array("count" => 0); // Set count to 0
2095 $next = true; // if false, then skip next loops and return
2096 $cnt = 0; // Current number of loops
2097 $max = 100; // Just for security, prevent looops
2098 $ldap = NULL; // To check if created result a valid
2099 $keep = ""; // save last failed parse string
2101 /* Check each parsed dn in ldap ? */
2102 if($config!=NULL && $verify_in_ldap){
2103 $ldap = $config->get_ldap_link();
2104 }
2106 /* Lets start */
2107 $called = false;
2108 while(preg_match("/,/",$dn) && $next && $cnt < $max){
2110 $cnt ++;
2111 if(!preg_match("/,/",$dn)){
2112 $next = false;
2113 }
2114 $object = preg_replace("/[,].*$/","",$dn);
2115 $dn = preg_replace("/^[^,]+,/","",$dn);
2117 $called = true;
2119 /* Check if current dn is valid */
2120 if($ldap!=NULL){
2121 $ldap->cd($dn);
2122 $ldap->cat($dn,array("dn"));
2123 if($ldap->count()){
2124 $ret[] = $keep.$object;
2125 $keep = "";
2126 }else{
2127 $keep .= $object.",";
2128 }
2129 }else{
2130 $ret[] = $keep.$object;
2131 $keep = "";
2132 }
2133 }
2135 /* No dn was posted */
2136 if($cnt == 0 && !empty($dn)){
2137 $ret[] = $dn;
2138 }
2140 /* Append the rest */
2141 $test = $keep.$dn;
2142 if($called && !empty($test)){
2143 $ret[] = $keep.$dn;
2144 }
2145 $ret['count'] = count($ret) - 1;
2147 return($ret);
2148 }
2150 function is_php4()
2151 {
2152 if (isset($_SESSION['PHP4COMPATIBLE'])){
2153 return true;
2154 }
2155 return (preg_match('/^4/', phpversion()));
2156 }
2158 /* Add "str_split" if this function is missing.
2159 * This function is only available in PHP5
2160 */
2161 if(!function_exists("str_split")){
2162 function str_split($str,$length =1)
2163 {
2164 if($length < 1 ) $length =1;
2166 $ret = array();
2167 for($i = 0 ; $i < strlen($str); $i = $i +$length){
2168 $ret[] = substr($str,$i ,$length);
2169 }
2170 return($ret);
2171 }
2172 }
2175 function get_base_from_hook($dn, $attrib)
2176 {
2177 global $config;
2179 if (isset($config->current['BASE_HOOK'])){
2181 /* Call hook script - if present */
2182 $command= $config->current['BASE_HOOK'];
2184 if ($command != ""){
2185 $command.= " '$dn' $attrib";
2186 if (check_command($command)){
2187 @DEBUG (DEBUG_SHELL, __LINE__, __FUNCTION__, __FILE__, $command, "Execute");
2188 exec($command, $output);
2189 if (preg_match("/^[0-9]+$/", $output[0])){
2190 return ($output[0]);
2191 } else {
2192 print_red(_("Warning - base_hook is not available. Using default base."));
2193 return ($config->current['UIDBASE']);
2194 }
2195 } else {
2196 print_red(_("Warning - base_hook is not available. Using default base."));
2197 return ($config->current['UIDBASE']);
2198 }
2200 } else {
2202 print_red(_("Warning - no base_hook defined. Using default base."));
2203 return ($config->current['UIDBASE']);
2205 }
2206 }
2207 }
2209 /* Schema validation functions */
2211 function check_schema_version($class, $version)
2212 {
2213 return preg_match("/\(v$version\)/", $class['DESC']);
2214 }
2216 function check_schema($cfg,$rfc2307bis = FALSE)
2217 {
2218 $messages= array();
2220 /* Get objectclasses */
2221 $ldap = new LDAP($cfg['admin'],$cfg['password'],$cfg['connection'] ,FALSE,$cfg['tls']);
2222 $objectclasses = $ldap->get_objectclasses();
2223 if(count($objectclasses) == 0){
2224 print_red(_("Can't get schema information from server. No schema check possible!"));
2225 }
2227 /* This is the default block used for each entry.
2228 * to avoid unset indexes.
2229 */
2230 $def_check = array("REQUIRED_VERSION" => "0",
2231 "SCHEMA_FILES" => array(),
2232 "CLASSES_REQUIRED" => array(),
2233 "STATUS" => FALSE,
2234 "IS_MUST_HAVE" => FALSE,
2235 "MSG" => "",
2236 "INFO" => "");#_("There is currently no information specified for this schema extension."));
2238 /* The gosa base schema */
2239 $checks['gosaObject'] = $def_check;
2240 $checks['gosaObject']['REQUIRED_VERSION'] = "2.4";
2241 $checks['gosaObject']['SCHEMA_FILES'] = array("gosa+samba3.schema","gosa.schema");
2242 $checks['gosaObject']['CLASSES_REQUIRED'] = array("gosaObject");
2243 $checks['gosaObject']['IS_MUST_HAVE'] = TRUE;
2245 /* GOsa Account class */
2246 $checks["gosaAccount"]["REQUIRED_VERSION"]= "2.4";
2247 $checks["gosaAccount"]["SCHEMA_FILES"] = array("gosa+samba3.schema","gosa.schema");
2248 $checks["gosaAccount"]["CLASSES_REQUIRED"]= array("gosaAccount");
2249 $checks["gosaAccount"]["IS_MUST_HAVE"] = TRUE;
2250 $checks["gosaAccount"]["INFO"] = _("Used to store account specific informations.");
2252 /* GOsa lock entry, used to mark currently edited objects as 'in use' */
2253 $checks["gosaLockEntry"]["REQUIRED_VERSION"] = "2.4";
2254 $checks["gosaLockEntry"]["SCHEMA_FILES"] = array("gosa+samba3.schema","gosa.schema");
2255 $checks["gosaLockEntry"]["CLASSES_REQUIRED"] = array("gosaLockEntry");
2256 $checks["gosaLockEntry"]["IS_MUST_HAVE"] = TRUE;
2257 $checks["gosaLockEntry"]["INFO"] = _("Used to lock currently edited entries to avoid multiple changes at the same time.");
2259 /* Some other checks */
2260 foreach(array(
2261 "gosaCacheEntry" => array("version" => "2.4"),
2262 "gosaDepartment" => array("version" => "2.4"),
2263 "goFaxAccount" => array("version" => "1.0.4", "class" => "gofaxAccount","file" => "gofax.schema"),
2264 "goFaxSBlock" => array("version" => "1.0.4", "class" => "gofaxAccount","file" => "gofax.schema"),
2265 "goFaxRBlock" => array("version" => "1.0.4", "class" => "gofaxAccount","file" => "gofax.schema"),
2266 "gosaUserTemplate" => array("version" => "2.4", "class" => "posixAccount","file" => "nis.schema"),
2267 "gosaMailAccount" => array("version" => "2.4", "class" => "mailAccount","file" => "gosa+samba3.schema"),
2268 "gosaProxyAccount" => array("version" => "2.4", "class" => "proxyAccount","file" => "gosa+samba3.schema"),
2269 "gosaApplication" => array("version" => "2.4", "class" => "appgroup","file" => "gosa.schema"),
2270 "gosaApplicationGroup" => array("version" => "2.4", "class" => "appgroup","file" => "gosa.schema"),
2271 "GOhard" => array("version" => "2.5", "class" => "terminals","file" => "goto.schema"),
2272 "gotoTerminal" => array("version" => "2.5", "class" => "terminals","file" => "goto.schema"),
2273 "goServer" => array("version" => "2.4","class" => "server","file" => "goserver.schema"),
2274 "goTerminalServer" => array("version" => "2.4", "class" => "terminals","file" => "goto.schema"),
2275 "goShareServer" => array("version" => "2.4", "class" => "terminals","file" => "goto.schema"),
2276 "goNtpServer" => array("version" => "2.4", "class" => "terminals","file" => "goto.schema"),
2277 "goSyslogServer" => array("version" => "2.4", "class" => "terminals","file" => "goto.schema"),
2278 "goLdapServer" => array("version" => "2.4"),
2279 "goCupsServer" => array("version" => "2.4", "class" => array("posixAccount", "terminals"),),
2280 "goImapServer" => array("version" => "2.4", "class" => array("mailAccount", "mailgroup"),"file" => "gosa+samba3. schema"),
2281 "goKrbServer" => array("version" => "2.4"),
2282 "goFaxServer" => array("version" => "2.4", "class" => "gofaxAccount","file" => "gofax.schema"),
2283 ) as $name => $values){
2285 $checks[$name] = $def_check;
2286 if(isset($values['version'])){
2287 $checks[$name]["REQUIRED_VERSION"] = $values['version'];
2288 }
2289 if(isset($values['file'])){
2290 $checks[$name]["SCHEMA_FILES"] = array($values['file']);
2291 }
2292 $checks[$name]["CLASSES_REQUIRED"] = array($name);
2293 }
2294 foreach($checks as $name => $value){
2295 foreach($value['CLASSES_REQUIRED'] as $class){
2297 if(!isset($objectclasses[$name])){
2298 $checks[$name]['STATUS'] = FALSE;
2299 if($value['IS_MUST_HAVE']){
2300 $checks[$name]['MSG'] = sprintf(_("The required objectClass '%s' is not present in your schema setup"),$class);
2301 }else{
2302 $checks[$name]['MSG'] = sprintf(_("The optional objectClass '%s' is not present in your schema setup"),$class);
2303 }
2304 }elseif(!check_schema_version($objectclasses[$name],$value['REQUIRED_VERSION'])){
2305 $checks[$name]['STATUS'] = FALSE;
2307 if($value['IS_MUST_HAVE']){
2308 $checks[$name]['MSG'] = sprintf(_("The required objectclass '%s' does not have version %s"), $class, $value['REQUIRED_VERSION']);
2309 }else{
2310 $checks[$name]['MSG'] = sprintf(_("The optional objectclass '%s' does not have version %s"), $class, $value['REQUIRED_VERSION']);
2311 }
2312 }else{
2313 $checks[$name]['STATUS'] = TRUE;
2314 $checks[$name]['MSG'] = sprintf(_("Class(es) available"));
2315 }
2316 }
2317 }
2319 $tmp = $objectclasses;
2321 /* The gosa base schema */
2322 $checks['posixGroup'] = $def_check;
2323 $checks['posixGroup']['REQUIRED_VERSION'] = "2.4";
2324 $checks['posixGroup']['SCHEMA_FILES'] = array("gosa+samba3.schema","gosa.schema");
2325 $checks['posixGroup']['CLASSES_REQUIRED'] = array("posixGroup");
2326 $checks['posixGroup']['STATUS'] = TRUE;
2327 $checks['posixGroup']['IS_MUST_HAVE'] = TRUE;
2328 $checks['posixGroup']['MSG'] = "";
2329 $checks['posixGroup']['INFO'] = "";
2331 /* Depending on selected rfc2307bis mode, we need different schema configurations */
2332 if(isset($tmp['posixGroup'])){
2334 if($rfc2307bis && isset($tmp['posixGroup']['STRUCTURAL'])){
2335 $checks['posixGroup']['STATUS'] = FALSE;
2336 $checks['posixGroup']['MSG'] = _("You have enabled the rfc2307bis option on the 'ldap setup' step, but your schema configuration do not support this option.");
2337 $checks['posixGroup']['INFO'] = _("In order to use rfc2307bis conform groups the objectClass 'posixGroup' must be AUXILIARY");
2338 }
2339 if(!$rfc2307bis && !isset($tmp['posixGroup']['STRUCTURAL'])){
2340 $checks['posixGroup']['STATUS'] = FALSE;
2341 $checks['posixGroup']['MSG'] = _("You have disabled the rfc2307bis option on the 'ldap setup' step, but your schema configuration do not support this option.");
2342 $checks['posixGroup']['INFO'] = _("The objectClass 'posixGroup' must be STRUCTURAL");
2343 }
2344 }
2346 return($checks);
2347 }
2349 // vim:tabstop=2:expandtab:shiftwidth=2:filetype=php:syntax:ruler:
2350 ?>