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

Diff for /loncom/interface/lonsource.pm between versions 1.4 and 1.40

version 1.4, 2004/07/07 00:02:00 version 1.40, 2020/02/17 23:04:18
Line 1 Line 1
 # The LearningOnline Network with CAPA  # The LearningOnline Network with CAPA
 # Souce Code handler  # Source Code handler
 #  #
 # $Id$  # $Id$
 #  #
Line 31 Line 31
 package Apache::lonsource;  package Apache::lonsource;
   
 use strict;  use strict;
 use Apache::lonnet();  use Apache::lonnet;
 use Apache::loncommon();  use Apache::loncommon();
 use Apache::lonhtmlcommon();  use Apache::lonhtmlcommon();
 use Apache::lonsequence();  use Apache::lonsequence();
 use Apache::Constants qw(:common :http);  use Apache::Constants qw(:common :http);
 use Apache::lonmeta;  use Apache::lonmeta;
   use Apache::lonenc();
 use Apache::File;  use Apache::File;
 use Apache::lonlocal;  use Apache::lonlocal;
 use HTML::Entities;  use HTML::Entities;
   use LONCAPA qw(:DEFAULT :match);
   
 sub make_link {  sub make_link {
     my ($filename, $listname) = @_;      my ($filename, $listname) = @_;
     my $sourcelink = "http://".$ENV{'SERVER_NAME'}.      my $sourcelink = '/adm/source?inhibitmenu=yes&filename='.
  "/adm/source/?filename=".$filename."&listname=".$listname;                       &escape(&escape($filename)).'&listname='.
                        &escape(&escape($listname));
     return $sourcelink;      return $sourcelink;
 }  }
   
 sub stage_2 {  sub stage_2 {
  my ($r, $filename, $author, $listname) = @_;      my ($r, $filename, $listname) = @_;
  $filename = $filename;      my ($author)=($filename=~/\/res\/[^\/]+\/([^\/]+)\//);
  &Apache::loncommon::content_type($r,'text/html');      $r->print(&Apache::loncommon::start_page('Copy Problem Source Code to Authoring Space',undef,
  my ($uname, $udom) = &Apache::loncacc::constructaccess('/~'.$author.'/',$r->dir_config('lonDefDomain'));                                               {'only_body' => 1,})
  $r->send_http_header;               .&mt('Please enter the directory that you would like the source code to go into.')
  $r->print('<html><head><title>LON-CAPA Move source to construction space</title>');               .'<p>'
  $r->print(&Apache::loncommon::bodytag('Problem source code moving operation'));               .&mt('Note: the path is in reference to the root of your Authoring Space,'
  $r->print("Please enter the directory that you would like the source code to go into, a default has also been provided <br />");                   .' and new directories will be automatically created.')
  $r->print("Also note, the path is in reference to the root of your construction space, and new directories will be automatically created. <br /><br />");               .'</p>');
  $r->print('    <form name="copy" action="/adm/source/" target="_parent" method="post">      $r->print('<form name="copy" action="/adm/source" target="_parent" method="post">
  <input type="hidden" name="filename" value="'.$filename.'" />                <input type="hidden" name="filename" value="'.$filename.'" />
  <input type="hidden" name="listname" value="'.$listname.'" />                <input type="hidden" name="listname" value="'.$listname.'" />
  <input type="hidden" name="action" value="copy_stage" />                <input type="hidden" name="action" value="copy_stage" />
  <input type="text" name="newpath" value="/shared_source/'.$author.'" />&nbsp;                <input type="text" size="50" name="newpath" value="/'.&mt('shared_source').'/'.$author.'" />&nbsp;
  <input type="submit" value="Copy" />                <input type="submit" value="'.&mt('Copy').'" />
  </form>');                </form>'.
  return OK;                &Apache::loncommon::end_page());
       return OK;
 }  }
   
   sub copy_author {
 sub copy_stage {  
     my ($r, $filename, $listname, $newpath) = @_;  
     my $role;      my $role;
     my $domain;      my $domain;
     my $author_name;      my $author_name;
     #Figure out if we are author or co-author      if ($env{'request.role'} =~ m{^ca\.}) {
     if($ENV{'request.role'} =~ m|ca.|) {           ($role, $domain, $author_name) = split(/\//,$env{'request.role'});
     ($role, $domain, $author_name) = split(/\//,$ENV{'request.role'});  
     } else {      } else {
     $role = "au.";          $role = "au.";
     $domain = $ENV{'user.domain'};          $domain = $env{'user.domain'};
     $author_name = $ENV{'user.name'};          $author_name = $env{'user.name'};
     }  
       
     my $path_to_new_file = '/home/'.$author_name.'/public_html/'.$newpath.'/'.$listname;  
     #Just checking again for access as we want to make sure that it is really ok now that we have the real path  
     my ($uname,$udom)= &Apache::loncacc::constructaccess($path_to_new_file,$domain);  
     unless (($uname) && ($udom)) {  
  return HTTP_NOT_ACCEPTABLE;  
     }      }
     &Apache::loncommon::content_type($r,'text/html');      return ($role,$author_name,$domain);
     $r->send_http_header;  }
     $r->print('<html><head><title>LON-CAPA Move source to construction space</title>');  
  $r->print(&Apache::loncommon::bodytag('Copying Source'));  
  my $result = &Apache::loncfile::exists($uname, $udom, $path_to_new_file);  sub copy_stage {
  $r->print($result);      my ($r, $filename, $listname, $newpath) = @_;
  if(($result) && ($result =~ m|published|) ) {  
  &delete_file($r, $author_name, $newpath, $filename, $path_to_new_file, '1');      my ($path_to_new_file,$uname,$udom) = &get_path_to_newfile($r,$newpath,$listname);
  } elsif(($result) && ($result =~ m|exists!|)) {  
  &confirm($r, $author_name, $newpath, $filename, $path_to_new_file);      #allowed
  } else {       if ($path_to_new_file) {
  &copy_file($r, $author_name, $newpath, $filename, $path_to_new_file);          $r->print(&Apache::loncommon::start_page('Copying Source',undef,{'only_body' => 1}));
  }          my $result = &Apache::loncfile::exists($uname, $udom, $path_to_new_file);
           $r->print($result);
 return OK;          if (($result) && ($result =~ /published/)) {
       &delete_copy_file($r, $newpath, $filename, $path_to_new_file, '1');
           } elsif (($result) && ($result =~ /exists\!/)) {
       &confirm($r, $newpath, $filename, $listname);
           } else {
       &copy_file($r, $newpath, $filename, $path_to_new_file);
           }
           $r->print(&Apache::loncommon::end_page());
       }
       return;
 }  }
   
 sub confirm {  sub confirm {
  my ($r, $author_name, $newpath, $filename, $path_to_new_file) = @_;      my ($r, $newpath, $filename, $listname) = @_;
  $r->print("<b>Press delete to remove file and replace it with a copy of the source you are viewing</b><br /><br />");      $r->print('<b>'.&mt('Press delete to remove file and replace it with a copy of the source you are viewing.').'</b><br /><br />');
  $r->print('    <form name="delete_confirm" action="/adm/source/" target="_parent" method="post">      $r->print('<form name="delete_confirm" action="/adm/source" target="_parent" method="post">
       <input type="hidden" name="filename" value="'.$filename.'" />                <input type="hidden" name="filename" value="'.$filename.'" />
       <input type="hidden" name="path" value="'.$path_to_new_file.'" />                <input type="hidden" name="listname" value="'.$listname.'" />
       <input type="hidden" name="author" value="'.$author_name.'" />                <input type="hidden" name="newpath" value="'.$newpath.'" />
       <input type="hidden" name="newpath" value="'.$newpath.'" />                <input type="hidden" name="action" value="delete_confirm" />
       <input type="hidden" name="action" value="delete_confirm" />                <input type="submit" value="Delete" />
                             </form>');
               <input type="submit" value="Delete" />      return;
     </form>');  }
 }  
   sub delete_copy_file {
 sub delete_file {      my ($r, $newpath, $filename, $path_to_new_file, $type) = @_;
  my ($r, $author_name, $newpath, $filename, $path_to_new_file, $type) = @_;      if ($type eq '1') {
  if($type eq '1') {           $r->print('<p><span class="LC_warning">'
  $r->print("<b>Cannot delete non-obsolete published file</b><br />Please                   .&mt('Cannot delete non-obsolete published file.')
  use the code view in previous window to use shared code<br /><br />");                   .'</span><br />'
  $r->print('<input type="button" value="Close Window" name="close" onClick="window.close()">');                   .&mt('Please use the code view in previous window to use shared code.')
  } else {                   .'<br /><br />');
  if(-e $path_to_new_file) {          $r->print('<form name="delete_done" action="/adm/source" target="_parent" method="post">'
    unless(unlink($path_to_new_file)) {                   .'<input type="button" value="'.&mt('Close Window').'" name="close"'
  $r->print('<font color="red">'.&mt('Error').': '.$!.'</font>');                   .' onclick="window.close()" />'
  return 0;                   .'</form></p>');
    }          return;
  } else {      } else {
     $r->print('<p> '.&mt('No such file').'. </p></form>');          $r->print(&Apache::loncommon::start_page('Copying Source',undef,{'only_body' => 1}));
     return 0;          if (-e $path_to_new_file) {
   }              unless (unlink($path_to_new_file)) {
   &copy_file($r, $author_name, $newpath, $filename, $path_to_new_file);                  $r->print('<p class="LC_error"">'.&mt('Error:').' '.$!.'</p>');
  }                  return 0;
               }
           } else {
               $r->print('<p class="LC_error">'.&mt('No such file').'</p>');
               return 0;
           }
           &copy_file($r, $newpath, $filename, $path_to_new_file);
           $r->print(&Apache::loncommon::end_page());
           return;
       }
 }  }
   
 sub copy_file {  sub copy_file {
  my ($r, $author_name, $newpath, $filename, $path_to_new_file) = @_;      my ($r, $newpath, $filename, $path_to_new_file) = @_;
  $r->print("<b>Creating directories</b>");      $r->print('<b>'.&mt('Creating directories').'</b>');
  my $path = '/home/'.$author_name.'/public_html/';  
  my @directories = split(/\//,$newpath);  #Figure out if we are author or co-author
  foreach my $now_checking (@directories) {       my ($role,$author_name,$domain)=&copy_author();
  if($now_checking ne '') {  
  $path = $path.'/'.$now_checking;      my $path = $r->dir_config('lonDocRoot')."/priv/$domain/$author_name/";
  if(-e $path) {} #More moving along, isn't recursion fun'      my @directories = split(/\//,$newpath);
  else {  
  unless(mkdir($path, 02770)) {      foreach my $now_checking (@directories) {
  $r->print('<font color="red">'.&mt('Error').': '.$!.'</font>');          if($now_checking ne '') {
  return 0;              $path = $path.'/'.$now_checking;
  }              if(-e $path) {} #More moving along, isn't recursion fun'
  unless(chmod(02770, ($path))) {  
  $r->print('<font color="red"> '.&mt('Error').': '.$!.'</font>');              else {
  return 0;                  unless(mkdir($path, 02770)) {
  }                      $r->print('<p class="LC_error">'.&mt('Error:').' '.$!.'</p>');
  }                      return 0;
  } else { } #Just move along                  }
  }                  unless(chmod(02770, ($path))) {
  $r->print("<br /><b>Copying File</b>");                      $r->print('<p class="LC_error"> '.&mt('Error:').' '.$!.'</p>');
  my $problem_filename = "/home/httpd/html".$filename;                      return 0;
  my $file_output = &Apache::lonnet::getfile($problem_filename);                  }
  my $fs=Apache::File->new(">$path_to_new_file");              }
  if (defined($fs)) {          } else { } #Just move along
  print $fs $file_output;  
  }      }
  $r->print("<br /><br />");      $r->print('<br /><b>'.&mt('Copying File').'</b>');
  $r->print('<input type="button" value="Close Window" name="close" onClick="window.close()">');      my $problem_filename = $Apache::lonnet::perlvar{'lonDocRoot'}.$filename;
  #Some 1.3'ish feature is to include the derivative feature, will go here..'      my $file_output = &includemeta(&Apache::lonnet::getfile($problem_filename),$filename);
 }      my $fs=Apache::File->new(">$path_to_new_file");
       if (defined($fs)) {
           print $fs $file_output;
       }
       $r->print("<br /><br />");
       $r->print('<form name="copied_file" action="/adm/source" target="_parent" method="post">'
                 .'<input type="button" value="'
                 .&mt('Close Window').'" name="close" onclick="window.close()" />'
                 .'</form>');
       #Some 1.3'ish feature is to include the derivative feature, will go here..'
       return;
   }
   
 sub print_item {  sub print_item {
  my ($r, $filename) = @_;      my ($r,$filename,$listname,$context) = @_;
  $filename = "/home/httpd/html".$filename;      my $file_output;
  &Apache::lonnet::logthis("print_item filename = $filename");      if ($context eq 'view') {
  my $file_output = &Apache::lonnet::getfile($filename);          $file_output =
  my $count=0;              &Apache::lonnet::getfile($Apache::lonnet::perlvar{'lonDocRoot'}.$filename);
  my $maxlength=-1;      } else {
  foreach (split ("\n", $file_output)) {          $file_output =
  $count+=int(length($_)/79);              &includemeta(&Apache::lonnet::getfile($Apache::lonnet::perlvar{'lonDocRoot'}.$filename),
  $count++;                                                    $filename);
  if (length($_) > $maxlength) { $maxlength = length($_); }      }
  }      $r->print(&Apache::loncommon::start_page('View Source Code',undef,
  my $rows = $count;                                               {'only_body' => 1}));
  my $cols = $maxlength;      if ($file_output ne '') {
  $r->print('<textarea rows="'.$rows.'" cols="'.$cols.'" name="editxmltext">'.          my $access_to_cstr;
  &HTML::Entities::encode($file_output,'<>&"').'</textarea>');          my $lonhost = $r->dir_config('lonHostID');
  return OK;          if ($context eq 'view') {
               $r->print('<form name="view" action="" target="_parent" method="post"><span class="LC_info">'.
                         &mt('Source code is displayed below.').
                         '</span>'.('&nbsp;' x4).'<input type="button" name="close" onclick="window.close();"'.
                         ' value="'.&mt('Close Window').'" /></form><hr />');
           } elsif (&Apache::lonnet::is_library($lonhost)) {
               my @possdoms = &Apache::lonnet::current_machine_domains();
               foreach my $dom (@possdoms) {
                   if ($env{"user.role.au./$dom/"}) {
                       $access_to_cstr = 1;
                       last;  
                   }
               }
               unless ($access_to_cstr) {
                   foreach my $key (keys(%env)) {
                       if ($key =~ m{^\Quser.role.ca./\E($match_domain)/}) {
                           my $adom = $1;
                           if (grep(/^\Q$adom\E$/,@possdoms)) {
                               $access_to_cstr = 1;
                               last;
                           }
                       }
                   }
               }
               if ($access_to_cstr) {
                   $r->print('
                <form name="copy" action="/adm/source" target="_parent" method="post">
                 <input type="button" value="'.&mt('Close Window').'" name="close" onclick="window.close();" />
                 <input type="hidden" name="filename" value="'.$filename.'" />
                 <input type="hidden" name="listname" value="'.$listname.'" />
                 <input type="hidden" name="action" value="stage2" />
                 <input type="submit" value="'.&mt('Copy to Authoring Space').'" />
                </form><hr />
                   ');
               } else {
                   $r->print('<p><span class="LC_info">'.
                             &mt('Source code is displayed, but you can not copy to Authoring Space, as you do not have an author or co-author role on this server.').
                             '</span></p><a href="javascript:window.close();">'.&mt('Close Window').
                             '</a><br /><hr />'
                            );
               }
           } else {
               $r->print('<p><span class="LC_info">'.
                         &mt('Source code is displayed, but you can not copy to Authoring Space on this server.').
                             '</span></p><a href="javascript:window.close();">'.&mt('Close Window').
                             '</a><br /><hr />'
                        );
   
           }
           my $count=0;
           my $maxlength=-1;
           foreach (split ("\n", $file_output)) {
               $count+=int(length($_)/79);
               $count++;
               if (length($_) > $maxlength) {
                   $maxlength = length($_);
               }
           }
           my $rows = $count;
           my $cols = $maxlength;
           $r->print('<form name="showsrc" action="" method="post" onsubmit="return false">'."\n".
                     '<textarea rows="'.$rows.'" cols="'.$cols.'" name="editxmltext">'.
                     &HTML::Entities::encode($file_output,'<>&"').'</textarea></form>');
       } else {
           $r->print('<p class="LC_warning">'.
                     &mt('Unable to retrieve file contents.').
                     '</p><a href="javascript:window.close();">'.&mt('Close Window').'</a>'
                    );
       }
       $r->print(&Apache::loncommon::end_page());
       return;
   }
   
   sub includemeta {
       my ($file_output,$orgfilename)=@_;
       my $escfilename=&escape($orgfilename);
       my $copytime=time;
       if ($file_output=~/\<meta\s*name\=\"isbasedonres\"/i) {
    $file_output=~s/(\<meta\s*name\=\"isbasedonres\"\s*content\=\"[^\"]*)\"/$1\,\Q$escfilename\E\"/i;
       } else {
    $file_output=~s/(\<(?:html|problem)[^\>]*\>)/$1\n\<meta name=\"isbasedonres\" content=\"\Q$escfilename\E\" \/\>/i;
       }
       if ($file_output=~/\<meta\s*name\=\"isbasedontime\"/i) {
    $file_output=~s/(\<meta\s*name\=\"isbasedontime\"\s*content\=\"[^\"]*)\"/$1\,\Q$copytime\E\"/i;
       } else {
    $file_output=~s/(\<(?:html|problem)[^\>]*\>)/$1\n\<meta name=\"isbasedontime\" content=\"\Q$copytime\E\" \/\>/i;
       }
       if ($file_output eq '-1') {
           return;
       } else {
           return $file_output;
       }
 }  }
   
   sub get_path_to_newfile {
       my ($r,$newpath,$listname) = @_;
   
       #Figure out if we are author or co-author
       my ($role,$author_name,$domain) = &copy_author();
   
       # Construct path to copy and filter out any possibly nasty stuff
       my $path = $r->dir_config('lonDocRoot')."/priv/$domain/$author_name/";
       my $path_to_new_file = $path."$newpath/$listname";
       $path_to_new_file=~s/\.\.//g;
       $path_to_new_file=~s/\~//g;
       $path_to_new_file=~s/\/+/\//g;
   
       #Just checking again for access as we want to make sure that it is really ok
       #now that we have the real path
   
       my ($uname,$udom)= &Apache::lonnet::constructaccess($path_to_new_file);
   
       if (!$uname || !$udom) {
           $r->print(&Apache::loncommon::start_page('Not Allowed',undef,{'only_body' => 1}));
           $r->print(&mt('Not allowed to create file [_1]', $path_to_new_file));
           $r->print(&Apache::loncommon::end_page());
           if (wantarray) {
               return();
           } else {
               return;
           }
       }
       if (wantarray) {
           return ($path_to_new_file,$uname,$udom);
       } else {
           return $path_to_new_file;
       }
   }
   
 sub handler {   sub handler {
     my $r=shift;      my $r=shift;
     &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},      &Apache::loncommon::get_unprocessed_cgi($ENV{'QUERY_STRING'},
     ['filename','listname']);                                              ['filename','listname','viewonly']);
     my $filename = $ENV{'form.filename'};      my $filename = $env{'form.filename'};
     my $listname = $ENV{'form.listname'};      my $shownfilename = $filename;
     my $source = &Apache::lonnet::metadata($filename,'sourceavail');      $shownfilename =~ s/(`)/'/g;
     if ($source ne 'open') {      $shownfilename =~ s/\$/\(\$\)/g;
  $ENV{'user.error.msg'}="$filename:cre:1:1:Source code not available";      my $listname = $env{'form.listname'};
  return HTTP_NOT_ACCEPTABLE;      my $viewonly = $env{'form.viewonly'};
     }  
     if ((!&Apache::lonnet::allowed('cre',$filename)) ||      if ($viewonly) {
  (!&Apache::lonnet::allowed('bre',$filename))) {          my $canview;
  $ENV{'user.error.msg'}="$filename:bre:1:1:Access to resource denied";          if ((&Apache::lonnet::metadata($filename,'sourceavail') eq 'open') &&
  return HTTP_NOT_ACCEPTABLE;              (&Apache::lonnet::allowed('cre','/'))) {
     }              $canview = 1;
     if ($ENV{'form.action'} eq 'stage2') {           } elsif (($env{'request.course.id'}) && (&Apache::lonnet::is_on_map($filename))) {
     my $author = &Apache::lonnet::metadata($filename,'authorspace');              my $crs_sec = $env{'request.course.id'} . (($env{'request.course.sec'} ne '')
     $author =~ m|@|;                                                        ? "/$env{'request.course.sec'}"
     $author = $`; #This just tells who the author name is for later processing.                                                        : '');
  &stage_2($r, $ENV{'form.filename'}, $author, $listname);              if (&Apache::lonnet::allowed('vxc',$crs_sec)) {
     } elsif($ENV{'form.action'} eq 'copy_stage') {                  my $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
     &copy_stage($r, $filename,$ENV{'form.listname'},$ENV{'form.newpath'});                  &Apache::lonenc::check_decrypt(\$filename);
     } elsif($ENV{'form.action'} eq 'delete_confirm') {                  if (($env{'request.role.domain'} eq $cdom) && ($filename =~ /$LONCAPA::assess_re/)) {
     &Apache::loncommon::content_type($r,'text/html');                      my ($auname) = ($filename =~ m{^\Q/res/$cdom/\E($match_username)/});
  $r->send_http_header;                      if (($auname ne '') && ($env{'request.course.adhocsrcaccess'} ne '') &&
     &delete_file($r, $ENV{'form.author'}, $ENV{'form.newpath'}, $ENV{'form.filename'}, $ENV{'form.path'}, '0');                          (grep(/^\Q$auname\E$/,split(/,/,$env{'request.course.adhocsrcaccess'})))) {
     } else {                          $canview = 1;
  &Apache::loncommon::content_type($r,'text/html');                      } elsif ((&Apache::lonnet::metadata($filename,'sourceavail') eq 'open') &&
  $r->send_http_header;                               ($filename =~ m{^\Q/res/$cdom/}) &&
  $r->print('    <form name="copy" action="/adm/source/" target="_parent" method="post">                               (&Apache::lonnet::allowed('bre',$crs_sec))) {
  <input type="button" value="Close Window" name="close" onClick="window.close()">                          $canview = 1;
       <input type="hidden" name="filename" value="'.$filename.'" />                      }
       <input type="hidden" name="listname" value="'.$listname.'" />                  }
       <input type="hidden" name="action" value="stage2" />              }
               <input type="submit" value="Copy to CSTR" />          }
     </form>');          unless ($canview) {
  $r->print('<hr />');              $env{'user.error.msg'}="$shownfilename:cre:1:1:Source code not available";
  &print_item($r, $ENV{'form.filename'});              return HTTP_NOT_ACCEPTABLE;
      }          }
       } elsif (&Apache::lonnet::metadata($filename,'sourceavail') ne 'open') {
           $env{'user.error.msg'}="$shownfilename:cre:1:1:Source code not available";
           return HTTP_NOT_ACCEPTABLE;
       }
       unless (&Apache::lonnet::allowed('bre',$filename)) {
           $env{'user.error.msg'}="$shownfilename:bre:1:1:Access to resource denied";
           return HTTP_NOT_ACCEPTABLE;
       }
       unless (($viewonly) || (&Apache::lonnet::allowed('cre','/'))) {
           $env{'user.error.msg'}="$shownfilename:cre:1:1:Access to source code denied";
           return HTTP_NOT_ACCEPTABLE;
       }
       my $newpath = $env{'form.newpath'};
   
       &Apache::loncommon::content_type($r,'text/html');
       $r->send_http_header;
   
       if ($viewonly) {
           &print_item($r,$filename,$listname,'view');
       } elsif ($env{'form.action'} eq 'stage2') {
           &stage_2($r,$filename,$listname);
       } elsif($env{'form.action'} eq 'copy_stage') {
           &copy_stage($r,$filename,$listname,$newpath);
       } elsif($env{'form.action'} eq 'delete_confirm') {
           my $path_to_new_file = &get_path_to_newfile($r,$newpath,$listname);
           if ($path_to_new_file) {
               &delete_copy_file($r, $newpath, $filename, $path_to_new_file, '0');
           }
       } else {
           &print_item($r,$filename,$listname);
       }
     return OK;      return OK;
 }  }
   
 1;  1;
   
   
Removed from v.1.4  
changed lines
  Added in v.1.40

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