--- doc/loncapafiles/Attic/loncapafiles.html 2001/02/27 21:06:07 1.58 +++ doc/loncapafiles/Attic/loncapafiles.html 2001/04/23 16:35:52 1.86 @@ -27,7 +27,7 @@ The format of these tags is:

Here are examples of all the different types of LONCAPA make/build tags. -
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler"> +
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler">
<LONCAPA TYPE=DIRECTORY DIST="redhat6.2" TARGET="home/httpd/lib/perl/Apache" CATEGORY="writeable by server">
<LONCAPA TYPE=OWNERSHIP DIST="redhat6.2" CATEGORY="setuid" CHMOD="6755" CHOWN="root:root">
<LONCAPA TYPE=RPM NAME="Vendor" VALUE="Laboratory for Instructional Technology Education, Division of Science and Mathematics Education, Michigan State University."> @@ -52,19 +52,19 @@ The NAME tags associated with TYPE=RPM a

Data can also be attached to any LON-CAPA tag. This is especially important for files. This is shown by these three examples:
<METAGROUP> -
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler"> +
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="modules/TexConvert/tthperl/lontex.pm" TARGET="home/httpd/lib/perl/Apache/lontex.pm" CATEGORY="handler">
<DESCRIPTION>
Handler for TeX files
</DESCRIPTION>
</METAGROUP>
 
<METAGROUP> -
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/modules/TexConvert/tthperl/tth.so" TARGET="usr/lib/perl5/site_perl/5.005/tth.so" CATEGORY="system file"> +
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="modules/TexConvert/tthperl/tth.so" TARGET="usr/lib/perl5/site_perl/5.005/tth.so" CATEGORY="system file">
<DESCRIPTION>
shared library file for dynamic loading and unloading of TeX-to-HTML functionality
</DESCRIPTION>
<BUILD> -
loncom/modules/TexConvert/tthperl/commands +
modules/TexConvert/tthperl/commands
</BUILD>
<DEPENDENCIES>
../tthdynamic/tthfunc.c @@ -160,8 +160,10 @@ browser and can only be seen be examinin + - + @@ -191,7 +193,16 @@ browser and can only be seen be examinin -define handlers, set parameters +This file has two major functions. +For the Apache web server, it defines a global +access configuration which defines what server options (Indexes", "Includes", +"FollowSymLinks", "ExecCGI", or "MultiViews") are associated +with specific directories ("/", "/home/httpd/html", "/home/httpd/cgi-bin", +and "/usr/doc"). For the LON-CAPA network server and perl module +handlers, it defines machine specific settings (lonHostID, lonRole, +lonAdmEMail, lonDefDomain, lonLoadLim, lonExpire, and lonReceipt) +and internal machine settings for specific directories, socket ports, +and browser detection logic. configure @@ -209,26 +220,30 @@ define handlers, set parameters -main server configuration file +This is the main server configuration file. The settings here are +more or less standard for the Apache web server. Most notably (and +importantly!), perl handling and mod_perl are enabled in this configuration +file.

-This file configures the "name space" of the Apache web server. srm.conf +This file configures the "name space" of the Apache web server. +srm.conf defines when specific perl modules should be called to handle a given -request. This definition is a function of the name of the perl module, +request. This definition is a function of both the name of the perl module, and a specific regular expression associated with the URL, such as "^/res/.*\.page".

Here is an example entry: 

-
+<LocationMatch "^/res/.*\.page$>
 SetHandler perl-script
 PerlHandler Apache::lonpage
-
+</LocationMatch>

@@ -236,13 +251,34 @@ PerlHandler Apache::lonpage -set paths to modules; invoked by access.conf +This file provides initializations for perl handlers. It adjusts what +the module path space is (so as to include /home/httpd/lib/perl/Apache) as +well as causing the Apache module to be used for every perl handler. +startup.pl is invoked by access.conf. -Descriptive list of file extensions, and extension groupings +Descriptive list of file extensions, and extension groupings. + + + + + +Default spreadsheet for individual assessment. + + + + + +Default spreadsheet for assessment of students. + + + + + +Default spreadsheet for assessment of a class. @@ -284,7 +320,7 @@ each list element consists of only one v - + Basic auth password to access /lon-status and /server-status @@ -336,6 +372,12 @@ Example:
server ntp.msu.edu + + +Batch script for updating SQL metadata database. + + + proxy server @@ -344,7 +386,17 @@ proxy server -remote command interpreter +This is a remote command interpreter on a TCP LON-CAPA network layer. +It accepts and processes incoming requests from other LON-CAPA machines +on the network. lond's functionality is self-contained in the sense +that it does not reference (import, require, use) any other file +described in this document. There are only 15 subroutines in this +script, however the make_new_child subroutine is quite +complex since it parses and responds about 29 different types of +network requests (i.e. enc, ping, pong, ekey, load, auth, passwd, +makeuser, home, update, unsub, sub, log, put, rolesput, get, eget, +del, keys, dump, store, restore, querysend, queryreply, idput, idget, +tmpput, tmpget, and ls). @@ -429,16 +481,72 @@ Table which has hash data necessary for - + -Handler for interacting with MySQL database (via lonsql layer). +Handler to upload files through browser into construction space. + +works/unverified + + + + +Handler to evaluate essay (ungraded) style responses. + +works/unverified + + + + +Handler to publish directories. + +works/unverified + + + + +Handler to retrieve old versions from resource space. + +works/unverified + + + + +Helper functions when in homework edit mode. + +works/unverified + + + + +Metadata display handler. + +works/unverified + + + + +Handler to resolve ambiguous file locations. + +works/unverified + + + + +Handler to set resource parameters inside of the RAT based on metadata. + +works/unverified + + + + +Handler for showing sequence objects of educational resources. works/unverified -Creates a new course and assigns course coordinator +Creates a new course and assigns course coordinator. works/unverified @@ -663,13 +771,13 @@ compile course into binary data structur - + -Handler for tex files (somewhere in loncom/modules) +Handler for tex files (somewhere in modules) - + Access to tth/ttm @@ -737,7 +845,10 @@ handles request to the CAPA homework pro -access to for a LON-CAPA user session +(This module, like loncacc.pm also authenticates with cookies.) +lonacc.pm coordinates access to a wide range of administrative-type +functions (e.g. roles, logout, annotations, and bookmarks) as well +as coordinating access to educational resources. @@ -749,7 +860,16 @@ access handler for file transfers -access to construction area +This module provides access to an educational resource construction area. +This module is invoked by the URL-related pattern syntax +LocationMatch "^/priv.*" or LocationMatch "^/\~.*". +Authentication of user identity +is coordinated through cookies. The abbreviation "cacc" corresponds +to "construction-space access"). If the cookie handle is invalid, then +this module returns a forbidden status and makes appropriate log entries. +If the cookie handle is valid, status is determined to be okay (and, +for the "priv"-type access, the resource is delivered by the +lonconstruct module). @@ -779,9 +899,15 @@ replication -roles picking +This perl handling module reads in the available roles available +for a LON-CAPA user (different courses, different privileges, etc) +and produces a form-element HTML page which allows the user to select +which role he wishes to exercise in the LON-CAPA system. For instance, +a user may want to select between being a student in a thermodynamics +physics course or a teaching assistant for an introductory calculus +class. - + @@ -791,7 +917,16 @@ cross server filesystem browser -interface to lonc +This file is an interface to the lonc processes of the LON-CAPA network +as well as set of elaborated functions for handling information necessary +for navigating through a given cluster of LON-CAPA machines within a domain. +There are over 40 specialized functions in this module which handle +the reading and transmission of metadata, user information +(ids, names, environments, roles, logs), file information (storage, reading, +directories, extensions, replication, embedded styles and descriptors), +educational resources (course descriptions, section names and numbers), +url hashing (to assign roles on a url basis), and translating abbreviated +symbols to and from more descriptive phrases or explanations. @@ -976,8 +1111,27 @@ icons to indicate an unexpected result lonconstruct.gif lonlogo_broken.gif +lonlogo_broken_tsp.gif + + + +icon to indicate an unexpected result + + + + + +icon to indicate an unexpected result + + + + + +icon to indicate an unexpected result + + @@ -989,8 +1143,17 @@ lonlogo.gif lonlogos.gif + + + +miscellaneous resources + + +cat_button.gif + + - + perl module for invoking functions specific to Tex-to-HTML conversion @@ -1001,12 +1164,12 @@ the build process however. - + shared library file for dynamic loading and unloading -loncom/modules/TexConvert/tthperl/commands +modules/TexConvert/tthperl/commands ../tthdynamic/tthfunc.c @@ -1100,6 +1263,12 @@ Encryption Routines according to Data En + + +used by lonxml::xmlparse() as input variable $safeinit to Apache::run::run() + + + used by lonxml::xmlparse() as input variable $safeinit to Apache::run::run() @@ -1138,6 +1307,7 @@ j.gif k.gif l.gif ledblink.gif +ledgreen.gif ledoff.gif ledon.gif ledsend.gif @@ -1276,24 +1446,24 @@ world2.gif icons used for directory indexing and login screen -button_close.gif -button_edit.gif -button_preview.gif -folder_closed.gif -folder_closed_pressed.gif +folder_anim.gif +folder_close.gif +folder_drag.gif folder_new.gif -folder_opened.gif -folder_opened_pressed.gif +folder_open.gif folder_pointer_closed.gif folder_pointer_opened.gif -folder_spacer.gif +folder_static.gif folder_trash.gif +folder_trash_hover.gif left_bar.gif link.gif -link_pressed.gif +link_anim.gif +link_drag.gif ll_corner.gif lower_bar.gif lr_corner.gif +pix.gif right_bar.gif toolbar_bg.gif ul_corner.gif @@ -1307,22 +1477,8 @@ ur_corner.gif associated with the frameset scheme of displaying bookmarks -aaloader.html -bookmarkmenu_bb.html -bookmarkmenu_left.html -bookmarkmenu_ll.html -bookmarkmenu_lr.html -bookmarkmenu_right.html bookmarkmenu_toolbar.html -bookmarkmenu_ul.html -bookmarkmenu_ur.html -bookmarkmenu_uu.html -bookmarkpal.html -bookmarkpal_old.html -bookmarkpal_v2.html -bookmarkpal_v2_backup.html -index.html -loading_bookmarks.html +blank.html