Annotation of loncom/auth/lonacc.pm, revision 1.179

1.1       albertel    1: # The LearningOnline Network
                      2: # Cookie Based Access Handler
1.22      www         3: #
1.179   ! raeburn     4: # $Id: lonacc.pm,v 1.178 2020/08/10 03:22:54 raeburn Exp $
1.22      www         5: #
                      6: # Copyright Michigan State University Board of Trustees
                      7: #
                      8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
                      9: #
                     10: # LON-CAPA is free software; you can redistribute it and/or modify
                     11: # it under the terms of the GNU General Public License as published by
                     12: # the Free Software Foundation; either version 2 of the License, or
                     13: # (at your option) any later version.
                     14: #
                     15: # LON-CAPA is distributed in the hope that it will be useful,
                     16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
                     17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     18: # GNU General Public License for more details.
                     19: #
                     20: # You should have received a copy of the GNU General Public License
                     21: # along with LON-CAPA; if not, write to the Free Software
                     22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
                     23: #
                     24: # /home/httpd/html/adm/gpl.txt
                     25: #
                     26: # http://www.lon-capa.org/
                     27: #
1.25      harris41   28: ###
1.1       albertel   29: 
1.121     jms        30: =head1 NAME
                     31: 
                     32: Apache::lonacc - Cookie Based Access Handler
                     33: 
                     34: =head1 SYNOPSIS
                     35: 
                     36: Invoked (for various locations) by /etc/httpd/conf/srm.conf:
                     37: 
                     38:  PerlAccessHandler       Apache::lonacc
                     39: 
                     40: =head1 INTRODUCTION
                     41: 
                     42: This module enables cookie based authentication and is used
                     43: to control access for many different LON-CAPA URIs.
                     44: 
                     45: Whenever the client sends the cookie back to the server, 
                     46: this cookie is handled by either lonacc.pm or loncacc.pm
                     47: (see srm.conf for what is invoked when).  If
                     48: the cookie is missing or invalid, the user is re-challenged
                     49: for login information.
                     50: 
                     51: This is part of the LearningOnline Network with CAPA project
                     52: described at http://www.lon-capa.org.
                     53: 
                     54: =head1 HANDLER SUBROUTINE
                     55: 
                     56: This routine is called by Apache and mod_perl.
                     57: 
                     58: =over 4
                     59: 
                     60: =item *
                     61: 
                     62: transfer profile into environment
                     63: 
                     64: =item *
                     65: 
                     66: load POST parameters
                     67: 
                     68: =item *
                     69: 
                     70: check access
                     71: 
                     72: =item *
                     73: 
                     74: if allowed, get symb, log, generate course statistics if applicable
                     75: 
                     76: =item *
                     77: 
                     78: otherwise return error
                     79: 
                     80: =item *
                     81: 
                     82: see if public resource
                     83: 
                     84: =item *
                     85: 
                     86: store attempted access
                     87: 
                     88: =back
                     89: 
                     90: =head1 NOTABLE SUBROUTINES
                     91: 
                     92: =cut
                     93: 
1.119     jms        94: 
1.1       albertel   95: package Apache::lonacc;
                     96: 
                     97: use strict;
1.8       www        98: use Apache::Constants qw(:common :http :methods);
1.2       www        99: use Apache::File;
1.6       www       100: use Apache::lonnet;
1.25      harris41  101: use Apache::loncommon();
1.47      www       102: use Apache::lonlocal;
1.86      albertel  103: use Apache::restrictedaccess();
1.148     raeburn   104: use Apache::blockedaccess();
1.175     raeburn   105: use Apache::lonprotected();
1.16      www       106: use Fcntl qw(:flock);
1.141     raeburn   107: use LONCAPA qw(:DEFAULT :match);
1.1       albertel  108: 
1.75      albertel  109: sub cleanup {
                    110:     my ($r)=@_;
                    111:     if (! $r->is_initial_req()) { return DECLINED; }
                    112:     &Apache::lonnet::save_cache();
                    113:     return OK;
                    114: }
                    115: 
                    116: sub goodbye {
                    117:     my ($r)=@_;
                    118:     &Apache::lonnet::goodbye();
                    119:     return DONE;
                    120: }
                    121: 
1.76      albertel  122: ###############################################
                    123: 
                    124: sub get_posted_cgi {
1.114     raeburn   125:     my ($r,$fields) = @_;
1.76      albertel  126: 
                    127:     my $buffer;
                    128:     if ($r->header_in('Content-length')) {
                    129: 	$r->read($buffer,$r->header_in('Content-length'),0);
                    130:     }
1.113     albertel  131:     my $content_type = $r->header_in('Content-type');
                    132:     if ($content_type !~ m{^multipart/form-data}) {
1.76      albertel  133: 	my @pairs=split(/&/,$buffer);
                    134: 	my $pair;
                    135: 	foreach $pair (@pairs) {
                    136: 	    my ($name,$value) = split(/=/,$pair);
                    137: 	    $value =~ tr/+/ /;
                    138: 	    $value =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
                    139: 	    $name  =~ tr/+/ /;
                    140: 	    $name  =~ s/%([a-fA-F0-9][a-fA-F0-9])/pack("C",hex($1))/eg;
1.114     raeburn   141:             if (ref($fields) eq 'ARRAY') {
                    142:                 next if (!grep(/^\Q$name\E$/,@{$fields}));
                    143:             }
1.77      albertel  144: 	    &Apache::loncommon::add_to_env("form.$name",$value);
1.76      albertel  145: 	}
                    146:     } else {
1.113     albertel  147: 	my ($contentsep) = ($content_type =~ /boundary=\"?([^\";,]+)\"?/);
1.76      albertel  148: 	my @lines = split (/\n/,$buffer);
                    149: 	my $name='';
                    150: 	my $value='';
                    151: 	my $fname='';
                    152: 	my $fmime='';
                    153: 	my $i;
                    154: 	for ($i=0;$i<=$#lines;$i++) {
1.113     albertel  155: 	    if ($lines[$i]=~/^--\Q$contentsep\E/) {
1.76      albertel  156: 		if ($name) {
1.139     raeburn   157:                     chomp($value);
                    158:                     if (($r->uri eq '/adm/portfolio') && 
                    159:                         ($name eq 'uploaddoc')) {
                    160:                         if (length($value) == 1) {
                    161:                             $value=~s/[\r\n]$//;
                    162:                         }
1.168     raeburn   163:                     } elsif ($fname =~ /\.(xls|doc|ppt)(x|m)$/i) {
1.154     raeburn   164:                         $value=~s/[\r\n]$//;
1.139     raeburn   165:                     }
1.114     raeburn   166:                     if (ref($fields) eq 'ARRAY') {
                    167:                         next if (!grep(/^\Q$name\E$/,@{$fields}));
                    168:                     }
1.118     raeburn   169:                     if ($fname) {
                    170:                         if ($env{'form.symb'} ne '') {
                    171:                             my $size = (length($value))/(1024.0 * 1024.0);
                    172:                             if (&upload_size_allowed($name,$size,$fname) eq 'ok') {
                    173:                                 $env{"form.$name.filename"}=$fname;
                    174:                                 $env{"form.$name.mimetype"}=$fmime;
                    175:                                 &Apache::loncommon::add_to_env("form.$name",$value);
                    176:                             }
                    177:                         } else {
                    178:                             $env{"form.$name.filename"}=$fname;
                    179:                             $env{"form.$name.mimetype"}=$fmime;
                    180:                             &Apache::loncommon::add_to_env("form.$name",$value);
                    181:                         }
                    182:                     } else {
                    183:                         $value=~s/\s+$//s;
                    184:                         &Apache::loncommon::add_to_env("form.$name",$value);
                    185:                     }
1.76      albertel  186: 		}
                    187: 		if ($i<$#lines) {
                    188: 		    $i++;
                    189: 		    $lines[$i]=~
                    190: 		/Content\-Disposition\:\s*form\-data\;\s*name\=\"([^\"]+)\"/i;
                    191: 		    $name=$1;
                    192: 		    $value='';
                    193: 		    if ($lines[$i]=~/filename\=\"([^\"]+)\"/i) {
                    194: 			$fname=$1;
                    195: 			if 
                    196:                             ($lines[$i+1]=~/Content\-Type\:\s*([\w\-\/]+)/i) {
                    197: 				$fmime=$1;
                    198: 				$i++;
                    199: 			    } else {
                    200: 				$fmime='';
                    201: 			    }
                    202: 		    } else {
                    203: 			$fname='';
                    204: 			$fmime='';
                    205: 		    }
1.162     damieng   206:                     if ($i<$#lines && $lines[$i+1]=~/^Content\-Type\:\s*([\w\-\/]+)/i) {
                    207:                         # TODO: something with $1 !
                    208:                         $i++;
                    209:                     }
                    210:                     if ($i<$#lines && $lines[$i+1]=~/^Content\-transfer\-encoding\:\s*([\w\-\/]+)/i) {
                    211:                         # TODO: something with $1 !
                    212:                         $i++;
                    213:                     }
1.76      albertel  214: 		    $i++;
                    215: 		}
                    216: 	    } else {
                    217: 		$value.=$lines[$i]."\n";
                    218: 	    }
                    219: 	}
                    220:     }
                    221: #
                    222: # Digested POSTed values
                    223: #
                    224: # Remember the way this was originally done (GET or POST)
                    225: #
                    226:     $env{'request.method'}=$ENV{'REQUEST_METHOD'};
                    227: #
                    228: # There may also be stuff in the query string
                    229: # Tell subsequent handlers that this was GET, not POST, so they can access query string.
                    230: # Also, unset POSTed content length to cover all tracks.
                    231: #
                    232: 
                    233:     $r->method_number(M_GET);
                    234: 
                    235:     $r->method('GET');
                    236:     $r->headers_in->unset('Content-length');
                    237: }
                    238: 
1.121     jms       239: =pod
                    240: 
1.146     raeburn   241: =over
                    242: 
1.121     jms       243: =item upload_size_allowed()
                    244: 
                    245: 	Perform size checks for file uploads to essayresponse items in course context.
                    246: 	
                    247: 	Add form.HWFILESIZE.$part_$id to %env with file size (MB)
                    248: 	If file exceeds maximum allowed size, add form.HWFILETOOBIG.$part_$id to %env.
                    249: 
                    250: =cut
1.118     raeburn   251:  
                    252: sub upload_size_allowed {
                    253:     my ($name,$size,$fname) = @_;
                    254:     if ($name =~ /^HWFILE(\w+)$/) {
                    255:         my $ident = $1;
                    256:         my $item = 'HWFILESIZE'.$ident;
1.122     raeburn   257:         my $savesize = sprintf("%.6f",$size);
                    258:         &Apache::loncommon::add_to_env("form.$item",$savesize);
1.118     raeburn   259:         my $maxsize= &Apache::lonnet::EXT("resource.$ident.maxfilesize");
                    260:         if (!$maxsize) {
1.123     raeburn   261:             $maxsize = 10.0; # FIXME This should become a domain configuration.
1.118     raeburn   262:         }
                    263:         if ($size > $maxsize) {
                    264:             my $warn = 'HWFILETOOBIG'.$ident;
                    265:             &Apache::loncommon::add_to_env("form.$warn",$fname);
                    266:             return;
                    267:         }
                    268:     }
                    269:     return 'ok';
                    270: }
                    271: 
1.121     jms       272: =pod
                    273: 
                    274: =item sso_login()
                    275: 
                    276: 	handle the case of the single sign on user, at this point $r->user 
1.150     raeburn   277: 	will be set and valid; now need to find the loncapa user info, and possibly
1.149     raeburn   278: 	balance them. If $r->user() is set this means either it was either set by
1.150     raeburn   279:         SSO or by checkauthen.pm, if a valid cookie was found. The latter case can
                    280:         be identified by the third arg ($usename), except when lonacc is called in 
                    281:         an internal redirect to /adm/switchserver (e.g., load-balancing following
                    282:         successful authentication) -- no cookie set yet.  For that particular case
                    283:         simply skip the call to sso_login(). 
1.149     raeburn   284: 
                    285: 	returns OK if it was SSO and user was handled.
                    286:         returns undef if not SSO or no means to handle the user.
1.121     jms       287:         
                    288: =cut
1.117     jms       289: 
1.94      albertel  290: sub sso_login {
1.149     raeburn   291:     my ($r,$handle,$username) = @_;
1.94      albertel  292: 
1.156     raeburn   293:     if (($r->user eq '') || ($username ne '') || ($r->user eq 'public:public') ||
1.143     raeburn   294:         (defined($env{'user.name'}) && (defined($env{'user.domain'}))
                    295: 	  && ($handle ne ''))) {
1.94      albertel  296: 	# not an SSO case or already logged in
                    297: 	return undef;
                    298:     }
                    299: 
1.161     raeburn   300:     my ($user) = ($r->user =~ m/^($match_username)$/);
                    301:     if ($user eq '') {
                    302:         return undef;
                    303:     }
1.97      albertel  304: 
1.126     raeburn   305:     my $query = $r->args;
                    306:     my %form;
                    307:     if ($query) {
1.145     raeburn   308:         my @items = ('role','symb','iptoken');
1.127     raeburn   309:         &Apache::loncommon::get_unprocessed_cgi($query,\@items);
                    310:         foreach my $item (@items) {
                    311:             if (defined($env{'form.'.$item})) {
                    312:                 $form{$item} = $env{'form.'.$item};
1.126     raeburn   313:             }
                    314:         }
                    315:     }
                    316: 
1.145     raeburn   317:     my %sessiondata;
                    318:     if ($form{'iptoken'}) {
                    319:         %sessiondata = &Apache::lonnet::tmpget($form{'iptoken'});
1.158     raeburn   320:         my $delete = &Apache::lonnet::tmpdel($form{'iptoken'});
                    321:         unless ($sessiondata{'sessionserver'}) {
                    322:             delete($form{'iptoken'});
                    323:         }
1.145     raeburn   324:     }
                    325: 
1.136     raeburn   326:     my $domain = $r->dir_config('lonSSOUserDomain');
                    327:     if ($domain eq '') {
                    328:         $domain = $r->dir_config('lonDefDomain');
                    329:     }
1.97      albertel  330:     my $home=&Apache::lonnet::homeserver($user,$domain);
1.94      albertel  331:     if ($home !~ /(con_lost|no_host|no_such_host)/) {
1.107     albertel  332: 	&Apache::lonnet::logthis(" SSO authorized user $user ");
1.145     raeburn   333:         my ($is_balancer,$otherserver,$hosthere);
                    334:         if ($form{'iptoken'}) {
1.158     raeburn   335:             if (($sessiondata{'domain'} eq $domain) &&
                    336:                 ($sessiondata{'username'} eq $user)) {
1.145     raeburn   337:                 $hosthere = 1;
                    338:             }
                    339:         }
                    340:         unless ($hosthere) {
                    341:             ($is_balancer,$otherserver) =
1.165     raeburn   342:                 &Apache::lonnet::check_loadbalancing($user,$domain,'login');
                    343:             if ($is_balancer) {
1.171     raeburn   344:                 # Check if browser sent a LON-CAPA load balancer cookie (and this is a balancer)
                    345:                 my ($found_server,$balancer_cookie) = &Apache::lonnet::check_for_balancer_cookie($r);
                    346:                 if (($found_server) && ($balancer_cookie =~ /^\Q$domain\E_\Q$user\E_/)) {
                    347:                     $otherserver = $found_server;
                    348:                 } elsif ($otherserver eq '') {
1.165     raeburn   349:                     my $lowest_load;
                    350:                     ($otherserver,undef,undef,undef,$lowest_load) = &Apache::lonnet::choose_server($domain);
                    351:                     if ($lowest_load > 100) {
                    352:                         $otherserver = &Apache::lonnet::spareserver($lowest_load,$lowest_load,1,$domain);
                    353:                     }
1.171     raeburn   354:                     if ($otherserver ne '') {
                    355:                         my @hosts = &Apache::lonnet::current_machine_ids();
                    356:                         if (grep(/^\Q$otherserver\E$/,@hosts)) {
                    357:                             $hosthere = $otherserver;
                    358:                         }
1.165     raeburn   359:                     }
                    360:                 }
                    361:             }
1.145     raeburn   362:         }
1.165     raeburn   363: 	if (($is_balancer) && (!$hosthere)) {
1.136     raeburn   364: 	    # login but immediately go to switch server to find us a new 
1.94      albertel  365: 	    # machine
1.127     raeburn   366: 	    &Apache::lonauth::success($r,$user,$domain,$home,'noredirect');
1.172     raeburn   367:             foreach my $item (keys(%form)) {
                    368:                 $env{'form.'.$item} = $form{$item};
                    369:             }
                    370:             unless ($form{'symb'}) {
                    371:                 unless (($r->uri eq '/adm/roles') || ($r->uri eq '/adm/sso')) {
                    372:                     $env{'form.origurl'} = $r->uri;
                    373:                 }
                    374:             }
1.105     raeburn   375:             $env{'request.sso.login'} = 1;
1.106     raeburn   376:             if (defined($r->dir_config("lonSSOReloginServer"))) {
                    377:                 $env{'request.sso.reloginserver'} =
                    378:                     $r->dir_config('lonSSOReloginServer');
                    379:             }
1.137     raeburn   380:             my $redirecturl = '/adm/switchserver';
                    381:             if ($otherserver ne '') {
                    382:                 $redirecturl .= '?otherserver='.$otherserver;
                    383:             }
                    384: 	    $r->internal_redirect($redirecturl);
1.101     albertel  385: 	    $r->set_handlers('PerlHandler'=> undef);
1.94      albertel  386: 	} else {
                    387: 	    # need to login them in, so generate the need data that
                    388: 	    # migrate expects to do login
1.164     raeburn   389: 	    my $ip = $r->get_remote_host();
1.147     raeburn   390: 	    my %info=('ip'        => $ip,
1.94      albertel  391: 		      'domain'    => $domain,
1.97      albertel  392: 		      'username'  => $user,
1.94      albertel  393: 		      'server'    => $r->dir_config('lonHostID'),
                    394: 		      'sso.login' => 1
                    395: 		      );
1.158     raeburn   396:             foreach my $item ('role','symb','iptoken') {
1.126     raeburn   397:                 if (exists($form{$item})) {
                    398:                     $info{$item} = $form{$item};
                    399:                 }
                    400:             }
1.151     raeburn   401:             unless ($info{'symb'}) {
1.152     raeburn   402:                 unless (($r->uri eq '/adm/roles') || ($r->uri eq '/adm/sso')) {
1.151     raeburn   403:                     $info{'origurl'} = $r->uri; 
                    404:                 }
                    405:             }
1.116     raeburn   406:             if ($r->dir_config("ssodirecturl") == 1) {
                    407:                 $info{'origurl'} = $r->uri;
                    408:             }
1.106     raeburn   409:             if (defined($r->dir_config("lonSSOReloginServer"))) {
                    410:                 $info{'sso.reloginserver'} = 
                    411:                     $r->dir_config('lonSSOReloginServer'); 
                    412:             }
1.165     raeburn   413:             if (($is_balancer) && ($hosthere)) {
                    414:                 $info{'noloadbalance'} = $hosthere;
                    415:             }
1.94      albertel  416: 	    my $token = 
                    417: 		&Apache::lonnet::tmpput(\%info,
                    418: 					$r->dir_config('lonHostID'));
                    419: 	    $env{'form.token'} = $token;
                    420: 	    $r->internal_redirect('/adm/migrateuser');
1.101     albertel  421: 	    $r->set_handlers('PerlHandler'=> undef);
1.94      albertel  422: 	}
                    423: 	return OK;
1.155     raeburn   424:     } else {
1.107     albertel  425: 	&Apache::lonnet::logthis(" SSO authorized unknown user $user ");
1.115     raeburn   426:         my @cancreate;
                    427:         my %domconfig =
                    428:             &Apache::lonnet::get_dom('configuration',['usercreation'],$domain);
                    429:         if (ref($domconfig{'usercreation'}) eq 'HASH') {
                    430:             if (ref($domconfig{'usercreation'}{'cancreate'}) eq 'HASH') {
                    431:                 if (ref($domconfig{'usercreation'}{'cancreate'}{'selfcreate'}) eq 'ARRAY') {
                    432:                     @cancreate = @{$domconfig{'usercreation'}{'cancreate'}{'selfcreate'}};
                    433:                 } elsif (($domconfig{'usercreation'}{'cancreate'}{'selfcreate'} ne 'none') && 
                    434:                          ($domconfig{'usercreation'}{'cancreate'}{'selfcreate'} ne '')) {
                    435:                     @cancreate = ($domconfig{'usercreation'}{'cancreate'}{'selfcreate'});
                    436:                 }
                    437:             }
                    438:         }
1.155     raeburn   439:         if ((grep(/^sso$/,@cancreate)) || (defined($r->dir_config('lonSSOUserUnknownRedirect')))) {
                    440:             $r->subprocess_env->set('SSOUserUnknown' => $user);
                    441:             $r->subprocess_env->set('SSOUserDomain' => $domain);
                    442:             if (grep(/^sso$/,@cancreate)) {
                    443:                 $r->set_handlers('PerlHandler'=> [\&Apache::createaccount::handler]);
                    444:                 $r->handler('perl-script');
                    445:             } else {
                    446: 	        $r->internal_redirect($r->dir_config('lonSSOUserUnknownRedirect'));
                    447:                 $r->set_handlers('PerlHandler'=> undef);
                    448:             }
                    449: 	    return OK;
1.115     raeburn   450:         }
1.94      albertel  451:     }
                    452:     return undef;
                    453: }
                    454: 
1.179   ! raeburn   455: sub needs_symb_check {
        !           456:     my ($requrl) = @_;
        !           457:     $requrl=~/\.(\w+)$/;
        !           458:     if ((&Apache::loncommon::fileembstyle($1) eq 'ssi') ||
        !           459:         ($requrl=~/^\/adm\/.*\/(aboutme|smppg|bulletinboard)(\?|$ )/x) ||
        !           460:         ($requrl=~/^\/adm\/wrapper\//) ||
        !           461:         ($requrl=~m|^/adm/coursedocs/showdoc/|) ||
        !           462:         ($requrl=~m|\.problem/smpedit$|) ||
        !           463:         ($requrl=~/^\/public\/.*\/syllabus$/) ||
        !           464:         ($requrl=~/^\/adm\/(viewclasslist|navmaps)$/) ||
        !           465:         ($requrl=~/^\/adm\/.*\/aboutme\/portfolio(\?|$)/)) {
        !           466:         return 1;
        !           467:     }
        !           468:     return;
        !           469: }
        !           470: 
1.1       albertel  471: sub handler {
                    472:     my $r = shift;
                    473:     my $requrl=$r->uri;
1.149     raeburn   474: 
                    475:     if ($requrl =~ m{^/res/adm/pages/[^/]+\.(gif|png)$}) {
1.108     raeburn   476:         return OK;
                    477:     }
1.70      albertel  478: 
1.149     raeburn   479:     if (&Apache::lonnet::is_domainimage($requrl)) {
1.124     raeburn   480:         return OK;
                    481:     }
                    482: 
1.149     raeburn   483:     my %user;
                    484:     my $handle = &Apache::lonnet::check_for_valid_session($r,undef,\%user);
1.93      albertel  485: 
1.150     raeburn   486:     unless (($requrl eq '/adm/switchserver') && (!$r->is_initial_req())) {
                    487:         my $result = &sso_login($r,$handle,$user{'name'});
                    488:         if (defined($result)) {
                    489: 	    return $result;
                    490:         }
1.70      albertel  491:     }
                    492: 
1.137     raeburn   493:     my ($is_balancer,$otherserver);
1.142     raeburn   494: 
1.92      albertel  495:     if ($handle eq '') {
1.159     raeburn   496:         unless ((($requrl eq '/adm/switchserver') && (!$r->is_initial_req())) ||
                    497:                 ($requrl =~ m{^/public/$match_domain/$match_courseid/syllabus}) ||
                    498:                 ($requrl =~ m{^/adm/help/}) ||
                    499:                 ($requrl =~ m{^/res/$match_domain/$match_username/})) {
1.149     raeburn   500: 	    $r->log_reason("Cookie not valid", $r->filename);
1.142     raeburn   501:         }
1.111     albertel  502:     } elsif ($handle ne '') {
1.6       www       503: 
1.46      www       504: # ------------------------------------------------------ Initialize Environment
1.111     albertel  505: 	my $lonidsdir=$r->dir_config('lonIDsDir');
1.92      albertel  506: 	&Apache::lonnet::transfer_profile_to_env($lonidsdir,$handle);
1.47      www       507: 
                    508: # --------------------------------------------------------- Initialize Language
                    509: 
1.92      albertel  510: 	&Apache::lonlocal::get_language_handle($r);
                    511: 
                    512:     }
1.46      www       513: 
1.92      albertel  514: # -------------------------------------------------- Should be a valid user now
                    515:     if ($env{'user.name'} ne '' && $env{'user.domain'} ne '') {
1.46      www       516: # -------------------------------------------------------------- Resource State
1.6       www       517: 
1.141     raeburn   518:         my ($cdom,$cnum);
                    519:         if ($env{'request.course.id'}) {
                    520:             $cdom = $env{'course.'.$env{'request.course.id'}.'.domain'};
                    521:             $cnum = $env{'course.'.$env{'request.course.id'}.'.num'};
                    522:         }
1.92      albertel  523: 	if ($requrl=~/^\/+(res|uploaded)\//) {
                    524: 	    $env{'request.state'} = "published";
                    525: 	} else {
                    526: 	    $env{'request.state'} = 'unknown';
                    527: 	}
                    528: 	$env{'request.filename'} = $r->filename;
                    529: 	$env{'request.noversionuri'} = &Apache::lonnet::deversion($requrl);
1.157     raeburn   530:         my ($suppext,$checkabsolute);
1.129     raeburn   531:         if ($requrl =~ m{^/adm/wrapper/ext/}) {
                    532:             my $query = $r->args;
                    533:             if ($query) {
                    534:                 my $preserved;
                    535:                 foreach my $pair (split(/&/,$query)) {
                    536:                     my ($name, $value) = split(/=/,$pair);
1.174     raeburn   537:                     unless (($name eq 'symb') || ($name eq 'usehttp')) {
1.129     raeburn   538:                         $preserved .= $pair.'&';
                    539:                     }
1.141     raeburn   540:                     if (($env{'request.course.id'}) && ($name eq 'folderpath')) {
                    541:                         if ($value =~ /^supplemental/) {
                    542:                             $suppext = 1;
                    543:                         }
                    544:                     }
1.129     raeburn   545:                 }
                    546:                 $preserved =~ s/\&$//;
                    547:                 if ($preserved) {
                    548:                     $env{'request.external.querystring'} = $preserved;
                    549:                 }
                    550:             }
1.157     raeburn   551:             if ($env{'request.course.id'}) {
                    552:                 $checkabsolute = 1;
                    553:             }
1.141     raeburn   554:         } elsif ($env{'request.course.id'} &&
                    555:                  (($requrl =~ m{^/adm/$match_domain/$match_username/aboutme$}) ||
1.166     raeburn   556:                   ($requrl eq "/public/$cdom/$cnum/syllabus") ||
1.167     raeburn   557:                   ($requrl =~ m{^/adm/$cdom/$cnum/\d+/ext\.tool$}))) {
1.141     raeburn   558:             my $query = $r->args;
                    559:             if ($query) {
                    560:                 foreach my $pair (split(/&/,$query)) {
                    561:                     my ($name, $value) = split(/=/,$pair);
                    562:                     if ($name eq 'folderpath') {
                    563:                         if ($value =~ /^supplemental/) {
                    564:                             $suppext = 1;
                    565:                         }
                    566:                     }
                    567:                 }
                    568:             }
1.157     raeburn   569:             if ($requrl =~ m{^/public/$cdom/$cnum/syllabus$}) {
                    570:                 $checkabsolute = 1;
                    571:             }
                    572:         }
                    573:         if ($checkabsolute) {
                    574:             my $hostname = $r->hostname();
                    575:             my $lonhost = &Apache::lonnet::host_from_dns($hostname);
                    576:             if ($lonhost) {
                    577:                 my $actual = &Apache::lonnet::absolute_url($hostname);
1.173     raeburn   578:                 my $exphostname = &Apache::lonnet::hostname($lonhost);
1.157     raeburn   579:                 my $expected = $Apache::lonnet::protocol{$lonhost}.'://'.$hostname;
                    580:                 unless ($actual eq $expected) {
                    581:                     $env{'request.use_absolute'} = $expected;
                    582:                 }
                    583:             }
1.129     raeburn   584:         }
1.6       www       585: # -------------------------------------------------------- Load POST parameters
                    586: 
1.92      albertel  587: 	&Apache::lonacc::get_posted_cgi($r);
1.6       www       588: 
1.137     raeburn   589: # ------------------------------------------------------ Check if load balancer 
                    590: 
1.138     raeburn   591:         my $checkexempt;
                    592:         if ($env{'user.loadbalexempt'} eq $r->dir_config('lonHostID')) {
                    593:             if ($env{'user.loadbalcheck.time'} + 600 > time) {
1.171     raeburn   594:                 $checkexempt = 1;
1.138     raeburn   595:             }
                    596:         }
1.145     raeburn   597:         if ($env{'user.noloadbalance'} eq $r->dir_config('lonHostID')) {
                    598:             $checkexempt = 1;
                    599:         }
1.138     raeburn   600:         unless ($checkexempt) {
                    601:             ($is_balancer,$otherserver) =
                    602:                 &Apache::lonnet::check_loadbalancing($env{'user.name'},
                    603:                                                      $env{'user.domain'});
1.171     raeburn   604:             if ($is_balancer) {
                    605:                 unless (($requrl eq '/adm/switchserver') && (!$r->is_initial_req())) {
                    606:                     # Check if browser sent a LON-CAPA load balancer cookie (and this is a balancer)
                    607:                     my ($found_server,$balancer_cookie) = &Apache::lonnet::check_for_balancer_cookie($r);
                    608:                     if (($found_server) && ($balancer_cookie =~ /^\Q$env{'user.domain'}\E_\Q$env{'user.name'}\E_/)) {
                    609:                         $otherserver = $found_server;
                    610:                     }
                    611:                 }
                    612:             }
1.138     raeburn   613:         }
1.137     raeburn   614:         if ($is_balancer) {
1.171     raeburn   615:             unless (($requrl eq '/adm/switchserver') && (!$r->is_initial_req())) {
                    616:                 $r->set_handlers('PerlResponseHandler'=>
                    617:                                  [\&Apache::switchserver::handler]);
                    618:                 if ($otherserver ne '') {
                    619:                     $env{'form.otherserver'} = $otherserver;
                    620:                 }
1.137     raeburn   621:             }
1.152     raeburn   622:             unless (($env{'form.origurl'}) || ($r->uri eq '/adm/roles') ||
                    623:                     ($r->uri eq '/adm/switchserver') || ($r->uri eq '/adm/sso')) {
                    624:                 $env{'form.origurl'} = $r->uri;
                    625:             }
1.137     raeburn   626:         }
1.169     raeburn   627:         if ($requrl=~m{^/+tiny/+$match_domain/+\w+$}) {
1.178     raeburn   628:             if ($env{'user.name'} eq 'public' &&
                    629:                 $env{'user.domain'} eq 'public') {
                    630:                 $env{'request.firsturl'}=$requrl;
                    631:                 return FORBIDDEN;
                    632:             } else {
                    633:                 return OK;
                    634:             }
1.169     raeburn   635:         }
1.6       www       636: # ---------------------------------------------------------------- Check access
1.92      albertel  637: 	my $now = time;
1.177     raeburn   638: 	if ($requrl !~ m{^/(?:adm|public|(?:prt|zip)spool)/}
1.95      albertel  639: 	    || $requrl =~ /^\/adm\/.*\/(smppg|bulletinboard)(\?|$ )/x) {
1.179   ! raeburn   640:             my ($access,$poss_symb);
        !           641:             if (($env{'request.course.id'}) && (!$suppext) && (&needs_symb_check($requrl))) {
        !           642:                 unless ($env{'form.symb'}) {
        !           643:                     if ($r->args) {
        !           644:                         &Apache::loncommon::get_unprocessed_cgi($r->args,['symb']);
        !           645:                     }
        !           646:                 }
        !           647:                 if ($env{'form.symb'}) {
        !           648:                     $poss_symb=&Apache::lonnet::symbclean($env{'form.symb'});
        !           649:                 }
        !           650:                 if ($poss_symb) {
        !           651:                     my ($possmap,$resid,$url)=&Apache::lonnet::decode_symb($poss_symb);
        !           652:                     $url = &Apache::lonnet::clutter($url);
        !           653:                     unless (($url eq $requrl) && (&Apache::lonnet::is_on_map($possmap))) {
        !           654:                         undef($poss_symb);
        !           655:                     }
        !           656:                     if ($poss_symb) {
        !           657:                         if ((!$env{'request.role.adv'}) && ($env{'acc.randomout'}) &&
        !           658:                             ($env{'acc.randomout'}=~/\&\Q$poss_symb\E\&/)) {
        !           659:                             undef($poss_symb);
        !           660:                         }
        !           661:                     }
        !           662:                 }
        !           663:                 if ($poss_symb) {
        !           664:                     $access=&Apache::lonnet::allowed('bre',$requrl,$poss_symb);
        !           665:                 } else {
        !           666:                     $access=&Apache::lonnet::allowed('bre',$requrl,'','','','',1);
        !           667:                 }
        !           668:             } else {
        !           669:                 $access=&Apache::lonnet::allowed('bre',$requrl);
        !           670:             }
1.159     raeburn   671:             if ($handle eq '') {
                    672:                 unless ($access eq 'F') {
                    673:                     if ($requrl =~ m{^/res/$match_domain/$match_username/}) {
                    674:                         $r->log_reason("Cookie not valid", $r->filename);
                    675:                     }
                    676:                 }
                    677:             }
1.92      albertel  678: 	    if ($access eq '1') {
                    679: 		$env{'user.error.msg'}="$requrl:bre:0:0:Choose Course";
                    680: 		return HTTP_NOT_ACCEPTABLE; 
                    681: 	    }
                    682: 	    if ($access eq 'A') {
                    683: 		&Apache::restrictedaccess::setup_handler($r);
                    684: 		return OK;
                    685: 	    }
1.103     raeburn   686:             if ($access eq 'B') {
1.179   ! raeburn   687:                 if ($poss_symb) {
        !           688:                     if ($requrl=~m{^(/adm/.*/aboutme)/portfolio$}) {
        !           689:                         $requrl = $1;
        !           690:                     }
        !           691:                     if (&Apache::lonnet::symbverify($poss_symb,$requrl)) {
        !           692:                         $env{'request.symb'} = $poss_symb;
        !           693:                     }
        !           694:                 }
1.103     raeburn   695:                 &Apache::blockedaccess::setup_handler($r);
                    696:                 return OK;
                    697:             }
1.175     raeburn   698:             if ($access eq 'D') {
                    699:                 &Apache::lonprotected::setup_handler($r);
                    700:                 return OK;
                    701:             }
1.92      albertel  702: 	    if (($access ne '2') && ($access ne 'F')) {
1.130     raeburn   703:                 if ($requrl =~ m{^/res/}) {
                    704:                     $access = &Apache::lonnet::allowed('bro',$requrl);
                    705:                     if ($access ne 'F') {
1.132     raeburn   706:                         if ($requrl eq '/res/lib/templates/simpleproblem.problem/smpedit') {
                    707:                             $access = &Apache::lonnet::allowed('bre','/res/lib/templates/simpleproblem.problem');
                    708:                             if ($access ne 'F') {
                    709:                                 $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    710:                                 return HTTP_NOT_ACCEPTABLE;
                    711:                             }
                    712:                         } else {
                    713:                             $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    714:                             return HTTP_NOT_ACCEPTABLE;
                    715:                         }
1.130     raeburn   716:                     }
1.160     raeburn   717:                 } elsif (($handle =~ /^publicuser_\d+$/) && (&Apache::lonnet::is_portfolio_url($requrl))) {
                    718:                     my $clientip = $r->get_remote_host();
                    719:                     if (&Apache::lonnet::allowed('bre',$requrl,undef,undef,$clientip) ne 'F') {
                    720:                         $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    721:                         return HTTP_NOT_ACCEPTABLE;
                    722:                     }
1.130     raeburn   723:                 } else {
                    724: 		    $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    725: 		    return HTTP_NOT_ACCEPTABLE;
                    726:                 }
1.37      albertel  727: 	    }
1.92      albertel  728: 	}
                    729: 	if ($requrl =~ m|^/prtspool/|) {
                    730: 	    my $start='/prtspool/'.$env{'user.name'}.'_'.
                    731: 		$env{'user.domain'};
                    732: 	    if ($requrl !~ /^\Q$start\E/) {
                    733: 		$env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    734: 		return HTTP_NOT_ACCEPTABLE;
1.67      albertel  735: 	    }
1.92      albertel  736: 	}
1.109     banghart  737: 	if ($requrl =~ m|^/zipspool/|) {
1.110     banghart  738: 	    my $start='/zipspool/zipout/'.$env{'user.name'}.":".
1.109     banghart  739: 		$env{'user.domain'};
                    740: 	    if ($requrl !~ /^\Q$start\E/) {
                    741: 		$env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    742: 		return HTTP_NOT_ACCEPTABLE;
                    743: 	    }
                    744: 	}
1.92      albertel  745: 	if ($env{'user.name'} eq 'public' && 
                    746: 	    $env{'user.domain'} eq 'public' &&
                    747: 	    $requrl !~ m{^/+(res|public|uploaded)/} &&
                    748: 	    $requrl !~ m{^/adm/[^/]+/[^/]+/aboutme/portfolio$ }x &&
1.128     droeschl  749:         $requrl !~ m{^/adm/blockingstatus/.*$} &&
1.92      albertel  750: 	    $requrl !~ m{^/+adm/(help|logout|restrictedaccess|randomlabel\.png)}) {
                    751: 	    $env{'request.querystring'}=$r->args;
                    752: 	    $env{'request.firsturl'}=$requrl;
                    753: 	    return FORBIDDEN;
                    754: 	}
1.23      www       755: # ------------------------------------------------------------- This is allowed
1.92      albertel  756: 	if ($env{'request.course.id'}) {
1.24      www       757: 	    &Apache::lonnet::countacc($requrl);
1.125     raeburn   758:             my $query=$r->args;
1.179   ! raeburn   759:             if (&needs_symb_check($requrl)) {
1.23      www       760: # ------------------------------------- This is serious stuff, get symb and log
1.92      albertel  761: 		my $symb;
                    762: 		if ($query) {
1.141     raeburn   763: 		    &Apache::loncommon::get_unprocessed_cgi($query,['symb','folderpath']);
1.92      albertel  764: 		}
                    765: 		if ($env{'form.symb'}) {
1.64      albertel  766: 		    $symb=&Apache::lonnet::symbclean($env{'form.symb'});
1.176     raeburn   767: 		    if ($requrl eq '/adm/navmaps') {
                    768:                         my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
                    769:                         &Apache::lonnet::symblist($map,$murl => [$murl,$mid]);
                    770: 		    } elsif ($requrl =~ m|^/adm/wrapper/|
1.72      albertel  771: 			|| $requrl =~ m|^/adm/coursedocs/showdoc/|) {
1.92      albertel  772: 			my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
1.176     raeburn   773:                         if ($map =~ /\.page$/) {
                    774:                             my $mapsymb = &Apache::lonnet::symbread($map);
                    775:                             ($map,$mid,$murl)=&Apache::lonnet::decode_symb($mapsymb); 
                    776:                         }
1.92      albertel  777: 			&Apache::lonnet::symblist($map,$murl => [$murl,$mid],
1.63      albertel  778: 						  'last_known' =>[$murl,$mid]);
1.92      albertel  779: 		    } elsif ((&Apache::lonnet::symbverify($symb,$requrl)) ||
1.53      albertel  780: 			     (($requrl=~m|(.*)/smpedit$|) &&
1.134     raeburn   781: 			      &Apache::lonnet::symbverify($symb,$1)) ||
                    782:                              (($requrl=~m|(.*/aboutme)/portfolio$|) &&
                    783:                               &Apache::lonnet::symbverify($symb,$1))) {
1.92      albertel  784: 			my ($map,$mid,$murl)=&Apache::lonnet::decode_symb($symb);
1.176     raeburn   785:                         if (($map =~ /\.page$/) && ($requrl !~ /\.page$/)) {
                    786:                             my $mapsymb = &Apache::lonnet::symbread($map);
                    787:                             ($map,$mid,$murl)=&Apache::lonnet::decode_symb($mapsymb);
                    788:                         }
1.92      albertel  789: 			&Apache::lonnet::symblist($map,$murl => [$murl,$mid],
                    790: 						  'last_known' =>[$murl,$mid]);
1.31      www       791: 		    } else {
                    792: 			$r->log_reason('Invalid symb for '.$requrl.': '.
1.92      albertel  793: 				       $symb);
                    794: 			$env{'user.error.msg'}=
                    795: 			    "$requrl:bre:1:1:Invalid Access";
                    796: 			return HTTP_NOT_ACCEPTABLE; 
                    797: 		    }
                    798: 		} else {
1.134     raeburn   799:                     if ($requrl=~m{^(/adm/.*/aboutme)/portfolio$}) {
                    800:                         $requrl = $1;
                    801:                     }
1.141     raeburn   802:                     unless ($suppext) {
                    803: 		        $symb=&Apache::lonnet::symbread($requrl);
1.179   ! raeburn   804:                         if (&Apache::lonnet::is_on_map($requrl) && $symb) {
        !           805:                             my ($encstate,$invalidsymb);
        !           806:                             unless (&Apache::lonnet::symbverify($symb,$requrl,\$encstate)) {
        !           807:                                 $invalidsymb = 1;
        !           808:                                 #
        !           809:                                 # If $env{'request.enc'} is true, but no encryption for $symb retrieved
        !           810:                                 # by original lonnet::symbread() call, call again to check for an instance
        !           811:                                 # of $requrl in the course which has encryption, and set that as the symb.
        !           812:                                 # If there is no such symb, or symbverify() fails for the new symb proceed
        !           813:                                 # to report invalid symb.
        !           814:                                 #
        !           815:                                 if ($env{'request.enc'} && !$encstate) {
        !           816:                                     my %possibles;
        !           817:                                     my $nocache = 1;
        !           818:                                     $symb = &Apache::lonnet::symbread($requrl,'','','',\%possibles,$nocache);
        !           819:                                     if ($symb) {
        !           820:                                         if (&Apache::lonnet::symbverify($symb,$requrl)) {
        !           821:                                             $invalidsymb = '';
        !           822:                                         }
        !           823:                                     } elsif (keys(%possibles) > 1) {
        !           824:                                         $r->internal_redirect('/adm/ambiguous');
        !           825:                                         return OK;
        !           826:                                     }
        !           827:                                 }
        !           828:                                 if ($invalidsymb) {
        !           829:                                     $r->log_reason('Invalid symb for '.$requrl.': '.$symb);
        !           830:                                     $env{'user.error.msg'}=
        !           831:                                         "$requrl:bre:1:1:Invalid Access";
        !           832:                                     return HTTP_NOT_ACCEPTABLE;
        !           833:                                 }
        !           834:                             }
        !           835:                         }
1.141     raeburn   836: 		        if ($symb) {
                    837: 			    my ($map,$mid,$murl)=
                    838: 			        &Apache::lonnet::decode_symb($symb);
1.176     raeburn   839:                             if ($requrl eq '/adm/navmaps') {
                    840:                                 &Apache::lonnet::symblist($map,$murl =>[$murl,$mid]);
                    841:                             } else {
                    842:                                 if (($map =~ /\.page$/) && ($requrl !~ /\.page$/)) {
                    843:                                     my $mapsymb = &Apache::lonnet::symbread($map);
                    844:                                     ($map,$mid,$murl)=&Apache::lonnet::decode_symb($mapsymb);
                    845:                                 }
                    846: 			        &Apache::lonnet::symblist($map,$murl =>[$murl,$mid],
                    847: 						          'last_known' =>[$murl,$mid]);
                    848:                             }
1.141     raeburn   849: 		        }
1.61      albertel  850: 		    }
1.92      albertel  851: 		}
                    852: 		$env{'request.symb'}=$symb;
1.179   ! raeburn   853:                 if (($env{'request.symbread.cached.'}) && ($env{'request.symbread.cached.'} ne $symb)) {
        !           854:                     $env{'request.symbread.cached.'} = $symb;
        !           855:                 }
1.92      albertel  856: 		&Apache::lonnet::courseacclog($symb);
                    857: 	    } else {
1.23      www       858: # ------------------------------------------------------- This is other content
1.92      albertel  859: 		&Apache::lonnet::courseacclog($requrl);    
                    860: 	    }
1.140     raeburn   861:             if ($requrl =~ m{^/+uploaded/\Q$cdom\E/\Q$cnum\E/(docs|supplemental)/.+\.html?$}) {
1.125     raeburn   862:                 if (&Apache::lonnet::allowed('mdc',$env{'request.course.id'})) {
                    863:                     if ($query) {
                    864:                         &Apache::loncommon::get_unprocessed_cgi($query,['forceedit']);
                    865:                         if ($env{'form.forceedit'}) {
                    866:                             $env{'request.state'} = 'edit';
                    867:                         }
                    868:                     }
                    869:                 }
1.144     raeburn   870:             } elsif ($requrl =~ m{^/+uploaded/\Q$cdom\E/\Q$cnum\E/portfolio/syllabus/.+\.html?$}) {
                    871:                 if (&Apache::lonnet::allowed('mdc',$env{'request.course.id'})) {
                    872:                     if ($query) {
                    873:                         &Apache::loncommon::get_unprocessed_cgi($query,['forceedit','editmode']);
                    874:                         if (($env{'form.forceedit'}) || ($env{'form.editmode'})) {
                    875:                             $env{'request.state'} = 'edit';
                    876:                         }
                    877:                     }
                    878:                 }
1.125     raeburn   879:             }
1.88      albertel  880: 	}
1.92      albertel  881: 	return OK;
1.137     raeburn   882:     } else {
                    883:         my $defdom=$r->dir_config('lonDefDomain');
                    884:         ($is_balancer,$otherserver) =
                    885:             &Apache::lonnet::check_loadbalancing(undef,$defdom);
                    886:         if ($is_balancer) {
                    887:             $r->set_handlers('PerlResponseHandler'=>
                    888:                              [\&Apache::switchserver::handler]);
                    889:             if ($otherserver ne '') {
                    890:                 $env{'form.otherserver'} = $otherserver;
                    891:             }
                    892:         }
1.92      albertel  893:     }
1.21      www       894: # -------------------------------------------- See if this is a public resource
1.68      albertel  895:     if ($requrl=~m|^/+adm/+help/+|) {
1.89      albertel  896:  	return OK;
1.68      albertel  897:     }
1.90      albertel  898: # ------------------------------------ See if this is a viewable portfolio file
1.89      albertel  899:     if (&Apache::lonnet::is_portfolio_url($requrl)) {
1.160     raeburn   900:         my $clientip = $r->get_remote_host();
                    901:         my $access=&Apache::lonnet::allowed('bre',$requrl,undef,undef,$clientip);
1.90      albertel  902: 	if ($access eq 'A') {
                    903: 	    &Apache::restrictedaccess::setup_handler($r);
                    904: 	    return OK;
                    905: 	}
                    906: 	if (($access ne '2') && ($access ne 'F')) {
                    907: 	    $env{'user.error.msg'}="$requrl:bre:1:1:Access Denied";
                    908: 	    return HTTP_NOT_ACCEPTABLE;
                    909: 	}
1.79      raeburn   910:     }
1.87      albertel  911: 
1.34      www       912: # -------------------------------------------------------------- Not authorized
                    913:     $requrl=~/\.(\w+)$/;
1.62      albertel  914: #    if ((&Apache::loncommon::fileembstyle($1) eq 'ssi') ||
                    915: #        ($requrl=~/^\/adm\/(roles|logout|email|menu|remote)/) ||
                    916: #        ($requrl=~m|^/prtspool/|)) {
1.34      www       917: # -------------------------- Store where they wanted to go and get login screen
1.64      albertel  918: 	$env{'request.querystring'}=$r->args;
                    919: 	$env{'request.firsturl'}=$requrl;
1.34      www       920:        return FORBIDDEN;
1.62      albertel  921: #   } else {
1.34      www       922: # --------------------------------------------------------------------- Goodbye
1.62      albertel  923: #       return HTTP_BAD_REQUEST;
                    924: #   }
1.1       albertel  925: }
                    926: 
                    927: 1;
                    928: __END__
1.120     jms       929: 
1.121     jms       930: =pod
1.120     jms       931: 
1.121     jms       932: =back
1.120     jms       933: 
1.121     jms       934: =cut
1.120     jms       935: 

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