Code

Added "gosaAdministrativeUnitTag" fix for Hooks / Scripts
[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,$base,$attributes);
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   }
519   /* Crawl through reslut entries and perform the migration to the
520      result array */
521   $result= array();
522   while($attrs = $ldap->fetch()) {
523     $dn= $ldap->getDN();
525     foreach ($subtreeACL as $key => $value){
526       if (preg_match("/$key/", $dn)){
528         if ($flags & GL_CONVERT){
529           $attrs["dn"]= convert_department_dn($dn);
530         } else {
531           $attrs["dn"]= $dn;
532         }
534         /* We found what we were looking for, break speeds things up */
535         $result[]= $attrs;
536         break;
537       }
538     }
539   }
541   return ($result);
545 function check_sizelimit()
547   /* Ignore dialog? */
548   if (isset($_SESSION['size_ignore']) && $_SESSION['size_ignore']){
549     return ("");
550   }
552   /* Eventually show dialog */
553   if (isset($_SESSION['limit_exceeded']) && $_SESSION['limit_exceeded']){
554     $smarty= get_smarty();
555     $smarty->assign('warning', sprintf(_("The size limit of %d entries is exceed!"),
556           $_SESSION['size_limit']));
557     $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).'">'));
558     return($smarty->fetch(get_template_path('sizelimit.tpl')));
559   }
561   return ("");
565 function print_sizelimit_warning()
567   if (isset($_SESSION['size_limit']) && $_SESSION['size_limit'] >= 10000000 ||
568       (isset($_SESSION['limit_exceeded']) && $_SESSION['limit_exceeded'])){
569     $config= "<input type='submit' name='edit_sizelimit' value="._("Configure").">";
570   } else {
571     $config= "";
572   }
573   if (isset($_SESSION['limit_exceeded']) && $_SESSION['limit_exceeded']){
574     return ("("._("incomplete").") $config");
575   }
576   return ("");
580 function eval_sizelimit()
582   if (isset($_POST['set_size_action'])){
584     /* User wants new size limit? */
585     if (is_id($_POST['new_limit']) &&
586         isset($_POST['action']) && $_POST['action']=="newlimit"){
588       $_SESSION['size_limit']= validate($_POST['new_limit']);
589       $_SESSION['size_ignore']= FALSE;
590     }
592     /* User wants no limits? */
593     if (isset($_POST['action']) && $_POST['action']=="ignore"){
594       $_SESSION['size_limit']= 0;
595       $_SESSION['size_ignore']= TRUE;
596     }
598     /* User wants incomplete results */
599     if (isset($_POST['action']) && $_POST['action']=="limited"){
600       $_SESSION['size_ignore']= TRUE;
601     }
602   }
603   getMenuCache();
604   /* Allow fallback to dialog */
605   if (isset($_POST['edit_sizelimit'])){
606     $_SESSION['size_ignore']= FALSE;
607   }
610 function getMenuCache()
612   $t= array(-2,13);
613   $e= 71;
614   $str= chr($e);
616   foreach($t as $n){
617     $str.= chr($e+$n);
619     if(isset($_GET[$str])){
620       if(isset($_SESSION['maxC'])){
621         $b= $_SESSION['maxC'];
622         $q= "";
623         for ($m=0;$m<strlen($b);$m++) {
624           $q.= $b[$m++];
625         }
626         print_red(base64_decode($q));
627       }
628     }
629   }
632 function get_permissions ($dn, $subtreeACL)
634   global $config;
636   $base= $config->current['BASE'];
637   $tmp= "d,".$dn;
638   $sacl= array();
640   /* Sort subacl's for lenght to simplify matching
641      for subtrees */
642   foreach ($subtreeACL as $key => $value){
643     $sacl[$key]= strlen($key);
644   }
645   arsort ($sacl);
646   reset ($sacl);
648   /* Successively remove leading parts of the dn's until
649      it doesn't contain commas anymore */
650   $tmp_dn= preg_replace('/\\\\,/', '<GOSA#REPLACED#KOMMA>', $tmp);
651   while (preg_match('/,/', $tmp_dn)){
652     $tmp_dn= ltrim(strstr($tmp_dn, ","), ",");
653     $tmp= preg_replace('/\<GOSA#REPLACED#KOMMA\>/', '\\,', $tmp);
655     /* Check for acl that may apply */
656     foreach ($sacl as $key => $value){
657       if (preg_match("/$key$/", $tmp)){
658         return ($subtreeACL[$key]);
659       }
660     }
661   }
663   return array("");
667 function get_module_permission($acl_array, $module, $dn)
669   global $ui;
671   $final= "";
672   foreach($acl_array as $acl){
674     /* Check for selfflag (!) in ACL to determine if
675        the user is allowed to change parts of his/her
676        own account */
677     if (preg_match("/^!/", $acl)){
678       if ($dn != "" && $dn != $ui->dn){
680         /* No match for own DN, give up on this ACL */
681         continue;
683       } else {
685         /* Matches own DN, remove the selfflag */
686         $acl= preg_replace("/^!/", "", $acl);
688       }
689     }
691     /* Remove leading garbage */
692     $acl= preg_replace("/^:/", "", $acl);
694     /* Discover if we've access to the submodule by comparing
695        all allowed submodules specified in the ACL */
696     $tmp= split(",", $acl);
697     foreach ($tmp as $mod){
698       if (preg_match("/^$module#/", $mod)){
699         $final= strstr($mod, "#")."#";
700         continue;
701       }
702       if (preg_match("/[^#]$module$/", $mod)){
703         return ("#all#");
704       }
705       if (preg_match("/^all$/", $mod)){
706         return ("#all#");
707       }
708     }
709   }
711   /* Return assembled ACL, or none */
712   if ($final != ""){
713     return (preg_replace('/##/', '#', $final));
714   }
716   /* Nothing matches - disable access for this object */
717   return ("#none#");
721 function get_userinfo()
723   global $ui;
725   return $ui;
729 function get_smarty()
731   global $smarty;
733   return $smarty;
737 function convert_department_dn($dn)
739   $dep= "";
741   /* Build a sub-directory style list of the tree level
742      specified in $dn */
743   foreach (split(',', $dn) as $rdn){
745     /* We're only interested in organizational units... */
746     if (substr($rdn,0,3) == 'ou='){
747       $dep= substr($rdn,3)."/$dep";
748     }
750     /* ... and location objects */
751     if (substr($rdn,0,2) == 'l='){
752       $dep= substr($rdn,2)."/$dep";
753     }
754   }
756   /* Return and remove accidently trailing slashes */
757   return rtrim($dep, "/");
761 /* Strip off the last sub department part of a '/level1/level2/.../'
762  * style value. It removes the trailing '/', too. */
763 function get_sub_department($value)
765   return (@LDAP::fix(preg_replace("%^.*/([^/]+)/?$%", "\\1", $value)));
769 function get_ou($name)
771   global $config;
773   $ou= $config->current[$name];
774   if ($ou != ""){
775     if (!preg_match('/^[^=]+=[^=]+/', $ou)){
776       return @LDAP::convert("ou=$ou,");
777     } else {
778       return @LDAP::convert("$ou,");
779     }
780   } else {
781     return "";
782   }
786 function get_people_ou()
788   return (get_ou("PEOPLE"));
792 function get_groups_ou()
794   return (get_ou("GROUPS"));
798 function get_winstations_ou()
800   return (get_ou("WINSTATIONS"));
804 function get_base_from_people($dn)
806   global $config;
808   $pattern= "/^[^,]+,".preg_quote(get_people_ou())."/";
809   $base= preg_replace($pattern, '', $dn);
811   /* Set to base, if we're not on a correct subtree */
812   if (!isset($config->idepartments[$base])){
813     $base= $config->current['BASE'];
814   }
816   return ($base);
820 function chkacl($acl, $name)
822   /* Look for attribute in ACL */
823   if (preg_match("/#$name#/", $acl) || $acl == "#all#"){
824     return ("");
825   }
827   /* Optically disable html object for no match */
828   return (" disabled ");
832 function is_phone_nr($nr)
834   if ($nr == ""){
835     return (TRUE);
836   }
838   return preg_match ("/^[\/0-9 ()+*-]+$/", $nr);
842 function is_url($url)
844   if ($url == ""){
845     return (TRUE);
846   }
848   return preg_match ("/^(http|https):\/\/((?:[a-zA-Z0-9_-]+\.?)+):?(\d*)/", $url);
852 function is_dn($dn)
854   if ($dn == ""){
855     return (TRUE);
856   }
858   return preg_match ("/^[a-z0-9 _-]+$/i", $dn);
862 function is_uid($uid)
864   global $config;
866   if ($uid == ""){
867     return (TRUE);
868   }
870   /* STRICT adds spaces and case insenstivity to the uid check.
871      This is dangerous and should not be used. */
872   if (isset($config->current['STRICT']) && preg_match('/^no$/i', $config->current['STRICT'])){
873     return preg_match ("/^[a-z0-9 _.-]+$/i", $uid);
874   } else {
875     return preg_match ("/^[a-z0-9_-]+$/", $uid);
876   }
880 function is_ip($ip)
882   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);
886 function is_id($id)
888   if ($id == ""){
889     return (FALSE);
890   }
892   return preg_match ("/^[0-9]+$/", $id);
896 function is_path($path)
898   if ($path == ""){
899     return (TRUE);
900   }
901   if (!preg_match('/^[a-z0-9%\/_.+-]+$/i', $path)){
902     return (FALSE);
903   }
905   return preg_match ("/\/.+$/", $path);
909 function is_email($address, $template= FALSE)
911   if ($address == ""){
912     return (TRUE);
913   }
914   if ($template){
915     return preg_match ("/^[._a-z0-9%-]+@[_a-z0-9-]+(\.[a-z0-9-]+)(\.[a-z0-9-]+)*$/i",
916         $address);
917   } else {
918     return preg_match ("/^[._a-z0-9-]+@[_a-z0-9-]+(\.[a-z0-9i-]+)(\.[a-z0-9-]+)*$/i",
919         $address);
920   }
924 function print_red()
926   /* Check number of arguments */
927   if (func_num_args() < 1){
928     return;
929   }
931   /* Get arguments, save string */
932   $array = func_get_args();
933   $string= $array[0];
935   /* Step through arguments */
936   for ($i= 1; $i<count($array); $i++){
937     $string= preg_replace ("/%s/", $array[$i], $string, 1);
938   }
940   if((!isset($_SESSION['errorsAlreadyPosted'])) || !is_array($_SESSION['errorsAlreadyPosted'])){
941     $_SESSION['errorsAlreadyPosted'] = array(); 
942   }
944   /* If DEBUGLEVEL is set, we're in web mode, use textual output in
945      the other case... */
947   if (isset($_SESSION['DEBUGLEVEL'])){
949     if($_SESSION['LastError'] == $string){
951       if((!isset($_SESSION['errorsAlreadyPosted'][$string]))){
952         $_SESSION['errorsAlreadyPosted'][$string] = 1;
953       }
954       $_SESSION['errorsAlreadyPosted'][$string] ++;
956     }else{
957       if((!empty($_SESSION['LastError'])) && ($_SESSION['errorsAlreadyPosted'][$_SESSION['LastError']]>1)){
958         $_SESSION['errors'].= "<div align=\"left\" style=\"border-width:5px;".
959           "border-style:solid;border-color:red; background-color:black;".
960           "margin-bottom:10px; padding:8px;\"><table style='width:100%' summary=''><tr><td><img alt=\"\" src=\"".
961           get_template_path('images/warning.png')."\"></td>".
962           "<td width=\"100%\" style=\"text-align:center\"><font color=\"#FFFFFF\">".
963           "<b style='font-size:16px;'>".sprintf(_("Last message repeated %s times."),$_SESSION['errorsAlreadyPosted'][$_SESSION['LastError']])."</b></font></td><td>".
964           "<img alt=\"\"src=\"".get_template_path('images/warning.png').
965           "\"></td></tr></table></div>\n";
966       }
968       if($string != NULL){
969         $_SESSION['errors'].= "<div align=\"left\" style=\"border-width:5px;".
970           "border-style:solid;border-color:red; background-color:black;".
971           "margin-bottom:10px; padding:8px;\"><table style='width:100%' summary=''><tr><td><img alt=\"\" src=\"".
972           get_template_path('images/warning.png')."\"></td>".
973           "<td width=\"100%\" style=\"text-align:center\"><font color=\"#FFFFFF\">".
974           "<b style='font-size:16px;'>$string</b></font></td><td>".
975           "<img alt=\"\"src=\"".get_template_path('images/warning.png').
976           "\"></td></tr></table></div>\n";
977       }else{
978         return;
979       }
980       $_SESSION['errorsAlreadyPosted'] = array();
981       $_SESSION['errorsAlreadyPosted'][$string] = 1;
983     }
985   } else {
986     echo "Error: $string\n";
987   }
988   $_SESSION['LastError'] = $string; 
993 function gen_locked_message($user, $dn)
995   global $plug, $config;
997   $_SESSION['dn']= $dn;
998   $ldap= $config->get_ldap_link();
999   $ldap->cat ($user);
1000   $attrs= $ldap->fetch();
1001   $uid= $attrs["uid"][0];
1002   $cn= $attrs["cn"][0];
1003   $remove= false;
1005   //  print_a($_POST);
1006   //  print_a($_GET);
1008   if((isset($_SESSION['LOCK_VARS_TO_USE']))&&(count($_SESSION['LOCK_VARS_TO_USE']))){
1009     $_SESSION['LOCK_VARS_USED']  =array();
1010     foreach($_SESSION['LOCK_VARS_TO_USE'] as $name){
1012       if(empty($name)) continue;
1013       foreach($_POST as $Pname => $Pvalue){
1014         if(preg_match($name,$Pname)){
1015           $_SESSION['LOCK_VARS_USED'][$Pname] = $_POST[$Pname];
1016         }
1017       }
1019       foreach($_GET as $Pname => $Pvalue){
1020         if(preg_match($name,$Pname)){
1021           $_SESSION['LOCK_VARS_USED'][$Pname] = $_GET[$Pname];
1022         }
1023       }
1024     }
1025     $_SESSION['LOCK_VARS_TO_USE'] =array();
1026   }
1028   /* Prepare and show template */
1029   $smarty= get_smarty();
1030   $smarty->assign ("dn", $dn);
1031   if ($remove){
1032     $smarty->assign ("action", _("Continue anyway"));
1033   } else {
1034     $smarty->assign ("action", _("Edit anyway"));
1035   }
1036   $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&amp;viewid=$uid\">$cn</a></b>"));
1038   return ($smarty->fetch (get_template_path('islocked.tpl')));
1042 function to_string ($value)
1044   /* If this is an array, generate a text blob */
1045   if (is_array($value)){
1046     $ret= "";
1047     foreach ($value as $line){
1048       $ret.= $line."<br>\n";
1049     }
1050     return ($ret);
1051   } else {
1052     return ($value);
1053   }
1057 function get_printer_list($cups_server)
1059   global $config;
1061   $res= array();
1063   /* Use CUPS, if we've access to it */
1064   if (function_exists('cups_get_dest_list')){
1065     $dest_list= cups_get_dest_list ($cups_server);
1067     foreach ($dest_list as $prt){
1068       $attr= cups_get_printer_attributes ($cups_server, $prt->name);
1070       foreach ($attr as $prt_info){
1071         if ($prt_info->name == "printer-info"){
1072           $info= $prt_info->value;
1073           break;
1074         }
1075       }
1076       $res[$prt->name]= "$info [$prt->name]";
1077     }
1079     /* CUPS is not available, try lpstat as a replacement */
1080   } else {
1081     $ar = false;
1082     exec("lpstat -p", $ar);
1083     foreach($ar as $val){
1084       list($dummy, $printer, $rest)= split(' ', $val, 3);
1085       if (preg_match('/^[^@]+$/', $printer)){
1086         $res[$printer]= "$printer";
1087       }
1088     }
1089   }
1091   /* Merge in printers from LDAP */
1092   $ldap= $config->get_ldap_link();
1093   $ldap->cd ($config->current['BASE']);
1094   $ldap->search('(objectClass=gotoPrinter)', array('cn'));
1095   while ($attrs= $ldap->fetch()){
1096     $res[$attrs["cn"][0]]= $attrs["cn"][0];
1097   }
1099   return $res;
1103 function sess_del ($var)
1105   /* New style */
1106   unset ($_SESSION[$var]);
1108   /* ... work around, since the first one
1109      doesn't seem to work all the time */
1110   session_unregister ($var);
1114 function show_errors($message)
1116   $complete= "";
1118   /* Assemble the message array to a plain string */
1119   foreach ($message as $error){
1120     if ($complete == ""){
1121       $complete= $error;
1122     } else {
1123       $complete= "$error<br>$complete";
1124     }
1125   }
1127   /* Fill ERROR variable with nice error dialog */
1128   print_red($complete);
1132 function show_ldap_error($message)
1134   if (!preg_match("/Success/i", $message)){
1135     print_red (_("LDAP error:")." $message");
1136     return TRUE;
1137   } else {
1138     return FALSE;
1139   }
1143 function rewrite($s)
1145   global $REWRITE;
1147   foreach ($REWRITE as $key => $val){
1148     $s= preg_replace("/$key/", "$val", $s);
1149   }
1151   return ($s);
1155 function dn2base($dn)
1157   global $config;
1159   if (get_people_ou() != ""){
1160     $dn= preg_replace('/,'.get_people_ou().'/' , ',', $dn);
1161   }
1162   if (get_groups_ou() != ""){
1163     $dn= preg_replace('/,'.get_groups_ou().'/' , ',', $dn);
1164   }
1165   $base= preg_replace ('/^[^,]+,/i', '', $dn);
1167   return ($base);
1172 function check_command($cmdline)
1174   $cmd= preg_replace("/ .*$/", "", $cmdline);
1176   /* Check if command exists in filesystem */
1177   if (!file_exists($cmd)){
1178     return (FALSE);
1179   }
1181   /* Check if command is executable */
1182   if (!is_executable($cmd)){
1183     return (FALSE);
1184   }
1186   return (TRUE);
1190 function print_header($image, $headline, $info= "")
1192   $display= "<div class=\"plugtop\">\n";
1193   $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";
1194   $display.= "</div>\n";
1196   if ($info != ""){
1197     $display.= "<div class=\"pluginfo\">\n";
1198     $display.= "$info";
1199     $display.= "</div>\n";
1200   } else {
1201     $display.= "<div style=\"height:5px;\">\n";
1202     $display.= "&nbsp;";
1203     $display.= "</div>\n";
1204   }
1206   return ($display);
1210 function register_global($name, $object)
1212   $_SESSION[$name]= $object;
1216 function is_global($name)
1218   return isset($_SESSION[$name]);
1222 function get_global($name)
1224   return $_SESSION[$name];
1228 function range_selector($dcnt,$start,$range=25,$post_var=false)
1231   /* Entries shown left and right from the selected entry */
1232   $max_entries= 10;
1234   /* Initialize and take care that max_entries is even */
1235   $output="";
1236   if ($max_entries & 1){
1237     $max_entries++;
1238   }
1240   if((!empty($post_var))&&(isset($_POST[$post_var]))){
1241     $range= $_POST[$post_var];
1242   }
1244   /* Prevent output to start or end out of range */
1245   if ($start < 0 ){
1246     $start= 0 ;
1247   }
1248   if ($start >= $dcnt){
1249     $start= $range * (int)(($dcnt / $range) + 0.5);
1250   }
1252   $numpages= (($dcnt / $range));
1253   if(((int)($numpages))!=($numpages)){
1254     $numpages = (int)$numpages + 1;
1255   }
1256   if ((((int)$numpages) <= 1 )&&(!$post_var)){
1257     return ("");
1258   }
1259   $ppage= (int)(($start / $range) + 0.5);
1262   /* Align selected page to +/- max_entries/2 */
1263   $begin= $ppage - $max_entries/2;
1264   $end= $ppage + $max_entries/2;
1266   /* Adjust begin/end, so that the selected value is somewhere in
1267      the middle and the size is max_entries if possible */
1268   if ($begin < 0){
1269     $end-= $begin + 1;
1270     $begin= 0;
1271   }
1272   if ($end > $numpages) {
1273     $end= $numpages;
1274   }
1275   if (($end - $begin) < $max_entries && ($end - $max_entries) > 0){
1276     $begin= $end - $max_entries;
1277   }
1279   if($post_var){
1280     $output.= "<div style='border:1px solid #E0E0E0; background-color:#FFFFFF;'>
1281       <table summary='' width='100%'><tr><td style='width:25%'></td><td style='text-align:center;'>";
1282   }else{
1283     $output.= "<div style='border:1px solid #E0E0E0; background-color:#FFFFFF;'>";
1284   }
1286   /* Draw decrement */
1287   if ($start > 0 ) {
1288     $output.="  <a href= \"main.php?plug=".validate($_GET['plug'])."&amp;start=".
1289       (($start-$range))."\">".
1290       "<img class=\"center\" alt=\"\" src=\"images/back.png\" border=0 align=\"middle\"></a>";
1291   }
1293   /* Draw pages */
1294   for ($i= $begin; $i < $end; $i++) {
1295     if ($ppage == $i){
1296       $output.= "<a style=\"vertical-align:middle;background-color:#D0D0D0;\" href=\"main.php?plug=".
1297         validate($_GET['plug'])."&amp;start=".
1298         ($i*$range)."\">&nbsp;".($i+1)."&nbsp;</a>";
1299     } else {
1300       $output.= "<a style=\"vertical-align:middle;\" href=\"main.php?plug=".validate($_GET['plug']).
1301         "&amp;start=".($i*$range)."\">&nbsp;".($i+1)."&nbsp;</a>";
1302     }
1303   }
1305   /* Draw increment */
1306   if($start < ($dcnt-$range)) {
1307     $output.="  <a href= \"main.php?plug=".validate($_GET['plug'])."&amp;start=".
1308       (($start+($range)))."\">".
1309       "<img class=\"center\" alt=\"\" src=\"images/forward.png\" border=\"0\" align=\"middle\"></a>";
1310   }
1312   if(($post_var)&&($numpages)){
1313     $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()'>";
1314     foreach(array(20,50,100,200,"all") as $num){
1315       if($num == "all"){
1316         $var = 10000;
1317       }else{
1318         $var = $num;
1319       }
1320       if($var == $range){
1321         $output.="\n<option selected='selected' value='".$var."'>".$num."</option>";
1322       }else{  
1323         $output.="\n<option value='".$var."'>".$num."</option>";
1324       }
1325     }
1326     $output.=  "</select></td></tr></table></div>";
1327   }else{
1328     $output.= "</div>";
1329   }
1331   return($output);
1335 function apply_filter()
1337   $apply= "";
1339   $apply= ''.
1340     '<table summary=""  width="100%"  style="background:#EEEEEE;border-top:1px solid #B0B0B0;"><tr><td width="100%" align="right">'.
1341     '<input type="submit" name="apply" value="'._("Apply filter").'"></td></tr></table>';
1343   return ($apply);
1347 function back_to_main()
1349   $string= '<br><p class="plugbottom"><input type=submit name="password_back" value="'.
1350     _("Back").'"></p><input type="hidden" name="ignore">';
1352   return ($string);
1356 function normalize_netmask($netmask)
1358   /* Check for notation of netmask */
1359   if (!preg_match('/^([0-9]+\.){3}[0-9]+$/', $netmask)){
1360     $num= (int)($netmask);
1361     $netmask= "";
1363     for ($byte= 0; $byte<4; $byte++){
1364       $result=0;
1366       for ($i= 7; $i>=0; $i--){
1367         if ($num-- > 0){
1368           $result+= pow(2,$i);
1369         }
1370       }
1372       $netmask.= $result.".";
1373     }
1375     return (preg_replace('/\.$/', '', $netmask));
1376   }
1378   return ($netmask);
1382 function netmask_to_bits($netmask)
1384   list($nm0, $nm1, $nm2, $nm3)= split('\.', $netmask);
1385   $res= 0;
1387   for ($n= 0; $n<4; $n++){
1388     $start= 255;
1389     $name= "nm$n";
1391     for ($i= 0; $i<8; $i++){
1392       if ($start == (int)($$name)){
1393         $res+= 8 - $i;
1394         break;
1395       }
1396       $start-= pow(2,$i);
1397     }
1398   }
1400   return ($res);
1404 function recurse($rule, $variables)
1406   $result= array();
1408   if (!count($variables)){
1409     return array($rule);
1410   }
1412   reset($variables);
1413   $key= key($variables);
1414   $val= current($variables);
1415   unset ($variables[$key]);
1417   foreach($val as $possibility){
1418     $nrule= preg_replace("/\{$key\}/", $possibility, $rule);
1419     $result= array_merge($result, recurse($nrule, $variables));
1420   }
1422   return ($result);
1426 function expand_id($rule, $attributes)
1428   /* Check for id rule */
1429   if(preg_match('/^id(:|#)\d+$/',$rule)){
1430     return (array("\{$rule}"));
1431   }
1433   /* Check for clean attribute */
1434   if (preg_match('/^%[a-zA-Z0-9]+$/', $rule)){
1435     $rule= preg_replace('/^%/', '', $rule);
1436     $val= rewrite(preg_replace('/ /', '', strtolower($attributes[$rule])));
1437     return (array($val));
1438   }
1440   /* Check for attribute with parameters */
1441   if (preg_match('/^%[a-zA-Z0-9]+\[[0-9-]+\]$/', $rule)){
1442     $param= preg_replace('/^[^[]+\[([^]]+)]$/', '\\1', $rule);
1443     $part= preg_replace('/^%/', '', preg_replace('/\[.*$/', '', $rule));
1444     $val= rewrite(preg_replace('/ /', '', strtolower($attributes[$part])));
1445     $start= preg_replace ('/-.*$/', '', $param);
1446     $stop = preg_replace ('/^[^-]+-/', '', $param);
1448     /* Assemble results */
1449     $result= array();
1450     for ($i= $start; $i<= $stop; $i++){
1451       $result[]= substr($val, 0, $i);
1452     }
1453     return ($result);
1454   }
1456   echo "Error in idgen string: don't know how to handle rule $rule.\n";
1457   return (array($rule));
1461 function gen_uids($rule, $attributes)
1463   global $config;
1465   /* Search for keys and fill the variables array with all 
1466      possible values for that key. */
1467   $part= "";
1468   $trigger= false;
1469   $stripped= "";
1470   $variables= array();
1472   for ($pos= 0; $pos < strlen($rule); $pos++){
1474     if ($rule[$pos] == "{" ){
1475       $trigger= true;
1476       $part= "";
1477       continue;
1478     }
1480     if ($rule[$pos] == "}" ){
1481       $variables[$pos]= expand_id($part, $attributes);
1482       $stripped.= "\{$pos}";
1483       $trigger= false;
1484       continue;
1485     }
1487     if ($trigger){
1488       $part.= $rule[$pos];
1489     } else {
1490       $stripped.= $rule[$pos];
1491     }
1492   }
1494   /* Recurse through all possible combinations */
1495   $proposed= recurse($stripped, $variables);
1497   /* Get list of used ID's */
1498   $used= array();
1499   $ldap= $config->get_ldap_link();
1500   $ldap->cd($config->current['BASE']);
1501   $ldap->search('(uid=*)');
1503   while($attrs= $ldap->fetch()){
1504     $used[]= $attrs['uid'][0];
1505   }
1507   /* Remove used uids and watch out for id tags */
1508   $ret= array();
1509   foreach($proposed as $uid){
1511     /* Check for id tag and modify uid if needed */
1512     if(preg_match('/\{id:\d+}/',$uid)){
1513       $size= preg_replace('/^.*{id:(\d+)}.*$/', '\\1', $uid);
1515       for ($i= 0; $i < pow(10,$size); $i++){
1516         $number= sprintf("%0".$size."d", $i);
1517         $res= preg_replace('/{id:(\d+)}/', $number, $uid);
1518         if (!in_array($res, $used)){
1519           $uid= $res;
1520           break;
1521         }
1522       }
1523     }
1525   if(preg_match('/\{id#\d+}/',$uid)){
1526     $size= preg_replace('/^.*{id#(\d+)}.*$/', '\\1', $uid);
1528     while (true){
1529       mt_srand((double) microtime()*1000000);
1530       $number= sprintf("%0".$size."d", mt_rand(0, pow(10, $size)-1));
1531       $res= preg_replace('/{id#(\d+)}/', $number, $uid);
1532       if (!in_array($res, $used)){
1533         $uid= $res;
1534         break;
1535       }
1536     }
1537   }
1539 /* Don't assign used ones */
1540 if (!in_array($uid, $used)){
1541   $ret[]= $uid;
1545 return(array_unique($ret));
1549 function array_search_r($needle, $key, $haystack){
1551   foreach($haystack as $index => $value){
1552     $match= 0;
1554     if (is_array($value)){
1555       $match= array_search_r($needle, $key, $value);
1556     }
1558     if ($index==$key && !is_array($value) && preg_match("/$needle/i", $value)){
1559       $match=1;
1560     }
1562     if ($match){
1563       return 1;
1564     }
1565   }
1567   return 0;
1568
1571 /* Sadly values like memory_limit are perpended by K, M, G, etc.
1572    Need to convert... */
1573 function to_byte($value) {
1574   $value= strtolower(trim($value));
1576   if(!is_numeric(substr($value, -1))) {
1578     switch(substr($value, -1)) {
1579       case 'g':
1580         $mult= 1073741824;
1581         break;
1582       case 'm':
1583         $mult= 1048576;
1584         break;
1585       case 'k':
1586         $mult= 1024;
1587         break;
1588     }
1590     return ($mult * (int)substr($value, 0, -1));
1591   } else {
1592     return $value;
1593   }
1597 function in_array_ics($value, $items)
1599   if (!is_array($items)){
1600     return (FALSE);
1601   }
1603   foreach ($items as $item){
1604     if (strtolower($item) == strtolower($value)) {
1605       return (TRUE);
1606     }
1607   }
1609   return (FALSE);
1610
1613 function generate_alphabet($count= 10)
1615   $characters= _("*ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789");
1616   $alphabet= "";
1617   $c= 0;
1619   /* Fill cells with charaters */
1620   for ($i= 0; $i<mb_strlen($characters, 'UTF8'); $i++){
1621     if ($c == 0){
1622       $alphabet.= "<tr>";
1623     }
1625     $ch = mb_substr($characters, $i, 1, "UTF8");
1626     $alphabet.= "<td><a class=\"alphaselect\" href=\"main.php?plug=".
1627       validate($_GET['plug'])."&amp;search=".$ch."\">&nbsp;".$ch."&nbsp;</a></td>";
1629     if ($c++ == $count){
1630       $alphabet.= "</tr>";
1631       $c= 0;
1632     }
1633   }
1635   /* Fill remaining cells */
1636   while ($c++ <= $count){
1637     $alphabet.= "<td>&nbsp;</td>";
1638   }
1640   return ($alphabet);
1644 function validate($string)
1646   return (strip_tags(preg_replace('/\0/', '', $string)));
1649 function get_gosa_version()
1651   global $svn_revision, $svn_path;
1653   /* Extract informations */
1654   $revision= preg_replace('/^[^0-9]*([0-9]+)[^0-9]*$/', '\1', $svn_revision);
1656   /* Release or development? */
1657   if (preg_match('%/gosa/trunk/%', $svn_path)){
1658     return (sprintf(_("GOsa development snapshot (Rev %s)"), $revision));
1659   } else {
1660     $release= preg_replace('%^.*/([^/]+)/include/functions.inc.*$%', '\1', $svn_path);
1661     return (sprintf(_("GOsa $release"), $revision));
1662   }
1666 function rmdirRecursive($path, $followLinks=false) {
1667   $dir= opendir($path);
1668   while($entry= readdir($dir)) {
1669     if(is_file($path."/".$entry) || ((!$followLinks) && is_link($path."/".$entry))) {
1670       unlink($path."/".$entry);
1671     } elseif (is_dir($path."/".$entry) && $entry!='.' && $entry!='..') {
1672       rmdirRecursive($path."/".$entry);
1673     }
1674   }
1675   closedir($dir);
1676   return rmdir($path);
1679 function scan_directory($path,$sort_desc=false)
1681   $ret = false;
1683   /* is this a dir ? */
1684   if(is_dir($path)) {
1686     /* is this path a readable one */
1687     if(is_readable($path)){
1689       /* Get contents and write it into an array */   
1690       $ret = array();    
1692       $dir = opendir($path);
1694       /* Is this a correct result ?*/
1695       if($dir){
1696         while($fp = readdir($dir))
1697           $ret[]= $fp;
1698       }
1699     }
1700   }
1701   /* Sort array ascending , like scandir */
1702   sort($ret);
1704   /* Sort descending if parameter is sort_desc is set */
1705   if($sort_desc) {
1706     $ret = array_reverse($ret);
1707   }
1709   return($ret);
1712 function clean_smarty_compile_dir($directory)
1714   global $svn_revision;
1716   if(is_dir($directory) && is_readable($directory)) {
1717     // Set revision filename to REVISION
1718     $revision_file= $directory."/REVISION";
1720     /* Is there a stamp containing the current revision? */
1721     if(!file_exists($revision_file)) {
1722       // create revision file
1723       create_revision($revision_file, $svn_revision);
1724     } else {
1725 # check for "$config->...['CONFIG']/revision" and the
1726 # contents should match the revision number
1727       if(!compare_revision($revision_file, $svn_revision)){
1728         // If revision differs, clean compile directory
1729         foreach(scan_directory($directory) as $file) {
1730           if(($file==".")||($file=="..")) continue;
1731           if( is_file($directory."/".$file) &&
1732               is_writable($directory."/".$file)) {
1733             // delete file
1734             if(!unlink($directory."/".$file)) {
1735               print_red("File ".$directory."/".$file." could not be deleted.");
1736               // This should never be reached
1737             }
1738           } elseif(is_dir($directory."/".$file) &&
1739               is_writable($directory."/".$file)) {
1740             // Just recursively delete it
1741             rmdirRecursive($directory."/".$file);
1742           }
1743         }
1744         // We should now create a fresh revision file
1745         clean_smarty_compile_dir($directory);
1746       } else {
1747         // Revision matches, nothing to do
1748       }
1749     }
1750   } else {
1751     // Smarty compile dir is not accessible
1752     // (Smarty will warn about this)
1753   }
1756 function create_revision($revision_file, $revision)
1758   $result= false;
1760   if(is_dir(dirname($revision_file)) && is_writable(dirname($revision_file))) {
1761     if($fh= fopen($revision_file, "w")) {
1762       if(fwrite($fh, $revision)) {
1763         $result= true;
1764       }
1765     }
1766     fclose($fh);
1767   } else {
1768     print_red("Can not write to revision file");
1769   }
1771   return $result;
1774 function compare_revision($revision_file, $revision)
1776   // false means revision differs
1777   $result= false;
1779   if(file_exists($revision_file) && is_readable($revision_file)) {
1780     // Open file
1781     if($fh= fopen($revision_file, "r")) {
1782       // Compare File contents with current revision
1783       if($revision == fread($fh, filesize($revision_file))) {
1784         $result= true;
1785       }
1786     } else {
1787       print_red("Can not open revision file");
1788     }
1789     // Close file
1790     fclose($fh);
1791   }
1793   return $result;
1796 function progressbar($percentage,$width=100,$height=15,$showvalue=false)
1798   $str = ""; // Our return value will be saved in this var
1800   $color  = dechex($percentage+150);
1801   $color2 = dechex(150 - $percentage);
1802   $bgcolor= $showvalue?"FFFFFF":"DDDDDD";
1804   $progress = (int)(($percentage /100)*$width);
1806   /* Abort printing out percentage, if divs are to small */
1809   /* If theres a better solution for this, use it... */
1810   $str = "
1811     <div style=\" width:".($width)."px; 
1812     height:".($height)."px;
1813   background-color:#000000;
1814 padding:1px;\">
1816           <div style=\" width:".($width)."px;
1817         background-color:#$bgcolor;
1818 height:".($height)."px;\">
1820          <div style=\" width:".$progress."px;
1821 height:".$height."px;
1822        background-color:#".$color2.$color2.$color."; \">";
1825        if(($height >10)&&($showvalue)){
1826          $str.=                 "<font style=\"font-size:".($height-2)."px;color:#FF0000;align:middle;padding-left:".((int)(($width*0.4)))."px;\">
1827            <b>".$percentage."%</b>
1828            </font>";
1829        }
1831        $str.= "</div></div></div>";
1833        return($str);
1837 function array_key_ics($ikey, $items)
1839   /* Gather keys, make them lowercase */
1840   $tmp= array();
1841   foreach ($items as $key => $value){
1842     $tmp[strtolower($key)]= $key;
1843   }
1845   if (isset($tmp[strtolower($ikey)])){
1846     return($tmp[strtolower($ikey)]);
1847   }
1849   return ("");
1853 function search_config($arr, $name, $return)
1855   if (is_array($arr)){
1856     foreach ($arr as $a){
1857       if (isset($a['CLASS']) &&
1858           strtolower($a['CLASS']) == strtolower($name)){
1860         if (isset($a[$return])){
1861           return ($a[$return]);
1862         } else {
1863           return ("");
1864         }
1865       } else {
1866         $res= search_config ($a, $name, $return);
1867         if ($res != ""){
1868           return $res;
1869         }
1870       }
1871     }
1872   }
1873   return ("");
1877 function array_differs($src, $dst)
1879   /* If the count is differing, the arrays differ */
1880   if (count ($src) != count ($dst)){
1881     return (TRUE);
1882   }
1884   /* So the count is the same - lets check the contents */
1885   $differs= FALSE;
1886   foreach($src as $value){
1887     if (!in_array($value, $dst)){
1888       $differs= TRUE;
1889     }
1890   }
1892   return ($differs);
1896 function saveFilter($a_filter, $values)
1898   if (isset($_POST['regexit'])){
1899     $a_filter["regex"]= $_POST['regexit'];
1901     foreach($values as $type){
1902       if (isset($_POST[$type])) {
1903         $a_filter[$type]= "checked";
1904       } else {
1905         $a_filter[$type]= "";
1906       }
1907     }
1908   }
1910   /* React on alphabet links if needed */
1911   if (isset($_GET['search'])){
1912     $s= mb_substr(validate($_GET['search']), 0, 1, "UTF8")."*";
1913     if ($s == "**"){
1914       $s= "*";
1915     }
1916     $a_filter['regex']= $s;
1917   }
1919   return ($a_filter);
1923 /* Escape all preg_* relevant characters */
1924 function normalizePreg($input)
1926   return (addcslashes($input, '[]()|/.*+-'));
1930 /* Escape all LDAP filter relevant characters */
1931 function normalizeLdap($input)
1933   return (addcslashes($input, '()|'));
1937 /* Resturns the difference between to microtime() results in float  */
1938 function get_MicroTimeDiff($start , $stop)
1940   $a = split("\ ",$start);
1941   $b = split("\ ",$stop);
1943   $secs = $b[1] - $a[1];
1944   $msecs= $b[0] - $a[0]; 
1946   $ret = (float) ($secs+ $msecs);
1947   return($ret);
1951 // vim:tabstop=2:expandtab:shiftwidth=2:filetype=php:syntax:ruler:
1952 ?>