Diff for /loncom/auth/lonauth.pm between versions 1.134 and 1.139

version 1.134, 2014/04/30 21:51:30 version 1.139, 2016/02/17 19:15:40
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;
 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 DynaLoader; # for Crypt::DES version
 use Crypt::DES;  use Crypt::DES;
 use Apache::loncommon();  use Apache::loncommon();
 use Apache::lonnet;  use Apache::lonnet;
 use Apache::lonmenu();  use Apache::lonmenu();
 use Apache::createaccount;  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;
     
 # ------------------------------------------------------------ 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 cookie ready
     $cookie="lonID=$cookie; path=/";      $cookie="lonID=$cookie; path=/";
 # -------------------------------------------------------- Menu script and info  # -------------------------------------------------------- Menu script and info
     my $destination = $lowerurl;      my $destination = $lowerurl;
   
     if (defined($form->{role})) {      if (defined($form->{role})) {
         my $envkey = 'user.role.'.$form->{role};          my $envkey = 'user.role.'.$form->{role};
         my $now=time;          my $now=time;
         my $then=$env{'user.login.time'};          my $then=$env{'user.login.time'};
         my $refresh=$env{'user.refresh.time'};          my $refresh=$env{'user.refresh.time'};
         my $update=$env{'user.update.time'};          my $update=$env{'user.update.time'};
         if (!$update) {          if (!$update) {
             $update = $then;              $update = $then;
         }          }
         if (exists($env{$envkey})) {          if (exists($env{$envkey})) {
             my ($role,$where,$trolecode,$tstart,$tend,$tremark,$tstatus);              my ($role,$where,$trolecode,$tstart,$tend,$tremark,$tstatus);
             &Apache::lonnet::role_status($envkey,$update,$refresh,$now,\$role,\$where,              &Apache::lonnet::role_status($envkey,$update,$refresh,$now,\$role,\$where,
                                          \$trolecode,\$tstatus,\$tstart,\$tend);                                           \$trolecode,\$tstatus,\$tstart,\$tend);
             if ($tstatus eq 'is') {              if ($tstatus eq 'is') {
                 $destination  .= ($destination =~ /\?/) ? '&' : '?';                  $destination  .= ($destination =~ /\?/) ? '&' : '?';
                 my $newrole = &HTML::Entities::encode($form->{role},'"<>&');                  my $newrole = &HTML::Entities::encode($form->{role},'"<>&');
                 $destination .= 'selectrole=1&'.$newrole.'=1';                  $destination .= 'selectrole=1&'.$newrole.'=1';
             }              }
         }          }
     }      }
     if (defined($form->{symb})) {      if (defined($form->{symb})) {
         my $destsymb = $form->{symb};          my $destsymb = $form->{symb};
         $destination  .= ($destination =~ /\?/) ? '&' : '?';          $destination  .= ($destination =~ /\?/) ? '&' : '?';
         if ($destsymb =~ /___/) {          if ($destsymb =~ /___/) {
             # FIXME Need to deal with encrypted symbs and urls as needed.              # FIXME Need to deal with encrypted symbs and urls as needed.
             my ($map,$resid,$desturl)=split(/___/,$destsymb);              my ($map,$resid,$desturl)=split(/___/,$destsymb);
             unless ($desturl=~/^(adm|editupload|public)/) {              $desturl = &Apache::lonnet::clutter($desturl);
                 $desturl = &Apache::lonnet::clutter($desturl);              $desturl = &HTML::Entities::encode($desturl,'"<>&');
             }              $destsymb = &HTML::Entities::encode($destsymb,'"<>&');
             $desturl = &HTML::Entities::encode($desturl,'"<>&');              $destination .= 'destinationurl='.$desturl.
             $destsymb = &HTML::Entities::encode($destsymb,'"<>&');                              '&destsymb='.$destsymb;
             $destination .= 'destinationurl='.$desturl.          } else {
                             '&destsymb='.$destsymb;              $destsymb = &HTML::Entities::encode($destsymb,'"<>&');
         } else {              $destination .= 'destinationurl='.$destsymb;
             $destsymb = &HTML::Entities::encode($destsymb,'"<>&');          }
             $destination .= 'destinationurl='.$destsymb;      }
         }      if ($destination =~ m{^/adm/roles}) {
     }          $destination  .= ($destination =~ /\?/) ? '&' : '?';
     if ($destination =~ m{^/adm/roles}) {          $destination .= 'source=login';
         $destination  .= ($destination =~ /\?/) ? '&' : '?';      }
         $destination .= 'source=login';  
     }      my $windowinfo = Apache::lonhtmlcommon::scripttag('self.name="loncapaclient";');
       my $header = '<meta HTTP-EQUIV="Refresh" CONTENT="0; url='.$destination.'" />';
     my $windowinfo = Apache::lonhtmlcommon::scripttag('self.name="loncapaclient";');      my $brcrum = [{'href' => '',
     my $header = '<meta HTTP-EQUIV="Refresh" CONTENT="0; url='.$destination.'" />';                     'text' => 'Successful Login'},];
     my $brcrum = [{'href' => '',      my $start_page=&Apache::loncommon::start_page('Successful Login',
                    'text' => 'Successful Login'},];                                                    $header,
     my $start_page=&Apache::loncommon::start_page('Successful Login',                                                    {'bread_crumbs' => $brcrum,});
                                                   $header,      my $end_page  =&Apache::loncommon::end_page();
                                                   {'bread_crumbs' => $brcrum,});  
     my $end_page  =&Apache::loncommon::end_page();   my $continuelink='<a href="'.$destination.'">'.&mt('Continue').'</a>';
   # ------------------------------------------------- Output for successful login
  my $continuelink='<a href="'.$destination.'">'.&mt('Continue').'</a>';  
 # ------------------------------------------------- Output for successful login      &Apache::loncommon::content_type($r,'text/html');
       $r->header_out('Set-cookie' => $cookie);
     &Apache::loncommon::content_type($r,'text/html');      $r->send_http_header;
     $r->header_out('Set-cookie' => $cookie);  
     $r->send_http_header;      my %lt=&Apache::lonlocal::texthash(
          'wel' => 'Welcome',
     my %lt=&Apache::lonlocal::texthash(         'pro' => 'Login problems?',
        'wel' => 'Welcome',         );
        'pro' => 'Login problems?',      my $loginhelp = &loginhelpdisplay($domain);
        );      if ($loginhelp) {
     my $loginhelp = &loginhelpdisplay($domain);          $loginhelp = '<p><a href="'.$loginhelp.'">'.$lt{'pro'}.'</a></p>';
     if ($loginhelp) {      }
         $loginhelp = '<p><a href="'.$loginhelp.'">'.$lt{'pro'}.'</a></p>';  
     }      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);
     my $welcome = &mt('Welcome to the Learning[_1]Online[_2] Network with CAPA. Please wait while your session is being set up.','<i>','</i>');   $start_page
     $r->print(<<ENDSUCCESS);  $windowinfo
 $start_page  <h1>$lt{'wel'}</h1>
 $windowinfo  $welcome
 <h1>$lt{'wel'}</h1>  $loginhelp
 $welcome  $continuelink
 $loginhelp  $end_page
 $continuelink  ENDSUCCESS
 $end_page      return;
 ENDSUCCESS  }
     return;  
 }  # --------------------------------------------------------------- Failed login!
   
 # --------------------------------------------------------------- Failed login!  sub failed {
       my ($r,$message,$form) = @_;
 sub failed {      (undef,undef,undef,my $clientmathml,my $clientunicode) =
     my ($r,$message,$form) = @_;          &Apache::loncommon::decode_user_agent();
     (undef,undef,undef,my $clientmathml,my $clientunicode) =      my $args = {};
         &Apache::loncommon::decode_user_agent();      if ($clientunicode && !$clientmathml) {
     my $args = {};          $args = {'browser.unicode' => 1};
     if ($clientunicode && !$clientmathml) {      }
         $args = {'browser.unicode' => 1};  
     }      my $start_page = &Apache::loncommon::start_page('Unsuccessful Login',undef,$args);
       my $uname = &Apache::loncommon::cleanup_html($form->{'uname'});
     my $start_page = &Apache::loncommon::start_page('Unsuccessful Login',undef,$args);      my $udom = &Apache::loncommon::cleanup_html($form->{'udom'});
     my $uname = &Apache::loncommon::cleanup_html($form->{'uname'});      if (&Apache::lonnet::domain($udom,'description') eq '') {
     my $udom = &Apache::loncommon::cleanup_html($form->{'udom'});          undef($udom);
     if (&Apache::lonnet::domain($udom,'description') eq '') {      }
         undef($udom);      my $retry = '/adm/login';
     }      if ($uname eq $form->{'uname'}) {
     my $retry = '/adm/login';          $retry .= '?username='.$uname;
     if ($uname eq $form->{'uname'}) {      }
         $retry .= '?username='.$uname;      if ($udom) {
     }          $retry .= (($retry=~/\?/)?'&amp;':'?').'domain='.$udom;
     if ($udom) {      }
         $retry .= (($retry=~/\?/)?'&amp;':'?').'domain='.$udom;      if (exists($form->{role})) {
     }          my $role = &Apache::loncommon::cleanup_html($form->{role});
     if (exists($form->{role})) {          if ($role ne '') {
         my $role = &Apache::loncommon::cleanup_html($form->{role});              $retry .= (($retry=~/\?/)?'&amp;':'?').'role='.$role;
         if ($role ne '') {          }
             $retry .= (($retry=~/\?/)?'&amp;':'?').'role='.$role;      }
         }      if (exists($form->{symb})) {
     }          my $symb = &Apache::loncommon::cleanup_html($form->{symb});
     if (exists($form->{symb})) {          if ($symb ne '') {
         my $symb = &Apache::loncommon::cleanup_html($form->{symb});              $retry .= (($retry=~/\?/)?'&amp;':'?').'symb='.$symb;
         if ($symb ne '') {          }
             $retry .= (($retry=~/\?/)?'&amp;':'?').'symb='.$symb;      }
         }      my $end_page = &Apache::loncommon::end_page();
     }      &Apache::loncommon::content_type($r,'text/html');
     my $end_page = &Apache::loncommon::end_page();      $r->send_http_header;
     &Apache::loncommon::content_type($r,'text/html');      my @actions =
     $r->send_http_header;           (&mt('Please [_1]log in again[_2].','<a href="'.$retry.'">','</a>'));
     my @actions =      my $loginhelp = &loginhelpdisplay($udom);
          (&mt('Please [_1]log in again[_2].','<a href="'.$retry.'">','</a>'));      if ($loginhelp) {
     my $loginhelp = &loginhelpdisplay($udom);          push(@actions, '<a href="'.$loginhelp.'">'.&mt('Login problems?').'</a>');
     if ($loginhelp) {      }
         push(@actions, '<a href="'.$loginhelp.'">'.&mt('Login problems?').'</a>');      #FIXME: link to helpdesk might be added here
     }  
     #FIXME: link to helpdesk might be added here      $r->print(
          $start_page
     $r->print(        .'<h2>'.&mt('Sorry ...').'</h2>'
        $start_page        .&Apache::lonhtmlcommon::confirm_success(&mt($message),1).'<br /><br />'
       .'<h2>'.&mt('Sorry ...').'</h2>'        .&Apache::lonhtmlcommon::actionbox(\@actions)
       .&Apache::lonhtmlcommon::confirm_success(&mt($message),1).'<br /><br />'        .$end_page
       .&Apache::lonhtmlcommon::actionbox(\@actions)      );
       .$end_page   }
     );  
  }  # ------------------------------------------------------------------ Rerouting!
   
 # ------------------------------------------------------------------ Rerouting!  sub reroute {
       my ($r) = @_;
 sub reroute {      &Apache::loncommon::content_type($r,'text/html');
     my ($r) = @_;      $r->send_http_header;
     &Apache::loncommon::content_type($r,'text/html');      my $msg='<b>'.&mt('Sorry ...').'</b><br />'
     $r->send_http_header;             .&mt('Please [_1]log in again[_2].');
     my $msg='<b>'.&mt('Sorry ...').'</b><br />'      &Apache::loncommon::simple_error_page($r,'Rerouting',$msg,{'no_auto_mt_msg' => 1});
            .&mt('Please [_1]log in again[_2].');  }
     &Apache::loncommon::simple_error_page($r,'Rerouting',$msg,{'no_auto_mt_msg' => 1});  
 }  # ---------------------------------------------------------------- Main handler
   
 # ---------------------------------------------------------------- Main handler  sub handler {
       my $r = shift;
 sub handler {      my $londocroot = $r->dir_config('lonDocRoot');
     my $r = shift;      my $form;
     my $londocroot = $r->dir_config('lonDocRoot');  # Are we re-routing?
     my $form;      if (-e "$londocroot/lon-status/reroute.txt") {
 # Are we re-routing?   &reroute($r);
     if (-e "$londocroot/lon-status/reroute.txt") {   return OK;
  &reroute($r);      }
  return OK;  
     }      &Apache::lonlocal::get_language_handle($r);
   
     &Apache::lonlocal::get_language_handle($r);  # -------------------------------- Prevent users from attempting to login twice
       my $handle = &Apache::lonnet::check_for_valid_session($r);
 # -------------------------------- Prevent users from attempting to login twice      if ($handle ne '') {
     my $handle = &Apache::lonnet::check_for_valid_session($r);          my $lonidsdir=$r->dir_config('lonIDsDir');
     if ($handle ne '') {          if ($handle=~/^publicuser\_/) {
         my $lonidsdir=$r->dir_config('lonIDsDir');  # For "public user" - remove it, we apparently really want to login
         if ($handle=~/^publicuser\_/) {              unlink($r->dir_config('lonIDsDir')."/$handle.id");
 # For "public user" - remove it, we apparently really want to login          } else {
             unlink($r->dir_config('lonIDsDir')."/$handle.id");  # Indeed, a valid token is found
         } else {              &Apache::lonnet::transfer_profile_to_env($lonidsdir,$handle);
 # Indeed, a valid token is found      &Apache::loncommon::content_type($r,'text/html');
             &Apache::lonnet::transfer_profile_to_env($lonidsdir,$handle);      $r->send_http_header;
     &Apache::loncommon::content_type($r,'text/html');      my $start_page =
     $r->send_http_header;          &Apache::loncommon::start_page('Already logged in');
     my $start_page =       my $end_page =
         &Apache::loncommon::start_page('Already logged in');          &Apache::loncommon::end_page();
     my $end_page =               my $dest = '/adm/roles';
         &Apache::loncommon::end_page();              if ($env{'form.firsturl'} ne '') {
             my $dest = '/adm/roles';                  $dest = $env{'form.firsturl'};
             if ($env{'form.firsturl'} ne '') {              }
                 $dest = $env{'form.firsturl'};              $r->print(
             }                 $start_page
             $r->print(                .'<p class="LC_warning">'.&mt('You are already logged in!').'</p>'
                $start_page                .'<p>'.&mt('Please either [_1]continue the current session[_2] or [_3]log out[_4].'
               .'<p class="LC_warning">'.&mt('You are already logged in!').'</p>'                      ,'<a href="'.$dest.'">','</a>','<a href="/adm/logout">','</a>')
               .'<p>'.&mt('Please either [_1]continue the current session[_2] or [_3]log out[_4].'                .'</p>'
                     ,'<a href="'.$dest.'">','</a>','<a href="/adm/logout">','</a>')                .$end_page
               .'</p>'              );
               .$end_page              return OK;
             );          }
             return OK;      }
         }  
     }  # ---------------------------------------------------- No valid token, continue
   
 # ---------------------------------------------------- No valid token, continue  
       my $buffer;
       if ($r->header_in('Content-length') > 0) {
     my $buffer;   $r->read($buffer,$r->header_in('Content-length'),0);
     if ($r->header_in('Content-length') > 0) {      }
  $r->read($buffer,$r->header_in('Content-length'),0);      my %form;
     }      foreach my $pair (split(/&/,$buffer)) {
     my %form;         my ($name,$value) = split(/=/,$pair);
     foreach my $pair (split(/&/,$buffer)) {         $value =~ tr/+/ /;
        my ($name,$value) = split(/=/,$pair);         $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
        $value =~ tr/+/ /;         $form{$name}=$value;
        $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;      }
        $form{$name}=$value;  
     }      if ((!$form{'uname'}) || (!$form{'upass0'}) || (!$form{'udom'})) {
    &failed($r,'Username, password and domain need to be specified.',
     if ((!$form{'uname'}) || (!$form{'upass0'}) || (!$form{'udom'})) {   \%form);
  &failed($r,'Username, password and domain need to be specified.',          return OK;
  \%form);      }
         return OK;  
     }  # split user logging in and "su"-user
   
 # split user logging in and "su"-user      ($form{'uname'},$form{'suname'})=split(/\:/,$form{'uname'});
       $form{'uname'} = &LONCAPA::clean_username($form{'uname'});
     ($form{'uname'},$form{'suname'})=split(/\:/,$form{'uname'});      $form{'suname'}= &LONCAPA::clean_username($form{'suname'});
     $form{'uname'} = &LONCAPA::clean_username($form{'uname'});      $form{'udom'}  = &LONCAPA::clean_domain(  $form{'udom'});
     $form{'suname'}= &LONCAPA::clean_username($form{'suname'});  
     $form{'udom'}  = &LONCAPA::clean_domain(  $form{'udom'});      my $role   = $r->dir_config('lonRole');
       my $domain = $r->dir_config('lonDefDomain');
     my $role   = $r->dir_config('lonRole');      my $prodir = $r->dir_config('lonUsersDir');
     my $domain = $r->dir_config('lonDefDomain');      my $contact_name = &mt('LON-CAPA helpdesk');
     my $prodir = $r->dir_config('lonUsersDir');  
     my $contact_name = &mt('LON-CAPA helpdesk');  # ---------------------------------------- Get the information from login token
   
 # ---------------------------------------- Get the information from login token      my $tmpinfo=Apache::lonnet::reply('tmpget:'.$form{'logtoken'},
                                         $form{'serverid'});
     my $tmpinfo=Apache::lonnet::reply('tmpget:'.$form{'logtoken'},  
                                       $form{'serverid'});      if (($tmpinfo=~/^error/) || ($tmpinfo eq 'con_lost') ||
           ($tmpinfo eq 'no_such_host')) {
     my %sessiondata;   &failed($r,'Information needed to verify your login information is missing, inaccessible or expired.',\%form);
     if ($form{'iptoken'}) {          return OK;
         %sessiondata = &Apache::lonnet::tmpget($form{'iptoken'});      } else {
         my $delete = &Apache::lonnet::tmpdel($form{'iptoken'});   my $reply = &Apache::lonnet::reply('tmpdel:'.$form{'logtoken'},
     }     $form{'serverid'});
           if ( $reply ne 'ok' ) {
     if (($tmpinfo=~/^error/) || ($tmpinfo eq 'con_lost') ||               &failed($r,'Session could not be opened.',\%form);
         ($tmpinfo eq 'no_such_host')) {      &Apache::lonnet::logthis("ERROR got a reply of $reply when trying to contact ". $form{'serverid'}." to get login token");
  &failed($r,'Information needed to verify your login information is missing, inaccessible or expired.',\%form);      return OK;
         return OK;   }
     } else {      }
  my $reply = &Apache::lonnet::reply('tmpdel:'.$form{'logtoken'},  
    $form{'serverid'});      if (!&Apache::lonnet::domain($form{'udom'})) {
         if ( $reply ne 'ok' ) {          &failed($r,'The domain you provided is not a valid LON-CAPA domain.',\%form);
             &failed($r,'Session could not be opened.',\%form);          return OK;
     &Apache::lonnet::logthis("ERROR got a reply of $reply when trying to contact ". $form{'serverid'}." to get login token");      }
     return OK;  
  }      my ($key,$firsturl,$rolestr,$symbstr,$iptokenstr)=split(/&/,$tmpinfo);
     }      if ($rolestr) {
           $rolestr = &unescape($rolestr);
     if (!&Apache::lonnet::domain($form{'udom'})) {      }
         &failed($r,'The domain you provided is not a valid LON-CAPA domain.',\%form);      if ($symbstr) {
         return OK;          $symbstr= &unescape($symbstr);
     }      }
       if ($iptokenstr) {
     my ($key,$firsturl,$rolestr,$symbstr)=split(/&/,$tmpinfo);          $iptokenstr = &unescape($iptokenstr);
     if ($rolestr) {      }
         $rolestr = &unescape($rolestr);      if ($rolestr =~ /^role=/) {
     }          (undef,$form{'role'}) = split('=',$rolestr);
     if ($symbstr) {      }
         $symbstr= &unescape($symbstr);      if ($symbstr =~ /^symb=/) {
     }          (undef,$form{'symb'}) = split('=',$symbstr);
     if ($rolestr =~ /^role=/) {      }
         (undef,$form{'role'}) = split('=',$rolestr);      if ($iptokenstr =~ /^iptoken=/) {
     }          (undef,$form{'iptoken'}) = split('=',$iptokenstr);
     if ($symbstr =~ /^symb=/) {       }
         (undef,$form{'symb'}) = split('=',$symbstr);  
     }      my $upass = $ENV{HTTPS} ? $form{'upass0'}
           : &Apache::loncommon::des_decrypt($key,$form{'upass0'});
     my $keybin=pack("H16",$key);  
   # ---------------------------------------------------------------- Authenticate
     my $cipher;  
     if ($Crypt::DES::VERSION>=2.03) {      my %domconfig = &Apache::lonnet::get_dom('configuration',['usercreation'],$form{'udom'});
  $cipher=new Crypt::DES $keybin;      my ($cancreate,$statustocreate) =
     }          &Apache::createaccount::get_creation_controls($form{'udom'},$domconfig{'usercreation'});
     else {      my $defaultauth;
  $cipher=new DES $keybin;      if (ref($cancreate) eq 'ARRAY') {
     }          if (grep(/^login$/,@{$cancreate})) {
     my $upass='';              $defaultauth = 1;
     for (my $i=0;$i<=2;$i++) {          }
  my $chunk=      }
     $cipher->decrypt(unpack("a8",pack("H16",substr($form{'upass'.$i},0,16))));      my $clientcancheckhost = 1;
       my $authhost=Apache::lonnet::authenticate($form{'uname'},$upass,
  $chunk.=                                                $form{'udom'},$defaultauth,
     $cipher->decrypt(unpack("a8",pack("H16",substr($form{'upass'.$i},16,16))));                                                $clientcancheckhost);
      
  $chunk=substr($chunk,1,ord(substr($chunk,0,1)));  # --------------------------------------------------------------------- Failed?
  $upass.=$chunk;  
     }      if ($authhost eq 'no_host') {
    &failed($r,'Username and/or password could not be authenticated.',
 # ---------------------------------------------------------------- Authenticate   \%form);
           return OK;
     my %domconfig = &Apache::lonnet::get_dom('configuration',['usercreation'],$form{'udom'});      } elsif ($authhost eq 'no_account_on_host') {
     my ($cancreate,$statustocreate) =          if ($defaultauth) {
         &Apache::createaccount::get_creation_controls($form{'udom'},$domconfig{'usercreation'});              my $domdesc = &Apache::lonnet::domain($form{'udom'},'description');
     my $defaultauth;              unless (&check_can_host($r,\%form,'no_account_on_host',$domdesc)) {
     if (ref($cancreate) eq 'ARRAY') {                  return OK;
         if (grep(/^login$/,@{$cancreate})) {              }
             $defaultauth = 1;              my $start_page =
         }                  &Apache::loncommon::start_page('Create a user account in LON-CAPA');
     }              my $lonhost = $r->dir_config('lonHostID');
     my $clientcancheckhost = 1;              my $origmail = $Apache::lonnet::perlvar{'lonSupportEMail'};
     my $authhost=Apache::lonnet::authenticate($form{'uname'},$upass,              my $contacts =
                                               $form{'udom'},$defaultauth,                  &Apache::loncommon::build_recipient_list(undef,'helpdeskmail',
                                               $clientcancheckhost);                                                          $form{'udom'},$origmail);
                   my ($contact_email) = split(',',$contacts);
 # --------------------------------------------------------------------- Failed?              my $output =
                   &Apache::createaccount::username_check($form{'uname'},$form{'udom'},
     if ($authhost eq 'no_host') {                                                         $domdesc,'',$lonhost,
  &failed($r,'Username and/or password could not be authenticated.',                                                         $contact_email,$contact_name,
  \%form);                                                         undef,$statustocreate);
         return OK;              &Apache::loncommon::content_type($r,'text/html');
     } elsif ($authhost eq 'no_account_on_host') {              $r->send_http_header;
         if ($defaultauth) {              &Apache::createaccount::print_header($r,$start_page);
             my $domdesc = &Apache::lonnet::domain($form{'udom'},'description');              $r->print('<h3>'.&mt('Account creation').'</h3>'.
             unless (&check_can_host($r,\%form,'no_account_on_host',$domdesc)) {                        &mt('Although your username and password were authenticated, you do not currently have a LON-CAPA account at this institution.').'<br />'.
                 return OK;                        $output.&Apache::loncommon::end_page());
             }              return OK;
             my $start_page =           } else {
                 &Apache::loncommon::start_page('Create a user account in LON-CAPA');              &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 $lonhost = $r->dir_config('lonHostID');              return OK;
             my $origmail = $Apache::lonnet::perlvar{'lonSupportEMail'};          }
             my $contacts =       }
                 &Apache::loncommon::build_recipient_list(undef,'helpdeskmail',  
                                                         $form{'udom'},$origmail);      if (($firsturl eq '') ||
             my ($contact_email) = split(',',$contacts);    ($firsturl=~/^\/adm\/(logout|remote)/)) {
             my $output =    $firsturl='/adm/roles';
                 &Apache::createaccount::username_check($form{'uname'},$form{'udom'},      }
                                                        $domdesc,'',$lonhost,  
                                                        $contact_email,$contact_name,      my $hosthere;
                                                        undef,$statustocreate);      if ($form{'iptoken'}) {
             &Apache::loncommon::content_type($r,'text/html');          my %sessiondata = &Apache::lonnet::tmpget($form{'iptoken'});
             $r->send_http_header;          my $delete = &Apache::lonnet::tmpdel($form{'iptoken'});
             &Apache::createaccount::print_header($r,$start_page);          if (($sessiondata{'domain'} eq $form{'udom'}) &&
             $r->print('<h3>'.&mt('Account creation').'</h3>'.              ($sessiondata{'username'} eq $form{'uname'})) {
                       &mt('Although your username and password were authenticated, you do not currently have a LON-CAPA account at this institution.').'<br />'.              $hosthere = 1;
                       $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);  # --------------------------------- Are we attempting to login as somebody else?
             return OK;      if ($form{'suname'}) {
         }  # ------------ see if the original user has enough privileges to pull this stunt
     }   if (&Apache::lonnet::privileged($form{'uname'},$form{'udom'})) {
   # ---------------------------------------------------- see if the su-user exists
     if (($firsturl eq '') ||       unless (&Apache::lonnet::homeserver($form{'suname'},$form{'udom'})
  ($firsturl=~/^\/adm\/(logout|remote)/)) {   eq 'no_host') {
  $firsturl='/adm/roles';   &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 $hosthere;  # -------------------------------------------------------- actually switch users
     if ($form{'iptoken'}) {      &Apache::lonnet::logperm('User '.$form{'uname'}.' at '.$form{'udom'}.
         if (($sessiondata{'domain'} eq $form{'udom'}) &&   ' logging in as '.$form{'suname'});
             ($sessiondata{'username'} eq $form{'uname'})) {      $form{'uname'}=$form{'suname'};
             $hosthere = 1;   } else {
         }      &Apache::lonnet::logthis('Attempted switch user to privileged user');
     }   }
       }
 # --------------------------------- Are we attempting to login as somebody else?   } else {
     if ($form{'suname'}) {      &Apache::lonnet::logthis('Non-privileged user attempting switch user');
 # ------------ see if the original user has enough privileges to pull this stunt   }
  if (&Apache::lonnet::privileged($form{'uname'},$form{'udom'})) {      }
 # ---------------------------------------------------- see if the su-user exists  
     unless (&Apache::lonnet::homeserver($form{'suname'},$form{'udom'})      my ($is_balancer,$otherserver);
  eq 'no_host') {  
  &Apache::lonnet::logthis(&Apache::lonnet::homeserver($form{'suname'},$form{'udom'}));      unless ($hosthere) {
 # ------------------------------ see if the su-user is not too highly privileged          ($is_balancer,$otherserver) =
  unless (&Apache::lonnet::privileged($form{'suname'},$form{'udom'})) {              &Apache::lonnet::check_loadbalancing($form{'uname'},$form{'udom'});
 # -------------------------------------------------------- actually switch users      }
     &Apache::lonnet::logperm('User '.$form{'uname'}.' at '.$form{'udom'}.  
  ' logging in as '.$form{'suname'});      if ($is_balancer) {
     $form{'uname'}=$form{'suname'};          if (!$otherserver) {
  } else {              ($otherserver) = &Apache::lonnet::choose_server($form{'udom'});
     &Apache::lonnet::logthis('Attempted switch user to privileged user');          }
  }          if ($otherserver) {
     }              &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',undef,
  } else {                       \%form);
     &Apache::lonnet::logthis('Non-privileged user attempting switch user');              my $switchto = '/adm/switchserver?otherserver='.$otherserver;
  }              if (($firsturl) && ($firsturl ne '/adm/switchserver') && ($firsturl ne '/adm/roles')) {
     }                  $switchto .= '&origurl='.$firsturl;
               }
     my ($is_balancer,$otherserver);              if ($form{'role'}) {
                   $switchto .= '&role='.$form{'role'};
     unless ($hosthere) {              }
         ($is_balancer,$otherserver) =              if ($form{'symb'}) {
             &Apache::lonnet::check_loadbalancing($form{'uname'},$form{'udom'});                  $switchto .= '&symb='.$form{'symb'};
     }              }
               $r->internal_redirect($switchto);
     if ($is_balancer) {          } else {
         if (!$otherserver) {               $r->print(&noswitch());
             ($otherserver) = &Apache::lonnet::choose_server($form{'udom'});          }
         }          return OK;
         if ($otherserver) {      } else {
             &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',undef,          if (!&check_can_host($r,\%form,$authhost)) {
                      \%form);              my ($otherserver) = &Apache::lonnet::choose_server($form{'udom'});
             my $switchto = '/adm/switchserver?otherserver='.$otherserver;              if ($otherserver) {
             if (($firsturl) && ($firsturl ne '/adm/switchserver') && ($firsturl ne '/adm/roles')) {                  &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',undef,
                 $switchto .= '&origurl='.$firsturl;                           \%form);
             }                  my $switchto = '/adm/switchserver?otherserver='.$otherserver;
             if ($form{'role'}) {                  if (($firsturl) && ($firsturl ne '/adm/switchserver') && ($firsturl ne '/adm/roles')) {
                 $switchto .= '&role='.$form{'role'};                      $switchto .= '&origurl='.$firsturl;
             }                  }
             if ($form{'symb'}) {                  if ($form{'role'}) {
                 $switchto .= '&symb='.$form{'symb'};                      $switchto .= '&role='.$form{'role'};
             }                  }
             $r->internal_redirect($switchto);                  if ($form{'symb'}) {
         } else {                      $switchto .= '&symb='.$form{'symb'};
             $r->print(&noswitch());                  }
         }                  $r->internal_redirect($switchto);
         return OK;              } else {
     } else {                  $r->print(&noswitch());
         if (!&check_can_host($r,\%form,$authhost)) {              }
             my ($otherserver) = &Apache::lonnet::choose_server($form{'udom'});              return OK;
             if ($otherserver) {          }
                 &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',undef,  
                          \%form);  # ------------------------------------------------------- Do the load balancing
                 my $switchto = '/adm/switchserver?otherserver='.$otherserver;  
                 if (($firsturl) && ($firsturl ne '/adm/switchserver') && ($firsturl ne '/adm/roles')) {  # ---------------------------------------------------------- Determine own load
                     $switchto .= '&origurl='.$firsturl;          my $loadlim = $r->dir_config('lonLoadLim');
                 }          my $loadavg;
                 if ($form{'role'}) {          {
                     $switchto .= '&role='.$form{'role'};              my $loadfile=Apache::File->new('/proc/loadavg');
                 }              $loadavg=<$loadfile>;
                 if ($form{'symb'}) {          }
                     $switchto .= '&symb='.$form{'symb'};          $loadavg =~ s/\s.*//g;
                 }          my $loadpercent=sprintf("%.1f",100*$loadavg/$loadlim);
                 $r->internal_redirect($switchto);          my $userloadpercent=&Apache::lonnet::userload();
             } else {  
                 $r->print(&noswitch());  # ---------------------------------------------------------- Are we overloaded?
             }          if ((($userloadpercent>100.0)||($loadpercent>100.0))) {
             return OK;              my $unloaded=Apache::lonnet::spareserver($loadpercent,$userloadpercent,1,$form{'udom'});
         }              if (!$unloaded) {
                   ($unloaded) = &Apache::lonnet::choose_server($form{'udom'});
 # ------------------------------------------------------- Do the load balancing              }
               if ($unloaded) {
 # ---------------------------------------------------------- Determine own load                  &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',
         my $loadlim = $r->dir_config('lonLoadLim');                           undef,\%form);
         my $loadavg;                  $r->internal_redirect('/adm/switchserver?otherserver='.$unloaded.'&origurl='.$firsturl);
         {                  return OK;
             my $loadfile=Apache::File->new('/proc/loadavg');              }
             $loadavg=<$loadfile>;          }
         }          &success($r,$form{'uname'},$form{'udom'},$authhost,$firsturl,undef,
         $loadavg =~ s/\s.*//g;                   \%form);
         my $loadpercent=sprintf("%.1f",100*$loadavg/$loadlim);          return OK;
         my $userloadpercent=&Apache::lonnet::userload();      }
   }
 # ---------------------------------------------------------- Are we overloaded?  
         if ((($userloadpercent>100.0)||($loadpercent>100.0))) {  sub check_can_host {
             my $unloaded=Apache::lonnet::spareserver($loadpercent,$userloadpercent,1,$form{'udom'});      my ($r,$form,$authhost,$domdesc) = @_;
             if (!$unloaded) {      return unless (ref($form) eq 'HASH');
                 ($unloaded) = &Apache::lonnet::choose_server($form{'udom'});      my $canhost = 1;
             }      my $lonhost = $r->dir_config('lonHostID');
             if ($unloaded) {      my $udom = $form->{'udom'};
                 &success($r,$form{'uname'},$form{'udom'},$authhost,'noredirect',      my @intdoms;
                          undef,\%form);      my $internet_names = &Apache::lonnet::get_internet_names($lonhost);
                 $r->internal_redirect('/adm/switchserver?otherserver='.$unloaded.'&origurl='.$firsturl);      if (ref($internet_names) eq 'ARRAY') {
                 return OK;          @intdoms = @{$internet_names};
             }      }
         }      my $uprimary_id = &Apache::lonnet::domain($udom,'primary');
         &success($r,$form{'uname'},$form{'udom'},$authhost,$firsturl,undef,      my $uint_dom = &Apache::lonnet::internet_dom($uprimary_id);
                  \%form);      unless ($uint_dom ne '' && grep(/^\Q$uint_dom\E$/,@intdoms)) {
         return OK;          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);
 sub check_can_host {          my %defdomdefaults = &Apache::lonnet::get_domain_defaults($serverhomedom);
     my ($r,$form,$authhost,$domdesc) = @_;          my %udomdefaults = &Apache::lonnet::get_domain_defaults($udom);
     return unless (ref($form) eq 'HASH');          my $loncaparev;
     my $canhost = 1;          if ($authhost eq 'no_account_on_host') {
     my $lonhost = $r->dir_config('lonHostID');              $loncaparev = &Apache::lonnet::get_server_loncaparev($machine_dom);
     my $udom = $form->{'udom'};          } else {
     my @intdoms;              $loncaparev = &Apache::lonnet::get_server_loncaparev($machine_dom,$lonhost);
     my $internet_names = &Apache::lonnet::get_internet_names($lonhost);          }
     if (ref($internet_names) eq 'ARRAY') {          $canhost = &Apache::lonnet::can_host_session($udom,$lonhost,$loncaparev,
         @intdoms = @{$internet_names};                                                       $udomdefaults{'remotesessions'},
     }                                                       $defdomdefaults{'hostedsessions'});
     my $uprimary_id = &Apache::lonnet::domain($udom,'primary');      }
     my $uint_dom = &Apache::lonnet::internet_dom($uprimary_id);      unless ($canhost) {
     unless ($uint_dom ne '' && grep(/^\Q$uint_dom\E$/,@intdoms)) {          if ($authhost eq 'no_account_on_host') {
         my $machine_dom = &Apache::lonnet::host_domain($lonhost);              my $checkloginvia = 1;
         my $hostname = &Apache::lonnet::hostname($lonhost);              my ($login_host,$hostname) =
         my $serverhomeID = &Apache::lonnet::get_server_homeID($hostname);                  &Apache::lonnet::choose_server($udom,$checkloginvia);
         my $serverhomedom = &Apache::lonnet::host_domain($serverhomeID);              &Apache::loncommon::content_type($r,'text/html');
         my %defdomdefaults = &Apache::lonnet::get_domain_defaults($serverhomedom);              $r->send_http_header;
         my %udomdefaults = &Apache::lonnet::get_domain_defaults($udom);              if ($login_host ne '') {
         my $loncaparev;                  my $protocol = $Apache::lonnet::protocol{$login_host};
         if ($authhost eq 'no_account_on_host') {                  $protocol = 'http' if ($protocol ne 'https');
             $loncaparev = &Apache::lonnet::get_server_loncaparev($machine_dom);                  my $newurl = $protocol.'://'.$hostname.'/adm/createaccount';
         } else {                  $r->print(&Apache::loncommon::start_page('Create a user account in LON-CAPA').
             $loncaparev = &Apache::lonnet::get_server_loncaparev($machine_dom,$lonhost);                            '<h3>'.&mt('Account creation').'</h3>'.
         }                            &mt('You do not currently have a LON-CAPA account at this institution.').'<br />'.
         $canhost = &Apache::lonnet::can_host_session($udom,$lonhost,$loncaparev,                            '<p>'.&mt('You will be able to create one by logging into a LON-CAPA server within the [_1] domain.',$domdesc).'</p>'.
                                                      $udomdefaults{'remotesessions'},                            '<p>'.&mt('[_1]Log in[_2]','<a href="'.$newurl.'">','</a>').
                                                      $defdomdefaults{'hostedsessions'});                            &Apache::loncommon::end_page());
     }              } else {
     unless ($canhost) {                  $r->print(&Apache::loncommon::start_page('Access to LON-CAPA unavailable').
         if ($authhost eq 'no_account_on_host') {                            '<h3>'.&mt('Account creation unavailable').'</h3>'.
             my $checkloginvia = 1;                            &mt('You do not currently have a LON-CAPA account at this institution.').'<br />'.
             my ($login_host,$hostname) =                             '<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::lonnet::choose_server($udom,$checkloginvia);                            &Apache::loncommon::end_page());
             &Apache::loncommon::content_type($r,'text/html');              }
             $r->send_http_header;          } else {
             if ($login_host ne '') {              &success($r,$form->{'uname'},$udom,$authhost,'noredirect',undef,
                 my $protocol = $Apache::lonnet::protocol{$login_host};                       $form);
                 $protocol = 'http' if ($protocol ne 'https');              my ($otherserver) = &Apache::lonnet::choose_server($udom);
                 my $newurl = $protocol.'://'.$hostname.'/adm/createaccount';              $r->internal_redirect('/adm/switchserver?otherserver='.$otherserver);
                 $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 />'.      return $canhost;
                           '<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());  sub noswitch {
             } else {      my $result = &Apache::loncommon::start_page('Access to LON-CAPA unavailable').
                 $r->print(&Apache::loncommon::start_page('Access to LON-CAPA unavailable').                   '<h3>'.&mt('Session unavailable').'</h3>'.
                           '<h3>'.&mt('Account creation unavailable').'</h3>'.                   &mt('This LON-CAPA server is unable to host your session.').'<br />'.
                           &mt('You do not currently have a LON-CAPA account at this institution.').'<br />'.                   '<p>'.&mt('Currently no other LON-CAPA server is available to host your session either.').'</p>'.
                           '<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();
                           &Apache::loncommon::end_page());      return $result;
             }  }
         } else {  
             &success($r,$form->{'uname'},$udom,$authhost,'noredirect',undef,  sub loginhelpdisplay {
                      $form);      my ($authdomain) = @_;
             my ($otherserver) = &Apache::lonnet::choose_server($udom);      my $login_help = 1;
             $r->internal_redirect('/adm/switchserver?otherserver='.$otherserver);      my $lang = &Apache::lonlocal::current_language();
         }      if ($login_help) {
     }          my $dom = $authdomain;
     return $canhost;          if ($dom eq '') {
 }              $dom = &Apache::lonnet::default_login_domain();
           }
 sub noswitch {          my %domconfhash = &Apache::loncommon::get_domainconf($dom);
     my $result = &Apache::loncommon::start_page('Access to LON-CAPA unavailable').          my $loginhelp_url;
                  '<h3>'.&mt('Session unavailable').'</h3>'.          if ($lang) {
                  &mt('This LON-CAPA server is unable to host your session.').'<br />'.              $loginhelp_url = $domconfhash{$dom.'.login.helpurl_'.$lang};
                  '<p>'.&mt('Currently no other LON-CAPA server is available to host your session either.').'</p>'.              if ($loginhelp_url ne '') {
                  &Apache::loncommon::end_page();                  return $loginhelp_url;
     return $result;              }
 }          }
           $loginhelp_url = $domconfhash{$dom.'.login.helpurl_nolang'};
 sub loginhelpdisplay {          if ($loginhelp_url ne '') {
     my ($authdomain) = @_;              return $loginhelp_url;
     my $login_help = 1;          } else {
     my $lang = &Apache::lonlocal::current_language();              return '/adm/loginproblems.html';
     if ($login_help) {          }
         my $dom = $authdomain;      }
         if ($dom eq '') {      return;
             $dom = &Apache::lonnet::default_login_domain();  }
         }  
         my %domconfhash = &Apache::loncommon::get_domainconf($dom);  1;
         my $loginhelp_url;  __END__
         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.134  
changed lines
  Added in v.1.139


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