--- doc/loncapafiles/Attic/loncapafiles.html 2000/09/24 01:08:06 1.2 +++ doc/loncapafiles/Attic/loncapafiles.html 2000/12/26 17:25:41 1.45 @@ -1,48 +1,200 @@ - - Untitled Document + + LON-CAPA Files and Directories

LON-CAPA Files and Directories


Scott Harrison, September 2000 +
Scott Harrison, October 2000 +
Scott Harrison, November 2000
Gerd Kortemeyer, Spring-Summer 2000

-Note: these files only refer to -

-and, these files +
    +
  1. Contents and Structure of loncapafiles.html +
  2. Software Package Information +
+

+
+

1. Contents and Structure of this loncapafiles.html

+

+This file contains specialized markup tags which encode information readable +by the LON-CAPA make/build process. This is meant to be "the master file" which +encodes all necessary configuration information to the associated make process. +The format of these tags is: +
<LONCAPA TYPE=type [otherparameters]> +

+

+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=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."> +

+

+The NAME tags associated with TYPE=RPM are:

+

+

+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"> +
<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"> +
<DESCRIPTION> +
shared library file for dynamic loading and unloading of TeX-to-HTML functionality +
</DESCRIPTION> +
<BUILD> +
loncom/modules/TexConvert/tthperl/commands +
</BUILD> +
<DEPENDENCIES> +
../tthdynamic/tthfunc.c +
../ttmdynamic/ttmfunc.c +
</DEPENDENCIES> +
</METAGROUP> +
  +
<METAGROUP> +
<LONCAPA TYPE=LOCATION DIST="redhat6.2" SOURCE="loncom/access.conf" TARGET="etc/httpd/conf/access.conf" CATEGORY="conf"> +
<DESCRIPTION> +
define handlers, set parameters +
</DESCRIPTION> +
<NOTE> +
<TABLE CELLPADDING=0 CELLSPACING=0 BORDER=1> +
<TR><TD><TT>lonHostID</TT></TD><TD>LON-internal HostID of this machine</TD></TR> +
<TR><TD><TT>lonRole</TT></TD><TD>Role of this machine: library, access</TD></TR> +
<TR><TD><TT>lonAdmEMail</TT></TD><TD>Server Administration</TD></TR> +
<TR><TD><TT>lonDefDomain</TT></TD><TD>Default domain</TD></TR> +
<TR><TD><TT>lonLoadLim</TT></TD><TD>Load Limit ( 100% loadavg )</TD></TR> +
<TR><TD><TT>lonExpire</TT></TD><TD>Expiration for local copies in seconds</TD></TR> +
</TABLE> +
</NOTE> +
</METAGROUP> +

+

+The METAGROUP tags for files are anticipatively limited to: NOTE, BUILD, DEPENDENCIES and DESCRIPTION. +

+

+To allow for viewing the tag information in a tabular HTML format, the make process generates +doc/loncapafiles/latestinstallconfiguration.html which +has the latest HTML presentation of the current LONCAPA tag configuration settings. Alternatively, +you can just view the internal tags of this HTML file. +

+
+

2. Software Package Information

+

+This section contains the actual LONCAPA tag information. These tags are probably not viewable with your +browser and can only be seen be examining the HTML source. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + +image maps for the LON-CAPA remote control + + + + + +welcoming page to the LON-CAPA system upon login + + + + + +renders the HTML (including image maps) for the LON-CAPA remote control + + + + + +icons used for the bookmark portion of the LON-CAPA user interface + + +a.gif +alert.black.gif +alert.red.gif +back.gif +ball.gray.gif +ball.red.gif +binary.gif +binhex.gif +blank.gif +bomb.gif +box1.gif +box2.gif +broken.gif +burst.gif +c.gif +comp.blue.gif +comp.gray.gif +compressed.gif +continued.gif +course.gif +dir.gif +down.gif +dvi.gif +f.gif +folder.gif +folder.open.gif +folder.sec.gif +folder_closed.gif +folder_closed_pressed.gif +folder_new.gif +folder_opened.gif +folder_opened_pressed.gif +folder_pointer_closed.gif +folder_pointer_opened.gif +folder_spacer.gif +folder_trash.gif +forward.gif +generic.gif +generic.red.gif +generic.sec.gif +hand.right.gif +hand.up.gif +html.gif +image1.gif +image2.gif +image3.gif +index.gif +layout.gif +left.gif +link.gif +mov.gif +movie1.gif +p.gif +patch.gif +pdf.gif +portal.gif +problem.gif +ps.gif +quill.gif +right.gif +screw1.gif +screw2.gif +script.gif +sound1.gif +sound2.gif +sphere1.gif +sphere2.gif +tar.gif +tex.gif +text.gif +transfer.gif +unknown.gif +up.gif +uu.gif +uuencoded.gif +white_space_20_22.gif +white_space_22_22.gif +world1.gif +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_new.gif +folder_opened.gif +folder_opened_pressed.gif +folder_pointer_closed.gif +folder_pointer_opened.gif +folder_spacer.gif +folder_trash.gif +left_bar.gif +link.gif +link_pressed.gif +ll_corner.gif +lower_bar.gif +lr_corner.gif +right_bar.gif +toolbar_bg.gif +ul_corner.gif +upper_bar.gif +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 + + + + + +javascript for handling client-side interactions with bookmark interface + + + + + +checks the system RPMs against what install.lon-capa.org specifies + + + + + +checks the important base LON-CAPA files against what install.lon-capa.org specifies + + + + + +restores .rpmsave files after a LON-CAPA-base upgrade + + + + + +does all the things to coordinate updating of LON-CAPA base files. Should be used with +caution so that you do not lose work + + + + + +makes verification report using loncapaverifypackages and loncapaverifybasepackage + + + + + +file that specifies periodic processes to run for the LON-CAPA machine + + + + + +file that stimulates running of ntpdate upon init.d/xntpd initiation + + +
Files & DirectoriesTypeFunctionInstall
directory DIRECTORY -- /etc/httpd/conf 
configurableaccess.confconfdefine handlers, set parametersconfigure + + + +define handlers, set parameters + + +configure
@@ -52,68 +204,59 @@ and, these files
lonHostIDLON-internal HostID of this machine
lonLoadLimLoad Limit ( 100% loadavg )
lonExpireExpiration for local copies in seconds
-
configurablehttpd.confstatic confmain server configuration file 
configurablesrm.confstatic confname space configuration 
configurablestartup.plstatic confset paths to modules; invoked by access.conf 
directory DIRECTORY -- /home/httpd/lonTabsLON-CAPA Tables
staticfiletypes.tabstatic confDescriptive list of file extensions, and extension groupings 
staticroles.tabstatic confList of privileges associated with users of multiple types (for example: Teaching Assistant, Exam Proctor, Course Coordinator) 
staticrolesplain.tabstatic confDescriptive list of abbreviations used in roles.tab for user types and privileges available - in the network with function 
statichosts.tabstatic confList of all machines in the LON-CAPA network. Relates lonHostID to lonDefDomain and IP address 
configurablespare.tabconfSpare hosts to - offload session to if the LON-CAPA machine is overloaded + + + + + +main server configuration file + + + + + +name space configuration + + + + + +set paths to modules; invoked by access.conf + + + + + +Descriptive list of file extensions, and extension groupings + + + + + +List of privileges associated with users of multiple types (for example: Teaching +Assistant, Exam Proctor, Course Coordinator) + + + + + +Descriptive list of abbreviations used in roles.tab for user types +and privileges available in the network with function + + + + + +List of all machines in the LON-CAPA network. Relates lonHostID to +lonDefDomain and IP address + + + + + +Spare hosts to offload session to if the LON-CAPA machine is overloaded + + configure
@@ -123,27 +266,20 @@ list elements are separated by newlines each list element consists of only one value; the value for lonHostID in access.conf
-
statichtpasswdstatic confBasic auth - password to access /lon-status and /server-status 
directory DIRECTORY -- /etc 
configurablekrb.confconfwhich Kerberos - server to contact for which Kerberos domainsconfigure
+ + + + + +Basic auth password to access /lon-status and /server-status + + + + + +which Kerberos server to contact for which Kerberos domains + +
list elements are separated by newlines @@ -157,281 +293,413 @@ each list element consists of only two s
-
directory DIRECTORY -- /home/httpd/perlCommunication
scriptloncscriptproxy server 
scriptlondscriptremote command - interpreter 
scriptloncronscripthousekeeping 
scriptlonsqlscriptmaintain secondary database of metadata 
empty directory EMPTY DIRECTORY -- /home/httpd/perl/logslogs and pids of lonc, lond and lonnet.pm
empty directory EMPTY DIRECTORY -- /home/httpd/perl/tmplogs and pids of lonc, lond and lonnet.pm
directory DIRECTORY -- /home/httpd/lib/perl/Apachehandlers
handler.giflonxml.pmhandlerXML Parsing Module 
handler.gifstyle.pmhandlerStyle Parsing Module 
handler.giflondefdef.pmhandlerTags Default Definition Module 
handler.gifrun.pmhandlerevaluates expression within a memory-safe environment (to protect system from break-in attempts) 
handler.gifscripttag.pmhandlerparse and evaluate contents of values within a <script> tag (this module invokes run.pm) 
handler.giflonhomework.pmhandlerhandles requests for output, evaluation, and alteration of homework resource 
handler.gifinputtags.pmhandlerproduces HTML input tags (<INPUT>) for rendering homework resources 
handler.gifstructuretags.pmhandlerproduces HTML tags necessary for structuring the presentation of homework resourcese 
handler.gifresponse.pmhandlerdefines different types of responses given to student as well as syntax for producing response values 
handler.gifcaparesponse.pmhandlerhandles request to the CAPA homework processing engine 
handler.giflonacc.pmhandleraccess to for a LON-CAPA user session 
handler.giflonracc.pmhandleraccess handler for file transfers 
handler.gifloncacc.pmhandleraccess to construction area 
handler.giflonauth.pmhandlerauthenticate, set up session environment 
handler.giflonlogin.pmhandlerlogin screen 
handler.giflonrep.pmhandlerreplication 
handler.giflonproblem.pmhandlerassessments 
handler.giflonroles.pmhandlerroles picking 
handler.giflonindexer.pmhandlercross server - filesystem browser 
handler.giflonnet.pmhandlerinterface - to lonc 
empty directory EMPTY DIRECTORY -- /home/httpd/lonIDscookie jar
empty directoryEMPTY DIRECTORY -- /home/httpd/socketslonc's sockets
empty directoryEMPTY DIRECTORY -- /home/httpd/sockets/delayedlonc's sockets
directory DIRECTORY -- /home/httpd/html  
interface fileindex.htmlinterface filebumps to login 
linkrawsymbolic linksymbolic link to /home/httpd/html/res 
emptydirectory EMPTY DIRECTORY -- /home/httpd/html/resroot of resource tree
directory DIRECTORY -- /home/httpd/html/admunauthenticated resources
interface filenotfound.htmlinterface filestatic html page that is shown when an attempt is made to access a document not present on the web server 
interface fileunauthorized.htmlinterface filestatic html page that is shown when an attempt is made to access a document which is restricted based on -file or server configurations 
directory DIRECTORY -- /home/httpd/html/adm/rathome of the rat
interface filerat.htmlinterface fileframeset 
interface filecode.htmlinterface filejavascript 
interface filemap.htmlinterface filebumper 
graphic file*.gifgraphic filesimages for - ratlisting
- + + + + + +configuration file to make LON-CAPA server file space accessible to network neighborhood + + +configure + + + + + +which NTP server to contact for information (XNTP3 standard) + + + + + +
+only one line needs to be changed to specify a server ip address +
+Example:
server ntp.msu.edu +
+
+
+ + + +proxy server + + + + + +remote command interpreter + + + + + +housekeeping + + + + + +maintain secondary database of metadata + + + + + +coordinates the system services and files in order to allow lond to change user passwords + + + + + +coordinates the system services and files in order to allow lond to add a new user + + + + + +coordinates the system services and files in order to allow lond to delete a user + + + + + +coordinates the system services and files in order to allow lond to enable NFS for a user + + + + + +coordinates the system services and files in order to allow lond to disable NFS for a user + + + + + +HTML frame that presents a form element to allow for the publishing of +resources, directories and underlying subdirectories. + + + + + +The relevant conditions and metadata to attach to LectureOnline-specific tags. + + + + + +File which contains words which should not be keywords used to specify resource +content. + + + + + +Table which contains list of copyright possibilities for educational resources. + + + + + +Table which contains string abbreviations of language::font rendering +combinations. + + + + + +Table which has hash data necessary for distinguishing IDs from indices. + + + + + +Routines for messaging. + + + + + +This handler coordinates the delivery of hints to students working on LON-CAPA +problems and assignments. + + + + + +Spreadsheet/Grades Display Handler + + + + + +Handler to resolve ambiguous file locations + + + + + +Page wrapper for handling construction space. + + + + + +Publishes an LON-CAPA educational resource complete with metadata +(authorship, language, copyright, creation date, etc). + + + + + +Has routines which control the remote control. + + + + + +Deals with forward, backward, and other page flips. + + + + + +Builds up frame set and loads in the right thing. + + + + + +This will take annotations and then plug them into a page + + + + + +This will take bookmarks and get/write/display them for the LON-CAPA user interface + + + + + +Handler tat takes output from RAT and stores it on disk. Handles the upper hidden +frame of the added window that comes up in RAT. (3 frames come up in RAT server, +code, and output. This module handles server connection.) + + + + + +bundles pages into one page + + + + + +compile course into binary data structure (in loncom/rat) + + + + + +Handler for tex files (somewhere in loncom/modules) + + + + + +Access to tth/ttm + + + + + +XML Parsing Module + + + + + +Style Parsing Module + + + + + +Tags Default Definition Module + + + + + +used to prevent poorly written problems from causing lingering after effects + + + + + +implements <script>, <scriptlib>, <parserlib>, and <import> + + + + + +handles requests for output, evaluation, and alteration of homework resource + + + + + +produces HTML input tags (<INPUT>) for rendering homework resources + + + + + +produces HTML tags necessary for structuring the presentation of homework resources + + + + + +defines different types of responses given to student as well as syntax for producing response values + + + + + +handles request to the CAPA homework processing engine + + + + + +access to for a LON-CAPA user session + + + + + +access handler for file transfers + + + + + +access to construction area + + + + + +authenticate, set up session environment + + + + + +login screen + + + + + +logout + + + + + +replication + + + + + +roles picking + + + + + +cross server filesystem browser + + + + + +interface to lonc + + + + + +bumps to login + + + + + +symbolic link to /etc/mime.types + + + + + +symbolic link to /home/httpd/html/res + + + + + +static html page that is shown when an attempt is made to access a document not present on the web server + + + + + +static html page that is shown when an attempt is made to access a document which is restricted based on +file or server configurations + + + + + +frameset + + + + + +Parameter input window. + + + + + +javascript + + + + + +bumper + + + + + +A blank page with very minimal HTML structural elements. + + + + + +graphic files + + 1.1.dt.gif 1.1.empty.gif 1.1.ld.gif @@ -537,71 +805,94 @@ start.gif std.gif stdl.gif sutd.gif -
-
directory DIRECTORY -- /home/httpd/html/adm/lonIcons 
graphic file*.gifgraphic fileslogos -listing
- + + + + + +"something bad happened" icon + + +lonlogo_broken.gif + + + + + +logos + + liteani.gif -logo.gif -logos.gif -
empty directory EMPTY DIRECTORY -- /home/httpd/lonUsershome dirs of local users
emptydirectory EMPTY DIRECTORY -- /home/httpd/html/lon-statusstatus reports
directory DIRECTORY -- /usr/lib/perl5/site_perl/5.005 
system filecapa.pmsystem fileperl module for invoking functions specific to CAPA 
system filecapa.bssystem filebootstrap file associated with dynamic loading of this module on multiple architectures 
system filecapa.sosystem fileshared library file for dynamic loading and unloading 
directory DIRECTORY -- /home/httpd/html/adm/MathML 
system file*.entstatic confentity files -listing
- +lonlogo.gif +lonlogos.gif + + + + + +perl module for invoking functions specific to Tex-to-HTML conversion + + +Has the same dependencies and build process as tth.so. +Currently, only the tth.so file specifications invoke +the build process however. + + + + + +shared library file for dynamic loading and unloading + + +loncom/modules/TexConvert/tthperl/commands + + +../tthdynamic/tthfunc.c +../ttmdynamic/ttmfunc.c + + + + + +perl module for invoking functions specific to CAPA + + +Has the same dependencies and build process as capa.so. +Currently, only the capa.so file specifications invoke +the build process however. + + + + + +bootstrap file associated with dynamic loading of this module on multiple architectures + + +Has the same dependencies and build process as capa.so. +Currently, only the capa.so file specifications invoke +the build process however. + + + + + +shared library file for dynamic loading and unloading + + +loncom/homework/caparesponse/commands + + +caparesponse.c +caparesponse.pm +[ALWAYS_RUN_BUILD_COMMAND] + + + + + +entity files + + isoamsa.ent isoamsb.ent isoamsc.ent @@ -624,49 +915,46 @@ isomscr.ent isonum.ent isopub.ent isotech.ent -mathml.dtd mmlalias.ent mmlextra.ent - -
system filemathml.cssstatic confcascading style sheet 
system filemathml.dtdstatic confdocument type definition 
directory DIRECTORY -- /home/httpd/html/res/adm/includes 
graphic filelondes.jsscriptEncryption Routines according to Data Encryption Standard DES, written in javascript 
directory DIRECTORY -- /home/httpd/html/res/adm/pages 
graphic file*.gifgraphic filesicons used for the entire LON-CAPA user interface -listing
- + + + + + +cascading style sheet + + + + + +document type definition + + + + + +Encryption Routines according to Data Encryption Standard DES, written in javascript + + + + + +used by lonxml::xmlparse() as input variable $safeinit to Apache::run::run() + + + + + +Define unit prefixing and conversion for CAPA problem handling. + + + + + +icons used for the entire LON-CAPA user interface + + a.gif b.gif c.gif @@ -713,29 +1001,240 @@ w.gif x.gif y.gif z.gif -
interface fileimgmaps.htmlinterface fileimage maps for the LON-CAPA remote control 
interface fileindex.htmlinterface filewelcoming page to the LON-CAPA system upon login 
interface filemenu.htmlinterface filerenders the HTML (including image maps) for the LON-CAPA remote control 
+
just one line with the ip address of the server
+ + + + + + + + + + + + +system init and control handling for the LON-CAPA network + + + + + +configuration file to make LON-CAPA server file space accessible to Appleshares access (Macintosh) + +