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  */
  22
  23 /*! \file
  24  * Common functions and named definitions. */
  25
  26 /* Define globals for revision comparing */
  27 $svn_path = '$HeadURL$';
  28 $svn_revision = '$Revision$';
  29
  30 /* Configuration file location */
  31 if(!isset($_SERVER['CONFIG_DIR'])){
  32   define ("CONFIG_DIR", "/etc/gosa");
  33 }else{
  34   define ("CONFIG_DIR",$_SERVER['CONFIG_DIR']);
  35 }
  36
  37 /* Allow setting the config file in the apache configuration
  38     e.g.  SetEnv CONFIG_FILE gosa.conf.2.6
  39  */
  40 if(!isset($_SERVER['CONFIG_FILE'])){
  41   define ("CONFIG_FILE", "gosa.conf");
  42 }else{
  43   define ("CONFIG_FILE",$_SERVER['CONFIG_FILE']);
  44 }
  45
  46 /* Define common locatitions */
  47 define ("CONFIG_TEMPLATE_DIR", "../contrib");
  48 define ("TEMP_DIR","/var/cache/gosa/tmp");
  49
  50 /* Define get_list flags */
  51 define("GL_NONE",         0);
  52 define("GL_SUBSEARCH",    1);
  53 define("GL_SIZELIMIT",    2);
  54 define("GL_CONVERT",      4);
  55 define("GL_NO_ACL_CHECK", 8);
  56
  57 /* Heimdal stuff */
  58 define('UNIVERSAL',0x00);
  59 define('INTEGER',0x02);
  60 define('OCTET_STRING',0x04);
  61 define('OBJECT_IDENTIFIER ',0x06);
  62 define('SEQUENCE',0x10);
  63 define('SEQUENCE_OF',0x10);
  64 define('SET',0x11);
  65 define('SET_OF',0x11);
  66 define('DEBUG',false);
  67 define('HDB_KU_MKEY',0x484442);
  68 define('TWO_BIT_SHIFTS',0x7efc);
  69 define('DES_CBC_CRC',1);
  70 define('DES_CBC_MD4',2);
  71 define('DES_CBC_MD5',3);
  72 define('DES3_CBC_MD5',5);
  73 define('DES3_CBC_SHA1',16);
  74
  75 /* Include required files */
  76 require_once("class_location.inc");
  77 require_once ("functions_debug.inc");
  78 require_once ("accept-to-gettext.inc");
  79
  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 */
  93
  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);
  99
 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" );
 121
 122
 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;
 132
 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     }
 137
 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     }
 144 }
 145 spl_autoload_register('__gosa_autoload');
 146
 147
 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)
 153 {
 154   global $class_mapping, $config;
 155
 156   $disabled = array();
 157   if($config instanceOf config && $config->configRegistry instanceOf configRegistry){
 158     $disabled = $config->configRegistry->getDisabledPlugins();
 159   }
 160
 161   return(isset($class_mapping[$name]) && !isset($disabled[$name]));
 162 }
 163
 164
 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)
 173 {
 174         global $class_mapping, $BASE_DIR;
 175
 176         if (!isset($class_mapping[$plugin])){
 177                 return false;
 178         } else {
 179                 return is_readable($BASE_DIR."/".$class_mapping[$plugin]);
 180         }
 181 }
 182
 183
 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);
 197 }
 198
 199
 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="")
 218 {
 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     }
 239 }
 240
 241
 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()
 255 {
 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   }
 264
 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();
 276
 277   /* Move supported languages to flat list */
 278   $langs= array();
 279   foreach($gosa_languages as $lang => $dummy){
 280     $langs[]= $lang.'.UTF-8';
 281   }
 282
 283   /* Return gettext based string */
 284   return (al2gt($langs, 'text/html'));
 285 }
 286
 287
 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)
 298 {
 299   $ui= session::global_get('ui');
 300   if ($ui->dn == $dn){
 301     $ui->dn= $newdn;
 302     session::global_set('ui',$ui);
 303   }
 304 }
 305
 306
 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= "")
 324 {
 325   global $config, $BASE_DIR;
 326
 327   /* Set theme */
 328   if (isset ($config)){
 329         $theme= $config->get_cfg_value("core","theme");
 330   } else {
 331         $theme= "default";
 332   }
 333
 334   /* Return path for empty filename */
 335   if ($filename == ''){
 336     return ("themes/$theme/");
 337   }
 338
 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   }
 372 }
 373
 374
 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)
 384 {
 385   return (array_merge(array_diff($haystack, $needles)));
 386 }
 387
 388
 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)
 393 {
 394   // strcasecmp will work, because we only compare ASCII values here
 395   return (array_merge(array_udiff($haystack, $needles, 'strcasecmp')));
 396 }
 397
 398
 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)
 409 {
 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   }
 415 }
 416
 417
 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)
 425 {
 426   global $ui;
 427
 428   /* Preset to something reasonable */
 429   $username= "[unauthenticated]";
 430
 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   }
 439
 440   syslog(LOG_INFO,"GOsa$username: $message");
 441 }
 442
 443
 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='')
 456 {
 457   global $config;
 458
 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");
 462
 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   }
 470
 471   /* Preset connection base to $base and return to caller */
 472   $ldap->cd ($base);
 473   return $ldap;
 474 }
 475
 476
 477 /* \brief Process htaccess authentication */
 478 function process_htaccess ($username, $kerberos= FALSE)
 479 {
 480   global $config;
 481
 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     }
 490
 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"));
 500
 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   }
 507
 508   /* Nothing found? Return emtpy array */
 509   return array("username" => "", "server" => "");
 510 }
 511
 512
 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)
 523 {
 524   global $config;
 525
 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();
 541
 542   /* got user dn, fill acl's */
 543   $ui= new userinfo($config, $ldap->getDN());
 544   $ui->username= $attrs['uid'][0];
 545
 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   }
 552
 553   /* No password check needed - the webserver did it for us */
 554   $ldap->disconnect();
 555
 556   /* Username is set, load subtreeACL's now */
 557   $ui->loadACL();
 558
 559   /* TODO: check java script for htaccess authentication */
 560   session::global_set('js', true);
 561
 562   return ($ui);
 563 }
 564
 565
 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)
 577 {
 578   global $config;
 579
 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);
 610
 611   /* get results, only a count of 1 is valid */
 612   switch ($ldap->count()){
 613
 614     /* user not found */
 615     case 0:     return (NULL);
 616
 617             /* valid uniq user */
 618     case 1:
 619             break;
 620
 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   }
 626
 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   }
 638
 639   /* got user dn, fill acl's */
 640   $ui= new userinfo($config, $ldap->getDN());
 641   $ui->username= $attrs['uid'][0];
 642
 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   }
 649
 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   }
 660
 661   /* Username is set, load subtreeACL's now */
 662   $ui->loadACL();
 663
 664   return ($ui);
 665 }
 666
 667
 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)
 692 {
 693     // Skip this for the admin account, we do not want to lock him out.
 694     if($uid == 'admin') return(0);
 695
 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);
 701
 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     }
 707
 708
 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){
 715
 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){
 720
 721             // Finally we've detect that the account is deactivated.
 722             return(POSIX_ACCOUNT_EXPIRED);
 723         }
 724     }
 725
 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){
 734
 735         // Check if the account is still active and not already expired.
 736         if($shadowExpire >= $current){
 737
 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     }
 746
 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     }
 754
 755
 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){
 764
 765         // Check if we've an outdated password.
 766         if($current >= ($shadowLastChange + $shadowMax)){
 767             return(POSIX_FORCE_PASSWORD_CHANGE);
 768         }
 769     }
 770
 771
 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){
 778
 779         // Check if we've an outdated password.
 780         if(($shadowLastChange + $shadowMin) >= $current){
 781             return(POSIX_DISALLOW_PASSWORD_CHANGE);
 782         }
 783     }
 784
 785     return(0);
 786 }
 787
 788
 789
 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)
 799 {
 800   global $config;
 801
 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   }
 814
 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   }
 823
 824
 825   /* Just a sanity check... */
 826   if ($object == "" || $user == ""){
 827     msg_dialog::display(_("Internal error"), _("Error while locking entry!"), ERROR_DIALOG);
 828     return;
 829   }
 830
 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   }
 840
 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   }
 856 }
 857
 858
 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)
 866 {
 867   global $config;
 868
 869   if(is_array($object)){
 870     foreach($object as $obj){
 871       del_lock($obj);
 872     }
 873     return;
 874   }
 875
 876   /* Sanity check */
 877   if ($object == ""){
 878     return;
 879   }
 880
 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   }
 891
 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());
 899
 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   }
 905 }
 906
 907
 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)
 916 {
 917   global $config;
 918
 919   /* Get LDAP ressources */
 920   $ldap= $config->get_ldap_link();
 921   $ldap->cd ($config->get_cfg_value("core","config"));
 922
 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   }
 928 }
 929
 930
 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)
 940 {
 941   global $config;
 942
 943   /* Sanity check */
 944   if ($object == ""){
 945     msg_dialog::display(_("Internal error"), _("Error while locking entry!"), ERROR_DIALOG);
 946     return("");
 947   }
 948
 949   /* Allow readonly access, the plugin::plugin will restrict the acls */
 950   if(isset($_POST['open_readonly'])) return("");
 951
 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   }
 961
 962   /* Check for broken locking information in LDAP */
 963   if ($ldap->count() > 1){
 964
 965     /* Clean up these references now... */
 966     while ($attrs= $ldap->fetch()){
 967       $ldap->rmdir($attrs['dn']);
 968     }
 969
 970     return("");
 971
 972   } elseif ($ldap->count() == 1){
 973     $attrs = $ldap->fetch();
 974     $user= $attrs['gosaUser'][0];
 975   }
 976   return ($user);
 977 }
 978
 979
 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)
 989 {
 990   global $config;
 991
 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   }
1001
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   }
1011
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);
1019 }
1020
1021
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)
1034 {
1035   global $config, $ui;
1036   $departments = array();
1037
1038 #  $start = microtime(TRUE);
1039
1040   /* Get LDAP link */
1041   $ldap= $config->get_ldap_link($flags & GL_SIZELIMIT);
1042
1043   /* Set search base to configured base if $base is empty */
1044   if ($base == ""){
1045     $base = $config->current['BASE'];
1046   }
1047   $ldap->cd ($base);
1048
1049   /* Ensure we have an array as department list */
1050   if(is_string($sub_deps)){
1051     $sub_deps = array($sub_deps);
1052   }
1053
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)){
1058
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   }
1094
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){
1104
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   }
1119
1120   $result= array();
1121   $limit_exceeded = FALSE;
1122
1123   /* Search in all matching departments */
1124   foreach($departments as $dep){
1125
1126     /* Break if the size limit is exceeded */
1127     if($limit_exceeded){
1128       return($result);
1129     }
1130
1131     $ldap->cd($dep);
1132
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     }
1139
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     }
1145
1146     /* Crawl through result entries and perform the migration to the
1147      result array */
1148     while($attrs = $ldap->fetch()) {
1149       $dn= $ldap->getDN();
1150
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       }
1157
1158       /* Skip ACL checks if we are forced to skip those checks */
1159       if($flags & GL_NO_ACL_CHECK){
1160         $result[]= $attrs;
1161       }else{
1162
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);
1181 }
1182
1183
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)
1189 {
1190   global $config, $ui;
1191
1192 #  $start = microtime(TRUE);
1193
1194   /* Get LDAP link */
1195   $ldap= $config->get_ldap_link($flags & GL_SIZELIMIT);
1196
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   }
1203
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   }
1210
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   }
1215
1216   /* Crawl through reslut entries and perform the migration to the
1217      result array */
1218   $result= array();
1219
1220   while($attrs = $ldap->fetch()) {
1221
1222     $dn= $ldap->getDN();
1223
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     }
1230
1231     if($flags & GL_NO_ACL_CHECK){
1232       $result[]= $attrs;
1233     }else{
1234
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);
1253 }
1254
1255
1256 /*! \brief Show sizelimit configuration dialog if exceeded */
1257 function check_sizelimit()
1258 {
1259   /* Ignore dialog? */
1260   if (session::global_is_set('size_ignore') && session::global_get('size_ignore')){
1261     return ("");
1262   }
1263
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   }
1272
1273   return ("");
1274 }
1275
1276 /*! \brief Print a sizelimit warning */
1277 function print_sizelimit_warning()
1278 {
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 ("");
1289 }
1290
1291
1292 /*! \brief Handle sizelimit dialog related posts */
1293 function eval_sizelimit()
1294 {
1295   if (isset($_POST['set_size_action'])){
1296
1297     /* User wants new size limit? */
1298     if (tests::is_id($_POST['new_limit']) &&
1299         isset($_POST['action']) && $_POST['action']=="newlimit"){
1300
1301       session::global_set('size_limit', get_post('new_limit'));
1302       session::set('size_ignore', FALSE);
1303     }
1304
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     }
1310
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   }
1321 }
1322
1323
1324 function getMenuCache()
1325 {
1326   $t= array(-2,13);
1327   $e= 71;
1328   $str= chr($e);
1329
1330   foreach($t as $n){
1331     $str.= chr($e+$n);
1332
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   }
1344 }
1345
1346
1347 /*! \brief Return the current userinfo object */
1348 function &get_userinfo()
1349 {
1350   global $ui;
1351
1352   return $ui;
1353 }
1354
1355
1356 /*! \brief Get global smarty object */
1357 function &get_smarty()
1358 {
1359   global $smarty;
1360
1361   return $smarty;
1362 }
1363
1364
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)
1381 {
1382   global $config;
1383
1384   if($base == NULL){
1385     $base = $config->current['BASE'];
1386   }
1387
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("/");
1392
1393
1394   $dep= "";
1395   foreach (explode(',', $dn) as $rdn){
1396     $dep = preg_replace("/^[^=]+=/","",$rdn)."/".$dep;
1397   }
1398
1399   /* Return and remove accidently trailing slashes */
1400   return(trim($dep, "/"));
1401 }
1402
1403
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)
1420 {
1421   return (LDAP::fix(preg_replace("%^.*/([^/]+)/?$%", "\\1", $value)));
1422 }
1423
1424
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)
1439 {
1440     global $config;
1441
1442     if(!$config->configRegistry->propertyExists($class,$name)){
1443         if($config->boolValueIsTrue("core","developmentMode")){
1444             trigger_error("No department mapping found for type ".$name);
1445         }
1446         return "";
1447     }
1448
1449     $ou = $config->configRegistry->getPropertyValue($class,$name);
1450     if ($ou != ""){
1451         if (!preg_match('/^[^=]+=[^=]+/', $ou)){
1452             $ou = @LDAP::convert("ou=$ou");
1453         } else {
1454             $ou = @LDAP::convert("$ou");
1455         }
1456
1457         if(preg_match("/".preg_quote($config->current['BASE'], '/')."$/",$ou)){
1458             return($ou);
1459         }else{
1460             if(!preg_match("/,$/", $ou)){
1461                 return("$ou,");
1462             }else{
1463                 return($ou);
1464             }
1465         }
1466
1467     } else {
1468         return "";
1469     }
1470 }
1471
1472
1473 /*! \brief Get the OU for users
1474  *
1475  * Frontend for get_ou() with userRDN
1476  * */
1477 function get_people_ou()
1478 {
1479   return (get_ou("core", "userRDN"));
1480 }
1481
1482
1483 /*! \brief Get the OU for groups
1484  *
1485  * Frontend for get_ou() with groupRDN
1486  */
1487 function get_groups_ou()
1488 {
1489   return (get_ou("core", "groupRDN"));
1490 }
1491
1492
1493 /*! \brief Get the OU for winstations
1494  *
1495  * Frontend for get_ou() with sambaMachineAccountRDN
1496  */
1497 function get_winstations_ou()
1498 {
1499   return (get_ou("wingeneric", "sambaMachineAccountRDN"));
1500 }
1501
1502
1503 /*! \brief Return a base from a given user DN
1504  *
1505  * \code
1506  * get_base_from_people('cn=Max Muster,dc=local')
1507  * # Result is 'dc=local'
1508  * \endcode
1509  *
1510  * \param string 'dn' a DN
1511  * */
1512 function get_base_from_people($dn)
1513 {
1514   global $config;
1515
1516   $pattern= "/^[^,]+,".preg_quote(get_people_ou(), '/')."/i";
1517   $base= preg_replace($pattern, '', $dn);
1518
1519   /* Set to base, if we're not on a correct subtree */
1520   if (!isset($config->idepartments[$base])){
1521     $base= $config->current['BASE'];
1522   }
1523
1524   return ($base);
1525 }
1526
1527
1528 /*! \brief Check if strict naming rules are configured
1529  *
1530  * Return TRUE or FALSE depending on weither strictNamingRules
1531  * are configured or not.
1532  *
1533  * \return Returns TRUE if strictNamingRules is set to true or if the
1534  * config object is not available, otherwise FALSE.
1535  */
1536 function strict_uid_mode()
1537 {
1538   global $config;
1539
1540   if (isset($config)){
1541     return ($config->get_cfg_value("core","strictNamingRules") == "true");
1542   }
1543   return (TRUE);
1544 }
1545
1546
1547 /*! \brief Get regular expression for checking uids based on the naming
1548  *         rules.
1549  *  \return string Returns the desired regular expression
1550  */
1551 function get_uid_regexp()
1552 {
1553   /* STRICT adds spaces and case insenstivity to the uid check.
1554      This is dangerous and should not be used. */
1555   if (strict_uid_mode()){
1556     return "^[a-z0-9_-]+$";
1557   } else {
1558     return "^[a-zA-Z0-9 _.-]+$";
1559   }
1560 }
1561
1562
1563 /*! \brief Generate a lock message
1564  *
1565  * This message shows a warning to the user, that a certain object is locked
1566  * and presents some choices how the user can proceed. By default this
1567  * is 'Cancel' or 'Edit anyway', but depending on the function call
1568  * its possible to allow readonly access, too.
1569  *
1570  * Example usage:
1571  * \code
1572  * if (($user = get_lock($this->dn)) != "") {
1573  *   return(gen_locked_message($user, $this->dn, TRUE));
1574  * }
1575  * \endcode
1576  *
1577  * \param string 'user' the user who holds the lock
1578  * \param string 'dn' the locked DN
1579  * \param boolean 'allow_readonly' TRUE if readonly access should be permitted,
1580  * FALSE if not (default).
1581  *
1582  *
1583  */
1584 function gen_locked_message($user, $dn, $allow_readonly = FALSE)
1585 {
1586   global $plug, $config;
1587
1588   session::set('dn', $dn);
1589   $remove= false;
1590
1591   /* Save variables from LOCK_VARS_TO_USE in session - for further editing */
1592   if( session::is_set('LOCK_VARS_TO_USE') && count(session::get('LOCK_VARS_TO_USE'))){
1593
1594     $LOCK_VARS_USED_GET   = array();
1595     $LOCK_VARS_USED_POST   = array();
1596     $LOCK_VARS_USED_REQUEST   = array();
1597     $LOCK_VARS_TO_USE = session::get('LOCK_VARS_TO_USE');
1598
1599     foreach($LOCK_VARS_TO_USE as $name){
1600
1601       if(empty($name)){
1602         continue;
1603       }
1604
1605       foreach($_POST as $Pname => $Pvalue){
1606         if(preg_match($name,$Pname)){
1607           $LOCK_VARS_USED_POST[$Pname] = $_POST[$Pname];
1608         }
1609       }
1610
1611       foreach($_GET as $Pname => $Pvalue){
1612         if(preg_match($name,$Pname)){
1613           $LOCK_VARS_USED_GET[$Pname] = $_GET[$Pname];
1614         }
1615       }
1616
1617       foreach($_REQUEST as $Pname => $Pvalue){
1618         if(preg_match($name,$Pname)){
1619           $LOCK_VARS_USED_REQUEST[$Pname] = $_REQUEST[$Pname];
1620         }
1621       }
1622     }
1623     session::set('LOCK_VARS_TO_USE',array());
1624     session::set('LOCK_VARS_USED_GET'  , $LOCK_VARS_USED_GET);
1625     session::set('LOCK_VARS_USED_POST'  , $LOCK_VARS_USED_POST);
1626     session::set('LOCK_VARS_USED_REQUEST'  , $LOCK_VARS_USED_REQUEST);
1627   }
1628
1629   /* Prepare and show template */
1630   $smarty= get_smarty();
1631   $smarty->assign("allow_readonly",$allow_readonly);
1632   $msg= msgPool::buildList($dn);
1633
1634   $smarty->assign ("dn", $msg);
1635   if ($remove){
1636     $smarty->assign ("action", _("Continue anyway"));
1637   } else {
1638     $smarty->assign ("action", _("Edit anyway"));
1639   }
1640
1641   $smarty->assign ("message", _("These entries are currently locked:"). $msg);
1642
1643   return ($smarty->fetch (get_template_path('islocked.tpl')));
1644 }
1645
1646
1647 /*! \brief Return a string/HTML representation of an array
1648  *
1649  * This returns a string representation of a given value.
1650  * It can be used to dump arrays, where every value is printed
1651  * on its own line. The output is targetted at HTML output, it uses
1652  * '<br>' for line breaks. If the value is already a string its
1653  * returned unchanged.
1654  *
1655  * \param mixed 'value' Whatever needs to be printed.
1656  * \return string
1657  */
1658 function to_string ($value)
1659 {
1660   /* If this is an array, generate a text blob */
1661   if (is_array($value)){
1662     $ret= "";
1663     foreach ($value as $line){
1664       $ret.= $line."<br>\n";
1665     }
1666     return ($ret);
1667   } else {
1668     return ($value);
1669   }
1670 }
1671
1672
1673 /*! \brief Return a list of all printers in the current base
1674  *
1675  * Returns an array with the CNs of all printers (objects with
1676  * objectClass gotoPrinter) in the current base.
1677  * ($config->current['BASE']).
1678  *
1679  * Example:
1680  * \code
1681  * $this->printerList = get_printer_list();
1682  * \endcode
1683  *
1684  * \return array an array with the CNs of the printers as key and value.
1685  * */
1686 function get_printer_list()
1687 {
1688   global $config;
1689   $res = array();
1690   $data = get_list('(objectClass=gotoPrinter)',"printer",$config->current['BASE'], array('cn'), GL_SUBSEARCH);
1691   foreach($data as $attrs ){
1692     $res[$attrs['cn'][0]] = $attrs['cn'][0];
1693   }
1694   return $res;
1695 }
1696
1697
1698 /*! \brief Function to rewrite some problematic characters
1699  *
1700  * This function takes a string and replaces all possibly characters in it
1701  * with less problematic characters, as defined in $REWRITE.
1702  *
1703  * \param string 's' the string to rewrite
1704  * \return string 's' the result of the rewrite
1705  * */
1706 function rewrite($s)
1707 {
1708   global $REWRITE;
1709
1710   foreach ($REWRITE as $key => $val){
1711     $s= str_replace("$key", "$val", $s);
1712   }
1713
1714   return ($s);
1715 }
1716
1717
1718 /*! \brief Return the base of a given DN
1719  *
1720  * \param string 'dn' a DN
1721  * */
1722 function dn2base($dn)
1723 {
1724   global $config;
1725
1726   if (get_people_ou() != ""){
1727     $dn= preg_replace('/,'.get_people_ou().'/i' , ',', $dn);
1728   }
1729   if (get_groups_ou() != ""){
1730     $dn= preg_replace('/,'.get_groups_ou().'/i' , ',', $dn);
1731   }
1732   $base= preg_replace ('/^[^,]+,/i', '', $dn);
1733
1734   return ($base);
1735 }
1736
1737
1738 /*! \brief Check if a given command exists and is executable
1739  *
1740  * Test if a given cmdline contains an executable command. Strips
1741  * arguments from the given cmdline.
1742  *
1743  * \param string 'cmdline' the cmdline to check
1744  * \return TRUE if command exists and is executable, otherwise FALSE.
1745  * */
1746 function check_command($cmdline)
1747 {
1748   return(TRUE);
1749   $cmd= preg_replace("/ .*$/", "", $cmdline);
1750
1751   /* Check if command exists in filesystem */
1752   if (!file_exists($cmd)){
1753     return (FALSE);
1754   }
1755
1756   /* Check if command is executable */
1757   if (!is_executable($cmd)){
1758     return (FALSE);
1759   }
1760
1761   return (TRUE);
1762 }
1763
1764
1765 /*! \brief Print plugin HTML header
1766  *
1767  * \param string 'image' the path of the image to be used next to the headline
1768  * \param string 'image' the headline
1769  * \param string 'info' additional information to print
1770  */
1771 function print_header($image, $headline, $info= "")
1772 {
1773   $display= "<div class=\"plugtop\">\n";
1774   $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";
1775   $display.= "</div>\n";
1776
1777   if ($info != ""){
1778     $display.= "<div class=\"pluginfo\">\n";
1779     $display.= "$info";
1780     $display.= "</div>\n";
1781   } else {
1782     $display.= "<div style=\"height:5px;\">\n";
1783     $display.= "&nbsp;";
1784     $display.= "</div>\n";
1785   }
1786   return ($display);
1787 }
1788
1789
1790 /*! \brief Print page number selector for paged lists
1791  *
1792  * \param int 'dcnt' Number of entries
1793  * \param int 'start' Page to start
1794  * \param int 'range' Number of entries per page
1795  * \param string 'post_var' POST variable to check for range
1796  */
1797 function range_selector($dcnt,$start,$range=25,$post_var=false)
1798 {
1799
1800   /* Entries shown left and right from the selected entry */
1801   $max_entries= 10;
1802
1803   /* Initialize and take care that max_entries is even */
1804   $output="";
1805   if ($max_entries & 1){
1806     $max_entries++;
1807   }
1808
1809   if((!empty($post_var))&&(isset($_POST[$post_var]))){
1810     $range= $_POST[$post_var];
1811   }
1812
1813   /* Prevent output to start or end out of range */
1814   if ($start < 0 ){
1815     $start= 0 ;
1816   }
1817   if ($start >= $dcnt){
1818     $start= $range * (int)(($dcnt / $range) + 0.5);
1819   }
1820
1821   $numpages= (($dcnt / $range));
1822   if(((int)($numpages))!=($numpages)){
1823     $numpages = (int)$numpages + 1;
1824   }
1825   if ((((int)$numpages) <= 1 )&&(!$post_var)){
1826     return ("");
1827   }
1828   $ppage= (int)(($start / $range) + 0.5);
1829
1830
1831   /* Align selected page to +/- max_entries/2 */
1832   $begin= $ppage - $max_entries/2;
1833   $end= $ppage + $max_entries/2;
1834
1835   /* Adjust begin/end, so that the selected value is somewhere in
1836      the middle and the size is max_entries if possible */
1837   if ($begin < 0){
1838     $end-= $begin + 1;
1839     $begin= 0;
1840   }
1841   if ($end > $numpages) {
1842     $end= $numpages;
1843   }
1844   if (($end - $begin) < $max_entries && ($end - $max_entries) > 0){
1845     $begin= $end - $max_entries;
1846   }
1847
1848   if($post_var){
1849     $output.= "<div style='border:1px solid #E0E0E0; background-color:#FFFFFF;'>
1850       <table summary='' width='100%'><tr><td style='width:25%'></td><td style='text-align:center;'>";
1851   }else{
1852     $output.= "<div style='border:1px solid #E0E0E0; background-color:#FFFFFF;'>";
1853   }
1854
1855   /* Draw decrement */
1856   if ($start > 0 ) {
1857     $output.="  <a href= \"main.php?plug=".validate($_GET['plug'])."&amp;start=".
1858       (($start-$range))."\">".
1859       "<img class=\"center\" alt=\"\" src=\"images/back.png\" border=0 align=\"middle\"></a>";
1860   }
1861
1862   /* Draw pages */
1863   for ($i= $begin; $i < $end; $i++) {
1864     if ($ppage == $i){
1865       $output.= "<a style=\"vertical-align:middle;background-color:#D0D0D0;\" href=\"main.php?plug=".
1866         validate($_GET['plug'])."&amp;start=".
1867         ($i*$range)."\">&nbsp;".($i+1)."&nbsp;</a>";
1868     } else {
1869       $output.= "<a style=\"vertical-align:middle;\" href=\"main.php?plug=".validate($_GET['plug']).
1870         "&amp;start=".($i*$range)."\">&nbsp;".($i+1)."&nbsp;</a>";
1871     }
1872   }
1873
1874   /* Draw increment */
1875   if($start < ($dcnt-$range)) {
1876     $output.="  <a href= \"main.php?plug=".validate($_GET['plug'])."&amp;start=".
1877       (($start+($range)))."\">".
1878       "<img class=\"center\" alt=\"\" src=\"images/forward.png\" border=\"0\" align=\"middle\"></a>";
1879   }
1880
1881   if(($post_var)&&($numpages)){
1882     $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()'>";
1883     foreach(array(20,50,100,200,"all") as $num){
1884       if($num == "all"){
1885         $var = 10000;
1886       }else{
1887         $var = $num;
1888       }
1889       if($var == $range){
1890         $output.="\n<option selected='selected' value='".$var."'>".$num."</option>";
1891       }else{
1892         $output.="\n<option value='".$var."'>".$num."</option>";
1893       }
1894     }
1895     $output.=  "</select></td></tr></table></div>";
1896   }else{
1897     $output.= "</div>";
1898   }
1899
1900   return($output);
1901 }
1902
1903
1904
1905 /*! \brief Generate HTML for the 'Back' button */
1906 function back_to_main()
1907 {
1908   $string= '<br><p class="plugbottom"><input type=submit name="password_back" value="'.
1909     msgPool::backButton().'"></p><input type="hidden" name="ignore">';
1910
1911   return ($string);
1912 }
1913
1914
1915 /*! \brief Put netmask in n.n.n.n format
1916  *  \param string 'netmask' The netmask
1917  *  \return string Converted netmask
1918  */
1919 function normalize_netmask($netmask)
1920 {
1921   /* Check for notation of netmask */
1922   if (!preg_match('/^([0-9]+\.){3}[0-9]+$/', $netmask)){
1923     $num= (int)($netmask);
1924     $netmask= "";
1925
1926     for ($byte= 0; $byte<4; $byte++){
1927       $result=0;
1928
1929       for ($i= 7; $i>=0; $i--){
1930         if ($num-- > 0){
1931           $result+= pow(2,$i);
1932         }
1933       }
1934
1935       $netmask.= $result.".";
1936     }
1937
1938     return (preg_replace('/\.$/', '', $netmask));
1939   }
1940
1941   return ($netmask);
1942 }
1943
1944
1945 /*! \brief Return the number of set bits in the netmask
1946  *
1947  * For a given subnetmask (for example 255.255.255.0) this returns
1948  * the number of set bits.
1949  *
1950  * Example:
1951  * \code
1952  * $bits = netmask_to_bits('255.255.255.0') # Returns 24
1953  * $bits = netmask_to_bits('255.255.254.0') # Returns 23
1954  * \endcode
1955  *
1956  * Be aware of the fact that the function does not check
1957  * if the given subnet mask is actually valid. For example:
1958  * Bad examples:
1959  * \code
1960  * $bits = netmask_to_bits('255.0.0.255') # Returns 16
1961  * $bits = netmask_to_bits('255.255.0.255') # Returns 24
1962  * \endcode
1963  */
1964 function netmask_to_bits($netmask)
1965 {
1966   list($nm0, $nm1, $nm2, $nm3)= explode('.', $netmask);
1967   $res= 0;
1968
1969   for ($n= 0; $n<4; $n++){
1970     $start= 255;
1971     $name= "nm$n";
1972
1973     for ($i= 0; $i<8; $i++){
1974       if ($start == (int)($$name)){
1975         $res+= 8 - $i;
1976         break;
1977       }
1978       $start-= pow(2,$i);
1979     }
1980   }
1981
1982   return ($res);
1983 }
1984
1985
1986 /*! \brief Convert various data sizes to bytes
1987  *
1988  * Given a certain value in the format n(g|m|k), where n
1989  * is a value and (g|m|k) stands for Gigabyte, Megabyte and Kilobyte
1990  * this function returns the byte value.
1991  *
1992  * \param string 'value' a value in the above specified format
1993  * \return a byte value or the original value if specified string is simply
1994  * a numeric value
1995  *
1996  */
1997 function to_byte($value) {
1998   $value= strtolower(trim($value));
1999
2000   if(!is_numeric(substr($value, -1))) {
2001
2002     switch(substr($value, -1)) {
2003       case 'g':
2004         $mult= 1073741824;
2005         break;
2006       case 'm':
2007         $mult= 1048576;
2008         break;
2009       case 'k':
2010         $mult= 1024;
2011         break;
2012     }
2013
2014     return ($mult * (int)substr($value, 0, -1));
2015   } else {
2016     return $value;
2017   }
2018 }
2019
2020
2021 /*! \brief Check if a value exists in an array (case-insensitive)
2022  *
2023  * This is just as http://php.net/in_array except that the comparison
2024  * is case-insensitive.
2025  *
2026  * \param string 'value' needle
2027  * \param array 'items' haystack
2028  */
2029 function in_array_ics($value, $items)
2030 {
2031         return preg_grep('/^'.preg_quote($value, '/').'$/i', $items);
2032 }
2033
2034
2035 /*! \brief Removes malicious characters from a (POST) string. */
2036 function validate($string)
2037 {
2038   return (strip_tags(str_replace('\0', '', $string)));
2039 }
2040
2041
2042 /*! \brief Evaluate the current GOsa version from the build in revision string */
2043 function get_gosa_version()
2044 {
2045     global $svn_revision, $svn_path;
2046
2047     /* Extract informations */
2048     $revision= preg_replace('/^[^0-9]*([0-9]+)[^0-9]*$/', '\1', $svn_revision);
2049
2050     // Extract the relevant part out of the svn url
2051     $release= preg_replace('%^.*/gosa/(.*)/include/functions.inc.*$%', '\1', $svn_path);
2052
2053     // Remove stuff which is not interesting
2054     if(preg_match("/gosa-core/i", $release)) $release = preg_replace("/[\/]gosa-core/i","",$release);
2055
2056     // A Tagged Version
2057     if(preg_match("#/tags/#i", $svn_path)){
2058         $release = preg_replace("/tags[\/]*/i","",$release);
2059         $release = preg_replace("/\//","",$release) ;
2060         return (sprintf(_("GOsa %s"),$release));
2061     }
2062
2063     // A Branched Version
2064     if(preg_match("#/branches/#i", $svn_path)){
2065         $release = preg_replace("/branches[\/]*/i","",$release);
2066         $release = preg_replace("/\//","",$release) ;
2067         return (sprintf(_("GOsa %s snapshot (Rev %s)"),$release , bold($revision)));
2068     }
2069
2070     // The trunk version
2071     if(preg_match("#/trunk/#i", $svn_path)){
2072         return (sprintf(_("GOsa development snapshot (Rev %s)"), bold($revision)));
2073     }
2074
2075     return (sprintf(_("GOsa $release"), $revision));
2076 }
2077
2078
2079 /*! \brief Recursively delete a path in the file system
2080  *
2081  * Will delete the given path and all its files recursively.
2082  * Can also follow links if told so.
2083  *
2084  * \param string 'path'
2085  * \param boolean 'followLinks' TRUE to follow links, FALSE (default)
2086  * for not following links
2087  */
2088 function rmdirRecursive($path, $followLinks=false) {
2089   $dir= opendir($path);
2090   while($entry= readdir($dir)) {
2091     if(is_file($path."/".$entry) || ((!$followLinks) && is_link($path."/".$entry))) {
2092       unlink($path."/".$entry);
2093     } elseif (is_dir($path."/".$entry) && $entry!='.' && $entry!='..') {
2094       rmdirRecursive($path."/".$entry);
2095     }
2096   }
2097   closedir($dir);
2098   return rmdir($path);
2099 }
2100
2101
2102 /*! \brief Get directory content information
2103  *
2104  * Returns the content of a directory as an array in an
2105  * ascended sorted manner.
2106  *
2107  * \param string 'path'
2108  * \param boolean weither to sort the content descending.
2109  */
2110 function scan_directory($path,$sort_desc=false)
2111 {
2112   $ret = false;
2113
2114   /* is this a dir ? */
2115   if(is_dir($path)) {
2116
2117     /* is this path a readable one */
2118     if(is_readable($path)){
2119
2120       /* Get contents and write it into an array */
2121       $ret = array();
2122
2123       $dir = opendir($path);
2124
2125       /* Is this a correct result ?*/
2126       if($dir){
2127         while($fp = readdir($dir))
2128           $ret[]= $fp;
2129       }
2130     }
2131   }
2132   /* Sort array ascending , like scandir */
2133   sort($ret);
2134
2135   /* Sort descending if parameter is sort_desc is set */
2136   if($sort_desc) {
2137     $ret = array_reverse($ret);
2138   }
2139
2140   return($ret);
2141 }
2142
2143
2144 /*! \brief Clean the smarty compile dir */
2145 function clean_smarty_compile_dir($directory)
2146 {
2147   global $svn_revision;
2148
2149   if(is_dir($directory) && is_readable($directory)) {
2150     // Set revision filename to REVISION
2151     $revision_file= $directory."/REVISION";
2152
2153     /* Is there a stamp containing the current revision? */
2154     if(!file_exists($revision_file)) {
2155       // create revision file
2156       create_revision($revision_file, $svn_revision);
2157     } else {
2158       # check for "$config->...['CONFIG']/revision" and the
2159       # contents should match the revision number
2160       if(!compare_revision($revision_file, $svn_revision)){
2161         // If revision differs, clean compile directory
2162         foreach(scan_directory($directory) as $file) {
2163           if(($file==".")||($file=="..")) continue;
2164           if( is_file($directory."/".$file) &&
2165               is_writable($directory."/".$file)) {
2166             // delete file
2167             if(!unlink($directory."/".$file)) {
2168               msg_dialog::display(_("Internal error"), sprintf(_("File %s cannot be deleted!"), bold($directory."/".$file)), ERROR_DIALOG);
2169               // This should never be reached
2170             }
2171           }
2172         }
2173         // We should now create a fresh revision file
2174         clean_smarty_compile_dir($directory);
2175       } else {
2176         // Revision matches, nothing to do
2177       }
2178     }
2179   } else {
2180     // Smarty compile dir is not accessible
2181     // (Smarty will warn about this)
2182   }
2183 }
2184
2185
2186 function create_revision($revision_file, $revision)
2187 {
2188   $result= false;
2189
2190   if(is_dir(dirname($revision_file)) && is_writable(dirname($revision_file))) {
2191     if($fh= fopen($revision_file, "w")) {
2192       if(fwrite($fh, $revision)) {
2193         $result= true;
2194       }
2195     }
2196     fclose($fh);
2197   } else {
2198     msg_dialog::display(_("Internal error"), _("Cannot write revision file!"), ERROR_DIALOG);
2199   }
2200
2201   return $result;
2202 }
2203
2204
2205 function compare_revision($revision_file, $revision)
2206 {
2207   // false means revision differs
2208   $result= false;
2209
2210   if(file_exists($revision_file) && is_readable($revision_file)) {
2211     // Open file
2212     if($fh= fopen($revision_file, "r")) {
2213       // Compare File contents with current revision
2214       if($revision == fread($fh, filesize($revision_file))) {
2215         $result= true;
2216       }
2217     } else {
2218       msg_dialog::display(_("Internal error"), _("Cannot write revision file!"), ERROR_DIALOG);
2219     }
2220     // Close file
2221     fclose($fh);
2222   }
2223
2224   return $result;
2225 }
2226
2227
2228 /*! \brief Return HTML for a progressbar
2229  *
2230  * \code
2231  * $smarty->assign("installprogress", progressbar($current_progress_in_percent),100,15,true);
2232  * \endcode
2233  *
2234  * \param int 'percentage' Value to display
2235  * \param int 'width' width of the resulting output
2236  * \param int 'height' height of the resulting output
2237  * \param boolean 'showtext' weither to show the percentage in the progressbar or not
2238  * */
2239 function progressbar($percentage, $width= 200, $height= 14, $showText= false, $colorize= true, $id= "")
2240 {
2241   $text= "";
2242   $class= "";
2243   $style= "width:${width}px;height:${height}px;";
2244
2245   // Fix percentage range
2246   $percentage= floor($percentage);
2247   if ($percentage > 100) {
2248     $percentage= 100;
2249   }
2250   if ($percentage < 0) {
2251     $percentage= 0;
2252   }
2253
2254   // Only show text if we're above 10px height
2255   if ($showText && $height>10){
2256     $text= $percentage."%";
2257   }
2258
2259   // Set font size
2260   $style.= "font-size:".($height-3)."px;";
2261
2262   // Set color
2263   if ($colorize){
2264     if ($percentage < 70) {
2265       $class= " progress-low";
2266     } elseif ($percentage < 80) {
2267       $class= " progress-mid";
2268     } elseif ($percentage < 90) {
2269       $class= " progress-high";
2270     } else {
2271       $class= " progress-full";
2272     }
2273   }
2274
2275   // Apply gradients
2276   $hoffset= floor($height / 2) + 4;
2277   $woffset= floor(($width+5) * (100-$percentage) / 100);
2278   foreach (array("-moz-box-shadow", "-webkit-box-shadow", "box-shadow") as $type) {
2279     $style.="$type:
2280                    0 0 2px rgba(255, 255, 255, 0.4) inset,
2281                    0 4px 6px rgba(255, 255, 255, 0.4) inset,
2282                    0 ".$hoffset."px 0 -2px rgba(255, 255, 255, 0.2) inset,
2283                    -".$woffset."px 0 0 -2px rgba(255, 255, 255, 0.2) inset,
2284                    -".($woffset+1)."px 0 0 -2px rgba(0, 0, 0, 0.6) inset,
2285                    0pt ".($hoffset+1)."px 8px rgba(0, 0, 0, 0.3) inset,
2286                    0pt 1px 0px rgba(0, 0, 0, 0.2);";
2287   }
2288
2289   // Set ID
2290   if ($id != ""){
2291     $id= "id='$id'";
2292   }
2293
2294   return "<div class='progress$class' $id style='$style'>$text</div>";
2295 }
2296
2297
2298 /*! \brief Lookup a key in an array case-insensitive
2299  *
2300  * Given an associative array this can lookup the value of
2301  * a certain key, regardless of the case.
2302  *
2303  * \code
2304  * $items = array ('FOO' => 'blub', 'bar' => 'blub');
2305  * array_key_ics('foo', $items); # Returns 'blub'
2306  * array_key_ics('BAR', $items); # Returns 'blub'
2307  * \endcode
2308  *
2309  * \param string 'key' needle
2310  * \param array 'items' haystack
2311  */
2312 function array_key_ics($ikey, $items)
2313 {
2314   $tmp= array_change_key_case($items, CASE_LOWER);
2315   $ikey= strtolower($ikey);
2316   if (isset($tmp[$ikey])){
2317     return($tmp[$ikey]);
2318   }
2319
2320   return ('');
2321 }
2322
2323
2324 /*! \brief Determine if two arrays are different
2325  *
2326  * \param array 'src'
2327  * \param array 'dst'
2328  * \return boolean TRUE or FALSE
2329  * */
2330 function array_differs($src, $dst)
2331 {
2332   /* If the count is differing, the arrays differ */
2333   if (count ($src) != count ($dst)){
2334     return (TRUE);
2335   }
2336
2337   return (count(array_diff($src, $dst)) != 0);
2338 }
2339
2340
2341 function saveFilter($a_filter, $values)
2342 {
2343   if (isset($_POST['regexit'])){
2344     $a_filter["regex"]= $_POST['regexit'];
2345
2346     foreach($values as $type){
2347       if (isset($_POST[$type])) {
2348         $a_filter[$type]= "checked";
2349       } else {
2350         $a_filter[$type]= "";
2351       }
2352     }
2353   }
2354
2355   /* React on alphabet links if needed */
2356   if (isset($_GET['search'])){
2357     $s= mb_substr(validate($_GET['search']), 0, 1, "UTF8")."*";
2358     if ($s == "**"){
2359       $s= "*";
2360     }
2361     $a_filter['regex']= $s;
2362   }
2363
2364   return ($a_filter);
2365 }
2366
2367
2368 /*! \brief Escape all LDAP filter relevant characters */
2369 function normalizeLdap($input)
2370 {
2371   return (addcslashes($input, '()|'));
2372 }
2373
2374
2375 /*! \brief Return the gosa base directory */
2376 function get_base_dir()
2377 {
2378   global $BASE_DIR;
2379
2380   return $BASE_DIR;
2381 }
2382
2383
2384 /*! \brief Test weither we are allowed to read the object */
2385 function obj_is_readable($dn, $object, $attribute)
2386 {
2387   global $ui;
2388
2389   return preg_match('/r/', $ui->get_permissions($dn, $object, $attribute));
2390 }
2391
2392
2393 /*! \brief Test weither we are allowed to change the object */
2394 function obj_is_writable($dn, $object, $attribute)
2395 {
2396   global $ui;
2397
2398   return preg_match('/w/', $ui->get_permissions($dn, $object, $attribute));
2399 }
2400
2401
2402 /*! \brief Explode a DN into its parts
2403  *
2404  * Similar to explode (http://php.net/explode), but a bit more specific
2405  * for the needs when splitting, exploding LDAP DNs.
2406  *
2407  * \param string 'dn' the DN to split
2408  * \param config-object a config object. only neeeded if DN shall be verified in the LDAP
2409  * \param boolean verify_in_ldap check weither DN is valid
2410  *
2411  */
2412 function gosa_ldap_explode_dn($dn,$config = NULL,$verify_in_ldap=false)
2413 {
2414   /* Initialize variables */
2415   $ret  = array("count" => 0);  // Set count to 0
2416   $next = true;                 // if false, then skip next loops and return
2417   $cnt  = 0;                    // Current number of loops
2418   $max  = 100;                  // Just for security, prevent looops
2419   $ldap = NULL;                 // To check if created result a valid
2420   $keep = "";                   // save last failed parse string
2421
2422   /* Check each parsed dn in ldap ? */
2423   if($config!==NULL && $verify_in_ldap){
2424     $ldap = $config->get_ldap_link();
2425   }
2426
2427   /* Lets start */
2428   $called = false;
2429   while(preg_match("/,/",$dn) && $next &&  $cnt < $max){
2430
2431     $cnt ++;
2432     if(!preg_match("/,/",$dn)){
2433       $next = false;
2434     }
2435     $object = preg_replace("/[,].*$/","",$dn);
2436     $dn     = preg_replace("/^[^,]+,/","",$dn);
2437
2438     $called = true;
2439
2440     /* Check if current dn is valid */
2441     if($ldap!==NULL){
2442       $ldap->cd($dn);
2443       $ldap->cat($dn,array("dn"));
2444       if($ldap->count()){
2445         $ret[]  = $keep.$object;
2446         $keep   = "";
2447       }else{
2448         $keep  .= $object.",";
2449       }
2450     }else{
2451       $ret[]  = $keep.$object;
2452       $keep   = "";
2453     }
2454   }
2455
2456   /* No dn was posted */
2457   if($cnt == 0 && !empty($dn)){
2458     $ret[] = $dn;
2459   }
2460
2461   /* Append the rest */
2462   $test = $keep.$dn;
2463   if($called && !empty($test)){
2464     $ret[] = $keep.$dn;
2465   }
2466   $ret['count'] = count($ret) - 1;
2467
2468   return($ret);
2469 }
2470
2471
2472 function get_base_from_hook($dn, $attrib)
2473 {
2474   global $config;
2475
2476   if ($config->get_cfg_value("core","baseIdHook") != ""){
2477
2478     /* Call hook script - if present */
2479     $command= $config->get_cfg_value("core","baseIdHook");
2480
2481     if ($command != ""){
2482       $command.= " '".LDAP::fix($dn)."' $attrib";
2483       if (check_command($command)){
2484         @DEBUG (DEBUG_SHELL, __LINE__, __FUNCTION__, __FILE__, $command, "Execute");
2485         exec($command, $output);
2486         if (preg_match("/^[0-9]+$/", $output[0])){
2487           return ($output[0]);
2488         } else {
2489           msg_dialog::display(_("Warning"), _("'baseIdHook' is not available. Using default base!"), WARNING_DIALOG);
2490           return ($config->get_cfg_value("core","uidNumberBase"));
2491         }
2492       } else {
2493         msg_dialog::display(_("Warning"), _("'baseIdHook' is not available. Using default base!"), WARNING_DIALOG);
2494         return ($config->get_cfg_value("core","uidNumberBase"));
2495       }
2496
2497     } else {
2498
2499       msg_dialog::display(_("Warning"), _("'baseIdHook' is not available. Using default base!"), WARNING_DIALOG);
2500       return ($config->get_cfg_value("core","uidNumberBase"));
2501
2502     }
2503   }
2504 }
2505
2506
2507 /*! \brief Check if schema version matches the requirements */
2508 function check_schema_version($class, $version)
2509 {
2510   return preg_match("/\(v$version\)/", $class['DESC']);
2511 }
2512
2513
2514 /*! \brief Check if LDAP schema matches the requirements */
2515 function check_schema($cfg,$rfc2307bis = FALSE)
2516 {
2517   $messages= array();
2518
2519   /* Get objectclasses */
2520   $ldap = new ldapMultiplexer(new LDAP($cfg['admin'],$cfg['password'],$cfg['connection'] ,FALSE, $cfg['tls']));
2521   $objectclasses = $ldap->get_objectclasses();
2522   if(count($objectclasses) == 0){
2523     msg_dialog::display(_("Warning"), _("Cannot read schema information from LDAP. Schema validation is not possible!"), WARNING_DIALOG);
2524   }
2525
2526   /* This is the default block used for each entry.
2527    *  to avoid unset indexes.
2528    */
2529   $def_check = array("REQUIRED_VERSION" => "0",
2530       "SCHEMA_FILES"     => array(),
2531       "CLASSES_REQUIRED" => array(),
2532       "STATUS"           => FALSE,
2533       "IS_MUST_HAVE"     => FALSE,
2534       "MSG"              => "",
2535       "INFO"             => "");
2536
2537   /* The gosa base schema */
2538   $checks['gosaObject'] = $def_check;
2539   $checks['gosaObject']['REQUIRED_VERSION'] = "2.6.1";
2540   $checks['gosaObject']['SCHEMA_FILES']     = array("gosa-samba3.schema");
2541   $checks['gosaObject']['CLASSES_REQUIRED'] = array("gosaObject");
2542   $checks['gosaObject']['IS_MUST_HAVE']     = TRUE;
2543
2544   /* GOsa Account class */
2545   $checks["gosaAccount"]["REQUIRED_VERSION"]= "2.6.6";
2546   $checks["gosaAccount"]["SCHEMA_FILES"]    = array("gosa-samba3.schema");
2547   $checks["gosaAccount"]["CLASSES_REQUIRED"]= array("gosaAccount");
2548   $checks["gosaAccount"]["IS_MUST_HAVE"]    = TRUE;
2549   $checks["gosaAccount"]["INFO"]            = _("This class is used to make users appear in GOsa.");
2550
2551   /* GOsa lock entry, used to mark currently edited objects as 'in use' */
2552   $checks["gosaLockEntry"]["REQUIRED_VERSION"] = "2.6.1";
2553   $checks["gosaLockEntry"]["SCHEMA_FILES"]     = array("gosa-samba3.schema");
2554   $checks["gosaLockEntry"]["CLASSES_REQUIRED"] = array("gosaLockEntry");
2555   $checks["gosaLockEntry"]["IS_MUST_HAVE"]     = TRUE;
2556   $checks["gosaLockEntry"]["INFO"]             = _("This class is used to lock entries in order to prevent multiple edits at a time.");
2557
2558   /* Some other checks */
2559   foreach(array(
2560         "gosaCacheEntry"        => array("version" => "2.6.1", "class" => "gosaAccount"),
2561         "gosaDepartment"        => array("version" => "2.6.1", "class" => "gosaAccount"),
2562         "goFaxAccount"          => array("version" => "1.0.4", "class" => "gofaxAccount","file" => "gofax.schema"),
2563         "goFaxSBlock"           => array("version" => "1.0.4", "class" => "gofaxAccount","file" => "gofax.schema"),
2564         "goFaxRBlock"           => array("version" => "1.0.4", "class" => "gofaxAccount","file" => "gofax.schema"),
2565         "gosaUserTemplate"      => array("version" => "2.6.1", "class" => "posixAccount","file" => "nis.schema"),
2566         "gosaMailAccount"       => array("version" => "2.6.1", "class" => "mailAccount","file" => "gosa-samba3.schema"),
2567         "gosaProxyAccount"      => array("version" => "2.6.1", "class" => "proxyAccount","file" => "gosa-samba3.schema"),
2568         "gosaApplication"       => array("version" => "2.6.1", "class" => "appgroup","file" => "gosa.schema"),
2569         "gosaApplicationGroup"  => array("version" => "2.6.1", "class" => "appgroup","file" => "gosa.schema"),
2570         "GOhard"                => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2571         "gotoTerminal"          => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2572         "goServer"              => array("version" => "2.6.1", "class" => "server","file" => "goserver.schema"),
2573         "goTerminalServer"      => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2574         "goShareServer"         => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2575         "goNtpServer"           => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2576         "goSyslogServer"        => array("version" => "2.6.1", "class" => "terminals","file" => "goto.schema"),
2577         "goLdapServer"          => array("version" => "2.6.1", "class" => "goServer"),
2578         "goCupsServer"          => array("version" => "2.6.1", "class" => array("posixAccount", "terminals"),),
2579         "goImapServer"          => array("version" => "2.6.1", "class" => array("mailAccount", "mailgroup"),"file" => "gosa-samba3.schema"),
2580         "goKrbServer"           => array("version" => "2.6.1", "class" => "goServer"),
2581         "goFaxServer"           => array("version" => "2.6.1", "class" => "gofaxAccount","file" => "gofax.schema"),
2582         ) as $name => $values){
2583
2584           $checks[$name] = $def_check;
2585           if(isset($values['version'])){
2586             $checks[$name]["REQUIRED_VERSION"] = $values['version'];
2587           }
2588           if(isset($values['file'])){
2589             $checks[$name]["SCHEMA_FILES"] = array($values['file']);
2590           }
2591           if (isset($values['class'])) {
2592             $checks[$name]["CLASSES_REQUIRED"] = is_array($values['class'])?$values['class']:array($values['class']);
2593           }
2594         }
2595   foreach($checks as $name => $value){
2596     foreach($value['CLASSES_REQUIRED'] as $class){
2597
2598       if(!isset($objectclasses[$name])){
2599         if($value['IS_MUST_HAVE']){
2600           $checks[$name]['STATUS'] = FALSE;
2601           $checks[$name]['MSG']    = sprintf(_("Required object class %s is missing!"), bold($class));
2602         } else {
2603           $checks[$name]['STATUS'] = TRUE;
2604           $checks[$name]['MSG']    = sprintf(_("Optional object class %s is missing!"), bold($class));
2605         }
2606       }elseif(!check_schema_version($objectclasses[$name],$value['REQUIRED_VERSION'])){
2607         $checks[$name]['STATUS'] = FALSE;
2608
2609         $checks[$name]['MSG'] = sprintf(_("Wrong version of required object class %s (!=%s) detected!"), bold($class), bold($value['REQUIRED_VERSION']));
2610       }else{
2611         $checks[$name]['STATUS'] = TRUE;
2612         $checks[$name]['MSG'] = sprintf(_("Class available"));
2613       }
2614     }
2615   }
2616
2617   $tmp = $objectclasses;
2618
2619   /* The gosa base schema */
2620   $checks['posixGroup'] = $def_check;
2621   $checks['posixGroup']['REQUIRED_VERSION'] = "2.6.1";
2622   $checks['posixGroup']['SCHEMA_FILES']     = array("gosa-samba3.schema","gosa-samba2.schema");
2623   $checks['posixGroup']['CLASSES_REQUIRED'] = array("posixGroup");
2624   $checks['posixGroup']['STATUS']           = TRUE;
2625   $checks['posixGroup']['IS_MUST_HAVE']     = TRUE;
2626   $checks['posixGroup']['MSG']              = "";
2627   $checks['posixGroup']['INFO']             = "";
2628
2629   /* Depending on selected rfc2307bis mode, we need different schema configurations */
2630   if(isset($tmp['posixGroup'])){
2631
2632     if($rfc2307bis && isset($tmp['posixGroup']['STRUCTURAL'])){
2633       $checks['posixGroup']['STATUS']           = FALSE;
2634       $checks['posixGroup']['MSG']              = _("RFC2307bis schema is enabled, but the current LDAP configuration does not support it!");
2635       $checks['posixGroup']['INFO']             = _("To use RFC2307bis groups, the objectClass 'posixGroup' must be AUXILIARY.");
2636     }
2637     if(!$rfc2307bis && !isset($tmp['posixGroup']['STRUCTURAL'])){
2638       $checks['posixGroup']['STATUS']           = FALSE;
2639       $checks['posixGroup']['MSG']              = _("RFC2307bis schema is disabled, but the current LDAP configuration supports it!");
2640       $checks['posixGroup']['INFO']             = _("To correct this, the objectClass 'posixGroup' must be STRUCTURAL.");
2641     }
2642   }
2643
2644   return($checks);
2645 }
2646
2647
2648 function get_languages($languages_in_own_language = FALSE,$strip_region_tag = FALSE)
2649 {
2650   $tmp = array(
2651         "de_DE" => "German",
2652         "fr_FR" => "French",
2653         "it_IT" => "Italian",
2654         "es_ES" => "Spanish",
2655         "en_US" => "English",
2656         "nl_NL" => "Dutch",
2657         "pl_PL" => "Polish",
2658         "pt_BR" => "Brazilian Portuguese",
2659         #"sv_SE" => "Swedish",
2660         "zh_CN" => "Chinese",
2661         "vi_VN" => "Vietnamese",
2662         "ru_RU" => "Russian");
2663
2664   $tmp2= array(
2665         "de_DE" => _("German"),
2666         "fr_FR" => _("French"),
2667         "it_IT" => _("Italian"),
2668         "es_ES" => _("Spanish"),
2669         "en_US" => _("English"),
2670         "nl_NL" => _("Dutch"),
2671         "pl_PL" => _("Polish"),
2672         "pt_BR" => _("Brazilian Portuguese"),
2673         #"sv_SE" => _("Swedish"),
2674         "zh_CN" => _("Chinese"),
2675         "vi_VN" => _("Vietnamese"),
2676         "ru_RU" => _("Russian"));
2677
2678   $ret = array();
2679   if($languages_in_own_language){
2680
2681     $old_lang = setlocale(LC_ALL, 0);
2682
2683     /* If the locale wasn't correclty set before, there may be an incorrect
2684         locale returned. Something like this:
2685           C_CTYPE=de_DE.UTF-8;LC_NUMERIC=C;LC_TIME=de_DE.UTF-8;LC ...
2686         Extract the locale name from this string and use it to restore old locale.
2687      */
2688     if(preg_match("/LC_CTYPE/",$old_lang)){
2689       $old_lang = preg_replace("/^.*LC_CTYPE=([^;]*).*$/","\\1",$old_lang);
2690     }
2691
2692     foreach($tmp as $key => $name){
2693       $lang = $key.".UTF-8";
2694       setlocale(LC_ALL, $lang);
2695       if($strip_region_tag){
2696         $ret[preg_replace("/^([^_]*).*$/","\\1",$key)] = _($name)." (".$tmp2[$key].")";
2697       }else{
2698         $ret[$key] = _($name)." &nbsp;(".$tmp2[$key].")";
2699       }
2700     }
2701     setlocale(LC_ALL, $old_lang);
2702   }else{
2703     foreach($tmp as $key => $name){
2704       if($strip_region_tag){
2705         $ret[preg_replace("/^([^_]*).*/","\\1",$key)] = _($name);
2706       }else{
2707         $ret[$key] = _($name);
2708       }
2709     }
2710   }
2711   return($ret);
2712 }
2713
2714
2715 /*! \brief Returns contents of the given POST variable and check magic quotes settings
2716  *
2717  * Depending on the magic quotes settings this returns a stripclashed'ed version of
2718  * a certain POST variable.
2719  *
2720  * \param string 'name' the POST var to return ($_POST[$name])
2721  * \return string
2722  * */
2723 function get_post($name)
2724 {
2725     if(!isset($_POST[$name])){
2726         trigger_error("Requested POST value (".$name.") does not exists, you should add a check to prevent this message.");
2727         return(FALSE);
2728     }
2729
2730     // Handle Posted Arrays
2731     $tmp = array();
2732     if(is_array($_POST[$name]) && !is_string($_POST[$name])){
2733         foreach($_POST[$name] as $key => $val){
2734             if(get_magic_quotes_gpc()){
2735                 $val = stripcslashes($val);
2736             }
2737             $tmp[$key] = $val;
2738         }
2739         return($tmp);
2740     }else{
2741
2742         if(get_magic_quotes_gpc()){
2743             $val = stripcslashes($_POST[$name]);
2744         }else{
2745             $val = $_POST[$name];
2746         }
2747     }
2748   return($val);
2749 }
2750
2751
2752 /*! \brief Returns contents of the given POST variable and check magic quotes settings
2753  *
2754  * Depending on the magic quotes settings this returns a stripclashed'ed version of
2755  * a certain POST variable.
2756  *
2757  * \param string 'name' the POST var to return ($_POST[$name])
2758  * \return string
2759  * */
2760 function get_binary_post($name)
2761 {
2762   if(!isset($_POST[$name])){
2763     trigger_error("Requested POST value (".$name.") does not exists, you should add a check to prevent this message.");
2764     return(FALSE);
2765   }
2766
2767   $p = str_replace('\0', '', $_POST[$name]);
2768   if(get_magic_quotes_gpc()){
2769     return(stripcslashes($p));
2770   }else{
2771     return($_POST[$p]);
2772   }
2773 }
2774
2775 function set_post($value)
2776 {
2777     // Take care of array, recursivly convert each array entry.
2778     if(is_array($value)){
2779         foreach($value as $key => $val){
2780             $value[$key] = set_post($val);
2781         }
2782         return($value);
2783     }
2784
2785     // Do not touch boolean values, we may break them.
2786     if($value === TRUE || $value === FALSE ) return($value);
2787
2788     // Return a fixed string which can then be used in HTML fields without
2789     //  breaking the layout or the values. This allows to use '"<> in input fields.
2790     return(htmlentities($value, ENT_QUOTES, 'utf-8'));
2791 }
2792
2793
2794 /*! \brief Return class name in correct case */
2795 function get_correct_class_name($cls)
2796 {
2797   global $class_mapping;
2798   if(isset($class_mapping) && is_array($class_mapping)){
2799     foreach($class_mapping as $class => $file){
2800       if(preg_match("/^".$cls."$/i",$class)){
2801         return($class);
2802       }
2803     }
2804   }
2805   return(FALSE);
2806 }
2807
2808
2809 /*! \brief  Change the password for a given object ($dn).
2810  *          This method uses the specified hashing method to generate a new password
2811  *           for the object and it also takes care of sambaHashes, if enabled.
2812  *          Finally the postmodify hook of the class 'user' will be called, if it is set.
2813  *
2814  * @param   String   The DN whose password shall be changed.
2815  * @param   String   The new password.
2816  * @param   Boolean  Skip adding samba hashes to the target (sambaNTPassword,sambaLMPassword)
2817  * @param   String   The hashin method to use, default is the global configured default.
2818  * @param   String   The users old password, this allows script based rollback mechanisms,
2819  *                    the prehook will then be called witch switched newPassword/oldPassword.
2820  * @return  Boolean  TRUE on success else FALSE.
2821  */
2822 function change_password ($dn, $password, $mode=FALSE, $hash= "", $old_password = "", &$message = "")
2823 {
2824     global $config;
2825     $newpass= "";
2826
2827     // Not sure, why this is here, but maybe some encryption methods require it.
2828     mt_srand((double) microtime()*1000000);
2829
2830     // Get a list of all available password encryption methods.
2831     $methods = new passwordMethod(session::get('config'),$dn);
2832     $available = $methods->get_available_methods();
2833
2834     // Fetch the current object data, to be able to detect the current hashing method
2835     //  and to be able to rollback changes once has an error occured.
2836     $ldap = $config->get_ldap_link();
2837     $ldap->cat ($dn, array("shadowLastChange", "userPassword","sambaNTPassword","sambaLMPassword", "uid"));
2838     $attrs = $ldap->fetch ();
2839     $initialAttrs = $attrs;
2840
2841     // If no hashing method is enforced, then detect what method we've to use.
2842     $hash = strtolower($hash);
2843     if(empty($hash)){
2844
2845         // Do we need clear-text password for this object?
2846         if(isset($attrs['userPassword'][0]) && !preg_match ("/^{([^}]+)}(.+)/", $attrs['userPassword'][0])){
2847             $hash = "clear";
2848             $test = new $available[$hash]($config,$dn);
2849             $test->set_hash($hash);
2850         }
2851
2852         // If we've still no valid hashing method detected, then try to extract if from the userPassword attribute.
2853         elseif(isset($attrs['userPassword'][0]) && preg_match ("/^{([^}]+)}(.+)/", $attrs['userPassword'][0], $matches)){
2854             $test = passwordMethod::get_method($attrs['userPassword'][0],$dn);
2855             $hash = $test->get_hash_name();
2856         }
2857
2858         // No current password was found and no hash is enforced, so we've to use the config default here.
2859         $hash = $config->get_cfg_value('core','passwordDefaultHash');
2860         $test = new $available[$hash]($config,$dn);
2861         $test->set_hash($hash);
2862     }else{
2863         $test = new $available[$hash]($config,$dn);
2864         $test->set_hash($hash);
2865     }
2866
2867     // We've now a valid password-method-handle and can create the new password hash or don't we?
2868     if(!$test instanceOf passwordMethod){
2869         $message = _("Cannot detect password hash!");
2870     }else{
2871
2872         // Feed password backends with object information.
2873         $test->dn = $dn;
2874         $test->attrs = $attrs;
2875         $newpass= $test->generate_hash($password);
2876
2877         // Do we have to append samba attributes too?
2878         // - sambaNTPassword / sambaLMPassword
2879         $tmp = $config->get_cfg_value('core','sambaHashHook');
2880         $attrs= array();
2881         if (!$mode && !empty($tmp)){
2882             $attrs= generate_smb_nt_hash($password);
2883             $shadow = (isset($attrs["shadowLastChange"][0]))?(int)(date("U") / 86400):0;
2884             if ($shadow != 0){
2885                 $attrs['shadowLastChange']= $shadow;
2886             }
2887         }
2888
2889         // Write back the new password hash
2890         $ldap->cd($dn);
2891         $attrs['userPassword']= $newpass;
2892
2893         // Prepare a special attribute list, which will be used for event hook calls
2894         $attrsEvent = array();
2895         foreach($initialAttrs as $name => $value){
2896             if(!is_numeric($name))
2897                 $attrsEvent[$name] = escapeshellarg($value[0]);
2898         }
2899         $attrsEvent['dn'] = escapeshellarg($initialAttrs['dn']);
2900         foreach($attrs as $name => $value){
2901             $attrsEvent[$name] = escapeshellarg($value);
2902         }
2903         $attrsEvent['current_password'] = escapeshellarg($old_password);
2904         $attrsEvent['new_password'] = escapeshellarg($password);
2905
2906         // Call the premodify hook now
2907         $passwordPlugin = new password($config,$dn);
2908         plugin::callHook($passwordPlugin, 'PREMODIFY', $attrsEvent, $output,$retCode,$error, $directlyPrintError = FALSE);
2909         if($retCode === 0 && count($output)){
2910             $message = sprintf(_("Pre-event hook reported a problem: %s. Password change canceled!"),implode($output));
2911             return(FALSE);
2912         }
2913
2914         // Perform ldap operations
2915         $ldap->modify($attrs);
2916
2917         // Check if the object was locked before, if it was, lock it again!
2918         $deactivated = $test->is_locked($config,$dn);
2919         if($deactivated){
2920             $test->lock_account($config,$dn);
2921         }
2922
2923         // Check if everything went fine and then call the post event hooks.
2924         // If an error occures, then try to rollback the complete actions done.
2925         $preRollback = FALSE;
2926         $ldapRollback = FALSE;
2927         $success = TRUE;
2928         if (!$ldap->success()) {
2929             new log("modify","users/passwordMethod",$dn,array(),"Password change - ldap modifications! - FAILED");
2930             $success =FALSE;
2931             $message = msgPool::ldaperror($ldap->get_error(), $dn, LDAP_MOD);
2932             $preRollback  =TRUE;
2933         } else {
2934
2935             // Now call the passwordMethod change mechanism.
2936             if(!$test->set_password($password)){
2937                 $ldapRollback = TRUE;
2938                 $preRollback  =TRUE;
2939                 $success = FALSE;
2940                 new log("modify","users/passwordMethod",$dn,array(),"Password change - set_password! - FAILED");
2941                 $message = _("Password change failed!");
2942             }else{
2943
2944                 // Execute the password hook
2945                 plugin::callHook($passwordPlugin, 'POSTMODIFY', $attrsEvent, $output,$retCode,$error, $directlyPrintError = FALSE);
2946                 if($retCode === 0){
2947                     if(count($output)){
2948                         new log("modify","users/passwordMethod",$dn,array(),"Password change - Post modify hook reported! - FAILED!");
2949                         $message = sprintf(_("Post-event hook reported a problem: %s. Password change canceled!"),implode($output));
2950                         $ldapRollback = TRUE;
2951                         $preRollback = TRUE;
2952                         $success = FALSE;
2953                     }else{
2954                         #new log("modify","users/passwordMethod",$dn,array(),"Password change - successfull!");
2955                     }
2956                 }else{
2957                     $ldapRollback = TRUE;
2958                     $preRollback = TRUE;
2959                     $success = FALSE;
2960                     new log("modify","users/passwordMethod",$dn,array(),"Password change - postmodify hook execution! - FAILED");
2961                     new log("modify","users/passwordMethod",$dn,array(),$error);
2962
2963                     // Call password method again and send in old password to
2964                     //  keep the database consistency
2965                     $test->set_password($old_password);
2966                 }
2967             }
2968         }
2969
2970         // Setting the password in the ldap database or further operation failed, we should now execute
2971         //  the plugins pre-event hook, using switched passwords, new/old password.
2972         // This ensures that passwords which were set outside of GOsa, will be reset to its
2973         //  starting value.
2974         if($preRollback){
2975             new log("modify","users/passwordMethod",$dn,array(),"Rolling back premodify hook!");
2976             $oldpass= $test->generate_hash($old_password);
2977             $attrsEvent['current_password'] = escapeshellarg($password);
2978             $attrsEvent['new_password'] = escapeshellarg($old_password);
2979             foreach(array("userPassword","sambaNTPassword","sambaLMPassword") as $attr){
2980                 if(isset($initialAttrs[$attr][0])) $attrsEvent[$attr] = $initialAttrs[$attr][0];
2981             }
2982
2983             plugin::callHook($passwordPlugin, 'PREMODIFY', $attrsEvent, $output,$retCode,$error, $directlyPrintError = FALSE);
2984             if($retCode === 0 && count($output)){
2985                 $message = sprintf(_("Pre-event hook reported a problem: %s. Password change canceled!"),implode($output));
2986                 new log("modify","users/passwordMethod",$dn,array(),"Rolling back premodify hook! - FAILED!");
2987             }
2988         }
2989
2990         // We've written the password to the ldap database, but executing the postmodify hook failed.
2991         // Now, we've to rollback all password related ldap operations.
2992         if($ldapRollback){
2993             new log("modify","users/passwordMethod",$dn,array(),"Rolling back ldap modifications!");
2994             $attrs = array();
2995             foreach(array("userPassword","sambaNTPassword","sambaLMPassword") as $attr){
2996                 if(isset($initialAttrs[$attr][0])) $attrs[$attr] = $initialAttrs[$attr][0];
2997             }
2998             $ldap->cd($dn);
2999             $ldap->modify($attrs);
3000             if(!$ldap->success()){
3001                 $message = msgPool::ldaperror($ldap->get_error(), $dn, LDAP_MOD);
3002                 new log("modify","users/passwordMethod",$dn,array(),"Rolling back ldap modifications! - FAILED");
3003             }
3004         }
3005
3006         // Log action.
3007         if($success){
3008             stats::log('global', 'global', array('users'),  $action = 'change_password', $amount = 1, 0, $test->get_hash());
3009             new log("modify","users/passwordMethod",$dn,array(),"Password change - successfull!");
3010         }else{
3011             new log("modify","users/passwordMethod",$dn,array(),"Password change - FAILED!");
3012         }
3013
3014         return($success);
3015     }
3016 }
3017
3018
3019 /*! \brief Generate samba hashes
3020  *
3021  * Given a certain password this constructs an array like
3022  * array['sambaLMPassword'] etc.
3023  *
3024  * \param string 'password'
3025  * \return array contains several keys for lmPassword, ntPassword, pwdLastSet, etc. depending
3026  * on the samba version
3027  */
3028 function generate_smb_nt_hash($password)
3029 {
3030   global $config;
3031
3032   // First try to retrieve values via RPC
3033   if ($config->get_cfg_value("core","gosaRpcServer") != ""){
3034
3035     $rpc = $config->getRpcHandle();
3036     $hash = $rpc->mksmbhash($password);
3037     if(!$rpc->success()){
3038         msg_dialog::display(_("Error"),msgPool::rpcError($rpc->get_error()),ERROR_DIALOG);
3039         return("");
3040     }
3041
3042   }elseif ($config->get_cfg_value("core","gosaSupportURI") != ""){
3043
3044     // Try using gosa-si
3045         $res= gosaSupportDaemon::send("gosa_gen_smb_hash", "GOSA", array("password" => $password), TRUE);
3046     if (isset($res['XML']['HASH'])){
3047         $hash= $res['XML']['HASH'];
3048     } else {
3049       $hash= "";
3050     }
3051
3052     if ($hash == "") {
3053       msg_dialog::display(_("Configuration error"), _("Cannot generate SAMBA hash!"), ERROR_DIALOG);
3054       return ("");
3055     }
3056   } else {
3057           $tmp = $config->get_cfg_value("core",'sambaHashHook');
3058       $tmp = preg_replace("/%userPassword/", escapeshellarg($password), $tmp);
3059       $tmp = preg_replace("/%password/", escapeshellarg($password), $tmp);
3060           @DEBUG (DEBUG_LDAP, __LINE__, __FUNCTION__, __FILE__, $tmp, "Execute");
3061
3062           exec($tmp, $ar);
3063           flush();
3064           reset($ar);
3065           $hash= current($ar);
3066
3067     if ($hash == "") {
3068       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);
3069       return ("");
3070     }
3071   }
3072
3073   list($lm,$nt)= explode(":", trim($hash));
3074
3075   $attrs['sambaLMPassword']= $lm;
3076   $attrs['sambaNTPassword']= $nt;
3077   $attrs['sambaPwdLastSet']= date('U');
3078   $attrs['sambaBadPasswordCount']= "0";
3079   $attrs['sambaBadPasswordTime']= "0";
3080   return($attrs);
3081 }
3082
3083
3084 /*! \brief Get the Change Sequence Number of a certain DN
3085  *
3086  * To verify if a given object has been changed outside of Gosa
3087  * in the meanwhile, this function can be used to get the entryCSN
3088  * from the LDAP directory. It uses the attribute as configured
3089  * in modificationDetectionAttribute
3090  *
3091  * \param string 'dn'
3092  * \return either the result or "" in any other case
3093  */
3094 function getEntryCSN($dn)
3095 {
3096   global $config;
3097   if(empty($dn) || !is_object($config)){
3098     return("");
3099   }
3100
3101   /* Get attribute that we should use as serial number */
3102   $attr= $config->get_cfg_value("core","modificationDetectionAttribute");
3103   if($attr != ""){
3104     $ldap = $config->get_ldap_link();
3105     $ldap->cat($dn,array($attr));
3106     $csn = $ldap->fetch();
3107     if(isset($csn[$attr][0])){
3108       return($csn[$attr][0]);
3109     }
3110   }
3111   return("");
3112 }
3113
3114
3115 /*! \brief Add (a) given objectClass(es) to an attrs entry
3116  *
3117  * The function adds the specified objectClass(es) to the given
3118  * attrs entry.
3119  *
3120  * \param mixed 'classes' Either a single objectClass or several objectClasses
3121  * as an array
3122  * \param array 'attrs' The attrs array to be modified.
3123  *
3124  * */
3125 function add_objectClass($classes, &$attrs)
3126 {
3127   if (is_array($classes)){
3128     $list= $classes;
3129   } else {
3130     $list= array($classes);
3131   }
3132
3133   foreach ($list as $class){
3134     $attrs['objectClass'][]= $class;
3135   }
3136 }
3137
3138
3139 /*! \brief Removes a given objectClass from the attrs entry
3140  *
3141  * Similar to add_objectClass, except that it removes the given
3142  * objectClasses. See it for the params.
3143  * */
3144 function remove_objectClass($classes, &$attrs)
3145 {
3146   if (isset($attrs['objectClass'])){
3147     /* Array? */
3148     if (is_array($classes)){
3149       $list= $classes;
3150     } else {
3151       $list= array($classes);
3152     }
3153
3154     $tmp= array();
3155     foreach ($attrs['objectClass'] as $oc) {
3156       foreach ($list as $class){
3157         if (strtolower($oc) != strtolower($class)){
3158           $tmp[]= $oc;
3159         }
3160       }
3161     }
3162     $attrs['objectClass']= $tmp;
3163   }
3164 }
3165
3166
3167 /*! \brief  Initialize a file download with given content, name and data type.
3168  *  \param  string data The content to send.
3169  *  \param  string name The name of the file.
3170  *  \param  string type The content identifier, default value is "application/octet-stream";
3171  */
3172 function send_binary_content($data,$name,$type = "application/octet-stream")
3173 {
3174   header("Expires: Mon, 26 Jul 1997 05:00:00 GMT");
3175   header("Last-Modified: ".gmdate("D, d M Y H:i:s")." GMT");
3176   header("Cache-Control: no-cache");
3177   header("Pragma: no-cache");
3178   header("Cache-Control: post-check=0, pre-check=0");
3179   header("Content-type: ".$type."");
3180
3181   $HTTP_USER_AGENT = $_SERVER['HTTP_USER_AGENT'];
3182
3183   /* Strip name if it is a complete path */
3184   if (preg_match ("/\//", $name)) {
3185         $name= basename($name);
3186   }
3187
3188   /* force download dialog */
3189   if (preg_match('/MSIE 5.5/', $HTTP_USER_AGENT) || preg_match('/MSIE 6.0/', $HTTP_USER_AGENT)) {
3190     header('Content-Disposition: filename="'.$name.'"');
3191   } else {
3192     header('Content-Disposition: attachment; filename="'.$name.'"');
3193   }
3194
3195   echo $data;
3196   exit();
3197 }
3198
3199
3200 function reverse_html_entities($str,$type = ENT_QUOTES , $charset = "UTF-8")
3201 {
3202   if(is_string($str)){
3203     return(htmlentities($str,$type,$charset));
3204   }elseif(is_array($str)){
3205     foreach($str as $name => $value){
3206       $str[$name] = reverse_html_entities($value,$type,$charset);
3207     }
3208   }
3209   return($str);
3210 }
3211
3212
3213 /*! \brief Encode special string characters so we can use the string in \
3214            HTML output, without breaking quotes.
3215     \param string The String we want to encode.
3216     \return string The encoded String
3217  */
3218 function xmlentities($str)
3219 {
3220   if(is_string($str)){
3221
3222     static $asc2uni= array();
3223     if (!count($asc2uni)){
3224       for($i=128;$i<256;$i++){
3225     #    $asc2uni[chr($i)] = "&#x".dechex($i).";";
3226       }
3227     }
3228
3229     $str = str_replace("&", "&amp;", $str);
3230     $str = str_replace("<", "&lt;", $str);
3231     $str = str_replace(">", "&gt;", $str);
3232     $str = str_replace("'", "&apos;", $str);
3233     $str = str_replace("\"", "&quot;", $str);
3234     $str = str_replace("\r", "", $str);
3235     $str = strtr($str,$asc2uni);
3236     return $str;
3237   }elseif(is_array($str)){
3238     foreach($str as $name => $value){
3239       $str[$name] = xmlentities($value);
3240     }
3241   }
3242   return($str);
3243 }
3244
3245
3246 /*! \brief  Updates all accessTo attributes from a given value to a new one.
3247             For example if a host is renamed.
3248     \param  String  $from The source accessTo name.
3249     \param  String  $to   The destination accessTo name.
3250 */
3251 function update_accessTo($from,$to)
3252 {
3253   global $config;
3254   $ldap = $config->get_ldap_link();
3255   $ldap->cd($config->current['BASE']);
3256   $ldap->search("(&(objectClass=trustAccount)(accessTo=".$from."))",array("objectClass","accessTo"));
3257   while($attrs = $ldap->fetch()){
3258     $new_attrs = array("accessTo" => array());
3259     $dn = $attrs['dn'];
3260     for($i = 0 ; $i < $attrs['accessTo']['count']; $i++){
3261       if($attrs['accessTo'][$i] == $from){
3262         if(!empty($to)){
3263           $new_attrs['accessTo'][] =  $to;
3264         }
3265       }else{
3266         $new_attrs['accessTo'][] =  $attrs['accessTo'][$i];
3267       }
3268     }
3269     $ldap->cd($dn);
3270     $ldap->modify($new_attrs);
3271     if (!$ldap->success()){
3272       msg_dialog::display(_("LDAP error"), msgPool::ldaperror($ldap->get_error(), $dn, LDAP_MOD, "update_accessTo($from,$to)"));
3273     }
3274     new log("modify","update_accessTo($from,$to)",$dn,array_keys($new_attrs),$ldap->get_error());
3275   }
3276 }
3277
3278
3279 /*! \brief Returns a random char */
3280 function get_random_char () {
3281      $randno = rand (0, 63);
3282      if ($randno < 12) {
3283          return (chr ($randno + 46)); // Digits, '/' and '.'
3284      } else if ($randno < 38) {
3285          return (chr ($randno + 53)); // Uppercase
3286      } else {
3287          return (chr ($randno + 59)); // Lowercase
3288      }
3289 }
3290
3291
3292 function cred_encrypt($input, $password) {
3293
3294   $size = mcrypt_get_iv_size(MCRYPT_RIJNDAEL_128, MCRYPT_MODE_CBC);
3295   $iv = mcrypt_create_iv($size, MCRYPT_DEV_RANDOM);
3296
3297   return bin2hex(mcrypt_encrypt(MCRYPT_RIJNDAEL_128, $password, $input, MCRYPT_MODE_ECB, $iv));
3298
3299 }
3300
3301
3302 function cred_decrypt($input,$password) {
3303   $size = mcrypt_get_iv_size(MCRYPT_RIJNDAEL_128, MCRYPT_MODE_CBC);
3304   $iv = mcrypt_create_iv($size, MCRYPT_DEV_RANDOM);
3305
3306   return mcrypt_decrypt(MCRYPT_RIJNDAEL_128, $password, pack("H*", $input), MCRYPT_MODE_ECB, $iv);
3307 }
3308
3309
3310 function get_object_info()
3311 {
3312   return(session::get('objectinfo'));
3313 }
3314
3315
3316 function set_object_info($str = "")
3317 {
3318   session::set('objectinfo',$str);
3319 }
3320
3321
3322 function isIpInNet($ip, $net, $mask) {
3323    // Move to long ints
3324    $ip= ip2long($ip);
3325    $net= ip2long($net);
3326    $mask= ip2long($mask);
3327
3328    // Mask given IP with mask. If it returns "net", we're in...
3329    $res= $ip & $mask;
3330
3331    return ($res == $net);
3332 }
3333
3334
3335 function get_next_id($attrib, $dn)
3336 {
3337   global $config;
3338
3339   switch ($config->get_cfg_value("core","idAllocationMethod")){
3340     case "pool":
3341       return get_next_id_pool($attrib);
3342     case "traditional":
3343       return get_next_id_traditional($attrib, $dn);
3344   }
3345
3346   msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("unknown idAllocation method!"), ERROR_DIALOG);
3347   return null;
3348 }
3349
3350
3351 function get_next_id_pool($attrib) {
3352   global $config;
3353
3354   /* Fill informational values */
3355   $min= $config->get_cfg_value("core","${attrib}PoolMin");
3356   $max= $config->get_cfg_value("core","${attrib}PoolMax");
3357
3358   /* Sanity check */
3359   if ($min >= $max) {
3360     msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." ".sprintf(_("%sPoolMin >= %sPoolMax!"), bold($attrib), bold($attrib)), ERROR_DIALOG);
3361     return null;
3362   }
3363
3364   /* ID to skip */
3365   $ldap= $config->get_ldap_link();
3366   $id= null;
3367
3368   /* Try to allocate the ID several times before failing */
3369   $tries= 3;
3370   while ($tries--) {
3371
3372     /* Look for ID map entry */
3373     $ldap->cd ($config->current['BASE']);
3374     $ldap->search ("(&(objectClass=sambaUnixIdPool)($attrib=*))", array("$attrib"));
3375
3376     /* If it does not exist, create one with these defaults */
3377     if ($ldap->count() == 0) {
3378       /* Fill informational values */
3379       $minUserId= $config->get_cfg_value("core","uidNumberPoolMin");
3380       $minGroupId= $config->get_cfg_value("core","gidNumberPoolMin");
3381
3382       /* Add as default */
3383       $attrs= array("objectClass" => array("organizationalUnit", "sambaUnixIdPool"));
3384       $attrs["ou"]= "idmap";
3385       $attrs["uidNumber"]= $minUserId;
3386       $attrs["gidNumber"]= $minGroupId;
3387       $ldap->cd("ou=idmap,".$config->current['BASE']);
3388       $ldap->add($attrs);
3389       if ($ldap->error != "Success") {
3390         msg_dialog::display(_("Error"), _("Cannot create sambaUnixIdPool entry!"), ERROR_DIALOG);
3391         return null;
3392       }
3393       $tries++;
3394       continue;
3395     }
3396     /* Bail out if it's not unique */
3397     if ($ldap->count() != 1) {
3398       msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("sambaUnixIdPool is not unique!"), ERROR_DIALOG);
3399       return null;
3400     }
3401
3402     /* Store old attrib and generate new */
3403     $attrs= $ldap->fetch();
3404     $dn= $ldap->getDN();
3405     $oldAttr= $attrs[$attrib][0];
3406     $newAttr= $oldAttr + 1;
3407
3408     /* Sanity check */
3409     if ($newAttr >= $max) {
3410       msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("no ID available!"), ERROR_DIALOG);
3411       return null;
3412     }
3413     if ($newAttr < $min) {
3414       msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("no ID available!"), ERROR_DIALOG);
3415       return null;
3416     }
3417
3418     #FIXME: PHP is not able to do a modification of "del: .../add: ...", so this
3419     #       is completely unsafe in the moment.
3420     #/* Remove old attr, add new attr */
3421     #$attrs= array($attrib => $oldAttr);
3422     #$ldap->rm($attrs, $dn);
3423     #if ($ldap->error != "Success") {
3424     #  continue;
3425     #}
3426     $ldap->cd($dn);
3427     $ldap->modify(array($attrib => $newAttr));
3428     if ($ldap->error != "Success") {
3429       msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." ".$ldap->get_error(), ERROR_DIALOG);
3430       return null;
3431     } else {
3432       return $oldAttr;
3433     }
3434   }
3435
3436   /* Bail out if we had problems getting the next id */
3437   if (!$tries) {
3438     msg_dialog::display(_("Error"), _("Cannot allocate free ID:")." "._("maximum number of tries exceeded!"), ERROR_DIALOG);
3439   }
3440
3441   return $id;
3442 }
3443
3444
3445 function get_next_id_traditional($attrib, $dn)
3446 {
3447   global $config;
3448
3449   $ids= array();
3450   $ldap= $config->get_ldap_link();
3451
3452   $ldap->cd ($config->current['BASE']);
3453   if (preg_match('/gidNumber/i', $attrib)){
3454     $oc= "posixGroup";
3455   } else {
3456     $oc= "posixAccount";
3457   }
3458   $ldap->search ("(&(objectClass=$oc)($attrib=*))", array("$attrib"));
3459
3460   /* Get list of ids */
3461   while ($attrs= $ldap->fetch()){
3462     $ids[]= (int)$attrs["$attrib"][0];
3463   }
3464
3465   /* Add the nobody id */
3466   $ids[]= 65534;
3467
3468   /* get the ranges */
3469   $tmp = array('0'=> 1000);
3470   if (preg_match('/posixAccount/', $oc) && $config->get_cfg_value("core","uidNumberBase") != ""){
3471     $tmp= explode('-',$config->get_cfg_value("core","uidNumberBase"));
3472   } elseif($config->get_cfg_value("core","gidNumberBase") != ""){
3473     $tmp= explode('-',$config->get_cfg_value("core","gidNumberBase"));
3474   }
3475
3476   /* Set hwm to max if not set - for backward compatibility */
3477   $lwm= $tmp[0];
3478   if (isset($tmp[1])){
3479     $hwm= $tmp[1];
3480   } else {
3481     $hwm= pow(2,32);
3482   }
3483   /* Find out next free id near to UID_BASE */
3484   if ($config->get_cfg_value("core","baseIdHook") == ""){
3485     $base= $lwm;
3486   } else {
3487     /* Call base hook */
3488     $base= get_base_from_hook($dn, $attrib);
3489   }
3490   for ($id= $base; $id++; $id < pow(2,32)){
3491     if (!in_array($id, $ids)){
3492       return ($id);
3493     }
3494   }
3495
3496   /* Should not happen */
3497   if ($id == $hwm){
3498     msg_dialog::display(_("Error"), _("Cannot allocate free ID!"), ERROR_DIALOG);
3499     exit;
3500   }
3501 }
3502
3503
3504 /* Mark the occurance of a string with a span */
3505 function mark($needle, $haystack, $ignorecase= true)
3506 {
3507   $result= "";
3508
3509   while (preg_match('/^(.*)('.preg_quote($needle).')(.*)$/i', $haystack, $matches)) {
3510     $result.= $matches[1]."<span class='mark'>".$matches[2]."</span>";
3511     $haystack= $matches[3];
3512   }
3513
3514   return $result.$haystack;
3515 }
3516
3517
3518 /* Return an image description using the path */
3519 function image($path, $action= "", $title= "", $align= "middle")
3520 {
3521   global $config;
3522   global $BASE_DIR;
3523   $label= null;
3524
3525   // Bail out, if there's no style file
3526   if(!session::global_is_set("img-styles")){
3527
3528     // Get theme
3529     if (isset ($config)){
3530       $theme= $config->get_cfg_value("core","theme");
3531     } else {
3532
3533       // Fall back to default theme
3534       $theme= "default";
3535     }
3536
3537     if (!file_exists("$BASE_DIR/ihtml/themes/$theme/img.styles")){
3538       die ("No img.style for this theme found!");
3539     }
3540
3541     session::global_set('img-styles', unserialize(file_get_contents("$BASE_DIR/ihtml/themes/$theme/img.styles")));
3542   }
3543   $styles= session::global_get('img-styles');
3544
3545   /* Extract labels from path */
3546   if (preg_match("/\.png\[(.*)\]$/", $path, $matches)) {
3547     $label= $matches[1];
3548   }
3549
3550   $lbl= "";
3551   if ($label) {
3552     if (isset($styles["images/label-".$label.".png"])) {
3553       $lbl= "<div style='".$styles["images/label-".$label.".png"]."'></div>";
3554     } else {
3555       die("Invalid label specified: $label\n");
3556     }
3557
3558     $path= preg_replace("/\[.*\]$/", "", $path);
3559   }
3560
3561   // Non middle layout?
3562   if ($align == "middle") {
3563     $align= "";
3564   } else {
3565     $align= ";vertical-align:$align";
3566   }
3567
3568   // Clickable image or not?
3569   if ($title != "") {
3570     $title= "title='$title'";
3571   }
3572   if ($action == "") {
3573     return "<div class='img' $title style='".$styles[$path]."$align'>$lbl</div>";
3574   } else {
3575     return "<input type='submit' class='img' id='$action' value='' name='$action' $title style='".$styles[$path]."$align'>";
3576   }
3577 }
3578
3579 /*! \brief    Encodes a complex string to be useable in HTML posts.
3580  */
3581 function postEncode($str)
3582 {
3583   return(preg_replace("/=/","_", base64_encode($str)));
3584 }
3585
3586 /*! \brief    Decodes a string encoded by postEncode
3587  */
3588 function postDecode($str)
3589 {
3590   return(base64_decode(preg_replace("/_/","=", $str)));
3591 }
3592
3593
3594 /*! \brief    Generate styled output
3595  */
3596 function bold($str)
3597 {
3598   return "<span class='highlight'>$str</span>";
3599 }
3600
3601
3602
3603 /*! \brief  Detect the special character handling for the currently used ldap database.
3604  *          For example some convert , to \2C or " to \22.
3605  *
3606  *  @param      Config  The GOsa configuration object.
3607  *  @return     Array   An array containing a character mapping the use.
3608  */
3609 function detectLdapSpecialCharHandling()
3610 {
3611     // The list of chars to test for
3612     global $config;
3613     if(!$config) return(NULL);
3614
3615     // In the DN we've to use escaped characters, but the object name (o)
3616     //  has the be un-escaped.
3617     $name = 'GOsaLdapEncoding_,_"_(_)_+_/';
3618     $dnName = 'GOsaLdapEncoding_\,_\"_(_)_\+_/';
3619
3620     // Prapare name to be useable in filters
3621     $fixed= normalizeLdap(str_replace('\\\\', '\\\\\\', $name));
3622     $filterName = str_replace('\\,', '\\\\,', $fixed);
3623
3624     // Create the target dn
3625     $oDN = "o={$dnName},".$config->current['BASE'];
3626
3627     // Get ldap connection and check if we've already created the character
3628     //  detection object.
3629     $ldapCID = ldap_connect($config->current['SERVER']);
3630     ldap_set_option($ldapCID, LDAP_OPT_PROTOCOL_VERSION, 3);
3631     ldap_bind($ldapCID, $config->current['ADMINDN'],$config->current['ADMINPASSWORD']);
3632     $res = ldap_list($ldapCID, $config->current['BASE'],
3633             "(&(o=".$filterName.")(objectClass=organization))",
3634             array('dn'));
3635
3636     // If we haven't created the character-detection object, then create it now.
3637     $cnt = ldap_count_entries($ldapCID, $res);
3638     if(!$cnt){
3639         $obj = array();
3640         $obj['objectClass'] = array('top','organization');
3641         $obj['o'] = $name;
3642         $obj['description'] = 'GOsa character encoding test-object.';
3643         if(!@ldap_add($ldapCID, $oDN, $obj)){
3644             trigger_error("GOsa couldn't detect the special character handling used by your ldap!");
3645             return(NULL);
3646         }
3647     }
3648
3649     // Read the character-handling detection entry from the ldap.
3650     $res = ldap_list($ldapCID, $config->current['BASE'],
3651             "(&(o=".$filterName.")(objectClass=organization))",
3652             array('dn','o'));
3653     $cnt = ldap_count_entries($ldapCID, $res);
3654     if($cnt != 1 || !$res){
3655         trigger_error("GOsa couldn't detect the special character handling used by your ldap!");
3656         return(NULL);
3657     }else{
3658
3659         // Get the character handling entry from the ldap and check how the
3660         //  values were written. Compare them with what
3661         //  we've initially intended to write and create a mapping out
3662         //  of the results.
3663         $re = ldap_first_entry($ldapCID, $res);
3664         $attrs = ldap_get_attributes($ldapCID, $re);
3665
3666         // Extract the interessting characters out of the dn and the
3667         //  initially used $name for the entry.
3668         $mapDNstr = preg_replace("/^o=GOsaLdapEncoding_([^,]*),.*$/","\\1", trim(ldap_get_dn($ldapCID, $re)));
3669         $mapDN = preg_split("/_/", $mapDNstr,0, PREG_SPLIT_NO_EMPTY);
3670
3671         $mapNameStr = preg_replace("/^GOsaLdapEncoding_/","",$dnName);
3672         $mapName = preg_split("/_/", $mapNameStr,0, PREG_SPLIT_NO_EMPTY);
3673
3674         // Create a mapping out of the results.
3675         $map = array();
3676         foreach($mapName as $key => $entry){
3677             $map[$entry] = $mapDN[$key];
3678         }
3679         return($map);
3680     }
3681     return(NULL);
3682 }
3683
3684
3685 /*! \brief  Replaces placeholder in a given string.
3686  *          For example:
3687  *            '%uid@gonicus.de'         Replaces '%uid' with 'uid'.
3688  *            '{%uid[0]@gonicus.de}'    Replaces '%uid[0]' with the first char of 'uid'.
3689  *            '%uid[2-4]@gonicus.de'    Replaces '%uid[2-4]' with three chars from 'uid' starting from the second.
3690  *
3691  *          The surrounding {} in example 2 are optional.
3692  *
3693  *  @param  String  The string to perform the action on.
3694  *  @param  Array   An array of replacements.
3695  *  @return     The resulting string.
3696  */
3697 function fillReplacements($str, $attrs, $shellArg = FALSE, $default = "")
3698 {
3699     // Search for '{%...[n-m]}
3700     // Get all matching parts of the given string and sort them by
3701     //  length, to avoid replacing strings like '%uidNumber' with 'uid'
3702     //  instead of 'uidNumber'; The longest tring at first.
3703     preg_match_all('/(\{?%([a-z0-9]+)(\[(([0-9]+)(\-([0-9]+))?)\])?\}?)/i', $str ,$matches, PREG_SET_ORDER);
3704     $hits = array();
3705     foreach($matches as $match){
3706         $hits[strlen($match[2]).$match[0]] = $match;
3707     }
3708     krsort($hits);
3709
3710     // Replace the placeholder in the given string now.
3711     foreach($hits as $match){
3712
3713         // Avoid errors about undefined index.
3714         $name = $match[2];
3715         if(!isset($attrs[$name])) $attrs[$name] = $default;
3716
3717         // Calculate the replacement
3718         $start = (isset($match[5])) ? $match[5] : 0;
3719         $end = strlen($attrs[$name]);
3720         if(isset($match[5]) && !isset($match[7])){
3721             $end = 1;
3722         }elseif(isset($match[5]) && isset($match[7])){
3723             $end = ($match[7]-$start+1);
3724         }
3725         $value  = substr($attrs[$name], $start, $end);
3726
3727         // Use values which are valid for shell execution?
3728         if($shellArg) $value = escapeshellarg($value);
3729
3730         // Replace the placeholder within the string.
3731         $str = preg_replace("/".preg_quote($match[0],'/')."/", $value, $str);
3732     }
3733     return($str);
3734 }
3735
3736
3737 /*! \brief Generate a list of uid proposals based on a rule
3738  *
3739  *  Unroll given rule string by filling in attributes and replacing
3740  *  all keywords.
3741  *
3742  * \param string 'rule' The rule string from gosa.conf.
3743  * \param array 'attributes' A dictionary of attribute/value mappings
3744  * \return array List of valid not used uids
3745  */
3746 function gen_uids($rule, $attributes)
3747 {
3748     global $config;
3749     $ldap = $config->get_ldap_link();
3750     $ldap->cd($config->current['BASE']);
3751
3752
3753     // Strip out non ascii chars
3754     foreach($attributes as $name => $value){
3755         $value = iconv('UTF-8', 'US-ASCII//TRANSLIT', $value);
3756         $value = preg_replace('/[^(\x20-\x7F)]*/','',$value);
3757         $attributes[$name] = strtolower($value);
3758     }
3759
3760     // Search for '{%...[n-m]}
3761     // Get all matching parts of the given string and sort them by
3762     //  length, to avoid replacing strings like '%uidNumber' with 'uid'
3763     //  instead of 'uidNumber'; The longest tring at first.
3764     preg_match_all('/(\{?%([a-z0-9]+)(\[(([0-9]+)(\-([0-9]+))?)\])?\}?)/i', $rule ,$matches, PREG_SET_ORDER);
3765     $replacements = array();
3766     foreach($matches as $match){
3767
3768         // No start position given, then add the complete value
3769         if(!isset($match[5])){
3770             $replacements[$match[0]][] = $attributes[$match[2]];
3771
3772         // Start given but no end, so just add a simple character
3773         }elseif(!isset($match[7])){
3774             if(isset($attributes[$match[2]][$match[5]])){
3775                 $replacements[$match[0]][] = $attributes[$match[2]][$match[5]];
3776             }
3777
3778         // Add all values in range
3779         }else{
3780             $str = "";
3781             for($i=$match[5]; $i<= $match[7]; $i++){
3782                 if(isset($attributes[$match[2]][$i])){
3783                     $str .= $attributes[$match[2]][$i];
3784                     $replacements[$match[0]][] = $str;
3785                 }
3786             }
3787         }
3788     }
3789
3790     // Create proposal array
3791     $rules = array($rule);
3792     foreach($replacements as $tag => $values){
3793         $rules = gen_uid_proposals($rules, $tag,$values);
3794     }
3795
3796
3797     // Search for id tags {id:3} / {id#3}
3798     preg_match_all('/\{id(#|:)([0-9])+\}/i', $rule ,$matches, PREG_SET_ORDER);
3799     $idReplacements = array();
3800     foreach($matches as $match){
3801         if(count($match) != 3) continue;
3802
3803         // Generate random number
3804         if($match[1] == '#'){
3805             foreach($rules as $id => $ruleStr){
3806                 $genID = rand(pow(10,$match[2] -1),pow(10, ($match[2])) - 1);
3807                 $rules[$id] = preg_replace("/".preg_quote($match[0],'/')."/", $genID,$ruleStr);
3808             }
3809         }
3810
3811         // Search for next free id
3812         if($match[1] == ':'){
3813
3814             // Walk through rules and replace all occurences of {id:..}
3815             foreach($rules as $id => $ruleStr){
3816                 $genID = 0;
3817                 $start = TRUE;
3818                 while($start || $ldap->count()){
3819                     $start = FALSE;
3820                     $number= sprintf("%0".$match[2]."d", $genID);
3821                     $testRule = preg_replace("/".preg_quote($match[0],'/')."/",$number,$ruleStr);
3822                     $ldap->search('uid='.normalizeLdap($testRule));
3823                     $genID ++;
3824                 }
3825                 $rules[$id] = preg_replace("/".preg_quote($match[0],'/')."/",$number,$ruleStr);
3826             }
3827         }
3828     }
3829
3830     // Create result set by checking which uid is already used and which is free.
3831     $ret = array();
3832     foreach($rules as $rule){
3833         $ldap->search('uid='.normalizeLdap($rule));
3834         if(!$ldap->count()){
3835             $ret[] =  $rule;
3836         }
3837     }
3838
3839     return($ret);
3840 }
3841
3842
3843 function gen_uid_proposals(&$rules, $tag, $values)
3844 {
3845     $newRules = array();
3846     foreach($rules as $rule){
3847         foreach($values as $value){
3848             $newRules[] = preg_replace("/".preg_quote($tag,'/')."/", $value, $rule);
3849         }
3850     }
3851     return($newRules);
3852 }
3853
3854
3855 function gen_uuid()
3856 {
3857     return sprintf( '%04x%04x-%04x-%04x-%04x-%04x%04x%04x',
3858         // 32 bits for "time_low"
3859         mt_rand( 0, 0xffff ), mt_rand( 0, 0xffff ),
3860
3861         // 16 bits for "time_mid"
3862         mt_rand( 0, 0xffff ),
3863
3864         // 16 bits for "time_hi_and_version",
3865         // four most significant bits holds version number 4
3866         mt_rand( 0, 0x0fff ) | 0x4000,
3867
3868         // 16 bits, 8 bits for "clk_seq_hi_res",
3869         // 8 bits for "clk_seq_low",
3870         // two most significant bits holds zero and one for variant DCE1.1
3871         mt_rand( 0, 0x3fff ) | 0x8000,
3872
3873         // 48 bits for "node"
3874         mt_rand( 0, 0xffff ), mt_rand( 0, 0xffff ), mt_rand( 0, 0xffff )
3875     );
3876 }
3877
3878 function gosa_file_name($filename)
3879 {
3880     $tempfile = tempnam(sys_get_temp_dir(), 'GOsa');
3881     if(move_uploaded_file($filename, $tempfile)){
3882        return( $tempfile);
3883     }
3884 }
3885
3886 function gosa_file($filename)
3887 {
3888     $tempfile = tempnam(sys_get_temp_dir(), 'GOsa');
3889     if(move_uploaded_file($filename, $tempfile)){
3890        return file( $tempfile );
3891     }
3892 }
3893
3894 function gosa_fopen($filename, $mode)
3895 {
3896     $tempfile = tempnam(sys_get_temp_dir(), 'GOsa');
3897     if(move_uploaded_file($filename, $tempfile)){
3898        return fopen( $tempfile, $mode );
3899     }
3900 }
3901
3902 // vim:tabstop=2:expandtab:shiftwidth=2:filetype=php:syntax:ruler:
3903 ?>