*** empty log message ***

svn path=/trunk/boinc/; revision=11088
This commit is contained in:
David Anderson 2006-09-02 23:40:05 +00:00
parent 2e01b2b0a4
commit 53756e2cb4
2 changed files with 28 additions and 25 deletions

View File

@ -5,7 +5,7 @@
<meta http-equiv="Content-Style-Type" content="text/css">
<title></title>
<meta name="Generator" content="Cocoa HTML Writer">
<meta name="CocoaVersion" content="824.39">
<meta name="CocoaVersion" content="824.41">
<style type="text/css">
p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; text-align: center; font: 14.0px Helvetica}
p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
@ -31,7 +31,7 @@
<p class="p1"><b>Building BOINC Clients and Applications on Macintosh OSX</b></p>
<p class="p2"><br></p>
<p class="p3">Written by Charlie Fenton</p>
<p class="p3">Last updated 6/28/06</p>
<p class="p3">Last updated 9/2/06</p>
<p class="p2"><br></p>
<p class="p4">This document applies to BOINC version 5.5.4 and later.<span class="Apple-converted-space">  </span>It has instructions for building BOINC for Macintosh OSX, plus information for building science project applications to run under BOINC on Macintosh OSX. <span class="Apple-converted-space"> </span></p>
<p class="p2"><br></p>
@ -170,14 +170,14 @@
<p class="p5">cd {path}/BOINC_dev/boinc/</p>
<p class="p5">source {path}/BOINC_dev/boinc/mac_installer/release_boinc.sh x y z</p>
<p class="p2"><br></p>
<p class="p4">Substitute the 3 parts of the BOINC version number for x y and z in the above.<span class="Apple-converted-space">  </span>For example, to build the installer for BOINC version 5.4.0, the command would be</p>
<p class="p5">source {path}/BOINC_dev/boinc/mac_installer/release_boinc.sh 5 4 0</p>
<p class="p4">This will create a directory "BOINC_Installer/New_Release_5_3_19" in the BOINC_dev directory.</p>
<p class="p4">Substitute the 3 parts of the BOINC version number for x y and z in the above.<span class="Apple-converted-space">  </span>For example, to build the installer for BOINC version 5.5.4, the command would be</p>
<p class="p5">source {path}/BOINC_dev/boinc/mac_installer/release_boinc.sh 5 5 4</p>
<p class="p4">This will create a directory "BOINC_Installer/New_Release_5_5_4" in the BOINC_dev directory.</p>
<p class="p7"><br></p>
<p class="p4">To build version 5.4.0 of the Grid Republic flavor of BOINC, you would type:<span class="s3"><span class="Apple-converted-space"> </span></span></p>
<p class="p4">To build version 5.5.4 of the Grid Republic flavor of BOINC, you would type:<span class="s3"><span class="Apple-converted-space"> </span></span></p>
<p class="p5">cd {path}/BOINC_dev/boinc/</p>
<p class="p5">source {path}/BOINC_dev/boinc/mac_installer/release_GridRepublic.sh 5 4 0</p>
<p class="p4">This will create a directory "BOINC_Installer/New_Release_GR_5_3_19" in the BOINC_dev directory.</p>
<p class="p5">source {path}/BOINC_dev/boinc/mac_installer/release_GridRepublic.sh 5 5 4</p>
<p class="p4">This will create a directory "BOINC_Installer/New_Release_GR_5_5_4" in the BOINC_dev directory.</p>
<p class="p6"><br></p>
<p class="p2"><br></p>
<p class="p1"><b>Debugging and BOINC security</b></p>

View File

@ -1,8 +1,7 @@
{\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf390
{\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf410
{\fonttbl\f0\fswiss\fcharset77 Helvetica-Bold;\f1\fswiss\fcharset77 Helvetica;\f2\fswiss\fcharset77 Helvetica-Oblique;
\f3\fmodern\fcharset77 Courier;\f4\fnil\fcharset77 LucidaGrande;}
{\colortbl;\red255\green255\blue255;\red0\green0\blue239;\red0\green0\blue0;\red78\green0\blue124;
}
{\colortbl;\red255\green255\blue255;\red0\green0\blue239;\red78\green0\blue124;}
\margl1440\margr1440\vieww13420\viewh8680\viewkind0
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qc
@ -12,7 +11,7 @@
\f1\b0\fs24 \cf0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qc
\cf0 Written by Charlie Fenton\
Last updated 6/28/06\
Last updated 9/2/06\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
\cf0 \
This document applies to BOINC version 5.5.4 and later. It has instructions for building BOINC for Macintosh OSX, plus information for building science project applications to run under BOINC on Macintosh OSX. \
@ -245,26 +244,26 @@ source \{path\}/BOINC_dev/boinc/mac_installer/release_boinc.sh x y z\
\f1\fs24 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
\cf0 Substitute the 3 parts of the BOINC version number for x y and z in the above. For example, to build the installer for BOINC version 5.4.0, the command would be\
\cf0 Substitute the 3 parts of the BOINC version number for x y and z in the above. For example, to build the installer for BOINC version 5.5.4, the command would be\
\pard\pardeftab720\ql\qnatural
\f3\fs26 \cf0 source \{path\}/BOINC_dev/boinc/mac_installer/release_boinc.sh 5 4 0\
\f3\fs26 \cf0 source \{path\}/BOINC_dev/boinc/mac_installer/release_boinc.sh 5 5 4\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
\f1\fs24 \cf0 This will create a directory "BOINC_Installer/New_Release_5_3_19" in the BOINC_dev directory.
\f1\fs24 \cf0 This will create a directory "BOINC_Installer/New_Release_5_5_4" in the BOINC_dev directory.
\f3 \
\
\f1 To build version 5.4.0 of the Grid Republic flavor of BOINC, you would type:
\f1 To build version 5.5.4 of the Grid Republic flavor of BOINC, you would type:
\f3
\f1 \
\pard\pardeftab720\ql\qnatural
\f3\fs26 \cf0 cd \{path\}/BOINC_dev/boinc/\
source \{path\}/BOINC_dev/boinc/mac_installer/release_GridRepublic.sh 5 4 0\
source \{path\}/BOINC_dev/boinc/mac_installer/release_GridRepublic.sh 5 5 4\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
\f1\fs24 \cf0 This will create a directory "BOINC_Installer/New_Release_GR_5_3_19" in the BOINC_dev directory.
\f1\fs24 \cf0 This will create a directory "BOINC_Installer/New_Release_GR_5_5_4" in the BOINC_dev directory.
\f3 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
@ -280,9 +279,9 @@ source \{path\}/BOINC_dev/boinc/mac_installer/release_GridRepublic.sh 5 4 0\
\cf0 \
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
\cf0 Version 5.5.4 of BOINC Manager for the Macintosh introduced new, stricter security measures. For details, please see the file boinc/mac_installer/Readme.rtf and {\field{\*\fldinst{HYPERLINK "http://boinc.berkeley.edu/sandbox.php"}}{\fldrslt http://boinc.berkeley.edu/sandbox.php}} \
\cf3 \
\
\pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\tx10560\tx11520\tx12480\tx13440\tx14400\tx15360\tx16320\tx17280\tx18240\tx19200\tx20160\tx21120\tx22080\tx23040\tx24000\tx24960\tx25920\tx26880\tx27840\tx28800\tx29760\tx30720\tx31680\tx32640\tx33600\tx34560\tx35520\tx36480\tx37440\tx38400\tx39360\tx40320\tx41280\tx42240\tx43200\tx44160\tx45120\tx46080\tx47040\tx48000\tx48960\tx49920\tx50880\tx51840\tx52800\tx53760\tx54720\tx55680\tx56640\tx57600\tx58560\tx59520\tx60480\tx61440\tx62400\tx63360\tx64320\tx65280\tx66240\tx67200\tx68160\tx69120\tx70080\tx71040\tx72000\tx72960\tx73920\tx74880\tx75840\tx76800\tx77760\tx78720\tx79680\tx80640\tx81600\tx82560\tx83520\tx84480\tx85440\tx86400\tx87360\tx88320\tx89280\tx90240\tx91200\tx92160\tx93120\tx94080\tx95040\tx96000\ql\qnatural\pardirnatural
\cf3 \CocoaLigature0 The GDB debugger can't attach to applications which are running as a diferent user or group so it ignores the S_ISUID and S_ISGID permisison bits when launching an application. To work around this, BOINC does not use the special boinc_master or boinc_project users or groups when run from XCode. \
\cf0 \CocoaLigature0 The GDB debugger can't attach to applications which are running as a diferent user or group so it ignores the S_ISUID and S_ISGID permisison bits when launching an application. To work around this, BOINC does not use the special boinc_master or boinc_project users or groups when run from XCode. \
\
The
\f2\i Development
@ -336,7 +335,7 @@ So it is important to make a native Intel application available as soon as possi
It is very easy to add a new platform to your server with the xadd utility. For directions on how to do this, see these web pages:\
\pard\pardeftab720\ql\qnatural
{\field{\*\fldinst{HYPERLINK "http://boinc.berkeley.edu/platform.php"}}{\fldrslt
\f3\fs26 \cf4 \ul \ulc4 http://boinc.berkeley.edu/platform.php}}
\f3\fs26 \cf3 \ul \ulc3 http://boinc.berkeley.edu/platform.php}}
\f3\fs26 \
\pard\pardeftab720\ql\qnatural
{\field{\*\fldinst{HYPERLINK "http://boinc.berkeley.edu/tool_xadd.php"}}{\fldrslt \cf2 \ul http://boinc.berkeley.edu/tool_xadd.php}}
@ -395,24 +394,28 @@ There is an optional api setMacIcon() in the libboinc_api.a library. This allow
\cf0 (1)Use "/Developer/Applications/utilities/Icon Composer.app" to create a xxx.icns file. (Use any name you wish instead of xxx.)\
\
(2) Convert the xxx.icns file to an app_icon.h file as follows: in Terminal, run: \
\pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\tx10560\tx11520\tx12480\tx13440\tx14400\tx15360\tx16320\tx17280\tx18240\tx19200\tx20160\tx21120\tx22080\tx23040\tx24000\tx24960\tx25920\tx26880\tx27840\tx28800\tx29760\tx30720\tx31680\tx32640\tx33600\tx34560\tx35520\tx36480\tx37440\tx38400\tx39360\tx40320\tx41280\tx42240\tx43200\tx44160\tx45120\tx46080\tx47040\tx48000\tx48960\tx49920\tx50880\tx51840\tx52800\tx53760\tx54720\tx55680\tx56640\tx57600\tx58560\tx59520\tx60480\tx61440\tx62400\tx63360\tx64320\tx65280\tx66240\tx67200\tx68160\tx69120\tx70080\tx71040\tx72000\tx72960\tx73920\tx74880\tx75840\tx76800\tx77760\tx78720\tx79680\tx80640\tx81600\tx82560\tx83520\tx84480\tx85440\tx86400\tx87360\tx88320\tx89280\tx90240\tx91200\tx92160\tx93120\tx94080\tx95040\tx96000\ql\qnatural\pardirnatural
\f3 \{path\}/MakeAppIcon_h \{source_file_path\}/
\f3 \cf0 \{path\}/MakeAppIcon_h \{source_file_path\}/
\f1 xxx.icns
\f3 \{dest_file_path\}/
\f1 app_icon.h
\f3 \
\pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\tx10560\tx11520\tx12480\tx13440\tx14400\tx15360\tx16320\tx17280\tx18240\tx19200\tx20160\tx21120\tx22080\tx23040\tx24000\tx24960\tx25920\tx26880\tx27840\tx28800\tx29760\tx30720\tx31680\tx32640\tx33600\tx34560\tx35520\tx36480\tx37440\tx38400\tx39360\tx40320\tx41280\tx42240\tx43200\tx44160\tx45120\tx46080\tx47040\tx48000\tx48960\tx49920\tx50880\tx51840\tx52800\tx53760\tx54720\tx55680\tx56640\tx57600\tx58560\tx59520\tx60480\tx61440\tx62400\tx63360\tx64320\tx65280\tx66240\tx67200\tx68160\tx69120\tx70080\tx71040\tx72000\tx72960\tx73920\tx74880\tx75840\tx76800\tx77760\tx78720\tx79680\tx80640\tx81600\tx82560\tx83520\tx84480\tx85440\tx86400\tx87360\tx88320\tx89280\tx90240\tx91200\tx92160\tx93120\tx94080\tx95040\tx96000\ql\qnatural\pardirnatural
\f1 (The MakeAppIcon_h command-line utility is built by the Mac boinc XCode project in the "boinc/mac_build/build/" directory.) Add the app_icon.h file to your science application's project.\
\f1 \cf0 (The MakeAppIcon_h command-line utility is built by the Mac boinc XCode project in the "boinc/mac_build/build/" directory.) Add the app_icon.h file to your science application's project.\
\
(3) In the science application's main(), add \
\pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\tx10560\tx11520\tx12480\tx13440\tx14400\tx15360\tx16320\tx17280\tx18240\tx19200\tx20160\tx21120\tx22080\tx23040\tx24000\tx24960\tx25920\tx26880\tx27840\tx28800\tx29760\tx30720\tx31680\tx32640\tx33600\tx34560\tx35520\tx36480\tx37440\tx38400\tx39360\tx40320\tx41280\tx42240\tx43200\tx44160\tx45120\tx46080\tx47040\tx48000\tx48960\tx49920\tx50880\tx51840\tx52800\tx53760\tx54720\tx55680\tx56640\tx57600\tx58560\tx59520\tx60480\tx61440\tx62400\tx63360\tx64320\tx65280\tx66240\tx67200\tx68160\tx69120\tx70080\tx71040\tx72000\tx72960\tx73920\tx74880\tx75840\tx76800\tx77760\tx78720\tx79680\tx80640\tx81600\tx82560\tx83520\tx84480\tx85440\tx86400\tx87360\tx88320\tx89280\tx90240\tx91200\tx92160\tx93120\tx94080\tx95040\tx96000\ql\qnatural\pardirnatural
\f3 #include "app_icon.h"
\f3 \cf0 #include "app_icon.h"
\f1 \
and call:\
\f3 setMacIcon(argv[0], MacAppIconData, sizeof(MacAppIconData));\
\pard\tx960\tx1920\tx2880\tx3840\tx4800\tx5760\tx6720\tx7680\tx8640\tx9600\tx10560\tx11520\tx12480\tx13440\tx14400\tx15360\tx16320\tx17280\tx18240\tx19200\tx20160\tx21120\tx22080\tx23040\tx24000\tx24960\tx25920\tx26880\tx27840\tx28800\tx29760\tx30720\tx31680\tx32640\tx33600\tx34560\tx35520\tx36480\tx37440\tx38400\tx39360\tx40320\tx41280\tx42240\tx43200\tx44160\tx45120\tx46080\tx47040\tx48000\tx48960\tx49920\tx50880\tx51840\tx52800\tx53760\tx54720\tx55680\tx56640\tx57600\tx58560\tx59520\tx60480\tx61440\tx62400\tx63360\tx64320\tx65280\tx66240\tx67200\tx68160\tx69120\tx70080\tx71040\tx72000\tx72960\tx73920\tx74880\tx75840\tx76800\tx77760\tx78720\tx79680\tx80640\tx81600\tx82560\tx83520\tx84480\tx85440\tx86400\tx87360\tx88320\tx89280\tx90240\tx91200\tx92160\tx93120\tx94080\tx95040\tx96000\ql\qnatural\pardirnatural
\f1 \
\f1 \cf0 \
(4) The science application must link with Carbon.framework to use \CocoaLigature1 setMacIcon()\CocoaLigature0 .\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
\cf0 \CocoaLigature1 \