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

Diff for /loncom/auth/lonlogin.pm between versions 1.150 and 1.160

version 1.150, 2012/04/11 11:40:07 version 1.160, 2014/12/05 12:03:20
Line 1 Line 1
 # The LearningOnline Network  # The LearningOnline Network
 # Login Screen  # Login Screen
 #  #
 # $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::lonlogin;  package Apache::lonlogin;
   
 use strict;  use strict;
 use Apache::Constants qw(:common);  use Apache::Constants qw(:common);
 use Apache::File ();  use Apache::File ();
 use Apache::lonnet;  use Apache::lonnet;
 use Apache::loncommon();  use Apache::loncommon();
 use Apache::lonauth();  use Apache::lonauth();
 use Apache::lonlocal;  use Apache::lonlocal;
 use Apache::migrateuser();  use Apache::migrateuser();
 use lib '/home/httpd/lib/perl/';  use lib '/home/httpd/lib/perl/';
 use LONCAPA;  use LONCAPA;
     
 sub handler {  sub handler {
     my $r = shift;      my $r = shift;
   
     &Apache::loncommon::get_unprocessed_cgi      &Apache::loncommon::get_unprocessed_cgi
  (join('&',$ENV{'QUERY_STRING'},$env{'request.querystring'},   (join('&',$ENV{'QUERY_STRING'},$env{'request.querystring'},
       $ENV{'REDIRECT_QUERY_STRING'}),        $ENV{'REDIRECT_QUERY_STRING'}),
  ['interface','username','domain','firsturl','localpath','localres',   ['interface','username','domain','firsturl','localpath','localres',
   'token','role','symb']);    'token','role','symb','iptoken']);
     if (!defined($env{'form.firsturl'})) {      if (!defined($env{'form.firsturl'})) {
         &Apache::lonacc::get_posted_cgi($r,['firsturl']);          &Apache::lonacc::get_posted_cgi($r,['firsturl']);
     }      }
   
 # -- check if they are a migrating user  # -- check if they are a migrating user
     if (defined($env{'form.token'})) {      if (defined($env{'form.token'})) {
  return &Apache::migrateuser::handler($r);   return &Apache::migrateuser::handler($r);
     }      }
   
     &Apache::loncommon::no_cache($r);      &Apache::loncommon::no_cache($r);
     &Apache::lonlocal::get_language_handle($r);      &Apache::lonlocal::get_language_handle($r);
     &Apache::loncommon::content_type($r,'text/html');      &Apache::loncommon::content_type($r,'text/html');
     $r->send_http_header;      $r->send_http_header;
     return OK if $r->header_only;      return OK if $r->header_only;
   
   
 # Are we re-routing?  # Are we re-routing?
     my $londocroot = $r->dir_config('lonDocRoot');       my $londocroot = $r->dir_config('lonDocRoot');
     if (-e "$londocroot/lon-status/reroute.txt") {      if (-e "$londocroot/lon-status/reroute.txt") {
  &Apache::lonauth::reroute($r);   &Apache::lonauth::reroute($r);
  return OK;   return OK;
     }      }
   
     $env{'form.firsturl'} =~ s/(`)/'/g;      $env{'form.firsturl'} =~ s/(`)/'/g;
   
 # -------------------------------- Prevent users from attempting to login twice  # -------------------------------- Prevent users from attempting to login twice
     my $handle = &Apache::lonnet::check_for_valid_session($r);      my $handle = &Apache::lonnet::check_for_valid_session($r);
     if ($handle ne '') {      if ($handle ne '') {
         my $lonidsdir=$r->dir_config('lonIDsDir');          my $lonidsdir=$r->dir_config('lonIDsDir');
         if ($handle=~/^publicuser\_/) {          if ($handle=~/^publicuser\_/) {
 # For "public user" - remove it, we apparently really want to login  # For "public user" - remove it, we apparently really want to login
     unlink($r->dir_config('lonIDsDir')."/$handle.id");      unlink($r->dir_config('lonIDsDir')."/$handle.id");
         } else {          } else {
 # Indeed, a valid token is found  # Indeed, a valid token is found
             &Apache::lonnet::transfer_profile_to_env($lonidsdir,$handle);              &Apache::lonnet::transfer_profile_to_env($lonidsdir,$handle);
     my $start_page =       my $start_page =
         &Apache::loncommon::start_page('Already logged in');          &Apache::loncommon::start_page('Already logged in');
     my $end_page =       my $end_page =
         &Apache::loncommon::end_page();          &Apache::loncommon::end_page();
             my $dest = '/adm/roles';              my $dest = '/adm/roles';
             if ($env{'form.firsturl'} ne '') {              if ($env{'form.firsturl'} ne '') {
                 $dest = $env{'form.firsturl'};                   $dest = $env{'form.firsturl'};
             }              }
     $r->print(      $r->print(
                   $start_page                    $start_page
                  .'<p class="LC_warning">'.&mt('You are already logged in!').'</p>'                   .'<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].',                   .'<p>'.&mt('Please either [_1]continue the current session[_2] or [_3]log out[_4].',
                   '<a href="'.$dest.'">','</a>','<a href="/adm/logout">','</a>').'</p>'                    '<a href="'.$dest.'">','</a>','<a href="/adm/logout">','</a>').'</p>'
                  .$end_page                   .$end_page
                  );                   );
             return OK;              return OK;
         }          }
     }      }
   
 # ---------------------------------------------------- No valid token, continue  # ---------------------------------------------------- No valid token, continue
   
  # ---------------------------- Not possible to really login to domain "public"  # ---------------------------- Not possible to really login to domain "public"
     if ($env{'form.domain'} eq 'public') {      if ($env{'form.domain'} eq 'public') {
  $env{'form.domain'}='';   $env{'form.domain'}='';
  $env{'form.username'}='';   $env{'form.username'}='';
     }      }
 # ----------------------------------------------------------- Process Interface  
     $env{'form.interface'}=~s/\W//g;  # ------ Is this page requested because /adm/migrateuser detected an IP change?
       my %sessiondata;
     my $httpbrowser=$ENV{"HTTP_USER_AGENT"};      if ($env{'form.iptoken'}) {
           %sessiondata = &Apache::lonnet::tmpget($env{'form.iptoken'});
     my $iconpath=           my $delete = &Apache::lonnet::tmpdel($env{'form.token'});
  &Apache::loncommon::lonhttpdurl($r->dir_config('lonIconsURL'));      }
   # ----------------------------------------------------------- Process Interface
     my $lonhost = $r->dir_config('lonHostID');      $env{'form.interface'}=~s/\W//g;
     my $domain = &Apache::lonnet::default_login_domain();  
     if ($lonhost ne '') {      (undef,undef,undef,undef,undef,undef,my $clientmobile) =
         my $redirect = &check_loginvia($domain,$lonhost);          &Apache::loncommon::decode_user_agent();
         if ($redirect) {  
             $r->print($redirect);      my $iconpath=
             return OK;   &Apache::loncommon::lonhttpdurl($r->dir_config('lonIconsURL'));
         }   
     }      my $lonhost = $r->dir_config('lonHostID');
       my $domain = &Apache::lonnet::default_login_domain();
     if (($env{'form.domain'}) &&       if ($lonhost ne '') {
  (&Apache::lonnet::domain($env{'form.domain'},'description'))) {          unless ($sessiondata{'sessionserver'}) {
  $domain=$env{'form.domain'};              my $redirect = &check_loginvia($domain,$lonhost);
     }              if ($redirect) {
     my $role    = $r->dir_config('lonRole');                  $r->print($redirect);
     my $loadlim = $r->dir_config('lonLoadLim');                  return OK;
     my $uloadlim= $r->dir_config('lonUserLoadLim');              }
     my $servadm = $r->dir_config('lonAdmEMail');          }
     my $tabdir  = $r->dir_config('lonTabDir');      }
     my $include = $r->dir_config('lonIncludes');  
     my $expire  = $r->dir_config('lonExpire');      if (($sessiondata{'domain'}) &&
     my $version = $r->dir_config('lonVersion');          (&Apache::lonnet::domain($env{'form.domain'},'description'))) {
     my $host_name = &Apache::lonnet::hostname($lonhost);          $domain=$sessiondata{'domain'};
       } elsif (($env{'form.domain'}) &&
 # --------------------------------------------- Default values for login fields   (&Apache::lonnet::domain($env{'form.domain'},'description'))) {
    $domain=$env{'form.domain'};
     my $authusername=($env{'form.username'}?$env{'form.username'}:'');      }
     my $authdomain=($env{'form.domain'}?$env{'form.domain'}:$domain);  
       my $role    = $r->dir_config('lonRole');
 # ---------------------------------------------------------- Determine own load      my $loadlim = $r->dir_config('lonLoadLim');
     my $loadavg;      my $uloadlim= $r->dir_config('lonUserLoadLim');
     {      my $servadm = $r->dir_config('lonAdmEMail');
  my $loadfile=Apache::File->new('/proc/loadavg');      my $tabdir  = $r->dir_config('lonTabDir');
  $loadavg=<$loadfile>;      my $include = $r->dir_config('lonIncludes');
     }      my $expire  = $r->dir_config('lonExpire');
     $loadavg =~ s/\s.*//g;      my $version = $r->dir_config('lonVersion');
       my $host_name = &Apache::lonnet::hostname($lonhost);
     my ($loadpercent,$userloadpercent);  
     if ($loadlim) {  # --------------------------------------------- Default values for login fields
         $loadpercent=sprintf("%.1f",100*$loadavg/$loadlim);     
     }      my ($authusername,$authdomain);
     if ($uloadlim) {      if ($sessiondata{'username'}) {
         $userloadpercent=&Apache::lonnet::userload();          $authusername=$sessiondata{'username'};
     }      } else {
           $env{'form.username'} = &Apache::loncommon::cleanup_html($env{'form.username'});
     my $firsturl=          $authusername=($env{'form.username'}?$env{'form.username'}:'');
     ($env{'request.firsturl'}?$env{'request.firsturl'}:$env{'form.firsturl'});      }
       if ($sessiondata{'domain'}) {
 # ----------------------------------------------------------- Get announcements          $authdomain=$sessiondata{'domain'};
     my $announcements=&Apache::lonnet::getannounce();      } else {
 # -------------------------------------------------------- Set login parameters          $env{'form.domain'} = &Apache::loncommon::cleanup_html($env{'form.domain'});
           $authdomain=($env{'form.domain'}?$env{'form.domain'}:$domain);
     my @hexstr=('0','1','2','3','4','5','6','7',      }
                 '8','9','a','b','c','d','e','f');  
     my $lkey='';  # ---------------------------------------------------------- Determine own load
     for (0..7) {      my $loadavg;
         $lkey.=$hexstr[rand(15)];      {
     }   my $loadfile=Apache::File->new('/proc/loadavg');
    $loadavg=<$loadfile>;
     my $ukey='';      }
     for (0..7) {      $loadavg =~ s/\s.*//g;
         $ukey.=$hexstr[rand(15)];  
     }      my ($loadpercent,$userloadpercent);
       if ($loadlim) {
     my $lextkey=hex($lkey);          $loadpercent=sprintf("%.1f",100*$loadavg/$loadlim);
     if ($lextkey>2147483647) { $lextkey-=4294967296; }      }
       if ($uloadlim) {
     my $uextkey=hex($ukey);          $userloadpercent=&Apache::lonnet::userload();
     if ($uextkey>2147483647) { $uextkey-=4294967296; }      }
   
 # -------------------------------------------------------- Store away log token      my $firsturl=
     my $tokenextras;      ($env{'request.firsturl'}?$env{'request.firsturl'}:$env{'form.firsturl'});
     if ($env{'form.role'}) {  
         $tokenextras = '&role='.&escape($env{'form.role'});  # ----------------------------------------------------------- Get announcements
     }      my $announcements=&Apache::lonnet::getannounce();
     if ($env{'form.symb'}) {  # -------------------------------------------------------- Set login parameters
         if (!$tokenextras) {  
             $tokenextras = '&';      my @hexstr=('0','1','2','3','4','5','6','7',
         }                  '8','9','a','b','c','d','e','f');
         $tokenextras .= '&symb='.&escape($env{'form.symb'});      my $lkey='';
     }      for (0..7) {
     my $logtoken=Apache::lonnet::reply(          $lkey.=$hexstr[rand(15)];
        'tmpput:'.$ukey.$lkey.'&'.$firsturl.$tokenextras,      }
        $lonhost);  
       my $ukey='';
 # -- If we cannot talk to ourselves, or hostID does not map to a hostname      for (0..7) {
 #    we are in serious trouble          $ukey.=$hexstr[rand(15)];
       }
     if (($logtoken eq 'con_lost') || ($logtoken eq 'no_such_host')) {  
         if ($logtoken eq 'no_such_host') {      my $lextkey=hex($lkey);
             &Apache::lonnet::logthis('No valid logtoken for log-in page -- unable to determine hostname for hostID: '.$lonhost.'. Check entry in hosts.tab');      if ($lextkey>2147483647) { $lextkey-=4294967296; }
         }  
         my $spares='';      my $uextkey=hex($ukey);
  my $last;      if ($uextkey>2147483647) { $uextkey-=4294967296; }
         foreach my $hostid (sort  
     {  # -------------------------------------------------------- Store away log token
  &Apache::lonnet::hostname($a) cmp      my $tokenextras;
     &Apache::lonnet::hostname($b);      if ($env{'form.role'}) {
     }          $tokenextras = '&role='.&escape($env{'form.role'});
     keys(%Apache::lonnet::spareid)) {      }
             next if ($hostid eq $lonhost);      if ($env{'form.symb'}) {
     my $hostname = &Apache::lonnet::hostname($hostid);          if (!$tokenextras) {
     next if (($last eq $hostname) || ($hostname eq ''));              $tokenextras = '&';
             $spares.='<br /><font size="+1"><a href="http://'.          }
                 $hostname.          $tokenextras .= '&symb='.&escape($env{'form.symb'});
                 '/adm/login?domain='.$authdomain.'">'.      }
                 $hostname.'</a>'.      my $logtoken=Apache::lonnet::reply(
                 ' '.&mt('(preferred)').'</font>'.$/;         'tmpput:'.$ukey.$lkey.'&'.$firsturl.$tokenextras,
     $last=$hostname;         $lonhost);
         }  
         if ($spares) {  # -- If we cannot talk to ourselves, or hostID does not map to a hostname
             $spares.= '<br />';  #    we are in serious trouble
         }  
 my %all_hostnames = &Apache::lonnet::all_hostnames();      if (($logtoken eq 'con_lost') || ($logtoken eq 'no_such_host')) {
 foreach my $hostid (sort          if ($logtoken eq 'no_such_host') {
     {              &Apache::lonnet::logthis('No valid logtoken for log-in page -- unable to determine hostname for hostID: '.$lonhost.'. Check entry in hosts.tab');
  &Apache::lonnet::hostname($a) cmp          }
     &Apache::lonnet::hostname($b);          my $spares='';
     }   my $last;
     keys(%all_hostnames)) {          foreach my $hostid (sort
     next if ($hostid eq $lonhost || $Apache::lonnet::spareid{$hostid});      {
     my $hostname = &Apache::lonnet::hostname($hostid);   &Apache::lonnet::hostname($a) cmp
     next if (($last eq $hostname) || ($hostname eq ''));      &Apache::lonnet::hostname($b);
     $spares.='<br /><a href="http://'.      }
  $hostname.      keys(%Apache::lonnet::spareid)) {
  '/adm/login?domain='.$authdomain.'">'.              next if ($hostid eq $lonhost);
  $hostname.'</a>';      my $hostname = &Apache::lonnet::hostname($hostid);
     $last=$hostname;      next if (($last eq $hostname) || ($hostname eq ''));
 }              $spares.='<br /><font size="+1"><a href="http://'.
 $r->print(                  $hostname.
    '<html>'                  '/adm/login?domain='.$authdomain.'">'.
   .'<head><title>'                  $hostname.'</a>'.
   .&mt('The LearningOnline Network with CAPA')                  ' '.&mt('(preferred)').'</font>'.$/;
   .'</title></head>'      $last=$hostname;
   .'<body bgcolor="#FFFFFF">'          }
   .'<h1>'.&mt('The LearningOnline Network with CAPA').'</h1>'          if ($spares) {
   .'<img src="/adm/lonKaputt/lonlogo_broken.gif" align="right" />'              $spares.= '<br />';
   .'<h3>'.&mt('This LON-CAPA server is temporarily not available for login.').'</h3>');          }
     if ($spares) {          my %all_hostnames = &Apache::lonnet::all_hostnames();
         $r->print('<p>'.&mt('Please attempt to login to one of the following servers:')          foreach my $hostid (sort
                  .'</p>'      {
                  .$spares);   &Apache::lonnet::hostname($a) cmp
     }      &Apache::lonnet::hostname($b);
     $r->print('</body>'      }
   .'</html>'      keys(%all_hostnames)) {
     );              next if ($hostid eq $lonhost || $Apache::lonnet::spareid{$hostid});
 return OK;              my $hostname = &Apache::lonnet::hostname($hostid);
 }              next if (($last eq $hostname) || ($hostname eq ''));
               $spares.='<br /><a href="http://'.
 # ----------------------------------------------- Apparently we are in business               $hostname.
 $servadm=~s/\,/\<br \/\>/g;               '/adm/login?domain='.$authdomain.'">'.
                $hostname.'</a>';
 # ----------------------------------------------------------- Front page design              $last=$hostname;
 my $pgbg=&Apache::loncommon::designparm('login.pgbg',$domain);           }
 my $font=&Apache::loncommon::designparm('login.font',$domain);           $r->print(
 my $link=&Apache::loncommon::designparm('login.link',$domain);     '<html>'
 my $vlink=&Apache::loncommon::designparm('login.vlink',$domain);    .'<head><title>'
 my $alink=&Apache::loncommon::designparm('login.alink',$domain);    .&mt('The LearningOnline Network with CAPA')
 my $mainbg=&Apache::loncommon::designparm('login.mainbg',$domain);    .'</title></head>'
 my $loginbox_bg=&Apache::loncommon::designparm('login.sidebg',$domain);    .'<body bgcolor="#FFFFFF">'
 my $loginbox_header_bgcol=&Apache::loncommon::designparm('login.bgcol',$domain);    .'<h1>'.&mt('The LearningOnline Network with CAPA').'</h1>'
 my $loginbox_header_textcol=&Apache::loncommon::designparm('login.textcol',$domain);    .'<img src="/adm/lonKaputt/lonlogo_broken.gif" align="right" />'
 my $logo=&Apache::loncommon::designparm('login.logo',$domain);    .'<h3>'.&mt('This LON-CAPA server is temporarily not available for login.').'</h3>');
 my $img=&Apache::loncommon::designparm('login.img',$domain);          if ($spares) {
 my $domainlogo=&Apache::loncommon::domainlogo($domain);              $r->print('<p>'.&mt('Please attempt to login to one of the following servers:')
 my $showbanner = 1;                       .'</p>'
 my $showmainlogo = 1;                       .$spares);
 if (defined(&Apache::loncommon::designparm('login.showlogo_img',$domain))) {          }
     $showbanner = &Apache::loncommon::designparm('login.showlogo_img',$domain);          $r->print('</body>'
 }                   .'</html>'
 if (defined(&Apache::loncommon::designparm('login.showlogo_logo',$domain))) {          );
     $showmainlogo = &Apache::loncommon::designparm('login.showlogo_logo',$domain);          return OK;
 }      }
 my $showadminmail=&Apache::loncommon::designparm('login.adminmail',$domain);  
 my $showcoursecat =  # ----------------------------------------------- Apparently we are in business
 &Apache::loncommon::designparm('login.coursecatalog',$domain);      $servadm=~s/\,/\<br \/\>/g;
 my $shownewuserlink =   
 &Apache::loncommon::designparm('login.newuser',$domain);  # ----------------------------------------------------------- Front page design
 my $now=time;      my $pgbg=&Apache::loncommon::designparm('login.pgbg',$domain);
 my $js = (<<ENDSCRIPT);      my $font=&Apache::loncommon::designparm('login.font',$domain);
       my $link=&Apache::loncommon::designparm('login.link',$domain);
 <script type="text/javascript" language="JavaScript">      my $vlink=&Apache::loncommon::designparm('login.vlink',$domain);
 // <![CDATA[      my $alink=&Apache::loncommon::designparm('login.alink',$domain);
 function send()      my $mainbg=&Apache::loncommon::designparm('login.mainbg',$domain);
 {      my $loginbox_bg=&Apache::loncommon::designparm('login.sidebg',$domain);
 this.document.server.elements.uname.value      my $loginbox_header_bgcol=&Apache::loncommon::designparm('login.bgcol',$domain);
 =this.document.client.elements.uname.value;      my $loginbox_header_textcol=&Apache::loncommon::designparm('login.textcol',$domain);
       my $logo=&Apache::loncommon::designparm('login.logo',$domain);
 this.document.server.elements.udom.value      my $img=&Apache::loncommon::designparm('login.img',$domain);
 =this.document.client.elements.udom.value;      my $domainlogo=&Apache::loncommon::domainlogo($domain);
       my $showbanner = 1;
 uextkey=this.document.client.elements.uextkey.value;      my $showmainlogo = 1;
 lextkey=this.document.client.elements.lextkey.value;      if (defined(&Apache::loncommon::designparm('login.showlogo_img',$domain))) {
 initkeys();          $showbanner = &Apache::loncommon::designparm('login.showlogo_img',$domain);
       }
 this.document.server.elements.upass0.value      if (defined(&Apache::loncommon::designparm('login.showlogo_logo',$domain))) {
     =crypted(this.document.client.elements.upass$now.value.substr(0,15));          $showmainlogo = &Apache::loncommon::designparm('login.showlogo_logo',$domain);
 this.document.server.elements.upass1.value      }
     =crypted(this.document.client.elements.upass$now.value.substr(15,15));      my $showadminmail;
 this.document.server.elements.upass2.value      my @possdoms = &Apache::lonnet::current_machine_domains();
     =crypted(this.document.client.elements.upass$now.value.substr(30,15));      if (grep(/^\Q$domain\E$/,@possdoms)) {
           $showadminmail=&Apache::loncommon::designparm('login.adminmail',$domain);
 this.document.client.elements.uname.value='';      }
 this.document.client.elements.upass$now.value='';      my $showcoursecat =
           &Apache::loncommon::designparm('login.coursecatalog',$domain);
 this.document.server.submit();      my $shownewuserlink =
 return false;          &Apache::loncommon::designparm('login.newuser',$domain);
 }      my $showhelpdesk =
           &Apache::loncommon::designparm('login.helpdesk',$domain);
 function enableInput() {      my $now=time;
     this.document.client.elements.upass$now.removeAttribute("readOnly");      my $js = (<<ENDSCRIPT);
     this.document.client.elements.uname.removeAttribute("readOnly");  
     this.document.client.elements.udom.removeAttribute("readOnly");  <script type="text/javascript" language="JavaScript">
     return;  // <![CDATA[
 }  function send()
   {
 // ]]>  this.document.server.elements.uname.value
 </script>  =this.document.client.elements.uname.value;
   
 ENDSCRIPT  this.document.server.elements.udom.value
   =this.document.client.elements.udom.value;
 # --------------------------------------------------- Print login screen header  
   uextkey=this.document.client.elements.uextkey.value;
 my %add_entries = (  lextkey=this.document.client.elements.lextkey.value;
        bgcolor      => "$mainbg",  initkeys();
        text         => "$font",  
        link         => "$link",  this.document.server.elements.upass0.value
        vlink        => "$vlink",      =this.document.client.elements.upass$now.value.substr(0,15);
        alink        => "$alink",  this.document.server.elements.upass1.value
                onload       => 'javascript:enableInput();',);      =this.document.client.elements.upass$now.value.substr(15,15);
   this.document.server.elements.upass2.value
 $r->print(&Apache::loncommon::start_page('The LearningOnline Network with CAPA Login',$js,      =this.document.client.elements.upass$now.value.substr(30,15);
        { 'redirect'       => [$expire,'/adm/roles'],   
  'add_entries' => \%add_entries,  if(this.document.server.action.substr(0,5) === 'http:'){
  'only_body'   => 1,}));      for (var idx in [1,2,3]){
           this.document.server.elements['upass' + idx].value =
 # ----------------------------------------------------------------------- Texts              crypted(this.document.server.elements['upass' + idx].value);
       }
 my %lt=&Apache::lonlocal::texthash(  }
           'un'       => 'Username',  
           'pw'       => 'Password',  this.document.client.elements.uname.value='';
           'dom'      => 'Domain',  this.document.client.elements.upass$now.value='';
           'perc'     => 'percent',  
           'load'     => 'Server Load',  this.document.server.submit();
           'userload' => 'User Load',  return false;
           'catalog'  => 'Course/Community Catalog',  }
           'log'      => 'Log in',  
           'help'     => 'Log-in Help',  function enableInput() {
           'serv'     => 'Server',      this.document.client.elements.upass$now.removeAttribute("readOnly");
           'servadm'  => 'Server Administration',      this.document.client.elements.uname.removeAttribute("readOnly");
           'helpdesk' => 'Contact Helpdesk',      this.document.client.elements.udom.removeAttribute("readOnly");
           'forgotpw' => 'Forgot password?',      return;
           'newuser'  => 'New User?',  }
        );  
 # -------------------------------------------------- Change password field name  // ]]>
   </script>
 my $forgotpw = &forgotpwdisplay(%lt);  
 $forgotpw .= '<br />' if $forgotpw;  ENDSCRIPT
 my $loginhelp = &loginhelpdisplay($authdomain,%lt);  
 $loginhelp .= '<br />' if $loginhelp;  # --------------------------------------------------- Print login screen header
   
 # ---------------------------------------------------- Serve out DES JavaScript      my %add_entries = (
 {         bgcolor      => "$mainbg",
 my $jsh=Apache::File->new($include."/londes.js");         text         => "$font",
 $r->print(<$jsh>);         link         => "$link",
 }         vlink        => "$vlink",
 # ---------------------------------------------------------- Serve rest of page         alink        => "$alink",
                  onload       => 'javascript:enableInput();',);
 $r->print(  
     '<div class="LC_Box"'      $r->print(&Apache::loncommon::start_page('The LearningOnline Network with CAPA Login',$js,
    .' style="margin:0 auto; padding:10px; width:90%; height: auto; background-color:#FFFFFF;">'         { 'redirect'       => [$expire,'/adm/roles'],
 );   'add_entries' => \%add_entries,
    'only_body'   => 1,}));
 #  
 #  If the loadbalancing yielded just http:// because perhaps there's no loadbalancing?  # ----------------------------------------------------------------------- Texts
 #  then just us a relative link to authenticate:  
 #      my %lt=&Apache::lonlocal::texthash(
             'un'       => 'Username',
 $r->print(<<ENDSERVERFORM);            'pw'       => 'Password',
 <form name="server" action="/adm/authenticate" method="post" target="_top">            'dom'      => 'Domain',
    <input type="hidden" name="logtoken" value="$logtoken" />            'perc'     => 'percent',
    <input type="hidden" name="serverid" value="$lonhost" />            'load'     => 'Server Load',
    <input type="hidden" name="uname" value="" />            'userload' => 'User Load',
    <input type="hidden" name="upass0" value="" />            'catalog'  => 'Course/Community Catalog',
    <input type="hidden" name="upass1" value="" />            'log'      => 'Log in',
    <input type="hidden" name="upass2" value="" />            'help'     => 'Log-in Help',
    <input type="hidden" name="udom" value="" />            'serv'     => 'Server',
    <input type="hidden" name="localpath" value="$env{'form.localpath'}" />            'servadm'  => 'Server Administration',
    <input type="hidden" name="localres" value="$env{'form.localres'}" />            'helpdesk' => 'Contact Helpdesk',
   </form>            'forgotpw' => 'Forgot password?',
 ENDSERVERFORM            'newuser'  => 'New User?',
 my $coursecatalog;         );
 if (($showcoursecat eq '') || ($showcoursecat)) {  # -------------------------------------------------- Change password field name
     $coursecatalog = &coursecatalog_link($lt{'catalog'}).'<br />';  
 }      my $forgotpw = &forgotpwdisplay(%lt);
 my $newuserlink;      $forgotpw .= '<br />' if $forgotpw;
 if ($shownewuserlink) {      my $loginhelp = &Apache::lonauth::loginhelpdisplay($authdomain);
     $newuserlink = &newuser_link($lt{'newuser'}).'<br />';      if ($loginhelp) {
 }          $loginhelp = '<a href="'.$loginhelp.'">'.$lt{'help'}.'</a><br />';
 my $logintitle =      }
     '<h2 class="LC_hcell"'  
    .' style="background:'.$loginbox_header_bgcol.';'  # ---------------------------------------------------- Serve out DES JavaScript
    .' color:'.$loginbox_header_textcol.'">'      {
    .$lt{'log'}      my $jsh=Apache::File->new($include."/londes.js");
    .'</h2>';      $r->print(<$jsh>);
       }
 my $noscript_warning='<noscript><span class="LC_warning"><b>'  # ---------------------------------------------------------- Serve rest of page
                      .&mt('Use of LON-CAPA requires Javascript to be enabled in your web browser.')  
                     .'</b></span></noscript>';      $r->print(
 my $helpdeskscript;      '<div class="LC_Box"'
 my $contactblock = &contactdisplay(\%lt,$servadm,$showadminmail,     .' style="margin:0 auto; padding:10px; width:90%; height: auto; background-color:#FFFFFF;">'
                                    $authdomain,\$helpdeskscript);  );
   
 my $loginform=(<<LFORM);      $r->print(<<ENDSERVERFORM);
 <form name="client" action="" onsubmit="return(send())">  <form name="server" action="/adm/authenticate" method="post" target="_top">
   <input type="hidden" name="lextkey" value="$lextkey" />     <input type="hidden" name="logtoken" value="$logtoken" />
   <input type="hidden" name="uextkey" value="$uextkey" />     <input type="hidden" name="serverid" value="$lonhost" />
   <b><label for="uname">$lt{'un'}</label>:</b><br />     <input type="hidden" name="uname" value="" />
   <input type="text" name="uname" id="uname" size="15" value="$authusername" readonly="readonly" /><br />     <input type="hidden" name="upass0" value="" />
   <b><label for="upass$now">$lt{'pw'}</label>:</b><br />     <input type="hidden" name="upass1" value="" />
   <input type="password" name="upass$now" id="upass$now" size="15" readonly="readonly" /><br />     <input type="hidden" name="upass2" value="" />
   <b><label for="udom">$lt{'dom'}</label>:</b><br />     <input type="hidden" name="udom" value="" />
   <input type="text" name="udom" id="udom" size="15" value="$authdomain" readonly="readonly" /><br />     <input type="hidden" name="localpath" value="$env{'form.localpath'}" />
   <input type="submit" value="$lt{'log'}" />     <input type="hidden" name="localres" value="$env{'form.localres'}" />
 </form>    </form>
 LFORM  ENDSERVERFORM
       my $coursecatalog;
     if ($showbanner) {      if (($showcoursecat eq '') || ($showcoursecat)) {
         $r->print(<<HEADER);          $coursecatalog = &coursecatalog_link($lt{'catalog'}).'<br />';
 <!-- The LON-CAPA Header -->      }
 <div style="background:$pgbg;margin:0;width:100%;">      my $newuserlink;
   <img src="$img" border="0" alt="The Learning Online Network with CAPA" />      if ($shownewuserlink) {
 </div>          $newuserlink = &newuser_link($lt{'newuser'}).'<br />';
 HEADER      }
     }      my $logintitle =
     $r->print(<<ENDTOP);          '<h2 class="LC_hcell"'
 <div style="float:left;margin-top:0;">         .' style="background:'.$loginbox_header_bgcol.';'
 <div class="LC_Box" style="background:$loginbox_bg;">         .' color:'.$loginbox_header_textcol.'">'
   $logintitle         .$lt{'log'}
   $loginform         .'</h2>';
   $noscript_warning  
 </div>      my $noscript_warning='<noscript><span class="LC_warning"><b>'
                             .&mt('Use of LON-CAPA requires Javascript to be enabled in your web browser.')
 <div class="LC_Box" style="padding-top: 10px;">                          .'</b></span></noscript>';
   $loginhelp      my $helpdeskscript;
   $forgotpw      my $contactblock = &contactdisplay(\%lt,$servadm,$showadminmail,
   $contactblock                                         $authdomain,\$helpdeskscript,
   $newuserlink                                         $showhelpdesk,\@possdoms);
   $coursecatalog  
 </div>      my $mobileargs;
 </div>      if ($clientmobile) {
           $mobileargs = 'autocapitalize="off" autocorrect="off"';
 <div>      }
 ENDTOP      my $loginform=(<<LFORM);
     if ($showmainlogo) {  <form name="client" action="" onsubmit="return(send())">
         $r->print(' <img src="'.$logo.'" alt="" />'."\n");    <input type="hidden" name="lextkey" value="$lextkey" />
     }    <input type="hidden" name="uextkey" value="$uextkey" />
 $r->print(<<ENDTOP);    <b><label for="uname">$lt{'un'}</label>:</b><br />
 $announcements    <input type="text" name="uname" id="uname" size="15" value="$authusername" readonly="readonly" $mobileargs /><br />
 </div>    <b><label for="upass$now">$lt{'pw'}</label>:</b><br />
 <hr style="clear:both;" />    <input type="password" name="upass$now" id="upass$now" size="15" readonly="readonly" /><br />
 ENDTOP    <b><label for="udom">$lt{'dom'}</label>:</b><br />
     my ($domainrow,$serverrow,$loadrow,$userloadrow,$versionrow);    <input type="text" name="udom" id="udom" size="15" value="$authdomain" readonly="readonly" $mobileargs /><br />
     $domainrow = <<"END";    <input type="submit" value="$lt{'log'}" />
       <tr>  </form>
        <td  align="left" valign="top">  LFORM
         <small><b>$lt{'dom'}:&nbsp;</b></small>  
        </td>      if ($showbanner) {
        <td  align="left" valign="top">          $r->print(<<HEADER);
         <small><tt>&nbsp;$domain</tt></small>  <!-- The LON-CAPA Header -->
        </td>  <div style="background:$pgbg;margin:0;width:100%;">
       </tr>    <img src="$img" border="0" alt="The Learning Online Network with CAPA" />
 END  </div>
     $serverrow = <<"END";  HEADER
       <tr>      }
        <td  align="left" valign="top">      $r->print(<<ENDTOP);
         <small><b>$lt{'serv'}:&nbsp;</b></small>  <div style="float:left;margin-top:0;">
        </td>  <div class="LC_Box" style="background:$loginbox_bg;">
        <td align="left" valign="top">    $logintitle
         <small><tt>&nbsp;$lonhost ($role)</tt></small>    $loginform
        </td>    $noscript_warning
       </tr>  </div>
 END   
     if ($loadlim) {  <div class="LC_Box" style="padding-top: 10px;">
         $loadrow = <<"END";    $loginhelp
       <tr>    $forgotpw
        <td align="left" valign="top">    $contactblock
         <small><b>$lt{'load'}:&nbsp;</b></small>    $newuserlink
        </td>    $coursecatalog
        <td align="left" valign="top">  </div>
         <small><tt>&nbsp;$loadpercent $lt{'perc'}</tt></small>  </div>
        </td>  
       </tr>  <div>
 END  ENDTOP
     }      if ($showmainlogo) {
     if ($uloadlim) {          $r->print(' <img src="'.$logo.'" alt="" />'."\n");
         $userloadrow = <<"END";      }
       <tr>  $r->print(<<ENDTOP);
        <td align="left" valign="top">  $announcements
         <small><b>$lt{'userload'}:&nbsp;</b></small>  </div>
        </td>  <hr style="clear:both;" />
        <td align="left" valign="top">  ENDTOP
         <small><tt>&nbsp;$userloadpercent $lt{'perc'}</tt></small>      my ($domainrow,$serverrow,$loadrow,$userloadrow,$versionrow);
        </td>      $domainrow = <<"END";
       </tr>        <tr>
 END         <td  align="left" valign="top">
     }          <small><b>$lt{'dom'}:&nbsp;</b></small>
     if (($version ne '') && ($version ne '<!-- VERSION -->')) {         </td>
         $versionrow = <<"END";         <td  align="left" valign="top">
       <tr>          <small><tt>&nbsp;$domain</tt></small>
        <td colspan="2" align="left">         </td>
         <small>$version</small>        </tr>
        </td>  END
       </tr>      $serverrow = <<"END";
 END        <tr>
     }         <td  align="left" valign="top">
           <small><b>$lt{'serv'}:&nbsp;</b></small>
 $r->print(<<ENDDOCUMENT);         </td>
     <div style="float: left;">         <td align="left" valign="top">
      <table border="0" cellspacing="0" cellpadding="0">          <small><tt>&nbsp;$lonhost ($role)</tt></small>
 $domainrow         </td>
 $serverrow        </tr>
 $loadrow      END
 $userloadrow      if ($loadlim) {
 $versionrow          $loadrow = <<"END";
      </table>        <tr>
     </div>         <td align="left" valign="top">
     <div style="float: right;">          <small><b>$lt{'load'}:&nbsp;</b></small>
     $domainlogo         </td>
     </div>         <td align="left" valign="top">
     <br style="clear:both;" />          <small><tt>&nbsp;$loadpercent $lt{'perc'}</tt></small>
  </div>         </td>
         </tr>
 <script type="text/javascript">  END
 // <![CDATA[      }
 // the if prevents the script error if the browser can not handle this      if ($uloadlim) {
 if ( document.client.uname ) { document.client.uname.focus(); }          $userloadrow = <<"END";
 // ]]>        <tr>
 </script>         <td align="left" valign="top">
 $helpdeskscript          <small><b>$lt{'userload'}:&nbsp;</b></small>
          </td>
 ENDDOCUMENT         <td align="left" valign="top">
     my %endargs = ( 'noredirectlink' => 1, );          <small><tt>&nbsp;$userloadpercent $lt{'perc'}</tt></small>
     $r->print(&Apache::loncommon::end_page(\%endargs));         </td>
     return OK;        </tr>
 }  END
       }
 sub check_loginvia {      if (($version ne '') && ($version ne '<!-- VERSION -->')) {
     my ($domain,$lonhost) = @_;          $versionrow = <<"END";
     if ($domain eq '' || $lonhost eq '') {        <tr>
         return;         <td colspan="2" align="left">
     }          <small>$version</small>
     my %domconfhash = &Apache::loncommon::get_domainconf($domain);         </td>
     my $loginvia = $domconfhash{$domain.'.login.loginvia_'.$lonhost};        </tr>
     my $loginvia_exempt = $domconfhash{$domain.'.login.loginvia_exempt_'.$lonhost};  END
     my $output;      }
     if ($loginvia ne '') {  
         my $noredirect;      $r->print(<<ENDDOCUMENT);
         my $ip = $ENV{'REMOTE_ADDR'};      <div style="float: left;">
         if ($ip eq '127.0.0.1') {       <table border="0" cellspacing="0" cellpadding="0">
             $noredirect = 1;  $domainrow
         } else {  $serverrow
             if ($loginvia_exempt ne '') {  $loadrow    
                 my @exempt = split(',',$loginvia_exempt);  $userloadrow
                 if (grep(/^\Q$ip\E$/,@exempt)) {  $versionrow
                     $noredirect = 1;       </table>
                 }      </div>
             }      <div style="float: right;">
         }      $domainlogo
         unless ($noredirect) {      </div>
             my ($newhost,$path);      <br style="clear:both;" />
             if ($loginvia =~ /:/) {   </div>
                 ($newhost,$path) = split(':',$loginvia);  
             } else {  <script type="text/javascript">
                 $newhost = $loginvia;  // <![CDATA[
             }  // the if prevents the script error if the browser can not handle this
             if ($newhost ne $lonhost) {  if ( document.client.uname ) { document.client.uname.focus(); }
                 if (&Apache::lonnet::hostname($newhost) ne '') {  // ]]>
                     $output = &redirect_page($newhost,$path);  </script>
                 }  $helpdeskscript
             }  
         }  ENDDOCUMENT
     }      my %endargs = ( 'noredirectlink' => 1, );
     return $output;      $r->print(&Apache::loncommon::end_page(\%endargs));
 }      return OK;
   }
 sub redirect_page {  
     my ($desthost,$path) = @_;  sub check_loginvia {
     my $protocol = $Apache::lonnet::protocol{$desthost};      my ($domain,$lonhost) = @_;
     $protocol = 'http' if ($protocol ne 'https');      if ($domain eq '' || $lonhost eq '') {
     unless ($path =~ m{^/}) {          return;
         $path = '/'.$path;      }
     }      my %domconfhash = &Apache::loncommon::get_domainconf($domain);
     my $url = $protocol.'://'.&Apache::lonnet::hostname($desthost).$path;      my $loginvia = $domconfhash{$domain.'.login.loginvia_'.$lonhost};
     if ($env{'form.firsturl'} ne '') {      my $loginvia_exempt = $domconfhash{$domain.'.login.loginvia_exempt_'.$lonhost};
         $url .='?firsturl='.$env{'form.firsturl'};      my $output;
     }      if ($loginvia ne '') {
     my $start_page = &Apache::loncommon::start_page('Switching Server ...',undef,          my $noredirect;
                                                     {'redirect' => [0,$url],});          my $ip = $ENV{'REMOTE_ADDR'};
     my $end_page   = &Apache::loncommon::end_page();          if ($ip eq '127.0.0.1') {
     return $start_page.$end_page;              $noredirect = 1;
 }          } else {
               if ($loginvia_exempt ne '') {
 sub contactdisplay {                  my @exempt = split(',',$loginvia_exempt);
     my ($lt,$servadm,$showadminmail,$authdomain,$helpdeskscript) = @_;                  if (grep(/^\Q$ip\E$/,@exempt)) {
     my $contactblock;                      $noredirect = 1;
     my $showhelpdesk = 0;                  }
     my $requestmail = $Apache::lonnet::perlvar{'lonSupportEMail'};              }
     if ($requestmail =~ m/^[^\@]+\@[^\@]+$/) {          }
         $showhelpdesk = 1;          unless ($noredirect) {
     }              my ($newhost,$path);
     if ($servadm && $showadminmail) {              if ($loginvia =~ /:/) {
         $contactblock .= $$lt{'servadm'}.':<br />'.                  ($newhost,$path) = split(':',$loginvia);
                          '<tt>'.$servadm.'</tt><br />';              } else {
     }                  $newhost = $loginvia;
     if ($showhelpdesk) {              }
         $contactblock .= '<a href="javascript:helpdesk()">'.$lt->{'helpdesk'}.'</a><br />';              if ($newhost ne $lonhost) {
         my $thisurl = &escape('/adm/login');                  if (&Apache::lonnet::hostname($newhost) ne '') {
         $$helpdeskscript = <<"ENDSCRIPT";                      $output = &redirect_page($newhost,$path);
 <script type="text/javascript">                  }
 // <![CDATA[              }
 function helpdesk() {          }
     var codedom = document.client.udom.value;      }
     if (codedom == '') {      return $output;
         codedom = "$authdomain";  }
     }  
     var querystr = "origurl=$thisurl&codedom="+codedom;  sub redirect_page {
     document.location.href = "/adm/helpdesk?"+querystr;      my ($desthost,$path) = @_;
     return;      my $protocol = $Apache::lonnet::protocol{$desthost};
 }      $protocol = 'http' if ($protocol ne 'https');
 // ]]>      unless ($path =~ m{^/}) {
 </script>          $path = '/'.$path;
 ENDSCRIPT      }
     }      my $url = $protocol.'://'.&Apache::lonnet::hostname($desthost).$path;
     return $contactblock;      if ($env{'form.firsturl'} ne '') {
 }          $url .='?firsturl='.$env{'form.firsturl'};
       }
 sub forgotpwdisplay {      my $start_page = &Apache::loncommon::start_page('Switching Server ...',undef,
     my (%lt) = @_;                                                      {'redirect' => [0,$url],});
     my $prompt_for_resetpw = 1;       my $end_page   = &Apache::loncommon::end_page();
     if ($prompt_for_resetpw) {      return $start_page.$end_page;
         return '<a href="/adm/resetpw">'.$lt{'forgotpw'}.'</a>';  }
     }  
     return;  sub contactdisplay {
 }      my ($lt,$servadm,$showadminmail,$authdomain,$helpdeskscript,$showhelpdesk,
           $possdoms) = @_;
 sub loginhelpdisplay {      my $contactblock;
     my ($authdomain,%lt) = @_;      my $origmail;
     my $login_help = 1;      if (ref($possdoms) eq 'ARRAY') {
     if ($login_help) {          if (grep(/^\Q$authdomain\E$/,@{$possdoms})) {
         my $dom = $authdomain;              $origmail = $Apache::lonnet::perlvar{'lonSupportEMail'};
         if ($dom eq '') {          }
             $dom = &Apache::lonnet::default_login_domain();      }
         }      my $requestmail =
         my %helpconfig = &Apache::lonnet::get_dom('configuration',['helpsettings'],$dom);          &Apache::loncommon::build_recipient_list(undef,'helpdeskmail',
         my $loginhelp_url = $helpconfig{'helpsettings'}{'loginhelpurl'};                                                   $authdomain,$origmail);
         if ($loginhelp_url ne '') {      unless ($showhelpdesk eq '0') {
             return '<a href="'.$loginhelp_url.'">'.$lt{'help'}.'</a>';          if ($requestmail =~ m/[^\@]+\@[^\@]+/) {
         } else {              $showhelpdesk = 1;
             return '<a href="/adm/loginproblems.html">'.$lt{'help'}.'</a>';          } else {
         }              $showhelpdesk = 0;
     }          }
     return;      }
 }      if ($servadm && $showadminmail) {
           $contactblock .= $$lt{'servadm'}.':<br />'.
 sub coursecatalog_link {                           '<tt>'.$servadm.'</tt><br />';
     my ($linkname) = @_;      }
     return <<"END";      if ($showhelpdesk) {
       <a href="/adm/coursecatalog">$linkname</a>          $contactblock .= '<a href="javascript:helpdesk()">'.$lt->{'helpdesk'}.'</a><br />';
 END          my $thisurl = &escape('/adm/login');
 }          $$helpdeskscript = <<"ENDSCRIPT";
   <script type="text/javascript">
 sub newuser_link {  // <![CDATA[
     my ($linkname) = @_;  function helpdesk() {
     return '<a href="/adm/createaccount">'.$linkname.'</a>';      var possdom = document.client.udom.value;
 }      var codedom = possdom.replace( new RegExp("[^A-Za-z0-9.\\-]","g"),'');
       if (codedom == '') {
 1;          codedom = "$authdomain";
 __END__      }
       var querystr = "origurl=$thisurl&codedom="+codedom;
       document.location.href = "/adm/helpdesk?"+querystr;
       return;
   }
   // ]]>
   </script>
   ENDSCRIPT
       }
       return $contactblock;
   }
   
   sub forgotpwdisplay {
       my (%lt) = @_;
       my $prompt_for_resetpw = 1;
       if ($prompt_for_resetpw) {
           return '<a href="/adm/resetpw">'.$lt{'forgotpw'}.'</a>';
       }
       return;
   }
   
   sub coursecatalog_link {
       my ($linkname) = @_;
       return <<"END";
         <a href="/adm/coursecatalog">$linkname</a>
   END
   }
   
   sub newuser_link {
       my ($linkname) = @_;
       return '<a href="/adm/createaccount">'.$linkname.'</a>';
   }
   
   1;
   __END__
Removed from v.1.150  
changed lines
  Added in v.1.160

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