[BACK]Return to lonauth.pm CVS log [TXT] [DIR] Up to [LON-CAPA] / loncom / auth

Diff for /loncom/auth/lonauth.pm between versions 1.128 and 1.179

version 1.128, 2013/11/26 01:19:12 version 1.179, 2023/06/02 01:20:26
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 Apache::ltiauth;
 use Apache::createaccount;  use Fcntl qw(:flock);
 use Fcntl qw(:flock);  use Apache::lonlocal;
 use Apache::lonlocal;  use Apache::File();
 use Apache::File();  use HTML::Entities;
 use HTML::Entities;  use Digest::MD5;
    use CGI::Cookie();
 # ------------------------------------------------------------ Successful login   
 sub success {  # ------------------------------------------------------------ Successful login
     my ($r, $username, $domain, $authhost, $lowerurl, $extra_env,  sub success {
  $form) = @_;      my ($r, $username, $domain, $authhost, $lowerurl, $extra_env,
    $form,$skipcritical,$cid,$expirepub,$write_to_opener) = @_;
 # ------------------------------------------------------------ Get cookie ready  
     my $cookie =  # ------------------------------------------------------------ Get cookie ready
  &Apache::loncommon::init_user_environment($r, $username, $domain,      my $cookie =
   $authhost, $form,   &Apache::loncommon::init_user_environment($r, $username, $domain,
   {'extra_env' => $extra_env,});    $authhost, $form,
     {'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,  
                          "Login $ENV{'REMOTE_ADDR'}");      my $ip = &Apache::lonnet::get_requestor_ip();
       &Apache::lonnet::log($domain,$username,$authhost,
 # ------------------------------------------------- Check for critical messages                           "Login $ip");
   
     my @what=&Apache::lonnet::dump('critical',$domain,$username);  # ------------------------------------------------- Check for critical messages
     if ($what[0]) {  
  if (($what[0] ne 'con_lost') && ($what[0]!~/^error\:/)) {      unless ($skipcritical) {
     $lowerurl='/adm/email?critical=display';          my @what=&Apache::lonnet::dump('critical',$domain,$username);
         }          if ($what[0]) {
     }      if (($what[0] ne 'con_lost') && ($what[0]!~/^error\:/)) {
           $lowerurl='/adm/email?critical=display';
 # ------------------------------------------------------------ Get cookie ready              }
     $cookie="lonID=$cookie; path=/";          }
 # -------------------------------------------------------- Menu script and info      }
     my $destination = $lowerurl;  
   # ----------------------------------------------------------- Get cookies ready
     if (defined($form->{role})) {      my ($securecookie,$defaultcookie);
         my $envkey = 'user.role.'.$form->{role};      my $ssl = $r->subprocess_env('https');
         my $now=time;      if ($ssl) {
         my $then=$env{'user.login.time'};          $securecookie="lonSID=$cookie; path=/; HttpOnly; secure";
         my $refresh=$env{'user.refresh.time'};          my $lonidsdir=$r->dir_config('lonIDsDir');
         my $update=$env{'user.update.time'};          if (($lonidsdir) && (-e "$lonidsdir/$cookie.id")) {
         if (!$update) {              my $linkname=substr(Digest::MD5::md5_hex(Digest::MD5::md5_hex(time(). {}. rand(). $$)), 0, 32).'_linked';
             $update = $then;              if (-e "$lonidsdir/$linkname.id") {
         }                  unlink("$lonidsdir/$linkname.id");
         if (exists($env{$envkey})) {              }
             my ($role,$where,$trolecode,$tstart,$tend,$tremark,$tstatus);              my $made_symlink = eval { symlink("$lonidsdir/$cookie.id",
             &Apache::lonnet::role_status($envkey,$update,$refresh,$now,\$role,\$where,                                                "$lonidsdir/$linkname.id"); 1 };
                                          \$trolecode,\$tstatus,\$tstart,\$tend);              if ($made_symlink) {
             if ($tstatus eq 'is') {                  $defaultcookie = "lonLinkID=$linkname; path=/; HttpOnly;";
                 $destination  .= ($destination =~ /\?/) ? '&' : '?';                  &Apache::lonnet::appenv({'user.linkedenv' => $linkname});
                 my $newrole = &HTML::Entities::encode($form->{role},'"<>&');              }
                 $destination .= 'selectrole=1&'.$newrole.'=1';          }
             }      } else {
         }          $defaultcookie = "lonID=$cookie; path=/; HttpOnly;";
     }      }
     if (defined($form->{symb})) {  # -------------------------------------------------------- Menu script and info
         my $destsymb = $form->{symb};      my $destination = $lowerurl;
         $destination  .= ($destination =~ /\?/) ? '&' : '?';      if ($env{'request.lti.login'}) {
         if ($destsymb =~ /___/) {          if (($env{'request.lti.reqcrs'}) && ($env{'request.lti.reqrole'} eq 'cc')) {
             # FIXME Need to deal with encrypted symbs and urls as needed.              &Apache::loncommon::content_type($r,'text/html');
             my ($map,$resid,$desturl)=split(/___/,$destsymb);              if ($securecookie) {
             unless ($desturl=~/^(adm|editupload|public)/) {                  $r->headers_out->add('Set-cookie' => $securecookie);
                 $desturl = &Apache::lonnet::clutter($desturl);              }
             }              if ($defaultcookie) {
             $desturl = &HTML::Entities::encode($desturl,'"<>&');                  $r->headers_out->add('Set-cookie' => $defaultcookie);
             $destsymb = &HTML::Entities::encode($destsymb,'"<>&');              }
             $destination .= '&destinationurl='.$desturl.              $r->send_http_header;
                             '&destsymb='.$destsymb;              if (ref($form) eq 'HASH') {
         } else {                  $form->{'lti.login'} = $env{'request.lti.login'};
             $destsymb = &HTML::Entities::encode($destsymb,'"<>&');                  $form->{'lti.reqcrs'} = $env{'request.lti.reqcrs'};
             $destination .= '&destinationurl='.$destsymb;                  $form->{'lti.reqrole'} = $env{'request.lti.reqrole'};
         }                  $form->{'lti.sourcecrs'} = $env{'request.lti.sourcecrs'};
     }              }
     if ($destination =~ m{^/adm/roles}) {              &Apache::ltiauth::lti_reqcrs($r,$domain,$form,$username,$domain);
         $destination  .= ($destination =~ /\?/) ? '&' : '?';              return;
         $destination .= 'source=login';          }
     }          if ($env{'request.lti.selfenrollrole'}) {
               if (&Apache::ltiauth::lti_enroll($username,$domain,
     my $windowinfo = Apache::lonhtmlcommon::scripttag('self.name="loncapaclient";');                                               $env{'request.lti.selfenrollrole'}) eq 'ok') {
     my $header = '<meta HTTP-EQUIV="Refresh" CONTENT="0; url='.$destination.'" />';                  $form->{'role'} = $env{'request.lti.selfenrollrole'};
     my $brcrum = [{'href' => '',                  &Apache::lonnet::delenv('request.lti.selfenrollrole');
                    'text' => 'Successful Login'},];              } else {
     my $start_page=&Apache::loncommon::start_page('Successful Login',                  &Apache::ltiauth::invalid_request($r,24);
                                                   $header,              }
                                                   {'bread_crumbs' => $brcrum,});          }
     my $end_page  =&Apache::loncommon::end_page();      }
       if (defined($form->{role})) {
  my $continuelink='<a href="'.$destination.'">'.&mt('Continue').'</a>';          my $envkey = 'user.role.'.$form->{role};
 # ------------------------------------------------- Output for successful login          my $now=time;
           my $then=$env{'user.login.time'};
     &Apache::loncommon::content_type($r,'text/html');          my $refresh=$env{'user.refresh.time'};
     $r->header_out('Set-cookie' => $cookie);          my $update=$env{'user.update.time'};
     $r->send_http_header;          if (!$update) {
               $update = $then;
     my %lt=&Apache::lonlocal::texthash(          }
        'wel' => 'Welcome',          if (exists($env{$envkey})) {
        'pro' => 'Login problems?',              my ($role,$where,$trolecode,$tstart,$tend,$tremark,$tstatus);
        );              &Apache::lonnet::role_status($envkey,$update,$refresh,$now,\$role,\$where,
     my $loginhelp = &loginhelpdisplay($domain);                                           \$trolecode,\$tstatus,\$tstart,\$tend);
     if ($loginhelp) {              if ($tstatus eq 'is') {
         $loginhelp = '<p><a href="'.$loginhelp.'">'.$lt{'pro'}.'</a></p>';                  $destination  .= ($destination =~ /\?/) ? '&' : '?';
     }                  my $newrole = &HTML::Entities::encode($form->{role},'"<>&');
                   $destination .= 'selectrole=1&'.$newrole.'=1';
     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->print(<<ENDSUCCESS);          }
 $start_page      } elsif (defined($form->{display})) {
 $windowinfo          if ($destination =~ m{^/adm/email($|\?)}) {
 <h1>$lt{'wel'}</h1>              $destination  .= ($destination =~ /\?/) ? '&' : '?' .'display='.&escape($form->{display});
 $welcome          }
 $loginhelp      }
 $continuelink      if (defined($form->{symb})) {
 $end_page          my $destsymb = $form->{symb};
 ENDSUCCESS          my $encrypted;
 }          if ($destsymb =~ m{^/enc/}) {
               $encrypted = 1;
 # --------------------------------------------------------------- Failed login!              if ($cid) {
                   $destsymb = &Apache::lonenc::unencrypted($destsymb,$cid);
 sub failed {              }
     my ($r,$message,$form) = @_;          }
     (undef,undef,undef,my $clientmathml,my $clientunicode) =          $destination  .= ($destination =~ /\?/) ? '&' : '?';
         &Apache::loncommon::decode_user_agent();          if ($destsymb =~ /___/) {
     my $args = {};              my ($map,$resid,$desturl)=split(/___/,$destsymb);
     if ($clientunicode && !$clientmathml) {              $desturl = &Apache::lonnet::clutter($desturl);
         $args = {'browser.unicode' => 1};              if ($encrypted) {
     }                  $desturl = &Apache::lonenc::encrypted($desturl,1,$cid);
                   $destsymb = $form->{symb};
     my $start_page = &Apache::loncommon::start_page('Unsuccessful Login',undef,$args);              }
     my $uname = $form->{'uname'};              $desturl = &HTML::Entities::encode($desturl,'"<>&');
     my $udom;              $destsymb = &HTML::Entities::encode($destsymb,'"<>&');
     if (&Apache::lonnet::domain($form->{'udom'},'description') ne '') {              $destination .= 'destinationurl='.$desturl.
         $udom = $form->{'udom'};                              '&destsymb='.$destsymb;
     }            } elsif (!$encrypted) {
     my $retry = '/adm/login?username='.$form->{'uname'};              $destsymb = &HTML::Entities::encode($destsymb,'"<>&');
     if ($udom) {              $destination .= 'destinationurl='.$destsymb;
         $retry .= '&amp;domain='.$form->{'udom'}          }
     }      }
     if (exists($form->{role})) {      if ($destination =~ m{^/adm/roles}) {
         $retry .= '&amp;role='.$form->{role};          $destination  .= ($destination =~ /\?/) ? '&' : '?';
     }          $destination .= 'source=login';
     if (exists($form->{symb})) {      }
         $retry .= '&amp;symb='.$form->{symb};  
     }      my $brcrum = [{'href' => '',
     my $end_page   = &Apache::loncommon::end_page();                     'text' => 'Successful Login'},];
     &Apache::loncommon::content_type($r,'text/html');      my $args = {'no_inline_link' => 1,
     $r->send_http_header;                  'bread_crumbs' => $brcrum,};
     my $loginhelp = &loginhelpdisplay($udom);      if (($env{'request.deeplink.login'} eq $lowerurl) &&
     if ($loginhelp) {          (($env{'request.linkprot'}) || ($env{'request.linkkey'} ne ''))) {
         $loginhelp = '<p><a href="'.$loginhelp.'">'.&mt('Login problems?').'</a></p>';          my %info;
     }          if ($env{'request.linkprot'}) {
               $info{'linkprot'} = $env{'request.linkprot'};
     $r->print(              foreach my $item ('linkprotuser','linkprotexit','linkprotpbid','linkprotpburl') {
        $start_page                  if ($form->{$item}) {
       .'<h1>'.&mt('Sorry ...').'</h1>'                      $info{$item} = $form->{$item};
       .'<p class="LC_warning">'.&mt($message).'</p>'                  }
       .'<p>'.&mt('Please [_1]log in again[_2].','<a href="'.$retry.'">','</a>')              }
       .'</p>'              $args = {'only_body' => 1,};
       .$loginhelp          } elsif ($env{'request.linkkey'} ne '') {
       .$end_page              $info{'linkkey'} = $env{'request.linkkey'};
     );          }
  }          $info{'origurl'} = $lowerurl;
           my $token = &Apache::lonnet::tmpput(\%info,$r->dir_config('lonHostID'),'link');
 # ------------------------------------------------------------------ Rerouting!          unless (($token eq 'con_lost') || ($token eq 'refused') ||
                   ($token eq 'unknown_cmd') || ($token eq 'no_such_host')) {
 sub reroute {              $destination .= (($destination =~ /\?/) ? '&' : '?') . 'ttoken='.$token;
     my ($r) = @_;          }
     &Apache::loncommon::content_type($r,'text/html');      }
     $r->send_http_header;  
     my $msg='<b>'.&mt('Sorry ...').'</b><br />'      my $windowname = 'loncapaclient';
            .&mt('Please [_1]log in again[_2].');      if ($env{'request.lti.login'}) {
     &Apache::loncommon::simple_error_page($r,'Rerouting',$msg,{'no_auto_mt_msg' => 1});          $windowname .= 'lti';
 }      }
       my $windowinfo = Apache::lonhtmlcommon::scripttag('self.name="'.$windowname.'";');
 # ---------------------------------------------------------------- Main handler      unless ((defined($form->{role})) || (defined($form->{symb}))) {
           my $update=$env{'user.update.time'};
 sub handler {          if (!$update) {
     my $r = shift;              $update = $env{'user.login.time'};
     my $londocroot = $r->dir_config('lonDocRoot');          }
     my $form;          my %roles_in_env;
 # Are we re-routing?          my $showcount = &Apache::lonroles::roles_from_env(\%roles_in_env,$update);
     if (-e "$londocroot/lon-status/reroute.txt") {          if ($showcount == 1) {
  &reroute($r);              foreach my $rolecode (keys(%roles_in_env)) {
  return OK;                  my ($cid) = ($rolecode =~ m{^\Quser.role.st./\E($match_domain/$match_courseid)(?:/|$)});
     }                  if ($cid) {
                       my %coursedescription =
     &Apache::lonlocal::get_language_handle($r);                          &Apache::lonnet::coursedescription($cid,{'one_time' => '1'});
                       if ($coursedescription{'type'} eq 'Placement') {
 # -------------------------------- Prevent users from attempting to login twice                          $args->{'crstype'} = 'Placement';
     my $handle = &Apache::lonnet::check_for_valid_session($r);                      }
     if ($handle ne '') {                      last;
         my $lonidsdir=$r->dir_config('lonIDsDir');                  }
         if ($handle=~/^publicuser\_/) {              }
 # For "public user" - remove it, we apparently really want to login          }
             unlink($r->dir_config('lonIDsDir')."/$handle.id");      }
         } else {  
 # Indeed, a valid token is found  # ------------------------------------------------- Output for successful login
             &Apache::lonnet::transfer_profile_to_env($lonidsdir,$handle);  
     &Apache::loncommon::content_type($r,'text/html');      &Apache::loncommon::content_type($r,'text/html');
     $r->send_http_header;      if ($securecookie) {
     my $start_page =           $r->headers_out->add('Set-cookie' => $securecookie);
         &Apache::loncommon::start_page('Already logged in');      }
     my $end_page =       if ($defaultcookie) {
         &Apache::loncommon::end_page();          $r->headers_out->add('Set-cookie' => $defaultcookie);
             my $dest = '/adm/roles';      }
             if ($env{'form.firsturl'} ne '') {      if ($expirepub) {
                 $dest = $env{'form.firsturl'};          my $c = new CGI::Cookie(-name    => 'lonPubID',
             }                                  -value   => '',
             $r->print(                                  -expires => '-10y',);
                $start_page          $r->headers_out->add('Set-cookie' => $c);
               .'<p class="LC_warning">'.&mt('You are already logged in!').'</p>'      }
               .'<p>'.&mt('Please either [_1]continue the current session[_2] or [_3]log out[_4].'      $r->send_http_header;
                     ,'<a href="'.$dest.'">','</a>','<a href="/adm/logout">','</a>')  
               .'</p>'      my ($start_page,$js,$pagebody,$end_page);
               .$end_page      if ($env{'request.lti.login'}) {
             );          $args = {'only_body' => 1};
             return OK;          if ($env{'request.lti.target'} eq '') {
         }              my $ltitarget = (($destination =~ /\?/) ? '&' : '?').
     }                              'ltitarget=iframe';
               &js_escape(\$destination);
 # ---------------------------------------------------- No valid token, continue              $js = <<"ENDJS";
   
   <script type="text/javascript">
     my $buffer;  // <![CDATA[
     if ($r->header_in('Content-length') > 0) {  function setLTItarget() {
  $r->read($buffer,$r->header_in('Content-length'),0);      var newloc = '$destination';
     }      if (parent !== window) {
     my %form;          newloc += '$ltitarget';
     foreach my $pair (split(/&/,$buffer)) {      }
        my ($name,$value) = split(/=/,$pair);      window.location.href=newloc;
        $value =~ tr/+/ /;  }
        $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;  // ]]>
        $form{$name}=$value;  </script>
     }  
   ENDJS
     if ((!$form{'uname'}) || (!$form{'upass0'}) || (!$form{'udom'})) {              $args->{'add_entries'} = {'onload' => "javascript:setLTItarget();"};
  &failed($r,'Username, password and domain need to be specified.',              $pagebody =  '<noscript><span class="LC_warning">'
  \%form);                          .&mt('Use of LON-CAPA requires Javascript to be enabled in your web browser.')
         return OK;                          .'</span></noscript>';
     }          } else {
               $args->{'redirect'} = [0,$destination,1];
 # split user logging in and "su"-user          }
           $start_page=&Apache::loncommon::start_page('',$js,$args);
     ($form{'uname'},$form{'suname'})=split(/\:/,$form{'uname'});      } else {
     $form{'uname'} = &LONCAPA::clean_username($form{'uname'});          $args->{'redirect'} = [0,$destination,'',$write_to_opener];
     $form{'suname'}= &LONCAPA::clean_username($form{'suname'});          $start_page=&Apache::loncommon::start_page('Successful Login',
     $form{'udom'}  = &LONCAPA::clean_domain(  $form{'udom'});                                                     $js,$args);
           unless ($env{'request.linkprot'}) {
     my $role   = $r->dir_config('lonRole');              my %lt=&Apache::lonlocal::texthash(
     my $domain = $r->dir_config('lonDefDomain');                     'wel' => 'Welcome',
     my $prodir = $r->dir_config('lonUsersDir');                 'pro' => 'Login problems?',
     my $contact_name = &mt('LON-CAPA helpdesk');            );
               $pagebody = "<h1>$lt{'wel'}</h1>\n".
 # ---------------------------------------- Get the information from login token                          &mt('Welcome to the Learning[_1]Online[_2] Network with CAPA. Please wait while your session is being set up.','<i>','</i>');
               my $loginhelp = &loginhelpdisplay($domain);
     my $tmpinfo=Apache::lonnet::reply('tmpget:'.$form{'logtoken'},              if ($loginhelp) {
                                       $form{'serverid'});                  $pagebody .= '<p><a href="'.$loginhelp.'">'.$lt{'pro'}.'</a></p>';
               }
     my %sessiondata;          }
     if ($form{'iptoken'}) {      }
         %sessiondata = &Apache::lonnet::tmpget($form{'iptoken'});      $end_page = &Apache::loncommon::end_page();
         my $delete = &Apache::lonnet::tmpdel($form{'token'});      $r->print(<<ENDSUCCESS);
     }  $start_page
   $windowinfo
     if (($tmpinfo=~/^error/) || ($tmpinfo eq 'con_lost') ||   $pagebody
         ($tmpinfo eq 'no_such_host')) {  $end_page
  &failed($r,'Information needed to verify your login information is missing, inaccessible or expired.',\%form);  ENDSUCCESS
         return OK;      return;
     } else {  }
  my $reply = &Apache::lonnet::reply('tmpdel:'.$form{'logtoken'},  
    $form{'serverid'});  # --------------------------------------------------------------- Failed login!
         if ( $reply ne 'ok' ) {  
             &failed($r,'Session could not be opened.',\%form);  sub failed {
     &Apache::lonnet::logthis("ERROR got a reply of $reply when trying to contact ". $form{'serverid'}." to get login token");      my ($r,$message,$form,$authhost) = @_;
     return OK;      (undef,undef,undef,my $clientmathml,my $clientunicode) =
  }          &Apache::loncommon::decode_user_agent();
     }      my $args = {};
       if ($clientunicode && !$clientmathml) {
     if (!&Apache::lonnet::domain($form{'udom'})) {          $args = {'browser.unicode' => 1};
         &failed($r,'The domain you provided is not a valid LON-CAPA domain.',\%form);      }
         return OK;      if ($form->{firsturl} =~ m{^/tiny/$match_domain/\w+$}) {
     }          if ($form->{linkprot}) {
               $args->{only_body} = 1;
     my ($key,$firsturl,$rolestr,$symbstr)=split(/&/,$tmpinfo);          }
     if ($rolestr) {      }
         $rolestr = &unescape($rolestr);  
     }      my @actions;
     if ($symbstr) {      my $start_page = &Apache::loncommon::start_page('Unsuccessful Login',undef,$args);
         $symbstr= &unescape($symbstr);      my $uname = &Apache::loncommon::cleanup_html($form->{'uname'});
     }      my $udom = &Apache::loncommon::cleanup_html($form->{'udom'});
     if ($rolestr =~ /^role=/) {      if (&Apache::lonnet::domain($udom,'description') eq '') {
         (undef,$form{'role'}) = split('=',$rolestr);          undef($udom);
     }      }
     if ($symbstr =~ /^symb=/) {       my $authtype;
         (undef,$form{'symb'}) = split('=',$symbstr);      if (($udom ne '') && ($uname ne '') && ($authhost eq 'no_host')) {
     }          $authtype = &Apache::lonnet::queryauthenticate($uname,$udom);
       }
     my $keybin=pack("H16",$key);      my $retry = '/adm/login';
       if (($uname eq $form->{'uname'}) && ($authtype !~ /^lti:/)) {
     my $cipher;          $retry .= '?username='.$uname;
     if ($Crypt::DES::VERSION>=2.03) {      }
  $cipher=new Crypt::DES $keybin;      if ($udom) {
     }          $retry .= (($retry=~/\?/)?'&amp;':'?').'domain='.$udom;
     else {      }
  $cipher=new DES $keybin;      my $lonhost = $r->dir_config('lonHostID');
     }      my $querystr;
     my $upass='';      my $result = &set_retry_token($form,$lonhost,\$querystr);
     for (my $i=0;$i<=2;$i++) {      if ($result eq 'fail') {
  my $chunk=          if (exists($form->{role})) {
     $cipher->decrypt(unpack("a8",pack("H16",substr($form{'upass'.$i},0,16))));              my $role = &Apache::loncommon::cleanup_html($form->{role});
               if ($role ne '') {
  $chunk.=                  $retry .= (($retry=~/\?/)?'&amp;':'?').'role='.$role;
     $cipher->decrypt(unpack("a8",pack("H16",substr($form{'upass'.$i},16,16))));              }
           }
  $chunk=substr($chunk,1,ord(substr($chunk,0,1)));          if (exists($form->{symb})) {
  $upass.=$chunk;              my $symb = &Apache::loncommon::cleanup_html($form->{symb});
     }              if ($symb ne '') {
                   $retry .= (($retry=~/\?/)?'&amp;':'?').'symb='.$symb;
 # ---------------------------------------------------------------- Authenticate              }
           }
     my %domconfig = &Apache::lonnet::get_dom('configuration',['usercreation'],$form{'udom'});          if (exists($form->{firsturl})) {
     my ($cancreate,$statustocreate) =              my $firsturl = &Apache::loncommon::cleanup_html($form->{firsturl});
         &Apache::createaccount::get_creation_controls($form{'udom'},$domconfig{'usercreation'});              if ($firsturl ne '') {
     my $defaultauth;                  $retry .= (($retry=~/\?/)?'&amp;':'?').'firsturl='.$firsturl;
     if (ref($cancreate) eq 'ARRAY') {                  if ($form->{firsturl} =~ m{^/tiny/$match_domain/\w+$}) {
         if (grep(/^login$/,@{$cancreate})) {                      unless (exists($form->{linkprot})) {
             $defaultauth = 1;                          if (exists($form->{linkkey})) {
         }                              $retry .= 'linkkey='.$form->{linkkey};
     }                          }
     my $clientcancheckhost = 1;                      }
     my $authhost=Apache::lonnet::authenticate($form{'uname'},$upass,                  }
                                               $form{'udom'},$defaultauth,              }
                                               $clientcancheckhost);          }
               if (exists($form->{linkprot})) {
 # --------------------------------------------------------------------- Failed?              my %info = (
                            'linkprot' => $form->{'linkprot'},
     if ($authhost eq 'no_host') {                         );
  &failed($r,'Username and/or password could not be authenticated.',              foreach my $item ('linkprotuser','linkprotexit','linkprotpbid','linkprotpburl') {
  \%form);                  if ($form->{$item} ne '') {
         return OK;                      $info{$item} = $form->{$item};
     } elsif ($authhost eq 'no_account_on_host') {                  }
         if ($defaultauth) {              }
             my $domdesc = &Apache::lonnet::domain($form{'udom'},'description');              my $ltoken = &Apache::lonnet::tmpput(\%info,
             unless (&check_can_host($r,\%form,'no_account_on_host',$domdesc)) {                                                   $r->dir_config('lonHostID'),'retry');
                 return OK;              if ($ltoken) {
             }                  $retry .= (($retry =~ /\?/) ? '&' : '?').'ltoken='.$ltoken;
             my $start_page =               }
                 &Apache::loncommon::start_page('Create a user account in LON-CAPA');          }
             my $lonhost = $r->dir_config('lonHostID');      } elsif ($querystr ne '') {
             my $origmail = $Apache::lonnet::perlvar{'lonSupportEMail'};          $retry .= (($retry=~/\?/)?'&amp;':'?').$querystr;
             my $contacts =       }
                 &Apache::loncommon::build_recipient_list(undef,'helpdeskmail',      my $end_page = &Apache::loncommon::end_page();
                                                         $form{'udom'},$origmail);      &Apache::loncommon::content_type($r,'text/html');
             my ($contact_email) = split(',',$contacts);       $r->send_http_header;
             my $output =       if ($authtype =~ /^lti:/) {
                 &Apache::createaccount::username_check($form{'uname'},$form{'udom'},          $message = &mt('Direct login is not supported with the username you entered.').
                                                        $domdesc,'',$lonhost,                     '<br /><br />'.
                                                        $contact_email,$contact_name,                     &mt('You likely need to launch LON-CAPA from within a course in a different Learning Management System.').
                                                        undef,$statustocreate);                     '<br />'.
             &Apache::loncommon::content_type($r,'text/html');                     &mt('You can also try to log in with a different username.');
             $r->send_http_header;          @actions =
             &Apache::createaccount::print_header($r,$start_page);              (&mt('Try your [_1]log in again[_2].','<a href="'.$retry.'">','</a>'));
             $r->print('<h3>'.&mt('Account creation').'</h3>'.      } else {
                       &mt('Although your username and password were authenticated, you do not currently have a LON-CAPA account at this institution.').'<br />'.          $message = &mt($message);
                       $output.&Apache::loncommon::end_page());          @actions =
             return OK;              (&mt('Please [_1]log in again[_2].','<a href="'.$retry.'">','</a>'));
         } 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);      my $loginhelp = &loginhelpdisplay($udom);
             return OK;      if ($loginhelp) {
         }          push(@actions, '<a href="'.$loginhelp.'">'.&mt('Login problems?').'</a>');
     }      }
       #FIXME: link to helpdesk might be added here
     if (($firsturl eq '') ||       $r->print(
  ($firsturl=~/^\/adm\/(logout|remote)/)) {         $start_page
  $firsturl='/adm/roles';        .'<h2>'.&mt('Sorry ...').'</h2>'
     }        .&Apache::lonhtmlcommon::confirm_success($message,1).'<br /><br />'
         .&Apache::lonhtmlcommon::actionbox(\@actions)
     my $hosthere;        .$end_page
     if ($form{'iptoken'}) {      );
         if (($sessiondata{'domain'} eq $form{'udom'}) &&   }
             ($sessiondata{'username'} eq $form{'uname'})) {  
             $hosthere = 1;  # ------------------------------------------------------------------ Rerouting!
         }  
     }  sub reroute {
       my ($r) = @_;
 # --------------------------------- Are we attempting to login as somebody else?      &Apache::loncommon::content_type($r,'text/html');
     if ($form{'suname'}) {      $r->send_http_header;
 # ------------ see if the original user has enough privileges to pull this stunt      my $msg='<b>'.&mt('Sorry ...').'</b><br />'
  if (&Apache::lonnet::privileged($form{'uname'},$form{'udom'})) {             .&mt('Please [_1]log in again[_2].');
 # ---------------------------------------------------- see if the su-user exists      &Apache::loncommon::simple_error_page($r,'Rerouting',$msg,{'no_auto_mt_msg' => 1});
     unless (&Apache::lonnet::homeserver($form{'suname'},$form{'udom'})  }
  eq 'no_host') {  
  &Apache::lonnet::logthis(&Apache::lonnet::homeserver($form{'suname'},$form{'udom'}));  # ---------------------------------------------------------------- Main handler
 # ------------------------------ see if the su-user is not too highly privileged  
  unless (&Apache::lonnet::privileged($form{'suname'},$form{'udom'})) {  sub handler {
 # -------------------------------------------------------- actually switch users      my $r = shift;
     &Apache::lonnet::logperm('User '.$form{'uname'}.' at '.$form{'udom'}.      my $londocroot = $r->dir_config('lonDocRoot');
  ' logging in as '.$form{'suname'});  # Are we re-routing?
     $form{'uname'}=$form{'suname'};      if (-e "$londocroot/lon-status/reroute.txt") {
  } else {   &reroute($r);
     &Apache::lonnet::logthis('Attempted switch user to privileged user');   return OK;
  }      }
     }  
  } else {      &Apache::lonlocal::get_language_handle($r);
     &Apache::lonnet::logthis('Non-privileged user attempting switch user');  
  }  # -------------------------------- Prevent users from attempting to login twice
     }      my $handle = &Apache::lonnet::check_for_valid_session($r);
       if ($handle ne '') {
     my ($is_balancer,$otherserver);          my $lonidsdir=$r->dir_config('lonIDsDir');
           if ($handle=~/^publicuser\_/) {
     unless ($hosthere) {  # For "public user" - remove it, we apparently really want to login
         ($is_balancer,$otherserver) =              unlink($r->dir_config('lonIDsDir')."/$handle.id");
             &Apache::lonnet::check_loadbalancing($form{'uname'},$form{'udom'});          } else {
     }  # Indeed, a valid token is found
               &Apache::lonnet::transfer_profile_to_env($lonidsdir,$handle);
     if ($is_balancer) {      &Apache::loncommon::content_type($r,'text/html');
         if (!$otherserver) {       $r->send_http_header;
             ($otherserver) = &Apache::lonnet::choose_server($form{'udom'});      my $start_page =
         }          &Apache::loncommon::start_page('Already logged in');
         if ($otherserver) {      my $end_page =
             &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',undef,          &Apache::loncommon::end_page();
                      \%form);              my $dest = '/adm/roles';
     $r->internal_redirect('/adm/switchserver?otherserver='.$otherserver.'&origurl='.$firsturl);              my %form = &get_form_items($r);
         } else {              if ($form{'logtoken'}) {
             $r->print(&noswitch());                  my $tmpinfo = &Apache::lonnet::reply('tmpget:'.$form{'logtoken'},
         }                                                       $form{'serverid'});
         return OK;                  unless (($tmpinfo=~/^error/) || ($tmpinfo eq 'con_lost') ||
     } else {                          ($tmpinfo eq 'no_such_host')) {
         if (!&check_can_host($r,\%form,$authhost)) {                      my ($des_key,$firsturl,@rest)=split(/&/,$tmpinfo);
             my ($otherserver) = &Apache::lonnet::choose_server($form{'udom'});                      $firsturl = &unescape($firsturl);
             if ($otherserver) {                      my %info;
                 &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',undef,                      foreach my $item (@rest) {
                          \%form);                          my ($key,$value) = split(/=/,$item);
                 $r->internal_redirect('/adm/switchserver?otherserver='.$otherserver.'&origurl='.$firsturl);                          $info{$key} = &unescape($value);
             } else {                      }
                 $r->print(&noswitch());                      if ($firsturl ne '') {
             }                          $info{'firsturl'} = $firsturl;
             return OK;                          $dest = $firsturl;
         }                          my $relogin;
                           if ($dest =~ m{^/tiny/$match_domain/\w+$}) {
 # ------------------------------------------------------- Do the load balancing                              if ($env{'request.course.id'}) {
                                   my $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
 # ---------------------------------------------------------- Determine own load                                  my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
         my $loadlim = $r->dir_config('lonLoadLim');                                  my $symb = &Apache::loncommon::symb_from_tinyurl($dest,$cnum,$cdom);
         my $loadavg;                                  if ($symb) {
         {                                      unless (&set_deeplink_login(%info) eq 'ok') {
             my $loadfile=Apache::File->new('/proc/loadavg');                                          $relogin = 1;
             $loadavg=<$loadfile>;                                      }
         }                                  }
         $loadavg =~ s/\s.*//g;                              }
         my $loadpercent=sprintf("%.1f",100*$loadavg/$loadlim);                              if ($relogin) {
         my $userloadpercent=&Apache::lonnet::userload();                                  $r->print(
                                         $start_page
 # ---------------------------------------------------------- Are we overloaded?                                       .'<p class="LC_warning">'.&mt('You are already logged in!').'</p>'
         if ((($userloadpercent>100.0)||($loadpercent>100.0))) {                                       .'<p>'.&mt('Please [_1]log out[_2] first, and then try your access again',
             my $unloaded=Apache::lonnet::spareserver($loadpercent,$userloadpercent,1,$form{'udom'});                                                  '<a href="/adm/logout">','</a>')
             if (!$unloaded) {                                       .'</p>'
                 ($unloaded) = &Apache::lonnet::choose_server($form{'udom'});                                       .$end_page);
             }                              } else {
             if ($unloaded) {                                  if (($info{'linkprot'}) || ($info{'linkkey'} ne '')) {
                 &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',                                      if (($info{'linkprot'}) && ($info{'linkprotuser'} ne '')) {
                          undef,\%form);                                          unless ($info{'linkprotuser'} eq $env{'user.name'}.':'.$env{'user.domain'}) {
                 $r->internal_redirect('/adm/switchserver?otherserver='.$unloaded.'&origurl='.$firsturl);                                              $r->print(
                 return OK;                                                        $start_page
             }                                                        .'<p class="LC_warning">'.&mt('You are already logged in, but as a different user from the one expected for the link you followed from another system').'</p>'
         }                                                        .'<p>'.&mt('Please [_1]log out[_2] first, and then try following the link again from the other system',
         &success($r,$form{'uname'},$form{'udom'},$authhost,$firsturl,undef,                                                                   '<a href="/adm/logout">','</a>')
                  \%form);  
         return OK;                                                        .'</p>'
     }                                                        .$end_page);
 }                                              return OK;
                                           }
 sub check_can_host {                                      }
     my ($r,$form,$authhost,$domdesc) = @_;                                      my $token = &Apache::lonnet::tmpput(\%info,$r->dir_config('lonHostID'),'link');
     return unless (ref($form) eq 'HASH');                                      unless (($token eq 'con_lost') || ($token eq 'refused') ||
     my $canhost = 1;                                              ($token eq 'unknown_cmd') || ($token eq 'no_such_host')) {
     my $lonhost = $r->dir_config('lonHostID');                                          $dest .= (($dest =~ /\?/) ? '&' : '?') . 'ttoken='.$token;
     my $udom = $form->{'udom'};                                      }
     my @intdoms;                                  }
     my $internet_names = &Apache::lonnet::get_internet_names($lonhost);                                  $r->print(
     if (ref($internet_names) eq 'ARRAY') {                                        $start_page
         @intdoms = @{$internet_names};                                       .'<p class="LC_warning">'.&mt('You are already logged in!').'</p>'
     }                                       .'<p>'.&mt('Please either [_1]continue the current session[_2] or [_3]log out[_4] first, and then try your access again',
     my $uprimary_id = &Apache::lonnet::domain($udom,'primary');                                                  '<a href="'.$dest.'">','</a>',
     my $uint_dom = &Apache::lonnet::internet_dom($uprimary_id);                                                  '<a href="/adm/logout">','</a>')
     unless ($uint_dom ne '' && grep(/^\Q$uint_dom\E$/,@intdoms)) {                                       .'</p>'
         my $machine_dom = &Apache::lonnet::host_domain($lonhost);                                       .$end_page);
         my $hostname = &Apache::lonnet::hostname($lonhost);                              }
         my $serverhomeID = &Apache::lonnet::get_server_homeID($hostname);                              return OK;
         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') {              $r->print(
             $loncaparev = &Apache::lonnet::get_server_loncaparev($machine_dom);                    $start_page
         } else {                   .'<p class="LC_warning">'.&mt('You are already logged in!').'</p>'
             $loncaparev = &Apache::lonnet::get_server_loncaparev($machine_dom,$lonhost);                   .'<p>'.&mt('Please either [_1]continue the current session[_2] or [_3]log out[_4].'
         }                            ,'<a href="'.$dest.'">','</a>','<a href="/adm/logout">','</a>')
         $canhost = &Apache::lonnet::can_host_session($udom,$lonhost,$loncaparev,                   .'</p>'
                                                      $udomdefaults{'remotesessions'},                   .$end_page
                                                      $defdomdefaults{'hostedsessions'});              );
     }              return OK;
     unless ($canhost) {          }
         if ($authhost eq 'no_account_on_host') {      }
             my $checkloginvia = 1;  
             my ($login_host,$hostname) =   # ---------------------------------------------------- No valid token, continue
                 &Apache::lonnet::choose_server($udom,$checkloginvia);  
             &Apache::loncommon::content_type($r,'text/html');      my %form = &get_form_items($r);
             $r->send_http_header;      if ((!$form{'uname'}) || (!$form{'upass0'}) || (!$form{'udom'})) {
             if ($login_host ne '') {   &failed($r,'Username, password and domain need to be specified.',
                 my $protocol = $Apache::lonnet::protocol{$login_host};   \%form);
                 $protocol = 'http' if ($protocol ne 'https');          return OK;
                 my $newurl = $protocol.'://'.$hostname.'/adm/createaccount';      }
                 $r->print(&Apache::loncommon::start_page('Create a user account in LON-CAPA').  
                           '<h3>'.&mt('Account creation').'</h3>'.  # split user logging in and "su"-user
                           &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>'.      ($form{'uname'},$form{'suname'},$form{'sudom'})=split(/\:/,$form{'uname'});
                           '<p>'.&mt('[_1]Log in[_2]','<a href="'.$newurl.'">','</a>').      $form{'uname'} = &LONCAPA::clean_username($form{'uname'});
                           &Apache::loncommon::end_page());      $form{'suname'}= &LONCAPA::clean_username($form{'suname'});
             } else {      $form{'udom'}  = &LONCAPA::clean_domain($form{'udom'});
                 $r->print(&Apache::loncommon::start_page('Access to LON-CAPA unavailable').      $form{'sudom'} = &LONCAPA::clean_domain($form{'sudom'});
                           '<h3>'.&mt('Account creation unavailable').'</h3>'.  
                           &mt('You do not currently have a LON-CAPA account at this institution.').'<br />'.      my $role   = $r->dir_config('lonRole');
                           '<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>'.      my $domain = $r->dir_config('lonDefDomain');
                           &Apache::loncommon::end_page());      my $prodir = $r->dir_config('lonUsersDir');
             }      my $contact_name = &mt('LON-CAPA helpdesk');
         } else {  
             &success($r,$form->{'uname'},$udom,$authhost,'noredirect',undef,  # ---------------------------------------- Get the information from login token
                      $form);  
             my ($otherserver) = &Apache::lonnet::choose_server($udom);      my $tmpinfo=Apache::lonnet::reply('tmpget:'.$form{'logtoken'},
             $r->internal_redirect('/adm/switchserver?otherserver='.$otherserver);                                        $form{'serverid'});
         }  
     }      if (($tmpinfo=~/^error/) || ($tmpinfo eq 'con_lost') ||
     return $canhost;          ($tmpinfo eq 'no_such_host')) {
 }   &failed($r,'Information needed to verify your login information is missing, inaccessible or expired.',\%form);
           return OK;
 sub noswitch {      } else {
     my $result = &Apache::loncommon::start_page('Access to LON-CAPA unavailable').   my $reply = &Apache::lonnet::reply('tmpdel:'.$form{'logtoken'},
                  '<h3>'.&mt('Session unavailable').'</h3>'.     $form{'serverid'});
                  &mt('This LON-CAPA server is unable to host your session.').'<br />'.          if ( $reply ne 'ok' ) {
                  '<p>'.&mt('Currently no other LON-CAPA server is available to host your session either.').'</p>'.              &failed($r,'Session could not be opened.',\%form);
                  &Apache::loncommon::end_page();      &Apache::lonnet::logthis("ERROR got a reply of $reply when trying to contact ". $form{'serverid'}." to get login token");
     return $result;      return OK;
 }   }
       }
 sub loginhelpdisplay {  
     my ($authdomain) = @_;      if (!&Apache::lonnet::domain($form{'udom'})) {
     my $login_help = 1;          &failed($r,'The domain you provided is not a valid LON-CAPA domain.',\%form);
     my $lang = &Apache::lonlocal::current_language();          return OK;
     if ($login_help) {      }
         my $dom = $authdomain;  
         if ($dom eq '') {      my ($des_key,$firsturl,@rest)=split(/&/,$tmpinfo);
             $dom = &Apache::lonnet::default_login_domain();      $firsturl = &unescape($firsturl);
         }      foreach my $item (@rest) {
         my %domconfhash = &Apache::loncommon::get_domainconf($dom);          my ($key,$value) = split(/=/,$item);
         my $loginhelp_url;          $form{$key} = &unescape($value);
         if ($lang) {      }
             $loginhelp_url = $domconfhash{$dom.'.login.helpurl_'.$lang};      if ($firsturl =~ m{^/tiny/$match_domain/\w+$}) {
             if ($loginhelp_url ne '') {          $form{'firsturl'} = $firsturl;
                 return $loginhelp_url;      }
             }      my $upass = $ENV{HTTPS} ? $form{'upass0'}
         }          : &Apache::loncommon::des_decrypt($des_key,$form{'upass0'});
         $loginhelp_url = $domconfhash{$dom.'.login.helpurl_nolang'};  
         if ($loginhelp_url ne '') {  # ---------------------------------------------------------------- Authenticate
             return $loginhelp_url;  
         } else {      my %domconfig = &Apache::lonnet::get_dom('configuration',['usercreation'],$form{'udom'});
             return '/adm/loginproblems.html';      my ($cancreate,$statustocreate) =
         }          &Apache::createaccount::get_creation_controls($form{'udom'},$domconfig{'usercreation'});
     }      my $defaultauth;
     return;      if (ref($cancreate) eq 'ARRAY') {
 }          if (grep(/^login$/,@{$cancreate})) {
               $defaultauth = 1;
 1;          }
 __END__      }
       my $clientcancheckhost = 1;
       my $authhost=Apache::lonnet::authenticate($form{'uname'},$upass,
                                                 $form{'udom'},$defaultauth,
                                                 $clientcancheckhost);
   
   # --------------------------------------------------------------------- Failed?
   
       if ($authhost eq 'no_host') {
           my $pwdverify;
           if (&Apache::lonnet::homeserver($form{'uname'},$form{'udom'}) eq 'no_host') {
               my %possunames = &alternate_unames_check($form{'uname'},$form{'udom'});
               if (keys(%possunames) > 0) {
                   foreach my $rulematch (keys(%possunames)) {
                       my $possuname = $possunames{$rulematch};
                       if (($possuname ne '') && ($possuname =~ /^$match_username$/)) {
                           $authhost=Apache::lonnet::authenticate($possuname,$upass,
                                                                  $form{'udom'},undef,
                                                                  $clientcancheckhost);
                           if (($authhost eq 'no_host') || ($authhost eq 'no_account_on_host')) {
                               next;
                           } elsif (($authhost ne '') && (&Apache::lonnet::hostname($authhost) ne '')) {
                               $pwdverify = 1;
                               &Apache::lonnet::logthis("Authenticated user: $possuname was submitted as: $form{'uname'}");
                               $form{'uname'} = $possuname;
                               last;
                           }
                       }
                   }
               }
           }
           unless ($pwdverify) {
               &failed($r,'Username and/or password could not be authenticated.',
                       \%form,$authhost);
               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,'no_account_on_host',$domdesc)) {
                   return OK;
               }
               my $start_page =
                   &Apache::loncommon::start_page('Create a user account in LON-CAPA',
                                                  '',{'no_inline_link'   => 1,});
               my $lonhost = $r->dir_config('lonHostID');
               my $origmail = $Apache::lonnet::perlvar{'lonSupportEMail'};
               my $contacts =
                   &Apache::loncommon::build_recipient_list(undef,'helpdeskmail',
                                                           $form{'udom'},$origmail);
               my ($contact_email) = split(',',$contacts);
               my $output =
                   &Apache::createaccount::username_check($form{'uname'},$form{'udom'},
                                                          $domdesc,'',$lonhost,
                                                          $contact_email,$contact_name,
                                                          undef,$statustocreate);
               &Apache::loncommon::content_type($r,'text/html');
               $r->send_http_header;
               &Apache::createaccount::print_header($r,$start_page);
               $r->print('<h3>'.&mt('Account creation').'</h3>'.
                         &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());
               return OK;
           } 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);
               return OK;
           }
       }
   
       if (($firsturl eq '') ||
    ($firsturl=~/^\/adm\/(logout|remote)/)) {
    $firsturl='/adm/roles';
       }
   
       my ($hosthere,%sessiondata);
       if ($form{'iptoken'}) {
           %sessiondata = &Apache::lonnet::tmpget($form{'iptoken'});
           my $delete = &Apache::lonnet::tmpdel($form{'iptoken'});
           if (($sessiondata{'domain'} eq $form{'udom'}) &&
               ($sessiondata{'username'} eq $form{'uname'})) {
               $hosthere = 1;
           }
       }
   
   # --------------------------------- Are we attempting to login as somebody else?
       if ($form{'suname'}) {
           my ($suname,$sudom,$sudomref);
           $suname = $form{'suname'};
           $sudom = $form{'udom'};
           if ($form{'sudom'}) {
               unless ($sudom eq $form{'sudom'}) {
                   if (&Apache::lonnet::domain($form{'sudom'})) {
                       $sudomref = [$form{'sudom'}];
                       $sudom = $form{'sudom'};
                   }
               }
           }
   # ------------ see if the original user has enough privileges to pull this stunt
    if (&Apache::lonnet::privileged($form{'uname'},$form{'udom'},$sudomref)) {
   # ---------------------------------------------------- see if the su-user exists
       unless (&Apache::lonnet::homeserver($suname,$sudom) eq 'no_host') {
   # ------------------------------ see if the su-user is not too highly privileged
    if (&Apache::lonnet::privileged($suname,$sudom)) {
                       &Apache::lonnet::logthis('Attempted switch user to privileged user');
                   } else {
                       my $noprivswitch;
   #
   # su-user's home server and user's home server must have one of:
   # (a) same domain
   # (b) same primary library server for the two domains
   # (c) same "internet domain" for primary library server(s) for home servers' domains
   #
                       my $suprim = &Apache::lonnet::domain($sudom,'primary');
                       my $suintdom = &Apache::lonnet::internet_dom($suprim);
                       unless ($sudom eq $form{'udom'}) {
                           my $uprim = &Apache::lonnet::domain($form{'udom'},'primary');
                           my $uintdom = &Apache::lonnet::internet_dom($uprim);
                           unless ($suprim eq $uprim) {
                               unless ($suintdom eq $uintdom) {
                                   &Apache::lonnet::logthis('Attempted switch user '
                                      .'to user with different "internet domain".');
                                   $noprivswitch = 1;
                               }
                           }
                       }
   
                       unless ($noprivswitch) {
   #
   # server where log-in occurs must have same "internet domain" as su-user's home
   # server
   #
                           my $lonhost = $r->dir_config('lonHostID');
                           my $hostintdom = &Apache::lonnet::internet_dom($lonhost);
                           if ($hostintdom ne $suintdom) {
                               &Apache::lonnet::logthis('Attempted switch user on a '
                                   .'server with a different "internet domain".');
                           } else {
   
   # -------------------------------------------------------- actually switch users
   
               &Apache::lonnet::logperm('User '.$form{'uname'}.' at '.
                                 $form{'udom'}.' logging in as '.$suname.':'.$sudom);
               $form{'uname'}=$suname;
                               if ($form{'udom'} ne $sudom) {
                                   $form{'udom'}=$sudom;
                               }
                           }
                       }
    }
       }
    } else {
       &Apache::lonnet::logthis('Non-privileged user attempting switch user');
    }
       }
   
       if ($form{'firsturl'} =~ m{^/tiny/$match_domain/\w+$}) {
           if (($form{'linkprot'}) && ($form{'linkprotuser'} ne '')) {
               unless($form{'linkprotuser'} eq $form{'uname'}.':'.$form{'udom'}) {
                   delete($form{'udom'});
                   delete($form{'uname'});
                   &failed($r,'Username and/or domain are different to that expected for the link you followed from another system',
                           \%form,$authhost);
                   return OK;
               }
           }
       }
   
       my ($is_balancer,$otherserver);
   
       unless ($hosthere) {
           ($is_balancer,$otherserver) =
               &Apache::lonnet::check_loadbalancing($form{'uname'},$form{'udom'},'login');
           if ($is_balancer) {
               # Check if browser sent a LON-CAPA load balancer cookie (and this is a balancer)
               my ($found_server,$balancer_cookie) = &Apache::lonnet::check_for_balancer_cookie($r);
               if (($found_server) && ($balancer_cookie =~ /^\Q$env{'user.domain'}\E_\Q$env{'user.name'}\E_/)) {
                   $otherserver = $found_server;
               }
               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($r,$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'};
               }
               if ($form{'linkprot'}) {
                   $env{'request.linkprot'} = $form{'linkprot'};
                   foreach my $item ('linkprotuser','linkprotexit','linkprotpbid','linkprotpburl') {
                       if ($form{$item}) {
                           $env{'request.'.$item} = $form{$item};
                       }
                   }
               } elsif ($form{'linkkey'} ne '') {
                   $env{'request.linkkey'} = $form{'linkkey'};
               }
               if ($form{'firsturl'} =~ m{^/tiny/$match_domain/\w+$}) {
                   &set_deeplink_login(%form);
               } elsif ($firsturl eq '/adm/email') {
                   if ($form{'display'} && ($form{'mailrecip'} eq "$form{'uname'}:$form{'udom'}")) {
                       $env{'request.display'} = $form{'display'};
                       $env{'request.mailrecip'} = $form{'mailrecip'};
                   }
               }
               $r->internal_redirect($switchto);
           } else {
               &Apache::loncommon::content_type($r,'text/html');
               $r->send_http_header;
               $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'};
                   }
                   if ($form{'linkprot'}) {
                       $env{'request.linkprot'} = $form{'linkprot'};
                       foreach my $item ('linkprotuser','linkprotexit','linkprotpbid','linkprotpburl') {
                           if ($form{$item}) {
                               $env{'request.'.$item} = $form{$item};
                           }
                       }
                   } elsif ($form{'linkkey'} ne '') {
                       $env{'request.linkkey'} = $form{'linkkey'};
                   }
                   if ($form{'firsturl'} =~ m{^/tiny/$match_domain/\w+$}) {
                       &set_deeplink_login(%form);
                   } elsif ($firsturl eq '/adm/email') {
                       if ($form{'display'} && ($form{'mailrecip'} eq "$form{'uname'}:$form{'udom'}")) {
                           $env{'request.display'} = $form{'display'};
                           $env{'request.mailrecip'} = $form{'mailrecip'};
                       }
                   }
                   $r->internal_redirect($switchto);
               } else {
                   &Apache::loncommon::content_type($r,'text/html');
                   $r->send_http_header;
                   $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($r,$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);
                   if ($form{'linkprot'}) {
                       $env{'request.linkprot'} = $form{'linkprot'};
                   } elsif ($form{'linkkey'} ne '') {
                       $env{'request.linkkey'} = $form{'linkkey'};
                   }
                   if ($form{'firsturl'} =~ m{^/tiny/$match_domain/\w+$}) {
                       &set_deeplink_login(%form);
                   } elsif ($firsturl eq '/adm/email') {
                       if ($form{'display'} && ($form{'mailrecip'} eq "$form{'uname'}:$form{'udom'}")) {
                           $env{'request.display'} = $form{'display'};
                           $env{'request.mailrecip'} = $form{'mailrecip'};
                       }
                   }
                   $r->internal_redirect('/adm/switchserver?otherserver='.$unloaded.'&origurl='.$firsturl);
                   return OK;
               }
           }
           if (($is_balancer) && ($hosthere)) {
               $form{'noloadbalance'} = $hosthere;
           }
           my $extra_env;
           if (($hosthere) && ($sessiondata{'sessionserver'} ne '')) {
               if ($sessiondata{'origurl'} ne '') {
                   $firsturl = $sessiondata{'origurl'};
                   $form{'firsturl'} = $sessiondata{'origurl'};
                   my @names = ('role','symb','linkprot','linkkey');
                   foreach my $item (@names) {
                       if ($sessiondata{$item} ne '') {
                           $form{$item} = $sessiondata{$item};
                       }
                   }
                   if ($sessiondata{'origurl'} eq '/adm/email') {
                       if (($sessiondata{'display'}) && ($sessiondata{'mailrecip'})) {
                           if (&unescape($sessiondata{'mailrecip'}) eq "$form{'uname'}:$form{'udom'}") {
                               $form{'display'} = &unescape($sessiondata{'display'});
                               $form{'mailrecip'} = &unescape($sessiondata{'mailrecip'});
                           }
                       }
                   }
               }
           }
           if ($form{'linkprot'}) {
               my ($linkprotector,$uri) = split(/:/,$form{'linkprot'},2);
               if ($linkprotector) {
                   $extra_env = {'user.linkprotector' => $linkprotector,
                                 'user.linkproturi'   => $uri};
               }
           } elsif ($form{'linkkey'} ne '') {
               $extra_env = {'user.deeplinkkey'  => $form{'linkkey'},
                             'user.keyedlinkuri' => $form{'firsturl'}};
           }
           if ($form{'firsturl'} =~ m{^/tiny/$match_domain/\w+$}) {
               &set_deeplink_login(%form);
               if ($form{'linkprot'}) {
                   if (ref($extra_env) eq 'HASH') {
                       %{$extra_env} = ( %{$extra_env}, 'request.linkprot' => $form{'linkprot'} );
                   } else {
                       $extra_env = {'request.linkprot' => $form{'linkprot'}};
                   }
                   if ($form{'linkprotexit'}) {
                       $extra_env->{'request.linkprotexit'} = $form{'linkprotexit'};
                   }
                   if ($form{'linkprotpbid'}) {
                       $extra_env->{'request.linkprotpbid'} = $form{'linkprotpbid'};
                   }
                   if ($form{'linkprotpburl'}) {
                       $extra_env->{'request.linkprotpburl'} = $form{'linkprotpburl'};
                   }
               } elsif ($form{'linkkey'} ne '') {
                   if (ref($extra_env) eq 'HASH') {
                       %{$extra_env} = ( %{$extra_env}, 'request.linkkey' => $form{'linkkey'} );
                   } else {
                       $extra_env = {'request.linkkey' => $form{'linkkey'}};
                   }
               }
               if ($env{'request.deeplink.login'}) {
                   if (ref($extra_env) eq 'HASH') {
                       %{$extra_env} = ( %{$extra_env}, 'request.deeplink.login' => $form{'firsturl'} );
                   } else {
                       $extra_env = {'request.deeplink.login' => $form{'firsturl'}};
                   }
               }
           }
           &success($r,$form{'uname'},$form{'udom'},$authhost,$firsturl,$extra_env,
                    \%form);
           return OK;
       }
   }
   
   sub get_form_items {
       my ($r) = @_;
       my $buffer;
       if ($r->header_in('Content-length') > 0) {
           $r->read($buffer,$r->header_in('Content-length'),0);
       }
       my %form;
       foreach my $pair (split(/&/,$buffer)) {
          my ($name,$value) = split(/=/,$pair);
          $value =~ tr/+/ /;
          $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
          $form{$name}=$value;
       }
       return %form;
   }
   
   sub set_deeplink_login {
       my (%form) = @_;
       my $disallow;
       if ($form{'firsturl'} =~ m{^/tiny/($match_domain)/\w+$}) {
           my $cdom = $1;
           my ($cnum,$symb) = &Apache::loncommon::symb_from_tinyurl($form{'firsturl'},'',$cdom);
           if ($symb) {
               if ($env{'request.course.id'} eq $cdom.'_'.$cnum) {
                   my $deeplink;
                   if ($symb =~ /\.(page|sequence)$/) {
                       my $mapname = &Apache::lonnet::deversion((&Apache::lonnet::decode_symb($symb))[2]);
                       my $navmap = Apache::lonnavmaps::navmap->new();
                       if (ref($navmap)) {
                           $deeplink = $navmap->get_mapparam(undef,$mapname,'0.deeplink');
                       }
                   } else {
                       $deeplink = &Apache::lonnet::EXT('resource.0.deeplink',$symb);
                   }
                   if ($deeplink ne '') {
                       my ($state,$others,$listed,$scope,$protect) = split(/,/,$deeplink);
                       if (($protect ne 'none') && ($protect ne '')) {
                           my ($acctype,$item) = split(/:/,$protect);
                           if ($acctype =~ /lti(c|d)$/) {
                               unless ($form{'linkprot'} eq $item.$1.':'.$env{'request.deeplink.login'}) {
                                   $disallow = 1;
                               }
                           } elsif ($acctype eq 'key') {
                               unless ($form{'linkkey'} eq $item) {
                                   $disallow = 1;
                               }
                           }
                       }
                   }
                   unless ($disallow) {
                       $env{'request.deeplink.login'} = $form{'firsturl'};
                   }
               } else {
                   $env{'request.deeplink.login'} = $form{'firsturl'};
               }
           }
       }
       if ($disallow) {
           return;
       }
       return 'ok';
   }
   
   sub set_retry_token {
       my ($form,$lonhost,$querystr) = @_;
       if (ref($form) eq 'HASH') {
           my ($firsturl,$token,$extras,@names);
           @names = ('role','symb','linkprotuser','linkprotexit','linkprot','linkkey','iptoken','linkprotpbid','linkprotpburl');
           foreach my $name (@names) {
               if ($form->{$name} ne '') {
                   $extras .= '&'.$name.'='.&escape($form->{$name});
                   last if ($name eq 'linkprot');
               }
           }
           my $firsturl = $form->{'firsturl'};
           if (($firsturl ne '') || ($extras ne '')) {
               $extras .= ':retry';
               $token = &Apache::lonnet::reply('tmpput:'.&escape($firsturl).
                                               $extras,$lonhost);
               if (($token eq 'con_lost') || ($token eq 'no_such_host')) {
                   return 'fail';
               } else {
                   if (ref($querystr)) {
                       $$querystr = 'retry='.$token;
                   }
                   return 'ok';
               }
           }
       }
       return;
   }
   
   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 $alias = &Apache::lonnet::use_proxy_alias($r,$login_host);
                   $hostname = $alias if ($alias ne '');
                   my $newurl = $protocol.'://'.$hostname.'/adm/createaccount';
   #FIXME Should preserve where user was going and linkprot by setting ltoken at $login_host
                   $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);
               if ($form->{'firsturl'} =~ m{^/tiny/$match_domain/\w+$}) {
                   $env{'request.deeplink.login'} = $form->{'firsturl'};
               } elsif ($form->{'firsturl'} eq '/adm/email') {
                   if ($form->{'display'} && ($form->{'mailrecip'} eq $form->{'uname'}.':'.$form->{'udom'})) {
                       $env{'request.display'} = $form->{'mailrecip'};
                       $env{'request.mailrecip'} = $form->{'mailrecip'};
                   }
               }
               if ($form->{'linkprot'}) {
                   $env{'request.linkprot'} = $form->{'linkprot'};
               } elsif ($form->{'linkkey'} ne '') {
                   $env{'request.linkkey'} = $form->{'linkkey'};
               }
               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;
   }
   
   sub alternate_unames_check {
       my ($uname,$udom) = @_;
       my %possunames;
       my %domdefs = &Apache::lonnet::get_domain_defaults($udom);
       if (ref($domdefs{'unamemap_rule'}) eq 'ARRAY') {
           if (@{$domdefs{'unamemap_rule'}} > 0) {
               %possunames =
                   &Apache::lonnet::inst_rulecheck($udom,$uname,undef,
                                                   'unamemap',$domdefs{'unamemap_rule'});
           }
       }
       return %possunames;
   }
   
   1;
   __END__
   
   
Removed from v.1.128  
changed lines
  Added in v.1.179

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