Annotation of doc/loncapafiles/buildfiles.lpml, revision 1.32
1.1 harris41 1: <!DOCTYPE lpml PUBLIC "-//TUX/DTD lpml 1.0 Final//EN"
2: "http://lpml.sourceforge.net/DTD/lpml.dtd">
3: <!-- buildfiles.lpml -->
4:
1.32 ! raeburn 5: <!-- $Id: buildfiles.lpml,v 1.31 2013/10/29 21:01:10 raeburn Exp $ -->
1.1 harris41 6:
7: <!--
8:
9: Copyright Michigan State University Board of Trustees
10:
11: This file is part of the LearningOnline Network with CAPA (LON-CAPA).
12:
13: LON-CAPA is free software; you can redistribute it and/or modify
14: it under the terms of the GNU General Public License as published by
15: the Free Software Foundation; either version 2 of the License, or
16: (at your option) any later version.
17:
18: LON-CAPA is distributed in the hope that it will be useful,
19: but WITHOUT ANY WARRANTY; without even the implied warranty of
20: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21: GNU General Public License for more details.
22:
23: You should have received a copy of the GNU General Public License
24: along with LON-CAPA; if not, write to the Free Software
25: Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
26:
27: /home/httpd/html/adm/gpl.txt
28:
29: http://www.lon-capa.org/
30:
31: -->
32:
33: <!-- Default values must be defined before specific values. -->
34: <!-- If no 'dist' attribute is specified, then it is always installed. -->
35: <!-- If 'dist' attribute is set to 'default', then the specification. -->
36: <!-- is accepted if an alternative distribution is not requested or not -->
37: <!-- defined. -->
38:
39: <lpml>
40: <specialnotices>
41: <specialnotice dist='default'>
42: </specialnotice>
43: </specialnotices>
44: <targetroot>/build</targetroot>
45: <sourceroot>/home/user/loncapa/</sourceroot>
46: <categories>
47: <category name="system file" type="runtime">
48: <chmod dist='default'>0644</chmod><chown dist='default'>root:root</chown>
49: <abbreviation>systemfile</abbreviation>
50: </category>
51: <category name="system file" type="development">
52: <chmod dist='default'>0644</chmod><chown dist='default'>root:root</chown>
53: <abbreviation>systemfile</abbreviation>
54: </category>
55: <category name="standard" type="runtime">
56: <chmod dist='default'>0755</chmod><chown dist='default'>root:root</chown>
57: <abbreviation>directory</abbreviation>
58: </category>
59: <category name="standard" type="development">
60: <chmod dist='default'>0755</chmod><chown dist='default'>root:root</chown>
61: <abbreviation>directory</abbreviation>
62: </category>
63: </categories>
64: <directories>
65: </directories>
66: <files>
67: <file>
68: <source>loncom/build/Makefile</source>
69: <target dist='default'>Makefile</target>
70: <categoryname>system file</categoryname>
71: <description>
72: Makefile for LON-CAPA
73: </description>
74: <note>
75: </note>
1.5 albertel 76: <dependencies>
77: doc/loncapafiles/configurable.gif;
78: doc/loncapafiles/directory.gif;
79: doc/loncapafiles/emptydirectory.gif;
80: doc/loncapafiles/graphicfile.gif;
81: doc/loncapafiles/handler.gif;
82: doc/loncapafiles/interfacefile.gif;
83: doc/loncapafiles/link.gif;
84: doc/loncapafiles/rootscript.gif;
85: doc/loncapafiles/script.gif;
86: doc/loncapafiles/setuid.gif;
87: doc/loncapafiles/static.gif;
88: doc/loncapafiles/systemfile.gif
89: </dependencies>
1.1 harris41 90: </file>
91: <file>
92: <source>doc/loncapafiles/loncapafiles.lpml</source>
93: <target dist='default'>loncapafiles.lpml</target>
94: <categoryname>system file</categoryname>
95: <description>
96: Describes the files that implement LON-CAPA on the filesystem
97: </description>
98: <note>
99: </note>
100: </file>
101: <file>
102: <source>doc/loncapafiles/buildfiles.lpml</source>
103: <target dist='default'>buildfiles.lpml</target>
104: <categoryname>system file</categoryname>
105: <description>
106: Describes the files that implement the building of LON-CAPA inside the source
107: file tree.
1.6 harris41 108: </description>
109: <note>
110: </note>
111: </file>
112: <file>
113: <source>doc/loncapafiles/installfiles.lpml</source>
114: <target dist='default'>installfiles.lpml</target>
115: <categoryname>system file</categoryname>
116: <description>
117: Describes the files that help automate LON-CAPA installations on specific
118: operating systems.
1.1 harris41 119: </description>
120: <note>
121: </note>
122: </file>
123: <file>
1.14 albertel 124: <source>doc/loncapafiles/modify_config_files.piml</source>
125: <target dist='default'>modify_config_files.piml</target>
126: <categoryname>system file</categoryname>
127: <description>
128: Post-installation of MySQL and yum config files
129: </description>
130: <note>
131: </note>
132: </file>
133: <file>
1.1 harris41 134: <source>doc/loncapafiles/webserver.piml</source>
135: <target dist='default'>webserver.piml</target>
136: <categoryname>system file</categoryname>
137: <description>
138: Post-installation of web server configuration files
1.3 albertel 139: </description>
140: <note>
141: </note>
142: </file>
143: <file>
144: <source>doc/loncapafiles/reseval_fixup.piml</source>
145: <target dist='default'>reseval_fixup.piml</target>
146: <categoryname>system file</categoryname>
147: <description>
148: Migrates reseval.db to nohist_eseval.db, deletes useless hist file
1.8 matthew 149: </description>
150: <note>
151: </note>
152: </file>
153: <file>
1.15 albertel 154: <source>doc/loncapafiles/clean_file_permissions.piml</source>
155: <target dist='default'>clean_file_permissions.piml</target>
156: <categoryname>system file</categoryname>
157: <description>
158: Executes clean_db.pl on each file_permisions.db file to remove erroneuos keys.
159: </description>
160: <note>
161: </note>
162: </file>
163: <file>
1.17 albertel 164: <source>doc/loncapafiles/chkconfig.piml</source>
165: <target dist='default'>chkconfig.piml</target>
166: <categoryname>system file</categoryname>
167: <description>
1.24 raeburn 168: Checks that the webserver and loncontrol are properly set to run at startup
169: </description>
170: <note>
171: </note>
172: </file>
173: <file>
1.17 albertel 174: <source>doc/loncapafiles/html_parser_check.piml</source>
175: <target dist='default'>html_parser_check.piml</target>
176: <categoryname>system file</categoryname>
177: <description>
178: Checks that the HTML::parser installation has the needed patches.
179: </description>
180: <note>
181: </note>
182: </file>
183: <file>
1.20 albertel 184: <source>doc/loncapafiles/math_random_check.piml</source>
185: <target dist='default'>math_random_check.piml</target>
186: <categoryname>system file</categoryname>
187: <description>
188: Checks that the Math::Random installation has the correct phrase to
189: seed generator.
190: </description>
191: <note>
192: </note>
193: </file>
194: <file>
1.17 albertel 195: <source>doc/loncapafiles/logcleanup.piml</source>
196: <target dist='default'>logcleanup.piml</target>
197: <categoryname>system file</categoryname>
198: <description>
199: Cleans the .perm logs, removing useless spam messages
200: </description>
201: <note>
202: </note>
203: </file>
204: <file>
1.8 matthew 205: <source>doc/loncapafiles/accesscount_seed.piml</source>
206: <target dist='default'>accesscount_seed.piml</target>
207: <categoryname>system file</categoryname>
208: <description>
209: Executes seed_accesscount.pl on each nohist_resevaldata.db file to move access
210: count data to nohist_accesscount.db and compact the nohist_resevaldata.db
211: file.
1.1 harris41 212: </description>
213: <note>
214: </note>
215: </file>
216: <file>
1.4 albertel 217: <source>doc/loncapafiles/clearoutoldspreadsheetcache.piml</source>
218: <target dist='default'>clearoutoldspreadsheetcache.piml</target>
219: <categoryname>system file</categoryname>
220: <description>
221: Deletes all of the old spreadsheet cache files, the ones generated prior
222: to version 0.6 were incorrect
223: </description>
224: <note>
225: </note>
226: </file>
227: <file>
1.1 harris41 228: <source>doc/loncapafiles/sanitycheck.piml</source>
229: <target dist='default'>sanitycheck.piml</target>
1.2 harris41 230: <categoryname>system file</categoryname>
231: <description>
232: Checks LON-CAPA system for frequently occuring bugs.
1.10 matthew 233: </description>
234: <note>
235: </note>
236: </file>
237: <file>
1.12 albertel 238: <source>doc/loncapafiles/cron_lpmlcheck.piml</source>
239: <target dist='default'>cron_lpmlcheck.piml</target>
240: <categoryname>system file</categoryname>
241: <description>
242: Checks that there is no lpmlsave file in the cron.d dir
243: </description>
244: </file>
245: <file>
1.10 matthew 246: <source>doc/loncapafiles/ntpcheck.piml</source>
247: <target dist='default'>ntpcheck.piml</target>
248: <categoryname>system file</categoryname>
249: <description>
250: Checks server to determine status of ntpd.
1.11 matthew 251: </description>
252: <note>
253: </note>
254: </file>
255: <file>
256: <source>doc/loncapafiles/rpmcheck.piml</source>
257: <target dist='default'>rpmcheck.piml</target>
258: <categoryname>system file</categoryname>
259: <description>
260: Checks server for rpms known to conflict with LON-CAPA.
1.2 harris41 261: </description>
262: <note>
263: </note>
264: </file>
265: <file>
266: <source>doc/loncapafiles/updatequery.piml</source>
267: <target dist='default'>updatequery.piml</target>
1.1 harris41 268: <categoryname>system file</categoryname>
269: <description>
270: Checks LON-CAPA system for frequently occuring bugs.
1.4 albertel 271: </description>
272: <note>
273: </note>
274: </file>
275: <file>
276: <source>doc/loncapafiles/sendmail_fix.piml</source>
277: <target dist='default'>sendmail_fix.piml</target>
278: <categoryname>system file</categoryname>
279: <description>
280: Checks LON-CAPA system for sendmail permissions error.
1.9 www 281: </description>
282: <note>
283: </note>
284: </file>
285: <file>
286: <source>doc/loncapafiles/ownership_fix.piml</source>
287: <target dist='default'>ownership_fix.piml</target>
288: <categoryname>system file</categoryname>
289: <description>
290: Makes sure that /home/httpd/lonUsers and /home/httpd/html are owned by www.
1.1 harris41 291: </description>
292: <note>
293: </note>
294: </file>
295: <file>
1.13 albertel 296: <source>doc/loncapafiles/run_searchcat.piml</source>
297: <target dist='default'>run_searchcat.piml</target>
298: <categoryname>system file</categoryname>
299: <description>
300: Makes sure that /home/httpd/lonUsers and /home/httpd/html are owned by www.
301: </description>
302: <note>
303: </note>
304: </file>
305: <file>
1.18 albertel 306: <source>doc/loncapafiles/update_queue_slots.piml</source>
307: <target dist='default'>update_queue_slots.piml</target>
308: <categoryname>system file</categoryname>
309: <description>
310: Update the slots definitons from havin @ to having :
311: </description>
312: <note>
313: </note>
314: </file>
315: <file>
1.16 albertel 316: <source>doc/loncapafiles/wrap_setuid.piml</source>
317: <target dist='default'>wrap_setuid.piml</target>
318: <categoryname>system file</categoryname>
319: <description>
320: Wraps the setuid perl scripts into a binary excutable wrapper.
321: </description>
322: <note>
323: </note>
324: </file>
325: <file>
1.21 raeburn 326: <source>doc/loncapafiles/latex_fixup.piml</source>
327: <target dist='default'>latex_fixup.piml</target>
328: <categoryname>system file</categoryname>
329: <description>
330: Runs /usr/bin/mktexlsr so LaTeX sees files added to texmf/tex/latex/base
331: </description>
332: <note>
333: </note>
334: </file>
335: <file>
1.22 raeburn 336: <source>doc/loncapafiles/picins_check.piml</source>
337: <target dist='default'>picins_check.piml</target>
338: <categoryname>system file</categoryname>
339: <description>
340: If picins.sty is absent, retrieves from CTAN and runs texinfo rehash
341: and fmtutil-sys --missing.
342: </description>
343: <note>
344: </note>
345: </file>
346: <file>
1.32 ! raeburn 347: <source>doc/loncapafiles/langcheck.piml</source>
! 348: <target dist='default'>langcheck.piml</target>
! 349: <categoryname>system file</categoryname>
! 350: <description>
! 351: Check language used for root bash and OS, and warn if language other
! 352: than English is in use.
! 353: </description>
! 354: <note>
! 355: </note>
! 356: </file>
! 357: <file>
1.23 raeburn 358: <source>doc/loncapafiles/mimetex_version_check.piml</source>
359: <target dist='default'>mimetex_version_check.piml</target>
360: <categoryname>system file</categoryname>
361: <description>
362: If mimeTeX cgi has been updated will update version number in
363: /home/httpd/lonTabs/mimetex-version and remove any .gif files from
364: /home/httpd/cgi-bin/mimtexcache/
365: </description>
366: <note>
367: </note>
368: </file>
369: <file>
1.26 raeburn 370: <source>doc/loncapafiles/verify_domconfiguser.piml</source>
371: <target dist='default'>verify_domconfiguser.piml</target>
372: <categoryname>system file</categoryname>
373: <description>
374: Determine if current machine is the primary library server for any domains.
375: If it is create the $dom-domainconfig user for any of these domains if it is absent, create /home/httpd/lonUsers/$dom/1/2/3/$dom-domainconfig directory, assign author role if required, and create /home/$dom-domconfig/public_html directory, if required.
376: </description>
377: <note>
378: </note>
379: </file>
380: <file>
1.27 raeburn 381: <source>doc/loncapafiles/latex_fmtutil.piml</source>
382: <target dist='default'>latex_fmtutil.piml</target>
383: <categoryname>system file</categoryname>
384: <description>
385: Runs "/usr/bin/fmtutil-sys --missing" to create any missing TeX format files.
386: </description>
387: <note>
388: </note>
389: </file>
390: <file>
1.30 raeburn 391: <source>doc/loncapafiles/removenolongerused.piml</source>
392: <target dist='default'>removenolongerused.piml</target>
393: <categoryname>system file</categoryname>
394: <description>
395: Check for files and/or directories installed by earlier versions of LON-CAPA which are no longer used by the version being installed. Prompt the user to confirm deletion for each file and each directory, before deleting them.
396: </description>
397: <note>
398: </note>
399: </file>
400: <file>
1.31 raeburn 401: <source>doc/loncapafiles/lcmathcomplex.piml</source>
402: <target dist='default'>lcmathcomplex.piml</target>
403: <categoryname>system file</categoryname>
404: <description>
405: Use perl core module Config.pm to determine nvsize and set value for this scalar in /home/httpd/lib/perl/LONCAPA/LCMathComplex.pm. LCMathComplex.pm is used instead of the core perl module Math::Complex in Safe Space, because the dependency on Config.pm is eliminated.
406: </description>
407: <note>
408: </note>
409: </file>
410: <file>
1.1 harris41 411: <source>doc/loncapafiles/valid_hosts.xfml</source>
412: <target dist='default'>valid_hosts.xfml</target>
413: <categoryname>system file</categoryname>
414: <description>
415: Useful for extracting (and pushing/pulling) information relevant
416: to hosts.tab.
417: </description>
418: <note>
419: </note>
420: </file>
421: <file>
422: <source>loncom/build/check-rpms</source>
423: <target dist='default'>check-rpms</target>
424: <categoryname>system file</categoryname>
425: <description>
426: script for checking RPMS against an RPM repository
427: </description>
428: <note>
429: </note>
430: </file>
431: <file>
432: <source>loncom/build/distprobe</source>
433: <target dist='default'>distprobe</target>
434: <categoryname>system file</categoryname>
435: <description>
436: for probing operating system flavor and version
437: </description>
438: <note>
439: </note>
440: </file>
441: <file>
442: <source>loncom/build/doc_template.pl</source>
443: <target dist='default'>doc_template.pl</target>
444: <categoryname>system file</categoryname>
445: <description>
446: for making fancy install.lon-capa.org pages
447: </description>
448: <note>
449: </note>
450: </file>
451: <file>
452: <source>loncom/build/filecompare.pl</source>
453: <target dist='default'>filecompare.pl</target>
454: <categoryname>system file</categoryname>
455: <description>
456: rigorously compare many different values associated between files
457: </description>
458: <note>
459: </note>
460: </file>
461: <file>
1.29 raeburn 462: <source>loncom/build/getcvsdate.pl</source>
463: <target dist='default'>getcvsdate.pl</target>
464: <categoryname>system file</categoryname>
465: <description>
466: script to get CVS commit date/time for a file from file's entry in
467: CVS/Entries for directory containing the file
468: </description>
469: <note>
470: </note>
471: </file>
472:
473: <file>
1.1 harris41 474: <source>loncom/build/loncaparestoreconfigurations</source>
475: <target dist='default'>loncaparestoreconfigurations</target>
476: <categoryname>system file</categoryname>
477: <description>
478: intelligently restore configuration values
479: </description>
480: <note>
481: </note>
482: </file>
483: <file>
484: <source>loncom/build/lpml.dtd</source>
485: <target dist='default'>lpml.dtd</target>
486: <categoryname>system file</categoryname>
487: <description>
488: DocumentType for LPML
489: </description>
490: <note>
491: </note>
492: </file>
493: <file>
494: <source>loncom/build/lpml_html_posteval.pl</source>
495: <target dist='default'>lpml_html_posteval.pl</target>
496: <categoryname>system file</categoryname>
497: <description>
498: </description>
499: <note>
500: </note>
501: </file>
502: <file>
503: <source>loncom/build/lpml_parse.pl</source>
504: <target dist='default'>lpml_parse.pl</target>
505: <categoryname>system file</categoryname>
506: <description>
507: parse apart the loncapafiles.lpml and buildfiles.lpml
508: </description>
509: <note>
510: </note>
511: </file>
512: <file>
513: <source>loncom/build/make_domain_coordinator.pl</source>
514: <target dist='default'>make_domain_coordinator.pl</target>
515: <categoryname>system file</categoryname>
516: <description>
517: make a domain coordinator on a new LON-CAPA system
518: </description>
519: <note>
520: </note>
521: </file>
522: <file>
1.19 albertel 523: <source>loncom/build/add_domain_coordinator_privilege.pl</source>
524: <target dist='default'>add_domain_coordinator_privilege.pl</target>
525: <categoryname>system file</categoryname>
526: <description>
527: add domain coordinator privilege to and exisiting local LON-CAPA user
528: </description>
529: <note>
530: </note>
531: </file>
532: <file>
1.28 raeburn 533: <source>loncom/build/expire_DC_role.pl</source>
534: <target dist='default'>expire_DC_role.pl</target>
535: <categoryname>system file</categoryname>
536: <description>
537: expire domain coordinator role for exisiting local LON-CAPA user
538: </description>
539: <note>
540: </note>
541: </file>
542: <file>
1.1 harris41 543: <source>loncom/build/piml.dtd</source>
544: <target dist='default'>piml.dtd</target>
545: <categoryname>system file</categoryname>
546: <description>
547: DocumentType definition for PIML (part of the LPML system)
548: </description>
549: <note>
550: </note>
551: </file>
552: <file>
553: <source>loncom/build/piml_parse.pl</source>
554: <target dist='default'>piml_parse.pl</target>
555: <categoryname>system file</categoryname>
556: <description>
557: parse a PIML file
558: </description>
559: <note>
560: </note>
561: </file>
562: <file>
563: <source>loncom/build/pod2html.sh</source>
564: <target dist='default'>pod2html.sh</target>
565: <categoryname>system file</categoryname>
566: <description>
567: make HTML documentation pages
568: </description>
569: <note>
570: </note>
571: </file>
572: <file>
573: <source>loncom/build/pod2man.sh</source>
574: <target dist='default'>pod2man.sh</target>
575: <categoryname>system file</categoryname>
576: <description>
577: make UNIX-style manual pages
578: </description>
579: <note>
580: </note>
581: </file>
582: <file>
583: <source>loncom/build/verify.pl</source>
584: <target dist='default'>verify.pl</target>
585: <categoryname>system file</categoryname>
586: <description>
587: wraps around filecompare.pl for posteval LPML statements
588: </description>
589: <note>
590: </note>
591: </file>
592: <file>
593: <source>loncom/build/verifymodown.pl</source>
594: <target dist='default'>verifymodown.pl</target>
595: <categoryname>system file</categoryname>
596: <description>
597: double-checks modification and ownership on files
598: </description>
599: <note>
600: </note>
601: </file>
602: <file>
603: <source>loncom/build/xfml.dtd</source>
604: <target dist='default'>xfml.dtd</target>
605: <categoryname>system file</categoryname>
606: <description>
607: DocumentType definition for XFML (part of the LPML system)
608: </description>
609: <note>
610: </note>
611: </file>
612: <file>
613: <source>loncom/build/xfml_parse.pl</source>
614: <target dist='default'>xfml_parse.pl</target>
615: <categoryname>system file</categoryname>
616: <description>
617: parses XFML files
618: </description>
619: <note>
620: </note>
621: </file>
622: </files>
623: </lpml>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>