| | 1 | = xadd - tool for adding database items = |
| | 2 | |
| | 3 | '''xadd''' adds platform and application records to the BOINC database. Information is read from an XML file '''project.xml''' in the project's root directory. Run xadd from the project root directory, i.e.: |
| | 4 | |
| | 5 | {{{ |
| | 6 | cd ~/projects/project_name |
| | 7 | bin/xadd |
| | 8 | }}} |
| | 9 | |
| | 10 | The contents of '''project.xml''' should look like this: |
| | 11 | |
| | 12 | {{{ |
| | 13 | <boinc> |
| | 14 | <app> |
| | 15 | <name>setiathome</name> |
| | 16 | <user_friendly_name>SETI@home</user_friendly_name> |
| | 17 | [ <beta>1</beta> ] |
| | 18 | </app> |
| | 19 | ... |
| | 20 | <platform> |
| | 21 | <name>anonymous</name> |
| | 22 | <user_friendly_name>anonymous</user_friendly_name> |
| | 23 | </platform> |
| | 24 | <platform> |
| | 25 | <name>i686-pc-linux-gnu</name> |
| | 26 | <user_friendly_name>Linux/x86</user_friendly_name> |
| | 27 | </platform> |
| | 28 | <platform> |
| | 29 | <name>windows_intelx86</name> |
| | 30 | <user_friendly_name>Windows/x86</user_friendly_name> |
| | 31 | </platform> |
| | 32 | <platform> |
| | 33 | <name>powerpc-apple-darwin</name> |
| | 34 | <user_friendly_name>Mac OS X</user_friendly_name> |
| | 35 | </platform> |
| | 36 | ... |
| | 37 | </boinc> |
| | 38 | }}} |
| | 39 | |
| | 40 | The "name" of each item should be short and without spaces or other special characters. The "user friendly name" (shown to end users) has no restrictions. An example project.xml file is in source/tools/. |
| | 41 | |
| | 42 | `xadd` only adds new items; entries that conflict with existing database entries are ignored. |
