Diff for /loncom/auth/lonauth.pm between versions 1.101.8.6 and 1.145

version 1.101.8.6, 2011/06/10 01:30:33 version 1.145, 2017/08/08 17:01:25
Line 1 Line 1
 # The LearningOnline Network  # The LearningOnline Network
 # User Authentication Module  # User Authentication Module
 #  #
 # $Id$  # $Id$
 #  #
 # Copyright Michigan State University Board of Trustees  # Copyright Michigan State University Board of Trustees
 #  #
 # This file is part of the LearningOnline Network with CAPA (LON-CAPA).  # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
 #  #
 # LON-CAPA is free software; you can redistribute it and/or modify  # LON-CAPA is free software; you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by  # it under the terms of the GNU General Public License as published by
 # the Free Software Foundation; either version 2 of the License, or  # the Free Software Foundation; either version 2 of the License, or
 # (at your option) any later version.  # (at your option) any later version.
 #  #
 # LON-CAPA is distributed in the hope that it will be useful,  # LON-CAPA is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of  # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the  # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.  # GNU General Public License for more details.
 #  #
 # You should have received a copy of the GNU General Public License  # You should have received a copy of the GNU General Public License
 # along with LON-CAPA; if not, write to the Free Software  # along with LON-CAPA; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA  # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 #  #
 # /home/httpd/html/adm/gpl.txt  # /home/httpd/html/adm/gpl.txt
 #  #
 # http://www.lon-capa.org/  # http://www.lon-capa.org/
 #  #
   
 package Apache::lonauth;  package Apache::lonauth;
   
 use strict;  use strict;
 use LONCAPA;  use LONCAPA qw(:DEFAULT :match);
 use Apache::Constants qw(:common);  use Apache::Constants qw(:common);
 use CGI qw(:standard);  use CGI qw(:standard);
 use DynaLoader; # for Crypt::DES version  use Apache::loncommon();
 use Crypt::DES;  use Apache::lonnet;
 use Apache::loncommon();  use Apache::lonmenu();
 use Apache::lonnet;  use Apache::createaccount;
 use Apache::lonmenu();  use Fcntl qw(:flock);
 use Apache::createaccount;  use Apache::lonlocal;
 use Fcntl qw(:flock);  use Apache::File();
 use Apache::lonlocal;  use HTML::Entities;
 use HTML::Entities;  use Digest::MD5;
     
 # ------------------------------------------------------------ Successful login  # ------------------------------------------------------------ Successful login
 sub success {  sub success {
     my ($r, $username, $domain, $authhost, $lowerurl, $extra_env,      my ($r, $username, $domain, $authhost, $lowerurl, $extra_env,
  $form) = @_;   $form) = @_;
   
 # ------------------------------------------------------------ Get cookie ready  # ------------------------------------------------------------ Get cookie ready
     my $cookie =      my $cookie =
  &Apache::loncommon::init_user_environment($r, $username, $domain,   &Apache::loncommon::init_user_environment($r, $username, $domain,
   $authhost, $form,    $authhost, $form,
   {'extra_env' => $extra_env,});    {'extra_env' => $extra_env,});
   
     my $public=($username eq 'public' && $domain eq 'public');      my $public=($username eq 'public' && $domain eq 'public');
   
     if ($public or $lowerurl eq 'noredirect') { return $cookie; }      if ($public or $lowerurl eq 'noredirect') { return $cookie; }
   
 # -------------------------------------------------------------------- Log this  # -------------------------------------------------------------------- Log this
   
     &Apache::lonnet::log($domain,$username,$authhost,      &Apache::lonnet::log($domain,$username,$authhost,
                          "Login $ENV{'REMOTE_ADDR'}");                           "Login $ENV{'REMOTE_ADDR'}");
   
 # ------------------------------------------------- Check for critical messages  # ------------------------------------------------- Check for critical messages
   
     my @what=&Apache::lonnet::dump('critical',$domain,$username);      my @what=&Apache::lonnet::dump('critical',$domain,$username);
     if ($what[0]) {      if ($what[0]) {
  if (($what[0] ne 'con_lost') && ($what[0]!~/^error\:/)) {   if (($what[0] ne 'con_lost') && ($what[0]!~/^error\:/)) {
     $lowerurl='/adm/email?critical=display';      $lowerurl='/adm/email?critical=display';
         }          }
     }      }
   
 # ------------------------------------------------------------ Get cookie ready  # ----------------------------------------------------------- Get cookies ready
     $cookie="lonID=$cookie; path=/";      my ($securecookie,$defaultcookie);
 # -------------------------------------------------------- Menu script and info      if ($ENV{'SERVER_PORT'} == 443) {
     my $destination = $lowerurl;          $securecookie="lonID=$cookie; path=/; HttpOnly; secure";
           my $lonidsdir=$r->dir_config('lonIDsDir');
     if (defined($form->{role})) {          if (($lonidsdir) && (-e "$lonidsdir/$cookie.id")) {
         my $envkey = 'user.role.'.$form->{role};              my $linkname=substr(Digest::MD5::md5_hex(Digest::MD5::md5_hex(time(). {}. rand(). $$)), 0, 32).'_linked';
         my $now=time;              if (-e "$lonidsdir/$linkname.id") {
         my $then=$env{'user.login.time'};                  unlink("$lonidsdir/$linkname.id");
         my $refresh=$env{'user.refresh.time'};              }
         if (exists($env{$envkey})) {              my $made_symlink = eval { symlink("$lonidsdir/$cookie.id",
             my ($role,$where,$trolecode,$tstart,$tend,$tremark,$tstatus);                                                "$lonidsdir/$linkname.id"); 1 };
             &Apache::lonnet::role_status($envkey,$then,$refresh,$now,\$role,\$where,              if ($made_symlink) {
                                          \$trolecode,\$tstatus,\$tstart,\$tend);                  $defaultcookie = "lonLinkID=$linkname; path=/; HttpOnly;";
             if ($tstatus eq 'is') {                  &Apache::lonnet::appenv({'user.linkedenv' => "$lonidsdir/$linkname.id"});
                 $destination  .= ($destination =~ /\?/) ? '&' : '?';              }
                 my $newrole = &HTML::Entities::encode($form->{role},'"<>&');          }
                 $destination .= 'selectrole=1&'.$newrole.'=1';      } else {
             }          $defaultcookie = "lonID=$cookie; path=/; HttpOnly;";
         }      }
     }  # -------------------------------------------------------- Menu script and info
     if (defined($form->{symb})) {      my $destination = $lowerurl;
         my $destsymb = $form->{symb};  
         $destination  .= ($destination =~ /\?/) ? '&' : '?';      if (defined($form->{role})) {
         if ($destsymb =~ /___/) {          my $envkey = 'user.role.'.$form->{role};
             # FIXME Need to deal with encrypted symbs and urls as needed.          my $now=time;
             my ($map,$resid,$desturl)=split(/___/,$destsymb);          my $then=$env{'user.login.time'};
             unless ($desturl=~/^(adm|uploaded|editupload|public)/) {          my $refresh=$env{'user.refresh.time'};
                 $desturl = &Apache::lonnet::clutter($desturl);          my $update=$env{'user.update.time'};
             }          if (!$update) {
             $desturl = &HTML::Entities::encode($desturl,'"<>&');              $update = $then;
             $destsymb = &HTML::Entities::encode($destsymb,'"<>&');          }
             $destination .= '&destinationurl='.$desturl.          if (exists($env{$envkey})) {
                             '&destsymb='.$destsymb;              my ($role,$where,$trolecode,$tstart,$tend,$tremark,$tstatus);
         } else {              &Apache::lonnet::role_status($envkey,$update,$refresh,$now,\$role,\$where,
             $destsymb = &HTML::Entities::encode($destsymb,'"<>&');                                           \$trolecode,\$tstatus,\$tstart,\$tend);
             $destination .= '&destinationurl='.$destsymb;              if ($tstatus eq 'is') {
         }                  $destination  .= ($destination =~ /\?/) ? '&' : '?';
     }                  my $newrole = &HTML::Entities::encode($form->{role},'"<>&');
                   $destination .= 'selectrole=1&'.$newrole.'=1';
     my $windowinfo=&Apache::lonmenu::open($env{'browser.os'});              }
     my $startupremote=&Apache::lonmenu::startupremote($destination);          }
     my $remoteinfo=&Apache::lonmenu::load_remote_msg($lowerurl);      }
     my $setflags=&Apache::lonmenu::setflags();      if (defined($form->{symb})) {
     my $maincall=&Apache::lonmenu::maincall();          my $destsymb = $form->{symb};
     my $brcrum = [{'href' => '',          $destination  .= ($destination =~ /\?/) ? '&' : '?';
                    'text' => 'Successful Login'},];          if ($destsymb =~ /___/) {
     my $start_page=&Apache::loncommon::start_page('Successful Login',              # FIXME Need to deal with encrypted symbs and urls as needed.
                                                   $startupremote,              my ($map,$resid,$desturl)=split(/___/,$destsymb);
                                                   {'no_inline_link' => 1,              $desturl = &Apache::lonnet::clutter($desturl);
                                                    'bread_crumbs' => $brcrum,});              $desturl = &HTML::Entities::encode($desturl,'"<>&');
     my $end_page  =&Apache::loncommon::end_page();              $destsymb = &HTML::Entities::encode($destsymb,'"<>&');
               $destination .= 'destinationurl='.$desturl.
     my $continuelink;                              '&destsymb='.$destsymb;
     if ($env{'environment.remote'} eq 'off') {          } else {
  $continuelink='<a href="'.$destination.'">'.&mt('Continue').'</a>';              $destsymb = &HTML::Entities::encode($destsymb,'"<>&');
     }              $destination .= 'destinationurl='.$destsymb;
 # ------------------------------------------------- Output for successful login          }
       }
     &Apache::loncommon::content_type($r,'text/html');      if ($destination =~ m{^/adm/roles}) {
     $r->header_out('Set-cookie' => $cookie);          $destination  .= ($destination =~ /\?/) ? '&' : '?';
     $r->send_http_header;          $destination .= 'source=login';
       }
     my %lt=&Apache::lonlocal::texthash(  
        'wel' => 'Welcome',      my $windowinfo = Apache::lonhtmlcommon::scripttag('self.name="loncapaclient";');
        'mes' => 'Welcome to the Learning<i>Online</i> Network with CAPA. Please wait while your session is being set up.',      my $header = '<meta HTTP-EQUIV="Refresh" CONTENT="0; url='.$destination.'" />';
        'pro' => 'Login problems?',      my $brcrum = [{'href' => '',
        'log' => 'loginproblems.html',                     'text' => 'Successful Login'},];
        );      my $args = {'bread_crumbs' => $brcrum,};
     $r->print(<<ENDSUCCESS);      unless ((defined($form->{role})) || (defined($form->{symb}))) {
 $start_page          my $update=$env{'user.update.time'};
 $setflags          if (!$update) {
 $windowinfo              $update = $env{'user.login.time'};
 <h1>$lt{'wel'}</h1>          }
 $lt{'mes'}<p>          my %roles_in_env;
 <a href="/adm/$lt{'log'}">$lt{'pro'}</a></p>          my $showcount = &Apache::lonroles::roles_from_env(\%roles_in_env,$update);
 $remoteinfo          if ($showcount == 1) {
 $maincall              foreach my $rolecode (keys(%roles_in_env)) {
 $continuelink                  my ($cid) = ($rolecode =~ m{^\Quser.role.st./\E($match_domain/$match_courseid)(?:/|$)});
 $end_page                  if ($cid) {
 ENDSUCCESS                      my %coursedescription =
 }                          &Apache::lonnet::coursedescription($cid,{'one_time' => '1'});
                       if ($coursedescription{'type'} eq 'Placement') {
 # --------------------------------------------------------------- Failed login!                          $args->{'crstype'} = 'Placement';
                       }
 sub failed {                      last;
     my ($r,$message,$form) = @_;                  }
     my $start_page = &Apache::loncommon::start_page('Unsuccessful Login',undef,              }
     {'no_inline_link' => 1,});          }
     my $retry = '/adm/login?username='.$form->{'uname'}.      }
                 '&domain='.$form->{'udom'};      my $start_page=&Apache::loncommon::start_page('Successful Login',
     if (exists($form->{role})) {                                                    $header,$args);
         $retry .= '&role='.$form->{role};      my $end_page  =&Apache::loncommon::end_page();
     }  
     if (exists($form->{symb})) {   my $continuelink='<a href="'.$destination.'">'.&mt('Continue').'</a>';
         $retry .= '&symb='.$form->{symb};  # ------------------------------------------------- Output for successful login
     }  
     my $end_page   = &Apache::loncommon::end_page();      &Apache::loncommon::content_type($r,'text/html');
     &Apache::loncommon::content_type($r,'text/html');      if ($securecookie) {
     $r->send_http_header;          $r->headers_out->add('Set-cookie' => $securecookie);
     $r->print(      }
        $start_page      if ($defaultcookie) {
       .'<h1>'.&mt('Sorry ...').'</h1>'          $r->headers_out->add('Set-cookie' => $defaultcookie);
       .'<p class="LC_warning">'.&mt($message).'</p>'      }
       .'<p>'.&mt('Please [_1]log in again[_2].','<a href="'.$retry.'">','</a>')      $r->send_http_header;
       .'</p>'  
       .'<p><a href="/adm/loginproblems.html">'.&mt('Login problems?').'</a></p>'      my %lt=&Apache::lonlocal::texthash(
       .$end_page         'wel' => 'Welcome',
     );         'pro' => 'Login problems?',
  }         );
       my $loginhelp = &loginhelpdisplay($domain);
 # ------------------------------------------------------------------ Rerouting!      if ($loginhelp) {
           $loginhelp = '<p><a href="'.$loginhelp.'">'.$lt{'pro'}.'</a></p>';
 sub reroute {      }
     my ($r) = @_;  
     &Apache::loncommon::content_type($r,'text/html');      my $welcome = &mt('Welcome to the Learning[_1]Online[_2] Network with CAPA. Please wait while your session is being set up.','<i>','</i>');
     $r->send_http_header;      $r->print(<<ENDSUCCESS);
     my $msg='<h1>'.&mt('Sorry ...').'</h1>'  $start_page
            .&mt('Please [_1]log in again[_2].');  $windowinfo
     &Apache::loncommon::simple_error_page($r,'Rerouting',$msg);  <h1>$lt{'wel'}</h1>
 }  $welcome
   $loginhelp
 # ---------------------------------------------------------------- Main handler  $continuelink
   $end_page
 sub handler {  ENDSUCCESS
     my $r = shift;      return;
     my $form;  }
 # Are we re-routing?  
     if (-e '/home/httpd/html/lon-status/reroute.txt') {  # --------------------------------------------------------------- Failed login!
  &reroute($r);  
  return OK;  sub failed {
     }      my ($r,$message,$form) = @_;
       (undef,undef,undef,my $clientmathml,my $clientunicode) =
     &Apache::lonlocal::get_language_handle($r);          &Apache::loncommon::decode_user_agent();
       my $args = {};
 # -------------------------------- Prevent users from attempting to login twice      if ($clientunicode && !$clientmathml) {
     my $handle = &Apache::lonnet::check_for_valid_session($r);          $args = {'browser.unicode' => 1};
     if ($handle ne '') {      }
         my $lonidsdir=$r->dir_config('lonIDsDir');  
         if ($handle=~/^publicuser\_/) {      my $start_page = &Apache::loncommon::start_page('Unsuccessful Login',undef,$args);
 # For "public user" - remove it, we apparently really want to login      my $uname = &Apache::loncommon::cleanup_html($form->{'uname'});
             unlink($r->dir_config('lonIDsDir')."/$handle.id");      my $udom = &Apache::loncommon::cleanup_html($form->{'udom'});
         } else {      if (&Apache::lonnet::domain($udom,'description') eq '') {
 # Indeed, a valid token is found          undef($udom);
             &Apache::lonnet::transfer_profile_to_env($lonidsdir,$handle);      }
             &Apache::loncommon::content_type($r,'text/html');      my $retry = '/adm/login';
             $r->send_http_header;      if ($uname eq $form->{'uname'}) {
             my $start_page =          $retry .= '?username='.$uname;
                 &Apache::loncommon::start_page('Already logged in');      }
             my $end_page =      if ($udom) {
                 &Apache::loncommon::end_page();          $retry .= (($retry=~/\?/)?'&amp;':'?').'domain='.$udom;
             my $dest = '/adm/roles';      }
             if ($env{'form.firsturl'} ne '') {      if (exists($form->{role})) {
                 $dest = $env{'form.firsturl'};          my $role = &Apache::loncommon::cleanup_html($form->{role});
             }          if ($role ne '') {
             $r->print(              $retry .= (($retry=~/\?/)?'&amp;':'?').'role='.$role;
                $start_page          }
               .'<h1>'.&mt('You are already logged in!').'</h1>'      }
               .'<p>'.&mt('Please either [_1]continue the current session[_2] or [_3]log out[_4].'      if (exists($form->{symb})) {
                     ,'<a href="'.$dest.'">','</a>','<a href="/adm/logout">','</a>')          my $symb = &Apache::loncommon::cleanup_html($form->{symb});
               .'</p>'          if ($symb ne '') {
               .$end_page              $retry .= (($retry=~/\?/)?'&amp;':'?').'symb='.$symb;
             );          }
             return OK;      }
         }      my $end_page = &Apache::loncommon::end_page();
     }      &Apache::loncommon::content_type($r,'text/html');
       $r->send_http_header;
 # ---------------------------------------------------- No valid token, continue      my @actions =
            (&mt('Please [_1]log in again[_2].','<a href="'.$retry.'">','</a>'));
       my $loginhelp = &loginhelpdisplay($udom);
     my $buffer;      if ($loginhelp) {
     if ($r->header_in('Content-length') > 0) {          push(@actions, '<a href="'.$loginhelp.'">'.&mt('Login problems?').'</a>');
  $r->read($buffer,$r->header_in('Content-length'),0);      }
     }      #FIXME: link to helpdesk might be added here
     my %form;  
     foreach my $pair (split(/&/,$buffer)) {      $r->print(
        my ($name,$value) = split(/=/,$pair);         $start_page
        $value =~ tr/+/ /;        .'<h2>'.&mt('Sorry ...').'</h2>'
        $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;        .&Apache::lonhtmlcommon::confirm_success(&mt($message),1).'<br /><br />'
        $form{$name}=$value;        .&Apache::lonhtmlcommon::actionbox(\@actions)
     }         .$end_page
       );
     if ((!$form{'uname'}) || (!$form{'upass0'}) || (!$form{'udom'})) {   }
  &failed($r,'Username, password and domain need to be specified.',  
  \%form);  # ------------------------------------------------------------------ Rerouting!
         return OK;  
     }  sub reroute {
       my ($r) = @_;
 # split user logging in and "su"-user      &Apache::loncommon::content_type($r,'text/html');
       $r->send_http_header;
     ($form{'uname'},$form{'suname'})=split(/\:/,$form{'uname'});      my $msg='<b>'.&mt('Sorry ...').'</b><br />'
     $form{'uname'} = &LONCAPA::clean_username($form{'uname'});             .&mt('Please [_1]log in again[_2].');
     $form{'suname'}= &LONCAPA::clean_username($form{'suname'});      &Apache::loncommon::simple_error_page($r,'Rerouting',$msg,{'no_auto_mt_msg' => 1});
     $form{'udom'}  = &LONCAPA::clean_domain(  $form{'udom'});  }
   
     my $role   = $r->dir_config('lonRole');  # ---------------------------------------------------------------- Main handler
     my $domain = $r->dir_config('lonDefDomain');  
     my $prodir = $r->dir_config('lonUsersDir');  sub handler {
     my $contact_name = &mt('LON-CAPA helpdesk');      my $r = shift;
       my $londocroot = $r->dir_config('lonDocRoot');
 # ---------------------------------------- Get the information from login token  # Are we re-routing?
       if (-e "$londocroot/lon-status/reroute.txt") {
     my $tmpinfo=Apache::lonnet::reply('tmpget:'.$form{'logtoken'},   &reroute($r);
                                       $form{'serverid'});   return OK;
       }
     if (($tmpinfo=~/^error/) || ($tmpinfo eq 'con_lost')) {  
  &failed($r,'Information needed to verify your login information is missing, inaccessible or expired.',\%form);      &Apache::lonlocal::get_language_handle($r);
         return OK;  
     } else {  # -------------------------------- Prevent users from attempting to login twice
  my $reply = &Apache::lonnet::reply('tmpdel:'.$form{'logtoken'},      my $handle = &Apache::lonnet::check_for_valid_session($r);
    $form{'serverid'});      if ($handle ne '') {
         if ( $reply ne 'ok' ) {          my $lonidsdir=$r->dir_config('lonIDsDir');
             &failed($r,'Session could not be opened.',\%form);          if ($handle=~/^publicuser\_/) {
     &Apache::lonnet::logthis("ERROR got a reply of $reply when trying to contact ". $form{'serverid'}." to get login token");  # For "public user" - remove it, we apparently really want to login
     return OK;              unlink($r->dir_config('lonIDsDir')."/$handle.id");
  }          } else {
     }  # Indeed, a valid token is found
               &Apache::lonnet::transfer_profile_to_env($lonidsdir,$handle);
     if (!&Apache::lonnet::domain($form{'udom'})) {      &Apache::loncommon::content_type($r,'text/html');
         &failed($r,'The domain you provided is not a valid LON-CAPA domain.',\%form);      $r->send_http_header;
         return OK;      my $start_page =
     }          &Apache::loncommon::start_page('Already logged in');
       my $end_page =
     my ($key,$firsturl,$rolestr,$symbstr)=split(/&/,$tmpinfo);          &Apache::loncommon::end_page();
     if ($rolestr) {              my $dest = '/adm/roles';
         $rolestr = &unescape($rolestr);              if ($env{'form.firsturl'} ne '') {
     }                  $dest = $env{'form.firsturl'};
     if ($symbstr) {              }
         $symbstr= &unescape($symbstr);              $r->print(
     }                 $start_page
     if ($rolestr =~ /^role=/) {                .'<p class="LC_warning">'.&mt('You are already logged in!').'</p>'
         (undef,$form{'role'}) = split('=',$rolestr);                .'<p>'.&mt('Please either [_1]continue the current session[_2] or [_3]log out[_4].'
     }                      ,'<a href="'.$dest.'">','</a>','<a href="/adm/logout">','</a>')
     if ($symbstr =~ /^symb=/) {                 .'</p>'
         (undef,$form{'symb'}) = split('=',$symbstr);                .$end_page
     }              );
               return OK;
     my $keybin=pack("H16",$key);          }
       }
     my $cipher;  
     if ($Crypt::DES::VERSION>=2.03) {  # ---------------------------------------------------- No valid token, continue
  $cipher=new Crypt::DES $keybin;  
     }  
     else {      my $buffer;
  $cipher=new DES $keybin;      if ($r->header_in('Content-length') > 0) {
     }   $r->read($buffer,$r->header_in('Content-length'),0);
     my $upass='';      }
     for (my $i=0;$i<=2;$i++) {      my %form;
  my $chunk=      foreach my $pair (split(/&/,$buffer)) {
     $cipher->decrypt(unpack("a8",pack("H16",substr($form{'upass'.$i},0,16))));         my ($name,$value) = split(/=/,$pair);
          $value =~ tr/+/ /;
  $chunk.=         $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
     $cipher->decrypt(unpack("a8",pack("H16",substr($form{'upass'.$i},16,16))));         $form{$name}=$value;
       }
  $chunk=substr($chunk,1,ord(substr($chunk,0,1)));  
  $upass.=$chunk;      if ((!$form{'uname'}) || (!$form{'upass0'}) || (!$form{'udom'})) {
     }   &failed($r,'Username, password and domain need to be specified.',
    \%form);
 # ---------------------------------------------------------------- Authenticate          return OK;
     my @cancreate;      }
     my %domconfig = &Apache::lonnet::get_dom('configuration',['usercreation'],$form{'udom'});  
     if (ref($domconfig{'usercreation'}) eq 'HASH') {  # split user logging in and "su"-user
         if (ref($domconfig{'usercreation'}{'cancreate'}) eq 'HASH') {  
             if (ref($domconfig{'usercreation'}{'cancreate'}{'selfcreate'}) eq 'ARRAY') {      ($form{'uname'},$form{'suname'},$form{'sudom'})=split(/\:/,$form{'uname'});
                 @cancreate = @{$domconfig{'usercreation'}{'cancreate'}{'selfcreate'}};      $form{'uname'} = &LONCAPA::clean_username($form{'uname'});
             } elsif (($domconfig{'usercreation'}{'cancreate'}{'selfcreate'} ne 'none') &&       $form{'suname'}= &LONCAPA::clean_username($form{'suname'});
                      ($domconfig{'usercreation'}{'cancreate'}{'selfcreate'} ne '')) {      $form{'udom'}  = &LONCAPA::clean_domain($form{'udom'});
                 @cancreate = ($domconfig{'usercreation'}{'cancreate'}{'selfcreate'});      $form{'sudom'} = &LONCAPA::clean_domain($form{'sudom'});
             }  
         }      my $role   = $r->dir_config('lonRole');
     }      my $domain = $r->dir_config('lonDefDomain');
     my $defaultauth;      my $prodir = $r->dir_config('lonUsersDir');
     if (grep(/^login$/,@cancreate)) {      my $contact_name = &mt('LON-CAPA helpdesk');
         $defaultauth = 1;  
     }  # ---------------------------------------- Get the information from login token
     my $clientcancheckhost = 1;  
     my $authhost=Apache::lonnet::authenticate($form{'uname'},$upass,      my $tmpinfo=Apache::lonnet::reply('tmpget:'.$form{'logtoken'},
                                               $form{'udom'},$defaultauth,                                        $form{'serverid'});
                                               $clientcancheckhost);  
           if (($tmpinfo=~/^error/) || ($tmpinfo eq 'con_lost') ||
 # --------------------------------------------------------------------- Failed?          ($tmpinfo eq 'no_such_host')) {
    &failed($r,'Information needed to verify your login information is missing, inaccessible or expired.',\%form);
     if ($authhost eq 'no_host') {          return OK;
  &failed($r,'Username and/or password could not be authenticated.',      } else {
  \%form);   my $reply = &Apache::lonnet::reply('tmpdel:'.$form{'logtoken'},
         return OK;     $form{'serverid'});
     } elsif ($authhost eq 'no_account_on_host') {          if ( $reply ne 'ok' ) {
         my %domconfig =               &failed($r,'Session could not be opened.',\%form);
             &Apache::lonnet::get_dom('configuration',['usercreation'],$form{'udom'});      &Apache::lonnet::logthis("ERROR got a reply of $reply when trying to contact ". $form{'serverid'}." to get login token");
         if (grep(/^login$/,@cancreate)) {      return OK;
             my $domdesc = &Apache::lonnet::domain($form{'udom'},'description');   }
             unless (&check_can_host($r,\%form,'no_account_on_host',$domdesc)) {      }
                 return OK;       
             }      if (!&Apache::lonnet::domain($form{'udom'})) {
             my $start_page =           &failed($r,'The domain you provided is not a valid LON-CAPA domain.',\%form);
                 &Apache::loncommon::start_page('Create a user account in LON-CAPA',          return OK;
                                                '',{'no_inline_link'   => 1,});      }
             my $lonhost = $r->dir_config('lonHostID');  
             my $origmail = $Apache::lonnet::perlvar{'lonSupportEMail'};      my ($key,$firsturl,$rolestr,$symbstr,$iptokenstr)=split(/&/,$tmpinfo);
             my $contacts =       if ($rolestr) {
                 &Apache::loncommon::build_recipient_list(undef,'helpdeskmail',          $rolestr = &unescape($rolestr);
                                                         $form{'udom'},$origmail);      }
             my ($contact_email) = split(',',$contacts);       if ($symbstr) {
             my $output = &Apache::createaccount::username_check($form{'uname'},           $symbstr= &unescape($symbstr);
                                                                 $form{'udom'},$domdesc,'',      }
                                                                 $lonhost,$contact_email,$contact_name);      if ($iptokenstr) {
             &Apache::loncommon::content_type($r,'text/html');          $iptokenstr = &unescape($iptokenstr);
             $r->send_http_header;      }
             &Apache::createaccount::print_header($r,$start_page);      if ($rolestr =~ /^role=/) {
             $r->print('<h3>'.&mt('Account creation').'</h3>'.          (undef,$form{'role'}) = split('=',$rolestr);
                       &mt('Although your username and password were authenticated, you do not currently have a LON-CAPA account at this institution.').'<br />'.      }
                       $output.&Apache::loncommon::end_page());      if ($symbstr =~ /^symb=/) {
             return OK;          (undef,$form{'symb'}) = split('=',$symbstr);
         } else {      }
             &failed($r,'Although your username and password were authenticated, you do not currently have a LON-CAPA account in this domain, and you are not permitted to create one.',\%form);      if ($iptokenstr =~ /^iptoken=/) {
             return OK;          (undef,$form{'iptoken'}) = split('=',$iptokenstr);
         }      }
     }  
       my $upass = $ENV{HTTPS} ? $form{'upass0'}
     if (($firsturl eq '') ||           : &Apache::loncommon::des_decrypt($key,$form{'upass0'});
  ($firsturl=~/^\/adm\/(logout|remote)/)) {  
  $firsturl='/adm/roles';  # ---------------------------------------------------------------- Authenticate
     }  
 # --------------------------------- Are we attempting to login as somebody else?      my %domconfig = &Apache::lonnet::get_dom('configuration',['usercreation'],$form{'udom'});
     if ($form{'suname'}) {      my ($cancreate,$statustocreate) =
 # ------------ see if the original user has enough privileges to pull this stunt          &Apache::createaccount::get_creation_controls($form{'udom'},$domconfig{'usercreation'});
  if (&Apache::lonnet::privileged($form{'uname'},$form{'udom'})) {      my $defaultauth;
 # ---------------------------------------------------- see if the su-user exists      if (ref($cancreate) eq 'ARRAY') {
     unless (&Apache::lonnet::homeserver($form{'suname'},$form{'udom'})          if (grep(/^login$/,@{$cancreate})) {
  eq 'no_host') {              $defaultauth = 1;
  &Apache::lonnet::logthis(&Apache::lonnet::homeserver($form{'suname'},$form{'udom'}));          }
 # ------------------------------ see if the su-user is not too highly privileged      }
  unless (&Apache::lonnet::privileged($form{'suname'},$form{'udom'})) {      my $clientcancheckhost = 1;
 # -------------------------------------------------------- actually switch users      my $authhost=Apache::lonnet::authenticate($form{'uname'},$upass,
     &Apache::lonnet::logperm('User '.$form{'uname'}.' at '.$form{'udom'}.                                                $form{'udom'},$defaultauth,
  ' logging in as '.$form{'suname'});                                                $clientcancheckhost);
     $form{'uname'}=$form{'suname'};     
  } else {  # --------------------------------------------------------------------- Failed?
     &Apache::lonnet::logthis('Attempted switch user to privileged user');  
  }      if ($authhost eq 'no_host') {
     }   &failed($r,'Username and/or password could not be authenticated.',
  } else {   \%form);
     &Apache::lonnet::logthis('Non-privileged user attempting switch user');          return OK;
  }      } elsif ($authhost eq 'no_account_on_host') {
     }          if ($defaultauth) {
               my $domdesc = &Apache::lonnet::domain($form{'udom'},'description');
     unless (&check_can_host($r,\%form,$authhost)) {              unless (&check_can_host($r,\%form,'no_account_on_host',$domdesc)) {
         return OK;                  return OK;
     }              }
               my $start_page =
     if ($r->dir_config("lonBalancer") eq 'yes') {                  &Apache::loncommon::start_page('Create a user account in LON-CAPA');
  &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',undef,              my $lonhost = $r->dir_config('lonHostID');
  \%form);              my $origmail = $Apache::lonnet::perlvar{'lonSupportEMail'};
         my $otherserver = &Apache::lonnet::spareserver(30000,undef,1,$form{'udom'});              my $contacts =
  $r->internal_redirect('/adm/switchserver?otherserver='.$otherserver.'&origurl='.$firsturl);                  &Apache::loncommon::build_recipient_list(undef,'helpdeskmail',
         return OK;                                                          $form{'udom'},$origmail);
     } else {              my ($contact_email) = split(',',$contacts);
 # ------------------------------------------------------- Do the load balancing              my $output =
                   &Apache::createaccount::username_check($form{'uname'},$form{'udom'},
 # ---------------------------------------------------------- Determine own load                                                         $domdesc,'',$lonhost,
         my $loadlim = $r->dir_config('lonLoadLim');                                                         $contact_email,$contact_name,
         my $loadavg;                                                         undef,$statustocreate);
         {              &Apache::loncommon::content_type($r,'text/html');
             my $loadfile=Apache::File->new('/proc/loadavg');              $r->send_http_header;
             $loadavg=<$loadfile>;              &Apache::createaccount::print_header($r,$start_page);
         }              $r->print('<h3>'.&mt('Account creation').'</h3>'.
         $loadavg =~ s/\s.*//g;                        &mt('Although your username and password were authenticated, you do not currently have a LON-CAPA account at this institution.').'<br />'.
         my $loadpercent=sprintf("%.1f",100*$loadavg/$loadlim);                        $output.&Apache::loncommon::end_page());
         my $userloadpercent=&Apache::lonnet::userload();              return OK;
           } else {
 # ---------------------------------------------------------- Are we overloaded?              &failed($r,'Although your username and password were authenticated, you do not currently have a LON-CAPA account in this domain, and you are not permitted to create one.',\%form);
         if ((($userloadpercent>100.0)||($loadpercent>100.0))) {              return OK;
             my $unloaded=Apache::lonnet::spareserver($loadpercent,$userloadpercent,1,$form{'udom'});          }
             if ($unloaded) {      }
                 &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',  
                          undef,\%form);      if (($firsturl eq '') ||
                 $r->internal_redirect('/adm/switchserver?otherserver='.$unloaded.'&origurl='.$firsturl);   ($firsturl=~/^\/adm\/(logout|remote)/)) {
                 return OK;   $firsturl='/adm/roles';
             }      }
         }  
         &success($r,$form{'uname'},$form{'udom'},$authhost,$firsturl,undef,      my $hosthere;
                  \%form);      if ($form{'iptoken'}) {
         return OK;          my %sessiondata = &Apache::lonnet::tmpget($form{'iptoken'});
     }          my $delete = &Apache::lonnet::tmpdel($form{'iptoken'});
 }          if (($sessiondata{'domain'} eq $form{'udom'}) &&
               ($sessiondata{'username'} eq $form{'uname'})) {
 sub check_can_host {              $hosthere = 1;
     my ($r,$form,$authhost,$domdesc) = @_;          }
     return unless (ref($form) eq 'HASH');      }
     my $canhost = 1;  
     my $lonhost = $r->dir_config('lonHostID');  # --------------------------------- Are we attempting to login as somebody else?
     my $udom = $form->{'udom'};      if ($form{'suname'}) {
     my @intdoms;          my ($suname,$sudom,$sudomref);
     my $internet_names = &Apache::lonnet::get_internet_names($lonhost);          $suname = $form{'suname'};
     if (ref($internet_names) eq 'ARRAY') {          $sudom = $form{'udom'};
         @intdoms = @{$internet_names};          if ($form{'sudom'}) {
     }              unless ($sudom eq $form{'sudom'}) {
     my $uprimary_id = &Apache::lonnet::domain($udom,'primary');                  if (&Apache::lonnet::domain($form{'sudom'})) {
     my $uint_dom = &Apache::lonnet::internet_dom($uprimary_id);                      $sudomref = [$form{'sudom'}];
     unless ($uint_dom ne '' && grep(/^\Q$uint_dom\E$/,@intdoms)) {                      $sudom = $form{'sudom'};
         my $machine_dom = &Apache::lonnet::host_domain($lonhost);                  }
         my $hostname = &Apache::lonnet::hostname($lonhost);              }
         my $serverhomeID = &Apache::lonnet::get_server_homeID($hostname);          }
         my $serverhomedom = &Apache::lonnet::host_domain($serverhomeID);  # ------------ see if the original user has enough privileges to pull this stunt
         my %defdomdefaults = &Apache::lonnet::get_domain_defaults($serverhomedom);   if (&Apache::lonnet::privileged($form{'uname'},$form{'udom'},$sudomref)) {
         my %udomdefaults = &Apache::lonnet::get_domain_defaults($udom);  # ---------------------------------------------------- see if the su-user exists
         my $loncaparev;      unless (&Apache::lonnet::homeserver($suname,$sudom) eq 'no_host') {
         if ($authhost eq 'no_account_on_host') {   &Apache::lonnet::logthis(&Apache::lonnet::homeserver($suname,$sudom));
             $loncaparev = &Apache::lonnet::get_server_loncaparev($machine_dom);  # ------------------------------ see if the su-user is not too highly privileged
         } else {   unless (&Apache::lonnet::privileged($suname,$sudom)) {
             $loncaparev = &Apache::lonnet::get_server_loncaparev($machine_dom,$lonhost);  #
         }  # su-user's home server and user's home server must have one of:
         $canhost = &Apache::lonnet::can_host_session($udom,$lonhost,$loncaparev,  # (a) same internet dom
                                                      $udomdefaults{'remotesessions'},  # (b) same primary library server for home server's domain
                                                      $defdomdefaults{'hostedsessions'});  # (c) same "internet domain" for primary library server for home server's domain
     }  #
     unless ($canhost) {                      unless ($sudom eq $form{'udom'}) {
         if ($authhost eq 'no_account_on_host') {                          my $suprim = &Apache::lonnet::domain($sudom,'primary');
             my ($login_host,$hostname) = &Apache::lonnet::choose_server($udom);                          my $uprim = &Apache::lonnet::domain($sudom,'primary');
             &Apache::loncommon::content_type($r,'text/html');                          unless ($suprim eq $uprim) {
             $r->send_http_header;                              my $suintdom = &Apache::lonnet::internet_dom($suprim);
             if ($login_host ne '') {                              my $uintdom = &Apache::lonnet::internet_dom($uprim);
                 my $protocol = $Apache::lonnet::protocol{$login_host};                              unless ($suintdom eq $uintdom) {
                 $protocol = 'http' if ($protocol ne 'https');                                  &Apache::lonnet::logthis('Attempted switch user '
                 my $newurl = $protocol.'://'.$hostname.'/adm/createaccount';                                                           .'to privileged user');                        
                 $r->print(&Apache::loncommon::start_page('Create a user account in LON-CAPA').                              }
                           '<h3>'.&mt('Account creation').'</h3>'.                          }
                           &mt('You do not currently have a LON-CAPA account at this institution.').'<br />'.                      }
                           '<p>'.&mt('You will be able to create one by logging into a LON-CAPA server within the [_1] domain.',$domdesc).'</p>'.  
                           '<p>'.&mt('[_1]Log in[_2]','<a href="'.$newurl.'">','</a>').  # -------------------------------------------------------- actually switch users
                           &Apache::loncommon::end_page());  
             } else {      &Apache::lonnet::logperm('User '.$form{'uname'}.' at '.$form{'udom'}.
                 $r->print(&Apache::loncommon::start_page('Access to LON-CAPA unavailable').   ' logging in as '.$suname.':'.$sudom);
                           '<h3>'.&mt('Account creation unavailable').'</h3>'.      $form{'uname'}=$suname;
                           &mt('You do not currently have a LON-CAPA account at this institution.').'<br />'.                      if ($form{'udom'} ne $sudom) {
                           '<p>'.&mt('Currently a LON-CAPA server is not available within the [_1] domain for you to log-in to, to create an account.',$domdesc).'</p>'.                          $form{'udom'}=$sudom;
                           &Apache::loncommon::end_page());                      }
             }   } else {
         } else {      &Apache::lonnet::logthis('Attempted switch user to privileged user');
             &success($r,$form->{'uname'},$udom,$authhost,'noredirect',undef,   }
                      $form);      }
             my ($otherserver) = &Apache::lonnet::choose_server($udom);   } else {
             $r->internal_redirect('/adm/switchserver?otherserver='.$otherserver);      &Apache::lonnet::logthis('Non-privileged user attempting switch user');
         }   }
     }      }
     return $canhost;  
 }      my ($is_balancer,$otherserver);
   
 1;      unless ($hosthere) {
 __END__          ($is_balancer,$otherserver) =
               &Apache::lonnet::check_loadbalancing($form{'uname'},$form{'udom'},'login');
           if ($is_balancer) {
               if ($otherserver eq '') {
                   my $lowest_load;
                   ($otherserver,undef,undef,undef,$lowest_load) = &Apache::lonnet::choose_server($form{'udom'});
                   if ($lowest_load > 100) {
                       $otherserver = &Apache::lonnet::spareserver($lowest_load,$lowest_load,1,$form{'udom'});
                   }
               }
               if ($otherserver ne '') {
                   my @hosts = &Apache::lonnet::current_machine_ids();
                   if (grep(/^\Q$otherserver\E$/,@hosts)) {
                       $hosthere = $otherserver;
                   }
               }
           }
       }
   
       if (($is_balancer) && (!$hosthere)) {
           if ($otherserver) {
               &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',undef,
                        \%form);
               my $switchto = '/adm/switchserver?otherserver='.$otherserver;
               if (($firsturl) && ($firsturl ne '/adm/switchserver') && ($firsturl ne '/adm/roles')) {
                   $switchto .= '&origurl='.$firsturl;
               }
               if ($form{'role'}) {
                   $switchto .= '&role='.$form{'role'};
               }
               if ($form{'symb'}) {
                   $switchto .= '&symb='.$form{'symb'};
               }
               $r->internal_redirect($switchto);
           } else {
               $r->print(&noswitch());
           }
           return OK;
       } else {
           if (!&check_can_host($r,\%form,$authhost)) {
               my ($otherserver) = &Apache::lonnet::choose_server($form{'udom'});
               if ($otherserver) {
                   &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',undef,
                            \%form);
                   my $switchto = '/adm/switchserver?otherserver='.$otherserver;
                   if (($firsturl) && ($firsturl ne '/adm/switchserver') && ($firsturl ne '/adm/roles')) {
                       $switchto .= '&origurl='.$firsturl;
                   }
                   if ($form{'role'}) {
                       $switchto .= '&role='.$form{'role'};
                   }
                   if ($form{'symb'}) {
                       $switchto .= '&symb='.$form{'symb'};
                   }
                   $r->internal_redirect($switchto);
               } else {
                   $r->print(&noswitch());
               }
               return OK;
           }
   
   # ------------------------------------------------------- Do the load balancing
   
   # ---------------------------------------------------------- Determine own load
           my $loadlim = $r->dir_config('lonLoadLim');
           my $loadavg;
           {
               my $loadfile=Apache::File->new('/proc/loadavg');
               $loadavg=<$loadfile>;
           }
           $loadavg =~ s/\s.*//g;
           my $loadpercent=sprintf("%.1f",100*$loadavg/$loadlim);
           my $userloadpercent=&Apache::lonnet::userload();
   
   # ---------------------------------------------------------- Are we overloaded?
           if ((($userloadpercent>100.0)||($loadpercent>100.0))) {
               my $unloaded=Apache::lonnet::spareserver($loadpercent,$userloadpercent,1,$form{'udom'});
               if (!$unloaded) {
                   ($unloaded) = &Apache::lonnet::choose_server($form{'udom'});
               }
               if ($unloaded) {
                   &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',
                            undef,\%form);
                   $r->internal_redirect('/adm/switchserver?otherserver='.$unloaded.'&origurl='.$firsturl);
                   return OK;
               }
           }
           if (($is_balancer) && ($hosthere)) {
               $form{'noloadbalance'} = $hosthere;
           }
           &success($r,$form{'uname'},$form{'udom'},$authhost,$firsturl,undef,
                    \%form);
           return OK;
       }
   }
   
   sub check_can_host {
       my ($r,$form,$authhost,$domdesc) = @_;
       return unless (ref($form) eq 'HASH');
       my $canhost = 1;
       my $lonhost = $r->dir_config('lonHostID');
       my $udom = $form->{'udom'};
       my @intdoms;
       my $internet_names = &Apache::lonnet::get_internet_names($lonhost);
       if (ref($internet_names) eq 'ARRAY') {
           @intdoms = @{$internet_names};
       }
       my $uprimary_id = &Apache::lonnet::domain($udom,'primary');
       my $uint_dom = &Apache::lonnet::internet_dom($uprimary_id);
       unless ($uint_dom ne '' && grep(/^\Q$uint_dom\E$/,@intdoms)) {
           my $machine_dom = &Apache::lonnet::host_domain($lonhost);
           my $hostname = &Apache::lonnet::hostname($lonhost);
           my $serverhomeID = &Apache::lonnet::get_server_homeID($hostname);
           my $serverhomedom = &Apache::lonnet::host_domain($serverhomeID);
           my %defdomdefaults = &Apache::lonnet::get_domain_defaults($serverhomedom);
           my %udomdefaults = &Apache::lonnet::get_domain_defaults($udom);
           my $loncaparev;
           if ($authhost eq 'no_account_on_host') {
               $loncaparev = &Apache::lonnet::get_server_loncaparev($machine_dom);
           } else {
               $loncaparev = &Apache::lonnet::get_server_loncaparev($machine_dom,$lonhost);
           }
           $canhost = &Apache::lonnet::can_host_session($udom,$lonhost,$loncaparev,
                                                        $udomdefaults{'remotesessions'},
                                                        $defdomdefaults{'hostedsessions'});
       }
       unless ($canhost) {
           if ($authhost eq 'no_account_on_host') {
               my $checkloginvia = 1;
               my ($login_host,$hostname) =
                   &Apache::lonnet::choose_server($udom,$checkloginvia);
               &Apache::loncommon::content_type($r,'text/html');
               $r->send_http_header;
               if ($login_host ne '') {
                   my $protocol = $Apache::lonnet::protocol{$login_host};
                   $protocol = 'http' if ($protocol ne 'https');
                   my $newurl = $protocol.'://'.$hostname.'/adm/createaccount';
                   $r->print(&Apache::loncommon::start_page('Create a user account in LON-CAPA').
                             '<h3>'.&mt('Account creation').'</h3>'.
                             &mt('You do not currently have a LON-CAPA account at this institution.').'<br />'.
                             '<p>'.&mt('You will be able to create one by logging into a LON-CAPA server within the [_1] domain.',$domdesc).'</p>'.
                             '<p>'.&mt('[_1]Log in[_2]','<a href="'.$newurl.'">','</a>').
                             &Apache::loncommon::end_page());
               } else {
                   $r->print(&Apache::loncommon::start_page('Access to LON-CAPA unavailable').
                             '<h3>'.&mt('Account creation unavailable').'</h3>'.
                             &mt('You do not currently have a LON-CAPA account at this institution.').'<br />'.
                             '<p>'.&mt('Currently a LON-CAPA server is not available within the [_1] domain for you to log-in to, to create an account.',$domdesc).'</p>'.
                             &Apache::loncommon::end_page());
               }
           } else {
               &success($r,$form->{'uname'},$udom,$authhost,'noredirect',undef,
                        $form);
               my ($otherserver) = &Apache::lonnet::choose_server($udom);
               $r->internal_redirect('/adm/switchserver?otherserver='.$otherserver);
           }
       }
       return $canhost;
   }
   
   sub noswitch {
       my $result = &Apache::loncommon::start_page('Access to LON-CAPA unavailable').
                    '<h3>'.&mt('Session unavailable').'</h3>'.
                    &mt('This LON-CAPA server is unable to host your session.').'<br />'.
                    '<p>'.&mt('Currently no other LON-CAPA server is available to host your session either.').'</p>'.
                    &Apache::loncommon::end_page();
       return $result;
   }
   
   sub loginhelpdisplay {
       my ($authdomain) = @_;
       my $login_help = 1;
       my $lang = &Apache::lonlocal::current_language();
       if ($login_help) {
           my $dom = $authdomain;
           if ($dom eq '') {
               $dom = &Apache::lonnet::default_login_domain();
           }
           my %domconfhash = &Apache::loncommon::get_domainconf($dom);
           my $loginhelp_url;
           if ($lang) {
               $loginhelp_url = $domconfhash{$dom.'.login.helpurl_'.$lang};
               if ($loginhelp_url ne '') {
                   return $loginhelp_url;
               }
           }
           $loginhelp_url = $domconfhash{$dom.'.login.helpurl_nolang'};
           if ($loginhelp_url ne '') {
               return $loginhelp_url;
           } else {
               return '/adm/loginproblems.html';
           }
       }
       return;
   }
   
   1;
   __END__
   
   

Removed from v.1.101.8.6  
changed lines
  Added in v.1.145


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>