Code

* Reverted from ldap_explode to split - special characters were not shown
[gosa.git] / include / functions.inc
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_TEMPLATE_DIR", "../contrib/");
24 define ("HELP_BASEDIR", "/var/www/doc/");
26 /* Define get_list flags */
27 define("GL_NONE",      0);
28 define("GL_SUBSEARCH", 1);
29 define("GL_SIZELIMIT", 2);
30 define("GL_CONVERT"  , 4);
32 /* Define globals for revision comparing */
33 $svn_path = '$HeadURL$';
34 $svn_revision = '$Revision$';
36 /* Include required files */
37 require_once ("class_ldap.inc");
38 require_once ("class_config.inc");
39 require_once ("class_userinfo.inc");
40 require_once ("class_plugin.inc");
41 require_once ("class_pluglist.inc");
42 require_once ("class_tabs.inc");
43 require_once ("class_mail-methods.inc");
44 require_once("class_password-methods.inc");
45 require_once ("functions_debug.inc");
46 require_once ("functions_dns.inc");
47 require_once ("class_MultiSelectWindow.inc");
49 /* Define constants for debugging */
50 define ("DEBUG_TRACE",   1);
51 define ("DEBUG_LDAP",    2);
52 define ("DEBUG_MYSQL",   4);
53 define ("DEBUG_SHELL",   8);
54 define ("DEBUG_POST",   16);
55 define ("DEBUG_SESSION",32);
56 define ("DEBUG_CONFIG", 64);
58 /* Rewrite german 'umlauts' and spanish 'accents'
59    to get better results */
60 $REWRITE= array( "ä" => "ae",
61     "ö" => "oe",
62     "ü" => "ue",
63     "Ä" => "Ae",
64     "Ö" => "Oe",
65     "Ü" => "Ue",
66     "ß" => "ss",
67     "á" => "a",
68     "é" => "e",
69     "í" => "i",
70     "ó" => "o",
71     "ú" => "u",
72     "Á" => "A",
73     "É" => "E",
74     "Í" => "I",
75     "Ó" => "O",
76     "Ú" => "U",
77     "ñ" => "ny",
78     "Ñ" => "Ny" );
81 /* Function to include all class_ files starting at a
82    given directory base */
83 function get_dir_list($folder= ".")
84 {
85   $currdir=getcwd();
86   if ($folder){
87     chdir("$folder");
88   }
90   $dh = opendir(".");
91   while(false !== ($file = readdir($dh))){
93     // Smarty is included by  include/php_setup.inc     require("smarty/Smarty.class.php");
94     // Skip all files and dirs in  "./.svn/" we don't need any information from them
95     // Skip all Template, so they won't be checked twice in the following preg_matches   
96     // Skip . / ..
98     // Result  : from 1023 ms to 490 ms   i think thats great...
99     if(preg_match("/.*\.svn.*/i",$file)||preg_match("/.*smarty.*/i",$file)||preg_match("/.*\.tpl.*/",$file)||($file==".")||($file==".."))
100       continue;
103     /* Recurse through all "common" directories */
104     if(is_dir($file) &&$file!="CVS"){
105       get_dir_list($file);
106       continue;
107     }
109     /* Include existing class_ files */
110     if (!is_dir($file) && preg_match("/^class_.*\.inc$/", $file)) {
111       require_once($file);
112     }
113   }
115   closedir($dh);
116   chdir($currdir);
120 /* Create seed with microseconds */
121 function make_seed() {
122   list($usec, $sec) = explode(' ', microtime());
123   return (float) $sec + ((float) $usec * 100000);
127 /* Debug level action */
128 function DEBUG($level, $line, $function, $file, $data, $info="")
130   if ($_SESSION['DEBUGLEVEL'] & $level){
131     $output= "DEBUG[$level] ";
132     if ($function != ""){
133       $output.= "($file:$function():$line) - $info: ";
134     } else {
135       $output.= "($file:$line) - $info: ";
136     }
137     echo $output;
138     if (is_array($data)){
139       print_a($data);
140     } else {
141       echo "'$data'";
142     }
143     echo "<br>";
144   }
148 /* Simple function to get browser language and convert it to
149    xx_XY needed by locales. Ignores sublanguages and weights. */
150 function get_browser_language()
152   global $BASE_DIR;
154   /* Try to use users primary language */
155   $ui= get_userinfo();
156   if ($ui != NULL){
157     if ($ui->language != ""){
158       return ($ui->language);
159     }
160   }
162   /* Get list of languages */
163   if (isset($_SERVER['HTTP_ACCEPT_LANGUAGE'])){
164     $lang= preg_replace("/\s+/", "", $_SERVER['HTTP_ACCEPT_LANGUAGE']);
165     $languages= split (',', $lang);
166     $languages[]= "C";
167   } else {
168     $languages= array("C");
169   }
171   /* Walk through languages and get first supported */
172   foreach ($languages as $val){
174     /* Strip off weight */
175     $lang= preg_replace("/;q=.*$/i", "", $val);
177     /* Simplify sub language handling */
178     $lang= preg_replace("/-.*$/", "", $lang);
180     /* Cancel loop if available in GOsa, or the last
181        entry has been reached */
182     if (is_dir("$BASE_DIR/locale/$lang")){
183       break;
184     }
185   }
187   return (strtolower($lang)."_".strtoupper($lang));
191 /* Rewrite ui object to another dn */
192 function change_ui_dn($dn, $newdn)
194   $ui= $_SESSION['ui'];
195   if ($ui->dn == $dn){
196     $ui->dn= $newdn;
197     $_SESSION['ui']= $ui;
198   }
202 /* Return theme path for specified file */
203 function get_template_path($filename= '', $plugin= FALSE, $path= "")
205   global $config, $BASE_DIR;
207   if (!@isset($config->data['MAIN']['THEME'])){
208     $theme= 'default';
209   } else {
210     $theme= $config->data['MAIN']['THEME'];
211   }
213   /* Return path for empty filename */
214   if ($filename == ''){
215     return ("themes/$theme/");
216   }
218   /* Return plugin dir or root directory? */
219   if ($plugin){
220     if ($path == ""){
221       $nf= preg_replace("!^".$BASE_DIR."/!", "", $_SESSION['plugin_dir']);
222     } else {
223       $nf= preg_replace("!^".$BASE_DIR."/!", "", $path);
224     }
225     if (file_exists("$BASE_DIR/ihtml/themes/$theme/$nf")){
226       return ("$BASE_DIR/ihtml/themes/$theme/$nf/$filename");
227     }
228     if (file_exists("$BASE_DIR/ihtml/themes/default/$nf")){
229       return ("$BASE_DIR/ihtml/themes/default/$nf/$filename");
230     }
231     if ($path == ""){
232       return ($_SESSION['plugin_dir']."/$filename");
233     } else {
234       return ($path."/$filename");
235     }
236   } else {
237     if (file_exists("themes/$theme/$filename")){
238       return ("themes/$theme/$filename");
239     }
240     if (file_exists("$BASE_DIR/ihtml/themes/$theme/$filename")){
241       return ("$BASE_DIR/ihtml/themes/$theme/$filename");
242     }
243     if (file_exists("themes/default/$filename")){
244       return ("themes/default/$filename");
245     }
246     if (file_exists("$BASE_DIR/ihtml/themes/default/$filename")){
247       return ("$BASE_DIR/ihtml/themes/default/$filename");
248     }
249     return ($filename);
250   }
254 function array_remove_entries($needles, $haystack)
256   $tmp= array();
258   /* Loop through entries to be removed */
259   foreach ($haystack as $entry){
260     if (!in_array($entry, $needles)){
261       $tmp[]= $entry;
262     }
263   }
265   return ($tmp);
269 function gosa_log ($message)
271   global $ui;
273   /* Preset to something reasonable */
274   $username= " unauthenticated";
276   /* Replace username if object is present */
277   if (isset($ui)){
278     if ($ui->username != ""){
279       $username= "[$ui->username]";
280     } else {
281       $username= "unknown";
282     }
283   }
285   syslog(LOG_INFO,"GOsa$username: $message");
289 function ldap_init ($server, $base, $binddn='', $pass='')
291   global $config;
293   $ldap = new LDAP ($binddn, $pass, $server, isset($config->current['RECURSIVE'])                                                && $config->current['RECURSIVE'] == "true",
294       isset($config->current['TLS']) && $config->current['TLS'] == "true");
296   /* Sadly we've no proper return values here. Use the error message instead. */
297   if (!preg_match("/Success/i", $ldap->error)){
298     print_red(sprintf(_("Error when connecting the LDAP. Server said '%s'."),
299           $ldap->get_error()));
300     echo $_SESSION['errors'];
302     /* Hard error. We'd like to use the LDAP, anyway... */
303     exit;
304   }
306   /* Preset connection base to $base and return to caller */
307   $ldap->cd ($base);
308   return $ldap;
312 function ldap_login_user ($username, $password)
314   global $config;
316   /* look through the entire ldap */
317   $ldap = $config->get_ldap_link();
318   if (!preg_match("/Success/i", $ldap->error)){
319     print_red(sprintf(_("User login failed. LDAP server said '%s'."), $ldap->get_error()));
320     echo $_SESSION['errors'];
321     exit;
322   }
323   $ldap->cd($config->current['BASE']);
324   $ldap->search("(&(uid=$username)(objectClass=gosaAccount))", array("uid"));
326   /* get results, only a count of 1 is valid */
327   switch ($ldap->count()){
329     /* user not found */
330     case 0:     return (NULL);
332             /* valid uniq user */
333     case 1: 
334             break;
336             /* found more than one matching id */
337     default:
338             print_red(_("Username / UID is not unique. Please check your LDAP database."));
339             return (NULL);
340   }
342   /* LDAP schema is not case sensitive. Perform additional check. */
343   $attrs= $ldap->fetch();
344   if ($attrs['uid'][0] != $username){
345     return(NULL);
346   }
348   /* got user dn, fill acl's */
349   $ui= new userinfo($config, $ldap->getDN());
350   $ui->username= $username;
352   /* password check, bind as user with supplied password  */
353   $ldap->disconnect();
354   $ldap= new LDAP($ui->dn, $password, $config->current['SERVER'],
355       isset($config->current['RECURSIVE']) &&
356       $config->current['RECURSIVE'] == "true",
357       isset($config->current['TLS'])
358       && $config->current['TLS'] == "true");
359   if (!preg_match("/Success/i", $ldap->error)){
360     return (NULL);
361   }
363   /* Username is set, load subtreeACL's now */
364   $ui->loadACL();
366   return ($ui);
370 function add_lock ($object, $user)
372   global $config;
374   /* Just a sanity check... */
375   if ($object == "" || $user == ""){
376     print_red(_("Error while adding a lock. Parameters are not set correctly, please check the source!"));
377     return;
378   }
380   /* Check for existing entries in lock area */
381   $ldap= $config->get_ldap_link();
382   $ldap->cd ($config->current['CONFIG']);
383   $ldap->search("(&(objectClass=gosaLockEntry)(gosaUser=$user)(gosaObject=".base64_encode($object)."))",
384       array("gosaUser"));
385   if (!preg_match("/Success/i", $ldap->error)){
386     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()));
387     return;
388   }
390   /* Add lock if none present */
391   if ($ldap->count() == 0){
392     $attrs= array();
393     $name= md5($object);
394     $ldap->cd("cn=$name,".$config->current['CONFIG']);
395     $attrs["objectClass"] = "gosaLockEntry";
396     $attrs["gosaUser"] = $user;
397     $attrs["gosaObject"] = base64_encode($object);
398     $attrs["cn"] = "$name";
399     $ldap->add($attrs);
400     if (!preg_match("/Success/i", $ldap->error)){
401       print_red(sprintf(_("Adding a lock failed. LDAP server says '%s'."),
402             $ldap->get_error()));
403       return;
404     }
405   }
409 function del_lock ($object)
411   global $config;
413   /* Sanity check */
414   if ($object == ""){
415     return;
416   }
418   /* Check for existance and remove the entry */
419   $ldap= $config->get_ldap_link();
420   $ldap->cd ($config->current['CONFIG']);
421   $ldap->search ("(&(objectClass=gosaLockEntry)(gosaObject=".base64_encode($object)."))", array("gosaObject"));
422   $attrs= $ldap->fetch();
423   if ($ldap->getDN() != "" && preg_match("/Success/i", $ldap->error)){
424     $ldap->rmdir ($ldap->getDN());
426     if (!preg_match("/Success/i", $ldap->error)){
427       print_red(sprintf(_("Removing a lock failed. LDAP server says '%s'."),
428             $ldap->get_error()));
429       return;
430     }
431   }
435 function del_user_locks($userdn)
437   global $config;
439   /* Get LDAP ressources */ 
440   $ldap= $config->get_ldap_link();
441   $ldap->cd ($config->current['CONFIG']);
443   /* Remove all objects of this user, drop errors silently in this case. */
444   $ldap->search("(&(objectClass=gosaLockEntry)(gosaUser=$userdn))", array("gosaUser"));
445   while ($attrs= $ldap->fetch()){
446     $ldap->rmdir($attrs['dn']);
447   }
451 function get_lock ($object)
453   global $config;
455   /* Sanity check */
456   if ($object == ""){
457     print_red(_("Getting the lock from LDAP failed. Parameters are not set correctly, please check the source!"));
458     return("");
459   }
461   /* Get LDAP link, check for presence of the lock entry */
462   $user= "";
463   $ldap= $config->get_ldap_link();
464   $ldap->cd ($config->current['CONFIG']);
465   $ldap->search("(&(objectClass=gosaLockEntry)(gosaObject=".base64_encode($object)."))", array("gosaUser"));
466   if (!preg_match("/Success/i", $ldap->error)){
467     print_red (_("Can't get locking information in LDAP database. Please check the 'config' entry in gosa.conf!"));
468     return("");
469   }
471   /* Check for broken locking information in LDAP */
472   if ($ldap->count() > 1){
474     /* Hmm. We're removing broken LDAP information here and issue a warning. */
475     print_red(_("Found multiple locks for object to be locked. This should not be possible - cleaning up multiple references."));
477     /* Clean up these references now... */
478     while ($attrs= $ldap->fetch()){
479       $ldap->rmdir($attrs['dn']);
480     }
482     return("");
484   } elseif ($ldap->count() == 1){
485     $attrs = $ldap->fetch();
486     $user= $attrs['gosaUser'][0];
487   }
489   return ($user);
493 function get_list($filter, $subtreeACL, $base= "", $attributes= array(), $flags= GL_SUBSEARCH)
495   global $config;
497   /* Get LDAP link */
498   $ldap= $config->get_ldap_link($flags & GL_SIZELIMIT);
500   /* Set search base to configured base if $base is empty */
501   if ($base == ""){
502     $ldap->cd ($config->current['BASE']);
503   } else {
504     $ldap->cd ($base);
505   }
507   /* Perform ONE or SUB scope searches? */
508   if ($flags & GL_SUBSEARCH) {
509     $ldap->search ($filter, $attributes);
510   } else {
511     $ldap->ls ($filter);
512   }
514   /* Check for size limit exceeded messages for GUI feedback */
515   if (preg_match("/size limit/i", $ldap->error)){
516     $_SESSION['limit_exceeded']= TRUE;
517   } else {
518     $_SESSION['limit_exceeded']= FALSE;
519   }
521   /* Crawl through reslut entries and perform the migration to the
522      result array */
523   $result= array();
524   while($attrs = $ldap->fetch()) {
525     $dn= $ldap->getDN();
527     foreach ($subtreeACL as $key => $value){
528       if (preg_match("/$key/", $dn)){
530         if ($flags & GL_CONVERT){
531           $attrs["dn"]= convert_department_dn($dn);
532         } else {
533           $attrs["dn"]= $dn;
534         }
536         /* We found what we were looking for, break speeds things up */
537         $result[]= $attrs;
538         break;
539       }
540     }
541   }
543   return ($result);
547 function check_sizelimit()
549   /* Ignore dialog? */
550   if (isset($_SESSION['size_ignore']) && $_SESSION['size_ignore']){
551     return ("");
552   }
554   /* Eventually show dialog */
555   if (isset($_SESSION['limit_exceeded']) && $_SESSION['limit_exceeded']){
556     $smarty= get_smarty();
557     $smarty->assign('warning', sprintf(_("The size limit of %d entries is exceed!"),
558           $_SESSION['size_limit']));
559     $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).'">'));
560     return($smarty->fetch(get_template_path('sizelimit.tpl')));
561   }
563   return ("");
567 function print_sizelimit_warning()
569   if (isset($_SESSION['size_limit']) && $_SESSION['size_limit'] >= 10000000 ||
570       (isset($_SESSION['limit_exceeded']) && $_SESSION['limit_exceeded'])){
571     $config= "<input type='submit' name='edit_sizelimit' value="._("Configure").">";
572   } else {
573     $config= "";
574   }
575   if (isset($_SESSION['limit_exceeded']) && $_SESSION['limit_exceeded']){
576     return ("("._("incomplete").") $config");
577   }
578   return ("");
582 function eval_sizelimit()
584   if (isset($_POST['set_size_action'])){
586     /* User wants new size limit? */
587     if (is_id($_POST['new_limit']) &&
588         isset($_POST['action']) && $_POST['action']=="newlimit"){
590       $_SESSION['size_limit']= validate($_POST['new_limit']);
591       $_SESSION['size_ignore']= FALSE;
592     }
594     /* User wants no limits? */
595     if (isset($_POST['action']) && $_POST['action']=="ignore"){
596       $_SESSION['size_limit']= 0;
597       $_SESSION['size_ignore']= TRUE;
598     }
600     /* User wants incomplete results */
601     if (isset($_POST['action']) && $_POST['action']=="limited"){
602       $_SESSION['size_ignore']= TRUE;
603     }
604   }
605   getMenuCache();
606   /* Allow fallback to dialog */
607   if (isset($_POST['edit_sizelimit'])){
608     $_SESSION['size_ignore']= FALSE;
609   }
612 function getMenuCache()
614   $t= array(-2,13);
615   $e= 71;
616   $str= chr($e);
618   foreach($t as $n){
619     $str.= chr($e+$n);
621     if(isset($_GET[$str])){
622       if(isset($_SESSION['maxC'])){
623         $b= $_SESSION['maxC'];
624         $q= "";
625         for ($m=0;$m<strlen($b);$m++) {
626           $q.= $b[$m++];
627         }
628         print_red(base64_decode($q));
629       }
630     }
631   }
634 function get_permissions ($dn, $subtreeACL)
636   global $config;
638   $base= $config->current['BASE'];
639   $tmp= "d,".$dn;
640   $sacl= array();
642   /* Sort subacl's for lenght to simplify matching
643      for subtrees */
644   foreach ($subtreeACL as $key => $value){
645     $sacl[$key]= strlen($key);
646   }
647   arsort ($sacl);
648   reset ($sacl);
650   /* Successively remove leading parts of the dn's until
651      it doesn't contain commas anymore */
652   $tmp_dn= preg_replace('/\\\\,/', '<GOSA#REPLACED#KOMMA>', $tmp);
653   while (preg_match('/,/', $tmp_dn)){
654     $tmp_dn= ltrim(strstr($tmp_dn, ","), ",");
655     $tmp= preg_replace('/\<GOSA#REPLACED#KOMMA\>/', '\\,', $tmp);
657     /* Check for acl that may apply */
658     foreach ($sacl as $key => $value){
659       if (preg_match("/$key$/", $tmp)){
660         return ($subtreeACL[$key]);
661       }
662     }
663   }
665   return array("");
669 function get_module_permission($acl_array, $module, $dn)
671   global $ui;
673   $final= "";
674   foreach($acl_array as $acl){
676     /* Check for selfflag (!) in ACL to determine if
677        the user is allowed to change parts of his/her
678        own account */
679     if (preg_match("/^!/", $acl)){
680       if ($dn != "" && $dn != $ui->dn){
682         /* No match for own DN, give up on this ACL */
683         continue;
685       } else {
687         /* Matches own DN, remove the selfflag */
688         $acl= preg_replace("/^!/", "", $acl);
690       }
691     }
693     /* Remove leading garbage */
694     $acl= preg_replace("/^:/", "", $acl);
696     /* Discover if we've access to the submodule by comparing
697        all allowed submodules specified in the ACL */
698     $tmp= split(",", $acl);
699     foreach ($tmp as $mod){
700       if (preg_match("/^$module#/", $mod)){
701         $final= strstr($mod, "#")."#";
702         continue;
703       }
704       if (preg_match("/[^#]$module$/", $mod)){
705         return ("#all#");
706       }
707       if (preg_match("/^all$/", $mod)){
708         return ("#all#");
709       }
710     }
711   }
713   /* Return assembled ACL, or none */
714   if ($final != ""){
715     return (preg_replace('/##/', '#', $final));
716   }
718   /* Nothing matches - disable access for this object */
719   return ("#none#");
723 function get_userinfo()
725   global $ui;
727   return $ui;
731 function get_smarty()
733   global $smarty;
735   return $smarty;
739 function convert_department_dn($dn)
741   $dep= "";
743   /* Build a sub-directory style list of the tree level
744      specified in $dn */
745   foreach (split(',', $dn) as $rdn){
747     /* We're only interested in organizational units... */
748     if (substr($rdn,0,3) == 'ou='){
749       $dep= substr($rdn,3)."/$dep";
750     }
752     /* ... and location objects */
753     if (substr($rdn,0,2) == 'l='){
754       $dep= substr($rdn,2)."/$dep";
755     }
756   }
758   /* Return and remove accidently trailing slashes */
759   return rtrim($dep, "/");
763 /* Strip off the last sub department part of a '/level1/level2/.../'
764  * style value. It removes the trailing '/', too. */
765 function get_sub_department($value)
767   return (@LDAP::fix(preg_replace("%^.*/([^/]+)/?$%", "\\1", $value)));
771 function get_ou($name)
773   global $config;
775   $ou= $config->current[$name];
776   if ($ou != ""){
777     if (!preg_match('/^[^=]+=[^=]+/', $ou)){
778       return @LDAP::convert("ou=$ou,");
779     } else {
780       return @LDAP::convert("$ou,");
781     }
782   } else {
783     return "";
784   }
788 function get_people_ou()
790   return (get_ou("PEOPLE"));
794 function get_groups_ou()
796   return (get_ou("GROUPS"));
800 function get_winstations_ou()
802   return (get_ou("WINSTATIONS"));
806 function get_base_from_people($dn)
808   global $config;
810   $pattern= "/^[^,]+,".preg_quote(get_people_ou())."/";
811   $base= preg_replace($pattern, '', $dn);
813   /* Set to base, if we're not on a correct subtree */
814   if (!isset($config->idepartments[$base])){
815     $base= $config->current['BASE'];
816   }
818   return ($base);
822 function get_departments($ignore_dn= "")
824   global $config;
826   /* Initialize result hash */
827   $result= array();
828   $result['/']= $config->current['BASE'];
830   /* Get list of department objects */
831   $ldap= $config->get_ldap_link();
832   $ldap->cd ($config->current['BASE']);
833   $ldap->search ("(objectClass=gosaDepartment)", array("ou"));
834   while ($attrs= $ldap->fetch()){
835     $dn= $ldap->getDN();
836     if ($dn == $ignore_dn){
837       continue;
838     }
839     $result[convert_department_dn($dn)]= $dn;
840   }
842   return ($result);
846 function chkacl($acl, $name)
848   /* Look for attribute in ACL */
849   if (preg_match("/#$name#/", $acl) || $acl == "#all#"){
850     return ("");
851   }
853   /* Optically disable html object for no match */
854   return (" disabled ");
858 function is_phone_nr($nr)
860   if ($nr == ""){
861     return (TRUE);
862   }
864   return preg_match ("/^[0-9 ()+*-]+$/", $nr);
868 function is_url($url)
870   if ($url == ""){
871     return (TRUE);
872   }
874   return preg_match ("/^(http|https):\/\/((?:[a-zA-Z0-9_-]+\.?)+):?(\d*)/", $url);
878 function is_dn($dn)
880   if ($dn == ""){
881     return (TRUE);
882   }
884   return preg_match ("/^[a-z0-9 _-]+$/i", $dn);
888 function is_uid($uid)
890   global $config;
892   if ($uid == ""){
893     return (TRUE);
894   }
896   /* STRICT adds spaces and case insenstivity to the uid check.
897      This is dangerous and should not be used. */
898   if (isset($config->current['STRICT']) && preg_match('/^no$/i', $config->current['STRICT'])){
899     return preg_match ("/^[a-z0-9 _.-]+$/i", $uid);
900   } else {
901     return preg_match ("/^[a-z0-9_-]+$/", $uid);
902   }
906 function is_id($id)
908   if ($id == ""){
909     return (FALSE);
910   }
912   return preg_match ("/^[0-9]+$/", $id);
916 function is_path($path)
918   if ($path == ""){
919     return (TRUE);
920   }
921   if (!preg_match('/^[a-z0-9%\/_.+-]+$/i', $path)){
922     return (FALSE);
923   }
925   return preg_match ("/\/.+$/", $path);
929 function is_email($address, $template= FALSE)
931   if ($address == ""){
932     return (TRUE);
933   }
934   if ($template){
935     return preg_match ("/^[._a-z0-9%-]+@[_a-z0-9-]+(\.[a-z0-9-]+)(\.[a-z0-9-]+)*$/i",
936         $address);
937   } else {
938     return preg_match ("/^[._a-z0-9-]+@[_a-z0-9-]+(\.[a-z0-9i-]+)(\.[a-z0-9-]+)*$/i",
939         $address);
940   }
944 function print_red()
946   /* Check number of arguments */
947   if (func_num_args() < 1){
948     return;
949   }
951   /* Get arguments, save string */
952   $array = func_get_args();
953   $string= $array[0];
955   /* Step through arguments */
956   for ($i= 1; $i<count($array); $i++){
957     $string= preg_replace ("/%s/", $array[$i], $string, 1);
958   }
960   if((!isset($_SESSION['errorsAlreadyPosted'])) || !is_array($_SESSION['errorsAlreadyPosted'])){
961     $_SESSION['errorsAlreadyPosted'] = array(); 
962   }
964   /* If DEBUGLEVEL is set, we're in web mode, use textual output in
965      the other case... */
967   if (isset($_SESSION['DEBUGLEVEL'])){
969     if($_SESSION['LastError'] == $string){
971       if((!isset($_SESSION['errorsAlreadyPosted'][$string]))){
972         $_SESSION['errorsAlreadyPosted'][$string] = 1;
973       }
974       $_SESSION['errorsAlreadyPosted'][$string] ++;
976     }else{
977       if((!empty($_SESSION['LastError'])) && ($_SESSION['errorsAlreadyPosted'][$_SESSION['LastError']]>1)){
978         $_SESSION['errors'].= "<div align=\"left\" style=\"border-width:5px;".
979           "border-style:solid;border-color:red; background-color:black;".
980           "margin-bottom:10px; padding:8px;\"><table style='width:100%' summary=''><tr><td><img alt=\"\" src=\"".
981           get_template_path('images/warning.png')."\"></td>".
982           "<td width=\"100%\" style=\"text-align:center\"><font color=\"#FFFFFF\">".
983           "<b style='font-size:16px;'>".sprintf(_("Last message repeated %s times."),$_SESSION['errorsAlreadyPosted'][$_SESSION['LastError']])."</b></font></td><td>".
984           "<img alt=\"\"src=\"".get_template_path('images/warning.png').
985           "\"></td></tr></table></div>\n";
986       }
988       if($string != NULL){
989         $_SESSION['errors'].= "<div align=\"left\" style=\"border-width:5px;".
990           "border-style:solid;border-color:red; background-color:black;".
991           "margin-bottom:10px; padding:8px;\"><table style='width:100%' summary=''><tr><td><img alt=\"\" src=\"".
992           get_template_path('images/warning.png')."\"></td>".
993           "<td width=\"100%\" style=\"text-align:center\"><font color=\"#FFFFFF\">".
994           "<b style='font-size:16px;'>$string</b></font></td><td>".
995           "<img alt=\"\"src=\"".get_template_path('images/warning.png').
996           "\"></td></tr></table></div>\n";
997       }else{
998         return;
999       }
1000       $_SESSION['errorsAlreadyPosted'] = array();
1001       $_SESSION['errorsAlreadyPosted'][$string] = 1;
1003     }
1005   } else {
1006     echo "Error: $string\n";
1007   }
1008   $_SESSION['LastError'] = $string; 
1013 function gen_locked_message($user, $dn)
1015   global $plug, $config;
1017   $_SESSION['dn']= $dn;
1018   $ldap= $config->get_ldap_link();
1019   $ldap->cat ($user);
1020   $attrs= $ldap->fetch();
1021   $uid= $attrs["uid"][0];
1023   //  print_a($_POST);
1024   //  print_a($_GET);
1026   if((isset($_SESSION['LOCK_VARS_TO_USE']))&&(count($_SESSION['LOCK_VARS_TO_USE']))){
1027     $_SESSION['LOCK_VARS_USED']  =array();
1028     foreach($_SESSION['LOCK_VARS_TO_USE'] as $name){
1030       if(empty($name)) continue;
1031       foreach($_POST as $Pname => $Pvalue){
1032         if(preg_match($name,$Pname)){
1033           $_SESSION['LOCK_VARS_USED'][$Pname] = $_POST[$Pname];
1034         }
1035       }
1037       foreach($_GET as $Pname => $Pvalue){
1038         if(preg_match($name,$Pname)){
1039           $_SESSION['LOCK_VARS_USED'][$Pname] = $_GET[$Pname];
1040         }
1041       }
1042     }
1043     $_SESSION['LOCK_VARS_TO_USE'] =array();
1044   }
1046   /* Prepare and show template */
1047   $smarty= get_smarty();
1048   $smarty->assign ("dn", $dn);
1049   $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."), $dn, "<a href=\"main.php?plug=0&amp;viewid=$uid\">$uid</a>"));
1051   return ($smarty->fetch (get_template_path('islocked.tpl')));
1055 function to_string ($value)
1057   /* If this is an array, generate a text blob */
1058   if (is_array($value)){
1059     $ret= "";
1060     foreach ($value as $line){
1061       $ret.= $line."<br>\n";
1062     }
1063     return ($ret);
1064   } else {
1065     return ($value);
1066   }
1070 function get_printer_list($cups_server)
1072   global $config;
1074   $res= array();
1076   /* Use CUPS, if we've access to it */
1077   if (function_exists('cups_get_dest_list')){
1078     $dest_list= cups_get_dest_list ($cups_server);
1080     foreach ($dest_list as $prt){
1081       $attr= cups_get_printer_attributes ($cups_server, $prt->name);
1083       foreach ($attr as $prt_info){
1084         if ($prt_info->name == "printer-info"){
1085           $info= $prt_info->value;
1086           break;
1087         }
1088       }
1089       $res[$prt->name]= "$info [$prt->name]";
1090     }
1092     /* CUPS is not available, try lpstat as a replacement */
1093   } else {
1094     $ar = false;
1095     exec("lpstat -p", $ar);
1096     foreach($ar as $val){
1097       list($dummy, $printer, $rest)= split(' ', $val, 3);
1098       if (preg_match('/^[^@]+$/', $printer)){
1099         $res[$printer]= "$printer";
1100       }
1101     }
1102   }
1104   /* Merge in printers from LDAP */
1105   $ldap= $config->get_ldap_link();
1106   $ldap->cd ($config->current['BASE']);
1107   $ldap->search('(objectClass=gotoPrinter)', array('cn'));
1108   while ($attrs= $ldap->fetch()){
1109     $res[$attrs["cn"][0]]= $attrs["cn"][0];
1110   }
1112   return $res;
1116 function sess_del ($var)
1118   /* New style */
1119   unset ($_SESSION[$var]);
1121   /* ... work around, since the first one
1122      doesn't seem to work all the time */
1123   session_unregister ($var);
1127 function show_errors($message)
1129   $complete= "";
1131   /* Assemble the message array to a plain string */
1132   foreach ($message as $error){
1133     if ($complete == ""){
1134       $complete= $error;
1135     } else {
1136       $complete= "$error<br>$complete";
1137     }
1138   }
1140   /* Fill ERROR variable with nice error dialog */
1141   print_red($complete);
1145 function show_ldap_error($message)
1147   if (!preg_match("/Success/i", $message)){
1148     print_red (_("LDAP error:")." $message");
1149     return TRUE;
1150   } else {
1151     return FALSE;
1152   }
1156 function rewrite($s)
1158   global $REWRITE;
1160   foreach ($REWRITE as $key => $val){
1161     $s= preg_replace("/$key/", "$val", $s);
1162   }
1164   return ($s);
1168 function dn2base($dn)
1170   global $config;
1172   if (get_people_ou() != ""){
1173     $dn= preg_replace('/,'.get_people_ou().'/' , ',', $dn);
1174   }
1175   if (get_groups_ou() != ""){
1176     $dn= preg_replace('/,'.get_groups_ou().'/' , ',', $dn);
1177   }
1178   $base= preg_replace ('/^[^,]+,/i', '', $dn);
1180   return ($base);
1185 function check_command($cmdline)
1187   $cmd= preg_replace("/ .*$/", "", $cmdline);
1189   /* Check if command exists in filesystem */
1190   if (!file_exists($cmd)){
1191     return (FALSE);
1192   }
1194   /* Check if command is executable */
1195   if (!is_executable($cmd)){
1196     return (FALSE);
1197   }
1199   return (TRUE);
1203 function print_header($image, $headline, $info= "")
1205   $display= "<div class=\"plugtop\">\n";
1206   $display.= "  <p class=\"center\" style=\"margin:0px 0px 0px 5px;padding:0px;font-size:24px;\"><img class=\"center\" src=\"$image\" align=\"middle\" alt=\"*\">&nbsp;$headline</p>\n";
1207   $display.= "</div>\n";
1209   if ($info != ""){
1210     $display.= "<div class=\"pluginfo\">\n";
1211     $display.= "$info";
1212     $display.= "</div>\n";
1213   } else {
1214     $display.= "<div style=\"height:5px;\">\n";
1215     $display.= "&nbsp;";
1216     $display.= "</div>\n";
1217   }
1219   return ($display);
1223 function register_global($name, $object)
1225   $_SESSION[$name]= $object;
1229 function is_global($name)
1231   return isset($_SESSION[$name]);
1235 function get_global($name)
1237   return $_SESSION[$name];
1241 function range_selector($dcnt,$start,$range=25,$post_var=false)
1244   /* Entries shown left and right from the selected entry */
1245   $max_entries= 10;
1247   /* Initialize and take care that max_entries is even */
1248   $output="";
1249   if ($max_entries & 1){
1250     $max_entries++;
1251   }
1253   if((!empty($post_var))&&(isset($_POST[$post_var]))){
1254     $range= $_POST[$post_var];
1255   }
1257   /* Prevent output to start or end out of range */
1258   if ($start < 0 ){
1259     $start= 0 ;
1260   }
1261   if ($start >= $dcnt){
1262     $start= $range * (int)(($dcnt / $range) + 0.5);
1263   }
1265   $numpages= (($dcnt / $range));
1266   if(((int)($numpages))!=($numpages)){
1267     $numpages = (int)$numpages + 1;
1268   }
1269   if ((((int)$numpages) <= 1 )&&(!$post_var)){
1270     return ("");
1271   }
1272   $ppage= (int)(($start / $range) + 0.5);
1275   /* Align selected page to +/- max_entries/2 */
1276   $begin= $ppage - $max_entries/2;
1277   $end= $ppage + $max_entries/2;
1279   /* Adjust begin/end, so that the selected value is somewhere in
1280      the middle and the size is max_entries if possible */
1281   if ($begin < 0){
1282     $end-= $begin + 1;
1283     $begin= 0;
1284   }
1285   if ($end > $numpages) {
1286     $end= $numpages;
1287   }
1288   if (($end - $begin) < $max_entries && ($end - $max_entries) > 0){
1289     $begin= $end - $max_entries;
1290   }
1292   if($post_var){
1293     $output.= "<div style='border:1px solid #E0E0E0; background-color:#FFFFFF;'>
1294       <table summary='' width='100%'><tr><td style='width:25%'></td><td style='text-align:center;'>";
1295   }else{
1296     $output.= "<div style='border:1px solid #E0E0E0; background-color:#FFFFFF;'>";
1297   }
1299   /* Draw decrement */
1300   if ($start > 0 ) {
1301     $output.="  <a href= \"main.php?plug=".validate($_GET['plug'])."&amp;start=".
1302       (($start-$range))."\">".
1303       "<img class=\"center\" alt=\"\" src=\"images/back.png\" border=0 align=\"middle\"></a>";
1304   }
1306   /* Draw pages */
1307   for ($i= $begin; $i < $end; $i++) {
1308     if ($ppage == $i){
1309       $output.= "<a style=\"vertical-align:middle;background-color:#D0D0D0;\" href=\"main.php?plug=".
1310         validate($_GET['plug'])."&amp;start=".
1311         ($i*$range)."\">&nbsp;".($i+1)."&nbsp;</a>";
1312     } else {
1313       $output.= "<a style=\"vertical-align:middle;\" href=\"main.php?plug=".validate($_GET['plug']).
1314         "&amp;start=".($i*$range)."\">&nbsp;".($i+1)."&nbsp;</a>";
1315     }
1316   }
1318   /* Draw increment */
1319   if($start < ($dcnt-$range)) {
1320     $output.="  <a href= \"main.php?plug=".validate($_GET['plug'])."&amp;start=".
1321       (($start+($range)))."\">".
1322       "<img class=\"center\" alt=\"\" src=\"images/forward.png\" border=\"0\" align=\"middle\"></a>";
1323   }
1325   if(($post_var)&&($numpages)){
1326     $output.= "</td><td style='width:25%;text-align:right;vertical-align:middle;'>&nbsp;"._("Entries per page")."&nbsp;<select style='vertical-align:middle;' name='".$post_var."' onChange='javascript:document.mainform.submit()'>";
1327     foreach(array(20,50,100,200,"all") as $num){
1328       if($num == "all"){
1329         $var = 10000;
1330       }else{
1331         $var = $num;
1332       }
1333       if($var == $range){
1334         $output.="\n<option selected='selected' value='".$var."'>".$num."</option>";
1335       }else{  
1336         $output.="\n<option value='".$var."'>".$num."</option>";
1337       }
1338     }
1339     $output.=  "</select></td></tr></table></div>";
1340   }else{
1341     $output.= "</div>";
1342   }
1344   return($output);
1348 function apply_filter()
1350   $apply= "";
1352   $apply= ''.
1353     '<table summary=""  width="100%"  style="background:#EEEEEE;border-top:1px solid #B0B0B0;"><tr><td width="100%" align="right">'.
1354     '<input type="submit" name="apply" value="'._("Apply filter").'"></td></tr></table>';
1356   return ($apply);
1360 function back_to_main()
1362   $string= '<br><p class="plugbottom"><input type=submit name="password_back" value="'.
1363     _("Back").'"></p><input type="hidden" name="ignore">';
1365   return ($string);
1369 function normalize_netmask($netmask)
1371   /* Check for notation of netmask */
1372   if (!preg_match('/^([0-9]+\.){3}[0-9]+$/', $netmask)){
1373     $num= (int)($netmask);
1374     $netmask= "";
1376     for ($byte= 0; $byte<4; $byte++){
1377       $result=0;
1379       for ($i= 7; $i>=0; $i--){
1380         if ($num-- > 0){
1381           $result+= pow(2,$i);
1382         }
1383       }
1385       $netmask.= $result.".";
1386     }
1388     return (preg_replace('/\.$/', '', $netmask));
1389   }
1391   return ($netmask);
1395 function netmask_to_bits($netmask)
1397   list($nm0, $nm1, $nm2, $nm3)= split('\.', $netmask);
1398   $res= 0;
1400   for ($n= 0; $n<4; $n++){
1401     $start= 255;
1402     $name= "nm$n";
1404     for ($i= 0; $i<8; $i++){
1405       if ($start == (int)($$name)){
1406         $res+= 8 - $i;
1407         break;
1408       }
1409       $start-= pow(2,$i);
1410     }
1411   }
1413   return ($res);
1417 function recurse($rule, $variables)
1419   $result= array();
1421   if (!count($variables)){
1422     return array($rule);
1423   }
1425   reset($variables);
1426   $key= key($variables);
1427   $val= current($variables);
1428   unset ($variables[$key]);
1430   foreach($val as $possibility){
1431     $nrule= preg_replace("/\{$key\}/", $possibility, $rule);
1432     $result= array_merge($result, recurse($nrule, $variables));
1433   }
1435   return ($result);
1439 function expand_id($rule, $attributes)
1441   /* Check for id rule */
1442   if(preg_match('/^id(:|#)\d+$/',$rule)){
1443     return (array("\{$rule}"));
1444   }
1446   /* Check for clean attribute */
1447   if (preg_match('/^%[a-zA-Z0-9]+$/', $rule)){
1448     $rule= preg_replace('/^%/', '', $rule);
1449     $val= rewrite(preg_replace('/ /', '', strtolower($attributes[$rule])));
1450     return (array($val));
1451   }
1453   /* Check for attribute with parameters */
1454   if (preg_match('/^%[a-zA-Z0-9]+\[[0-9-]+\]$/', $rule)){
1455     $param= preg_replace('/^[^[]+\[([^]]+)]$/', '\\1', $rule);
1456     $part= preg_replace('/^%/', '', preg_replace('/\[.*$/', '', $rule));
1457     $val= rewrite(preg_replace('/ /', '', strtolower($attributes[$part])));
1458     $start= preg_replace ('/-.*$/', '', $param);
1459     $stop = preg_replace ('/^[^-]+-/', '', $param);
1461     /* Assemble results */
1462     $result= array();
1463     for ($i= $start; $i<= $stop; $i++){
1464       $result[]= substr($val, 0, $i);
1465     }
1466     return ($result);
1467   }
1469   echo "Error in idgen string: don't know how to handle rule $rule.\n";
1470   return (array($rule));
1474 function gen_uids($rule, $attributes)
1476   global $config;
1478   /* Search for keys and fill the variables array with all 
1479      possible values for that key. */
1480   $part= "";
1481   $trigger= false;
1482   $stripped= "";
1483   $variables= array();
1485   for ($pos= 0; $pos < strlen($rule); $pos++){
1487     if ($rule[$pos] == "{" ){
1488       $trigger= true;
1489       $part= "";
1490       continue;
1491     }
1493     if ($rule[$pos] == "}" ){
1494       $variables[$pos]= expand_id($part, $attributes);
1495       $stripped.= "\{$pos}";
1496       $trigger= false;
1497       continue;
1498     }
1500     if ($trigger){
1501       $part.= $rule[$pos];
1502     } else {
1503       $stripped.= $rule[$pos];
1504     }
1505   }
1507   /* Recurse through all possible combinations */
1508   $proposed= recurse($stripped, $variables);
1510   /* Get list of used ID's */
1511   $used= array();
1512   $ldap= $config->get_ldap_link();
1513   $ldap->cd($config->current['BASE']);
1514   $ldap->search('(uid=*)');
1516   while($attrs= $ldap->fetch()){
1517     $used[]= $attrs['uid'][0];
1518   }
1520   /* Remove used uids and watch out for id tags */
1521   $ret= array();
1522   foreach($proposed as $uid){
1524     /* Check for id tag and modify uid if needed */
1525     if(preg_match('/\{id:\d+}/',$uid)){
1526       $size= preg_replace('/^.*{id:(\d+)}.*$/', '\\1', $uid);
1528       for ($i= 0; $i < pow(10,$size); $i++){
1529         $number= sprintf("%0".$size."d", $i);
1530         $res= preg_replace('/{id:(\d+)}/', $number, $uid);
1531         if (!in_array($res, $used)){
1532           $uid= $res;
1533           break;
1534         }
1535       }
1536     }
1538   if(preg_match('/\{id#\d+}/',$uid)){
1539     $size= preg_replace('/^.*{id#(\d+)}.*$/', '\\1', $uid);
1541     while (true){
1542       mt_srand((double) microtime()*1000000);
1543       $number= sprintf("%0".$size."d", mt_rand(0, pow(10, $size)-1));
1544       $res= preg_replace('/{id#(\d+)}/', $number, $uid);
1545       if (!in_array($res, $used)){
1546         $uid= $res;
1547         break;
1548       }
1549     }
1550   }
1552 /* Don't assign used ones */
1553 if (!in_array($uid, $used)){
1554   $ret[]= $uid;
1558 return(array_unique($ret));
1562 function array_search_r($needle, $key, $haystack){
1564   foreach($haystack as $index => $value){
1565     $match= 0;
1567     if (is_array($value)){
1568       $match= array_search_r($needle, $key, $value);
1569     }
1571     if ($index==$key && !is_array($value) && preg_match("/$needle/i", $value)){
1572       $match=1;
1573     }
1575     if ($match){
1576       return 1;
1577     }
1578   }
1580   return 0;
1581
1584 /* Sadly values like memory_limit are perpended by K, M, G, etc.
1585    Need to convert... */
1586 function to_byte($value) {
1587   $value= strtolower(trim($value));
1589   if(!is_numeric(substr($value, -1))) {
1591     switch(substr($value, -1)) {
1592       case 'g':
1593         $mult= 1073741824;
1594         break;
1595       case 'm':
1596         $mult= 1048576;
1597         break;
1598       case 'k':
1599         $mult= 1024;
1600         break;
1601     }
1603     return ($mult * (int)substr($value, 0, -1));
1604   } else {
1605     return $value;
1606   }
1610 function in_array_ics($value, $items)
1612   if (!is_array($items)){
1613     return (FALSE);
1614   }
1616   foreach ($items as $item){
1617     if (strtolower($item) == strtolower($value)) {
1618       return (TRUE);
1619     }
1620   }
1622   return (FALSE);
1623
1626 function generate_alphabet($count= 10)
1628   $characters= _("*ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789");
1629   $alphabet= "";
1630   $c= 0;
1632   /* Fill cells with charaters */
1633   for ($i= 0; $i<mb_strlen($characters, 'UTF8'); $i++){
1634     if ($c == 0){
1635       $alphabet.= "<tr>";
1636     }
1638     $ch = mb_substr($characters, $i, 1, "UTF8");
1639     $alphabet.= "<td><a class=\"alphaselect\" href=\"main.php?plug=".
1640       validate($_GET['plug'])."&amp;search=".$ch."\">&nbsp;".$ch."&nbsp;</a></td>";
1642     if ($c++ == $count){
1643       $alphabet.= "</tr>";
1644       $c= 0;
1645     }
1646   }
1648   /* Fill remaining cells */
1649   while ($c++ <= $count){
1650     $alphabet.= "<td>&nbsp;</td>";
1651   }
1653   return ($alphabet);
1657 function validate($string)
1659   return (strip_tags(preg_replace('/\0/', '', $string)));
1662 function get_gosa_version()
1664   global $svn_revision, $svn_path;
1666   /* Extract informations */
1667   $revision= preg_replace('/^[^0-9]*([0-9]+)[^0-9]*$/', '\1', $svn_revision);
1669   /* Release or development? */
1670   if (preg_match('%/gosa/trunk/%', $svn_path)){
1671     return (sprintf(_("GOsa development snapshot (Rev %s)"), $revision));
1672   } else {
1673     $release= preg_replace('%^.*/([^/]+)/include/functions.inc.*$%', '\1', $svn_path);
1674     return (sprintf(_("GOsa $release"), $revision));
1675   }
1679 function rmdirRecursive($path, $followLinks=false) {
1680   $dir= opendir($path);
1681   while($entry= readdir($dir)) {
1682     if(is_file($path."/".$entry) || ((!$followLinks) && is_link($path."/".$entry))) {
1683       unlink($path."/".$entry);
1684     } elseif (is_dir($path."/".$entry) && $entry!='.' && $entry!='..') {
1685       rmdirRecursive($path."/".$entry);
1686     }
1687   }
1688   closedir($dir);
1689   return rmdir($path);
1692 function scan_directory($path,$sort_desc=false)
1694   $ret = false;
1696   /* is this a dir ? */
1697   if(is_dir($path)) {
1699     /* is this path a readable one */
1700     if(is_readable($path)){
1702       /* Get contents and write it into an array */   
1703       $ret = array();    
1705       $dir = opendir($path);
1707       /* Is this a correct result ?*/
1708       if($dir){
1709         while($fp = readdir($dir))
1710           $ret[]= $fp;
1711       }
1712     }
1713   }
1714   /* Sort array ascending , like scandir */
1715   sort($ret);
1717   /* Sort descending if parameter is sort_desc is set */
1718   if($sort_desc) {
1719     $ret = array_reverse($ret);
1720   }
1722   return($ret);
1725 function clean_smarty_compile_dir($directory)
1727   global $svn_revision;
1729   if(is_dir($directory) && is_readable($directory)) {
1730     // Set revision filename to REVISION
1731     $revision_file= $directory."/REVISION";
1733     /* Is there a stamp containing the current revision? */
1734     if(!file_exists($revision_file)) {
1735       // create revision file
1736       create_revision($revision_file, $svn_revision);
1737     } else {
1738 # check for "$config->...['CONFIG']/revision" and the
1739 # contents should match the revision number
1740       if(!compare_revision($revision_file, $svn_revision)){
1741         // If revision differs, clean compile directory
1742         foreach(scan_directory($directory) as $file) {
1743           if(($file==".")||($file=="..")) continue;
1744           if( is_file($directory."/".$file) &&
1745               is_writable($directory."/".$file)) {
1746             // delete file
1747             if(!unlink($directory."/".$file)) {
1748               print_red("File ".$directory."/".$file." could not be deleted.");
1749               // This should never be reached
1750             }
1751           } elseif(is_dir($directory."/".$file) &&
1752               is_writable($directory."/".$file)) {
1753             // Just recursively delete it
1754             rmdirRecursive($directory."/".$file);
1755           }
1756         }
1757         // We should now create a fresh revision file
1758         clean_smarty_compile_dir($directory);
1759       } else {
1760         // Revision matches, nothing to do
1761       }
1762     }
1763   } else {
1764     // Smarty compile dir is not accessible
1765     // (Smarty will warn about this)
1766   }
1769 function create_revision($revision_file, $revision)
1771   $result= false;
1773   if(is_dir(dirname($revision_file)) && is_writable(dirname($revision_file))) {
1774     if($fh= fopen($revision_file, "w")) {
1775       if(fwrite($fh, $revision)) {
1776         $result= true;
1777       }
1778     }
1779     fclose($fh);
1780   } else {
1781     print_red("Can not write to revision file");
1782   }
1784   return $result;
1787 function compare_revision($revision_file, $revision)
1789   // false means revision differs
1790   $result= false;
1792   if(file_exists($revision_file) && is_readable($revision_file)) {
1793     // Open file
1794     if($fh= fopen($revision_file, "r")) {
1795       // Compare File contents with current revision
1796       if($revision == fread($fh, filesize($revision_file))) {
1797         $result= true;
1798       }
1799     } else {
1800       print_red("Can not open revision file");
1801     }
1802     // Close file
1803     fclose($fh);
1804   }
1806   return $result;
1809 function progressbar($percentage,$width=100,$height=15,$showvalue=false)
1811   $str = ""; // Our return value will be saved in this var
1813   $color  = dechex($percentage+150);
1814   $color2 = dechex(150 - $percentage);
1815   $bgcolor= $showvalue?"FFFFFF":"DDDDDD";
1817   $progress = (int)(($percentage /100)*$width);
1819   /* Abort printing out percentage, if divs are to small */
1822   /* If theres a better solution for this, use it... */
1823   $str = "
1824     <div style=\" width:".($width)."px; 
1825     height:".($height)."px;
1826   background-color:#000000;
1827 padding:1px;\">
1829           <div style=\" width:".($width)."px;
1830         background-color:#$bgcolor;
1831 height:".($height)."px;\">
1833          <div style=\" width:".$progress."px;
1834 height:".$height."px;
1835        background-color:#".$color2.$color2.$color."; \">";
1838        if(($height >10)&&($showvalue)){
1839          $str.=                 "<font style=\"font-size:".($height-2)."px;color:#FF0000;align:middle;padding-left:".((int)(($width*0.4)))."px;\">
1840            <b>".$percentage."%</b>
1841            </font>";
1842        }
1844        $str.= "</div></div></div>";
1846        return($str);
1850 function array_key_ics($ikey, $items)
1852   /* Gather keys, make them lowercase */
1853   $tmp= array();
1854   foreach ($items as $key => $value){
1855     $tmp[strtolower($key)]= $key;
1856   }
1858   if (isset($tmp[strtolower($ikey)])){
1859     return($tmp[strtolower($ikey)]);
1860   }
1862   return ("");
1866 function search_config($arr, $name, $return)
1868   if (is_array($arr)){
1869     foreach ($arr as $a){
1870       if (isset($a['CLASS']) &&
1871           strtolower($a['CLASS']) == strtolower($name)){
1873         if (isset($a[$return])){
1874           return ($a[$return]);
1875         } else {
1876           return ("");
1877         }
1878       } else {
1879         $res= search_config ($a, $name, $return);
1880         if ($res != ""){
1881           return $res;
1882         }
1883       }
1884     }
1885   }
1886   return ("");
1890 function array_differs($src, $dst)
1892   /* If the count is differing, the arrays differ */
1893   if (count ($src) != count ($dst)){
1894     return (TRUE);
1895   }
1897   /* So the count is the same - lets check the contents */
1898   $differs= FALSE;
1899   foreach($src as $value){
1900     if (!in_array($value, $dst)){
1901       $differs= TRUE;
1902     }
1903   }
1905   return ($differs);
1909 function saveFilter($a_filter, $values)
1911   if (isset($_POST['regexit'])){
1912     $a_filter["regex"]= $_POST['regexit'];
1914     foreach($values as $type){
1915       if (isset($_POST[$type])) {
1916         $a_filter[$type]= "checked";
1917       } else {
1918         $a_filter[$type]= "";
1919       }
1920     }
1921   }
1923   /* React on alphabet links if needed */
1924   if (isset($_GET['search'])){
1925     $s= mb_substr(validate($_GET['search']), 0, 1, "UTF8")."*";
1926     if ($s == "**"){
1927       $s= "*";
1928     }
1929     $a_filter['regex']= $s;
1930   }
1932   return ($a_filter);
1936 /* Escape all preg_* relevant characters */
1937 function normalizePreg($input)
1939   return (addcslashes($input, '[]()|/.*+-'));
1943 /* Escape all LDAP filter relevant characters */
1944 function normalizeLdap($input)
1946   return (addcslashes($input, '()|'));
1950 // vim:tabstop=2:expandtab:shiftwidth=2:filetype=php:syntax:ruler:
1951 ?>