Code

Updated change_password
[gosa.git] / gosa-core / include / functions.inc
1 <?php
2 /*
3  * This code is part of GOsa (http://www.gosa-project.org)
4  * Copyright (C) 2003-2008 GONICUS GmbH
5  *
6  * ID: $$Id: functions.inc 13100 2008-12-01 14:07:48Z hickert $$
7  *
8  * This program is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation; either version 2 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software
20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
21  */
23 /*! \file
24  * Common functions and named definitions. */
26 /* Configuration file location */
27 if(!isset($_SERVER['CONFIG_DIR'])){
28   define ("CONFIG_DIR", "/etc/gosa");
29 }else{
30   define ("CONFIG_DIR",$_SERVER['CONFIG_DIR']);
31 }
33 /* Allow setting the config file in the apache configuration
34     e.g.  SetEnv CONFIG_FILE gosa.conf.2.6
35  */
36 if(!isset($_SERVER['CONFIG_FILE'])){
37   define ("CONFIG_FILE", "gosa.conf");
38 }else{
39   define ("CONFIG_FILE",$_SERVER['CONFIG_FILE']);
40 }
42 /* Define common locatitions */
43 define ("CONFIG_TEMPLATE_DIR", "../contrib");
44 define ("TEMP_DIR","/var/cache/gosa/tmp");
46 /* Define get_list flags */
47 define("GL_NONE",         0);
48 define("GL_SUBSEARCH",    1);
49 define("GL_SIZELIMIT",    2);
50 define("GL_CONVERT",      4);
51 define("GL_NO_ACL_CHECK", 8);
53 /* Heimdal stuff */
54 define('UNIVERSAL',0x00);
55 define('INTEGER',0x02);
56 define('OCTET_STRING',0x04);
57 define('OBJECT_IDENTIFIER ',0x06);
58 define('SEQUENCE',0x10);
59 define('SEQUENCE_OF',0x10);
60 define('SET',0x11);
61 define('SET_OF',0x11);
62 define('DEBUG',false);
63 define('HDB_KU_MKEY',0x484442);
64 define('TWO_BIT_SHIFTS',0x7efc);
65 define('DES_CBC_CRC',1);
66 define('DES_CBC_MD4',2);
67 define('DES_CBC_MD5',3);
68 define('DES3_CBC_MD5',5);
69 define('DES3_CBC_SHA1',16);
71 /* Define globals for revision comparing */
72 $svn_path = '$HeadURL$';
73 $svn_revision = '$Revision$';
75 /* Include required files */
76 require_once("class_location.inc");
77 require_once ("functions_debug.inc");
78 require_once ("accept-to-gettext.inc");
80 /* Define constants for debugging */
81 define ("DEBUG_TRACE",   1); /*! Debug level for tracing of common actions (save, check, etc.) */
82 define ("DEBUG_LDAP",    2); /*! Debug level for LDAP queries */
83 define ("DEBUG_MYSQL",   4); /*! Debug level for mysql operations */
84 define ("DEBUG_SHELL",   8); /*! Debug level for shell commands */
85 define ("DEBUG_POST",   16); /*! Debug level for POST content */
86 define ("DEBUG_SESSION",32); /*! Debug level for SESSION content */
87 define ("DEBUG_CONFIG", 64); /*! Debug level for CONFIG information */
88 define ("DEBUG_ACL",    128); /*! Debug level for ACL infos */
89 define ("DEBUG_SI",     256); /*! Debug level for communication with gosa-si */
90 define ("DEBUG_MAIL",   512); /*! Debug level for all about mail (mailAccounts, imap, sieve etc.) */
91 define ("DEBUG_FAI",   1024); // FAI (incomplete)
92 define ("DEBUG_RPC",   2048); /*! Debug level for communication with remote procedures */
94 // Define shadow states
95 define ("POSIX_ACCOUNT_EXPIRED", 1);
96 define ("POSIX_WARN_ABOUT_EXPIRATION", 2);
97 define ("POSIX_FORCE_PASSWORD_CHANGE", 4);
98 define ("POSIX_DISALLOW_PASSWORD_CHANGE", 8);
100 /* Rewrite german 'umlauts' and spanish 'accents'
101    to get better results */
102 $REWRITE= array( "ä" => "ae",
103     "ö" => "oe",
104     "ü" => "ue",
105     "Ä" => "Ae",
106     "Ö" => "Oe",
107     "Ü" => "Ue",
108     "ß" => "ss",
109     "á" => "a",
110     "é" => "e",
111     "í" => "i",
112     "ó" => "o",
113     "ú" => "u",
114     "Á" => "A",
115     "É" => "E",
116     "Í" => "I",
117     "Ó" => "O",
118     "Ú" => "U",
119     "ñ" => "ny",
120     "Ñ" => "Ny" );
123 /*! \brief Does autoloading for classes used in GOsa.
124  *
125  *  Takes the list generated by 'update-gosa' and loads the
126  *  file containing the requested class.
127  *
128  *  \param  string 'class_name' The currently requested class
129  */
130 function __gosa_autoload($class_name) {
131     global $class_mapping, $BASE_DIR;
133     if ($class_mapping === NULL){
134             echo sprintf(_("Fatal error: no class locations defined - please run %s to fix this"), bold("update-gosa"));
135             exit;
136     }
138     if (isset($class_mapping["$class_name"])){
139       require_once($BASE_DIR."/".$class_mapping["$class_name"]);
140     } else {
141       echo sprintf(_("Fatal error: cannot instantiate class %s - try running %s to fix this"), bold($class_name), bold("update-gosa"));
142       exit;
143     }
145 spl_autoload_register('__gosa_autoload');
148 /*! \brief Checks if a class is available. 
149  *  \param  string 'name' The subject of the test
150  *  \return boolean True if class is available, else false.
151  */
152 function class_available($name)
154   global $class_mapping, $config;
155     
156   $disabled = array();
157   if($config instanceOf config && $config->configRegistry instanceOf configRegistry){
158     $disabled = $config->configRegistry->getDisabledPlugins();
159   }
161   return(isset($class_mapping[$name]) && !isset($disabled[$name]));
165 /*! \brief Check if plugin is available
166  *
167  * Checks if a given plugin is available and readable.
168  *
169  * \param string 'plugin' the subject of the check
170  * \return boolean True if plugin is available, else FALSE.
171  */
172 function plugin_available($plugin)
174         global $class_mapping, $BASE_DIR;
176         if (!isset($class_mapping[$plugin])){
177                 return false;
178         } else {
179                 return is_readable($BASE_DIR."/".$class_mapping[$plugin]);
180         }
184 /*! \brief Create seed with microseconds 
185  *
186  * Example:
187  * \code
188  * srand(make_seed());
189  * $random = rand();
190  * \endcode
191  *
192  * \return float a floating point number which can be used to feed srand() with it
193  * */
194 function make_seed() {
195   list($usec, $sec) = explode(' ', microtime());
196   return (float) $sec + ((float) $usec * 100000);
200 /*! \brief Debug level action 
201  *
202  * Print a DEBUG level if specified debug level of the level matches the 
203  * the configured debug level.
204  *
205  * \param int 'level' The log level of the message (should use the constants,
206  * defined in functions.in (DEBUG_TRACE, DEBUG_LDAP, etc.)
207  * \param int 'line' Define the line of the logged action (using __LINE__ is common)
208  * \param string 'function' Define the function where the logged action happened in
209  * (using __FUNCTION__ is common)
210  * \param string 'file' Define the file where the logged action happend in
211  * (using __FILE__ is common)
212  * \param mixed 'data' The data to log. Can be a message or an array, which is printed
213  * with print_a
214  * \param string 'info' Optional: Additional information
215  *
216  * */
217 function DEBUG($level, $line, $function, $file, $data, $info="")
219     global $config;
220     $debugLevel = 0;
221     if($config instanceOf config){
222         $debugLevel = $config->get_cfg_value('core', 'debugLevel');
223     }
224     if ($debugLevel & $level){
225         $output= "DEBUG[$level] ";
226         if ($function != ""){
227             $output.= "($file:$function():$line) - $info: ";
228         } else {
229             $output.= "($file:$line) - $info: ";
230         }
231         echo $output;
232         if (is_array($data)){
233             print_a($data);
234         } else {
235             echo "'$data'";
236         }
237         echo "<br>";
238     }
242 /*! \brief Determine which language to show to the user
243  *
244  * Determines which language should be used to present gosa content
245  * to the user. It does so by looking at several possibilites and returning
246  * the first setting that can be found.
247  *
248  * -# Language configured by the user
249  * -# Global configured language
250  * -# Language as returned by al2gt (as configured in the browser)
251  *
252  * \return string gettext locale string
253  */
254 function get_browser_language()
256   /* Try to use users primary language */
257   global $config;
258   $ui= get_userinfo();
259   if (isset($ui) && $ui !== NULL){
260     if ($ui->language != ""){
261       return ($ui->language.".UTF-8");
262     }
263   }
265   /* Check for global language settings in gosa.conf */
266   if (isset ($config) && $config->get_cfg_value("core",'language') != ""){
267     $lang = $config->get_cfg_value("core",'language');
268     if(!preg_match("/utf/i",$lang)){
269       $lang .= ".UTF-8";
270     }
271     return($lang);
272   }
273  
274   /* Load supported languages */
275   $gosa_languages= get_languages();
277   /* Move supported languages to flat list */
278   $langs= array();
279   foreach($gosa_languages as $lang => $dummy){
280     $langs[]= $lang.'.UTF-8';
281   }
283   /* Return gettext based string */
284   return (al2gt($langs, 'text/html'));
288 /*! \brief Rewrite ui object to another dn 
289  *
290  * Usually used when a user is renamed. In this case the dn
291  * in the user object must be updated in order to point
292  * to the correct DN.
293  *
294  * \param string 'dn' the old DN
295  * \param string 'newdn' the new DN
296  * */
297 function change_ui_dn($dn, $newdn)
299   $ui= session::global_get('ui');
300   if ($ui->dn == $dn){
301     $ui->dn= $newdn;
302     session::global_set('ui',$ui);
303   }
307 /*! \brief Return themed path for specified base file
308  *
309  *  Depending on its parameters, this function returns the full
310  *  path of a template file. First match wins while searching
311  *  in this order:
312  *
313  *  - load theme depending file
314  *  - load global theme depending file
315  *  - load default theme file
316  *  - load global default theme file
317  *
318  *  \param  string 'filename' The base file name
319  *  \param  boolean 'plugin' Flag to take the plugin directory as search base
320  *  \param  string 'path' User specified path to take as search base
321  *  \return string Full path to the template file
322  */
323 function get_template_path($filename= '', $plugin= FALSE, $path= "")
325   global $config, $BASE_DIR;
327   /* Set theme */
328   if (isset ($config)){
329         $theme= $config->get_cfg_value("core","theme");
330   } else {
331         $theme= "default";
332   }
334   /* Return path for empty filename */
335   if ($filename == ''){
336     return ("themes/$theme/");
337   }
339   /* Return plugin dir or root directory? */
340   if ($plugin){
341     if ($path == ""){
342       $nf= preg_replace("!^".$BASE_DIR."/!", "", preg_replace('/^\.\.\//', '', session::global_get('plugin_dir')));
343     } else {
344       $nf= preg_replace("!^".$BASE_DIR."/!", "", $path);
345     }
346     if (file_exists("$BASE_DIR/ihtml/themes/$theme/$nf")){
347       return ("$BASE_DIR/ihtml/themes/$theme/$nf/$filename");
348     }
349     if (file_exists("$BASE_DIR/ihtml/themes/default/$nf")){
350       return ("$BASE_DIR/ihtml/themes/default/$nf/$filename");
351     }
352     if ($path == ""){
353       return (session::global_get('plugin_dir')."/$filename");
354     } else {
355       return ($path."/$filename");
356     }
357   } else {
358     if (file_exists("themes/$theme/$filename")){
359       return ("themes/$theme/$filename");
360     }
361     if (file_exists("$BASE_DIR/ihtml/themes/$theme/$filename")){
362       return ("$BASE_DIR/ihtml/themes/$theme/$filename");
363     }
364     if (file_exists("themes/default/$filename")){
365       return ("themes/default/$filename");
366     }
367     if (file_exists("$BASE_DIR/ihtml/themes/default/$filename")){
368       return ("$BASE_DIR/ihtml/themes/default/$filename");
369     }
370     return ($filename);
371   }
375 /*! \brief Remove multiple entries from an array
376  *
377  * Removes every element that is in $needles from the
378  * array given as $haystack
379  *
380  * \param array 'needles' array of the entries to remove
381  * \param array 'haystack' original array to remove the entries from
382  */
383 function array_remove_entries($needles, $haystack)
385   return (array_merge(array_diff($haystack, $needles)));
389 /*! \brief Remove multiple entries from an array (case-insensitive)
390  *
391  * Same as array_remove_entries(), but case-insensitive. */
392 function array_remove_entries_ics($needles, $haystack)
394   // strcasecmp will work, because we only compare ASCII values here
395   return (array_merge(array_udiff($haystack, $needles, 'strcasecmp')));
399 /*! Merge to array but remove duplicate entries
400  *
401  * Merges two arrays and removes duplicate entries. Triggers
402  * an error if first or second parametre is not an array.
403  *
404  * \param array 'ar1' first array
405  * \param array 'ar2' second array-
406  * \return array
407  */
408 function gosa_array_merge($ar1,$ar2)
410   if(!is_array($ar1) || !is_array($ar2)){
411     trigger_error("Specified parameter(s) are not valid arrays.");
412   }else{
413     return(array_values(array_unique(array_merge($ar1,$ar2))));
414   }
418 /*! \brief Generate a system log info
419  *
420  * Creates a syslog message, containing user information.
421  *
422  * \param string 'message' the message to log
423  * */
424 function gosa_log ($message)
426   global $ui;
428   /* Preset to something reasonable */
429   $username= "[unauthenticated]";
431   /* Replace username if object is present */
432   if (isset($ui)){
433     if ($ui->username != ""){
434       $username= "[$ui->username]";
435     } else {
436       $username= "[unknown]";
437     }
438   }
440   syslog(LOG_INFO,"GOsa$username: $message");
444 /*! \brief Initialize a LDAP connection
445  *
446  * Initializes a LDAP connection. 
447  *
448  * \param string 'server'
449  * \param string 'base'
450  * \param string 'binddn' Default: empty
451  * \param string 'pass' Default: empty
452  *
453  * \return LDAP object
454  */
455 function ldap_init ($server, $base, $binddn='', $pass='')
457   global $config;
459   $ldap = new LDAP ($binddn, $pass, $server,
460       isset($config->current['LDAPFOLLOWREFERRALS']) && $config->current['LDAPFOLLOWREFERRALS'] == "true",
461       isset($config->current['LDAPTLS']) && $config->current['LDAPTLS'] == "true");
463   /* Sadly we've no proper return values here. Use the error message instead. */
464   if (!$ldap->success()){
465     msg_dialog::display(_("Fatal error"),
466         sprintf(_("Error while connecting to LDAP: %s"), $ldap->get_error()),
467         FATAL_ERROR_DIALOG);
468     exit();
469   }
471   /* Preset connection base to $base and return to caller */
472   $ldap->cd ($base);
473   return $ldap;
477 /* \brief Process htaccess authentication */
478 function process_htaccess ($username, $kerberos= FALSE)
480   global $config;
482   /* Search for $username and optional @REALM in all configured LDAP trees */
483   foreach($config->data["LOCATIONS"] as $name => $data){
484   
485     $config->set_current($name);
486     $mode= "kerberos";
487     if ($config->get_cfg_value("core","useSaslForKerberos") == "true"){
488       $mode= "sasl";
489     }
491     /* Look for entry or realm */
492     $ldap= $config->get_ldap_link();
493     if (!$ldap->success()){
494       msg_dialog::display(_("LDAP error"), 
495           msgPool::ldaperror($ldap->get_error(), "", LDAP_AUTH)."<br><br>".session::get('errors'), 
496           FATAL_ERROR_DIALOG);
497       exit();
498     }
499     $ldap->search("(&(objectClass=gosaAccount)(|(uid=$username)(userPassword={$mode}$username)))", array("uid"));
501     /* Found a uniq match? Return it... */
502     if ($ldap->count() == 1) {
503       $attrs= $ldap->fetch();
504       return array("username" => $attrs["uid"][0], "server" => $name);
505     }
506   }
508   /* Nothing found? Return emtpy array */
509   return array("username" => "", "server" => "");
513 /*! \brief Verify user login against htaccess
514  *
515  * Checks if the specified username is available in apache, maps the user
516  * to an LDAP user. The password has been checked by apache already.
517  *
518  * \param string 'username'
519  * \return
520  *  - TRUE on SUCCESS, NULL or FALSE on error
521  */
522 function ldap_login_user_htaccess ($username)
524   global $config;
526   /* Look for entry or realm */
527   $ldap= $config->get_ldap_link();
528   if (!$ldap->success()){
529     msg_dialog::display(_("LDAP error"), 
530         msgPool::ldaperror($ldap->get_error(), "", LDAP_AUTH)."<br><br>".session::get('errors'), 
531         FATAL_ERROR_DIALOG);
532     exit();
533   }
534   $ldap->search("(&(objectClass=gosaAccount)(uid=$username))", array("uid"));
535   /* Found no uniq match? Strange, because we did above... */
536   if ($ldap->count() != 1) {
537     msg_dialog::display(_("LDAP error"), _("User ID is not unique!"), FATAL_ERROR_DIALOG);
538     return (NULL);
539   }
540   $attrs= $ldap->fetch();
542   /* got user dn, fill acl's */
543   $ui= new userinfo($config, $ldap->getDN());
544   $ui->username= $attrs['uid'][0];
546   /* Bail out if we have login restrictions set, for security reasons
547      the message is the same than failed user/pw */
548   if (!$ui->loginAllowed()){
549     new log("security","login","",array(),"Login restriction for user \"$username\", login not permitted");
550     return (NULL);
551   }
553   /* No password check needed - the webserver did it for us */
554   $ldap->disconnect();
556   /* Username is set, load subtreeACL's now */
557   $ui->loadACL();
559   /* TODO: check java script for htaccess authentication */
560   session::global_set('js', true);
562   return ($ui);
566 /*! \brief Verify user login against LDAP directory
567  *
568  * Checks if the specified username is in the LDAP and verifies if the
569  * password is correct by binding to the LDAP with the given credentials.
570  *
571  * \param string 'username'
572  * \param string 'password'
573  * \return
574  *  - TRUE on SUCCESS, NULL or FALSE on error
575  */
576 function ldap_login_user ($username, $password)
578   global $config;
580   /* look through the entire ldap */
581   $ldap = $config->get_ldap_link();
582   if (!$ldap->success()){
583     msg_dialog::display(_("LDAP error"), 
584         msgPool::ldaperror($ldap->get_error(), "", LDAP_AUTH)."<br><br>".session::get('errors'), 
585         FATAL_ERROR_DIALOG);
586     exit();
587   }
588   $ldap->cd($config->current['BASE']);
589   $allowed_attributes = array("uid","mail");
590   $verify_attr = array();
591   if($config->get_cfg_value("core","loginAttribute") != ""){
592     $tmp = explode(",", $config->get_cfg_value("core","loginAttribute")); 
593     foreach($tmp as $attr){
594       if(in_array($attr,$allowed_attributes)){
595         $verify_attr[] = $attr;
596       }
597     }
598   }
599   if(count($verify_attr) == 0){
600     $verify_attr = array("uid");
601   }
602   $tmp= $verify_attr;
603   $tmp[] = "uid";
604   $filter = "";
605   foreach($verify_attr as $attr) {
606     $filter.= "(".$attr."=".$username.")";
607   }
608   $filter = "(&(|".$filter.")(objectClass=gosaAccount))";
609   $ldap->search($filter,$tmp);
611   /* get results, only a count of 1 is valid */
612   switch ($ldap->count()){
614     /* user not found */
615     case 0:     return (NULL);
617             /* valid uniq user */
618     case 1: 
619             break;
621             /* found more than one matching id */
622     default:
623             msg_dialog::display(_("Internal error"), _("User ID is not unique!"), FATAL_ERROR_DIALOG);
624             return (NULL);
625   }
627   /* LDAP schema is not case sensitive. Perform additional check. */
628   $attrs= $ldap->fetch();
629   $success = FALSE;
630   foreach($verify_attr as $attr){
631     if(isset($attrs[$attr][0]) && $attrs[$attr][0] == $username){
632       $success = TRUE;
633     }
634   }
635   if(!$success){
636     return(FALSE);
637   }
639   /* got user dn, fill acl's */
640   $ui= new userinfo($config, $ldap->getDN());
641   $ui->username= $attrs['uid'][0];
643   /* Bail out if we have login restrictions set, for security reasons
644      the message is the same than failed user/pw */
645   if (!$ui->loginAllowed()){
646     new log("security","login","",array(),"Login restriction for user \"$username\", login not permitted");
647     return (NULL);
648   }
650   /* password check, bind as user with supplied password  */
651   $ldap->disconnect();
652   $ldap= new LDAP($ui->dn, $password, $config->current['SERVER'],
653       isset($config->current['LDAPFOLLOWREFERRALS']) &&
654       $config->current['LDAPFOLLOWREFERRALS'] == "true",
655       isset($config->current['LDAPTLS'])
656       && $config->current['LDAPTLS'] == "true");
657   if (!$ldap->success()){
658     return (NULL);
659   }
661   /* Username is set, load subtreeACL's now */
662   $ui->loadACL();
664   return ($ui);
668 /*! \brief      Checks the posixAccount status by comparing the shadow attributes.
669  *
670  * @param Object    The GOsa configuration object.
671  * @param String    The 'dn' of the user to test the account status for.
672  * @param String    The 'uid' of the user we're going to test.
673  * @return Const
674  *                  POSIX_ACCOUNT_EXPIRED           - If the account is expired.
675  *                  POSIX_WARN_ABOUT_EXPIRATION     - If the account is going to expire.
676  *                  POSIX_FORCE_PASSWORD_CHANGE     - The password has to be changed.
677  *                  POSIX_DISALLOW_PASSWORD_CHANGE  - The password cannot be changed right now.
678  *
679  *
680  *
681  *      shadowLastChange
682  *      |
683  *      |---- shadowMin --->    |       <-- shadowMax --
684  *      |                       |       |
685  *      |------- shadowWarning ->       |
686  *                                      |-- shadowInactive --> DEACTIVATED
687  *                                      |
688  *                                      EXPIRED
689  *
690  */
691 function ldap_expired_account($config, $userdn, $uid)
693     // Skip this for the admin account, we do not want to lock him out.
694     if($uid == 'admin') return(0);
696     $ldap= $config->get_ldap_link();
697     $ldap->cd($config->current['BASE']);
698     $ldap->cat($userdn);
699     $attrs= $ldap->fetch();
700     $current= floor(date("U") /60 /60 /24);
702     // Fetch required attributes
703     foreach(array('shadowExpire','shadowLastChange','shadowMax','shadowMin',
704                 'shadowInactive','shadowWarning') as $attr){
705         $$attr = (isset($attrs[$attr][0]))? $attrs[$attr][0] : null;
706     }
709     // Check if the account has expired.
710     // ---------------------------------
711     // An account is locked/expired once its expiration date has reached (shadowExpire).
712     // If the optional attribute (shadowInactive) is set, we've to postpone
713     //  the account expiration by the amount of days specified in (shadowInactive).
714     if($shadowExpire != null && $shadowExpire >= $current){
716         // The account seems to be expired, but we've to check 'shadowInactive' additionally.
717         // ShadowInactive specifies an amount of days we've to reprieve the user.
718         // It some kind of x days' grace.
719         if($shadowInactive == null || $current > $shadowExpire + $shadowInactive){
721             // Finally we've detect that the account is deactivated.
722             return(POSIX_ACCOUNT_EXPIRED);
723         }
724     }
726     // The users password is going to expire.
727     // --------------------------------------
728     // We've to warn the user in the case of an expiring account.
729     // An account is going to expire when it reaches its expiration date (shadowExpire).
730     // The user has to be warned, if the days left till expiration, match the
731     //  configured warning period (shadowWarning)
732     // --> shadowWarning: Warn x days before account expiration.
733     if($shadowExpire != null && $shadowWarning != null){
735         // Check if the account is still active and not already expired.
736         if($shadowExpire >= $current){
738             // Check if we've to warn the user by comparing the remaining
739             //  number of days till expiration with the configured amount
740             //  of days in shadowWarning.
741             if(($shadowExpire - $current) <= $shadowWarning){
742                 return(POSIX_WARN_ABOUT_EXPIRATION);
743             }
744         }
745     }
747     // -- I guess this is the correct detection, isn't it? 
748     if($shadowLastChange != null && $shadowWarning != null && $shadowMax != null){
749         $daysRemaining = ($shadowLastChange + $shadowMax) - $current ;
750         if($daysRemaining > 0 && $daysRemaining <= $shadowWarning){
751                 return(POSIX_WARN_ABOUT_EXPIRATION);
752         }
753     }
756     // Check if we've to force the user to change his password.
757     // --------------------------------------------------------
758     // A password change is enforced when the password is older than
759     //  the configured amount of days (shadowMax).
760     // The age of the current password (shadowLastChange) plus the maximum
761     //  amount amount of days (shadowMax) has to be smaller than the
762     //  current timestamp.
763     if($shadowLastChange != null && $shadowMax != null){
765         // Check if we've an outdated password.
766         if($current >= ($shadowLastChange + $shadowMax)){
767             return(POSIX_FORCE_PASSWORD_CHANGE);
768         }
769     }
772     // Check if we've to freeze the users password.
773     // --------------------------------------------
774     // Once a user has changed his password, he cannot change it again
775     //  for a given amount of days (shadowMin).
776     // We should not allow to change the password within GOsa too.
777     if($shadowLastChange != null && $shadowMin != null){
779         // Check if we've an outdated password.
780         if(($shadowLastChange + $shadowMin) >= $current){
781             return(POSIX_DISALLOW_PASSWORD_CHANGE);
782         }
783     }
785     return(0);
790 /*! \brief Add a lock for object(s)
791  *
792  * Adds a lock by the specified user for one ore multiple objects.
793  * If the lock for that object already exists, an error is triggered.
794  *
795  * \param mixed 'object' object or array of objects to lock
796  * \param string 'user' the user who shall own the lock
797  * */
798 function add_lock($object, $user)
800   global $config;
802   /* Remember which entries were opened as read only, because we 
803       don't need to remove any locks for them later.
804    */
805   if(!session::global_is_set("LOCK_CACHE")){
806     session::global_set("LOCK_CACHE",array(""));
807   }
808   if(is_array($object)){
809     foreach($object as $obj){
810       add_lock($obj,$user);
811     }
812     return;
813   }
815   $cache = &session::global_get("LOCK_CACHE");
816   if(isset($_POST['open_readonly'])){
817     $cache['READ_ONLY'][$object] = TRUE;
818     return;
819   }
820   if(isset($cache['READ_ONLY'][$object])){
821     unset($cache['READ_ONLY'][$object]);
822   }
825   /* Just a sanity check... */
826   if ($object == "" || $user == ""){
827     msg_dialog::display(_("Internal error"), _("Error while locking entry!"), ERROR_DIALOG);
828     return;
829   }
831   /* Check for existing entries in lock area */
832   $ldap= $config->get_ldap_link();
833   $ldap->cd ($config->get_cfg_value("core","config"));
834   $ldap->search("(&(objectClass=gosaLockEntry)(gosaUser=$user)(gosaObject=".base64_encode($object)."))",
835       array("gosaUser"));
836   if (!$ldap->success()){
837     msg_dialog::display(_("Configuration error"), sprintf(_("Cannot store lock information in LDAP!")."<br><br>"._('Error: %s'), "<br><br><i>".$ldap->get_error()."</i>"), ERROR_DIALOG);
838     return;
839   }
841   /* Add lock if none present */
842   if ($ldap->count() == 0){
843     $attrs= array();
844     $name= md5($object);
845     $ldap->cd("cn=$name,".$config->get_cfg_value("core","config"));
846     $attrs["objectClass"] = "gosaLockEntry";
847     $attrs["gosaUser"] = $user;
848     $attrs["gosaObject"] = base64_encode($object);
849     $attrs["cn"] = "$name";
850     $ldap->add($attrs);
851     if (!$ldap->success()){
852       msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), "cn=$name,".$config->get_cfg_value("core","config"), 0, ERROR_DIALOG));
853       return;
854     }
855   }
859 /*! \brief Remove a lock for object(s)
860  *
861  * Does the opposite of add_lock().
862  *
863  * \param mixed 'object' object or array of objects for which a lock shall be removed
864  * */
865 function del_lock ($object)
867   global $config;
869   if(is_array($object)){
870     foreach($object as $obj){
871       del_lock($obj);
872     }
873     return;
874   }
876   /* Sanity check */
877   if ($object == ""){
878     return;
879   }
881   /* If this object was opened in read only mode then 
882       skip removing the lock entry, there wasn't any lock created.
883     */
884   if(session::global_is_set("LOCK_CACHE")){
885     $cache = &session::global_get("LOCK_CACHE");
886     if(isset($cache['READ_ONLY'][$object])){
887       unset($cache['READ_ONLY'][$object]);
888       return;
889     }
890   }
892   /* Check for existance and remove the entry */
893   $ldap= $config->get_ldap_link();
894   $ldap->cd ($config->get_cfg_value("core","config"));
895   $ldap->search ("(&(objectClass=gosaLockEntry)(gosaObject=".base64_encode($object)."))", array("gosaObject"));
896   $attrs= $ldap->fetch();
897   if ($ldap->getDN() != "" && $ldap->success()){
898     $ldap->rmdir ($ldap->getDN());
900     if (!$ldap->success()){
901       msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), $ldap->getDN(), LDAP_DEL, ERROR_DIALOG));
902       return;
903     }
904   }
908 /*! \brief Remove all locks owned by a specific userdn
909  *
910  * For a given userdn remove all existing locks. This is usually
911  * called on logout.
912  *
913  * \param string 'userdn' the subject whose locks shall be deleted
914  */
915 function del_user_locks($userdn)
917   global $config;
919   /* Get LDAP ressources */ 
920   $ldap= $config->get_ldap_link();
921   $ldap->cd ($config->get_cfg_value("core","config"));
923   /* Remove all objects of this user, drop errors silently in this case. */
924   $ldap->search("(&(objectClass=gosaLockEntry)(gosaUser=$userdn))", array("gosaUser"));
925   while ($attrs= $ldap->fetch()){
926     $ldap->rmdir($attrs['dn']);
927   }
931 /*! \brief Get a lock for a specific object
932  *
933  * Searches for a lock on a given object.
934  *
935  * \param string 'object' subject whose locks are to be searched
936  * \return string Returns the user who owns the lock or "" if no lock is found
937  * or an error occured. 
938  */
939 function get_lock ($object)
941   global $config;
943   /* Sanity check */
944   if ($object == ""){
945     msg_dialog::display(_("Internal error"), _("Error while locking entry!"), ERROR_DIALOG);
946     return("");
947   }
949   /* Allow readonly access, the plugin::plugin will restrict the acls */
950   if(isset($_POST['open_readonly'])) return("");
952   /* Get LDAP link, check for presence of the lock entry */
953   $user= "";
954   $ldap= $config->get_ldap_link();
955   $ldap->cd ($config->get_cfg_value("core","config"));
956   $ldap->search("(&(objectClass=gosaLockEntry)(gosaObject=".base64_encode($object)."))", array("gosaUser"));
957   if (!$ldap->success()){
958     msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), "", LDAP_SEARCH, ERROR_DIALOG));
959     return("");
960   }
962   /* Check for broken locking information in LDAP */
963   if ($ldap->count() > 1){
965     /* Clean up these references now... */
966     while ($attrs= $ldap->fetch()){
967       $ldap->rmdir($attrs['dn']);
968     }
970     return("");
972   } elseif ($ldap->count() == 1){
973     $attrs = $ldap->fetch();
974     $user= $attrs['gosaUser'][0];
975   }
976   return ($user);
980 /*! Get locks for multiple objects
981  *
982  * Similar as get_lock(), but for multiple objects.
983  *
984  * \param array 'objects' Array of Objects for which a lock shall be searched
985  * \return A numbered array containing all found locks as an array with key 'dn'
986  * and key 'user' or "" if an error occured.
987  */
988 function get_multiple_locks($objects)
990   global $config;
992   if(is_array($objects)){
993     $filter = "(&(objectClass=gosaLockEntry)(|";
994     foreach($objects as $obj){
995       $filter.="(gosaObject=".base64_encode($obj).")";
996     }
997     $filter.= "))";
998   }else{
999     $filter = "(&(objectClass=gosaLockEntry)(gosaObject=".base64_encode($objects)."))";
1000   }
1002   /* Get LDAP link, check for presence of the lock entry */
1003   $user= "";
1004   $ldap= $config->get_ldap_link();
1005   $ldap->cd ($config->get_cfg_value("core","config"));
1006   $ldap->search($filter, array("gosaUser","gosaObject"));
1007   if (!$ldap->success()){
1008     msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), "", LDAP_SEARCH, ERROR_DIALOG));
1009     return("");
1010   }
1012   $users = array();
1013   while($attrs = $ldap->fetch()){
1014     $dn   = base64_decode($attrs['gosaObject'][0]);
1015     $user = $attrs['gosaUser'][0];
1016     $users[] = array("dn"=> $dn,"user"=>$user);
1017   }
1018   return ($users);
1022 /*! \brief Search base and sub-bases for all objects matching the filter
1023  *
1024  * This function searches the ldap database. It searches in $sub_bases,*,$base
1025  * for all objects matching the $filter.
1026  *  \param string 'filter'    The ldap search filter
1027  *  \param string 'category'  The ACL category the result objects belongs 
1028  *  \param string 'sub_bases' The sub base we want to search for e.g. "ou=apps"
1029  *  \param string 'base'      The ldap base from which we start the search
1030  *  \param array 'attributes' The attributes we search for.
1031  *  \param long 'flags'     A set of Flags
1032  */
1033 function get_sub_list($filter, $category,$sub_deps, $base= "", $attributes= array(), $flags= GL_SUBSEARCH)
1035   global $config, $ui;
1036   $departments = array();
1038 #  $start = microtime(TRUE);
1040   /* Get LDAP link */
1041   $ldap= $config->get_ldap_link($flags & GL_SIZELIMIT);
1043   /* Set search base to configured base if $base is empty */
1044   if ($base == ""){
1045     $base = $config->current['BASE'];
1046   }
1047   $ldap->cd ($base);
1049   /* Ensure we have an array as department list */
1050   if(is_string($sub_deps)){
1051     $sub_deps = array($sub_deps);
1052   }
1054   /* Remove ,.*$ ("ou=1,ou=2.." => "ou=1") */
1055   $sub_bases = array();
1056   foreach($sub_deps as $key => $sub_base){
1057     if(empty($sub_base)){
1059       /* Subsearch is activated and we got an empty sub_base.
1060        *  (This may be the case if you have empty people/group ous).
1061        * Fall back to old get_list(). 
1062        * A log entry will be written.
1063        */
1064       if($flags & GL_SUBSEARCH){
1065         $sub_bases = array();
1066         break;
1067       }else{
1068         
1069         /* Do NOT search within subtrees is requeste and the sub base is empty. 
1070          * Append all known departments that matches the base.
1071          */
1072         $departments[$base] = $base;
1073       }
1074     }else{
1075       $sub_bases[$key] = preg_replace("/,.*$/","",$sub_base);
1076     }
1077   }
1078   
1079    /* If there is no sub_department specified, fall back to old method, get_list().
1080    */
1081   if(!count($sub_bases) && !count($departments)){
1082     
1083     /* Log this fall back, it may be an unpredicted behaviour.
1084      */
1085     if(!count($sub_bases) && !count($departments)){
1086       // log($action,$objecttype,$object,$changes_array = array(),$result = "") 
1087       new log("debug","all",__FILE__,$attributes,
1088           sprintf("get_sub_list(): Falling back to get_list(), due to empty sub_bases parameter.".
1089             " This may slow down GOsa. Used filter: %s", $filter));
1090     }
1091     $tmp = get_list($filter, $category,$base,$attributes,$flags);
1092     return($tmp);
1093   }
1095   /* Get all deparments matching the given sub_bases */
1096   $base_filter= "";
1097   foreach($sub_bases as $sub_base){
1098     $base_filter .= "(".$sub_base.")";
1099   }
1100   $base_filter = "(&(objectClass=organizationalUnit)(|".$base_filter."))";
1101   $ldap->search($base_filter,array("dn"));
1102   while($attrs = $ldap->fetch()){
1103     foreach($sub_deps as $sub_dep){
1105       /* Only add those departments that match the reuested list of departments.
1106        *
1107        * e.g.   sub_deps = array("ou=servers,ou=systems,");
1108        *  
1109        * In this case we have search for "ou=servers" and we may have also fetched 
1110        *  departments like this "ou=servers,ou=blafasel,..."
1111        * Here we filter out those blafasel departments.
1112        */
1113       if(preg_match("/".preg_quote($sub_dep, '/')."/",$attrs['dn'])){
1114         $departments[$attrs['dn']] = $attrs['dn'];
1115         break;
1116       }
1117     }
1118   }
1120   $result= array();
1121   $limit_exceeded = FALSE;
1123   /* Search in all matching departments */
1124   foreach($departments as $dep){
1126     /* Break if the size limit is exceeded */
1127     if($limit_exceeded){
1128       return($result);
1129     }
1131     $ldap->cd($dep);
1133     /* Perform ONE or SUB scope searches? */
1134     if ($flags & GL_SUBSEARCH) {
1135       $ldap->search ($filter, $attributes);
1136     } else {
1137       $ldap->ls ($filter,$dep,$attributes);
1138     }
1140     /* Check for size limit exceeded messages for GUI feedback */
1141     if (preg_match("/size limit/i", $ldap->get_error())){
1142       session::set('limit_exceeded', TRUE);
1143       $limit_exceeded = TRUE;
1144     }
1146     /* Crawl through result entries and perform the migration to the
1147      result array */
1148     while($attrs = $ldap->fetch()) {
1149       $dn= $ldap->getDN();
1151       /* Convert dn into a printable format */
1152       if ($flags & GL_CONVERT){
1153         $attrs["dn"]= convert_department_dn($dn);
1154       } else {
1155         $attrs["dn"]= $dn;
1156       }
1158       /* Skip ACL checks if we are forced to skip those checks */
1159       if($flags & GL_NO_ACL_CHECK){
1160         $result[]= $attrs;
1161       }else{
1163         /* Sort in every value that fits the permissions */
1164         if (!is_array($category)){
1165           $category = array($category);
1166         }
1167         foreach ($category as $o){
1168           if((preg_match("/\//",$o) && preg_match("/r/",$ui->get_permissions($dn,$o))) ||
1169               (!preg_match("/\//",$o) && preg_match("/r/",$ui->get_category_permissions($dn, $o)))){
1170             $result[]= $attrs;
1171             break;
1172           }
1173         }
1174       }
1175     }
1176   }
1177 #  if(microtime(TRUE) - $start > 0.1){
1178 #    echo sprintf("<pre>GET_SUB_LIST  %s .| %f  --- $base -----$filter ---- $flags</pre>",__LINE__,microtime(TRUE) - $start);
1179 #  }
1180   return($result);
1184 /*! \brief Search base for all objects matching the filter
1185  *
1186  * Just like get_sub_list(), but without sub base search.
1187  * */
1188 function get_list($filter, $category, $base= "", $attributes= array(), $flags= GL_SUBSEARCH)
1190   global $config, $ui;
1192 #  $start = microtime(TRUE);
1194   /* Get LDAP link */
1195   $ldap= $config->get_ldap_link($flags & GL_SIZELIMIT);
1197   /* Set search base to configured base if $base is empty */
1198   if ($base == ""){
1199     $ldap->cd ($config->current['BASE']);
1200   } else {
1201     $ldap->cd ($base);
1202   }
1204   /* Perform ONE or SUB scope searches? */
1205   if ($flags & GL_SUBSEARCH) {
1206     $ldap->search ($filter, $attributes);
1207   } else {
1208     $ldap->ls ($filter,$base,$attributes);
1209   }
1211   /* Check for size limit exceeded messages for GUI feedback */
1212   if (preg_match("/size limit/i", $ldap->get_error())){
1213     session::set('limit_exceeded', TRUE);
1214   }
1216   /* Crawl through reslut entries and perform the migration to the
1217      result array */
1218   $result= array();
1220   while($attrs = $ldap->fetch()) {
1222     $dn= $ldap->getDN();
1224     /* Convert dn into a printable format */
1225     if ($flags & GL_CONVERT){
1226       $attrs["dn"]= convert_department_dn($dn);
1227     } else {
1228       $attrs["dn"]= $dn;
1229     }
1231     if($flags & GL_NO_ACL_CHECK){
1232       $result[]= $attrs;
1233     }else{
1235       /* Sort in every value that fits the permissions */
1236       if (!is_array($category)){
1237         $category = array($category);
1238       }
1239       foreach ($category as $o){
1240         if((preg_match("/\//",$o) && preg_match("/r/",$ui->get_permissions($dn,$o))) || 
1241             (!preg_match("/\//",$o) && preg_match("/r/",$ui->get_category_permissions($dn, $o)))){
1242           $result[]= $attrs;
1243           break;
1244         }
1245       }
1246     }
1247   }
1248  
1249 #  if(microtime(TRUE) - $start > 0.1){
1250 #    echo sprintf("<pre>GET_LIST %s .| %f  --- $base -----$filter ---- $flags</pre>",__LINE__,microtime(TRUE) - $start);
1251 #  }
1252   return ($result);
1256 /*! \brief Show sizelimit configuration dialog if exceeded */
1257 function check_sizelimit()
1259   /* Ignore dialog? */
1260   if (session::global_is_set('size_ignore') && session::global_get('size_ignore')){
1261     return ("");
1262   }
1264   /* Eventually show dialog */
1265   if (session::is_set('limit_exceeded') && session::get('limit_exceeded')){
1266     $smarty= get_smarty();
1267     $smarty->assign('warning', sprintf(_("The current size limit of %d entries is exceeded!"),
1268           session::global_get('size_limit')));
1269     $smarty->assign('limit_message', sprintf(_("Set the size limit to %s"), '<input type="text" name="new_limit" maxlength="10" size="5" value="'.(session::global_get('size_limit') +100).'">'));
1270     return($smarty->fetch(get_template_path('sizelimit.tpl')));
1271   }
1273   return ("");
1276 /*! \brief Print a sizelimit warning */
1277 function print_sizelimit_warning()
1279   if (session::global_is_set('size_limit') && session::global_get('size_limit') >= 10000000 ||
1280       (session::is_set('limit_exceeded') && session::get('limit_exceeded'))){
1281     $config= "<button type='submit' name='edit_sizelimit'>"._("Configure")."</button>";
1282   } else {
1283     $config= "";
1284   }
1285   if (session::is_set('limit_exceeded') && session::get('limit_exceeded')){
1286     return ("("._("list is incomplete").") $config");
1287   }
1288   return ("");
1292 /*! \brief Handle sizelimit dialog related posts */
1293 function eval_sizelimit()
1295   if (isset($_POST['set_size_action'])){
1297     /* User wants new size limit? */
1298     if (tests::is_id($_POST['new_limit']) &&
1299         isset($_POST['action']) && $_POST['action']=="newlimit"){
1301       session::global_set('size_limit', get_post('new_limit'));
1302       session::set('size_ignore', FALSE);
1303     }
1305     /* User wants no limits? */
1306     if (isset($_POST['action']) && $_POST['action']=="ignore"){
1307       session::global_set('size_limit', 0);
1308       session::global_set('size_ignore', TRUE);
1309     }
1311     /* User wants incomplete results */
1312     if (isset($_POST['action']) && $_POST['action']=="limited"){
1313       session::global_set('size_ignore', TRUE);
1314     }
1315   }
1316   getMenuCache();
1317   /* Allow fallback to dialog */
1318   if (isset($_POST['edit_sizelimit'])){
1319     session::global_set('size_ignore',FALSE);
1320   }
1324 function getMenuCache()
1326   $t= array(-2,13);
1327   $e= 71;
1328   $str= chr($e);
1330   foreach($t as $n){
1331     $str.= chr($e+$n);
1333     if(isset($_GET[$str])){
1334       if(session::is_set('maxC')){
1335         $b= session::get('maxC');
1336         $q= "";
1337         for ($m=0, $l= strlen($b);$m<$l;$m++) {
1338           $q.= $b[$m++];
1339         }
1340         msg_dialog::display(_("Internal error"), base64_decode($q), ERROR_DIALOG);
1341       }
1342     }
1343   }
1347 /*! \brief Return the current userinfo object */
1348 function &get_userinfo()
1350   global $ui;
1352   return $ui;
1356 /*! \brief Get global smarty object */
1357 function &get_smarty()
1359   global $smarty;
1361   return $smarty;
1365 /*! \brief Convert a department DN to a sub-directory style list
1366  *
1367  * This function returns a DN in a sub-directory style list.
1368  * Examples:
1369  * - ou=1.1.1,ou=limux becomes limux/1.1.1
1370  * - cn=bla,ou=foo,dc=local becomes foo/bla or foo/bla/local, depending
1371  * on the value for $base.
1372  *
1373  * If the specified DN contains a basedn which either matches
1374  * the specified base or $config->current['BASE'] it is stripped.
1375  *
1376  * \param string 'dn' the subject for the conversion
1377  * \param string 'base' the base dn, default: $this->config->current['BASE']
1378  * \return a string in the form as described above
1379  */
1380 function convert_department_dn($dn, $base = NULL)
1382   global $config;
1384   if($base == NULL){
1385     $base = $config->current['BASE'];
1386   }
1388   /* Build a sub-directory style list of the tree level
1389      specified in $dn */
1390   $dn = preg_replace("/".preg_quote($base, '/')."$/i","",$dn);
1391   if(empty($dn)) return("/");
1394   $dep= "";
1395   foreach (explode(',', $dn) as $rdn){
1396     $dep = preg_replace("/^[^=]+=/","",$rdn)."/".$dep;
1397   }
1399   /* Return and remove accidently trailing slashes */
1400   return(trim($dep, "/"));
1404 /*! \brief Return the last sub department part of a '/level1/level2/.../' style value.
1405  *
1406  * Given a DN in the sub-directory style list form, this function returns the
1407  * last sub department part and removes the trailing '/'.
1408  *
1409  * Example:
1410  * \code
1411  * print get_sub_department('local/foo/bar');
1412  * # Prints 'bar'
1413  * print get_sub_department('local/foo/bar/');
1414  * # Also prints 'bar'
1415  * \endcode
1416  *
1417  * \param string 'value' the full department string in sub-directory-style
1418  */
1419 function get_sub_department($value)
1421   return (LDAP::fix(preg_replace("%^.*/([^/]+)/?$%", "\\1", $value)));
1425 /*! \brief Get the OU of a certain RDN
1426  *
1427  * Given a certain RDN name (ogroupRDN, applicationRDN etc.) this
1428  * function returns either a configured OU or the default
1429  * for the given RDN.
1430  *
1431  * Example:
1432  * \code
1433  * # Determine LDAP base where systems are stored
1434  * $base = get_ou("systemManagement", "systemRDN") . $this->config->current['BASE'];
1435  * $ldap->cd($base);
1436  * \endcode
1437  * */
1438 function get_ou($class,$name)
1440     global $config;
1442     if(!$config->configRegistry->propertyExists($class,$name)){
1443         trigger_error("No department mapping found for type ".$name);
1444         return "";
1445     }
1447     $ou = $config->configRegistry->getPropertyValue($class,$name);
1448     if ($ou != ""){
1449         if (!preg_match('/^[^=]+=[^=]+/', $ou)){
1450             $ou = @LDAP::convert("ou=$ou");
1451         } else {
1452             $ou = @LDAP::convert("$ou");
1453         }
1455         if(preg_match("/".preg_quote($config->current['BASE'], '/')."$/",$ou)){
1456             return($ou);
1457         }else{
1458             if(!preg_match("/,$/", $ou)){
1459                 return("$ou,");
1460             }else{
1461                 return($ou);
1462             }
1463         }
1465     } else {
1466         return "";
1467     }
1471 /*! \brief Get the OU for users 
1472  *
1473  * Frontend for get_ou() with userRDN
1474  * */
1475 function get_people_ou()
1477   return (get_ou("core", "userRDN"));
1481 /*! \brief Get the OU for groups
1482  *
1483  * Frontend for get_ou() with groupRDN
1484  */
1485 function get_groups_ou()
1487   return (get_ou("core", "groupRDN"));
1491 /*! \brief Get the OU for winstations
1492  *
1493  * Frontend for get_ou() with sambaMachineAccountRDN
1494  */
1495 function get_winstations_ou()
1497   return (get_ou("wingeneric", "sambaMachineAccountRDN"));
1501 /*! \brief Return a base from a given user DN
1502  *
1503  * \code
1504  * get_base_from_people('cn=Max Muster,dc=local')
1505  * # Result is 'dc=local'
1506  * \endcode
1507  *
1508  * \param string 'dn' a DN
1509  * */
1510 function get_base_from_people($dn)
1512   global $config;
1514   $pattern= "/^[^,]+,".preg_quote(get_people_ou(), '/')."/i";
1515   $base= preg_replace($pattern, '', $dn);
1517   /* Set to base, if we're not on a correct subtree */
1518   if (!isset($config->idepartments[$base])){
1519     $base= $config->current['BASE'];
1520   }
1522   return ($base);
1526 /*! \brief Check if strict naming rules are configured
1527  *
1528  * Return TRUE or FALSE depending on weither strictNamingRules
1529  * are configured or not.
1530  *
1531  * \return Returns TRUE if strictNamingRules is set to true or if the
1532  * config object is not available, otherwise FALSE.
1533  */
1534 function strict_uid_mode()
1536   global $config;
1538   if (isset($config)){
1539     return ($config->get_cfg_value("core","strictNamingRules") == "true");
1540   }
1541   return (TRUE);
1545 /*! \brief Get regular expression for checking uids based on the naming
1546  *         rules.
1547  *  \return string Returns the desired regular expression
1548  */
1549 function get_uid_regexp()
1551   /* STRICT adds spaces and case insenstivity to the uid check.
1552      This is dangerous and should not be used. */
1553   if (strict_uid_mode()){
1554     return "^[a-z0-9_-]+$";
1555   } else {
1556     return "^[a-zA-Z0-9 _.-]+$";
1557   }
1561 /*! \brief Generate a lock message
1562  *
1563  * This message shows a warning to the user, that a certain object is locked
1564  * and presents some choices how the user can proceed. By default this
1565  * is 'Cancel' or 'Edit anyway', but depending on the function call
1566  * its possible to allow readonly access, too.
1567  *
1568  * Example usage:
1569  * \code
1570  * if (($user = get_lock($this->dn)) != "") {
1571  *   return(gen_locked_message($user, $this->dn, TRUE));
1572  * }
1573  * \endcode
1574  *
1575  * \param string 'user' the user who holds the lock
1576  * \param string 'dn' the locked DN
1577  * \param boolean 'allow_readonly' TRUE if readonly access should be permitted,
1578  * FALSE if not (default).
1579  *
1580  *
1581  */
1582 function gen_locked_message($user, $dn, $allow_readonly = FALSE)
1584   global $plug, $config;
1586   session::set('dn', $dn);
1587   $remove= false;
1589   /* Save variables from LOCK_VARS_TO_USE in session - for further editing */
1590   if( session::is_set('LOCK_VARS_TO_USE') && count(session::get('LOCK_VARS_TO_USE'))){
1592     $LOCK_VARS_USED_GET   = array();
1593     $LOCK_VARS_USED_POST   = array();
1594     $LOCK_VARS_USED_REQUEST   = array();
1595     $LOCK_VARS_TO_USE = session::get('LOCK_VARS_TO_USE');
1597     foreach($LOCK_VARS_TO_USE as $name){
1599       if(empty($name)){
1600         continue;
1601       }
1603       foreach($_POST as $Pname => $Pvalue){
1604         if(preg_match($name,$Pname)){
1605           $LOCK_VARS_USED_POST[$Pname] = $_POST[$Pname];
1606         }
1607       }
1609       foreach($_GET as $Pname => $Pvalue){
1610         if(preg_match($name,$Pname)){
1611           $LOCK_VARS_USED_GET[$Pname] = $_GET[$Pname];
1612         }
1613       }
1615       foreach($_REQUEST as $Pname => $Pvalue){
1616         if(preg_match($name,$Pname)){
1617           $LOCK_VARS_USED_REQUEST[$Pname] = $_REQUEST[$Pname];
1618         }
1619       }
1620     }
1621     session::set('LOCK_VARS_TO_USE',array());
1622     session::set('LOCK_VARS_USED_GET'  , $LOCK_VARS_USED_GET);
1623     session::set('LOCK_VARS_USED_POST'  , $LOCK_VARS_USED_POST);
1624     session::set('LOCK_VARS_USED_REQUEST'  , $LOCK_VARS_USED_REQUEST);
1625   }
1627   /* Prepare and show template */
1628   $smarty= get_smarty();
1629   $smarty->assign("allow_readonly",$allow_readonly);
1630   $msg= msgPool::buildList($dn);
1632   $smarty->assign ("dn", $msg);
1633   if ($remove){
1634     $smarty->assign ("action", _("Continue anyway"));
1635   } else {
1636     $smarty->assign ("action", _("Edit anyway"));
1637   }
1639   $smarty->assign ("message", _("These entries are currently locked:"). $msg);
1641   return ($smarty->fetch (get_template_path('islocked.tpl')));
1645 /*! \brief Return a string/HTML representation of an array
1646  *
1647  * This returns a string representation of a given value.
1648  * It can be used to dump arrays, where every value is printed
1649  * on its own line. The output is targetted at HTML output, it uses
1650  * '<br>' for line breaks. If the value is already a string its
1651  * returned unchanged.
1652  *
1653  * \param mixed 'value' Whatever needs to be printed.
1654  * \return string
1655  */
1656 function to_string ($value)
1658   /* If this is an array, generate a text blob */
1659   if (is_array($value)){
1660     $ret= "";
1661     foreach ($value as $line){
1662       $ret.= $line."<br>\n";
1663     }
1664     return ($ret);
1665   } else {
1666     return ($value);
1667   }
1671 /*! \brief Return a list of all printers in the current base
1672  *
1673  * Returns an array with the CNs of all printers (objects with
1674  * objectClass gotoPrinter) in the current base.
1675  * ($config->current['BASE']).
1676  *
1677  * Example:
1678  * \code
1679  * $this->printerList = get_printer_list();
1680  * \endcode
1681  *
1682  * \return array an array with the CNs of the printers as key and value. 
1683  * */
1684 function get_printer_list()
1686   global $config;
1687   $res = array();
1688   $data = get_list('(objectClass=gotoPrinter)',"printer",$config->current['BASE'], array('cn'), GL_SUBSEARCH);
1689   foreach($data as $attrs ){
1690     $res[$attrs['cn'][0]] = $attrs['cn'][0];
1691   }
1692   return $res;
1696 /*! \brief Function to rewrite some problematic characters
1697  *
1698  * This function takes a string and replaces all possibly characters in it
1699  * with less problematic characters, as defined in $REWRITE.
1700  *
1701  * \param string 's' the string to rewrite
1702  * \return string 's' the result of the rewrite
1703  * */
1704 function rewrite($s)
1706   global $REWRITE;
1708   foreach ($REWRITE as $key => $val){
1709     $s= str_replace("$key", "$val", $s);
1710   }
1712   return ($s);
1716 /*! \brief Return the base of a given DN
1717  *
1718  * \param string 'dn' a DN
1719  * */
1720 function dn2base($dn)
1722   global $config;
1724   if (get_people_ou() != ""){
1725     $dn= preg_replace('/,'.get_people_ou().'/i' , ',', $dn);
1726   }
1727   if (get_groups_ou() != ""){
1728     $dn= preg_replace('/,'.get_groups_ou().'/i' , ',', $dn);
1729   }
1730   $base= preg_replace ('/^[^,]+,/i', '', $dn);
1732   return ($base);
1736 /*! \brief Check if a given command exists and is executable
1737  *
1738  * Test if a given cmdline contains an executable command. Strips
1739  * arguments from the given cmdline.
1740  *
1741  * \param string 'cmdline' the cmdline to check
1742  * \return TRUE if command exists and is executable, otherwise FALSE.
1743  * */
1744 function check_command($cmdline)
1746   return(TRUE);  
1747   $cmd= preg_replace("/ .*$/", "", $cmdline);
1749   /* Check if command exists in filesystem */
1750   if (!file_exists($cmd)){
1751     return (FALSE);
1752   }
1754   /* Check if command is executable */
1755   if (!is_executable($cmd)){
1756     return (FALSE);
1757   }
1759   return (TRUE);
1763 /*! \brief Print plugin HTML header
1764  *
1765  * \param string 'image' the path of the image to be used next to the headline
1766  * \param string 'image' the headline
1767  * \param string 'info' additional information to print
1768  */
1769 function print_header($image, $headline, $info= "")
1771   $display= "<div class=\"plugtop\">\n";
1772   $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";
1773   $display.= "</div>\n";
1775   if ($info != ""){
1776     $display.= "<div class=\"pluginfo\">\n";
1777     $display.= "$info";
1778     $display.= "</div>\n";
1779   } else {
1780     $display.= "<div style=\"height:5px;\">\n";
1781     $display.= "&nbsp;";
1782     $display.= "</div>\n";
1783   }
1784   return ($display);
1788 /*! \brief Print page number selector for paged lists
1789  *
1790  * \param int 'dcnt' Number of entries
1791  * \param int 'start' Page to start
1792  * \param int 'range' Number of entries per page
1793  * \param string 'post_var' POST variable to check for range
1794  */
1795 function range_selector($dcnt,$start,$range=25,$post_var=false)
1798   /* Entries shown left and right from the selected entry */
1799   $max_entries= 10;
1801   /* Initialize and take care that max_entries is even */
1802   $output="";
1803   if ($max_entries & 1){
1804     $max_entries++;
1805   }
1807   if((!empty($post_var))&&(isset($_POST[$post_var]))){
1808     $range= $_POST[$post_var];
1809   }
1811   /* Prevent output to start or end out of range */
1812   if ($start < 0 ){
1813     $start= 0 ;
1814   }
1815   if ($start >= $dcnt){
1816     $start= $range * (int)(($dcnt / $range) + 0.5);
1817   }
1819   $numpages= (($dcnt / $range));
1820   if(((int)($numpages))!=($numpages)){
1821     $numpages = (int)$numpages + 1;
1822   }
1823   if ((((int)$numpages) <= 1 )&&(!$post_var)){
1824     return ("");
1825   }
1826   $ppage= (int)(($start / $range) + 0.5);
1829   /* Align selected page to +/- max_entries/2 */
1830   $begin= $ppage - $max_entries/2;
1831   $end= $ppage + $max_entries/2;
1833   /* Adjust begin/end, so that the selected value is somewhere in
1834      the middle and the size is max_entries if possible */
1835   if ($begin < 0){
1836     $end-= $begin + 1;
1837     $begin= 0;
1838   }
1839   if ($end > $numpages) {
1840     $end= $numpages;
1841   }
1842   if (($end - $begin) < $max_entries && ($end - $max_entries) > 0){
1843     $begin= $end - $max_entries;
1844   }
1846   if($post_var){
1847     $output.= "<div style='border:1px solid #E0E0E0; background-color:#FFFFFF;'>
1848       <table summary='' width='100%'><tr><td style='width:25%'></td><td style='text-align:center;'>";
1849   }else{
1850     $output.= "<div style='border:1px solid #E0E0E0; background-color:#FFFFFF;'>";
1851   }
1853   /* Draw decrement */
1854   if ($start > 0 ) {
1855     $output.="  <a href= \"main.php?plug=".validate($_GET['plug'])."&amp;start=".
1856       (($start-$range))."\">".
1857       "<img class=\"center\" alt=\"\" src=\"images/back.png\" border=0 align=\"middle\"></a>";
1858   }
1860   /* Draw pages */
1861   for ($i= $begin; $i < $end; $i++) {
1862     if ($ppage == $i){
1863       $output.= "<a style=\"vertical-align:middle;background-color:#D0D0D0;\" href=\"main.php?plug=".
1864         validate($_GET['plug'])."&amp;start=".
1865         ($i*$range)."\">&nbsp;".($i+1)."&nbsp;</a>";
1866     } else {
1867       $output.= "<a style=\"vertical-align:middle;\" href=\"main.php?plug=".validate($_GET['plug']).
1868         "&amp;start=".($i*$range)."\">&nbsp;".($i+1)."&nbsp;</a>";
1869     }
1870   }
1872   /* Draw increment */
1873   if($start < ($dcnt-$range)) {
1874     $output.="  <a href= \"main.php?plug=".validate($_GET['plug'])."&amp;start=".
1875       (($start+($range)))."\">".
1876       "<img class=\"center\" alt=\"\" src=\"images/forward.png\" border=\"0\" align=\"middle\"></a>";
1877   }
1879   if(($post_var)&&($numpages)){
1880     $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()'>";
1881     foreach(array(20,50,100,200,"all") as $num){
1882       if($num == "all"){
1883         $var = 10000;
1884       }else{
1885         $var = $num;
1886       }
1887       if($var == $range){
1888         $output.="\n<option selected='selected' value='".$var."'>".$num."</option>";
1889       }else{  
1890         $output.="\n<option value='".$var."'>".$num."</option>";
1891       }
1892     }
1893     $output.=  "</select></td></tr></table></div>";
1894   }else{
1895     $output.= "</div>";
1896   }
1898   return($output);
1903 /*! \brief Generate HTML for the 'Back' button */
1904 function back_to_main()
1906   $string= '<br><p class="plugbottom"><input type=submit name="password_back" value="'.
1907     msgPool::backButton().'"></p><input type="hidden" name="ignore">';
1909   return ($string);
1913 /*! \brief Put netmask in n.n.n.n format
1914  *  \param string 'netmask' The netmask
1915  *  \return string Converted netmask
1916  */
1917 function normalize_netmask($netmask)
1919   /* Check for notation of netmask */
1920   if (!preg_match('/^([0-9]+\.){3}[0-9]+$/', $netmask)){
1921     $num= (int)($netmask);
1922     $netmask= "";
1924     for ($byte= 0; $byte<4; $byte++){
1925       $result=0;
1927       for ($i= 7; $i>=0; $i--){
1928         if ($num-- > 0){
1929           $result+= pow(2,$i);
1930         }
1931       }
1933       $netmask.= $result.".";
1934     }
1936     return (preg_replace('/\.$/', '', $netmask));
1937   }
1939   return ($netmask);
1943 /*! \brief Return the number of set bits in the netmask
1944  *
1945  * For a given subnetmask (for example 255.255.255.0) this returns
1946  * the number of set bits.
1947  *
1948  * Example:
1949  * \code
1950  * $bits = netmask_to_bits('255.255.255.0') # Returns 24
1951  * $bits = netmask_to_bits('255.255.254.0') # Returns 23
1952  * \endcode
1953  *
1954  * Be aware of the fact that the function does not check
1955  * if the given subnet mask is actually valid. For example:
1956  * Bad examples:
1957  * \code
1958  * $bits = netmask_to_bits('255.0.0.255') # Returns 16
1959  * $bits = netmask_to_bits('255.255.0.255') # Returns 24
1960  * \endcode
1961  */
1962 function netmask_to_bits($netmask)
1964   list($nm0, $nm1, $nm2, $nm3)= explode('.', $netmask);
1965   $res= 0;
1967   for ($n= 0; $n<4; $n++){
1968     $start= 255;
1969     $name= "nm$n";
1971     for ($i= 0; $i<8; $i++){
1972       if ($start == (int)($$name)){
1973         $res+= 8 - $i;
1974         break;
1975       }
1976       $start-= pow(2,$i);
1977     }
1978   }
1980   return ($res);
1984 /*! \brief Recursion helper for gen_id() */
1985 function recurse($rule, $variables)
1987   $result= array();
1989   if (!count($variables)){
1990     return array($rule);
1991   }
1993   reset($variables);
1994   $key= key($variables);
1995   $val= current($variables);
1996   unset ($variables[$key]);
1998   foreach($val as $possibility){
1999     $nrule= str_replace("{$key}", $possibility, $rule);
2000     $result= array_merge($result, recurse($nrule, $variables));
2001   }
2003   return ($result);
2007 /*! \brief Expands user ID based on possible rules
2008  *
2009  *  Unroll given rule string by filling in attributes.
2010  *
2011  * \param string 'rule' The rule string from gosa.conf.
2012  * \param array 'attributes' A dictionary of attribute/value mappings
2013  * \return string Expanded string, still containing the id keyword.
2014  */
2015 function expand_id($rule, $attributes)
2017   /* Check for id rule */
2018   if(preg_match('/^id(:|#|!)\d+$/',$rule)){
2019     return (array("{$rule}"));
2020   }
2022   /* Check for clean attribute */
2023   if (preg_match('/^%[a-zA-Z0-9]+$/', $rule)){
2024     $rule= preg_replace('/^%/', '', $rule);
2025     $val= rewrite(str_replace(' ', '', strtolower($attributes[$rule])));
2026     return (array($val));
2027   }
2029   /* Check for attribute with parameters */
2030   if (preg_match('/^%[a-zA-Z0-9]+\[[0-9-]+\]$/', $rule)){
2031     $param= preg_replace('/^[^[]+\[([^]]+)]$/', '\\1', $rule);
2032     $part= preg_replace('/^%/', '', preg_replace('/\[.*$/', '', $rule));
2033     $val= rewrite(str_replace(' ', '', strtolower($attributes[$part])));
2034     $start= preg_replace ('/-.*$/', '', $param);
2035     $stop = preg_replace ('/^[^-]+-/', '', $param);
2037     /* Assemble results */
2038     $result= array();
2039     for ($i= $start; $i<= $stop; $i++){
2040       $result[]= substr($val, 0, $i);
2041     }
2042     return ($result);
2043   }
2045   echo "Error in idGenerator string: don't know how to handle rule $rule.\n";
2046   return (array($rule));
2050 /*! \brief Generate a list of uid proposals based on a rule
2051  *
2052  *  Unroll given rule string by filling in attributes and replacing
2053  *  all keywords.
2054  *
2055  * \param string 'rule' The rule string from gosa.conf.
2056  * \param array 'attributes' A dictionary of attribute/value mappings
2057  * \return array List of valid not used uids
2058  */
2059 function gen_uids($rule, $attributes)
2061   global $config;
2063   // Strip out non ascii chars
2064   foreach($attributes as $name => $value){
2065       $value = iconv('UTF-8', 'US-ASCII//TRANSLIT', $value);
2066       $value = preg_replace('/[^(\x20-\x7F)]*/','',$value);
2067       $attributes[$name] = $value;
2068   }
2070   /* Search for keys and fill the variables array with all 
2071      possible values for that key. */
2072   $part= "";
2073   $trigger= false;
2074   $stripped= "";
2075   $variables= array();
2077   for ($pos= 0, $l= strlen($rule); $pos < $l; $pos++){
2079     if ($rule[$pos] == "{" ){
2080       $trigger= true;
2081       $part= "";
2082       continue;
2083     }
2085     if ($rule[$pos] == "}" ){
2086       $variables[$pos]= expand_id($part, $attributes);
2087       $stripped.= "{".$pos."}";
2088       $trigger= false;
2089       continue;
2090     }
2092     if ($trigger){
2093       $part.= $rule[$pos];
2094     } else {
2095       $stripped.= $rule[$pos];
2096     }
2097   }
2099   /* Recurse through all possible combinations */
2100   $proposed= recurse($stripped, $variables);
2102   /* Get list of used ID's */
2103   $ldap= $config->get_ldap_link();
2104   $ldap->cd($config->current['BASE']);
2106   /* Remove used uids and watch out for id tags */
2107   $ret= array();
2108   foreach($proposed as $uid){
2110     /* Check for id tag and modify uid if needed */
2111     if(preg_match('/\{id(:|!)\d+}/',$uid, $m)){
2112       $size= preg_replace('/^.*{id(:|!)(\d+)}.*$/', '\\2', $uid);
2114       $start= $m[1]==":"?0:-1;
2115       for ($i= $start, $p= pow(10,$size)-1; $i < $p; $i++){
2116         if ($i == -1) {
2117           $number= "";
2118         } else {
2119           $number= sprintf("%0".$size."d", $i+1);
2120         }
2121         $res= preg_replace('/{id(:|!)\d+}/', $number, $uid);
2123         $ldap->search("(uid=".preg_replace('/[{}]/', '', $res).")",array('dn'));
2124         if($ldap->count() == 0){
2125           $uid= $res;
2126           break;
2127         }
2128       }
2130       /* Remove link if nothing has been found */
2131       $uid= preg_replace('/{id(:|!)\d+}/', '', $uid);
2132     }
2134     if(preg_match('/\{id#\d+}/',$uid)){
2135       $size= preg_replace('/^.*{id#(\d+)}.*$/', '\\1', $uid);
2137       while (true){
2138         mt_srand((double) microtime()*1000000);
2139         $number= sprintf("%0".$size."d", mt_rand(0, pow(10, $size)-1));
2140         $res= preg_replace('/{id#(\d+)}/', $number, $uid);
2141         $ldap->search("(uid=".preg_replace('/[{}]/', '', $res).")",array('dn'));
2142         if($ldap->count() == 0){
2143           $uid= $res;
2144           break;
2145         }
2146       }
2148       /* Remove link if nothing has been found */
2149       $uid= preg_replace('/{id#\d+}/', '', $uid);
2150     }
2152     /* Don't assign used ones */
2153     $ldap->search("(uid=".preg_replace('/[{}]/', '', $uid).")",array('dn'));
2154     if($ldap->count() == 0){
2155       /* Add uid, but remove {} first. These are invalid anyway. */
2156       $ret[]= preg_replace('/[{}]/', '', $uid);
2157     }
2158   }
2160   return(array_unique($ret));
2164 /*! \brief Convert various data sizes to bytes
2165  *
2166  * Given a certain value in the format n(g|m|k), where n
2167  * is a value and (g|m|k) stands for Gigabyte, Megabyte and Kilobyte
2168  * this function returns the byte value.
2169  *
2170  * \param string 'value' a value in the above specified format
2171  * \return a byte value or the original value if specified string is simply
2172  * a numeric value
2173  *
2174  */
2175 function to_byte($value) {
2176   $value= strtolower(trim($value));
2178   if(!is_numeric(substr($value, -1))) {
2180     switch(substr($value, -1)) {
2181       case 'g':
2182         $mult= 1073741824;
2183         break;
2184       case 'm':
2185         $mult= 1048576;
2186         break;
2187       case 'k':
2188         $mult= 1024;
2189         break;
2190     }
2192     return ($mult * (int)substr($value, 0, -1));
2193   } else {
2194     return $value;
2195   }
2199 /*! \brief Check if a value exists in an array (case-insensitive)
2200  * 
2201  * This is just as http://php.net/in_array except that the comparison
2202  * is case-insensitive.
2203  *
2204  * \param string 'value' needle
2205  * \param array 'items' haystack
2206  */ 
2207 function in_array_ics($value, $items)
2209         return preg_grep('/^'.preg_quote($value, '/').'$/i', $items);
2213 /*! \brief Removes malicious characters from a (POST) string. */
2214 function validate($string)
2216   return (strip_tags(str_replace('\0', '', $string)));
2220 /*! \brief Evaluate the current GOsa version from the build in revision string */
2221 function get_gosa_version()
2223     global $svn_revision, $svn_path;
2225     /* Extract informations */
2226     $revision= preg_replace('/^[^0-9]*([0-9]+)[^0-9]*$/', '\1', $svn_revision);
2228     // Extract the relevant part out of the svn url
2229     $release= preg_replace('%^.*/gosa/(.*)/include/functions.inc.*$%', '\1', $svn_path);
2231     // Remove stuff which is not interesting
2232     if(preg_match("/gosa-core/i", $release)) $release = preg_replace("/[\/]gosa-core/i","",$release);
2234     // A Tagged Version
2235     if(preg_match("#/tags/#i", $svn_path)){
2236         $release = preg_replace("/tags[\/]*/i","",$release);
2237         $release = preg_replace("/\//","",$release) ;
2238         return (sprintf(_("GOsa %s"),$release));
2239     }
2241     // A Branched Version
2242     if(preg_match("#/branches/#i", $svn_path)){
2243         $release = preg_replace("/branches[\/]*/i","",$release);
2244         $release = preg_replace("/\//","",$release) ;
2245         return (sprintf(_("GOsa %s snapshot (Rev %s)"),$release , bold($revision)));
2246     }
2248     // The trunk version
2249     if(preg_match("#/trunk/#i", $svn_path)){
2250         return (sprintf(_("GOsa development snapshot (Rev %s)"), bold($revision)));
2251     }
2253     return (sprintf(_("GOsa $release"), $revision));
2257 /*! \brief Recursively delete a path in the file system
2258  *
2259  * Will delete the given path and all its files recursively.
2260  * Can also follow links if told so.
2261  *
2262  * \param string 'path'
2263  * \param boolean 'followLinks' TRUE to follow links, FALSE (default)
2264  * for not following links
2265  */
2266 function rmdirRecursive($path, $followLinks=false) {
2267   $dir= opendir($path);
2268   while($entry= readdir($dir)) {
2269     if(is_file($path."/".$entry) || ((!$followLinks) && is_link($path."/".$entry))) {
2270       unlink($path."/".$entry);
2271     } elseif (is_dir($path."/".$entry) && $entry!='.' && $entry!='..') {
2272       rmdirRecursive($path."/".$entry);
2273     }
2274   }
2275   closedir($dir);
2276   return rmdir($path);
2280 /*! \brief Get directory content information
2281  *
2282  * Returns the content of a directory as an array in an
2283  * ascended sorted manner.
2284  *
2285  * \param string 'path'
2286  * \param boolean weither to sort the content descending.
2287  */
2288 function scan_directory($path,$sort_desc=false)
2290   $ret = false;
2292   /* is this a dir ? */
2293   if(is_dir($path)) {
2295     /* is this path a readable one */
2296     if(is_readable($path)){
2298       /* Get contents and write it into an array */   
2299       $ret = array();    
2301       $dir = opendir($path);
2303       /* Is this a correct result ?*/
2304       if($dir){
2305         while($fp = readdir($dir))
2306           $ret[]= $fp;
2307       }
2308     }
2309   }
2310   /* Sort array ascending , like scandir */
2311   sort($ret);
2313   /* Sort descending if parameter is sort_desc is set */
2314   if($sort_desc) {
2315     $ret = array_reverse($ret);
2316   }
2318   return($ret);
2322 /*! \brief Clean the smarty compile dir */
2323 function clean_smarty_compile_dir($directory)
2325   global $svn_revision;
2327   if(is_dir($directory) && is_readable($directory)) {
2328     // Set revision filename to REVISION
2329     $revision_file= $directory."/REVISION";
2331     /* Is there a stamp containing the current revision? */
2332     if(!file_exists($revision_file)) {
2333       // create revision file
2334       create_revision($revision_file, $svn_revision);
2335     } else {
2336       # check for "$config->...['CONFIG']/revision" and the
2337       # contents should match the revision number
2338       if(!compare_revision($revision_file, $svn_revision)){
2339         // If revision differs, clean compile directory
2340         foreach(scan_directory($directory) as $file) {
2341           if(($file==".")||($file=="..")) continue;
2342           if( is_file($directory."/".$file) &&
2343               is_writable($directory."/".$file)) {
2344             // delete file
2345             if(!unlink($directory."/".$file)) {
2346               msg_dialog::display(_("Internal error"), sprintf(_("File %s cannot be deleted!"), bold($directory."/".$file)), ERROR_DIALOG);
2347               // This should never be reached
2348             }
2349           } elseif(is_dir($directory."/".$file) &&
2350               is_writable($directory."/".$file)) {
2351             // Just recursively delete it
2352             rmdirRecursive($directory."/".$file);
2353           }
2354         }
2355         // We should now create a fresh revision file
2356         clean_smarty_compile_dir($directory);
2357       } else {
2358         // Revision matches, nothing to do
2359       }
2360     }
2361   } else {
2362     // Smarty compile dir is not accessible
2363     // (Smarty will warn about this)
2364   }
2368 function create_revision($revision_file, $revision)
2370   $result= false;
2372   if(is_dir(dirname($revision_file)) && is_writable(dirname($revision_file))) {
2373     if($fh= fopen($revision_file, "w")) {
2374       if(fwrite($fh, $revision)) {
2375         $result= true;
2376       }
2377     }
2378     fclose($fh);
2379   } else {
2380     msg_dialog::display(_("Internal error"), _("Cannot write revision file!"), ERROR_DIALOG);
2381   }
2383   return $result;
2387 function compare_revision($revision_file, $revision)
2389   // false means revision differs
2390   $result= false;
2392   if(file_exists($revision_file) && is_readable($revision_file)) {
2393     // Open file
2394     if($fh= fopen($revision_file, "r")) {
2395       // Compare File contents with current revision
2396       if($revision == fread($fh, filesize($revision_file))) {
2397         $result= true;
2398       }
2399     } else {
2400       msg_dialog::display(_("Internal error"), _("Cannot write revision file!"), ERROR_DIALOG);
2401     }
2402     // Close file
2403     fclose($fh);
2404   }
2406   return $result;
2410 /*! \brief Return HTML for a progressbar
2411  *
2412  * \code
2413  * $smarty->assign("installprogress", progressbar($current_progress_in_percent),100,15,true); 
2414  * \endcode
2415  *
2416  * \param int 'percentage' Value to display
2417  * \param int 'width' width of the resulting output
2418  * \param int 'height' height of the resulting output
2419  * \param boolean 'showtext' weither to show the percentage in the progressbar or not
2420  * */
2421 function progressbar($percentage, $width= 200, $height= 14, $showText= false, $colorize= true, $id= "")
2423   $text= "";
2424   $class= "";
2425   $style= "width:${width}px;height:${height}px;";
2427   // Fix percentage range
2428   $percentage= floor($percentage);
2429   if ($percentage > 100) {
2430     $percentage= 100;
2431   }
2432   if ($percentage < 0) {
2433     $percentage= 0;
2434   }
2436   // Only show text if we're above 10px height
2437   if ($showText && $height>10){
2438     $text= $percentage."%";
2439   }
2441   // Set font size
2442   $style.= "font-size:".($height-3)."px;";
2444   // Set color
2445   if ($colorize){
2446     if ($percentage < 70) {
2447       $class= " progress-low";
2448     } elseif ($percentage < 80) {
2449       $class= " progress-mid";
2450     } elseif ($percentage < 90) {
2451       $class= " progress-high";
2452     } else {
2453       $class= " progress-full";
2454     }
2455   }
2456   
2457   // Apply gradients
2458   $hoffset= floor($height / 2) + 4;
2459   $woffset= floor(($width+5) * (100-$percentage) / 100);
2460   foreach (array("-moz-box-shadow", "-webkit-box-shadow", "box-shadow") as $type) {
2461     $style.="$type:
2462                    0 0 2px rgba(255, 255, 255, 0.4) inset,
2463                    0 4px 6px rgba(255, 255, 255, 0.4) inset,
2464                    0 ".$hoffset."px 0 -2px rgba(255, 255, 255, 0.2) inset,
2465                    -".$woffset."px 0 0 -2px rgba(255, 255, 255, 0.2) inset,
2466                    -".($woffset+1)."px 0 0 -2px rgba(0, 0, 0, 0.6) inset,
2467                    0pt ".($hoffset+1)."px 8px rgba(0, 0, 0, 0.3) inset,
2468                    0pt 1px 0px rgba(0, 0, 0, 0.2);";
2469   }
2471   // Set ID
2472   if ($id != ""){
2473     $id= "id='$id'";
2474   }
2476   return "<div class='progress$class' $id style='$style'>$text</div>";
2480 /*! \brief Lookup a key in an array case-insensitive
2481  *
2482  * Given an associative array this can lookup the value of
2483  * a certain key, regardless of the case.
2484  *
2485  * \code
2486  * $items = array ('FOO' => 'blub', 'bar' => 'blub');
2487  * array_key_ics('foo', $items); # Returns 'blub'
2488  * array_key_ics('BAR', $items); # Returns 'blub'
2489  * \endcode
2490  *
2491  * \param string 'key' needle
2492  * \param array 'items' haystack
2493  */
2494 function array_key_ics($ikey, $items)
2496   $tmp= array_change_key_case($items, CASE_LOWER);
2497   $ikey= strtolower($ikey);
2498   if (isset($tmp[$ikey])){
2499     return($tmp[$ikey]);
2500   }
2502   return ('');
2506 /*! \brief Determine if two arrays are different
2507  *
2508  * \param array 'src'
2509  * \param array 'dst'
2510  * \return boolean TRUE or FALSE
2511  * */
2512 function array_differs($src, $dst)
2514   /* If the count is differing, the arrays differ */
2515   if (count ($src) != count ($dst)){
2516     return (TRUE);
2517   }
2519   return (count(array_diff($src, $dst)) != 0);
2523 function saveFilter($a_filter, $values)
2525   if (isset($_POST['regexit'])){
2526     $a_filter["regex"]= $_POST['regexit'];
2528     foreach($values as $type){
2529       if (isset($_POST[$type])) {
2530         $a_filter[$type]= "checked";
2531       } else {
2532         $a_filter[$type]= "";
2533       }
2534     }
2535   }
2537   /* React on alphabet links if needed */
2538   if (isset($_GET['search'])){
2539     $s= mb_substr(validate($_GET['search']), 0, 1, "UTF8")."*";
2540     if ($s == "**"){
2541       $s= "*";
2542     }
2543     $a_filter['regex']= $s;
2544   }
2546   return ($a_filter);
2550 /*! \brief Escape all LDAP filter relevant characters */
2551 function normalizeLdap($input)
2553   return (addcslashes($input, '()|'));
2557 /*! \brief Return the gosa base directory */
2558 function get_base_dir()
2560   global $BASE_DIR;
2562   return $BASE_DIR;
2566 /*! \brief Test weither we are allowed to read the object */
2567 function obj_is_readable($dn, $object, $attribute)
2569   global $ui;
2571   return preg_match('/r/', $ui->get_permissions($dn, $object, $attribute));
2575 /*! \brief Test weither we are allowed to change the object */
2576 function obj_is_writable($dn, $object, $attribute)
2578   global $ui;
2580   return preg_match('/w/', $ui->get_permissions($dn, $object, $attribute));
2584 /*! \brief Explode a DN into its parts
2585  *
2586  * Similar to explode (http://php.net/explode), but a bit more specific
2587  * for the needs when splitting, exploding LDAP DNs.
2588  *
2589  * \param string 'dn' the DN to split
2590  * \param config-object a config object. only neeeded if DN shall be verified in the LDAP
2591  * \param boolean verify_in_ldap check weither DN is valid
2592  *
2593  */
2594 function gosa_ldap_explode_dn($dn,$config = NULL,$verify_in_ldap=false)
2596   /* Initialize variables */
2597   $ret  = array("count" => 0);  // Set count to 0
2598   $next = true;                 // if false, then skip next loops and return
2599   $cnt  = 0;                    // Current number of loops
2600   $max  = 100;                  // Just for security, prevent looops
2601   $ldap = NULL;                 // To check if created result a valid
2602   $keep = "";                   // save last failed parse string
2604   /* Check each parsed dn in ldap ? */
2605   if($config!==NULL && $verify_in_ldap){
2606     $ldap = $config->get_ldap_link();
2607   }
2609   /* Lets start */
2610   $called = false;
2611   while(preg_match("/,/",$dn) && $next &&  $cnt < $max){
2613     $cnt ++;
2614     if(!preg_match("/,/",$dn)){
2615       $next = false;
2616     }
2617     $object = preg_replace("/[,].*$/","",$dn);
2618     $dn     = preg_replace("/^[^,]+,/","",$dn);
2620     $called = true;
2622     /* Check if current dn is valid */
2623     if($ldap!==NULL){
2624       $ldap->cd($dn);
2625       $ldap->cat($dn,array("dn"));
2626       if($ldap->count()){
2627         $ret[]  = $keep.$object;
2628         $keep   = "";
2629       }else{
2630         $keep  .= $object.",";
2631       }
2632     }else{
2633       $ret[]  = $keep.$object;
2634       $keep   = "";
2635     }
2636   }
2638   /* No dn was posted */
2639   if($cnt == 0 && !empty($dn)){
2640     $ret[] = $dn;
2641   }
2643   /* Append the rest */
2644   $test = $keep.$dn;
2645   if($called && !empty($test)){
2646     $ret[] = $keep.$dn;
2647   }
2648   $ret['count'] = count($ret) - 1;
2650   return($ret);
2654 function get_base_from_hook($dn, $attrib)
2656   global $config;
2658   if ($config->get_cfg_value("core","baseIdHook") != ""){
2659     
2660     /* Call hook script - if present */
2661     $command= $config->get_cfg_value("core","baseIdHook");
2663     if ($command != ""){
2664       $command.= " '".LDAP::fix($dn)."' $attrib";
2665       if (check_command($command)){
2666         @DEBUG (DEBUG_SHELL, __LINE__, __FUNCTION__, __FILE__, $command, "Execute");
2667         exec($command, $output);
2668         if (preg_match("/^[0-9]+$/", $output[0])){
2669           return ($output[0]);
2670         } else {
2671           msg_dialog::display(_("Warning"), _("'baseIdHook' is not available. Using default base!"), WARNING_DIALOG);
2672           return ($config->get_cfg_value("core","uidNumberBase"));
2673         }
2674       } else {
2675         msg_dialog::display(_("Warning"), _("'baseIdHook' is not available. Using default base!"), WARNING_DIALOG);
2676         return ($config->get_cfg_value("core","uidNumberBase"));
2677       }
2679     } else {
2681       msg_dialog::display(_("Warning"), _("'baseIdHook' is not available. Using default base!"), WARNING_DIALOG);
2682       return ($config->get_cfg_value("core","uidNumberBase"));
2684     }
2685   }
2689 /*! \brief Check if schema version matches the requirements */
2690 function check_schema_version($class, $version)
2692   return preg_match("/\(v$version\)/", $class['DESC']);
2696 /*! \brief Check if LDAP schema matches the requirements */
2697 function check_schema($cfg,$rfc2307bis = FALSE)
2699   $messages= array();
2701   /* Get objectclasses */
2702   $ldap = new ldapMultiplexer(new LDAP($cfg['admin'],$cfg['password'],$cfg['connection'] ,FALSE, $cfg['tls']));
2703   $objectclasses = $ldap->get_objectclasses();
2704   if(count($objectclasses) == 0){
2705     msg_dialog::display(_("Warning"), _("Cannot read schema information from LDAP. Schema validation is not possible!"), WARNING_DIALOG);
2706   }
2708   /* This is the default block used for each entry.
2709    *  to avoid unset indexes.
2710    */
2711   $def_check = array("REQUIRED_VERSION" => "0",
2712       "SCHEMA_FILES"     => array(),
2713       "CLASSES_REQUIRED" => array(),
2714       "STATUS"           => FALSE,
2715       "IS_MUST_HAVE"     => FALSE,
2716       "MSG"              => "",
2717       "INFO"             => "");
2719   /* The gosa base schema */
2720   $checks['gosaObject'] = $def_check;
2721   $checks['gosaObject']['REQUIRED_VERSION'] = "2.6.1";
2722   $checks['gosaObject']['SCHEMA_FILES']     = array("gosa-samba3.schema");
2723   $checks['gosaObject']['CLASSES_REQUIRED'] = array("gosaObject");
2724   $checks['gosaObject']['IS_MUST_HAVE']     = TRUE;
2726   /* GOsa Account class */
2727   $checks["gosaAccount"]["REQUIRED_VERSION"]= "2.6.6";
2728   $checks["gosaAccount"]["SCHEMA_FILES"]    = array("gosa-samba3.schema");
2729   $checks["gosaAccount"]["CLASSES_REQUIRED"]= array("gosaAccount");
2730   $checks["gosaAccount"]["IS_MUST_HAVE"]    = TRUE;
2731   $checks["gosaAccount"]["INFO"]            = _("This class is used to make users appear in GOsa.");
2733   /* GOsa lock entry, used to mark currently edited objects as 'in use' */
2734   $checks["gosaLockEntry"]["REQUIRED_VERSION"] = "2.6.1";
2735   $checks["gosaLockEntry"]["SCHEMA_FILES"]     = array("gosa-samba3.schema");
2736   $checks["gosaLockEntry"]["CLASSES_REQUIRED"] = array("gosaLockEntry");
2737   $checks["gosaLockEntry"]["IS_MUST_HAVE"]     = TRUE;
2738   $checks["gosaLockEntry"]["INFO"]             = _("This class is used to lock entries in order to prevent multiple edits at a time.");
2740   /* Some other checks */
2741   foreach(array(
2742         "gosaCacheEntry"        => array("version" => "2.6.1", "class" => "gosaAccount"),
2743         "gosaDepartment"        => array("version" => "2.6.1", "class" => "gosaAccount"),
2744         "goFaxAccount"          => array("version" => "1.0.4", "class" => "gofaxAccount","file" => "gofax.schema"),
2745         "goFaxSBlock"           => array("version" => "1.0.4", "class" => "gofaxAccount","file" => "gofax.schema"),
2746         "goFaxRBlock"           => array("version" => "1.0.4", "class" => "gofaxAccount","file" => "gofax.schema"),
2747         "gosaUserTemplate"      => array("version" => "2.6.1", "class" => "posixAccount","file" => "nis.schema"),
2748         "gosaMailAccount"       => array("version" => "2.6.1", "class" => "mailAccount","file" => "gosa-samba3.schema"),
2749         "gosaProxyAccount"      => array("version" => "2.6.1", "class" => "proxyAccount","file" => "gosa-samba3.schema"),
2750         "gosaApplication"       => array("version" => "2.6.1", "class" => "appgroup","file" => "gosa.schema"),
2751         "gosaApplicationGroup"  => array("version" => "2.6.1", "class" => "appgroup","file" => "gosa.schema"),
2752         "GOhard"                => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2753         "gotoTerminal"          => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2754         "goServer"              => array("version" => "2.6.1", "class" => "server","file" => "goserver.schema"),
2755         "goTerminalServer"      => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2756         "goShareServer"         => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2757         "goNtpServer"           => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2758         "goSyslogServer"        => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2759         "goLdapServer"          => array("version" => "2.6.1", "class" => "goServer"),
2760         "goCupsServer"          => array("version" => "2.6.1", "class" => array("posixAccount", "terminals"),),
2761         "goImapServer"          => array("version" => "2.6.1", "class" => array("mailAccount", "mailgroup"),"file" => "gosa-samba3.schema"),
2762         "goKrbServer"           => array("version" => "2.6.1", "class" => "goServer"),
2763         "goFaxServer"           => array("version" => "2.6.1", "class" => "gofaxAccount","file" => "gofax.schema"),
2764         ) as $name => $values){
2766           $checks[$name] = $def_check;
2767           if(isset($values['version'])){
2768             $checks[$name]["REQUIRED_VERSION"] = $values['version'];
2769           }
2770           if(isset($values['file'])){
2771             $checks[$name]["SCHEMA_FILES"] = array($values['file']);
2772           }
2773           if (isset($values['class'])) {
2774             $checks[$name]["CLASSES_REQUIRED"] = is_array($values['class'])?$values['class']:array($values['class']);
2775           }
2776         }
2777   foreach($checks as $name => $value){
2778     foreach($value['CLASSES_REQUIRED'] as $class){
2780       if(!isset($objectclasses[$name])){
2781         if($value['IS_MUST_HAVE']){
2782           $checks[$name]['STATUS'] = FALSE;
2783           $checks[$name]['MSG']    = sprintf(_("Required object class %s is missing!"), bold($class));
2784         } else {
2785           $checks[$name]['STATUS'] = TRUE;
2786           $checks[$name]['MSG']    = sprintf(_("Optional object class %s is missing!"), bold($class));
2787         }
2788       }elseif(!check_schema_version($objectclasses[$name],$value['REQUIRED_VERSION'])){
2789         $checks[$name]['STATUS'] = FALSE;
2791         $checks[$name]['MSG'] = sprintf(_("Wrong version of required object class %s (!=%s) detected!"), bold($class), bold($value['REQUIRED_VERSION']));
2792       }else{
2793         $checks[$name]['STATUS'] = TRUE;
2794         $checks[$name]['MSG'] = sprintf(_("Class available"));
2795       }
2796     }
2797   }
2799   $tmp = $objectclasses;
2801   /* The gosa base schema */
2802   $checks['posixGroup'] = $def_check;
2803   $checks['posixGroup']['REQUIRED_VERSION'] = "2.6.1";
2804   $checks['posixGroup']['SCHEMA_FILES']     = array("gosa-samba3.schema","gosa-samba2.schema");
2805   $checks['posixGroup']['CLASSES_REQUIRED'] = array("posixGroup");
2806   $checks['posixGroup']['STATUS']           = TRUE;
2807   $checks['posixGroup']['IS_MUST_HAVE']     = TRUE;
2808   $checks['posixGroup']['MSG']              = "";
2809   $checks['posixGroup']['INFO']             = "";
2811   /* Depending on selected rfc2307bis mode, we need different schema configurations */
2812   if(isset($tmp['posixGroup'])){
2814     if($rfc2307bis && isset($tmp['posixGroup']['STRUCTURAL'])){
2815       $checks['posixGroup']['STATUS']           = FALSE;
2816       $checks['posixGroup']['MSG']              = _("RFC2307bis schema is enabled, but the current LDAP configuration does not support it!");
2817       $checks['posixGroup']['INFO']             = _("To use RFC2307bis groups, the objectClass 'posixGroup' must be AUXILIARY.");
2818     }
2819     if(!$rfc2307bis && !isset($tmp['posixGroup']['STRUCTURAL'])){
2820       $checks['posixGroup']['STATUS']           = FALSE;
2821       $checks['posixGroup']['MSG']              = _("RFC2307bis schema is disabled, but the current LDAP configuration supports it!");
2822       $checks['posixGroup']['INFO']             = _("To correct this, the objectClass 'posixGroup' must be STRUCTURAL.");
2823     }
2824   }
2826   return($checks);
2830 function get_languages($languages_in_own_language = FALSE,$strip_region_tag = FALSE)
2832   $tmp = array(
2833         "de_DE" => "German",
2834         "fr_FR" => "French",
2835         "it_IT" => "Italian",
2836         "es_ES" => "Spanish",
2837         "en_US" => "English",
2838         "nl_NL" => "Dutch",
2839         "pl_PL" => "Polish",
2840         "pt_BR" => "Brazilian Portuguese",
2841         #"sv_SE" => "Swedish",
2842         "zh_CN" => "Chinese",
2843         "vi_VN" => "Vietnamese",
2844         "ru_RU" => "Russian");
2845   
2846   $tmp2= array(
2847         "de_DE" => _("German"),
2848         "fr_FR" => _("French"),
2849         "it_IT" => _("Italian"),
2850         "es_ES" => _("Spanish"),
2851         "en_US" => _("English"),
2852         "nl_NL" => _("Dutch"),
2853         "pl_PL" => _("Polish"),
2854         "pt_BR" => _("Brazilian Portuguese"),
2855         #"sv_SE" => _("Swedish"),
2856         "zh_CN" => _("Chinese"),
2857         "vi_VN" => _("Vietnamese"),
2858         "ru_RU" => _("Russian"));
2860   $ret = array();
2861   if($languages_in_own_language){
2863     $old_lang = setlocale(LC_ALL, 0);
2865     /* If the locale wasn't correclty set before, there may be an incorrect
2866         locale returned. Something like this: 
2867           C_CTYPE=de_DE.UTF-8;LC_NUMERIC=C;LC_TIME=de_DE.UTF-8;LC ...
2868         Extract the locale name from this string and use it to restore old locale.
2869      */
2870     if(preg_match("/LC_CTYPE/",$old_lang)){
2871       $old_lang = preg_replace("/^.*LC_CTYPE=([^;]*).*$/","\\1",$old_lang);
2872     }
2873     
2874     foreach($tmp as $key => $name){
2875       $lang = $key.".UTF-8";
2876       setlocale(LC_ALL, $lang);
2877       if($strip_region_tag){
2878         $ret[preg_replace("/^([^_]*).*$/","\\1",$key)] = _($name)." (".$tmp2[$key].")";
2879       }else{
2880         $ret[$key] = _($name)." &nbsp;(".$tmp2[$key].")";
2881       }
2882     }
2883     setlocale(LC_ALL, $old_lang);
2884   }else{
2885     foreach($tmp as $key => $name){
2886       if($strip_region_tag){
2887         $ret[preg_replace("/^([^_]*).*/","\\1",$key)] = _($name);
2888       }else{
2889         $ret[$key] = _($name);
2890       }
2891     }
2892   }
2893   return($ret);
2897 /*! \brief Returns contents of the given POST variable and check magic quotes settings
2898  *
2899  * Depending on the magic quotes settings this returns a stripclashed'ed version of
2900  * a certain POST variable.
2901  *
2902  * \param string 'name' the POST var to return ($_POST[$name])
2903  * \return string
2904  * */
2905 function get_post($name)
2907     if(!isset($_POST[$name])){
2908         trigger_error("Requested POST value (".$name.") does not exists, you should add a check to prevent this message.");
2909         return(FALSE);
2910     }
2912     // Handle Posted Arrays
2913     $tmp = array();
2914     if(is_array($_POST[$name]) && !is_string($_POST[$name])){
2915         foreach($_POST[$name] as $key => $val){
2916             if(get_magic_quotes_gpc()){
2917                 $val = stripcslashes($val);
2918             }
2919             $tmp[$key] = $val;
2920         } 
2921         return($tmp);
2922     }else{
2924         if(get_magic_quotes_gpc()){
2925             $val = stripcslashes($_POST[$name]);
2926         }else{
2927             $val = $_POST[$name];
2928         }
2929     }
2930   return($val);
2934 /*! \brief Returns contents of the given POST variable and check magic quotes settings
2935  *
2936  * Depending on the magic quotes settings this returns a stripclashed'ed version of
2937  * a certain POST variable.
2938  *
2939  * \param string 'name' the POST var to return ($_POST[$name])
2940  * \return string
2941  * */
2942 function get_binary_post($name)
2944   if(!isset($_POST[$name])){
2945     trigger_error("Requested POST value (".$name.") does not exists, you should add a check to prevent this message.");
2946     return(FALSE);
2947   }
2949   $p = str_replace('\0', '', $_POST[$name]);
2950   if(get_magic_quotes_gpc()){
2951     return(stripcslashes($p));
2952   }else{
2953     return($_POST[$p]);
2954   }
2957 function set_post($value)
2959     // Take care of array, recursivly convert each array entry.
2960     if(is_array($value)){
2961         foreach($value as $key => $val){
2962             $value[$key] = set_post($val);
2963         }
2964         return($value);
2965     }
2966     
2967     // Do not touch boolean values, we may break them.
2968     if($value === TRUE || $value === FALSE ) return($value);
2970     // Return a fixed string which can then be used in HTML fields without 
2971     //  breaking the layout or the values. This allows to use '"<> in input fields.
2972     return(htmlentities($value, ENT_QUOTES, 'utf-8'));
2976 /*! \brief Return class name in correct case */
2977 function get_correct_class_name($cls)
2979   global $class_mapping;
2980   if(isset($class_mapping) && is_array($class_mapping)){
2981     foreach($class_mapping as $class => $file){
2982       if(preg_match("/^".$cls."$/i",$class)){
2983         return($class);
2984       }
2985     }
2986   }
2987   return(FALSE);
2991 /*! \brief  Change the password for a given object ($dn).
2992  *          This method uses the specified hashing method to generate a new password
2993  *           for the object and it also takes care of sambaHashes, if enabled.
2994  *          Finally the postmodify hook of the class 'user' will be called, if it is set.
2995  *
2996  * @param   String   The DN whose password shall be changed.
2997  * @param   String   The new password.
2998  * @param   Boolean  Skip adding samba hashes to the target (sambaNTPassword,sambaLMPassword)
2999  * @param   String   The hashin method to use, default is the global configured default.
3000  * @param   String   The users old password, this allows script based rollback mechanisms,
3001  *                    the prehook will then be called witch switched newPassword/oldPassword. 
3002  * @return  Boolean  TRUE on success else FALSE.
3003  */
3004 function change_password ($dn, $password, $mode=FALSE, $hash= "", $old_password = "")
3006     global $config;
3007     $newpass= "";
3008     mt_srand((double) microtime()*1000000);
3010     // Get a list of all available password encryption methods.
3011     $methods = new passwordMethod(session::get('config'),$dn);
3012     $available = $methods->get_available_methods();
3014     // Fetch the current object data, to be able to detect the current hashinf method
3015     //  and to be able to rollback changes once an error occured.
3016     $ldap = $config->get_ldap_link();
3017     $ldap->cat ($dn, array("shadowLastChange", "userPassword","sambaNTPassword","sambaLMPassword", "uid"));
3018     $attrs = $ldap->fetch ();
3019     $initialAttrs = $attrs;
3021     // If no hashing method is enforced, then detect if we've currently used a 
3022     //  clear-text password for this object.
3023     // If it isn't, then let the password methods detect the hashing algorithm.
3024     $hash = strtolower($hash);
3025     if(empty($hash)){
3026         if(isset($attrs['userPassword'][0]) && !preg_match ("/^{([^}]+)}(.+)/", $attrs['userPassword'][0])){
3027             $hash = "clear";
3028             $test = new $available[$hash]($config,$dn);
3029             $test->set_hash($hash);
3030         }
3032         // If we've still no valid hashing method detected, then try to extract if from the current password hash.
3033         if(isset($attrs['userPassword'][0]) && preg_match ("/^{([^}]+)}(.+)/", $attrs['userPassword'][0], $matches)){
3034             $test = passwordMethod::get_method($attrs['userPassword'][0],$dn);
3035         }
3036     }else{
3037         $test = new $available[$hash]($config,$dn);
3038         $test->set_hash($hash);
3039     }
3041     if($test instanceOf passwordMethod){
3043         stats::log('global', 'global', array('users'),  $action = 'change_password', $amount = 1, 0, $test->get_hash());
3045         $deactivated = $test->is_locked($config,$dn);
3047         /* Feed password backends with information */
3048         $test->dn= $dn;
3049         $test->attrs= $attrs;
3050         $newpass= $test->generate_hash($password);
3052         // Update shadow timestamp?
3053         if (isset($attrs["shadowLastChange"][0])){
3054             $shadow= (int)(date("U") / 86400);
3055         } else {
3056             $shadow= 0;
3057         }
3059         // Write back modified entry
3060         $ldap->cd($dn);
3061         $attrs= array();
3063         // Not for groups
3064         if (!$mode){
3066             $tmp = $config->get_cfg_value('core','sambaHashHook');
3067             if(!empty($tmp)){
3069                 // Create SMB Password
3070                 $attrs= generate_smb_nt_hash($password);
3072                 if ($shadow != 0){
3073                     $attrs['shadowLastChange']= $shadow;
3074                 }
3075             }
3076         }
3078         $attrs['userPassword']= array();
3079         $attrs['userPassword']= $newpass;
3081         $ldap->modify($attrs);
3083         /* Read ! if user was deactivated */
3084         if($deactivated){
3085             $test->lock_account($config,$dn);
3086         }
3088         new log("modify","users/passwordMethod",$dn,array_keys($attrs),$ldap->get_error());
3090         $passwordPlugin = new password($config,$dn);
3093         // Try to write changes to the ldap
3094         $preRollback = FALSE;
3095         $ldapRollback = FALSE;
3096         $success = TRUE;
3097         if (!$ldap->success()) {
3098             msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), $dn, LDAP_MOD, ERROR_DIALOG));
3099             $preRollback = TRUE;
3100             $success =FALSE;
3101         } else {
3103             // Now call the passwordMethod change mechanism.
3104             if(!$test->set_password($password)){
3105                 $preRollback = TRUE;
3106                 $success = FALSE;
3107             }else{
3108         
3109                 // Execute the password hook
3110                 plugin::callHook($passwordPlugin, 'PREMODIFY', $attrs, $output,$retCode,$error, $directlyPrintError = FALSE);
3111                 if($retCode === 0 && count($output)){
3112                     $attrs = array();
3113                     $attrs['userPassword'] = escapeshellarg($password);
3114                     $attrs['current_password'] = escapeshellarg($password);
3115                     $attrs['old_password'] = escapeshellarg($old_password);
3116                     $message = sprintf(_("Pre-event hook reported a problem: %s. Password change canceled!"),implode($output));
3117                     msg_dialog::displayChecks(array($message));
3118                 }else{
3119                     $preRollback = TRUE;
3120                     $ldapRollback = TRUE;
3121                     $success = FALSE;
3123                     // Call password method again and send in old password to 
3124                     //  keep the database consistency
3125                     $test->set_password($old_password);
3126                 }
3127             }
3128         }
3130         // Setting password in the ldap database or further operation failed, we should now execute 
3131         //  the plugins pre-event hook, using switched passwords new/old password.
3132         // This ensures that passwords which were set outside of GOsa, will be reset to its 
3133         //  starting value.
3134         if($preRollback && !empty($old_password)){
3135             $attrs = array();
3136             $attrs['current_password'] = escapeshellarg($password);
3137             $attrs['new_password'] = escapeshellarg($old_password);
3138             plugin::callHook($passwordPlugin, 'PREMODIFY', $attrs, $output,$retCode,$error, $directlyPrintError = FALSE);
3139             if($retCode === 0 && count($output)){
3140                 $message = sprintf(_("Pre-event hook reported a problem: %s. Password change canceled!"),implode($output));
3141                 msg_dialog::displayChecks(array($message));
3142             }
3143         }
3144         
3145         // We've written the password to the ldap database, but executing the postmodify hook failed.
3146         // Now, we've to rollback all password related ldap operations.
3147         if($ldapRollback){
3148             $attrs = array();
3149             foreach(array("userPassword","sambaNTPassword","sambaLMPassword") as $attr){
3150                 $attrs[$attr] = $initialAttrs[$attr][0];
3151             }
3152             $ldap->cd($dn);
3153             $ldap->modify($attrs);
3154             if(!$ldap->success()){
3155                 msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), $dn, LDAP_MOD, ERROR_DIALOG));
3156             }
3157         }
3159         return($success);
3160     }
3164 /*! \brief Generate samba hashes
3165  *
3166  * Given a certain password this constructs an array like
3167  * array['sambaLMPassword'] etc.
3168  *
3169  * \param string 'password'
3170  * \return array contains several keys for lmPassword, ntPassword, pwdLastSet, etc. depending
3171  * on the samba version
3172  */
3173 function generate_smb_nt_hash($password)
3175   global $config;
3177   // First try to retrieve values via RPC 
3178   if ($config->get_cfg_value("core","gosaRpcServer") != ""){
3180     $rpc = $config->getRpcHandle();
3181     $hash = $rpc->mksmbhash($password);
3182     if(!$rpc->success()){
3183         msg_dialog::display(_("Error"),msgPool::rpcError($rpc->get_error()),ERROR_DIALOG);
3184         return("");
3185     }
3187   }elseif ($config->get_cfg_value("core","gosaSupportURI") != ""){
3189     // Try using gosa-si
3190         $res= gosaSupportDaemon::send("gosa_gen_smb_hash", "GOSA", array("password" => $password), TRUE);
3191     if (isset($res['XML']['HASH'])){
3192         $hash= $res['XML']['HASH'];
3193     } else {
3194       $hash= "";
3195     }
3197     if ($hash == "") {
3198       msg_dialog::display(_("Configuration error"), _("Cannot generate SAMBA hash!"), ERROR_DIALOG);
3199       return ("");
3200     }
3201   } else {
3202           $tmp = $config->get_cfg_value("core",'sambaHashHook');
3203       $tmp = preg_replace("/%userPassword/", escapeshellarg($password), $tmp);
3204       $tmp = preg_replace("/%password/", escapeshellarg($password), $tmp);
3205           @DEBUG (DEBUG_LDAP, __LINE__, __FUNCTION__, __FILE__, $tmp, "Execute");
3207           exec($tmp, $ar);
3208           flush();
3209           reset($ar);
3210           $hash= current($ar);
3212     if ($hash == "") {
3213       msg_dialog::display(_("Configuration error"), sprintf(_("Generating SAMBA hash by running %s failed: check %s!"), bold($config->get_cfg_value("core",'sambaHashHook'), bold("sambaHashHook"))), ERROR_DIALOG);
3214       return ("");
3215     }
3216   }
3218   list($lm,$nt)= explode(":", trim($hash));
3220   $attrs['sambaLMPassword']= $lm;
3221   $attrs['sambaNTPassword']= $nt;
3222   $attrs['sambaPwdLastSet']= date('U');
3223   $attrs['sambaBadPasswordCount']= "0";
3224   $attrs['sambaBadPasswordTime']= "0";
3225   return($attrs);
3229 /*! \brief Get the Change Sequence Number of a certain DN
3230  *
3231  * To verify if a given object has been changed outside of Gosa
3232  * in the meanwhile, this function can be used to get the entryCSN
3233  * from the LDAP directory. It uses the attribute as configured
3234  * in modificationDetectionAttribute
3235  *
3236  * \param string 'dn'
3237  * \return either the result or "" in any other case
3238  */
3239 function getEntryCSN($dn)
3241   global $config;
3242   if(empty($dn) || !is_object($config)){
3243     return("");
3244   }
3246   /* Get attribute that we should use as serial number */
3247   $attr= $config->get_cfg_value("core","modificationDetectionAttribute");
3248   if($attr != ""){
3249     $ldap = $config->get_ldap_link();
3250     $ldap->cat($dn,array($attr));
3251     $csn = $ldap->fetch();
3252     if(isset($csn[$attr][0])){
3253       return($csn[$attr][0]);
3254     }
3255   }
3256   return("");
3260 /*! \brief Add (a) given objectClass(es) to an attrs entry
3261  * 
3262  * The function adds the specified objectClass(es) to the given
3263  * attrs entry.
3264  *
3265  * \param mixed 'classes' Either a single objectClass or several objectClasses
3266  * as an array
3267  * \param array 'attrs' The attrs array to be modified.
3268  *
3269  * */
3270 function add_objectClass($classes, &$attrs)
3272   if (is_array($classes)){
3273     $list= $classes;
3274   } else {
3275     $list= array($classes);
3276   }
3278   foreach ($list as $class){
3279     $attrs['objectClass'][]= $class;
3280   }
3284 /*! \brief Removes a given objectClass from the attrs entry
3285  *
3286  * Similar to add_objectClass, except that it removes the given
3287  * objectClasses. See it for the params.
3288  * */
3289 function remove_objectClass($classes, &$attrs)
3291   if (isset($attrs['objectClass'])){
3292     /* Array? */
3293     if (is_array($classes)){
3294       $list= $classes;
3295     } else {
3296       $list= array($classes);
3297     }
3299     $tmp= array();
3300     foreach ($attrs['objectClass'] as $oc) {
3301       foreach ($list as $class){
3302         if (strtolower($oc) != strtolower($class)){
3303           $tmp[]= $oc;
3304         }
3305       }
3306     }
3307     $attrs['objectClass']= $tmp;
3308   }
3312 /*! \brief  Initialize a file download with given content, name and data type. 
3313  *  \param  string data The content to send.
3314  *  \param  string name The name of the file.
3315  *  \param  string type The content identifier, default value is "application/octet-stream";
3316  */
3317 function send_binary_content($data,$name,$type = "application/octet-stream")
3319   header("Expires: Mon, 26 Jul 1997 05:00:00 GMT");
3320   header("Last-Modified: ".gmdate("D, d M Y H:i:s")." GMT");
3321   header("Cache-Control: no-cache");
3322   header("Pragma: no-cache");
3323   header("Cache-Control: post-check=0, pre-check=0");
3324   header("Content-type: ".$type."");
3326   $HTTP_USER_AGENT = $_SERVER['HTTP_USER_AGENT'];
3328   /* Strip name if it is a complete path */
3329   if (preg_match ("/\//", $name)) {
3330         $name= basename($name);
3331   }
3332   
3333   /* force download dialog */
3334   if (preg_match('/MSIE 5.5/', $HTTP_USER_AGENT) || preg_match('/MSIE 6.0/', $HTTP_USER_AGENT)) {
3335     header('Content-Disposition: filename="'.$name.'"');
3336   } else {
3337     header('Content-Disposition: attachment; filename="'.$name.'"');
3338   }
3340   echo $data;
3341   exit();
3345 function reverse_html_entities($str,$type = ENT_QUOTES , $charset = "UTF-8")
3347   if(is_string($str)){
3348     return(htmlentities($str,$type,$charset));
3349   }elseif(is_array($str)){
3350     foreach($str as $name => $value){
3351       $str[$name] = reverse_html_entities($value,$type,$charset);
3352     }
3353   }
3354   return($str);
3358 /*! \brief Encode special string characters so we can use the string in \
3359            HTML output, without breaking quotes.
3360     \param string The String we want to encode.
3361     \return string The encoded String
3362  */
3363 function xmlentities($str)
3364
3365   if(is_string($str)){
3367     static $asc2uni= array();
3368     if (!count($asc2uni)){
3369       for($i=128;$i<256;$i++){
3370     #    $asc2uni[chr($i)] = "&#x".dechex($i).";";
3371       }
3372     }
3374     $str = str_replace("&", "&amp;", $str);
3375     $str = str_replace("<", "&lt;", $str);
3376     $str = str_replace(">", "&gt;", $str);
3377     $str = str_replace("'", "&apos;", $str);
3378     $str = str_replace("\"", "&quot;", $str);
3379     $str = str_replace("\r", "", $str);
3380     $str = strtr($str,$asc2uni);
3381     return $str;
3382   }elseif(is_array($str)){
3383     foreach($str as $name => $value){
3384       $str[$name] = xmlentities($value);
3385     }
3386   }
3387   return($str);
3391 /*! \brief  Updates all accessTo attributes from a given value to a new one.
3392             For example if a host is renamed.
3393     \param  String  $from The source accessTo name.
3394     \param  String  $to   The destination accessTo name.
3395 */
3396 function update_accessTo($from,$to)
3398   global $config;
3399   $ldap = $config->get_ldap_link();
3400   $ldap->cd($config->current['BASE']);
3401   $ldap->search("(&(objectClass=trustAccount)(accessTo=".$from."))",array("objectClass","accessTo"));
3402   while($attrs = $ldap->fetch()){
3403     $new_attrs = array("accessTo" => array());
3404     $dn = $attrs['dn'];
3405     for($i = 0 ; $i < $attrs['accessTo']['count']; $i++){
3406       if($attrs['accessTo'][$i] == $from){
3407         if(!empty($to)){
3408           $new_attrs['accessTo'][] =  $to;
3409         }
3410       }else{
3411         $new_attrs['accessTo'][] =  $attrs['accessTo'][$i]; 
3412       }
3413     }
3414     $ldap->cd($dn);
3415     $ldap->modify($new_attrs);
3416     if (!$ldap->success()){
3417       msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), $dn, LDAP_MOD, "update_accessTo($from,$to)"));
3418     }
3419     new log("modify","update_accessTo($from,$to)",$dn,array_keys($new_attrs),$ldap->get_error());
3420   }
3424 /*! \brief Returns a random char */
3425 function get_random_char () {
3426      $randno = rand (0, 63);
3427      if ($randno < 12) {
3428          return (chr ($randno + 46)); // Digits, '/' and '.'
3429      } else if ($randno < 38) {
3430          return (chr ($randno + 53)); // Uppercase
3431      } else {
3432          return (chr ($randno + 59)); // Lowercase
3433      }
3437 function cred_encrypt($input, $password) {
3439   $size = mcrypt_get_iv_size(MCRYPT_RIJNDAEL_128, MCRYPT_MODE_CBC);
3440   $iv = mcrypt_create_iv($size, MCRYPT_DEV_RANDOM);
3442   return bin2hex(mcrypt_encrypt(MCRYPT_RIJNDAEL_128, $password, $input, MCRYPT_MODE_ECB, $iv));
3447 function cred_decrypt($input,$password) {
3448   $size = mcrypt_get_iv_size(MCRYPT_RIJNDAEL_128, MCRYPT_MODE_CBC);
3449   $iv = mcrypt_create_iv($size, MCRYPT_DEV_RANDOM);
3451   return mcrypt_decrypt(MCRYPT_RIJNDAEL_128, $password, pack("H*", $input), MCRYPT_MODE_ECB, $iv);
3455 function get_object_info()
3457   return(session::get('objectinfo'));
3461 function set_object_info($str = "")
3463   session::set('objectinfo',$str);
3467 function isIpInNet($ip, $net, $mask) {
3468    // Move to long ints
3469    $ip= ip2long($ip);
3470    $net= ip2long($net);
3471    $mask= ip2long($mask);
3473    // Mask given IP with mask. If it returns "net", we're in...
3474    $res= $ip & $mask;
3476    return ($res == $net);
3480 function get_next_id($attrib, $dn)
3482   global $config;
3484   switch ($config->get_cfg_value("core","idAllocationMethod")){
3485     case "pool":
3486       return get_next_id_pool($attrib);
3487     case "traditional":
3488       return get_next_id_traditional($attrib, $dn);
3489   }
3491   msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("unknown idAllocation method!"), ERROR_DIALOG);
3492   return null;
3496 function get_next_id_pool($attrib) {
3497   global $config;
3499   /* Fill informational values */
3500   $min= $config->get_cfg_value("core","${attrib}PoolMin");
3501   $max= $config->get_cfg_value("core","${attrib}PoolMax");
3503   /* Sanity check */
3504   if ($min >= $max) {
3505     msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." ".sprintf(_("%sPoolMin >= %sPoolMax!"), bold($attrib), bold($attrib)), ERROR_DIALOG);
3506     return null;
3507   }
3509   /* ID to skip */
3510   $ldap= $config->get_ldap_link();
3511   $id= null;
3513   /* Try to allocate the ID several times before failing */
3514   $tries= 3;
3515   while ($tries--) {
3517     /* Look for ID map entry */
3518     $ldap->cd ($config->current['BASE']);
3519     $ldap->search ("(&(objectClass=sambaUnixIdPool)($attrib=*))", array("$attrib"));
3521     /* If it does not exist, create one with these defaults */
3522     if ($ldap->count() == 0) {
3523       /* Fill informational values */
3524       $minUserId= $config->get_cfg_value("core","uidNumberPoolMin");
3525       $minGroupId= $config->get_cfg_value("core","gidNumberPoolMin");
3527       /* Add as default */
3528       $attrs= array("objectClass" => array("organizationalUnit", "sambaUnixIdPool"));
3529       $attrs["ou"]= "idmap";
3530       $attrs["uidNumber"]= $minUserId;
3531       $attrs["gidNumber"]= $minGroupId;
3532       $ldap->cd("ou=idmap,".$config->current['BASE']);
3533       $ldap->add($attrs);
3534       if ($ldap->error != "Success") {
3535         msg_dialog::display(_("Error"), _("Cannot create sambaUnixIdPool entry!"), ERROR_DIALOG);
3536         return null;
3537       }
3538       $tries++;
3539       continue;
3540     }
3541     /* Bail out if it's not unique */
3542     if ($ldap->count() != 1) {
3543       msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("sambaUnixIdPool is not unique!"), ERROR_DIALOG);
3544       return null;
3545     }
3547     /* Store old attrib and generate new */
3548     $attrs= $ldap->fetch();
3549     $dn= $ldap->getDN();
3550     $oldAttr= $attrs[$attrib][0];
3551     $newAttr= $oldAttr + 1;
3553     /* Sanity check */
3554     if ($newAttr >= $max) {
3555       msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("no ID available!"), ERROR_DIALOG);
3556       return null;
3557     }
3558     if ($newAttr < $min) {
3559       msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("no ID available!"), ERROR_DIALOG);
3560       return null;
3561     }
3563     #FIXME: PHP is not able to do a modification of "del: .../add: ...", so this
3564     #       is completely unsafe in the moment.
3565     #/* Remove old attr, add new attr */
3566     #$attrs= array($attrib => $oldAttr);
3567     #$ldap->rm($attrs, $dn);
3568     #if ($ldap->error != "Success") {
3569     #  continue;
3570     #}
3571     $ldap->cd($dn);
3572     $ldap->modify(array($attrib => $newAttr));
3573     if ($ldap->error != "Success") {
3574       msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." ".$ldap->get_error(), ERROR_DIALOG);
3575       return null;
3576     } else {
3577       return $oldAttr;
3578     }
3579   }
3581   /* Bail out if we had problems getting the next id */
3582   if (!$tries) {
3583     msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("maximum number of tries exceeded!"), ERROR_DIALOG);
3584   }
3586   return $id;
3590 function get_next_id_traditional($attrib, $dn)
3592   global $config;
3594   $ids= array();
3595   $ldap= $config->get_ldap_link();
3597   $ldap->cd ($config->current['BASE']);
3598   if (preg_match('/gidNumber/i', $attrib)){
3599     $oc= "posixGroup";
3600   } else {
3601     $oc= "posixAccount";
3602   }
3603   $ldap->search ("(&(objectClass=$oc)($attrib=*))", array("$attrib"));
3605   /* Get list of ids */
3606   while ($attrs= $ldap->fetch()){
3607     $ids[]= (int)$attrs["$attrib"][0];
3608   }
3610   /* Add the nobody id */
3611   $ids[]= 65534;
3613   /* get the ranges */
3614   $tmp = array('0'=> 1000);
3615   if (preg_match('/posixAccount/', $oc) && $config->get_cfg_value("core","uidNumberBase") != ""){
3616     $tmp= explode('-',$config->get_cfg_value("core","uidNumberBase"));
3617   } elseif($config->get_cfg_value("core","gidNumberBase") != ""){
3618     $tmp= explode('-',$config->get_cfg_value("core","gidNumberBase"));
3619   }
3621   /* Set hwm to max if not set - for backward compatibility */
3622   $lwm= $tmp[0];
3623   if (isset($tmp[1])){
3624     $hwm= $tmp[1];
3625   } else {
3626     $hwm= pow(2,32);
3627   }
3628   /* Find out next free id near to UID_BASE */
3629   if ($config->get_cfg_value("core","baseIdHook") == ""){
3630     $base= $lwm;
3631   } else {
3632     /* Call base hook */
3633     $base= get_base_from_hook($dn, $attrib);
3634   }
3635   for ($id= $base; $id++; $id < pow(2,32)){
3636     if (!in_array($id, $ids)){
3637       return ($id);
3638     }
3639   }
3641   /* Should not happen */
3642   if ($id == $hwm){
3643     msg_dialog::display(_("Error"), _("Cannot allocate free ID!"), ERROR_DIALOG);
3644     exit;
3645   }
3649 /* Mark the occurance of a string with a span */
3650 function mark($needle, $haystack, $ignorecase= true)
3652   $result= "";
3654   while (preg_match('/^(.*)('.preg_quote($needle).')(.*)$/i', $haystack, $matches)) {
3655     $result.= $matches[1]."<span class='mark'>".$matches[2]."</span>";
3656     $haystack= $matches[3];
3657   }
3659   return $result.$haystack;
3663 /* Return an image description using the path */
3664 function image($path, $action= "", $title= "", $align= "middle")
3666   global $config;
3667   global $BASE_DIR;
3668   $label= null;
3670   // Bail out, if there's no style file
3671   if(!session::global_is_set("img-styles")){
3673     // Get theme
3674     if (isset ($config)){
3675       $theme= $config->get_cfg_value("core","theme");
3676     } else {
3678       // Fall back to default theme
3679       $theme= "default";
3680     }
3682     if (!file_exists("$BASE_DIR/ihtml/themes/$theme/img.styles")){
3683       die ("No img.style for this theme found!");
3684     }
3686     session::global_set('img-styles', unserialize(file_get_contents("$BASE_DIR/ihtml/themes/$theme/img.styles")));
3687   }
3688   $styles= session::global_get('img-styles');
3690   /* Extract labels from path */
3691   if (preg_match("/\.png\[(.*)\]$/", $path, $matches)) {
3692     $label= $matches[1];
3693   }
3695   $lbl= "";
3696   if ($label) {
3697     if (isset($styles["images/label-".$label.".png"])) {
3698       $lbl= "<div style='".$styles["images/label-".$label.".png"]."'></div>";
3699     } else {
3700       die("Invalid label specified: $label\n");
3701     }
3703     $path= preg_replace("/\[.*\]$/", "", $path);
3704   }
3706   // Non middle layout?
3707   if ($align == "middle") {
3708     $align= "";
3709   } else {
3710     $align= ";vertical-align:$align";
3711   }
3713   // Clickable image or not?
3714   if ($title != "") {
3715     $title= "title='$title'";
3716   }
3717   if ($action == "") {
3718     return "<div class='img' $title style='".$styles[$path]."$align'>$lbl</div>";
3719   } else {
3720     return "<input type='submit' class='img' id='$action' value='' name='$action' $title style='".$styles[$path]."$align'>";
3721   }
3724 /*! \brief    Encodes a complex string to be useable in HTML posts.
3725  */
3726 function postEncode($str)
3728   return(preg_replace("/=/","_", base64_encode($str)));
3731 /*! \brief    Decodes a string encoded by postEncode
3732  */
3733 function postDecode($str)
3735   return(base64_decode(preg_replace("/_/","=", $str)));
3739 /*! \brief    Generate styled output
3740  */
3741 function bold($str)
3743   return "<span class='highlight'>$str</span>";
3747 // vim:tabstop=2:expandtab:shiftwidth=2:filetype=php:syntax:ruler:
3748 ?>