checkin_notes_2002 78.1 KB
Newer Older
David Anderson's avatar
David Anderson committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467 1468 1469 1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1484 1485 1486 1487 1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 1504 1505 1506 1507 1508 1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769 1770 1771 1772 1773 1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785 1786 1787 1788 1789 1790 1791 1792 1793 1794 1795 1796 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 1808 1809 1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838 1839 1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896 1897 1898 1899 1900 1901 1902 1903 1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919 1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966 1967 1968 1969 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 2035 2036 2037 2038 2039 2040 2041 2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 2065 2066 2067 2068 2069 2070 2071 2072 2073 2074 2075 2076 2077 2078 2079 2080 2081 2082 2083 2084 2085 2086 2087 2088 2089 2090 2091 2092 2093 2094 2095 2096 2097 2098 2099 2100 2101 2102 2103 2104 2105 2106 2107 2108 2109 2110 2111 2112 2113 2114 2115 2116 2117 2118 2119 2120 2121 2122 2123 2124 2125 2126 2127 2128 2129 2130 2131 2132 2133 2134 2135 2136 2137 2138 2139 2140 2141 2142 2143 2144 2145 2146 2147 2148 2149 2150 2151 2152 2153 2154 2155 2156 2157 2158 2159 2160 2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 2176 2177 2178 2179 2180 2181 2182 2183 2184 2185 2186 2187 2188 2189 2190 2191 2192 2193 2194 2195 2196 2197 2198 2199 2200 2201 2202 2203 2204 2205 2206 2207 2208 2209 2210 2211 2212 2213 2214 2215 2216 2217 2218 2219 2220 2221 2222 2223 2224 2225 2226 2227 2228 2229 2230 2231 2232 2233 2234 2235 2236 2237 2238 2239 2240 2241 2242 2243 2244 2245 2246 2247 2248 2249 2250 2251 2252 2253 2254 2255 2256 2257 2258 2259 2260 2261 2262 2263 2264 2265 2266 2267 2268 2269 2270 2271 2272 2273 2274 2275 2276 2277 2278 2279 2280 2281 2282 2283 2284 2285 2286 2287 2288 2289 2290 2291 2292 2293 2294 2295 2296 2297 2298 2299 2300 2301 2302 2303 2304 2305 2306 2307 2308 2309 2310 2311 2312 2313 2314 2315 2316 2317 2318 2319 2320 2321 2322 2323 2324 2325 2326 2327 2328 2329 2330 2331 2332 2333 2334 2335 2336 2337 2338 2339 2340 2341 2342 2343 2344 2345 2346 2347 2348 2349 2350 2351 2352 2353 2354 2355 2356 2357 2358 2359 2360 2361 2362 2363 2364 2365 2366 2367 2368 2369 2370 2371 2372 2373 2374 2375 2376 2377 2378 2379 2380 2381 2382 2383 2384 2385 2386 2387 2388 2389 2390 2391 2392 2393 2394 2395 2396 2397 2398 2399 2400 2401 2402 2403 2404 2405 2406 2407 2408 2409 2410 2411 2412 2413 2414 2415 2416 2417 2418 2419 2420 2421 2422 2423 2424 2425 2426 2427 2428 2429 2430 2431 2432 2433 2434 2435 2436 2437 2438 2439 2440 2441 2442 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2461 2462 2463 2464 2465 2466 2467 2468 2469 2470 2471 2472 2473 2474 2475 2476 2477 2478 2479 2480 2481 2482 2483 2484 2485 2486 2487 2488 2489 2490 2491 2492 2493 2494 2495 2496 2497 2498 2499 2500 2501 2502 2503 2504 2505 2506 2507 2508 2509 2510 2511 2512 2513 2514 2515 2516 2517 2518 2519 2520 2521 2522 2523 2524 2525 2526 2527 2528 2529 2530 2531 2532 2533 2534 2535 2536 2537 2538 2539 2540 2541 2542 2543 2544 2545 2546 2547 2548 2549 2550 2551 2552 2553 2554 2555 2556 2557 2558 2559 2560 2561 2562 2563 2564 2565 2566 2567 2568 2569 2570 2571 2572 2573 2574 2575 2576 2577 2578 2579 2580 2581 2582 2583 2584 2585 2586 2587 2588 2589 2590 2591 2592 2593 2594 2595 2596 2597 2598 2599 2600 2601 2602 2603 2604 2605 2606 2607 2608 2609 2610 2611 2612 2613 2614 2615 2616 2617 2618 2619 2620 2621 2622 2623 2624 2625 2626 2627 2628 2629 2630 2631 2632 2633 2634 2635 2636 2637 2638 2639 2640 2641 2642 2643 2644 2645 2646 2647 2648 2649 2650 2651 2652 2653 2654 2655 2656 2657 2658 2659 2660 2661 2662 2663 2664 2665 2666 2667 2668 2669 2670 2671 2672 2673 2674 2675 2676 2677 2678 2679 2680 2681 2682 2683 2684 2685 2686 2687 2688 2689 2690 2691 2692 2693 2694 2695 2696 2697 2698 2699 2700 2701 2702 2703 2704 2705 2706 2707 2708 2709 2710 2711 2712 2713 2714 2715 2716 2717 2718 2719 2720 2721 2722 2723 2724 2725 2726 2727 2728 2729 2730 2731 2732 2733 2734 2735 2736 2737 2738 2739 2740 2741 2742 2743 2744 2745 2746 2747 2748 2749 2750 2751 2752 2753 2754 2755 2756 2757 2758 2759 2760 2761 2762 2763 2764 2765 2766 2767 2768 2769 2770 2771 2772 2773 2774 2775 2776 2777 2778 2779 2780 2781 2782 2783 2784 2785 2786 2787 2788 2789 2790 2791 2792 2793 2794 2795 2796 2797 2798 2799 2800 2801 2802 2803 2804 2805 2806 2807 2808 2809 2810 2811 2812
David A.        April 10 2002
    Initial checkin of all files.
    The system is fairly feature-complete and
    runs a number of test cases correctly.
    Currently runs only on Linux.

David A.        April 11 2002
    - Got things to compile on Solaris.
    - Pass in platform name, version number from Makefile
        (platform name comes from configure)

David A.        May 15 2002
    - Allow applications to have multiple files
        (e.g. scripts, libraries, pre- and post-processing programs).
        The app_version table now has an xml_doc field,
        which contains a list of <file_info> and <file_ref> elements.
        Note: the utility for adding applications (tools/add.C)
        still handles only single-file applications.
    - Changed IO_FILE_DESC to FILE_REF since it now represents
        an association of a file to workunit, result or application

    client
        app.C
        client_state.C,h
        cs_apps.C
        cs_scheduler.C
        main.C
        message.h (new)
        parse.C,h
        scheduler_reply.C,h
        types.C,h
        Makefile.in
    db
        db.h
        db_mysql.C
        schema.sql
    doc
        app.html (new)
        files.html
        index.html
        intro.html
        project.gif
        project.html
        project.png
        protocol.html
        result.html (new)
        work.html
    html_user
        db.inc
    sched
        handle_request.C
        server_types.C,h
    test
        test_uc.php
        init.inc
    tools
        add.C

David A.        May 23 2002
    - Change the scheduling server to reduce database accesses.
        There's now a shared-memory segment that contains
        1) the platform, app, and app_version tables in their entirety;
        2) a fixed-size set of results ready to be sent,
            and their corresponding workunit.
        This segment is initialized and maintained by a new program
        called the "feeder" (sched/feeder.C) that should run
        whenever the scheduling server is up.
        Note: the scheduler still needs to be converted to fast CGI
    - Added handy interfaces for dealing with shared memory and semaphores.
    - Changed to utilities and scripts used for testing so that all
        server-specific names (paths and URLs) come from environment
        variables instead of being hardwired in the code.
        You'll want to add these to your .tcshrc or whatever.
        See the doc/install.html for details.

    Files:
    TODO
    apps/
        Makefile.in
    client/
        app.C
    db/
        db.h
    doc/
        index.html
        install.html
        intro.html
        tools.html (removed)
        tools_other.html
        tools_work.html
        work.html
    lib/
        Makefile.in
        md5_file.C
        shmem.C,h (new)
        shmem_test.C (new)
        synch.C,h (new)
        synch_test.C (new)
    sched/
        feeder.C (new)
        Makefile.in
        handle_request.C,h
        main.C
        sched_shmem.C,h (new)
        server_types.C,h
    test/
        account.xml (deleted)
        account1.xml
        init.inc
        test_uc.php
    tools/
        add.C
        create_work.C

Hiram C.        Fri May 24 23:34:59 PDT 2002
        files db/dependencies and client/config.status and client/config.log
                removed.  These are build time files and should not belong
                in the source tree.  They confuse subsequent builds.
        files updated: configure configure.in api/Makefile.in
                apps/Makefile.in client/Makefile.in db/Makefile.in
                db/mysql.h lib/Makefile.in sched/Makefile.in
                tools/Makefile.in

        These Makefile.in changes will allow the build to be performed
        outside the source tree.  This is convenient for several
        reasons.  The number one reason is that this allows the source
        tree to remain untouched by the build and therefore clean.
        This will prevent garbage build files from being checked in
        during a 'cvs commit'

        To run a build outside the source tree, simply make an object
        directory anywhere else that you would like to work, then just
        execute the configure script in the top-level boinc directory.
                $ mkdir boincobj
                $ cd boincobj
                $ <... path to source tree ...>/boinc/configure
                $ make > make.out 2>&1 &

        Note the examples in apps/Makefile.in and sched/Makefile.in
        of how to use the top_srcdir variable to locate include files
        in the source tree outside of the current directory.  Local
        references to other object files and libraries produced by
        the build remain as local .. references.

        The change to configure.in, (and thus configure) and db/mysql.h
        allow a proper identification of where the mysql .h files live.
        The SSL location of /usr/local/mysql/include is a bit non-standard.
        Most systems will have these in /usr/local/include/mysql

Hiram C.                Sat May 25 09:20:25 PDT 2002
        Continue updating:
        Makefile.in config.guess configure configure.in api/Makefile.in
        apps/Makefile.in client/Makefile.in client/config.guess
        client/configure client/configure.in sched/Makefile.in
        tools/Makefile.in

        I have almost clean builds now on Solaris, Mac OS X,
        and UnixWare.  There appears to be a missing sched_shmem.h
        file from the source tree.

        There is still cruft in this configure system.  I will continue
        to work on it to clean it up.

David A.        May 29, 2002
    - Mostly implemented support for editing preferences,
        including project-specific preferences.
        Simplified the preferences scheme.
        Abandoned the idea of multiple preference sets per user;
        each user now has a single set of preferences.
        Got rid of the "prefs" database table;
        prefs are now just an XML and mod_time field in the user table.
        Haven't tested much yet.

    NOTE: these new features use the XML parsing features of PHP.
    This means that, on the BOINC web server,
    you must configure PHP with the --with-xml option,
    and you must make and install Apache.
    Also, you probably need to use a recent version of PHP;
    XML parsing was broken in PHP 4.0.4, but it works in 4.2.1.

    client/
        Makefile.in
        speed_stats.C  (fixed code formatting a bit; doesn't compile on linux)
    db/
        Makefile.in
        db.h
        db_mysql.C
        schema.sql
    doc/
        prefs.html
    html_user/
        db.inc
        prefs.inc
        prefs.php
        prefs_action.php (removed)
        prefs_add_project_action.php (new)
        prefs_add_project_form.php (new)
        prefs_delete_project.php (new)
        prefs_delete_project_confirm.php (new)
        prefs_edit.php (removed)
        prefs_edit_disk_action.php (new)
        prefs_edit_disk_form.php (new)
        prefs_edit_project_action.php (new)
        prefs_edit_project_form.php (new)
        prefs_edit_projects.php (new)
        prefs_edit_work_action.php (new)
        prefs_edit_work_form.php (new)
        test.php (removed)
    sched/
        handle_request.C
        server_types.C,h
    test/
        init.inc
        test_1sec.php
        test_concat.php
        test_dynamic.php
        test_prefs.php
        test_projects.php
        test_stderr.php
        test_uc.php
        test_uc_slow.php
    tools/
        add.C

David A.        May 29, 2002
    - forgot to add a couple of files
    sched/
        feeder.C
        sched_shmem.C,h

Hiram C.  Thu May 30 01:28:47 PDT 2002
        updating: client/configure client/configure.in
        client/net_xfer.C sched/Makefile.in sched/feeder.C

        This now builds just fine on Solaris, Linux and OpenUnix8.
        And only two tiny errors remain for a Mac OS X build.
        That being the specification of g++ in the sched/Makefile
        and statvfs() is not available on the Mac for
        the client/hostinfo_unix.C compile.  Need a substitute for
        that function on the Mac.

Eric H.  May 30, 2002
     Added safeguard to avoid removing root directory when
     BOINC_DOWNLOAD_DIR and BOINC_UPLOAD_ DIR environment
     variables aren't declared.
     test/
        init.inc

David A.    June 1, 2002
    - Ensure that preferences propagate from the server
        where they are updated to all hosts,
        Eliminated concept of "home project".
        Not tested yet.
        Also to do: replace the "accounts.xml" file with
        a file containing preferences.
    - Changed the way the client handles preferences.
        It now saves saves the exact XML it gets from the server,
        regardless of whether it can parse it all.
    - Fixed client parsing code to reflect new names for preferences
    - Changed the way the scheduling server handles prefs in
        a client/server interaction.
        If it gets newer prefs, it updates its own DB.
        If its DB has newer prefs, it sends them to client.
    - Fixed the test scripts so that they start/stop the feeder also.
        This required adding a "ready" flag to the shared-mem structure
        so that the scheduling server can find out if the feeder hasn't
        finished initializing the structure.
        Also required adding a "-synch" cmdline option to feeder.
    - added utility program (sched/show_shmem.C) for looking at
        scheduler shared memory
    - renamed "types.*" to "client_types.*" to avoid name conflict
        with system include files

    /Makefile (removed - this is derived from Makefile.in)
    client/
        Makefile.in
        accounts.C,h
        app.C
        client_state.C,h
        client_types.C,h (new)
        cs_files.C
        cs_scheduler.C
        file_names.h
        file_xfer.h
        hostinfo_unix.C
        net_xfer.C
        prefs.C,h
        scheduler_reply.C,h
        speed_stats.C
        types.C,h (removed)
    db/
        constraints.sql
    doc/
        protocol.html
    html_user
        prefs.inc
    sched/
        feeder.C
        handle_request.C
        main.C
        sched_shmem.h
        server_types.C,h
        show_shmem.C (new)
        ss_reply_file (removed)
        ss_req_file (removed)
    test/
        account1.xml
        init.inc
        sched_reply.xml (removed)
        sched_request.xml (removed)
        test_uc.php
    tools/
        add.C

Eric Heien    June 03, 2002
    - Consolidated XML parsing functions into lib
    - Fixed compile bug on Solaris in shmem.C

    client/
        parse.C (moved to lib)
        parse.h (moved to lib)
        Makefile.in
    lib/
        parse.C (moved from client)
        parse.h (moved from client)
        shmem.C
    sched/
        parse.C (removed, uses lib version now)
        parse.h (removed, uses lib version now)
        Makefile.in

Michael Gary        June 04, 2002
    - Added server side water level functionality, now sends as many work units
        as necessary to fill the time requested.

    sched/
        handle_request.C

Eric Heien   June 06, 2002
    - Changes and additions made to begin porting to Windows.
    - This code will compile on Windows, but is not quite fully functional.

    client/
        hostinfo_unix.C
        hostinfo_win.C (added)
        http.C
        main.C
        net_xfer.C
        prefs.C
        speed_stats.C
        test_file_xfer.C
        test_http.C
        test_net_xfer.C
        util.C
        util.h
        windows_cpp.h (added)
        win_main.C (added)
    lib/
        md5.c
        parse.C

Michael Gary        June 06, 2002
    - Added client side water level functionality.
    - Added rsc_fpops and rsc_iops to the client WORKUNIT struct, bun not yet
        functional since not initialized.
    - Test scripts to check water level functionality, including minima and
        maxima. Test scripts are based on test_prefs.php.

    client/
        client_state.h
        cs_scheduler.C
        client_types.h
    test/
        max_water_prefs.xml (new)
        min_water_prefs.xml (new)
        normal_water_prefs.xml (new)
        test_max_water_prefs.php (new)
        test_min_water_prefs.php (new)
        test_normal_water_prefs.php (new)

Michael Gary        June 07, 2002
    - Converted scheduling server to allow for Fast CGI. Fast CGI will only be
        used if Makefile.in is replaced by Makefile.fcgi.in. Makefile.nofcgi.in
        is a copy of the current Makefile.in.

    sched/
        feeder.C
        handle_request.C
        main.C
        sched_shmem.C
        main.C
        sched_shmem.C
        server_types.C
        show_shmem.C
        Makefile.nofcgi.in (new)
        Makefile.fcgi.in (new)
    lib/
        parse.C

Eric Heien    June 07, 2002
    - Added initial functionality for passing graphics preferences between core and app

    client/
        Makefile.in
        app.C
    lib/
        gfx_interface.C
        gfx_interface.h

Michael Gary                June 08, 2002
    - Moved fast cgi Makefile.in to boinc/sched_fcgi
    - make now makes fcgi in boinc/sched_fcgi
    - Added links to existing code where necessary for making fast cgi
        scheduling server.

    configure
    Makefile.in
    sched/
        Makefile.nofcgi.in (removed)
        Makefile.fcgi.in (removed)
        Makefile.in
        parse.C (added)
        parse.h (added)
    sched_fcgi/ (added)
        Makefile.in (added)
        feeder.C (added)
        handle_request.C (added)
        handle_request.h (added)
        main.C (added)
        parse.C (added)
        parse.h (added)
        sched_shmem.C (added)
        sched_shmem.h (added)
        server_types.C (added)
        server_types.h (added)
        show_shmem.C (added)

David A     June 9 2002
    - added support for multiple URLs in a FILE_INFO
        (e.g. multiple servers from which the file can be downloaded)
    - started work on "persistent file transfer": a layer on top of
        FILE_XFER that manages restarting from failed connections,
        and that implements a give-up policy
    - added offset arguments to GET and PUT HTTP operations.
        NOTE: this will work fine for downloading files (GET)
        but we'll have to use something else for upload,
        since the standard PUT handler doesn't do offsets,
        and we need security functionality in any case.
    - added preliminary version of application API for
        communicating with core client.
    - use <file_ref> tags instead of <input_file> and <output_file>
        (makes things simpler)

    TODO
    notes
    api/
        api.C,h
    client/
        configure.in
        client_state.C
        client_types.C,h
        cs_files.C
        error_numbers.h
        file_xfer.h
        http.C,h
        pers_file_xfer.C,h
        test_http.C
    html_ops/
        db.php
    html_user/
        db.inc
    test/
        1sec_result
        account2.xml
        *_result
        *_wu
        init.inc
        laptop_prefs.xml
        test_*.php
    tools/
        add.C

David A     June 13 2002
    - added the RSAEuro library to the project,
        and some interface routines for it.

    RSAEuro/ (new)
        source/*
        demo/*
    lib/
        crypt.C,h (new)
        crypt_prog.C
        Makefile.in
    sched/
        file_upload_handler.C

Eric H       June 19, 2002
    - Removed redundant files

    sched/
        parse.C (removed)
        parse.h (removed)

Eric H       June 20, 2002
    - added soft link support via XML tags
    - fixed Windows ASCII/binary bug
    - Added Windows networking support
    - Fixed some bad indenting

    api/
        api.C
        api.h
    lib/
        md5_file.C
    client/
        client_state.C
        cs_scheduler.C
        net_xfer.C
        win_net.cpp (added)
        win_net.h (added)
        win_main.C (changed to win_main.cpp)
        win_main.cpp (changed from win_main.C)
        windows_cpp.h

David A     June 20 2002
    - Replaced the "accounts.xml" file with the user preferences ("prefs.xml").
        All non-host-specific project info is stored in this file;
        all host-specific project info is in client_state.xml.
        The PROJECT class is a union of the two.
        The logic for dealing with inconsistencies between
        prefs.xml and client_state.xml, and with updating in-memory
        and on-disk project lists in response to an update from a server,
        are a little tricky and are described in the code.
    - The prefs file can be overwritten by <preferences> in a scheduling
        server reply.  To prevent buggy servers from zeroing out
        users' project lists, the client makes sure there's at least
        one project, and backs up the old prefs.xml into a timestamped file.
    - The command-line client, if prefs.xml is absent,
        prompts the user for a project URL and authenticator,
        and creates an initial prefs.xml.
    - Each project now has a "master URL", with is its home page
        and also contains <scheduler> elements giving the URLs of
        its scheduling servers.
    - Added a class SCHEDULER_OP which encapsulates fetching and
        parsing a project's master page (if necessary),
        then making an RPC to one of its scheduling servers.
        TODO: add retry and failure logic.
    - A project can have more than one scheduling server.
        TODO: use all of them.
    - Project directories are stored in URL-encoded form.
        This allows project master URLs to have slashes, which is a necessity.

    client/
        Makefile.in
        accounts.C,h (deleted)
        app.C,h
        client_state.C,h
        client_types.C,h
        cs_apps.C
        cs_scheduler.C
        file_names.C,h
        main.C
        prefs.C,h
        scheduler_op.C,h (new)
        scheduler_reply.C,h (deleted)
    doc/
        project.html
    lib/
        parse.C,h
    sched/
        server_types.C
    test/
        account1.xml, account2.xml (deleted)
        init.inc
        prefs1.xml, prefs2.xml (new)
        test_*.php

David A     June 21 2002
    - top-level Makefile now compiles RSAEuro/,
        and doesn't refer to sched_fcgi
    - Added <scheduler> element to html_user/index.html,
        making it the "master file" for test project.
        This file must be placed in the directory referred to by
        http://localhost/

    Makefile.in
    html_user/
        index.html

Michael Gary        June 21 2002
    - added install to the make system to put executables
        in /usr/local/boinc
    - simplified make system for fast cgi scheduling server
    - completed implementation of high/low water system and
        testing of host.
    - checkpoints and timekeeping now implemented in api
    - timekeeping through api done in client state

    Makefile.in
    configure
    api/
        Makefile.in
        api.C
        api.h
        api_test.C
    apps/
        Makefile.in
    client/
        Makefile.in
        client_state.C
        client_state.h
        client_types.C
        client_types.h
        cs_scheduler.C
        hostinfo.C
        hostinfo.h
        app.h
        app.C
    db/
        db.h
    lib/
        Makefile.in
    sched/
        Makefile.in
        feeder.C
        handle_request.C
        main.C
        parse.C (removed)
        parse.h (removed)
        sched_shmem.C
        server_types.C
        show_shmem.C
    test/
        log_flags.php
    sched_fcgi/ (removed)

Micahel Gary        6/23/2002
    - Checkpoint timer initialized in boinc_init.
    - Test script added for api.

    api/
        api.C
        test_api.C
    test/
        init.inc
        test_api.php (new)
        ta_correct_atc (new)
        ta_correct_f (new)
        core_to_app.xml.in (new)

Michael Gary        6/25/2002
    - Maggie is now the master url for boinc.

    test/
        prefs1.html
    doc/
        test.html

Michael Gary        6/27/2002
    - Fixed a bug in add_work and added water level testing to test_uc.php

    test/
        test_uc.php
    tools/
        add_work.C

Michael Gary        6/28/2002
    - Added an explicit test for water level
    - Added a -no_time_test argument to the boinc client to stop the time tests
        from running.

    client/
        main.C
        client_state.h
        client_state.C
    test/
        test_water.php (new)

Eric Heien 7/01/2002
    - Added S@H test scripts, added other testing functionality.
    - Added random WU generation.
    - Added concat_slow application.
    - Altered functionality of API checkpoint_completed.

    api/
        api.C
        api.h
        api_test.C
    apps/
        concat_slow.C (added)
        Makefile.in
        uc_slow.C
        upper_case.C
    test/
        sah_result (added)
        sah_wu (added)
        sah_test.php (added)
        init.inc
        test_uc_slow.php
    tools/
        create_work.C

Michael Gary        7/01/2002
    - Fixed fast cgi scheduling server
    - If low water mark is higher than high water mark, water marks are
        switched
    - Updated documentation

    doc/
        flow.html
        protocol.html
    client/
        client_state.C
        cs_scheduler.C
    sched/
        main.C
    test/
        prefs1.xml

Michael Gary         7/03/2002
    - api test is now more thorough, tests time accounting and restarting
    - added app_completed function to api
    - api_test.C was moved to api_app.C
    - removed #ifdef solaris and #ifdef unix from all files

    api/
        Makefile.in
        api.C
        api.h
        api_test.C
        api_app.C (new)
    test/
        init.inc
        ta_correct_f
        test_api.php
    client/
        app.C
        hostinfo_unix.C
        configure
        configure.in
        filesys.C
    doc/
        api.html
    configure
    configure.in

David Anderson      July 4, 2002
    - Added support for upload authentication.
        This prevents bad guys from filling up data servers with trash.
        In this scheme, each <file_info> element sent from
        server to client includes a <max_nbytes> field limiting
        the size of the file, and includes a digital signature
        based on the project's "upload authentication" key pair.
        File uploads, instead of being done by PUT, are now done by POST
        to a CGI program, "file_upload_handler".
        The request header includes the signed <file_info>,
        and the CGI program verifies the signature and enforces the size limit.

        The affected pieces of code:
        - Added a function create_keys() in PHP test scripts
            to create encryption keys.  Call it from all script.
        - Added environment var BOINC_KEY_DIR saying where keys are kept.
        - The client must maintain an exact copy of each <file_info> XML,
            and of the signature, so that it can send to upload server.
        - Added a new variant of HTTP operation, HTTP_OP_POST2.
            The existing variants all use single files for request and reply.
            The new variant (used for file upload) has a request
            consisting of a memory block followed by (part of) a file;
            the reply is in memory.
            This avoid copying possibly huge upload files.
        - FILE_XFER objects now take a FILE_INFO as initialization argument;
            needed to convey authentication info.
            The upload variant creates and sends the authentication header.
        - Result templates now include a <max_nbytes> in each
            <file_info> element, and the URLs refer to the
            file_upload_handler (with no filename)
        - process_result_template() works differently, since it must
            generate a digital signature at the end of each <file_info>
        - create_work expects the name of a private key file.
        - Added crypt/md5 functions to sign/verify in memory,
            encode/decode ASCII data in memory, checksum in memory
    - Change "gmake" to "make" in top-level makefile.
        (alias make to gmake if this is a problem)

    boinc/
        Makefile.in
        TODO
    RSAEuro/source/
        rsaeuro.h
    client/
        Makefile.in
        client_state.C
        client_types.C,h
        cs_files.C
        file_names.C
        file_xfer.C,h
        http.C,h
        main.C
        scheduler_op.C
        test_file_xfer.C
    db/
        mysql_util.C
    doc/
        index.html
        intro.html
        master_url.html (new)
        project_startup.html (new)
        tools_security.html (new)
    html_user/
        index.html
    lib/
        Makefile.in
        crypt.C,h
        crypt_prog.C
        md5_file.C,h
        parse.C,h
    sched/
        Makefile.in
        file_upload_handler.C
        server_types.C
    test/
        1sec_result
        concat_result
        init.inc
        master.html (new)
        sah_result
        test_1sec.php
        test_concat.php
        test_dynamic.php
        test_max_water_prefs.php
        test_min_water_prefs.php
        test_normal_water_prefs.php
        test_prefs.php
        test_projects.php
        test_stderr.php
        test_uc.php
        test_uc_slow.php
        uc_result
        ucs_result
    tools/
        Makefile.in
        add.C
        backend_lib.C,h
        create_work.C
        process_result_template.C

David   July 4, 2002
    - fixed compile problems on linux.
        use kill() instead of sigsend()

    client/app.C
    sched/file_upload_handler.C

Michael Gary        July 5, 2002
    - fixed fast cgi crypto
        use fgets and sscanf instead of fscanf, which
        is not implemented in fcgi_stdio.h

    sched/Makefile.in
    lib/crypt.C

David A.    July 7, 2002
    - Added code signing.  All files associated with an app version
        (i.e. all executable files) must now be signed
        with the project's "code sign key".  The components include:
        - PROJECT has new field "code_sign_key", keep track of project's
            public code-signing key.
            Send this on each scheduler RPC.
        - The scheduling server stores the public code-signing key in memory.
            Send it to any client who doesn't have it.
            If the client has an old key,
            send them the new key signed with the old key.
            NOTE: this uses a scheme in which signatures are kept
            in files on the server, to avoid keeping private keys
            in online machines.  This should be documented.
        - The utility to add new app versions (add.C) adds a signature
            to the FILE_INFO element.
            NOTE: eventually the signing should be done offline.
        - FILE_INFO has a new boolean field "signature_required";
            set for all files associated with an app version
        - FILE_INFO has a new char* field "file_signature",
            which is the digital signature.
            Renamed upload authenticator from "signature" to "xml_signature"
            to avoid confusion.
        - Add function verify_downloaded_file(), called after every download;
            does MD5 or signature checking as needed.
        - Added some new functions for signature checking etc.
        - the client is now linked with the crypt library
    - Server-side errors should always include the name of the
        CGI program generating the error (scheduler or file upload handler)

    client/
        Makefile.in
        client_state.C
        client_types.C,h
        cs_files.C
        cs_scheduler.C
        file_xfer.C
        scheduler_op.C,h
        test_file_xfer.C
    doc/
        index.html
        project_startup.html (new)
        security.html
    lib/
        crypt.C,h
        parse.C,h
    sched/
        file_upload_handler.C
        handle_request.C,h
        main.C
        server_types.C,h
    test/
        init.inc
        prefs1.xml
        test_uc.php
    tools/
        add.C
        process_result_template.C

David A.    July 8, 2002
    - fix compile errors
    - fix bugs in FCGI version of scan_hex_data stuff

    client/
        client_types.C
    lib/
        crypt.C
        crypt_prog.C
    sched/
        file_upload_handler.C
    tools/
        Makefile.in
        add.C
        process_result_template.C

Michael Gary        July 10, 2002
    - Added asserts to the server side
    - Added error checks on function parameters
    - Made the api update result with time information at
        checkpoints and when an application exits
    - Removed unused tests
    - Fixed bug in crypto sscan
    - Moved client/error_numbers.h to lib/error_numbers.h

    api/
        Makefile.in
        api.C
        app.C
    client/
        app.h
        client_state.C
        client_types.C
        cs_apps.C
        cs_files.C
        cs_scheduler.C
        file_names.C
        file_xfer.C
        filesys.C
        hostinfo.C
        hostinfo_unix.C
        http.C
        log_flags.C
        main.C
        net_stats.C
        scheduler_op.C
        speed_stats.C
        time_stats.C
        util.C
        error_numbers.h (removed)
    db/
        db_mysql.C
        mysql_util.C
    lib/
        crypt.C
        md5_file.C
        parse.C
        shmem.C
        error_numbers.h (added)
    sched/
        Makefile.in
        feeder.C
        file_upload_handler.C
        handle_request.C
        main.C
        sched_shmem.C
        sched_shmem.h
        server_types.C
    test/
        max_water_prefs.xml (removed)
        min_water_prefs.xml (removed)
        normal_water_prefs.xml (removed)
        test_max_water_prefs.php (removed)
        test_min_water_prefs.php (removed)
        test_normal_water_prefs.php (removed)
    tools/
        add.C
        backend_lib.C
        process_result_template.C

Barry Luong    July 11, 2002
    - added changes to allow for multiple servers on one machine
        - database names are from environment variables
        - download and upload directories are from environment variables
        - download and upload url's are from environment variables
        - boinc_key (for shared memory) is from environment variables
        - new directory tree:

                  ~barry/
                   /  \
                  /    \
                 /      \
          boinc_cvs/   boinc_server/
            /         /   /    \   \
           /         /   /      \   \
          /         /   /        \   \
       boinc/   cgi/  keys/  upload/  download/
       /  \    \
      /    \    \
     /      \    \
  client/ sched/  ...

        - sched cgi, fcgi, file_upload_handler are copied into
          ~barry/boinc_server/cgi/
        - in httpd.conf set up cgi permissions for appropriate files and
          directories
        - must define new environment variables:
          BOINC_DOWNLOAD_DIR ~/barry/boinc_server/download
          BOINC_UPLOAD_DIR ~/barry/boinc_server/upload
          BOINC_DB_NAME boinc_barry
          BOINC_UPLOAD_URL http://localhost/barry/boinc_server/cgi/fileupload_handler
          BOINC_DOWNLOAD_URL http://localhost/barry/boinc_server/cgi/download
          BOINC_KEY 0xdabacafe
          BOINC_USER barry
          BOINC_PUBLIC_KEY_PATH ~/barry/boinc_server/keys/upload_public
          BOINC_KEY_DIR ~barry/boinc_server/keys

    db/
        init_db
        drop.sql
        schema.sql
        constraints.sql

    sched/
        main.C
        feeder.C
        Makefile.in
        file_upload_handler.C
        sched_shmem.h

    tools/
        backend_lib.C
        process_result_template.C
        add.C
        create_work.C

    html_user/
        db.inc

Barry Luong    July 12, 2002
    - Changed error messages in main.C so user names are printed out also
    - took out a debugging variable I accidentally left in feeder.C
    - removed an assert in file_upload_handler.C
    - changed so BOINC_UPLOAD_DIR and BOINC_KEY_DIR are defined at compile time

    sched/
        main.C
        Makefile.in
        feeder.C
        file_upload_handler.C

Michael Gary        July 12, 2002
    - Added a test to make sure the scheduling server does not send unfeasible
        work units
    - Removed some debug output

    lib/
        shmem.C
    sched/
        file_upload_handler.C
        handle_request.C
    test/
        prefs3.xml
        test_rsc.php

David A     July 14 2002
    - Added reasonable policies for making scheduler RPCs.  Summary:
        - results now have a "report deadline".
            This may be useful for various purposes; for now,
            we use it to trigger scheduler RPCs to report results
        - The client now tries all a project's scheduler URLs in turn.
        - Projects have a "min_rpc_time", the earliest time to
            attempt another RPC (replaces next_request_time)
        - We maintain an RPC failure count for each project.
            If RPCs to all its URLs fail, we increment the count
            and set its min_rpc_time according to an exponential backoff
        - If a project is getting repeated RPC failures,
            reread and parse its master URL file every so often,
            in case the set of scheduler URLs has changed
        - When the client has a completed result past its deadline,
            it attempts to report it to that project.
        - When the client's estimated work falls below low water,
            it ranks projects according to their "resource deficit",
            then attempts RPCs to project in that order
            until the estimated work is above high water.
        NOTE: only the simplest case has been tested.
        We need to write test scripts for many other cases.
        NOTE: currently a result's report deadline is now+1000.
        We need to add a mechanism for setting it.
    - The CLIENT_STATE is now kept in a global variable instead of
        a local var of main().
        This is because SCHEDULER_OP needs to get at it.

    client/
        client_state.C,h
        client_types.C,h
        cs_scheduler.C
        main.C
        scheduler_op.C,h
    db/
        db.h
        db_mysql.h
        schema.sql
    doc/
        file_xfer_policy.html (new)
        index.html
        result.html
        rpc_policy.html (new)
    html_user/
        db.inc
    tools/
        backend_lib.C
        create_work.C

David A     July 15, 2002
    - added env var BOINC_MASTER_URL.
        Each / in the master URL must be preceded by four \s
        e.g. setenv BOINC_MASTER_URL  http:\\\\/\\\\/localhost\\\\/index.html
    - team name must be non-null to be unique
    - TODO (Barry): make the master page per-project;
        make database access from PHP/Web per-project
    db/
        schema.sql
    html_user/
        db.inc
    test/
        init.inc
        master.html
        prefs1.xml
    tools/
        Makefile.in

Michael Gary        July 15, 2002
    - Fixed compile bug
    - Updated documentation
    - Fixed test script bug
    - Added comments to some .h files
    - Fixed timing bug
    doc/
        api.html
        client_debug.html
        flow.html
        index.html
        protocol.html
        sched_debug.html
        sched_policy.html
        test.html
    tools/
        Makefile.in
    test/
        test_uc.php
        test_rsc.php
        init.inc
    client/
        client_types.h
        hostinfo.h
    api/
        api.C
        api.h

Michael Gary        July 16, 2002
    -Fixed test script bug
    test/
        concat_result
        test_concat.php

Eric Heien      July 17, 2002
    - Removed assembly optimized routines from RSAEuro, since we
      want to be platform independent and RSAEuro isn't a highly speed
      critical piece of code.  This had the side benefit of making the
      RSAEuro Makefile operate cleanly with make.
    - Fixed compiler warnings in RSAEuro demo programs.  Do we really
      need to keep these demo programs around?
    - Turned off the "secure" versions of memcpy, memset and memcmp.
      If needed, we can turn them back on.
    RSAEuro/
        source/
            makefile (moved to Makefile)
            Makefile (renamed from makefile)
            des386.s (removed)
            rsa386.s (removed)
            rsa68k.s (removed)
            rsasparc.s (removed)
        demo/
            mdemo.c
            randemo.c
            redemo.c

Michael Gary        7/17/2002
    - Fixed more test scripts
    - Added a comprehensive test
    - Added make tar_client to toplevel makefile
    - Added installation notes for the server and the client
    Makefile.in
    INSTALL (added)
    INSTALL_CLIENT (added)
    test/
        test_1sec.php
        test_dynamic.php
        test_prefs.php
        test_projects.php
        test_stderr.php
        test_uc_slow.php
        test_suite.php (added)


Michael Gary        7/18/2002
    - Configure now checks to make sure that apache, mysql, and php are
        installed. If they are not installed, it prints out a warning and
        continues configuration
    - Added uninstall target, made Makefiles more compliant with GNU standards
    INSTALL
    INSTALL_CLIENT
    aclocal.m4 (added)
    configure
    configure.in
    Makefile.in
    sched/
        Makefile.in
    lib/
        Makefile.in
    api/
        Makefile.in
    client/
        Makefile.in

Eric Heien   7/18/2002
    -  Fixed RSAEuro makefile so that it doesn't require gcc.  This was
       causing problems when porting.

    RSAEuro/source/
        Makefile (removed)
        Makefile.in (added)
    configure
    configure.in

Michael Gary        7/23/2002
    - Added a test for sticky files. Required updating escape_url to support
         RRC1738 (-_. no longer escaped out).
    client/
        file_names.C
    test/
        test_sticky.php (added)
        uc_wu_sticky (added)
        uc_result_sticky (added)

Michael Gary        7/24/2002
    - Added a test for the time reporting system.
    test/
        test_time.php (added)
        init.inc
    apps/
        uc_slow.C
        uc_cpu.C (added)
        Makefile.in

David   July 28 2002
    - Changed the "add" utility so that, when adding an app version,
        you can give it the signature files (computed offline, presumably)
    - Changed the "add" utility so that an app version can consist
        of multiple files
    - Removed the notion of alpha/beta/production versions of an app.
        The same effect can be achieved by making separate projects
        for alpha and beta testing.
    - Apps now have a "minimum version number" on the server side -
        Don't send a WU unless there's an app version of that number or greater.
        Send the latest available version for the platform.
    - Clarified app version semantics:
        - Workunits don't have a version# on the server
        - When a client gets a workunit, it associates it with
            the most recent version of the application that it knows about
            (possibly one it received in the same reply message).
            It continues to use this version for this WU,
            even if it receives a later version while the WU is in progress.
        - On the client, no version #s are associated with apps

    PROGRAMMERS NOTE:
    - Removed checking of args in client_state.C
        This gunks up the code too much.  Let's do checking at higher level.
    - Comments should be in the imperative mood.
        "Write the state file", not "Writes the state file"
    - Comments should not be vague, e.g.
        // See if the application (name) associated with project p is
        // around here
        ... what does "around here" mean?
    - Leave a space between "if" and "("
    - When asserting that a pointer is non-NULL, just say "assert(p)".
        Saying "assert(p!=NULL)" is like saying if (flag==true)
    - Linux doesn't have -lsocket and -lnsl.
        Don't put them in Makefile.in.

    TODO
    client/
        client_state.C,h
        client_types.C,h
        cs_scheduler.C
        main.C
    db/
        db.h
        db_mysql.C
        schema.sql
    doc/
        app.html
        index.html
        intro.html
        project.html
        tools_other.html
    html_user/
        db.inc
    sched/
        handle_request.C
        sched_shmem.C
        server_types.C
    test/
        init.inc
        master.html
    tools/
        Makefile.in
        add.C
        backend_lib.C


Eric Heien  July 29 2002
    - Added code to determine the amount of disk space being
        used by BOINC, by recursively descending through the
        root directory.  Still needs to be ported to Windows.

    client/
        filesys.C
        filesys.h

David A.    July 30 2002
    - Revised API doc
    - made some API implementation functions static
        (this breaks the test program, need to discuss)
    - removed CPU spin from uc_slow (why?)

    api/
        api.C,h
    apps/
        uc_slow.C
    doc/
        api.html
        graphics.html
        index.html

David A.    July 30, 2002
    - Revised API and graphics docs
    - removed error checks from parse.C

    doc/
        api.html
        graphics.html
        index.html
    lib/
        parse.C

Eric Heien  August 2, 2002
    - Implemented HTTP 301 and 302 redirect commands.
    - These still need to be fully tested.

    TODO
    client/
        http.C
        http.h
        net_xfer.C
        net_xfer.h

David A.    August 4 2002
    Various changes to API:
        - Added user, team names, credit info to APP_INIT_DATA
        - separate call for getting init data
        - separate call for returning fraction done
        - separated out fraction_done_update_period
        - moved graphics API to separate file
        - moved MFILE implementation to separate file
        - API timer is now 0.1 sec; use counters for various uses
            (checkpoint, fraction done, graphics)
        - changed name of API files to boinc_api.C,h

    - clarify distinction between
        "current CPU time"
        "CPU time at last checkpoint"
        "CPU time at start of current run"
        These are all kept in ACTIVE_TASK.
        RESULT now only has "final CPU time".

    - fixed bug in dir scanning (ahem...)

    - Coding style notes:
        - every fopen() MUST have a matching fclose() in same function
        - every malloc() MUST have a matching free() in same function
        - don't do a rewind() right after fopen()
        - write function calls as
            func(arg1, arg2);
            NOTE: there's a space after every comma, everywhere
        - write "if" statements as
            if (condition) {
                ...
            }
        - no explicit argument checking.  do this at higher level
        - functions in foo.C should be declared (as extern) in foo.h,
            AND NOWHERE ELSE.

    api/
        Makefile.in
        api.C,h (removed)
        boinc_api.C,h (new)
        graphics_api.C,h (new)
        mfile.C (new)
    apps/
        Makefile.in
        *.C
    client/
        Makefile.in
        app.C,h
        client_state.C,h
        client_types.C,h
        cs_apps.C
        cs_scheduler.C
        file_names.C
        filesys.C,h
    doc/
        api.html


Barry Luong  August 6, 2002

    - Added team pages in html_user/
        - pages to display team page, join team, quit team, edit team, disband
          team, and remove inactive members
    - Added database access per project via the web
        - a new file in html_user/ called db_name containing only the name of
          that project's database

    html_user/
        db.inc
        team.inc
        team.php
        team_create_action.php
        team_create_form.php
        team_disband_action.php
        team_disband_form.php
        team_display.php
        team_edit_action.php
        team_edit_form.php
        team_join_action.php
        team_join_form.php
        team_lookup.php
        team_quit_action.php
        team_quit_form.php
        team_remove_inactive_action.php
        team_remove_inactive_form.php


Eric Heien      August 7, 2002
        - Added PERS_FILE_XFER (persistent file transfer)
          functionality.  This includes the notions of retrying
          when unable to connect, exponential backoff, and giving
          up after a period of time.  Giving up is currently
          not fully implemented.  Includes initial work for
          supporting upload/download resumption.  All features
          still need to be thoroughly tested.
        - Added initial functionality to calculate allowable disk
          usage.

    client/
        Makefile.in
        client_state.C
        client_state.h
        client_types.C
        client_types.h
        cs_files.C
        cs_scheduler.C
        file_xfer.C
        hostinfo_unix.C
        http.C
        http.h
        pers_file_xfer.C
        pers_file_xfer.h
        scheduler_op.C
        test_file_xfer.C
        test_http.C
        util.C
        util.h
    sched/
        file_upload_handler.C

Eric Heien    August 9, 2002
        - Moved windows files to client/win directory, added win_build.zip
          for building Windows GUI and CLI clients.
        - Fixed compile bugs in graphics_api.C and graphics_api.h
        - Updated TODO and INSTALL docs
        - Added Mac init, event loop, and cleanup functionality in main.C
        - Added user requestable quit to main loop for use in GUI interfaces.
        - Fixed Windows specific compile bugs in filesys and pers_file_xfer.

    TODO
    INSTALL
    INSTALL_CLIENT
    win_build.zip
    api/
        boinc_api.C
        graphics_api.C
        graphics_api.h
    client/
        app.C
        filesys.C
        filesys.h
        hostinfo_win.C (removed)
        main.C
        pers_file_xfer.C
        util.C
        util.h
        win_main.cpp (removed)
        win_net.cpp (removed)
        win_net.h (removed)
        windows_cpp.h (removed)
        win/
            hostinfo_win.cpp (added)
            win_main.cpp (added)
            win_net.cpp (added)
            win_net.h (added)
            windows_cpp.h (added)

David A.    August 10 2002
    - Changed Winmain() to get argc/argv correctly
    - fixed bugs in CLIENT_STATE::allowed_disk_usage
        NOTE: keep track of whether units are bytes or GB.
            Not interchangeable!
        NOTE: above bugs caused compiler warnings.
    - Got rid of all compiler warnings in Windows

    api/
       boinc_api.h
    client/
       app.C
       client_state.C
       hostinfo_unix.C (??? should remove this from Windows project)
       pers_file_xfer.C,h
    client/win/
       Resource.h (new)
       win_main.cpp
       wingui.cpp,h (new)

Barry        August 12, 2002
    - Changed front page to a php page so we can check for cookies
         Added explanatory text to front page and to team pages

    html_user/
        index.php

Eric Heien   August 12, 2002
    - Added concept of result state.  This replaces the old boolean
      flags and represents what phase of the computation pipeline
      each result is currently at (downloading, computing, uploading,
      etc).
    - Added file upload/download resumption.  For downloads, this
      involves checking how big the local file is, then asking
      the server for the remainder of it.  For uploads, this
      involves asking the file_upload_handler how much of a certain
      file it already has, then sending the remainder of it.
      Both ul and dl resumption need to be thoroughly tested.

    client/
        client_state.C
        client_state.h
        client_types.C
        client_types.h
        cs_apps.C
        cs_files.C
        cs_scheduler.C
        file_xfer.C
        http.C
        net_xfer.C
        pers_file_xfer.C
        scheduler_op.C
    sched/
        file_upload_handler.C

David    August 12 2002
    - Cleaned up initialization code:
        main.C is now used ONLY for CLI versions
        (remove this file from GUI projects)
        Factored out initialization code that is common to
        both GUI and CLI versions.

    client/
        client_state.C,h
        log_flags.C,h
        main.C
        prefs.h

Eric Heien  August 13, 2002
    - Implemented correct handling of RSA or MD5 failures.  The
      result associated with the file will be flagged and the
      failure will be passed back to the scheduling server.

    client/
        client_state.C
        client_types.C
        client_types.h
        cs_files.C
        pers_file_xfer.C
    lib/
        error_numbers.h

Eric Heien  August 21, 2002
    - Finished persistent file transfer implementation, including
      file upload/download resumption, exponential backoff

    client/
        client_state.C
        client_state.h
        client_types.C
        client_types.h
        cs_files.C
        file_xfer.C
        file_xfer.h
        http.h
        main.C
        pers_file_xfer.C
        pers_file_xfer.h
        mac/
            mac_main.cpp
            mac_main.h
    lib/
        error_numbers.h

David   August 24, 2002
    - fixed bugs in the Windows variant of app.C
        Notes on Windows:
        - Some places (e.g. current dir arg of CreateProcess())
          require a full path
        - Some places require \ instead of / in paths.
          Added the constant PATH_SEPARATOR for this purpose.
        - To redirect stdin/stdout, you need to use freopen();
          it's not enough to dup2 the underlying descriptor

    api/
        boinc_api.C
    apps/
        upper_case.C
    client/
        app.C,h
        file_names.C
        filesys.C,h
    lib/
        error_numbers.h

David        August 25, 2002
    - Implemented project name (as shown in GUI).
        It's stored in the DB (in a single-row "project" table)
        and sent in scheduler RPC
    - Changed env var BOINC_KEY to BOINC_SHMEM_KEY
        (avoid confusion w/ encryption keys)

    Makefile.in
    client/
        cs_scheduler.C
        filesys.C
        scheduler_op.C,h
        win/
            windows_cpp.h
            wingui.cpp
    db/
        db.h
        db_mysql.C
        schema.sql
    sched/
        Makefile.in
        feeder.C
        main.C
        server_types.C
        show_shmem.C
    test/
        init.inc
        test_uc.php
        test_uc_win.php
    tools/
        add.C

Eric  August 26, 2002
    - Finished multi-slot functionality.  The client now requests an
      open slot from the ACTIVE_TASK_SET which will be the slot
      for the new process.

    client/
        app.C
        app.h
        cs_apps.C

David  August 26, 2002
    - adding missing clause to SCHEDULER_OP::poll(); was failing to
        return state to IDLE, caused reply to get processed twice
    - return user name, total credit, avg credit in scheduler RPC reply
        - save/restore these in client state file
    - client was trying to delete "checkpoint CPU file" in wrong directory
    - change CLIENT_STATE field from "version" to "core_client_version"
    - got rid of CLIENT_STATE::update_net_stats(), insert_file_xfer()
        (made some stuff public)
    - disable host performance measurement (temp! turn back on later)
    - removed comments of the form
        read_config_file();    // read config file
    - in HTTP op of type POST2, it's not an error if htp->file is zero
    - replaced hardwired HTTP_STATUS constants
    - made separate db.inc, util.inc in html_ops
    - key creation prints message before delay, not after
    - file upload handler prints user name in error log lines
    - scheduling server: make USER, HOST part of SCHEDULER_REPLY
        so don't have to pass around as separate args
    - in test/init.inc, don't use the init_db() from html_user/.
        define it separately here.
    - in test/init.inc, split up clear_data_dirs() into
        client, server parts
    - change test_uc.php to not create keys by default

    client/
        app.C
        client_state.C,h
        cs_scheduler.C
        file_xfer.C
        http.C,h
        pers_file_xfer.C
        scheduler_op.C,h
    db/
        db.h
    html_ops/
        db.inc (new)
        util.inc (new)
    lib/
        crypt_prog.C
    sched/
        file_upload_handler.C
        handle_request.C
        server_types.C,h
    test/
        init.inc
        master.html
        test_uc.php

David   August 28, 2002
    - added DB fields to keep track of credit for hosts and result
    - added utility program "grant_credit" to grant credit for a result
    - removed some extraneous printfs
    - file upload handler error messages have user name
    - added a "poll_debug" flag; turn this on in case of infinite
        poll loop, to see what's causing the problem
    - added a "libboinc.a" target to lib/ Makefile.
        We might want to consider using a random library
        instead of referring to explicit .o files everywhere

    api/
        boinc_api.h
    client/
        Makefile.in
        app.C
        client_state.C
        cs_apps.C
        cs_files.C
        cs_scheduler.C
        file_xfer.C
        log_flags.C,h
        net_xfer.C
        pers_file_xfer.C
    db/
        db.h
        db_mysql.C
        schema.sql
    html_ops/
        db.inc
        db.php
    html_user/
        index.html
    lib/
        Makefile.in
    sched/
        feeder.C
        file_upload_handler.C
        handle_request.C
    test/
        master.html
        test_uc.php
    tools/
        Makefile.in
        backend_lib.C,h
        grant_credit.C (new)

David   August 30 2002
    - improved Win GUI
    - print error if file validate failure
    - fix lib Makefile.in

    client/
        client_state.C
        cs_files.C
        pers_file_xfer.C
    client/win/
        wingui.cpp,h
    lib/
        Makefile.in
        countries.C
        crypt.C
        error_numbers.h
        filesys.C
        md5_file.C

Eric    September 4, 2002
    - condensed uc_slow, uc_cpu into upper_case, concat_slow into concat, using command line arguments
    - changed test_uc to use files rather than stdin/stdout

    apps/
        uc_slow.C (removed)
        concat_slow.C (removed)
        uc_cpu.C (removed)
        upper_case.C
        concat.C
        Makefile.in
    lib/
        error_numbers.h
    test/
        test_uc_slow.php
        test_concat.php
        uc_result
        uc_wu
        ucs_wu

Eric   September 18, 2002
    - Windows OpenGL based graphics added, graphics API updated
    - Beginning of Mac Carbon based graphics added
    - Uppercase application updated to use GL, GLUT graphics

    apps/
        upper_case.C
    api/
        boinc_api.C
        boinc_api.h
        graphics_api.C
        graphics_api.h
        windows_opengl.cpp

David    Sept 22, 2002
    - Various changes to prevent buffer overrun in servers;
        parse_str and parse_attr now take a buffer length arg

    api/
        boinc_api.C,h
    apps/
        concat.C
        upper_case.C
    client/
        app.C
        client_types.C
        file_xfer.C
        hostinfo.C
        scheduler_op.C
    doc/
        account.html
    lib/
        parse.C,h
    sched/
        file_upload_handler.C
        handle_request.C
        server_types.C,h

David   Sept 25 2002
    - Progress on validation and credit-granting
    - added DB fields to support the above

    client/
        cs_scheduler.C
    db/
        db.h
        db_mysql.C
        schema.sql
    sched/
        Makefile.in
        validate.C
        validate_test.C (new)

David   Sept 25 2002
    - Move account into (master URL, authenticator, per-project prefs)
        from the prefs.xml file into separate files, one per project
        (with names of the form account_XXX.xml, XXX = master URL).
        Adding new projects is now done using the core client
        (via GUI or command line) or by copying an existing account file,
        but NOT via web site; this was a major security weakness
        since bad guys could guess your web password,
        then register you for a bogus project.

        This change also involved the html_user files (not finished).

    - Further work on credit-granting.
        On each RPC, the scheduler computes a "credit per CPU second"
        for the host (linear combo of FP/int/mem speeds).
        For each result received, the scheduler computes a "claimed credit",
        the claimed CPU time times the credit per CPU second.
        It also sets the "need validate" flag of the WU.

    api/
        boinc_api.C
    apps/
        upper_case.C
    client/
        Makefile.in
        account.C,h (new)
        client_state.C,h
        client_types.C,h
        cs_scheduler.C
        file_names.C,h
        file_xfer.C
        main.C
        prefs.C,h
    db/
        db.h
    doc/
        account.html
        boinc_dev.html
        client_files.html
        client_logic.html
        prefs.html
        startup.html
        validation.html
    html_user/
        prefs.inc
        prefs.php
        prefs_edit_project_form.php
    sched/
        handle_request.C
        validate.C
    test/
        account1.xml (new)
        init.inc
        master.html
        prefs1.xml
        test_uc.php
    tools/
        backend_lib.C

David   Sept 26 2002
    - added todo list
    - added license comment to various files

    tools/
        grant_credit.C (removed)

David   Sept 26 2002
    - continue with separation of global vs. project preferences.
        Added separate DB field for project prefs.
        Revised PHP files for editing separately

    client/
        prefs.C
    db/
        db.h
        db_mysql.C
        schema.sql
    doc/
        prefs.html
    html_user/
        removed prefs_add*, prefs_delete*, prefs_edit_disk*, prefs_edit_work*
        removed prefs_edit_projects.php
        added prefs_edit_global*
        prefs_edit_project_action.php
        prefs.inc
        prefs.php
        util.inc
    sched/
        server_types.C
    test/
        init.inc
        test_uc.php
    tools/
        add.C

David   Sept 28 2002
    - Clarified the way that preferences (global and project)
        are stored in the database and in the core client,
        and the protocol (part of scheduler RPC) for maintaining them.
        See doc/prefs_impl.html
    - Implemented the above: lots of small changes to client, server
    - Changed names from "prefs" to "global_prefs" where relevant

    client/
        client_state.C,h
        client_types.C,h
        cs_scheduler.C
        file_names.C,h
        prefs.C,h
        scheduler_op.C,h
    db/
        db.h
        db_mysql.C
        schema.sql
    doc/
        boinc_dev.html
        prefs_impl.html (new)
        prefs_mod.html (removed)
    html_user/
        prefs.inc
    sched/
        handle_request.C
        server_types.C,h
    tools/
        add.C

David   Oct 3 2002
    - Changed the PHP framework for testing to facilitate
        multi-project, multi-host tests (all on one machine).
        See doc/test.html for details.
    - NOTE: the BOINC-related environment variables have changed.
        There are no longer any project-specific variables
        (e.g. database name, shmem key)
    - NOTE: the server programs now expect a configuration file
        in their directory.
    - TODO: enhance the testing framework to allow projects with
        multiple scheduling servers or data servers
    - TODO: enhance the testing framework to allow specification
        of failure and recovery of servers

    - changed things so a NULL in the DB won't crash db_mysql.C
    - parse_int() can now handle hex
    - "add" now takes args for DB name/passwd
    - "create_work" now takes args for DB name/passwd,
        upload/download URL, download dir

    db/
        db_mysql.C
        mysql_util.C
    doc/
        data_server_setup.html
        sched_server_setup.html
        test.html
        web_site.html
    html_user/
        index.html
    lib/
        md5_file.C
        parse.C
    sched/
        Makefile.in
        config.C,h (new)
        feeder.C
        file_upload_handler.C
        main.C
        validate.C
        validate_test.C
    test/
        test.inc (new)
        test_uc.php
    tools/
        add.C
        backend_lib.C,h
        create_work.C
        process_result_template.C

David   Oct 3 2002
    - updated test scripts to use new framework
    - got rid of some obsolete scripts

David   Oct 8 2002
    - progress getting "make_work" (dummy work generator) to work.
        Removed the <name> element from workunit XML,
        and the <name> and <wu_name> elements from result XML;
        instead, the scheduler server inserts these as it sends them.

        This simplifies things a little in work generation,
        and removes some redundancy.

        Everything seems to work now except that the file upload signature
        ends up being wrong, which is expected,
        and it shows that the security mechanism works.
    - added test_loop.php, which simulates a system that is complete
        except for the validation process.

    client/
        http.C
    db/
        db.h
        db_mysql.C
    html_ops/
        index.html
    sched/
        Makefile.in
        feeder.C
        file_upload_handler.C
        handle_request.C
        main.C
        make_work.C (new)
    test/
        *_result
        *_wu
        *.php
        test_loop.php (new)
    tools/
        backend_lib.C,h
        process_result_template.C

Eric  October 13, 2002
    - Now uses alternate means (statfs, sysctl) to get host information
      on non-Linux platforms
    - Fixed compile warnings

    client/
        client_state.C
        hostinfo.h
        hostinfo_unix.C
        file_names.C
        scheduler_op.C

Eric  October 14, 2002
    - Added initial support for Mac OpenGL graphics, still needs to
      be polished and tested (particularly multithreaded aspect)

    api/
        mac_app_opengl.c,h
        mac_carbon_dsp.c,h
        mac_carbon_gl.c,h
    mac_build/
        boinc.pbproj/
            project.pbxproj

David  Oct 14 2002
    - Change make_work so that it generates results with
        valid file upload signatures.
        Instead of directly creating new DB.result records,
        it now calls create_result() to do the work.
    - Changed create_result() to take a name suffix
    - Factored key parsing into a function
    - Removed random-WU-name feature from create_work;
        names should be generated at a higher level
    - added a key-generation function to test.inc

    lib/
        parse.C
    sched/
        Makefile.in
        config.C,h
        make_work.C
    test/
        test.inc
        test_loop.php
    tools/
        add.C
        backend_lib.C,h
        create_work.C
        process_result_template.C

David  Oct 15 2002
    - remove the idea of "dynamic result" generation
        (remove some DB fields and code relating to it)
    - remove the nresults_* fields from the workunit table.
        These are redundant, and they weren't being used.
        Furthermore, they were being updated in a way that
        overwrote other updates.
    - change html_ops table displays to 2 columns

    db/
        db.h
        db_mysql.C
        mysql_util.C,h
        schema.sql
    doc/
        test.html
    html_ops/
        db.inc
    sched/
        handle_request.C
    tools/
        backend_lib.C
        create_work.C

David  Oct 18, 2002
    - make_work now adds new WUs as well as results

    sched/
        feeder.C
        make_work.C

David  Oct 20, 2002
    - Pin down exactly what credit is, both in the docs and the code
    - Show credit in admin PHP pages.
    - NOTE: multi-word titles (e.g. in admin pages) should
        have only the first letter capitalized

    todo
    client/
        client_state.C
        speed_stats.C
    doc/
        credit.html (new)
        participation.html
        validation.html
    html_ops/
        db.inc
        db.php
        index.html
        util.inc
    sched/
        handle_request.C
        validate.C

David  Oct 21, 2002
    - floating-point values are passed to/from MySQL using sprintf and atof.
        The "%f" format, by default, uses 6 decimal places of precision.
        This is inadequate for small values, e.g. 1e-7.
        So db_mysql.C should use %.12e instead of %f.
    - changed all floats to doubles in DB schema
    - Credit half-life is one week

    db/
        db_mysql.C
        schema.sql
    doc/
        credit.html
    html_ops/
        util.inc
    sched/
        validate.C
    test/
        test_loop.php

Eric  October 28, 2002
    - added signal handling to API
    - removed win_build.zip

    api/
        boinc_api.C,h
    apps/
        upper_case.C
        concat.C
    lib/
        error_numbers.h
    win_build.zip (removed)

Eric  October 29, 2002
    - Mac graphics completed (except for screensaver mode)

    api/
        boinc_api.C
        graphics_api.C
        mac_app_opengl.c,h
        mac_carbon_dsp.c,h
        mac_carbon_gl.c,h

David  Nov 5 2002
    - Continued work on result retry mechanism:
        - new fields "retry_check_time" and "state" in workunit table
        - logic for creating new output filenames
        - needs a bit more work
    db/
        db.h
        db_mysql.C
        schema.sql
    sched/
        Makefile.in
        make_work.C
        result_retry.C

David  Nov 7 2002
    - Finished and did basic testing of result retry mechanism.
        It now correctly generates new results with unique names,
        unique filenames, and upload signatures.
        TODO: make a test script
    - added DB field workunit.delay_bound:
        determines deadlines of result, determines retry check period
        Mandatory argument to create_work.
    - Added DB indices for all enumeration functions

    client/
        client_types.C
    db/
        constraints.sql
        db.h
        db_mysql.C
        schema.sql
    doc/
        result.html
        tools_work.html
        work.html
    html_ops/
        db.inc
    sched/
        Makefile.in
        feeder.C
        handle_request.C
        result_retry.C
    test/
        1sec_wu
        concat_wu
        sah_result
        sah_wu
        test.inc
        test_uc.php
        uc_wu
        ucs_wu
    tools/
        backend_lib.Ch
        create_work.C
        process_result_template.C

David  Nov 9 2002
    - fixed bug that caused file upload authentication failure
    - The user web site now correctly provides download of the core client,
        as long as you add a core client app version in your test script
        (see test_uc.php for an example)
    - version numbers now come from env vars BOINC_MAJOR_VERSION
        and BOINC_MINOR_VERSION.  You must set these in your .cshrc
    - Web server config file must have
        DefaultType application/octet-stream
        so that core client is saved as file, not displayed
    - replaced "db_name" file in html_user, html_ops directories with
        "config.xml", which contains download URL as well as DB name/passwd
    - got rid of "install" target in main Makefile

    Makefile.in
    client/
        Makefile.in
    doc/
        data_server_setup.html
        single_host_server.html
    html_ops/
        util.inc
    html_user/
        db.inc
        download.php
        index.php
        login.inc
        login_action.php
        util.inc
    sched/
        file_upload_handler.C
        handle_request.C
    test/
        test.inc
        test_uc.php
    tools/
        process_result_template.C

David  Nov 9 2002
    - Simplified account creation.
        Only screen name, email address required; country, zip optional.
        Only account ID required to log in
        Removed web password from form;
        projects can add this if they want.
    - Change "authenticator" to "account ID" everywhere
    - made country list appear on account creation form

    todo
    db/
        constraints.sql
        db.h
    doc/
        account.html
        app.html
        create_project.html
        participate.html
        startup.html
    html_user/
        renamed create_account.php to create_account_form.php
        renamed login.php to login_form.php
        download.php
        index.php
        login_action.php
        util.inc
    test/
        test_uc.php

Eric  Nov 12, 2002
    - X11 graphics support added
    - upper_case_x11 target added
    - configure now checks for pthread, gl libraries

    configure
    configure.in
    api/
        boinc_api.C
        graphics_api.C
        x_opengl.C,h (added)
    apps/
        upper_case.C
        Makefile.in

Eric  Nov 14, 2002
    - windows screensaver module

    api/
        boinc_api.C
        graphics_api.C
        windows_opengl.cpp
    client/
        win/
            win_screensaver.cpp (added)
    win_build/
        boinc.dsw
        boinc_ss/ (added)
            boinc_ss.dsp (added)

Seth/Eric  Nov 18, 2002
    - windows idle detection
    - Communication to app for suspend/resume/quit

    api/
        boinc_api.C,h
        windows_opengl.cpp
    client/
        app.C
        client_state.C,h
        prefs.C,h
        win/
            win_screensaver.cpp
            wingui.cpp,h
            win_idle_tracker.cpp,h,def (added)
    win_build/
        boinc.dsw
        boinc_dll/ (added)
            boinc_dll.dsp (added)
        boinc_gui/
            boinc_gui.dsp

David   Nov 30 2002
    - use the major/minor version from env vars to identify the core client
        (rather than the single version in Makefile)

    client/
        Makefile.in
        client_state.C,h
        cs_scheduler.C

David   Nov 30 200
    - first part of work sequence implementation

    db/
        schema.sql
        db.h
        db_mysql.C
David   Dec 1 2002
    - If request to scheduling server is from client with wrong version,
        return an error
    - Change the file upload handler protocol a little:
        1) add core client version to request
        2) add enclosing <data_server_request> element
    - The file upload handler returns an error if client has wrong version
    - Split up long function in file_upload_handler.C
    - Changed name of feeder trigger file so that it works
        (when did this get broken??)

    client/
        file_xfer.C,h
    doc/
        protocol.html
        upload.html
    sched/
        Makefile.in
        feeder.C
        file_upload_handler.C
        handle_request.C
        server_types.C,h
    test/
        test.inc

David   Dec 3 2002
    - change scheduling server so that by default it doesn't
        store request and reply messages in files;
        add "-use_files" option to do this
    - added validation step to test_uc.php;
        this computes and grants credit
    - added "-one_pass" option to validate
    - split scheduler trigger files into two:
        stop_server: used for all server components;
            NOT deleted after reading
        reread_db: used to tell feeder to reread DB
            deleted after reading
    - added license text to some files

    sched/
        config.C,h
        feeder.C
        handle_request.C
        main.C,h
        make_work.C
        result_retry.C
        sched_shmem.h
        show_shmem.C
        validate.C
    test/
        test.inc
        test_uc.php

David   Dec 5 2002
    - added initial support for aborting runaway applications:
        check for exceeding maximum CPU time or disk usage
    - create_work now takes max_cobblestones and max_disk_usage
    - split ACTIVE_TASK::suspend into separate suspend, resume functions

    A bunch of coding style notes:
    - changed ACTIVE_TASK::request_exit() so that it doesn't sleep.
        ==> The core client should never sleep <==
        This would cause a period of non-response in the GUI client
    - changed file_delete() so that it doesn't sleep or retry.
        Should eventually add garbage-collection mechanism
    - Most functions NEED to be implemented in the client.
        So e.g. instead of
        #if HAVE_SIGNAL_H
            unix code
        #endif
        #ifdef _WIN32
            win code
        #endif
        we should have
        #ifdef _WIN32
            win code
        #else
            unix code
        #endif
        Any compilation that doesn't match anything should cause a
        compile-time error
    - change file_size(), dir_size(), CLIENT_STATE::total_disk_usage() etc.
        so that:
        1) they report file size in double, not int
        2) they return an error code, not a size overloaded with error code;
            size is return in reference param
    - All fopen()s should check for zero pointer and return ERR_FOPEN
    - Omit "this->" wherever it appears

    client/
        app.C,h
        client_state.C,h
        client_types.C,h
        file_xfer.C
        http.C
        pers_file_xfer.C
    lib/
        filesys.C,h
    test/
        test.inc
    tools/
        backend_lib.C,h
        create_work.C

David  Dec 6 2002
    - fix bugs in get_local_ip_addr()
        (need to figure out why they were happening)

Eric   Dec 8, 2002
    - added and tested HTTP proxy support (no SOCKS support yet)
    - proxy server is specified through environment variable HTTP_PROXY

    client/
        client_state.C,h
        http.C,h
        net_xfer.C
        pers_file_xfer.C
        scheduler_op.C

Hamid  Dec 9,2002
    - added field client_state to result

    - added some more functionality to repor_project_error()
      It now adds the following info to stderr_out of the result:

      <message>message if any passed</mesage>
      <active_task_state>%d</active_task_state>
      <exit_status>%d</exit_status>
      <signal>%d</signal>
      if download had failures
         "<download_error>\
          "    <file_name>%s</file_name>
          "    <error_code>%d</error_code>\n"
          "    </download_error>\n"


      if upload  had failures
        same as above

      if coudln't start active task for result (in which err_num should be set)
        "<couldnt_start>%d</couldnt_start>\n"


    - The error mechanism right now is such that any failures
    regarding file_infos (download, upload or whatever)
    are recorded in the status of the file_infos and then garbage collect
    called report_project_error.
    However errors regarding starting and ending active tasks
    are reported from app.C and cs_apps.C.

Seth  Dec 9, 2002
        - time tests run in their own thread when needed, if they are global state
          won't do anything until they are done; threads communicate by a file
        - windows host info complete except for cache

        client/
            client_stat.C,h
            file_names.h
            hostinfo.C,h
        client/win/
            hostinfo_win.cpp

David  Dec 11 2002
    - Have process_wu_template() fill in the file size as well as the MD5.
        This necessitated changing the format of WU templates,
        and the way they are processed.

    NOTE: this breaks the multiple-data-server test.
    Need to figure out another way to do that.

    tools/
        backend_lib.C
    doc/
        tools_work.html
    test/
        *wu

David  Dec 13 2002
    - use lock file mechanism to prevent multiple instances of
       core client from running in same directory

    configure
    configure.in
    client/
        file_names.h
        main.C
    lib/
        util.C,y

David  Dec. 17 2002
    - Added new state fields to workunit and result to support
        file deletion and assimilation backend phases
    - Added sample assimilator program
    - Added file_deleter program (AKA garbage collector)

    client/
        main.C
    db/
        db.h
        db_mysql.C
        schema.sql
    sched/
        Makefile.in
        assimilator.C (new)
        config.C,h
        result_retry.C
        validate.C
    test/
        test.inc
    tools/
        backend_lib.C

David   Dec 17 2002
    - The assimilator takes a -app argument
    - Added execution of file_delete and assimilator to test_uc.php
        this should delete all input and output files
        TODO: check that it actually does
    - fixed bugs in file_deleter

    todo
    db/
        db.h
        db_mysql.C
    doc/
        backend.gif (new)
        backend.html
        backend.png (new)
        work_states.html
    html_ops/
        db.inc
    html_user/
        user.inc
    sched/
        assimilator.C
        file_deleter.C
        handle_request.C
    test/
        test.inc
        test_uc.php

Seth Dec 18 2002
        - net_xfers in windows will get permission before connecting if needed
        - added global pref for whether or not to hang up the modem if BOINC dialed
        - client state saves global prefs confirm_before_connecting
        and hangup_if_dialed locally for now
        - wingui split into different files, bug fixes

        client/
                net_xfer.C,h
                prefs.C,h
                client_state.C
        client/win
                win_net.cpp,h
                wingui.cpp,h
                wingui_mainwindow.cpp,h (new)
                wingui_dialog.cpp,h (new)
                wingui_listctrl.cpp,h (new)
                wingui_pictrl.cpp,h (new)

David  Dec 18 2002
    - Have account create action redirect to a different page
        so you don't get "Repost form data" if you go back to it
    - Added full support for project-specific preferences.
        Logic is encapsulated in project_specific_prefs.inc.
        The example lets you choose color scheme
        (Tahiti Sunset, Desert Sands)

    html_user/
        account_created.php (new)
        project_specific_prefs.inc (new)
        create_account_action.php
        prefs.inc
        prefs.php
        prefs_edit_global_form.php
        prefs_edit_project_action.php
        prefs_edit_project_form.php
        util.inc
    lib/
        countries.C,h

David   Dec 19 2002
    - The Edit Account form now shows current values
        directly in input fields.
    - Country select popup shows current value
    - Improve new account email

    html_user/
        account_created.php
        change_pass_action.php
        create_account_action.php
        edit.inc
        edit_action.php
        edit_user_info.php
        util.inc
    tools/
        country_select.C

Hamid   Dec 19 2002

    -Edited make_work.C, now when a new work_unit is created,
        it's input files are copied along with it,
        with some random numbers added to the end,
        so for each new work_unit there are a set of associated new input files

    -fixed a little bug in file_deleter

    -note: strtok() changes the original string passed to it, kind of dangerous to use

    -from parse.h : replace_element() is now in use ( I used it for make_work.C)

David  Dec 19 2002
    - added -add_new_project option to command line version
        changed func name from get_initial_project() to add_new_project()

    client/
        account.C,h
        client_state.C,h
        main.C
        scheduler_op.h
    win/
        wingui.cpp,h

David   Dec 23 2002
    - Made stripcharts work with BOINC test framework
        The script "test_loop.php" now generates a data file of
        CPU load that can be graphed using stripchart.
        TODO: add other data sources
    - added "country" field to team
    - expanded team description from 256 chars to blob
    - turned off debug output from file upload handler, scheduler
    - removed "time" args from various Project member functions
        in test.inc.  Use sleep().

    db/
        db.h
        db_mysql.C
        schema.sql
    html_user/
        db.inc
        team_create_form.php
    sched/
        file_upload_handler.C
        handle_request.C
        result_retry.C
    stripchart/
        stripchart.cgi
        stripchart.cnf
        samples/
            datafiles
    test/
        test.inc
        test_download_backoff.php
        test_loop.php
        test_masterurl_failure.php
        test_sched_failure.php