--- loncom/auth/lonracc.pm 2007/03/02 23:43:29 1.22 +++ loncom/auth/lonracc.pm 2008/11/12 20:01:09 1.23 @@ -1,7 +1,7 @@ # The LearningOnline Network # Access Handler for File Transfers # -# $Id: lonracc.pm,v 1.22 2007/03/02 23:43:29 albertel Exp $ +# $Id: lonracc.pm,v 1.23 2008/11/12 20:01:09 jms Exp $ # # Copyright Michigan State University Board of Trustees # @@ -26,6 +26,53 @@ # http://www.lon-capa.org/ # +=pod + +=head1 NAME + +Apache::lonracc - Access Handler for File Transfers + +=head1 SYNOPSIS + +Invoked by /etc/httpd/conf/loncapa.conf: + + + PerlAccessHandler Apache::lonracc + + +=head1 INTRODUCTION + +This module enables authentication for file transfers and works +against the /res tree. + +Only lond invokes the /raw namespace through its subscribe function. + +This is part of the LearningOnline Network with CAPA project +described at http://www.lon-capa.org. + +=head1 HANDLER SUBROUTINE + +This routine is called by Apache and mod_perl. + +=over 4 + +=item * + +Determine requesting host + +=item * + +See whether or not the requesting host is subscribed. + +=item * + +Respond with status of request and make log entry in case of unallowed +access. + +=back + +=cut + package Apache::lonracc; use strict; @@ -101,50 +148,7 @@ sub handler { 1; __END__ -=head1 NAME - -Apache::lonracc - Access Handler for File Transfers - -=head1 SYNOPSIS - -Invoked by /etc/httpd/conf/loncapa.conf: - - - PerlAccessHandler Apache::lonracc - - -=head1 INTRODUCTION - -This module enables authentication for file transfers and works -against the /res tree. - -Only lond invokes the /raw namespace through its subscribe function. - -This is part of the LearningOnline Network with CAPA project -described at http://www.lon-capa.org. - -=head1 HANDLER SUBROUTINE - -This routine is called by Apache and mod_perl. - -=over 4 - -=item * - -Determine requesting host - -=item * - -See whether or not the requesting host is subscribed. -=item * - -Respond with status of request and make log entry in case of unallowed -access. - -=back - -=cut