Vm-dev May 2016

vm-dev@lists.squeakfoundation.org

36 participants
150 discussions

Re: [Vm-dev] Ephemerons and VM crash
by Guille Polito 01 Jun '16

01 Jun '16

Hi again! I snip most of the old thread to keep the relevant. -------- Original Message -------- > 1 - The mourn table is being collected because it is not marked upon > creation > > =============== > > I decided to move the assignment of marking out into markObjects: Ok, it looks good for me, I did not know what would be a good place to put them without breaking something :) > > > 2 - Accesses to unscannedEphemerons are unaligned > =============== > > Looks good. I've changed all the ephemeron methods to use > bytesPerOop, cuz the ephemeron queue contains oops, but your fix is > just as good. cool! I thought so that would be the best. > > > > 3 - While debugging I also had a DNU #intAt: in #primitiveIntegerAt > ========================== > > Question: besides reviewing, how should I commit these fixes? one > issue per commit? all at once? > > > Typically all at once. What I try and do is commit a large set of > related changes in a single commit, so I wouldn't mix the fixes to > ephemerons with, say, fixes to time. But equally I'd commit any > changes I made to help debugging in the same commit. And all rules > are made to be broken ;-). ok! > > Hey, _thank you_! This is really great and ephemerons won't be > usable without testing like this. I'm in your debt. Ha, there is no debt (or at least it would be in the opposite direction). Now I'm working on another crash that I can easily reproduce using this script: Smalltalk supportsQueueingFinalization: true. e := (1 to: 200000) collect: [ :i | Ephemeron key: (ObjectFinalizer receiver: 'test', 'asd' selector: #logCr) value: Object new ]. Smalltalk garbageCollect. While debugging that in the simulator, we saw with clement that during #fireEphemeronsInRememberedSet, #fireEphemeronsOnEphemeronList we are always firing, tenuring and scavenging ephemerons regardless they are marked or not. fireEphemeronsInRememberedSet [SNIP] coInterpreter fireEphemeron: ephemeron. manager storePointerUnchecked: 0 ofObject: ephemeron withValue: (self copyAndForward: (manager keyOfEphemeron: ephemeron)). (self scavengeReferentsOf: ephemeron) [SNIP] So I put an assertion to check that the key of the ephemeron is marked when scavenging and it is not always the case... self assert: (manager isMarked: (manager keyOfEphemeron: ephemeron)). Is the code wrong? or I'm missing something? Guille > > > Guille > > -------- Original Message -------- >> I see, I probably I need to leave the simulator run for a longer >> time... Because running the image using the assertion VM took >> some time to crash, it may be the same case. >> >> -------- Original Message -------- >>> Some advance on my side, >>> >>> - Yes, apparently the image was already broken. I started a new >>> one and I can open it with the simulator. It seems that as soon >>> as I activate Ephemerons and I have alive ephemerons the heap >>> corrupts (and since saving the image fires a gc...). >>> >>> - Then, to catch the moment where the image breaks, I prepared >>> my image for debug with the following script: >>> >>> Smalltalk snapshotPrimitive. >>> f := ObjectFinalizer receiver: 'Hello' selector: #logCr. >>> d := EphemeronDictionary new. >>> d at: f put: f. >>> f := nil. >>> Smalltalk supportsQueueingFinalization: true. >>> 1 to: 2 do: [ :i | Smalltalk garbageCollect]. >>> >>> Then I opened it with the simulator (latest version: >>> VMMaker.oscog-tfel.1864) and I had several assertion failures in >>> >>> keyOfEphemeron: objOop >>> "Answer the object the ephemeron guards. This is its first >>> element." >>> self assert: ((self isNonImmediate: objOop) and: [self >>> isEphemeron: objOop]). >>> ^self fetchPointer: 0 ofObject: objOop >>> >>> followedKeyOfEphemeron: objOop >>> "Answer the object the ephemeron guards. This is its first >>> element." >>> self assert: ((self isNonImmediate: objOop) and: [self >>> isEphemeron: objOop]). >>> ^self followOopField: 0 ofObject: objOop >>> >>> So, I noticed the following: >>> >>> - Ephemerons in the unscanned list are marked, fired, and the >>> format of ephemerons is changed to a non-ephemeron format >>> - But they are not removed from the unscanned list >>> - then the mark #markAllUnscannedEphemerons fails tons of >>> assertions because it expects ephemeron objects and the >>> (not-anymore-)ephemeron is still there in the unscanned list >>> >>> self markInactiveEphemerons ifFalse: >>> [self fireAllUnscannedEphemerons]. >>> self markAllUnscannedEphemerons >>> >>> The strange thing is that if I ignore the assertions by >>> proceeding, the thing continues normally and it the image does >>> not break... >>> >>> So I then compiled the VM, with the latest version, and in trace >>> mode to compare. I attach the log of the stdout. But here there >>> is a résumé >>> >>> * First I see the same assertions I saw in the simulator >>> >>> (isNonImmediate(objOop)) && (isEphemeron(objOop)) 41155 >>> >>> (isNonImmediate(objOop)) && (isEphemeron(objOop)) 55477 >>> >>> * Then there are tons of repetitions of the same assertion: >>> >>> !(((GIV(mournQueue) != GIV(nilObj)) && >>> (isonObjStack(anEphemeronOrWeakArray, GIV(mournQueue))))) 60030 >>> >>> Which I understand it means that we are adding to the mourn >>> queue all the time the same object. Which is strange because it >>> is a WeakArray with a single slot which turns out to be nil (at >>> least at the moment I inspected it). >>> >>> * Then something breaks (!!) Looks like we are trying to mark a >>> forwarder. And then I have a follow up of assertions which are >>> probably caused by the same thing. >>> >>> !(isForwarded(field)) 49489 >>> >>> (classIndexOf(objToScan)) > (isForwardedObjectClassIndexPun()) 49537 >>> >>> (classIndex <= (tagMask())) || (classIndex >= >>> (arrayClassIndexPun())) 49403 >>> >>> objCouldBeClassObj(classObj) 49415 >>> >>> addressCouldBeOop(objOop) 59997 >>> >>> addressCouldBeObj(topOfObjStack((0 == >>> (fetchPointerofObject(ObjStackTopx, objStack)) ? >>> fetchPointerofObject(ObjStackNextx, objStack) : objStack))) 60002 >>> >>> addressCouldBeOop(objOop) 59997 >>> >>> * Finally there are some more >>> >>> !(isForwarded(field)) 49489 >>> >>> until a segmentation fault arrives while executing a fullGC >>> >>> ../results/pharo[0x80ceaa4] >>> ../results/pharo[0x80cfde4] >>> ../results/pharo(fullGC+0x9b)[0x80c95ea] >>> ../results/pharo[0x80e2d49] >>> ../results/pharo[0x80e5f4a] >>> ../results/pharo[0x80ebca3] >>> ../results/pharo(ceStackOverflow+0xd7)[0x809356a] >>> [0x91002c6] >>> ../results/pharo(interpret+0x128)[0x8082b38] >>> ../results/pharo(main+0x23a)[0x810a7db] >>> /lib/i386-linux-gnu/i686/cmov/libc.so.6(__libc_start_main+0xf3)[0xf73b5a63] >>> [0x1000] >>> >>> I'll continue digging a bit more, >>> Guille >>> >>> -------- Original Message -------- >>>> Hi Guille, >>>> >>>> On Thu, May 19, 2016 at 12:53 AM, Guille Polito >>>> <guillermopolito(a)gmail.com <mailto:guillermopolito@gmail.com>> >>>> wrote: >>>> >>>> >>>> >>>> -------- Original Message -------- >>>>> Hi Guille, >>>>> >>>>> On Wed, May 18, 2016 at 12:46 AM, Guille Polito >>>>> <guillermopolito(a)gmail.com >>>>> <mailto:guillermopolito@gmail.com>> wrote: >>>>> >>>>> Hello, >>>>> >>>>> -------- Original Message -------- >>>>>> >>>>>> >>>>>> >>>>>> Hi Guille, Hi Pablo (and welcome), >>>>>> >>>>>> On Tue, May 17, 2016 at 8:37 AM, Guille Polito >>>>>> <guillermopolito(a)gmail.com >>>>>> <mailto:guillermopolito@gmail.com>> wrote: >>>>>> >>>>>> >>>>>> Hi Eliot, list >>>>>> >>>>>> I'm working here with Pablo (Tesone) on moving >>>>>> forward the Ephemeron implementation. >>>>>> >>>>> >>>>> >>>>> Where's "here"? Are you in Lille? >>>> Yup. Pablo is a new Phd student here :) >>>>> >>>>> >>>>>> We first installed Eliot's changeset, added a >>>>>> #mourn method and an EphemeronDictionary >>>>>> collection, and then started testing something >>>>>> like this: >>>>>> >>>>>> f := ObjectFinalizer receiver: 'Hello' selector: >>>>>> #logCr. >>>>>> d := EphemeronDictionary new. >>>>>> >>>>>> d at: f put: f. >>>>>> >>>>>> f := nil. >>>>>> Smalltalk garbageCollect. >>>>>> >>>>>> >>>>>> So this looks like something simulate able. Are you >>>>>> able to use the simulator? If not, why not? >>>>> >>>>> For some reason I have that bytesToShift when opening >>>>> the image is negative. >>>>> >>>>> >>>>> That is to be expected. In the real VM the heap is >>>>> located somewhere well above the bottom of the address >>>>> space, typically above the program code. In the simulator >>>>> the heap is located either at 0 (an interpreter or stack >>>>> VM) or immediately above the code zone (in a Cogit VM). >>>>> So when an image that has been saved on the real VM is >>>>> loaded into the simulator all oops have to be adjusted >>>>> down and hence bytesToShift is negative. >>>>> >>>>> >>>>> bytesToShift := objectMemory >>>>> memoryBaseForImageRead - oldBaseAddr. "adjust pointers >>>>> for zero base address" >>>>> >>>>> So I cannot continue loading because addresses become >>>>> negative and I have "Improper Store into indexable >>>>> object kind of errors". >>>>> >>>>> >>>>> Can you post a back trace? Where is this happening? >>>> I'm working in latest pharo (5.0), using the same source >>>> code that is used in the Pharo CI jobs to build the VM >>>> (pharo branded). I would expect this branch to be stable, >>>> maybe it could be a bit behind your branch of development, >>>> but I think Esteban merges regularly. >>>> >>>> >>>> Esteban is very busy trying to get UFFI working, and having >>>> just got Pharo 5 released and working on Pharo 6 to be >>>> released. I'd prefer it if you used the tip of VMMaker.oscog. >>>> Further, that's the package that Clément is using and he's your >>>> expert source of local help. >>>> >>>> >>>> I'm executing this, >>>> >>>> vm := StackInterpreterSimulator newWithOptions: >>>> #(#ObjectMemory #Spur32BitMemoryManager ). >>>> vm desiredNumStackPages: 8. "Makes simulation faster by >>>> creating fewer stack pages." >>>> (vm openOn: '/home/guille/Pharo/temp/ephemerons/broken.image') >>>> openAsMorph; run. >>>> >>>> And here is the trace. The error happens while swizzling. >>>> >>>> LittleEndianBitmap(Object)>>error: >>>> LittleEndianBitmap(Object)>>errorImproperStore >>>> LittleEndianBitmap(Object)>>at:put: >>>> Spur32BitMMLESimulator>>longAt:put: >>>> Spur32BitMMLESimulator(SpurMemoryManager)>>swizzleFieldsOfObject: >>>> Spur32BitMMLESimulator(SpurMemoryManager)>>adjustAllOopsBy: >>>> Spur32BitMMLESimulator(SpurMemoryManager)>>initializeObjectMemory: >>>> StackInterpreterSimulatorLSB(StackInterpreter)>>initializeInterpreter: >>>> [ self initializeInterpreter: bytesToShift ] in >>>> StackInterpreterSimulatorLSB(StackInterpreterSimulator)>>openOn:extraMemory: >>>> in Block: [ self initializeInterpreter: bytesToShift ] >>>> >>>> >>>> So the image is presumably already broken? Looks to me like >>>> it was corrupted when saved. Can you reproduce the problem >>>> that led to this image being broken from a working image? >>>> >>>>> What version of VMMaker.oscog are you using? >>>> Monticello reports VMMaker.oscog-eem.1855. >>>> However, I'm not sure I have the right number, because >>>> source code is now in git. >>>> >>>> >>>> It would be so great if you could use Monticello, not git, and >>>> hence be able to contribute back. >>>> >>>>> Are you running in Pharo or Squeak? If you're in Lille >>>>> you could perhaps visit Clément's office and get him to >>>>> take a look. Clément, would that be ok? >>>> I'll maybe see it with clement, but today I have to work on >>>> some other project... >>>>> >>>>>> When debugging the VM there are two main levels of >>>>>> support, one is the simulator where there is maximum >>>>>> support for debugging: >>>>>> - asserts on all the time >>>>>> - arbitrary breakpoints >>>>>> - attempting every GC in a copy of the heap before >>>>>> doing the real GC so that bugs in the GC can be >>>>>> investigated without needing to construct a >>>>>> reproducible case after a crash >>>>>> - the Smalltalk environment to inspect and browse >>>>>> >>>>>> The next level is the assert and debug VMs. If you >>>>>> look in the build directories on the Cog svn branch >>>>>> you'll see that all of them build three VMs, a >>>>>> production VM with maximum optimisation and asserts >>>>>> excluded, an assert VM with -O1 and asserts enabled, >>>>>> and a debug VM with -O0 and asserts enabled. So if >>>>>> you either don't see the bug in the simulator, or the >>>>>> simulator is too slow for the case being examined, or >>>>>> if the bug doesn't show up in the simulator (the >>>>>> worst of all worlds), build both assert and debug VMs >>>>>> and run with the assert VM first. >>>>>> >>>>> Well so far we were using a VM compiled for debug with >>>>> a graphical C debugger. It was not so bad. However, I >>>>> cannot say I'm missing a better debugger. >>>>> >>>>> >>>>> "Compiled for debug" is vague. Do you mean it is compiled >>>>> with -g -O0, or in addition is compiled with -g -O0 >>>>> -DDEBUGVM=0 -DNDEBUG=1? >>>> That would exactly be: >>>> >>>> { '-g3'. >>>> '-O0'. >>>> '-msse2'. >>>> '-D_GNU_SOURCE'. >>>> '-DITIMER_HEARTBEAT=1'. >>>> '-DNO_VM_PROFILE=1'. >>>> '-DDEBUGVM=1'. >>>> '-DNDEBUG' } >>>> >>>> And Esteban told me to compile it with '-UNDEBUG' to get >>>> more information, but I did not try this yet. >>>> >>>> >>>> Yes. NDEBUG is what turns off asserts. You don't have a >>>> proper assert or debug VM unless you do not use -NDEBUG. >>>> >>>> Thanks! >>>> >>>>>> Note that there is a heap leak checker which can be >>>>>> enabled both in the simulator and the assert and >>>>>> debug VMs. See the checkForLeaks method and the >>>>>> -leakcheck argument. >>>>> >>>>> ok! >>>>>> >>>>>> Without the simulator or the assert and debug VMs you >>>>>> are flying blind. It is /really/ productive to use >>>>>> the simulator for debugging, provided the bug is >>>>>> reproducible within a short amount of time, as for >>>>>> example your case is above. >>>>> >>>>> Ok, gotcha! By this afternoon I'll have some news >>>>> probably. >>>>> >>>>> Thanks a lot! >>>>> >>>>>> >>>>>> >>>>>> >>>>>> >>>>>> However, as soon as we garbage collect twice, we >>>>>> have a VM crash. We started debugging the VM to >>>>>> see if we could have some more clues. >>>>>> >>>>>> The first thing we noticed is that the first time >>>>>> the GC runs, the mournQueue is nil. This is of >>>>>> course expected because the new finalization >>>>>> mechanism was not active and then there was no >>>>>> need to create the mournQueue. We saw that the >>>>>> mournQueue is actually created in a lazy fashion >>>>>> when putting queuing a mourned object (I refer >>>>>> myself to #queueMourner: and >>>>>> #ensureRoomOnObjStackAt:). So the second time the >>>>>> GC passes, the mournQueue is there. So far ok, >>>>>> but still crashing. >>>>>> >>>>>> The crash happens in the call to >>>>>> >>>>>> markAndTraceObjStackandContents(GIV(mournQueue), 1); >>>>>> >>>>>> after the >>>>>> >>>>>> if (!markAndTraceContents) { >>>>>> return; >>>>>> } >>>>>> >>>>>> But when understanding why, it starts being less >>>>>> clear to us :). We used the printObjStack() >>>>>> function and we saw that: >>>>>> >>>>>> call printObjStack(markStack) >>>>>> call printObjStack(weaklingStack) >>>>>> >>>>>> and we saw in the console some output that makes >>>>>> sense. However, printing the mournQueue in the >>>>>> same manner produces some strange output >>>>>> >>>>>> call printObjStack(mournQueue) >>>>>> >>>>>> head 0xb06e980 cx 18 (18) fmt 10 (10) sz 4092 >>>>>> (4092) myx: 4098 (4098) unmkd >>>>>> topx: 14 next: 0x0 free: 0x0 >>>>>> >>>>>> We noticed that free and next are 0x0 while the >>>>>> others are not... >>>>>> >>>>>> Finally we saw there is isValidObjStack(), that >>>>>> gave us the following results: >>>>>> >>>>>> call isValidObjStack(markStack) => 1 >>>>>> >>>>>> call isValidObjStack(weaklingStack) => 0 >>>>>> p objStackInvalidBecause = "marking but page is >>>>>> unmarked" >>>>>> >>>>>> call isValidObjStack(mournQueue) => 0 >>>>>> p objStackInvalidBecause = "marking but page is >>>>>> unmarked" >>>>>> >>>>>> >>>>>> So we assume that the stack creation is wrong? We >>>>>> are a bit lost in here. >>>>>> >>>>>> Guille and Pablo >>>>>> >>>>>> >>>>>> >>>>>> >>>>>> -- >>>>>> _,,,^..^,,,_ >>>>>> best, Eliot >>>>> >>>>> >>>>> >>>>> >>>>> -- >>>>> _,,,^..^,,,_ >>>>> best, Eliot >>>> >>>> >>>> >>>> >>>> -- >>>> _,,,^..^,,,_ >>>> best, Eliot >>> >> > > > > > -- > _,,,^..^,,,_ > best, Eliot

4 7

VM Maker: CMakeVMMakerSqueak-tty.123.mcz
by commits＠source.squeak.org 31 May '16

31 May '16

Timothy M uploaded a new version of CMakeVMMakerSqueak to project VM Maker: http://source.squeak.org/VMMaker/CMakeVMMakerSqueak-tty.123.mcz ==================== Summary ==================== Name: CMakeVMMakerSqueak-tty.123 Author: tty Time: 31 May 2016, 1:58:37.446194 pm UUID: dab66491-fde1-4c7f-8657-fd96bd87f3a6 Ancestors: CMakeVMMakerSqueak-tty.122 All tests green. Refactored some tests. Deleted some Builder tests that properly belong to Configurations. Fixed a bug in CMakeVMakerConfigurationInfo where Abstract Base Class configurations where not accounted for. =============== Diff against CMakeVMMakerSqueak-tty.122 =============== Item was changed: ----- Method: CMakeVMMakerSqueakBuildersTest>>testAllAndNoneBuildTypes (in category 'as yet unclassified') ----- testAllAndNoneBuildTypes + self assert: (SqueakCMakeVMMakerAbstractBuilder allBuildTypes isKindOf: Collection). self assert: (SqueakCMakeVMMakerAbstractBuilder allBuildTypes size > 0). self assert: (SqueakCMakeVMMakerAbstractBuilder noBuildTypes isEmpty). ! Item was removed: - ----- Method: CMakeVMMakerSqueakBuildersTest>>testBuildDirectory (in category 'as yet unclassified') ----- - testBuildDirectory - SqueakCMakeVMMakerAbstractBuilder - subclassesDo:[:builder | - self assert: (builder buildDirectory isString). - self assert:(builder buildDirectory size > 0). - ] - - ! Item was removed: - ----- Method: CMakeVMMakerSqueakBuildersTest>>testSourceDirectoryFor (in category 'as yet unclassified') ----- - testSourceDirectoryFor - SqueakCMakeVMMakerAbstractBuilder - subclassesDo:[:builder | - builder availableBuildConfigurations do:[:configuration | - self assert:((builder sourceDirectoryFor: configuration) isString). - self assert:((builder sourceDirectoryFor: configuration) size > 0)]] - - ! Item was added: + ----- Method: CMakeVMMakerSqueakBuildersTest>>testUnAvailableBuildConfigurations (in category 'as yet unclassified') ----- + testUnAvailableBuildConfigurations + SqueakCMakeVMMakerAbstractBuilder + subclassesDo:[:builder | + self assert: (builder unAvailableBuildConfigurations isKindOf:Collection)] + + ! Item was removed: - ----- Method: CMakeVMMakerSqueakBuildersTest>>testUnavailableBuildConfigurations (in category 'as yet unclassified') ----- - testUnavailableBuildConfigurations - SqueakCMakeVMMakerAbstractBuilder - subclassesDo:[:builder | - self assert: (builder unAvailableBuildConfigurations isKindOf:Collection)] - - ! Item was changed: ----- Method: CMakeVMMakerSqueakCommonConfigTest>>testDirBuildPlatform (in category 'as yet unclassified') ----- testDirBuildPlatform "for each builder, make sure all its configurations provide a dirSource " #(#SqueakMacintoshConfig #SqueakUnixConfig #SqueakWindowsConfig) do:[:each | (Smalltalk at:each) allSubclassesDo:[:configuration | | o | o:= configuration basicNew. self assert:(o dirBuildPlatform isString)]] ! Item was added: + ----- Method: CMakeVMakerConfigurationInfo>>isAbstractBaseClass (in category 'accessing') ----- + isAbstractBaseClass + + ^ isAbstractBaseClass! Item was changed: ----- Method: CMakeVMakerConfigurationInfo>>visit: (in category 'visiting') ----- visit: aVisitor |v| "I am being visited by a CMakeVMMakerSqueak configuration class. Extract its information and store it in myself" self flag:'tty'. "why am I not storing the instances itself?does this visit stuff really make sense? I am thinking its 'lightweight'. hmmm" v:= aVisitor basicNew. (v class isAbstractBaseClass) + ifTrue:[ + isAbstractBaseClass := true. + excludeFromBuild := true] ifFalse:[ availableBuildTypes := v availableBuildTypes. dirBuildPlatform := v dirBuildPlatform. - dirSource := v dirSource. excludeFromBuild := v excludeFromBuild. + isAbstractBaseClass := false]. - isAbstractBaseClass := (v class) isAbstractBaseClass]. ! Item was changed: Object subclass: #SqueakCMakeVMMakerAbstractBuilder instanceVariableNames: 'buildTypeAndDirectoryInfo config' classVariableNames: '' poolDictionaries: '' category: 'CMakeVMMakerSqueak-Builder'! SqueakCMakeVMMakerAbstractBuilder class instanceVariableNames: 'default'! + !SqueakCMakeVMMakerAbstractBuilder commentStamp: 'tty 5/31/2016 09:46' prior: 0! - !SqueakCMakeVMMakerAbstractBuilder commentStamp: 'tty 2/7/2016 08:51' prior: 0! I am an abstract base class for various CMakeVMMakerSqueak builders. I am a singleton. I am a facade to the various Squeak[Platform][WordSize][VM][MemoryManager]Config classes I provide facilities to query my configurations. I use the Visitor pattern in collecting information about my configurations. - HelpBrowser openOn: CMakeVMMakerSqueakDeveloperHelp. + (HelpBrowser openOn: CMakeVMMakerSqueakDeveloperHelp) model + showTopicThat: [:topic | topic title beginsWith: 'Builder']. ! SqueakCMakeVMMakerAbstractBuilder class instanceVariableNames: 'default'! Item was removed: - ----- Method: SqueakCMakeVMMakerAbstractBuilder class>>dirBuildPlatform (in category 'queries') ----- - dirBuildPlatform - default ifNil:[default:= self new]. - ^default dirBuildPlatform! Item was removed: - ----- Method: SqueakCMakeVMMakerAbstractBuilder class>>sourceDirectoryFor: (in category 'queries') ----- - sourceDirectoryFor: aSymbol - default ifNil:[default:= self new]. - ^default sourceDirectoryFor: aSymbol! Item was changed: ----- Method: SqueakCMakeVMMakerAbstractBuilder>>availableBuildConfigurationsFor: (in category 'queries') ----- availableBuildConfigurationsFor: aCategoryName + "answer the CMakeVMakerSqueak configurations in a Smalltalk category that are neither Abstract Base Classes nor excluded from builds." - "answer the CMakeVMakerSqueak configurations in a Smalltalk category that have not excluded themselves from being built." - " (((self configurationDictionary:aCategoryName) keys asSortedCollection) size = 0) - ifTrue:[^((self configurationDictionary:aCategoryName) keys asSortedCollection) sort]." - ^(((self configurationDictionary:aCategoryName) select: [:info| info value excludeFromBuild not ]) keys asSortedCollection) sort + + ^(( + (self configurationDictionary:aCategoryName) select: [:info| (info isAbstractBaseClass not) & (info excludeFromBuild not)] + ) keys asSortedCollection + ) sort. + ! Item was changed: ----- Method: SqueakCMakeVMMakerAbstractBuilder>>availableBuildTypesFor:inCategory: (in category 'queries') ----- availableBuildTypesFor: aSymbol inCategory: aCategoryName |d | "extract the CMakeVMakerConfigurationInfo object for a configuration and return the availableBuildTypes ." d:=(self configurationDictionary:aCategoryName) at: aSymbol ifAbsent:[^SqueakCMakeVMMakerAbstractBuilder default noBuildConfigurations]. ^d availableBuildTypes ! Item was removed: - ----- Method: SqueakCMakeVMMakerAbstractBuilder>>dirBuildPlatform (in category 'queries') ----- - dirBuildPlatform - "Answer the root directory for this configuration's build that contains build, build.assert...etc directories. example: cmake_build.linux32x86." - ^self dirBuildPlatform:(self configurationsCategory)! Item was removed: - ----- Method: SqueakCMakeVMMakerAbstractBuilder>>dirBuildPlatform: (in category 'queries') ----- - dirBuildPlatform: aCategoryName - |info| - "All the configurations in a category share the same build platform." - info:=(self configurationDictionary:aCategoryName) at: ((self configurationDictionary:aCategoryName) keys at:1). "i.e. aDictionary at:1" - ^info dirBuildPlatform - - - ! Item was removed: - ----- Method: SqueakCMakeVMMakerAbstractBuilder>>getInfoForBuild: (in category 'queries') ----- - getInfoForBuild: aSymbol! Item was changed: ----- Method: SqueakCMakeVMMakerAbstractBuilder>>getInfoForBuilds (in category 'queries') ----- getInfoForBuilds | result| "return a Dictionary of CMakeMakerSqueak-XYZ platform configurations and their associated CMakeVMakerConfigurationInfo " result := Dictionary new. self class allSubclassesDo:[:c | |configurationsCategory | configurationsCategory := c default configurationsCategory. result at:(configurationsCategory asSymbol) put: (self configurationDictionary: configurationsCategory). ]. . ^result ! Item was changed: ----- Method: SqueakCMakeVMMakerAbstractBuilder>>initialize (in category 'initialization') ----- initialize "a stupid <cough>temporary</cough> hack to workaround initialization problems" + self flag:'tty. why is this here? its from pharo...'. Cogit allSubclassesDo: [ :each | each initializeWithOptions: (VMMaker new instVarNamed: 'optionsDictionary') ]. + " scriptMode:= false. On the chance that we ever use scripts to invoke builders, here is a flag to bypass user interaction/informs" - scriptMode:= false. "On the chance that we ever use scripts to invoke builders, here is a flag to bypass user interaction/informs" self initializeBuildTypeAndDirectoryInfo. ! Item was removed: - ----- Method: SqueakCMakeVMMakerAbstractBuilder>>sourceDirectoryFor: (in category 'queries') ----- - sourceDirectoryFor: aSymbol - "answer a subset of buildTypeAndDirectoryInfo based on the buildTypes the configuration supports " - [ - ((Smalltalk at: aSymbol) category) = (self configurationsCategory) "verify the class is handled by this concrete builder" - ifTrue:[ ^self sourceDirectoryFor: aSymbol inCategory: ((Smalltalk at: aSymbol) category).] "if so, go get its info" - ifFalse:[^self userErrorInvalidTarget: aSymbol] - ] ifError:[^'sourceDirectoryFor: ''', aSymbol , ''' not found' ]. - ^nil.! Item was removed: - ----- Method: SqueakCMakeVMMakerAbstractBuilder>>sourceDirectoryFor:inCategory: (in category 'queries') ----- - sourceDirectoryFor: aSymbol inCategory: aCategoryName - |info | - "extract the CMakeVMakerConfigurationInfo object for a configuration and return the sourceDirectory ." - info:=(self configurationDictionary:aCategoryName) at: aSymbol ifAbsent:[^SqueakCMakeVMMakerAbstractBuilder default userErrorNoSource:aSymbol]. - ^info dirSource - - - - ! Item was changed: ----- Method: SqueakCMakeVMMakerAbstractBuilder>>unAvailableBuildConfigurationsFor: (in category 'queries') ----- unAvailableBuildConfigurationsFor: aCategoryName + "answer the CMakeVMakerSqueak configurations in a Smalltalk category that are neither Abstract Base Classes nor excluded from builds." - "answer the CMakeVMakerSqueak configurations in a Smalltalk category that havenot excluded themselves from being built." - " (((self configurationDictionary:aCategoryName) keys asSortedCollection) size = 0) - ifTrue:[^((self configurationDictionary:aCategoryName) keys asSortedCollection) sort]." - ^(((self configurationDictionary:aCategoryName) select: [:info| info value excludeFromBuild ]) keys asSortedCollection) sort + + ^(( + (self configurationDictionary:aCategoryName) select: [:info| (info isAbstractBaseClass) | (info excludeFromBuild)] + ) keys asSortedCollection + ) sort. + !

1 0

Re: [Vm-dev] VM Maker: VMMaker.oscog-cb.1875.mcz
by Eliot Miranda 31 May '16

31 May '16

Cool! Clément, a) why not just provide this anyway even if no immutability check, but make the branch between the frameful and the frameless version depend on whether the receiver is new, and hence doesn't need a store check, or not? and b) add another bytecode descriptor flag that identifies bytecodes that (may) do an inst var store instead of checking for a specific generator? _,,,^..^,,,_ (phone) > On May 27, 2016, at 7:07 AM, commits(a)source.squeak.org wrote: > > > ClementBera uploaded a new version of VMMaker to project VM Maker: > http://source.squeak.org/VMMaker/VMMaker.oscog-cb.1875.mcz > > ==================== Summary ==================== > > Name: VMMaker.oscog-cb.1875 > Author: cb > Time: 27 May 2016, 11:43:40.369719 am > UUID: 4da4e9c0-8ef3-4400-b610-73c7959006ce > Ancestors: VMMaker.oscog-eem.1874 > > Anti-slavery society forms (NY)... > > When I benched Immutability/write barrier, games benchmarks had identical performance with and without it (the difference was within noise). > > However I built a microbench doing only inst var stores: > > Foo>>imm: imm nonImm: nonImm > iv1 := 1. > iv2 := #foo. > iv3 := imm. > iv4 := nonImm. > > | f | > f := Foo new. > [f imm: 2 nonImm: #bar ] bench > > And in this case there was 18.7% overhead with the write barrier. BinaryTree bench has a similar method, use it extensively and yet we can't see the overhead on the whole bench, so it's not that critical, but it's still something which could matter in specific cases. > > In this commit I changed the JIT so that (with Immutability/Write barrier ON) methods with only frameless instance variable stores are compiled with two paths. The code first checks if the receiver is immutable/read-only, and takes the right path accordingly. The first path is frameless and does not include immutability/write barrier checks. The second one is frameful and does all the immutability/write barrier checks. > > I didn't do it for blocks as I believe blocks with only instance variable store are not that common - I may be wrong, if you prove to me I am wrong on this with numbers, I will do it for blocks. > > In the micro-bench shown, #imm:nonImm:, the overhead decreased from 18.7% to 2.6%. > > I think this has an impact in general to setter methods. > > I made that in a Pharo sprint (or what it matters). > > =============== Diff against VMMaker.oscog-eem.1874 =============== > > Item was changed: > ----- Method: RegisterAllocatingCogit>>scanMethod (in category 'compile abstract instructions') ----- > scanMethod > "Overrides to count the number of fixups." > "Scan the method (and all embedded blocks) to determine > - what the last bytecode is; extra bytes at the end of a method are used to encode things like source pointers or temp names > - if the method needs a frame or not > - what are the targets of any backward branches. > - how many blocks it creates > Answer the block count or on error a negative error code" > | latestContinuation nExts descriptor pc numBlocks distance targetPC framelessStackDelta | > <var: #descriptor type: #'BytecodeDescriptor *'> > needsFrame := false. > numFixups := 0. > prevBCDescriptor := nil. > + self > + cppIf: IMMUTABILITY > + ifTrue: [needsTwoPath := false]. > NewspeakVM ifTrue: > [numIRCs := 0]. > (primitiveIndex > 0 > and: [coInterpreter isQuickPrimitiveIndex: primitiveIndex]) ifTrue: > [^0]. > pc := latestContinuation := initialPC. > numBlocks := framelessStackDelta := nExts := extA := extB := 0. > [pc <= endPC] whileTrue: > [byte0 := (objectMemory fetchByte: pc ofObject: methodObj) + bytecodeSetOffset. > descriptor := self generatorAt: byte0. > descriptor isExtension ifTrue: > [descriptor opcode = Nop ifTrue: "unknown bytecode tag; see Cogit class>>#generatorTableFrom:" > [^EncounteredUnknownBytecode]. > self loadSubsequentBytesForDescriptor: descriptor at: pc. > self perform: descriptor generator]. > (descriptor isReturn > and: [pc >= latestContinuation]) ifTrue: > [endPC := pc]. > + self > + cppIf: IMMUTABILITY > + ifTrue: [(needsFrame and: [needsTwoPath not]) > + ifFalse: [(descriptor needsFrameFunction isNil > + or: [self perform: descriptor needsFrameFunction with: framelessStackDelta]) > + ifTrue: [needsFrame := true. > + needsTwoPath := descriptor generator == #genStoreAndPopReceiverVariableBytecode] > + ifFalse: [framelessStackDelta := framelessStackDelta + descriptor stackDelta]]] > + ifFalse: [needsFrame > + ifFalse: [(descriptor needsFrameFunction isNil > + or: [self perform: descriptor needsFrameFunction with: framelessStackDelta]) > + ifTrue: [needsFrame := true] > + ifFalse: [framelessStackDelta := framelessStackDelta + descriptor stackDelta]]]. > - needsFrame ifFalse: > - [(descriptor needsFrameFunction isNil > - or: [self perform: descriptor needsFrameFunction with: framelessStackDelta]) > - ifTrue: [needsFrame := true] > - ifFalse: [framelessStackDelta := framelessStackDelta + descriptor stackDelta]]. > descriptor isBranch ifTrue: > [distance := self spanFor: descriptor at: pc exts: nExts in: methodObj. > targetPC := pc + descriptor numBytes + distance. > (self isBackwardBranch: descriptor at: pc exts: nExts in: methodObj) > ifTrue: [self initializeFixupAt: targetPC - initialPC] > ifFalse: > [latestContinuation := latestContinuation max: targetPC. > numFixups := numFixups + 1]]. > descriptor isBlockCreation ifTrue: > [numBlocks := numBlocks + 1. > distance := self spanFor: descriptor at: pc exts: nExts in: methodObj. > targetPC := pc + descriptor numBytes + distance. > latestContinuation := latestContinuation max: targetPC. > numFixups := numFixups + 1]. > NewspeakVM ifTrue: > [descriptor hasIRC ifTrue: > [numIRCs := numIRCs + 1]]. > pc := pc + descriptor numBytes. > descriptor isExtension > ifTrue: [nExts := nExts + 1] > ifFalse: [nExts := extA := extB := 0]. > prevBCDescriptor := descriptor]. > ^numBlocks! > > Item was changed: > ----- Method: SistaCogit>>scanMethod (in category 'compile abstract instructions') ----- > scanMethod > "Scan the method (and all embedded blocks) to determine > - what the last bytecode is; extra bytes at the end of a method are used to encode things like source pointers or temp names > - if the method needs a frame or not > - what are the targets of any backward branches. > - how many blocks it creates > - how many counters it needs/conditional branches it contains > Answer the block count or on error a negative error code" > | latestContinuation nExts descriptor pc numBlocks distance targetPC framelessStackDelta numFixups | > <var: #descriptor type: #'BytecodeDescriptor *'> > self flag: 'numFixup should be reverted to inst var when moving back sistaCogit as subclass of RegisterAllocatingCogit'. > needsFrame := false. > numFixups := 0. > prevBCDescriptor := nil. > numCounters := 0. > + self > + cppIf: IMMUTABILITY > + ifTrue: [needsTwoPath := false]. > NewspeakVM ifTrue: > [numIRCs := 0]. > (primitiveIndex > 0 > and: [coInterpreter isQuickPrimitiveIndex: primitiveIndex]) ifTrue: > [^0]. > pc := latestContinuation := initialPC. > numBlocks := framelessStackDelta := nExts := extA := extB := 0. > [pc <= endPC] whileTrue: > [byte0 := (objectMemory fetchByte: pc ofObject: methodObj) + bytecodeSetOffset. > descriptor := self generatorAt: byte0. > descriptor isExtension ifTrue: > [descriptor opcode = Nop ifTrue: "unknown bytecode tag; see Cogit class>>#generatorTableFrom:" > [^EncounteredUnknownBytecode]. > self loadSubsequentBytesForDescriptor: descriptor at: pc. > self perform: descriptor generator]. > (descriptor isReturn > and: [pc >= latestContinuation]) ifTrue: > [endPC := pc]. > + self > + cppIf: IMMUTABILITY > + ifTrue: [(needsFrame and: [needsTwoPath not]) > + ifFalse: [(descriptor needsFrameFunction isNil > + or: [self perform: descriptor needsFrameFunction with: framelessStackDelta]) > + ifTrue: [needsFrame := true. > + needsTwoPath := descriptor generator == #genStoreAndPopReceiverVariableBytecode] > + ifFalse: [framelessStackDelta := framelessStackDelta + descriptor stackDelta]]] > + ifFalse: [needsFrame > + ifFalse: [(descriptor needsFrameFunction isNil > + or: [self perform: descriptor needsFrameFunction with: framelessStackDelta]) > + ifTrue: [needsFrame := true] > + ifFalse: [framelessStackDelta := framelessStackDelta + descriptor stackDelta]]]. > - needsFrame ifFalse: > - [(descriptor needsFrameFunction isNil > - or: [self perform: descriptor needsFrameFunction with: framelessStackDelta]) > - ifTrue: [needsFrame := true] > - ifFalse: [framelessStackDelta := framelessStackDelta + descriptor stackDelta]]. > descriptor isBranch ifTrue: > [distance := self spanFor: descriptor at: pc exts: nExts in: methodObj. > targetPC := pc + descriptor numBytes + distance. > (self isBackwardBranch: descriptor at: pc exts: nExts in: methodObj) > ifTrue: [self initializeFixupAt: targetPC - initialPC] > ifFalse: > [latestContinuation := latestContinuation max: targetPC. > numFixups := numFixups + 1. > (descriptor isBranchTrue or: [descriptor isBranchFalse]) ifTrue: > [numCounters := numCounters + 1]]]. > descriptor isBlockCreation ifTrue: > [numBlocks := numBlocks + 1. > distance := self spanFor: descriptor at: pc exts: nExts in: methodObj. > targetPC := pc + descriptor numBytes + distance. > latestContinuation := latestContinuation max: targetPC. > numFixups := numFixups + 1]. > NewspeakVM ifTrue: > [descriptor hasIRC ifTrue: > [numIRCs := numIRCs + 1]]. > pc := pc + descriptor numBytes. > descriptor isExtension > ifTrue: [nExts := nExts + 1] > ifFalse: [nExts := extA := extB := 0]. > prevBCDescriptor := descriptor]. > ^numBlocks! > > Item was changed: > SimpleStackBasedCogit subclass: #StackToRegisterMappingCogit > + instanceVariableNames: 'prevBCDescriptor numPushNilsFunction pushNilSizeFunction methodOrBlockNumTemps regArgsHaveBeenPushed simSelf simStack simStackPtr simSpillBase optStatus ceCallCogCodePopReceiverArg0Regs ceCallCogCodePopReceiverArg1Arg0Regs methodAbortTrampolines picAbortTrampolines picMissTrampolines ceCall0ArgsPIC ceCall1ArgsPIC ceCall2ArgsPIC debugStackPointers debugFixupBreaks realCECallCogCodePopReceiverArg0Regs realCECallCogCodePopReceiverArg1Arg0Regs deadCode needsTwoPath' > - instanceVariableNames: 'prevBCDescriptor numPushNilsFunction pushNilSizeFunction methodOrBlockNumTemps regArgsHaveBeenPushed simSelf simStack simStackPtr simSpillBase optStatus ceCallCogCodePopReceiverArg0Regs ceCallCogCodePopReceiverArg1Arg0Regs methodAbortTrampolines picAbortTrampolines picMissTrampolines ceCall0ArgsPIC ceCall1ArgsPIC ceCall2ArgsPIC debugStackPointers debugFixupBreaks realCECallCogCodePopReceiverArg0Regs realCECallCogCodePopReceiverArg1Arg0Regs deadCode' > classVariableNames: 'NeedsMergeFixupFlag NeedsNonMergeFixupFlag' > poolDictionaries: 'CogCompilationConstants VMMethodCacheConstants VMObjectIndices VMStackFrameOffsets' > category: 'VMMaker-JIT'! > StackToRegisterMappingCogit class > instanceVariableNames: 'numPushNilsFunction pushNilSizeFunction'! > > !StackToRegisterMappingCogit commentStamp: 'eem 12/19/2010 18:12' prior: 0! > StackToRegisterMappingCogit is an optimizing code generator that eliminates a lot of stack operations and inlines some special selector arithmetic. It does so by a simple stack-to-register mapping scheme based on deferring the generation of code to produce operands until operand-consuming operations. The operations that consume operands are sends, stores and returns. > > See methods in the class-side documentation protocol for more detail. > > Instance Variables > callerSavedRegMask: <Integer> > ceEnter0ArgsPIC: <Integer> > ceEnter1ArgsPIC: <Integer> > ceEnter2ArgsPIC: <Integer> > ceEnterCogCodePopReceiverArg0Regs: <Integer> > ceEnterCogCodePopReceiverArg1Arg0Regs: <Integer> > debugBytecodePointers: <Set of Integer> > debugFixupBreaks: <Set of Integer> > debugStackPointers: <CArrayAccessor of (Integer|nil)> > methodAbortTrampolines: <CArrayAccessor of Integer> > methodOrBlockNumTemps: <Integer> > optStatus: <Integer> > picAbortTrampolines: <CArrayAccessor of Integer> > picMissTrampolines: <CArrayAccessor of Integer> > realCEEnterCogCodePopReceiverArg0Regs: <Integer> > realCEEnterCogCodePopReceiverArg1Arg0Regs: <Integer> > regArgsHaveBeenPushed: <Boolean> > simSelf: <CogSimStackEntry> > simSpillBase: <Integer> > simStack: <CArrayAccessor of CogSimStackEntry> > simStackPtr: <Integer> > traceSimStack: <Integer> > > callerSavedRegMask > - the bitmask of the ABI's caller-saved registers > > ceEnter0ArgsPIC ceEnter1ArgsPIC ceEnter2ArgsPIC > - the trampoline for entering an N-arg PIC > > ceEnterCogCodePopReceiverArg0Regs ceEnterCogCodePopReceiverArg1Arg0Regs > - teh trampoline for entering a method with N register args > > debugBytecodePointers > - a Set of bytecode pcs for setting breakpoints (simulation only) > > debugFixupBreaks > - a Set of fixup indices for setting breakpoints (simulation only) > > debugStackPointers > - an Array of stack depths for each bytecode for code verification > > methodAbortTrampolines > - a CArrayAccessor of abort trampolines for 0, 1, 2 and N args > > methodOrBlockNumTemps > - the number of method or block temps (including args) in the current compilation unit (method or block) > > optStatus > - the variable used to track the status of ReceiverResultReg for avoiding reloading that register with self between adjacent inst var accesses > > picAbortTrampolines > - a CArrayAccessor of abort trampolines for 0, 1, 2 and N args > > picMissTrampolines > - a CArrayAccessor of abort trampolines for 0, 1, 2 and N args > > realCEEnterCogCodePopReceiverArg0Regs realCEEnterCogCodePopReceiverArg1Arg0Regs > - the real trampolines for ebtering machine code with N reg args when in the Debug regime > > regArgsHaveBeenPushed > - whether the register args have been pushed before frame build (e.g. when an interpreter primitive is called) > > simSelf > - the simulation stack entry representing self in the current compilation unit > > simSpillBase > - the variable tracking how much of the simulation stack has been spilled to the real stack > > simStack > - the simulation stack itself > > simStackPtr > - the pointer to the top of the simulation stack > ! > StackToRegisterMappingCogit class > instanceVariableNames: 'numPushNilsFunction pushNilSizeFunction'! > > Item was changed: > ----- Method: StackToRegisterMappingCogit>>compileFrameBuild (in category 'compile abstract instructions') ----- > compileFrameBuild > "Build a frame for a CogMethod activation. See CoInterpreter class>>initializeFrameIndices. > Override to push the register receiver and register arguments, if any." > + self cppIf: IMMUTABILITY ifTrue: > + [needsTwoPath ifTrue: > + [self compileTwoPathFrameBuild. > + ^self]]. > needsFrame ifFalse: > [self initSimStackForFramelessMethod: initialPC. > ^self]. > self genPushRegisterArgs. > super compileFrameBuild. > self initSimStackForFramefulMethod: initialPC! > > Item was added: > + ----- Method: StackToRegisterMappingCogit>>compileTwoPathFrameBuild (in category 'compile abstract instructions') ----- > + compileTwoPathFrameBuild > + <option: #IMMUTABILITY> > + "We are in a method where the frame is needed *only* for instance variable store, typically a setter method. > + This case has 20% overhead with Immutability compared to setter without immutability because of the stack > + frame creation. We compile two path, one where the object is immutable, one where it isn't. At the beginning > + of the frame build, we take one path or the other depending on the receiver mutability. > + > + Note: this specific case happens only where there are only instance variabel stores. We could do something > + similar for literal variable stores, but we don't as it's too uncommon." > + |jumpImmutable| > + self assert: needsFrame. > + self assert: IMMUTABILITY. > + self assert: needsTwoPath. > + self assert: blockCount = 0. > + jumpImmutable := objectRepresentation genJumpImmutable: ReceiverResultReg scratchReg: TempReg. > + "first path. The receiver is mutable" > + self initSimStackForFramelessMethod: initialPC. > + self compileMethodBody. > + "second path. The receiver is mutable" > + needsTwoPath := false. "reset because it impact inst var store compilation" > + jumpImmutable jmpTarget: self Label. > + self genPushRegisterArgs. > + super compileFrameBuild. > + self initSimStackForFramefulMethod: initialPC! > > Item was changed: > ----- Method: StackToRegisterMappingCogit>>genStorePop:slotIndex:destReg:needsStoreCheck:needsRestoreRcvr: (in category 'bytecode generator support') ----- > genStorePop: popBoolean slotIndex: slotIndex destReg: destReg needsStoreCheck: needsStoreCheck needsRestoreRcvr: needsRestoreReceiver > <inline: true> > "This method expects destReg to hold the object to store into. In practice, it is almost always RcvrResultReg because it is mandatory for the various store checks. We could put any register there if no store check is needed" > self > cppIf: IMMUTABILITY > ifTrue: > + [needsTwoPath > + ifTrue: > + [self "first path, receiver is mutable" > + genVanillaStorePop: popBoolean > + slotIndex: slotIndex > + destReg: destReg > + needsStoreCheck: needsStoreCheck] > + ifFalse: > + [self > + genImmCheckStorePop: popBoolean > + slotIndex: slotIndex > + destReg: destReg > + needsStoreCheck: needsStoreCheck > + needsRestoreRcvr: needsRestoreReceiver]] > - [ self > - genImmCheckStorePop: popBoolean > - slotIndex: slotIndex > - destReg: destReg > - needsStoreCheck: needsStoreCheck > - needsRestoreRcvr: needsRestoreReceiver ] > ifFalse: > + [self > - [ self > genVanillaStorePop: popBoolean > slotIndex: slotIndex > destReg: destReg > + needsStoreCheck: needsStoreCheck]. > - needsStoreCheck: needsStoreCheck ]. > ! > > Item was changed: > ----- Method: StackToRegisterMappingCogit>>genUpArrowReturn (in category 'bytecode generators') ----- > genUpArrowReturn > "Generate a method return from within a method or a block. > Frameless method activation looks like > CISCs (x86): > receiver > args > sp-> ret pc. > RISCs (ARM): > receiver > args > ret pc in LR. > A fully framed activation is described in CoInterpreter class>initializeFrameIndices. > Return pops receiver and arguments off the stack. Callee pushes the result." > + | framelessReturn | > deadCode := true. "can't fall through" > inBlock ifTrue: > [self assert: needsFrame. > self CallRT: ceNonLocalReturnTrampoline. > self annotateBytecode: self Label. > ^0]. > + self > + cppIf: IMMUTABILITY > + ifTrue: [framelessReturn := needsFrame and: [needsTwoPath not]] > + ifFalse: [framelessReturn := needsFrame]. > + framelessReturn > - needsFrame > ifTrue: > [self MoveR: FPReg R: SPReg. > self PopR: FPReg. > backEnd hasLinkRegister ifTrue: > [self PopR: LinkReg]. > self RetN: methodOrBlockNumArgs + 1 * objectMemory wordSize] > ifFalse: > [self RetN: ((methodOrBlockNumArgs > self numRegArgs > "A method with an interpreter prim will push its register args for the prim. If the failure > body is frameless the args must still be popped, see e.g. Behavior>>nextInstance." > or: [regArgsHaveBeenPushed]) > ifTrue: [methodOrBlockNumArgs + 1 * objectMemory wordSize] > ifFalse: [0])]. > ^0! > > Item was changed: > ----- Method: StackToRegisterMappingCogit>>scanMethod (in category 'compile abstract instructions') ----- > scanMethod > "Scan the method (and all embedded blocks) to determine > - what the last bytecode is; extra bytes at the end of a method are used to encode things like source pointers or temp names > - if the method needs a frame or not > - what are the targets of any backward branches. > - how many blocks it creates > Answer the block count or on error a negative error code" > | latestContinuation nExts descriptor pc numBlocks distance targetPC framelessStackDelta | > <var: #descriptor type: #'BytecodeDescriptor *'> > needsFrame := false. > prevBCDescriptor := nil. > + self cppIf: IMMUTABILITY ifTrue: [ needsTwoPath := false ]. > NewspeakVM ifTrue: > [numIRCs := 0]. > (primitiveIndex > 0 > and: [coInterpreter isQuickPrimitiveIndex: primitiveIndex]) ifTrue: > [^0]. > pc := latestContinuation := initialPC. > numBlocks := framelessStackDelta := nExts := extA := extB := 0. > [pc <= endPC] whileTrue: > [byte0 := (objectMemory fetchByte: pc ofObject: methodObj) + bytecodeSetOffset. > descriptor := self generatorAt: byte0. > descriptor isExtension ifTrue: > [descriptor opcode = Nop ifTrue: "unknown bytecode tag; see Cogit class>>#generatorTableFrom:" > [^EncounteredUnknownBytecode]. > self loadSubsequentBytesForDescriptor: descriptor at: pc. > self perform: descriptor generator]. > (descriptor isReturn > and: [pc >= latestContinuation]) ifTrue: > [endPC := pc]. > + self cppIf: IMMUTABILITY > + ifTrue: > + [(needsFrame and: [needsTwoPath not]) ifFalse: > + [(descriptor needsFrameFunction isNil > + or: [self perform: descriptor needsFrameFunction with: framelessStackDelta]) > + ifTrue: > + [needsFrame := true. > + needsTwoPath := descriptor generator == #genStoreAndPopReceiverVariableBytecode ] > + ifFalse: [framelessStackDelta := framelessStackDelta + descriptor stackDelta]]] > + ifFalse: > + [needsFrame ifFalse: > + [(descriptor needsFrameFunction isNil > + or: [self perform: descriptor needsFrameFunction with: framelessStackDelta]) > + ifTrue: [needsFrame := true] > + ifFalse: [framelessStackDelta := framelessStackDelta + descriptor stackDelta]]]. > + > - needsFrame ifFalse: > - [(descriptor needsFrameFunction isNil > - or: [self perform: descriptor needsFrameFunction with: framelessStackDelta]) > - ifTrue: [needsFrame := true] > - ifFalse: [framelessStackDelta := framelessStackDelta + descriptor stackDelta]]. > descriptor isBranch ifTrue: > [distance := self spanFor: descriptor at: pc exts: nExts in: methodObj. > targetPC := pc + descriptor numBytes + distance. > (self isBackwardBranch: descriptor at: pc exts: nExts in: methodObj) > ifTrue: [self initializeFixupAt: targetPC - initialPC] > ifFalse: [latestContinuation := latestContinuation max: targetPC]]. > descriptor isBlockCreation ifTrue: > [numBlocks := numBlocks + 1. > distance := self spanFor: descriptor at: pc exts: nExts in: methodObj. > targetPC := pc + descriptor numBytes + distance. > latestContinuation := latestContinuation max: targetPC]. > NewspeakVM ifTrue: > [descriptor hasIRC ifTrue: > [numIRCs := numIRCs + 1]]. > pc := pc + descriptor numBytes. > descriptor isExtension > ifTrue: [nExts := nExts + 1] > ifFalse: [nExts := extA := extB := 0]. > prevBCDescriptor := descriptor]. > ^numBlocks! >

2 2

VM Maker: CMakeVMMakerSqueak-tty.122.mcz
by commits＠source.squeak.org 31 May '16

31 May '16

Timothy M uploaded a new version of CMakeVMMakerSqueak to project VM Maker: http://source.squeak.org/VMMaker/CMakeVMMakerSqueak-tty.122.mcz ==================== Summary ==================== Name: CMakeVMMakerSqueak-tty.122 Author: tty Time: 30 May 2016, 5:31:28.428568 pm UUID: 1336e30e-abd6-4280-ab25-98ad217cb8b7 Ancestors: CMakeVMMakerSqueak-tty.121 Continued work on a refactored Help for the system. Builders tests are broken. Need to fix. In light of the Configuration step-by-step tutorial, I would like to consider tests for each step too. Next up is verifying the New Configuration Tutorial works as advertised as I use it to create a Linux64x64 squeak.cog.spur configuration. I am awaiting morphic bug fix before doing that. I will start the decoupling from the pharo code soon. =============== Diff against CMakeVMMakerSqueak-tty.121 =============== Item was changed: ----- Method: CMakeVMGeneratorForSqueak>>generateByTemplate (in category 'code generation') ----- generateByTemplate + "The bulk of CMake generation happens here. + + See CPlatformConfigForSqueak>>initialize for CMake output. that occurs prior to this method. (This may change on refactoring) + + Think Seaside renderOn composition. + " - "attempt to move way from string based writing to template based. Think Seaside renderOn composition" | extPlugins intPlugins | self flag: 'tty'. "refactor so that the cascade reflects CMake terminilogy" output := String new writeStream. config templates: OrderedCollection new. config setGlobalOptions: self; cmakePrefixPath; cmakeIncludePath; cmakeLibraryPath; cmakeIncludeModules; cmakeCFlags; cmakeAddDefinitions; cmakeWriteDirectoriesDotCmake: self; cmakeIncludeDirectories: self; "<---" preferredIncludes; "<---why 3 of em?" standardIncludes; "<---" setGlobalOptionsAfterDetermineSystem: self; extraVMSettings: self; "<--catch-all method. os/platform specific" setCoreSources: self; setPlatformSources: self; setCrossSources: self; setExtraSources; cmakeSetSourceFilesProperties; cmakeListAppend:'LINKLIBS' elements: (config externalLibs); cmakeAddExecutableNameOptionSource: self; setExecutableOutputPath; addVMPlugins: self. config templates do: [:each | self puts: each content]. config templates: OrderedCollection new. extPlugins := self generatePluginConfigs: config internalPlugins internal: true. intPlugins := self generatePluginConfigs: config externalPlugins internal: false. self processThirdpartyLibraries. "<--unused in Pharo code? What exactly does this do?" self processPlugins: intPlugins, extPlugins. self config templates addLast:((CMakeCommand new) command:'target_link_libraries' params:(self moduleName , ' ${LINKLIBS}')). " self cmd: 'target_link_libraries' params: self moduleName , ' ${LINKLIBS}'." config postBuildActions: self.. config templates do: [:each | self puts: each content]. self saveFile. self generateBuildScript! Item was changed: ----- Method: CMakeVMMakerSqueakBuildersHelp class>>overview (in category 'pages') ----- overview ^HelpTopic title: 'Overview' contents: + 'Builders are a facade interfact to CMakeVMmakerSqueak Configurations. - 'A CMakeVMakerSqueak Builder is both a ''query'' tool and a ''build'' tool. + A CMakeVMakerSqueak Builder is both a ''query'' tool and a ''build'' tool. - Builders provide a facade to CMakeVMmakerSqueak Configurations. + With a Builder, you can query its configurationsCategory''s Configurations invoke a Configuration to generate CMake files or... invoke a Configuration to generateSources which... invokes VMMaker.oscog to generate source Builders are concrete instances of the Abstract Base Class:SqueakCMakeVMMakerAbstractBuilder Browse its class comment an heirarchy to get a feel for it. HelpBrowser openOn: SqueakCMakeVMMakerAbstractBuilder SqueakCMakeVMMakerAbstractBuilder browseHierarchy. Information on creating your own is available via HelpBrowser openOn: CMakeVMMakerSqueakDeveloperHelp - TODO: Fix above sentence to point to something useful. + '! Item was changed: ----- Method: CMakeVMMakerSqueakBuildersHelp class>>pages (in category 'accessing') ----- pages + ^#(overview queryingBuilders buildTypes generatingCMakeBuilds CMakeVMMakerSqueakTutorialNewBuilderHelp) - ^#(overview queryingBuilders buildTypes generatingCMakeBuilds) "#(overview queryingBuilders buildTypes generatingCMakeBuilds scratch)"! Item was removed: - ----- Method: CMakeVMMakerSqueakCommonConfigTest>>testDirSource (in category 'as yet unclassified') ----- - testDirSource - "for each builder, make sure all its configurations provide a dirSource " - #(#SqueakMacintoshConfig #SqueakUnixConfig #SqueakWindowsConfig) - do:[:each | - (Smalltalk at:each) - allSubclassesDo:[:configuration | | o | - configuration isAbstractBaseClass not - ifTrue:[ o:= configuration basicNew. - o excludeFromBuild not - ifTrue:[self assert:(o dirSource isString)]]]] - - - - - - - - ! Item was removed: - ----- Method: CMakeVMMakerSqueakCommonConfigTest>>testPlatformSources (in category 'as yet unclassified') ----- - testPlatformSources - #(#SqueakMacintoshConfig #SqueakUnixConfig #SqueakWindowsConfig) - do:[:each | - (Smalltalk at:each) - allSubclassesDo:[:configuration | | o | - o:= configuration basicNew. - (o excludeFromBuild not) | (configuration isAbstractBaseClass) - ifTrue:[self assert:(o platformSources isArray)]]] - - - - - - - - ! Item was changed: ----- Method: CMakeVMMakerSqueakConfigurationsHelp class>>pages (in category 'accessing') ----- pages + ^#(overview ) - " #(overview CMakeVMMakerSqueakStepByStepNewConfigurationHelp CMakeVMMakerSqueakStepByStepNewPlatformHelp)" - ^#(overview CMakeVMMakerSqueakStepByStepNewConfigurationHelp) ! Item was changed: ----- Method: CMakeVMMakerSqueakDesignPatternsHelp class>>overview (in category 'pages') ----- overview ^HelpTopic title: 'Overview' contents: 'CMakeVMMakerSqueak makes heavy use of several design patterns. They include: - Visitor Pattern. Method Redirect Pattern*. + Visitor Pattern. *N.B. tty. It might have a different name, I just named it that for reasons that will be apparent. '! Item was changed: ----- Method: CMakeVMMakerSqueakDeveloperHelp class>>pages (in category 'pages') ----- pages + ^#( CMakeVMMakerSqueakOverviewHelp CMakeVMMakerSqueakBuildersHelp CMakeVMMakerSqueakConfigurationsHelp CMakeVMMakerSqueakGeneratorsHelp CMakeVMMakerSqueakTemplatesHelp CMakeVMMakerSqueakDesignPatternsHelp CMakeVMMakerSqueakHistoryHelp ) - ^#( CMakeVMMakerSqueakOverviewHelp CMakeVMMakerSqueakBuildersHelp CMakeVMMakerSqueakConfigurationsHelp CMakeVMMakerSqueakGeneratorsHelp CMakeVMMakerSqueakTemplatesHelp CMakeVMMakerSqueakDesignPatternsHelp CMakeVMMakerSqueakHistoryHelp ) + ! - - "#(CMakeVMMakerSqueakHistoryHelp CMakeVMMakerSqueakConfigurationsHelp CMakeVMMakerSqueakOverviewHelp CMakeVMMakerSqueakGeneratorsHelp CMakeVMMakerSqueakTemplatesHelp CMakeVMMakerSqueakBuildersHelp CMakeVMMakerSqueakDesignPatternsHelp configDotCmake looseEnds plugins pthreads templates tests )"! Item was removed: - CMakeVMMakerSqueakHelp subclass: #CMakeVMMakerSqueakExampleWorkflowHelp - instanceVariableNames: '' - classVariableNames: '' - poolDictionaries: '' - category: 'CMakeVMMakerSqueak-Help'! - - !CMakeVMMakerSqueakExampleWorkflowHelp commentStamp: 'tty 2/28/2015 13:25' prior: 0! - A CMakeVMMakerSqueakTerseGuideHelp provides a simple walkthrough of a build using the CMakeVMMaker package. - - - ! Item was removed: - ----- Method: CMakeVMMakerSqueakExampleWorkflowHelp class>>bookName (in category 'accessing') ----- - bookName - ^'Example Workflow: End User'! Item was removed: - ----- Method: CMakeVMMakerSqueakExampleWorkflowHelp class>>configureAndGenerate (in category 'pages') ----- - configureAndGenerate - ^HelpTopic - title: 'Configure and Generate' - contents: - ' The final step is to instruct the Configuration to configure itself for an available buildType , enable/disable debugging trace messages and generate the output. - - SqueakLinux64x86w32CompatBuilder - configureA: #Linux32x86SqueakCogV3Config forBuildType: #build; - enableMessageTracking: true; - generateByTemplate. - - Running the above cascade provides no feedback to the user. If all went well, there should be a CMake build tree as discussed on the next page. - - - - ' - - - ! Item was removed: - ----- Method: CMakeVMMakerSqueakExampleWorkflowHelp class>>examiningOutput (in category 'pages') ----- - examiningOutput - "This method was automatically generated. Edit it using:" - "a HelpBrowser edit: #examiningOutput" - ^HelpTopic - title: 'Examining Output' - contents: - 'TODO: tty fix apperent but in build directory as it is outputing to DO THIS NEXT /cmake.build.linux64x86w32BitCompatibility/squeak.cog.v3/build/ - and not cmake.build.linux32_64x86 - - Examining the output requires two queries (both intuitive, via the intention revealing names of the Builder and Configuration) - - First, we ask the builder where it has its Configurations put their output: - - SqueakLinux64x86w32CompatBuilder buildDirectory - --> ''cmake.build.linux32_64x86'' - - - The Linux32x86SqueakCogV3Config writes itself to a directory that matches its [cmake.Platform]/[Language].[VM].[MemoryModel]/[BuildType] - - On my system that is: - - ~./..../cogVMMaker/oscogvm/cmake.[Platform]/[Language].[VM].[MemoryModel]/build - i.e. - ~./..../cogVMMaker/oscogvm/cmake.build.linux32_64x86/squeak.cog.v3/build - - I open a terminal and navigate to that directory: - - cd ~./..../cogVMMaker/oscogvm/cmake.build.linux32_64x86/squeak.cog.v3/build - - and list the contents - - bash-4.2$ ls - ADPCMCodecPlugin LICENSE.txt SurfacePlugin - AsynchFilePlugin LargeIntegers Utils.cmake - B2DPlugin LocalePlugin ZipPlugin - BMPReadWriterPlugin MIDIPlugin build.cmake - BitBltPlugin Matrix2x3Plugin build.sh - CMakeLists.txt MiscPrimitivePlugin config.cmake - CroquetPlugin Mpeg3Plugin config.in - DSAPrims PLUGINS.txt directories.cmake - DropPlugin Plugins.cmake sqNamedPrims.h - FFTPlugin SecurityPlugin testDoubleWordAlignment.c - FileCopyPlugin SerialPlugin testDoubleWordOrder.c - FilePlugin SocketPlugin testLanginfoCodeset.c - FloatArrayPlugin SoundCodecPrims vm-display-X11 - FloatMathPlugin SoundGenerationPlugin vm-display-null - JoystickTabletPlugin SoundPlugin vm-sound-ALSA - Klatt StarSqueakPlugin vm-sound-null - .... - - - (NOTE TODO tty: build a query to have a configuration return its build directory path.) - - !!' readStream nextChunkText! Item was removed: - ----- Method: CMakeVMMakerSqueakExampleWorkflowHelp class>>invokeCMake (in category 'pages') ----- - invokeCMake - ^HelpTopic - title: 'Invoke cmake' - contents: - 'The next step is to tell CMake to create the native build files. - - On linux the commands are: - - cmake . <----N.B. note the ''dot'' after the cmake - make - - As a convenience, the commands are duplicated in a generated ''build.sh'' file . (I have had some wierd issues with running it directly, so I just run the commands therein) - bash-4.2$ cat build.sh - #!!/usr/bin/env bash - export CC=gcc - export CXX=g++ - cmake . - make - - - When CMakeVMMakerSqueak is ported to different platforms, then the ''make'' command could be replaced by a different native build system command. - - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakExampleWorkflowHelp class>>overview (in category 'pages') ----- - overview - ^HelpTopic - title: 'Overview' - contents: - 'On a given Platform, a platform specific Builder configures a platform specific Configuration for a buildType and instructs it to write its CMake output to that Configuration''s build directory. - - This terse example shows a typicall use-case of the tools. - - In this terse example, I want to build a Cog VM for Squeak with the V3 memory model. on a SlackwareLinux64 with 32 bit Compatability libs platform. - - To do this, I ... - - 1. Select the Builder for my platform. - 2. Query the Builder - 3 Select a Configuration - 4 Instruct the Configuration (via the Builder) to configure itself for a builtType - 5. Instruct the Configuration (via the Builder) to enable message tracking (useful for debugging output) - 6. Instruct the Configuration (via the Builder) to generate its CMake output. - 7 - 8 Invoke the native build system. - 9. Test the generated VM. - '! Item was removed: - ----- Method: CMakeVMMakerSqueakExampleWorkflowHelp class>>pages (in category 'accessing') ----- - pages - ^#(overview selectBuilder queryBuilder selectConfiguration configureAndGenerate examiningOutput invokeCMake testDrive)! Item was removed: - ----- Method: CMakeVMMakerSqueakExampleWorkflowHelp class>>priority (in category 'pages') ----- - priority - - ^ 3! Item was removed: - ----- Method: CMakeVMMakerSqueakExampleWorkflowHelp class>>queryBuilder (in category 'pages') ----- - queryBuilder - ^HelpTopic - title: 'Query the Builder' - contents: - 'I can query the Builder for information on available Configurations and BuildTypes - - SqueakLinux64x86w32CompatBuilder - availableBuildConfigurations. - - SqueakLinux64x86w32CompatBuilder - allBuildTypes. - - SqueakLinux64x86w32CompatBuilder - availableBuildTypesFor:(SqueakLinux64x86w32CompatBuilder availableBuildConfigurations at:1). - - SqueakLinux64x86w32CompatBuilder - buildDirectory. - - The ''queries'' protocol of the SqueakCMakeVMMakerAbstractBuilder contains additional queries. - - SqueakCMakeVMMakerAbstractBuilder class browse. - ' - - - ! Item was removed: - ----- Method: CMakeVMMakerSqueakExampleWorkflowHelp class>>selectBuilder (in category 'pages') ----- - selectBuilder - ^HelpTopic - title: 'Select a Builder' - contents: - 'I select the appropriate Builder from the CMakeVMMakerSqueak-Builder category for my platform; in my case it is the SqueakLinux64x86w32CompatBuilder. - - - SqueakLinux64x86w32CompatBuilder browseHierarchy. - - SqueakCMakeVMMakerAbstractBuilder browseHierarchy. - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakExampleWorkflowHelp class>>selectConfiguration (in category 'pages') ----- - selectConfiguration - ^HelpTopic - title: 'Select a Configuration' - contents: - 'The Configuration Linux64x86w32BitSqueakCogV3Config is available for my platform. (i.e. a developer has done the work of encapsulating the custom CMake for us). - - As stated before, I can view what Configurations are available for a platform by asking the platform Builder what it has available: - - SqueakLinux64x86w32CompatBuilder - availableBuildConfigurations. - - As of this writing the Linux64x86w32BitSqueakCogV3Config is available and I decide to use it. - - Note that the class name of the Configuration is intention-revealing. It is a Configuration for the Linux 64 platform with 32 Bit compatibility libs that encapsulates the CMake required to build the Squeak Cog V3 virtual machine. From this convention, The organization of configurations is straight-forward: - - CPlatformConfigForSqueak browseHierarchy - - Linux64x86w32BitSqueakCogV3Config browseHierarchy - ' - - - ! Item was removed: - ----- Method: CMakeVMMakerSqueakExampleWorkflowHelp class>>testDrive (in category 'pages') ----- - testDrive - ^HelpTopic - title: 'Test Driving the VM' - contents: - 'The Cog svn tree contains a directory named ''products'' where it stores its make output. - - The CMakeVMMakerSqueak system mirrors that with a cmake.products directory that is created at the same level. - - - The newly generated VM is stored in a subdirectory of ''cmake.products" that mimics the [Language][VM][MemoryModel] naming convention of the Configuration - - Since I built a #Linux32x86SqueakCogV3Config the cog vm is placed in the cmake.products/squeak.cog.v3 directory. - - TODO: Add a message name showing where this is customized. - '! Item was changed: ----- Method: CMakeVMMakerSqueakHelp class>>pages (in category 'accessing') ----- pages + ^#( CMakeVMMakerSqueakStartHereHelp CMakeVMMakerSqueakDeveloperHelp CMakeVMMakerSqueakTutorialsHelp )! - ^#( CMakeVMMakerSqueakStartHereHelp CMakeVMMakerSqueakExampleWorkflowHelp CMakeVMMakerSqueakDeveloperHelp )! Item was changed: ----- Method: CMakeVMMakerSqueakStartHereHelp class>>nextSteps (in category 'pages') ----- nextSteps ^HelpTopic title: 'Next Steps' contents: + 'The Help Topic entitled "Developer Guide" will explain the design of and how to add and modify the components of the CMakeVMMakerSqueak system. - 'The Help Topic entitled "Example Workflow: End User" will walk you through an example workflow as executed on a GNU Linux system with the standard development tools. Macintosh and Windows dev tools will differ (N.B. tty The primary difference is that they have not been written yet (: ). + The Tutorials Help Topic contains some useful tutorials - The Help Topic entitled "Developer Guide" will explain the design of and how to add and modify the components of the CMakeVMMakerSqueak system. - '! Item was changed: ----- Method: CMakeVMMakerSqueakStartHereHelp class>>overview (in category 'pages') ----- overview ^HelpTopic title: 'Overview' contents: 'CMakeVMMakerSqueak is a collection of tools for generating CMake files. The high-level workflow is: 1. Instruct CMakeVMMakerSqueak to generate CMake build directories and CMake configuration files. 2. Invoke the ''cmake'' command at the top level of the generated cmake build tree 3. CMake configures and outputs the build system files for that platform. 4. The user invokes the native build system. 5. The native build system compiles a VM. + The ''Tutorial: End User'' page in this Help book provides an example of the above workflow with minimal explanation. - The ''Example Workflow: End User'' page in this Help book provides an example of the above workflow with minimal explanation. + For in-depth explanations of the system(s), tools and how to use and extend them, see the ''CMakeVMMaker Developer Guide'''! - In-depth explanations of the system(s), tools and how to use them, see the ''CMakeVMMaker Developer Guide'''! Item was changed: ----- Method: CMakeVMMakerSqueakStartHereHelp class>>pages (in category 'accessing') ----- pages + ^#(overview requirements nextSteps )! - ^#(overview requirements nextSteps)! Item was removed: - CMakeVMMakerSqueakConfigurationsHelp subclass: #CMakeVMMakerSqueakStepByStepNewConfigurationHelp - instanceVariableNames: '' - classVariableNames: '' - poolDictionaries: '' - category: 'CMakeVMMakerSqueak-Help'! - - !CMakeVMMakerSqueakStepByStepNewConfigurationHelp commentStamp: 'tty 6/16/2014 12:19' prior: 0! - A CMakeVMMakerSqueakNewConfigurationStepByStepHelp itemizes the steps needed to create a new build configuration. - - HelpBrowser openOn: CMakeVMMakerSqueakNewConfigurationStepByStepHelp! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>aNoteOnFoo (in category 'pages') ----- - aNoteOnFoo - ^HelpTopic - title:'A Note On FOO' - contents: - 'Since we have customized plugins, now is a good time to introduce the FOO in [PLATFORM][Language][VM][Memory Manager][BuildType][foo] - - The purpose of FOO is to accomadate personal plugins that ''just work'' for an odd-ball platform or odd set of plugins or some obscure operating system.. - - Some examples will suffice to convey the purpose of FOO. (below I encase [FOO] for clarity) - - Linux64x86w32BitSqueakCogV3[WithoutGL]Config - - SqueakBSD32x86[TTYsConfigurationFromHell]Config - - Linux32x86SqueakCogV3[BillyBobVeryOwn]Config - - Linux32x86SqueakCogV3[withoutIA32BOCHSPLugin]Config - - you get the idea. - - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>addVMPlugins (in category 'pages') ----- - addVMPlugins - ^HelpTopic - title:'addVMPlugins' - contents: - 'addVMPlugins depends on custom configuration provided in our Configuration; the method depends on three other methods as described below - - VMPlugins are similar to built-in plugins yet are critical for running squeak on particular systems. - - The CMake configuration data needed for building them is encapsulated in sublcasses of CMakeVMPlugin. - - CMakeVMPlugin browseHierarchy - - You see that they are predominantly display and sound drivers. - - The process of customization ''starts'' in the initialze method of CPlatformConfigForSqueak - - ToolSet browse: CPlatformConfigForSqueak selector: #initialize - - In CPlatformConfigForSqueak>>initializeVMDrivers an OrderedCollection of CMakeVMPlugin subclasses are initialzed and stored. This collection is the universe of possible vm plugins. - - In our custom Configuration, we need a subset of that universe. The CPlatformConfigForSqueak>>customizeVMDrivers forces this with a ''self subclassResponsibility'' - - In our new Configuration we have this method already as we copied from an existing Configuration - - ToolSet browse: Linux64x86w32BitConfigUsrLib selector: #customizeVMPlugins - - We see that the code selects specific vm plugin templates from the universe of available ones and then customizes each one. - - Taking Linux64x86w32BitConfigUsrLib>>customizeCMakeVMDisplayNull as an example... - - ToolSet browse: Linux64x86w32BitConfigUsrLib selector: #customizeCMakeVMDisplayNull - - We see that we set the sources, compiler definitions, flags, external libraries, linker flags and include directories needed to compile the vm plugin here. - - So, if we have trouble with a vm plugin, we need to look in its customzeCMakeVMXYZ method and fix it there. - - These configurations are extracted from our Configuration and written out to that vm plugins directory and placed in its CMakeLists.txt file. - - Here is an example of the CMakeLists.txt file for the vm-display-null plugin - - bash-4.2$ cat oscogvm/cmake.build.linux64x86w32BitCompatibility/squeak.cog.v3/build/vm-display-null/CMakeLists.txt - # This is automatically generated file using Linux64x86w32BitSqueakCogSpurConfig on 1 May 2016 8:40:02.153261 am - project (vm-display-null) - cmake_minimum_required(VERSION 2.8.12) - include (/home/wm/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/cmake.build.linux64x86w32BitCompatibility/squeak.cog.v3/build/directories.cmake) - add_definitions(-DNDEBUG -DDEBUGVM=0 -DLSB_FIRST=1 -D_GNU_SOURCE -D_FILE_OFFSET_BITS=64 -DCOGMTVM=0) - add_definitions(-w -m32 -msse2 -O1) - add_definitions(-fPIC -DPIC) - set(sources ${targetPlatform}/vm-display-null/sqUnixDisplayNull) - add_library(vm-display-null SHARED ${sources}) - include_directories( ${crossDir}/plugins/FilePlugin ${targetPlatform}/plugins/B3DAcceleratorPlugin ${crossDir}/plugins/B3DAcceleratorPlugin) - set(LIBRARY_OUTPUT_PATH "/home/wm/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/cmake.products/squeak.cog.v3") - target_link_libraries(vm-display-null ${LINKLIBS}) - set_target_properties(vm-display-null PROPERTIES PREFIX "" SUFFIX "" LINK_FLAGS "-w -m32 -msse2 -O1") - - - To modify the above output, we modify our Configuration''s customizeCMakeVMXyz methods . - To add or remove a vm-plugin from our configuration, we edit the customizeVMPlugins method. - To expand the universe of available vm plugins, we modify the CMakeConfigForSqueak >>initializeVMDrivers method. - - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>bookName (in category 'accessing') ----- - bookName - ^'Example Workflow: New Configuration'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cPlatformConfigForSqueak (in category 'pages') ----- - cPlatformConfigForSqueak - "This method was automatically generated. Edit it using:" - "a HelpBrowser edit: #cPlatformConfigForSqueak" - ^HelpTopic - title: 'CPlatformConfigForSqueak' - contents: - 'CPlatformConfigForSqueak browse - - CPlatformConfForSqueak encapsulates data and methods/behaviors that span computer platforms. - - The immediate children of CPlatformConfigForSqueak - - SqueakMacintoshConfig - SqueakUnixConfig - SqueakWindowsConfig - - begin the specialization required for the Macintiosh , Unix and Windows machines. Adding a new platform, say VAX, is as easy as - CPlatformConfigForSqueak subclass:#SqueakVAXConfig and configure its relevant data/methods for that platform. - - An example of Configuration customization at the platform level is in the executableType method. - - SystemNavigation default browseMethodsWhoseNamesContain: ''executableType'' - - Here, we see that CPlatformConfForSqueak requires that a subclass implement it. The other subclasses may impliment it with an appropriate return value. - - Configurations are further refined as we proceed down the heirarchy. - - SqueakMacOSX32x86Config browseHierarchy - - Here we see a (stub) configuration for Mac OSX32 on the x86 processor. - - Our new Linux64x86w32BitSqueakCogSpurConfig configuration fits into its expected place under the Unix hierarchy. - - Linux64x86w32BitSqueakCogSpurConfig browseHierarchy - - The key and art of customizing our Linux64x86w32BitSqueakCogSpurConfig is to customize our Configuration at the appropriate level. - Higher levels should provide existing, appropriate configuration. Our job is to then implement and customize at the finest level of customization. - - To understand the how and why of customizing a Configuration, we turn to the heavily implemented design pattern I call the "Method Redirect Pattern". - - We cover that next. - - - - - - - - - - - - N.B. The ''Squeak'' prefix is unfortunate as it violates the naming convention. It is a holdover from initial attempts with the Pharo CMakeVMMaker code base. - I will attempt to remember to rename these after the Pharo dependency is removed. - - - - - - - - - - CPlatformConfigForSqueak is a child of CPlatformConfig, the root Configuration in Pharo''''s CMakeVMMaker. - - This is temporary as I have decided to de-couple CMakeVMMakerSqueak from CMakeVMMaker. - - - ToolSet browseMessageCategory:''cmake'' inClass: CPlatformConfigForSqueak!!' readStream nextChunkText! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cmakeAddDefinitions (in category 'pages') ----- - cmakeAddDefinitions - ^HelpTopic - title:'cmakeAddDefinitions' - contents: - 'SystemNavigation browseAllImplementorsOf: #cmakeAddDefinitions - - We see that the CPlatformConfigForSqueak routes the method based on the buildType #build via the Method Redirect pattern to cmakeAddDefinitionsBuild - - SystemNavigation browseAllImplementorsOf: #cmakeAddDefinitionsBuild - - We see that our Linux64x86w32BitSqueakCogSpurConfig already implements it due to our copying of an existing configuration. - - We need to modify this for our Configuration. The current method (minus commented out elements) reads as: - - definitions:=#( - ''-DNDEBUG'' - ''-DDEBUGVM=0'' - '' -DLSB_FIRST=1'' - ''-D_GNU_SOURCE'' - ''-D_FILE_OFFSET_BITS=64'' - ''-DCOGMTVM=0'') . - - Like the cmakeCFlags method, we look at the mvm file - - cat ~/.../Cog/build.linux32x86/squeak.cog.spur/build/mvm - - And see the - 3.4.*) OPT=''-g -O1 -fwrapv -DNDEBUG -DDEBUGVM=o'';; - *) OPT=''-g -O2 -DNDEBUG -DDEBUGVM=0'';; - - lines and the - - CFLAGS=''$OPT -msse2 -D_GNU_SOURCE -D_FILE_OFFSET_BITS=64 -DCOGMTVM=0'' \ - - Based on these mvm file details, I modify the method to read as such: - - definitions:=#( - ''-DNDEBUG'' - ''-DDEBUGVM=0'' - ''-D_GNU_SOURCE'' - ''-D_FILE_OFFSET_BITS=64'' - ''-DCOGMTVM=0'') . - - To match the directives specified in the mvm file - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cmakeAddExecutableNameOptionSource (in category 'pages') ----- - cmakeAddExecutableNameOptionSource - ^HelpTopic - title:'cmakeAddExecutableNameOptionSource:' - contents: - 'SystemNavigation browseAllImplementorsOf: #cmakeAddExecutableNameOptionSource: - - We see this is a top-level method implemented only by CPlatformConfigForSqueak - - The method creates a new CMakeAddExecutableNameOptionSource template - - CMakeAddExecutableNameOptionSource browse - - and the class comment says it "Add an executable to the project using the specified source files." - - To get a sense of the CMake output print the following: - - ((CMakeAddExecutableNameOptionSource new) - executableName: ''cog'' - optionalproperty: '''' - sources: (OrderedCollection with: ''${coreSources} ${crossVMSources} ${platformVMSources} ${extraSources}'')) content - - In looking at this, the exectuableName worries me. I am not sure that ''cog'' is what we want. - - Looking at it... - SystemNavigation browseAllImplementorsOf: #executableName - - it is something we can customize or code if we need. - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cmakeCFlags (in category 'pages') ----- - cmakeCFlags - ^HelpTopic - title:'cmakeCFlags' - contents: - 'SystemNavigation browseAllImplementorsOf: #cmakeCFlags - - We see that CPlatformConfigForSqueak implements it - - The method comment reads in part: - - ''self deprecated: this catchall method has been split into dedicated methods: cmakePrefixPath cmakeIncludePath cmakeLibraryPath cmakeIncludeModules; cmakeCFlags; ...'' - - - And that this method will be refactored out of existence ''soon''. - - Looking at it, we see that the method implements the Method Redirect pattern - - Since we have configured for buildType: #build, the Method Redirect Pattern will invoke the cmakeCFlagsBuild method. - - So we look at the implementors of it.. - - SystemNavigation browseAllImplementorsOf: #cmakeCFlagsBuild - - Here we see that our new Linux64x86w32BitSqueakCogSpurConfig configuration implements it (since we copied an existing Configuration that implemented it) - - We now have something to customize. - - We look at the line: cflags:= String streamContents: [:stream | (self compilerFlags) asStringOn: stream delimiter: '' '' ]. - - and see that our ''self compilerFlags'' method is used. - - SystemNavigation browseAllImplementorsOf: #compilerFlags - - These are flags to pass to the compiler. Take a look at the mwm file in the GNU config - - cat ~/.../Cog/build.linux32x86/squeak.cog.spur/build/mvm - - We see an OPT variable being populated... - - - OPT=''-g -O1 -fwrapv -DNDEBUG -DDEBUGVM=0'';; - OPT=''-g -O2 -DNDEBUG -DDEBUGVM=0'';; - esac - - And later in the file we see the CFLAGS variable being populated with the $OPT variable and some other flags. - - CC=''gcc -m32'' \ - CXX=''g++ -m32'' \ - CFLAGS=''$OPT -msse2 -D_GNU_SOURCE -D_FILE_OFFSET_BITS=64 -DCOGMTVM=0'' \ - LIBS=''-lpthread -luuid'' \ - LDFLAGS=-Wl,-z,now - - That CFLAGS variable is what we are mimicing here. with some caveats... - - The pharo code just dumped all that stuff into one method, whereas I split them up. - - We are ommitting the Compiler defines like -D_GNU_SOURCE as we will be setting those in cmakeAddDefinitions. - - My current compilerFlags (minus commented out elements) method reads like this: - - compilerFlags - ^#( ''-w'' - ''-m32'' - ''-msse2'' - ''-O1'') - - - checking my compiler version - bash-4.2$ gcc --version - gcc (GCC) 4.8.2 - Copyright (C) 2013 Free Software Foundation, Inc. - This is free software; see the source for copying conditions. There is NO - warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. - - I see I need some options from the OPT=''-g -O1 -fwrapv -DNDEBUG -DDEBUGVM=0'' line - line - - - Mimicing the mvm file, I modify it to read as such: - - compilerFlags - ^#(''-g'' - ''-O1'' - ''-fwrapv'' - ''-m32'' - ''-msse2'' - ) - - In doing this, I am congizant that I may have to return to this method as I fiddle around getting this configuration correct. - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cmakeIncludeDirectories (in category 'pages') ----- - cmakeIncludeDirectories - ^HelpTopic - title:'cmakeIncludeDirectories' - contents: - 'SystemNavigation browseAllImplementorsOf: #cmakeIncludeDirectories: - - We see that the sole implementor of the method is the top level configuration CPlatformConfigForSqueak - - The method creates an instance of the CMakeTemplate CMakeIncludeDirectories - - CMakeIncludeDirectories browse - - where the class comment tells us that it tells CMake to add extra ''include'' directories to the build. - - Currently a variable placeholder is hard-coded in CMakeVMGeneratorForSqueak>>includeDirs - You can print the following to see them: - (CMakeVMGeneratorForSqueak new) includeDirs - - And the generated CMake by printing the following: - - ((CMakeIncludeDirectories new) dirs: (OrderedCollection with: (CMakeVMGeneratorForSqueak new) includeDirs)) content - - What you see when you print it are variable placeholders that CMake will populate with the value of CMake variables ${crossDir} - , ${srcVMDir} and ${targetPlatform} that we will be defining or have already been defined in our configuration. - - This is truly a global method and would only change if Eliot changed the layout of the underlying build structure. - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cmakeIncludeModules (in category 'pages') ----- - cmakeIncludeModules - ^HelpTopic - title:'cmakeIncludeModules' - contents: - 'CMake allows the user to include custom CMake library files (modules). - This construct allows the developer to include those modules. - - cmakeIncludeModules implements the Method Redirect pattern. - - ToolSet browse: CPlatformConfigForSqueak selector: #cmakeIncludeModules - - Since the configuration is configured for buildType: #build the method redirect pattern will redirect to - - SystemNavigation browseAllImplementorsOf: #cmakeIncludeModulesBuild. - - We see in CPlatformConfigForSqueak that a sublcass must implement it via ''self subclassResponsibility''. - - We see that (as of this writing) the SqueakUnixConfig handles the method by including some custom modules - Utils.cmake - Plugins.cmake - TestBigEndian - CheckIncludeFile - CheckLibraryExists - CheckTypeSize - CheckFunctionExists - CheckVariableExists - CheckStructHasMember - FindPkgConfig - - These Module wrap CMake constructs and can be thought of as CMake ''include files''. and they are implemented high in the Configuration platform hierarchy. - - Our new Configuration need not override anything here. - - Let''s move on...'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cmakeIncludePath (in category 'pages') ----- - cmakeIncludePath - ^HelpTopic - title:'cmakeIncludePath' - contents: - 'cmakeIncludePath implements the Method Redirect pattern. - - ToolSet browse: CPlatformConfigForSqueak selector: #cmakeIncludePath - - Since the configuration is configured for buildType: #build the method redirect pattern will redirect to - - SystemNavigation browseAllImplementorsOf: #cmakeIncludePathBuild - - We see in CPlatformConfigForSqueak that a sublcass must implement it via ''self subclassResponsibility''. - - We see that (as of this writing) the SqueakUnixConfig handles the method, but only for debug messages. - - There is a possibility a sub-platform will have include files in a non-standard directories and a specific Configuration - will have to implement this to generate appropriate CMake output. - - At this moment, we conclude we don''t need to. - - Since I am writing this help in tandem with generating a new Configuration, there is the possibility I am wrong and that I will need this. - - Since I don''t know for a fact that it is, I leave it alone for now.'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cmakeLibraryPath (in category 'pages') ----- - cmakeLibraryPath - ^HelpTopic - title:'cmakeLibraryPath' - contents: - 'cmakeLibraryPath implements the Method Redirect pattern. - - ToolSet browse: CPlatformConfigForSqueak selector: #cmakeLibraryPath - - Since the configuration is configured for buildType: #build the method redirect pattern will redirect to - - SystemNavigation browseAllImplementorsOf: #cmakeLibraryPathBuild. - - We see in CPlatformConfigForSqueak that a sublcass must implement it via ''self subclassResponsibility''. - - We see that (as of this writing) the SqueakUnixConfig handles the method, but only for debug messages. - - There is a possibility a sub-platform will have libraries in a non-standard directories and a specific Configuration - will have to implement this to generate appropriate CMake output. - - At this moment, we conclude we don''t need to. - - Since I am writing this help in tandem with generating a new Configuration, there is the possibility I am wrong and that I will need this. - - Since I don''t know for a fact that it is, I leave it alone for now. - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cmakeListAppend: (in category 'pages') ----- - cmakeListAppend:LINKLIBSelements - ^HelpTopic - title:'cmakeListAppend:LINKLIBSelements' - contents: - ' - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cmakeListAppendLINKLIBSelements (in category 'pages') ----- - cmakeListAppendLINKLIBSelements - ^HelpTopic - title:'cmakeListAppendLINKLIBSelements' - contents: - 'SystemNavigation browseAllImplementorsOf: #cmakeListAppend:elements: - - We see this is a top-level method. - - The method creates a new CMakeListAppend which according to the class comment ''I handle the APPEND functionality for the cmake list commmand.''. - - Here we are appending libraries to link to the list LINKLIBS. - - You can get a sense of the CMake output by evaluating. - - ((CMakeListAppend new) list:''LINKLIBS'' elements:#((''-L/usr/lib'' ''-L/usr/lib/X11'' ''uuid'' ''ssl'' ''crypto'' ''m'' ''dl'' ''pthread'' ''SM'' ''ICE'' ''GL'' ''X11'' ''nsl''))) content - - The list of libraries is available via the configurations ''externalLibs'' method. - - SystemNavigation browseAllImplementorsOf: #externalLibs - - Which we see implements the Method Redirect pattern. - - Since this is a #build buildType we look in - - SystemNavigation browseAllImplementorsOf: #externalLibsBuild - - And we see the CPlatformConfigForSqueak subclasses responsibility and that our new Linux64x86w32BitSqueakCogSpurConfig implements it as - - externalLibsBuild - ^self externalLibraries asOrderedCollection. - - which is contained in its parent as - - externalLibraries - ^#( - ''-L/usr/lib'' - ''-L/usr/lib/X11'' - ...... - etc... - ) - - - So, we see the ability to specify what libraries we want to link against in our configuration. - - Where to do this in the Configuration heirarchy is a matter of judgement. - - We will leave this one alone, bearing in mind that if we have a library linking problem, we have an idea where to look for it. - - - - - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cmakePrefixPath (in category 'pages') ----- - cmakePrefixPath - ^HelpTopic - title:'cmakePrefixPath' - contents: - 'ToolSet browse: CPlatformConfigForSqueak selector: #cmakePrefixPath - - cmakePrefixPath implements the Method Redirect pattern. - - Since the configuration is configured for buildType: #build the method redirect pattern will redirect to - - SystemNavigation browseAllImplementorsOf: #cmakePrefixPathBuild - - We see in CPlatformConfigForSqueak that a sublcass must implement it via ''self subclassResponsibility''. - - We see that (as of this writing) the SqueakUnixConfig handles the method. - - We reason that this method generates platform specific CMake output and our lower-level Configuration need not override it. - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cmakeSetSourceFilesProperties (in category 'pages') ----- - cmakeSetSourceFilesProperties - ^HelpTopic - title:'cmakeSetSourceFilesProperties' - contents: - 'SystemNavigation browseAllImplementorsOf: #cmakeSetSourceFilesProperties - - SystemNavigation browseAllImplementorsOf: #cmakeSetSourceFilesPropertiesBuild - - We see that the CPlatformConfigForSqueak subclasses responsibility (scroll down past the method comment) - - We also see that our new Linux64x86w32BitSqueakCogSpurConfig Configuration implements it. - - I suspect this method will be refactored upwards. It appears to be passing distinct compiler flags to the cogit.c and sqUnixHeartbeat.c. - - - Let''s leave this one alone. - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cmakeWriteDirectoriesDotCmake (in category 'pages') ----- - cmakeWriteDirectoriesDotCmake - ^HelpTopic - title:'cmakeWriteDirectoriesDotCmake' - contents: - 'SystemNavigation browseAllImplementorsOf: #cmakeWriteDirectoriesDotCmake: - - Here we see that the CPlatformConfigForSqueak forces subclasses to implement this . - - This method sets some CMake variables to platform specific values and writes them to a file named ''directories.cmake'' - - Here is the directories.cmake file contents on my platform - - bash-4.2$ cat directories.cmake - set(topDir "/home/tty/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm") - set(buildDir "/home/tty/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/cmake.build.linux64x86w32BitCompatibility/squeak.cog.v3/build") - set(thirdpartyDir "${buildDir}/thirdParty") - set(platformsDir "/home/tty/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/platforms") - set(srcDir "/home/tty/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/src") - set(srcPluginsDir "${srcDir}/plugins") - set(srcVMDir "${srcDir}/vm") - set(platformName "unix") - set(targetPlatform "${platformsDir}/${platformName}") - set(crossDir "${platformsDir}/Cross") - set(platformVMDir "${targetPlatform}/vm}") - set(outputDir "/home/tty/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/cmake.products/squeak.cog.v3") - set(externalModulesDir "${outputDir}") - - EOF - - The file contains CMake ''set'' commands that bind a variable to a value. - - In this application, CMake commands are encapsulated as objects and the CMake Set command is no exception: - - CMakeSet browse - - Taking the set(platformName,"unix") command as an example, we see the rationale for sublcassing this construct to the platform specific subclasses. - - - There is nothing for us to do here, HOWEVER, we will be customizing some variables that compose this. For example: - set(srcDir "some path to a source directory") can take any of the below directory names: - - nsspur64src - nsspursrc - nsspurstack64src - nsspurstacksrc - nssrc - spur64src - spursistasrc - spursrc - spurstack64src - spurstacksrc - src - stacksrc - - - - - - - - - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cogitClass (in category 'pages') ----- - cogitClass - ^HelpTopic - title:'cogitClass' - contents: - ' - write me. - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>compilingLinkingSetup (in category 'pages') ----- - compilingLinkingSetup - ^HelpTopic - title:'Compiling and Linking Setup' - contents: - 'In your concrete configuration''s ''compiling'' protocol contains the methods that you must customize for your Configuration - - cmakeAddDefinitionsBuild - cmakeCFlagsBuild - externalLibsBuild - linkerFlags - - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>configGenerateByTemplate (in category 'pages') ----- - configGenerateByTemplate - ^HelpTopic - title:'config generate by template' - contents: - ' - write me: generate by template is in several places. including the unix config and the vm and plugin generators - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>configureAbstractBaseClass (in category 'pages') ----- - configureAbstractBaseClass - ^HelpTopic - title:'Configure Abstract Base Class' - contents: - 'Abstract Base Classes contain configuration information for a specific platform. - - Let''s start from the top and work are way down. evaluate: - - CPlatformConfigForSqueak browseHierarchy - - CPlatformConfigForSqueak is a fairly involved class, but focusing on the protocol ''cmake directory'' for now, we see a bunch of dirFOO methods. - - selectinng: - - CPlatformConfigForSqueak >>dirLinux32x86 - ^''cmake.build.linux32x86'' - - We see the top-level directory for our new platform specific build. - - The next level down in our hierarchy is SqueakUnixConfig which contains configuration info specific to Unix platforms. An example being: - - SqueakUnixConfig>>platformName - ^self unixPlatformName - - - The next level down is our Abstract Base Class for our specific variant of Unix--specifically Linux32x86Config. - - The methods in this class contain system wide configuratin information for this Platform. On a mature platform tree, this class''s configuration should be rock-solid. However, as of 2014.12.09, the Abstract Base Class has not been configured correctly and I must set it up here. - - Setting it up is not difficult and an existing Abstract Base Class can provide a good starting point. However, a familiarity with the design patterns of the Configurations is helpful (particularly the Redirect Method pattern) - - HelpBrowser openOn: CMakeVMMakerSqueakDesignPatternsHelp - - - - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>createTheConfiguration (in category 'pages') ----- - createTheConfiguration - ^HelpTopic - title:'Create the Configuration' - contents: - 'Our new Concrete Configuration must be created as a subclass of our Platform''s Abstract Base Class. - - SInce I am creating a Squeak Cog Spur config for the CMakeVMMakerSqueak-Linux64X86-32BitCompatibility Platform I choose the name: - - Linux64x86w32BitSqueakCogSpurConfig. - - (For a discussion on naming conventions evaluate: - HelpBrowser openOn: CMakeVMMakerSqueakOverviewHelp - ) - - To create it, I must subclass the Abstract Base Class for my Platform like so: - - Linux64x86w32BitConfigUsrLib subclass: #Linux64x86w32BitSqueakCogSpurConfig - instanceVariableNames: '' - classVariableNames: '' - poolDictionaries: '' - category: ''CMakeVMMakerSqueak-Linux64X86-32BitCompatibility'' - - However, being lazy, I am going to copy an existing Configuration that is similar to what I want. - - Today I choose Linux64x86w32BitSqueakCogV3Config from the CMakeVMMakerSqueak-Linux64X86-32BitCompatibility Platform category - - I copy the class and then change its name, parent and class category to get: - - Linux64x86w32BitConfigUsrLib subclass: #Linux64x86w32BitSqueakCogSpurConfig - instanceVariableNames: '' - classVariableNames: '' - poolDictionaries: '' - category: ''CMakeVMMakerSqueak-Linux64X86-32BitCompatibility'' - - - I then query by Builder to see if it sees the new Configuration in the platform: - - SqueakLinux64x86w32CompatBuilder configurationsCategory - --> ''CMakeVMMakerSqueak-Linux64X86-32BitCompatibility'' - - SqueakLinux64x86w32CompatBuilder availableBuildConfigurations - --> a SortedCollection(#Linux64x86w32BitSqueakCogSpurConfig #Linux64x86w32BitSqueakCogV3Config) - "Here we see our new Configuration is visible to the Builder" - - SqueakLinux64x86w32CompatBuilder unAvailableBuildConfigurations - --> a SortedCollection(#Linux64x86w32BitConfigUsrLib #Linux64x86w32BitConfigUsrLib32) "Our Abstract Base Classes are not available to be built" - - SqueakLinux64x86w32CompatBuilder availableBuildTypesFor: #Linux64x86w32BitSqueakCogSpurConfig - --> an OrderedCollection(#build #buildAssert) "The Configuration I copied has two Build Types coded and available." - - - SqueakLinux64x86w32CompatBuilder sourceDirectoryFor:#Linux64x86w32BitSqueakCogSpurConfig - --> "src" "Where the vm source code is located (we will be changing this)" - - My new configuration is correctly named and in the correct place. - - At this point I re-run all my Tests. - TestRunner open - For me, all tests pass. - - In the next topic we cover how to hide our new Configuration from a builder. - - ' - ! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>customizePlugins (in category 'pages') ----- - customizePlugins - ^HelpTopic - title:'customize Plugins' - contents: - 'We can customize which plugins we want on our configuration by overriding our platform''s defaultExternalPlugins and defaultInternalPlugins methods. - - The default set can be further customized according to buildType if desired via the externalPlugins[BuildType] and internalPlugins[BuildType] redirect pattern - - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>customizeVMDrivers (in category 'pages') ----- - customizeVMDrivers - ^HelpTopic - title:'Specify VM Drivers' - contents: - 'The SqueakUnixConfig contains the unverisal list of VM Drivers for *nix. - - In our concrete Configuration, we need to specify which ones we want for out build. - - We do this by overloading the SqueakUnixConfig>>customizeVMDrivers method. - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>dirBuildLanguageVMMM (in category 'pages') ----- - dirBuildLanguageVMMM - ^HelpTopic - title:'Specify dirBuildLanguageVMMM' - contents: - ' - SystemNavigation new browseAllImplementorsOf: #dirBuildLanguageVMMM localTo:CPlatformConfigForSqueak. - - We scroll down to our Linux64x86w32BitSqueakCogSpurConfig which we copied from the existing Linux64x86w32BitSqueakCogV3Config. - - Looking at the dirBuildLanguageVMMM it initially reads (due to the copying of the existing class) - - dirBuildLanguageVMMM - ^self squeakCogV3 - - Since this is a configuration for Squeak Cog Spur, I modify the method to return - - dirBuildLanguageVMMM - ^self squeakCogSpur - - - As a sanity check, I verify that the method squeakCogSpur exists... - - SystemNavigation new browseAllImplementorsOf: #squeakCogSpur - - And we see the method exists and will return the sting ''squeak.cog.spur''. - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>dirSource (in category 'pages') ----- - dirSource - ^HelpTopic - title:'Specify Source Directory' - contents: - ' - Eliot''s VMMaker.oscog package outputs c-source code to varios directories depending ont he vm type. - - SystemNavigation new browseAllImplementorsOf: #dirSource localTo:CPlatformConfigForSqueak. - - Evaluating the above, we see that the CPlatformConfigForSqueak lists the available source directories. - - The string values for these things are hard-coded in CPlatformConfigForSqueak in the ''cmake source names'' category. - - ToolSet browse: CPlatformConfigForSqueak category: ''cmake source names'' - - For our Linux64x86w32BitSqueakCogSpurConfig we choose ''spursrc'' as our dirSource return value - - dirSource - ^self spursrc - - which you can test here. - - (Linux64x86w32BitSqueakCogSpurConfig basicNew) dirSource - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>excludingConfigFromBuilds (in category 'pages') ----- - excludingConfigFromBuilds - ^HelpTopic - title:'Excluding a Config From Builds' - contents: - 'Configurations can hide themselves from , or make themselves visible to Builders via their ''excludeFromBuild'' method. - - excludeFromBuild - ^false "build this configuration" - " ^true do not build this configuration" - - In our case, the Builder shows us that Linux32x86SqueakCogSpurConfig is capable of being built (I had copied an existing, working Configuration): - - SqueakLinux64x86w32CompatBuilder availableBuildConfigurations - --> a SortedCollection(#Linux64x86w32BitSqueakCogSpurConfig #Linux64x86w32BitSqueakCogV3Config) - - - To exclude it, override (or alter) the Configurations ''excludeFromBuild'' method - - Linux64x86w32BitSqueakCogSpurConfig >>excludeFromBuild - "over-ride to exclude yourself from a build" - ^true - - And the Configuration is hidden from the Builder... - - SqueakLinux64x86w32CompatBuilder availableBuildConfigurations - --> a SortedCollection(#Linux64x86w32BitSqueakCogV3Config) - - - However, since I am developing locally, I need it to be visible to the Builder , so I set it as so: - - Linux64x86w32BitSqueakCogSpurConfig >>excludeFromBuild - "over-ride to exclude yourself from a build" - ^false - - And my Builder can see it again... - - SqueakLinux64x86w32CompatBuilder availableBuildConfigurations - --> a SortedCollection(#Linux64x86w32BitSqueakCogSpurConfig #Linux64x86w32BitSqueakCogV3Config) - - - N.B. tty. My opinion is that this is a weak way of doing this, but I have not thought through how to do this elegantly. - This functionality is included with an eye towards easing automated builds for all platforms and configurations.'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>extraVMSettings (in category 'pages') ----- - extraVMSettings - ^HelpTopic - title:'extraVMSettings' - contents: - 'SystemNavigation browseAllImplementorsOf: #extraVMSettings: - - - In the CPlatformConfigForSqueak>>extraVMSettings: aMaker, we see the Method Redirect Pattern employed. Since this is for buildType #build, the method will re-route to self extraVMSettingsBuild: - - SystemNavigation browseAllImplementorsOf: #extraVMSettingsBuild: - - We see the CPLatformConfigForSqueak forces a subclass to implement it and the SqueakUnixConfig implements it. - - In SqueakUnixConfig a CMakeAddCustomCommandOutput is created and initialized. - - CMakeAddCustomCommandOutput browse - - The class comment says that: ''Add a custom build rule to the generated build system.'' - - - If you look in the file Cog/platforms/unix/config/verstamp you see that this is (looks like) the definition/implemenation of the command CMake - will invoke. - - - Currently this is a platform level method. Honestly, I have no idea why it is there. (: - - For our purposes, there is nothing we need to do. - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>firstCMakeGeneration (in category 'pages') ----- - firstCMakeGeneration - "This method was automatically generated. Edit it using:" - "a HelpBrowser edit: #firstCMakeGeneration" - ^HelpTopic - title: 'First CMake Generation' - contents: - 'For didactic purposes I am going to do a sanity check and generate CMake code from the configuration for the first time. - - If you are not familiar with the CMakeVMMakerSqueak naming conventions, please evaluate: - HelpBrowser openOn: CMakeVMMakerSqueakOverviewHelp - - On my system a copy of the Cog svn tree is located under my current working Squeak directory in the folder ''oscogvm". - - It looks like this: - - bash-4.2$ ls --width=1 ~/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/ - README - build - build.linux32ARM - build.linux32x86 - build.linux64x64 - build.macos32x86 - build.macos64x64 - build.win32x86 - history - mkNamedPrims.sh - nsspur64src - nsspursrc - nsspurstack64src - nsspurstacksrc - nssrc - platforms - processors - products - scripts - sources - spur64src - spursistasrc - spursrc - spurstack64src - spurstacksrc - src - stacksrc - - What I want to do is see if my configuration will write its output to an appropriate CMake subfolder. - - To do this, I ask the Builder to configure my new configuration for a buildType and output its contents. I do so by evaluating: - - SqueakLinux64x86w32CompatBuilder - configureA: #Linux32x86SqueakCogSpurConfig forBuildType:#build; - enableMessageTracking: true; - generateByTemplate. - - - and look again - bash-4.2$ ls --width=1 usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/ - CHANGES - LICENSE - README - build - build.linux32ARM - build.linux32x86 - build.linux64x64 - build.macos32x86 - build.macos64x64 - build.win32x86 - cmake.build.linux64x86w32BitCompatibility <--Here is the directory created by my configuration. - history - .... - - Above we see that a new cmake.build.linux64x86w32BitCompatibility directory has been created. Let''s look at its contents - - tree -d ~/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/cmake.build.linux64x86w32BitCompatibility/ - `-- squeak.cog.v3 <--We will be changing this later as we want a squeak.cog.spur directory, not a V3 directory - `-- build <--our build type is #build - |-- ADPCMCodecPlugin - |-- AsynchFilePlugin - |-- B2DPlugin - |-- BMPReadWriterPlugin - |-- BitBltPlugin - |-- CroquetPlugin - |-- DSAPrims - |-- DropPlugin - |-- FFTPlugin - |-- FileCopyPlugin - |-- FilePlugin - |-- FloatArrayPlugin - |-- FloatMathPlugin - |-- JoystickTabletPlugin - |-- Klatt - |-- LargeIntegers - |-- LocalePlugin - |-- MIDIPlugin - |-- Matrix2x3Plugin - |-- MiscPrimitivePlugin - |-- Mpeg3Plugin - |-- SecurityPlugin - |-- SerialPlugin - |-- SocketPlugin - |-- SoundCodecPrims - |-- SoundGenerationPlugin - |-- SoundPlugin - |-- StarSqueakPlugin - |-- SurfacePlugin - |-- ZipPlugin - |-- vm-display-X11 - |-- vm-display-null - |-- vm-sound-ALSA - `-- vm-sound-null - - ...etc - We see that the configuration has output a CMake build tree and we have done a sanity check. - - Next we take stock of what we have accomplished and preview the remaining tasks. - - !!' readStream nextChunkText! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>forTheImpatient (in category 'pages') ----- - forTheImpatient - ^HelpTopic - title:'For the impatient' - contents: - 'Here is the TL;DR synopsis of the methods* I implemented or overrode in creating the Linux64x86w32BitSqueakCogSpurConfig. - - A step-by-step exposition begins on the next page. - - dirBuildLanguageVMMM - specifyProductDirectories - cmakeCFlags - cmakeAddDefinitions - cmakeIncludePath - cmakeLibraryPath - compilerFlags - cmakeAddDefinitions - preferredIncludes - setGlobalOptionsAfterDetermineSystem: - cmakeSetSourceFilesProperties - externalLibs - cmakeAddExecutableNameOptionSource: - customizeVMPlugins - specifyingPlugins - - - *If the method uses the Method Redirect Pattern then (in most instances) the method to modify will be for the buildType. ie. ''methodnameBuildType'' - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>generatePluginConfigs (in category 'pages') ----- - generatePluginConfigs - ^HelpTopic - title:'generatePluginConfigs' - contents: - 'This method iterates over a collection of InterpreterPlugin subclasses and asks each class to populate itself with some basic information and write out its own CMakeLists.txt in a directory named after the plugin name. - - The processing is a bit complicated, but the setup is easy. - - The collections of plugin classes are stored in our Configuration. We cover that next in Specifying Plugins'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>identifyBuilder (in category 'pages') ----- - identifyBuilder - ^HelpTopic - title:'Identify Builder' - contents: - 'My new Configuration will be managed by a Builder. - - Builders are located in the CMakeVMMakerSqueak-Builder class category. - - Builders are subclasses of SqueakCMakeVMMakerAbstractBuilder. - SqueakCMakeVMMakerAbstractBuilder browseHierarchy - - Builders are named according to the Platform they manage. - - (For a discussion on naming conventions evaluate: - HelpBrowser openOn: CMakeVMMakerSqueakOverviewHelp - ) - - Builders manage configurations for one Platform in one class category. - - - My platform is Linux Linux64x86 with 32 bit compatability libs stored in /usr/lib (other linux use /usr/lib32 for this.) - - I suspect that the SqueakLinux64x86w32CompatBuilder as the Builder that will manage my new configuration. - - I confirm this by sending it the ''configurationsCategory'' message as shown below: - - SqueakLinux64x86w32CompatBuilder configurationsCategory - -->''CMakeVMMakerSqueak-Linux64X86-32BitCompatibility'' <---this is the correct class category for my Platform. - - This is correct Builder for my new Configuration. - - I can query the Builder for some more information: - - SqueakLinux64x86w32CompatBuilder availableBuildConfigurations - a SortedCollection(#Linux64x86w32BitSqueakCogV3Config) <--A Cog V3 configuration exists. - - SqueakLinux64x86w32CompatBuilder unAvailableBuildConfigurations - --> a SortedCollection(#Linux64x86w32BitConfigUsrLib #Linux64x86w32BitConfigUsrLib32) - <--these are platform specific Abstract Base Classes. Abstract Base Classes cannot be built, hence they are unavailable. - - SqueakLinux64x86w32CompatBuilder buildDirectory - -->''cmake.build.linux64x86w32BitCompatibility'' <--this matches my platform - - We will be using the SqueakLinux64x86w32CompatBuilder in tandem with Tests during Configuration development.' - - ! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>identifyPlatform (in category 'pages') ----- - identifyPlatform - ^HelpTopic - title:'Identify Platform' - contents: - 'My target platform is 64 bit Linux on X86 with 32 bit compatibility libraries stored in /usr/lib. - - I identify my Platform in the existing CMakeVMMakerSqueak-xyz class categories. - - - If I wanted a configuration for MacOSX32x86, I would place my configuration in CMakeVMMakerSqueak-MacOSX32x86. - If SunOSx3x86 then CMakeVMMakerSqueak-SunOS32x86. - etc. - - For a discussion on naming conventions evaluate: - HelpBrowser openOn: CMakeVMMakerSqueakOverviewHelp - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>identifyPlatformAbstractBaseClass (in category 'pages') ----- - identifyPlatformAbstractBaseClass - ^HelpTopic - title:'Identify Abstract Base Class ' - contents: - 'My new configuration must be a subclass of my Platform''s Abstract Base Class. - - A Platform Abstract Base Class encapsulates common platform information. - - In CMakeVMMakerSqueak-Linux64X86-32BitCompatibility class category I see two Abstract Base Classes (typically there is only one). They are: - - Linux64x86w32BitConfigUsrLib - Linux64x86w32BitConfigUsrLib32 - - The Suffixes ''UsrLib'' and ''UsrLib32'' refer to the location of the 32 bit compatablity libs. - On my system they are in /usr/lib, so I choose Linux64x86w32BitConfigUsrLib as my Abstract Base Class - - Examples of Abstract Base Classes in other class categories include: - - CMakeVMMakerSqueak-BSD32x86 -> SqueakBSD32x86Config - CMakeVMMakerSqueak-IA32-Bochs -> SqueakIA32BochsConfig - CMakeVMMakerSqueak-IOS -> SqueakIOSConfig - CMakeVMMakerSqueak-IOS -> SqueakIOSConfig - CMakeVMMakerSqueak-Linux32ARMv6 -> Linux32ARMv6Config - CMakeVMMakerSqueak-Linux64x64 -> Linux64x64Config - CMakeVMMakerSqueak-MacOSPowerPC -> SqueakMacOSXPowerPCConfig - CMakeVMMakerSqueak-MacOSX32x86 -> SqueakMacOSX32x86Config - CMakeVMMakerSqueak-SunOS32x86 -> SqueakSunOS32x86Config - CMakeVMMakerSqueak-Win32x86 -> SqueakWin32x86Config - - I can identify the Abstract Base Class in several ways - - 1. It is a topmost class in the class heirarchy for that platform/class category - 2. It is named after its platform - 3. It answers #true to the message isAbstractBaseClass - Linux64x86w32BitConfigUsrLib isAbstractBaseClass - --> true - - In this workflow example I ideduce that the AbstractBaseClass for my Platform is Linux64x86w32BitConfigUsrLib'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>key (in category 'accessing') ----- - key - ^'CMakeVMMakerSqueakStepByStepNewConfigurationHelp'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>methodRedirectPattern (in category 'pages') ----- - methodRedirectPattern - ^HelpTopic - title:'Review of Method Redirect Pattern' - contents: - 'The CPlatformConfigForSqueak provides methods that must be implemented at some level in the CPlatformConfigForSqueak hierarchy. - The design pattern is heavily used and you can get a sense of its scope by evaluating: - - ToolSet browseMessageCategory: ''cmake buildType redirects'' inClass:CPlatformConfigForSqueak - - The naming of the redirect methods follows a consistent pattern. - - fooBuild; - fooBuildAssert - fooBuildAssertITimerHeartbeat - fooBuildDebug - fooBuildDebugITimerHeartbeat - fooBuildITimerHeartbeat - fooBuildMultiThreaded - fooBuildMultiThreadedAssert - fooBuildMultiThreadedDebug - fooNoBuildType - - Where the suffix to ''foo'' denotes a specific buildType out of the available pool specified here: - - SqueakCMakeVMMakerAbstractBuilder allBuildTypes - - - The CPlatformConfigForSqueak either (rarely) implements or requires that at least one of these methods are implemented as such: - - fooBuild - self subclassResponsibility - - - At the same time, it does not require that all of them be implemented. It accomplishes this by defaulting to the ''fooBuild'' method: - - fooBuildAssertITimerHeartbeat - ^ self fooBuild - - You can see the ''foo'' pattern here in the ''cmakeAddDefinitions'' method - - SystemNavigation new browseAllImplementorsOf: #cmakeAddDefinitionsBuildMultiThreadedAssert localTo: CPlatformConfigForSqueak. - - Most buildTypes are redirected to a default implementation. This default implementation is implemented at an appropriate level in the CPlatformConfigHeirarchy - - There are some redirect methods that are appropriate to CPlatformConfigForSqueak; for example: - - SystemNavigation new browseAllImplementorsOf: #setGlobalOptionsBuild: localTo: CPlatformConfigForSqueak. - - Most methods are implemented lower in the hierarchy. - - When we implement a Configuration, we are implementing and or overriding methods in CMakePlatformConfigForSqueak that are appropriate for our buildType. - - The Method Redirect Pattern is covered in detail in an existing Help topic. - - HelpBrowser openOn: CMakeVMMakerSqueakDesignPatternsHelp - - Invocation of the Method Redirect Pattern occurs in the VMGenerator. We cover that next. - - ' - - ! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>overview (in category 'pages') ----- - overview - ^HelpTopic - title:'Overview' - contents: - 'This Help Topic presents the workflow the author used in creating the Squeak, Cog, Spur CMake configuration for a 64 bit Slackware 14.1 system.with 32 bit compatability libs in /usr/lib - - Although some details will be different, the steps involved should be the same for any platform.'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>pages (in category 'accessing') ----- - pages - - "platformSources...cogitClass...src vs vmsrc" - ^#( - platformSources - cogitClass - vmsrc - configGenerateByTemplate - overview - tests - identifyPlatform - identifyPlatformAbstractBaseClass - identifyBuilder - createTheConfiguration - excludingConfigFromBuilds - setAvailableBuildTypes - firstCMakeGeneration - tackingStockOne - cPlatformConfigForSqueak - methodRedirectPattern - theVMGenerator - tackingStockTwo - forTheImpatient - specifyDirectories - setGlobalOptions - cmakePrefixPath - cmakeIncludePath - cmakeLibraryPath - cmakeIncludeModules - cmakeCFlags - cmakeAddDefinitions - cmakeWriteDirectoriesDotCmake - cmakeIncludeDirectories - preferredIncludes - standardIncludes - setGlobalOptionsAfterDetermineSystem - extraVMSettings - setCoreSources - setPlatformSources - setCrossSources - setExtraSources - cmakeSetSourceFilesProperties - cmakeListAppendLINKLIBSelements - cmakeAddExecutableNameOptionSource - setExecutableOutputPath - addVMPlugins - generatePluginConfigs - specifyPlugins - - processThirdpartyLibraries - processPlugins - postBuildActions - - setConfigurationDirectory - compilingLinkingSetup - customizeVMDrivers - - aNoteOnFoo - ) - - ! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>platformSources (in category 'pages') ----- - platformSources - ^HelpTopic - title:'platformSources' - contents: - 'write me - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>postBuildActions (in category 'pages') ----- - postBuildActions - ^HelpTopic - title:'postBuildActions:' - contents: - 'postBuildActions: implements the Method Redirect pattern. - - ToolSet browse: CPlatformConfigForSqueak selector: #postBuildActions: - - Since the configuration is configured for buildType: #build the method redirect pattern will redirect to - - SystemNavigation browseAllImplementorsOf: #postBuildActionsBuild: - - We see in CPlatformConfigForSqueak that a sublcass must implement it via ''self subclassResponsibility''. - - The platform Config SqueakUnixConfig implements this. It can be over-ridden or extended as needed. - - We have nothing new to do here. - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>preferredIncludes (in category 'pages') ----- - preferredIncludes - ^HelpTopic - title:'preferredIncludes' - contents: - 'SystemNavigation browseAllImplementorsOf: #preferredIncludes - - CPlatformConfig browseHierarchy - - As of CMakeVMMakerSqueak-tty.114 the method is a legacy method from the pharo CPlatformConfig. It is expect it (and this help page!!) will go away on a refactoring pass when the dependency on the pharo package is removed. - - - In the CPlatformConfigForSqueak>>preferredIncludes, we see the Method Redirect Pattern employed. Since this is for buildType #build, the method will re-route to self preferredIncludesBuild. - - SystemNavigation browseAllImplementorsOf: #preferredIncludesBuild - - We see that #preferredIncludesBuild is subclassed and implemented below the the platform level and down at the architecture/library location, one level above our new configuration. - - Linux64x86w32BitConfigUsrLib browseHierarchy - - The method itself creates a CMakeIncludeDirectories CMake template - - CMakeIncludeDirectories browse - - The class comment tells us that we can add custom include directories for CMake to use. - - The CMake template class initializes itself with some default data, which you can print out here: - - (CMakeIncludeDirectories new) content - - Since this is handled for us one level above our new configuration, we will leave this one untouched. If it turns out that we need to include some other directories, we can override the method.'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>processPlugins (in category 'pages') ----- - processPlugins - ^HelpTopic - title:'Process Plugins' - contents: - 'SystemNavigation browseAllImplementorsOf: #processPlugins: - - This method is inhereted from the pharo code. I do not fully understand the reasoning behind it. I expect it will be refactored or rewritten. - See the method comment in - SystemNavigation browseAllImplementorsOf: #initializeConfigDotCmakeFiles - - Presently it does (at least) three things. - - First, it adds plugin information to the master CMakeLists.txt file typically the add_subdirectory(''PluginName'') cmake command. - - Second, it adds plugin information to the master CMakeLists.txt file from the CMakePluginGeneratorForSqueak>>configDotSomePluginName group of methods - - - SystemNavigation browseAllImplementorsOf: #configDotFilePlugin - - - Third it generates the sqNamedPrims.h file reproduced below. - - bash-4.2$ cat sqNamedPrims.h - /* This is automatically generated file using CVMMaker on 9 May 2016 2:26:20.906098 pm */ - extern sqExport vm_exports[]; - extern sqExport os_exports[]; - extern sqExport ADPCMCodecPlugin_exports []; - extern sqExport AsynchFilePlugin_exports []; - extern sqExport B2DPlugin_exports []; - extern sqExport BitBltPlugin_exports []; - extern sqExport BMPReadWriterPlugin_exports []; - extern sqExport CroquetPlugin_exports []; - extern sqExport ZipPlugin_exports []; - extern sqExport DropPlugin_exports []; - extern sqExport DSAPrims_exports []; - extern sqExport FFTPlugin_exports []; - extern sqExport FileCopyPlugin_exports []; - extern sqExport FilePlugin_exports []; - extern sqExport FloatArrayPlugin_exports []; - extern sqExport FloatMathPlugin_exports []; - extern sqExport JoystickTabletPlugin_exports []; - extern sqExport Klatt_exports []; - extern sqExport LargeIntegers_exports []; - extern sqExport Matrix2x3Plugin_exports []; - extern sqExport MIDIPlugin_exports []; - extern sqExport MiscPrimitivePlugin_exports []; - extern sqExport Mpeg3Plugin_exports []; - extern sqExport SecurityPlugin_exports []; - extern sqExport SerialPlugin_exports []; - extern sqExport SocketPlugin_exports []; - extern sqExport SoundCodecPrims_exports []; - extern sqExport SoundPlugin_exports []; - extern sqExport StarSqueakPlugin_exports []; - extern sqExport SurfacePlugin_exports []; - extern sqExport LocalePlugin_exports []; - - sqExport *pluginExports[] = { - vm_exports, - os_exports, - ADPCMCodecPlugin_exports, - AsynchFilePlugin_exports, - B2DPlugin_exports, - BitBltPlugin_exports, - BMPReadWriterPlugin_exports, - CroquetPlugin_exports, - ZipPlugin_exports, - DropPlugin_exports, - DSAPrims_exports, - FFTPlugin_exports, - FileCopyPlugin_exports, - FilePlugin_exports, - FloatArrayPlugin_exports, - FloatMathPlugin_exports, - JoystickTabletPlugin_exports, - Klatt_exports, - LargeIntegers_exports, - Matrix2x3Plugin_exports, - MIDIPlugin_exports, - MiscPrimitivePlugin_exports, - Mpeg3Plugin_exports, - SecurityPlugin_exports, - SerialPlugin_exports, - SocketPlugin_exports, - SoundCodecPrims_exports, - SoundPlugin_exports, - StarSqueakPlugin_exports, - SurfacePlugin_exports, - LocalePlugin_exports, - NULL - - - - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>processThirdpartyLibraries (in category 'pages') ----- - processThirdpartyLibraries - ^HelpTopic - title:'Process Third Party Libraries' - contents: - 'SystemNavigation browseAllImplementorsOf: #processThirdpartyLibraries - - I have no idea what this does. It exists in the pharo codebase. - - If I do figure out its utility, then the processing architecture will be similar or identical to the Plugin processing. - - i.e. Libraries will be represented by objects which will have the responsibility of generating ''stuff''. - - - - .'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>setAvailableBuildTypes (in category 'pages') ----- - setAvailableBuildTypes - ^HelpTopic - title:'Setting Available Build Types' - contents: - 'Configurations inform Builders what BuildTypes they support. via the availableBuildTypes method - - Here is my Builder asking my new Configuration what build types it supports (remember, this Configuration was copied, so it has been configured already) - - SqueakLinux64x86w32CompatBuilder availableBuildTypesFor: #Linux64x86w32BitSqueakCogSpurConfig - --> an OrderedCollection(#build #buildAssert) - - - In our Abstract Base Class (Which, you recall cannot be built )for our Platform, we default to no build types. - - Linux64x86w32BitConfigUsrLib>>availableBuildTypes - ^SqueakCMakeVMMakerAbstractBuilder default noBuildTypes - - - To get an idea of what buildTypes are available system wide evaluate - SqueakCMakeVMMakerAbstractBuilder default allBuildTypes - -->an OrderedCollection(#build #buildAssert #buildAssertITimerHeartbeat #buildDebug #buildDebugITimerHeartbeat #buildITimerHeartbeat #buildMultiThreaded #buildMultiThreadedAssert #buildMultiThreadedDebug #buildNone) - - - To set the available build types for a Concrete Configurations we override the AbstactBaseClass''s method and SUBTRACT OUT what we do not want. Like so: - - Since I am starting simple, I want my configuration to build a vanilla build. To do this I remove all but #build buildType like so - - Linux64x86w32BitSqueakCogSpurConfig >> availableBuildTypes - ^SqueakCMakeVMMakerAbstractBuilder default allBuildTypes copyWithoutAll: #( #buildAssert #buildAssertITimerHeartbeat #buildDebug #buildDebugITimerHeartbeat #buildITimerHeartbeat #buildMultiThreaded #buildMultiThreadedAssert #buildMultiThreadedDebug #buildNone) - - - As I code more build types in my configuration, I subtract out - - Linux32x86SqueakCogV3Config >> availableBuildTypes - ^SqueakCMakeVMMakerAbstractBuilder default allBuildTypes copyWithoutAll: #( #buildMultiThreadedDebug #buildNone) - - With the result that my Builder shows the removed items as Available Build Types: - - SqueakLinux32x86Builder availableBuildTypesFor: #Linux32x86SqueakCogV3Config - --> an OrderedCollection(#build #buildAssert #buildAssertITimerHeartbeat #buildDebug #buildDebugITimerHeartbeat #buildITimerHeartbeat #buildMultiThreaded #buildMultiThreadedAssert) - - Since I will only be developing the #build buildType for now, I put it as so: - - Linux32x86SqueakCogV3Config>>availableBuildTypes - ^SqueakCMakeVMMakerAbstractBuilder default allBuildTypes copyWithoutAll: #( #buildAssert #buildAssertITimerHeartbeat #buildDebug #buildDebugITimerHeartbeat #buildITimerHeartbeat #buildMultiThreaded #buildMultiThreadedAssert #buildMultiThreadedDebug #buildNone) - - - and verify it is correct: - - SqueakLinux32x86Builder availableBuildTypesFor: #Linux32x86SqueakCogV3Config - -->an OrderedCollection(#build) - - - *N.B. tty. In my opinion, this is a weak design on my part. as it relies on the developer to set it up. If there is an elegant way to do this , I am for it. - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>setConfigurationDirectory (in category 'pages') ----- - setConfigurationDirectory - ^HelpTopic - title:'Set Configuration Directory' - contents: - ' - Need the squeak.cog.spur directory here. - - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>setCoreSources (in category 'pages') ----- - setCoreSources - ^HelpTopic - title:'setCoreSources' - contents: - 'SystemNavigation browseAllImplementorsOf: #setCoreSources: - - We see that this is a top-level Configuration method that writes a CMake Set(foo, bar) construct. - - There is nothing for us to do here.' - - - ! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>setCrossSources (in category 'pages') ----- - setCrossSources - ^HelpTopic - title:'setCrossSources' - contents: - 'SystemNavigation browseAllImplementorsOf: #setCrossSources: - - We see that this is a top-level Configuration method that writes a CMake Set(foo, bar) construct. - - There is nothing for us to do here.' - ! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>setExecutableOutputPath (in category 'pages') ----- - setExecutableOutputPath - "This method was automatically generated. Edit it using:" - "a HelpBrowser edit: #setExecutableOutputPath" - ^HelpTopic - title: 'setExecutableOutputPath' - contents: - 'SystemNavigation browseAllImplementorsOf: #setExecutableOutputPath - - We see that this is implemtented in CPlatformConfigForSqueak. - - It creates a CMakeSet object and sets the ''EXECUTABLE_OUTPUT_PATH'' variable to self outputDir - - SystemNavigation browseAllImplementorsOf: #outputDir - - Which redirects to - - (CPlatformConfigForSqueak basicNew) outputDirName - - The #outputDir method is a legacy method from the pharo code. It should be factored out after the dependency on the pharo code is removed.!!' readStream nextChunkText! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>setExtraSources (in category 'pages') ----- - setExtraSources - ^HelpTopic - title:'setExtraSources' - contents: - 'SystemNavigation browseAllImplementorsOf: #setExtraSources - - We see that this is a top-level Configuration method that writes a CMake Set(foo, bar) construct. - - There is nothing for us to do here. - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>setGlobalOptions (in category 'pages') ----- - setGlobalOptions - ^HelpTopic - title:'setGlobalOptions: self' - contents: - 'For this method there is nothing to do. Here is why. - - Let''s start by seeing what classes implement the method - - SystemNavigation browseAllImplementorsOf: #setGlobalOptions: - - We see that CPlatformConfigForSqueak implements it (The other classes are from the pharo package. These will go way after the dependency on the pharo code is factored out). - - Looking at it, we see that the method implements the Method Redirect pattern - - Since we have configured for buildType: #build, the Method Redirect Pattern will invoke the setGlobalOptionsBuild: aMaker method. - - So we look at the implementors of it.. - - SystemNavigation browseAllImplementorsOf: #setGlobalOptionsBuild: - - We see only CPlatformConfigForSqueak implements the method. Reading the method comments, we see that it generates CMakeLists.txt commands that span all platforms. - - No subclasses of CPlatformConfigForSqueak override it. - - There is nothing for us to override here. Let''s move on. - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>setGlobalOptionsAfterDetermineSystem (in category 'pages') ----- - setGlobalOptionsAfterDetermineSystem - ^HelpTopic - title:'setGlobalOptionsAfterDetermineSystem' - contents: - 'SystemNavigation browseAllImplementorsOf: #setGlobalOptionsAfterDetermineSystem: - - - In the CPlatformConfigForSqueak>>setGlobalOptionsAfterDetermineSystem: aMaker, we see the Method Redirect Pattern employed. Since this is for buildType #build, the method will re-route to self setGlobalOptionsAfterDetermineSystemBuild - - SystemNavigation browseAllImplementorsOf: #setGlobalOptionsAfterDetermineSystemBuild: - - We see the CPLatformConfigForSqueak forces a subclass to implement it and the SqueakUnixConfig implements it. - - In SqueakUnixConfig a CMakeSet is created and initialized. You can see the resultant output by printing the below expression: - - ((CMakeSet new) variable:''CMAKE_C_COMPILER'' value:''gcc'') content - - Currently this is a platform level method, however, we can envision it being set lower when ''gcc'' is not the default compiler. - - For our purposes, there is nothing we need to do. - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>setPlatformSources (in category 'pages') ----- - setPlatformSources - ^HelpTopic - title:'setPlatformSources' - contents:' - SystemNavigation browseAllImplementorsOf: #setPlatformSources: - - We see that this is a top-level Configuration method that writes a CMake Set(foo, bar) construct. - - There is nothing for us to do here.' - ! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>specifyDirectories (in category 'pages') ----- - specifyDirectories - ^HelpTopic - title:'Specify Directories' - contents: - 'Our new Configuration must correctly name two directory trees. - - The first is the cmake.build.* directory tree where the generated CMake output is placed. - The second is the cmake.products/* directory tree where the compiled vm is placed. - - - Correctly naming these is a courtesy you should extend as the system grows*. - - - For this particular Configuration, we want a cmake.build.* directory that looks like this: - - oscogvm/cmake.products/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur - - - and we want a cmake.products/* directory that looks like this: - - oscogvm/cmake.products/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur/build - - - Each directory in those trees is accessible viathe the CPlatformConfigForSqueak in the ''cmake directory'' category. - - ToolSet browseClass: CPlatformConfigForSqueak category: ''cmake directory''. - - There are two method variants. - - The first variant is hardcoded in the method itself. For example the platform directories are stored as... - - dirLinux32Armv6 - ^''cmake.build.linux32armv6'' - - or, for our configuration - - dirLinux64x86w32BitCompatibility - ^''cmake.build.linux64x86w32BitCompatibility'' - - The second variant accesses the name of a buildType directory via the SqueakCMakeVMMakerAbstractBuilder (do a printIt or doIt). - - dirBuild - ^SqueakCMakeVMMakerAbstractBuilder default buildTypeAndDirectoryInfo at: #build - - - - Each part of the directory tree is contained/accessible via these methods. It is our job to select the corect ones for our purposes. - - Here is an example of mapping this output directory path - ''oscogvm/cmake.products/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur/build'' - - to the methods that output each part. - - |c| - c:=(CPlatformConfigForSqueak basicNew). - (c oscogvm), ''/'', (c dirOutput), ''/'', (c dirLinux64x86w32BitCompatibility), ''/'', (c squeakCogSpur), ''/'', (c dirBuild) - - - The methods corresponding to each of the above directory names are: - - topDir - dirOutput - dirBuildPlatform - dirBuildLanguageVMMM - buildType (not a method,this is a private instance variable in the configuration) - - The first two, topDir and dirOutput are contained in CPlatformConfigForSqueak - dirBuildPlatform is contained at the platform level - - SystemNavigation new browseAllImplementorsOf: #dirBuildPlatform localTo:CPlatformConfigForSqueak. - - dirBuildLangaugeVMMM is at the specific Configuration level - SystemNavigation new browseAllImplementorsOf: #dirBuildLanguageVMMM localTo:CPlatformConfigForSqueak. - - buildType is set when we configure the Configuration for a particular buildType and is stored in the SqueakCMakeVMMakerAbstractBuilder at its initialization. - - SystemNavigation new browseAllImplementorsOf: #initializeBuildTypeAndDirectoryInfo - - It is this values that the CPlatformConfigForSqueak access via dirBuild, dirBuildAssert etc... - SystemNavigation new browseAllImplementorsOf: #dirBuild - - - Similarly, the build directory tree - ''oscogvm/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur/build/'' - - has methods corresponding to each of the above directory names. they are: - - topDir - dirBuildPlatform - dirBuildLanguageVMMM - buildType (not a method,this is a private instance variable in the configuration) - - It follows then, that for our Configuration we need to make the method dirBuildLanguageVMMM return ''squeak.cog.spur''. - - We cover that in the next Help page. - - - *The naming convention is straightforward and convered in the ''Naming Convetions'' page of the Developer Guide Overview Help. - - - (HelpBrowser openOn: CMakeVMMakerSqueakOverviewHelp) model - showTopicThat: [:topic | topic key = #namingConventions]. - - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>specifyPlugins (in category 'pages') ----- - specifyPlugins - ^HelpTopic - title:'Specify Plugins' - contents: - 'We can specify which plugins we want on our configuration by overriding our platform''s defaultExternalPlugins and defaultInternalPlugins methods. - - The default set can be further customized according to buildType if desired via the externalPlugins[BuildType] and internalPlugins[BuildType] redirect pattern - - We will cover only the internalPlugins scenario here. The methodology is exactly the same for externalPlugins. - - Let''s look first at the defaultInternalPlugins - - SystemNavigation browseAllImplementorsOf: #defaultInternalPlugins - - Looking at the Linux64x86w32BitConfigUsrLib we see that it just returns a default collection of class names. - - The defaultInternalPlugins message is typically sent from the internalPlugins[buildType] method. - - SystemNavigation browseAllImplementorsOf: #internalPlugins - - Here we see that CPlatformConfigForSqueak implements the message redirect pattern. - - SystemNavigation browseAllImplementorsOf: #internalPluginsBuild - - In CPlatformConfigForSqueak >> internalPluginsBuild forces subclasses to implement the method. - - Looking at - - SystemNavigation browseAllImplementorsOf: #internalPluginsBuildMultiThreadedDebug - we see the default is to return the default list provided in internalPluginsBuild. - - This enables configurations to customize their plugins with a good degree of granularity should we want to change the plugins we use based on buildType while keeping things simple in the default case. - - To summarize, a Configuration specifies what plugins it wants to build (either internal or external) by modifying or overriding the list of Plugin class names stored in defaultInternalPlugins or defaultExternalPlugins by overriding the internalPlugins[buildType] method or externalPlugins[buildType] method - - - - - - - - - - - - - - - - - - - - - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>standardIncludes (in category 'pages') ----- - standardIncludes - ^HelpTopic - title:'standardIncludes' - contents: - 'As of CMakeVMMakerSqueak-tty.114 the method is a legacy method from the pharo CPlatformConfig. It is expect it (and this help page!!) will go away on a refactoring pass when the dependency on the pharo package is removed. - - - SystemNavigation browseAllImplementorsOf: #standardIncludes - - CPlatformConfig browseHierarchy - - In the CPlatformConfigForSqueak>>standardIncludes, we see the Method Redirect Pattern employed. Since this is for buildType #build, the method will re-route to self standardIncludesBuild. - - SystemNavigation browseAllImplementorsOf: #standardIncludesBuild - - The SqueakUnixConfig just writes some debug messages. - - There is nothing for us to do here.'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>tackingStockOne (in category 'pages') ----- - tackingStockOne - ^HelpTopic - title:'Taking Stock' - contents: - 'Let''s take stock of where we are. - - At this point, we have - 1. Created a Configuration for a specific platform, language, VM and memory model . - 2. Invoked the appropriate Builder for that Configuration asking it to ... - 2.a configure itself for a specific BuildType and - 2.b asked it to ouput its content to a specific directory. - 3. Confirmed that the Configuration outputs its data. - - The remainder of our task is customizing our Configuration so that the generated data correctly builds as the intention revealing name of the Configuration implies. I.e. we expect a Linux64x86w32BitSqueakCogSpurConfig, when configured for the buildType #build to generate CMake (and other) files that in fact, creates a release version of a squeak.cog.spur vm that runs on Linux64 with 32 bit compat libs stored in /usr/lib. - - Before we dive into customizing our new Configuration, we step back to gain some perspective so that if there are problems, you know where to look. - - We will start by a quick summary of.. - - 1. The root Configuration class CPlatformConfigForSqueak - 2. The ''method redirect'' design pattern. - 3. The CMakeVMGeneratorForSqueak class - - - After that, we will take stock again and proceed with the customization of our example Linux64x86w32BitSqueakCogSpurConfig - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>tackingStockTwo (in category 'pages') ----- - tackingStockTwo - ^HelpTopic - title:'Taking Stock II' - contents: - 'To recap, at this point, we have - 1. Created a Configuration for a specific platform, language, VM and memory model . - 2. Invoked the appropriate Builder for that Configuration asking it to ... - 2.a configure itself for a specific BuildType and - 2.b asked it to ouput its content to a specific directory. - 3. Confirmed that the Configuration outputs its data. - - We know that - - Configuration is performed at the highest appropriate Configuration with fine-tuning at the lower Configuration levels. - The Method Redirect Pattern is implemented in CPlatformConfigForSqueak. It is boilerplate code. - A specific Configuration may override a Method Redirect method for a particular build type to provide custom output - The CMakeVMGeneratorForSqueak takes our Configuration as input via the Visitor pattern and executes the Method Redirect methods in a predictable way based on the Configurations buidType.. - - - The remainder of this Example Workflow will be the customization of the Linux64x86w32BitSqueakCogSpurConfig and generating a working build. - - To do this by taking each statement in the CMakeVMGeneratorForSqueak>>generateByTemplate cascade in turn. - - - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>tests (in category 'pages') ----- - tests - ^HelpTopic - title:'Tests' - contents: - 'We start with Tests. - - The Tests are in class category CMakeVMMakerSqueak-Tests. - - They are: - - CMakeVMMakerSqueakBuildersTest - CMakeVMMakerSqueakCommonConfigTest - CMakeVMMakerSqueakMacintoshConfigTest - CMakeVMMakerSqueakRedirectMethodsTest - CMakeVMMakerSqueakRedirectMethodsWithArgTest - CMakeVMMakerSqueakUnixConfigTest - CMakeVMMakerSqueakWindowsConfigTest - - As of 2014.12.09 all tests pass. - - As we create the Configuration these tests will be an important check on our work and we will return to them often.'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>theVMGenerator (in category 'pages') ----- - theVMGenerator - ^HelpTopic - title:'The CMakeVMGeneratorForSqueak class' - contents: - 'Before we move onto setting the most common directives and flags in the Concrete Configuration, lets take a quick look at the class and method that actually generates the CMake files for us. - - CMakeVMGeneratorForSqueak browseHierarchy - - - CMakeVMGeneratorForSqueak implements the Visitor Design pattern. It takes as input a Configuration and it operates on that Configuration in a methodical manner. - - The CMakeVMGeneratorForSqueak has in instance variable named ''config''. This variable is our Configuration. - - The methodical operation on the Configuration occur in its generateByTemplate method. - - To see this, look at the generateByTemplate method and the long cascade that starts with: - - config - setGlobalOptions: self; - cmakePrefixPath; - cmakeIncludePath;..... - - - Here you see the generator iterating over the CPlatformConfigForSqueak Method Redirect methods. - - SystemNavigation new browseAllImplementorsOf: #cmakeIncludePath localTo: CPlatformConfigForSqueak. - - Here you see that based on the Configurations buildType, the appropriate Redirect Method out of - cmakeIncludePathBuild - cmakeIncludePathBuildAssert - cmakeIncludePathBuildAssertITimerHeartbeat - cmakeIncludePathBuildDebug - cmakeIncludePathBuildDebugITimerHeartbeat - cmakeIncludePathBuildITimerHeartbeat - cmakeIncludePathBuildMultiThreaded - cmakeIncludePathBuildMultiThreadedAssert - cmakeIncludePathBuildMultiThreadedDebug - cmakeIncludePathNoBuildType - - is executed. - - - For debugging and troubleshooting you new Configuration, CMakeVMGeneratorForSqueak>>generateByTemplate enables you to step through CMake generation in an entirely predictable way. - - Let''s recap next. - ' - - ! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>vmsrc (in category 'pages') ----- - vmsrc - ^HelpTopic - title:'vmsrc' - contents: - ' - write me. - '! Item was removed: - CMakeVMMakerSqueakConfigurationsHelp subclass: #CMakeVMMakerSqueakStepByStepNewPlatformHelp - instanceVariableNames: '' - classVariableNames: '' - poolDictionaries: '' - category: 'CMakeVMMakerSqueak-Help'! - - !CMakeVMMakerSqueakStepByStepNewPlatformHelp commentStamp: '<historical>' prior: 0! - A CMakeVMMakerSqueakNewConfigurationStepByStepHelp itemizes the steps needed to create a new build configuration. - - HelpBrowser openOn: CMakeVMMakerSqueakNewConfigurationStepByStepHelp! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewPlatformHelp class>>bookName (in category 'accessing') ----- - bookName - ^'Example Workflow: New Platform'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewPlatformHelp class>>key (in category 'accessing') ----- - key - ^'CMakeVMMakerSqueakStepByStepNewPlatformHelp'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewPlatformHelp class>>overview (in category 'pages') ----- - overview - ^HelpTopic - title:'Overview' - contents: - ' Write me. - '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewPlatformHelp class>>pages (in category 'accessing') ----- - pages - ^#(overview step1)! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewPlatformHelp class>>step1 (in category 'pages') ----- - step1 - ^HelpTopic - title:'Step 1. ' - contents: - ' Write me - '! Item was added: + CMakeVMMakerSqueakTutorialsHelp subclass: #CMakeVMMakerSqueakTutorialEndUserHelp + instanceVariableNames: '' + classVariableNames: '' + poolDictionaries: '' + category: 'CMakeVMMakerSqueak-Help'! + + !CMakeVMMakerSqueakTutorialEndUserHelp commentStamp: 'tty 2/28/2015 13:25' prior: 0! + A CMakeVMMakerSqueakTerseGuideHelp provides a simple walkthrough of a build using the CMakeVMMaker package. + + + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialEndUserHelp class>>bookName (in category 'accessing') ----- + bookName + ^'Tutorial: End User'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialEndUserHelp class>>configureAndGenerate (in category 'pages') ----- + configureAndGenerate + ^HelpTopic + title: 'Configure and Generate' + contents: + ' The final step is to instruct the Configuration to configure itself for an available buildType , enable/disable debugging trace messages and generate the output. + + SqueakLinux64x86w32CompatBuilder + configureA: #Linux32x86SqueakCogV3Config forBuildType: #build; + enableMessageTracking: true; + generateByTemplate. + + Running the above cascade provides no feedback to the user. If all went well, there should be a CMake build tree as discussed on the next page. + + + + ' + + + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialEndUserHelp class>>examiningOutput (in category 'pages') ----- + examiningOutput + "This method was automatically generated. Edit it using:" + "a HelpBrowser edit: #examiningOutput" + ^HelpTopic + title: 'Examining Output' + contents: + 'TODO: tty fix apperent but in build directory as it is outputing to DO THIS NEXT /cmake.build.linux64x86w32BitCompatibility/squeak.cog.v3/build/ + and not cmake.build.linux32_64x86 + + Examining the output requires two queries (both intuitive, via the intention revealing names of the Builder and Configuration) + + First, we ask the builder where it has its Configurations put their output: + + SqueakLinux64x86w32CompatBuilder buildDirectory + --> ''cmake.build.linux32_64x86'' + + + The Linux32x86SqueakCogV3Config writes itself to a directory that matches its [cmake.Platform]/[Language].[VM].[MemoryModel]/[BuildType] + + On my system that is: + + ~./..../cogVMMaker/oscogvm/cmake.[Platform]/[Language].[VM].[MemoryModel]/build + i.e. + ~./..../cogVMMaker/oscogvm/cmake.build.linux32_64x86/squeak.cog.v3/build + + I open a terminal and navigate to that directory: + + cd ~./..../cogVMMaker/oscogvm/cmake.build.linux32_64x86/squeak.cog.v3/build + + and list the contents + + bash-4.2$ ls + ADPCMCodecPlugin LICENSE.txt SurfacePlugin + AsynchFilePlugin LargeIntegers Utils.cmake + B2DPlugin LocalePlugin ZipPlugin + BMPReadWriterPlugin MIDIPlugin build.cmake + BitBltPlugin Matrix2x3Plugin build.sh + CMakeLists.txt MiscPrimitivePlugin config.cmake + CroquetPlugin Mpeg3Plugin config.in + DSAPrims PLUGINS.txt directories.cmake + DropPlugin Plugins.cmake sqNamedPrims.h + FFTPlugin SecurityPlugin testDoubleWordAlignment.c + FileCopyPlugin SerialPlugin testDoubleWordOrder.c + FilePlugin SocketPlugin testLanginfoCodeset.c + FloatArrayPlugin SoundCodecPrims vm-display-X11 + FloatMathPlugin SoundGenerationPlugin vm-display-null + JoystickTabletPlugin SoundPlugin vm-sound-ALSA + Klatt StarSqueakPlugin vm-sound-null + .... + + + (NOTE TODO tty: build a query to have a configuration return its build directory path.) + + !!' readStream nextChunkText! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialEndUserHelp class>>invokeCMake (in category 'pages') ----- + invokeCMake + ^HelpTopic + title: 'Invoke cmake' + contents: + 'The next step is to tell CMake to create the native build files. + + On linux the commands are: + + cmake . <----N.B. note the ''dot'' after the cmake + make + + As a convenience, the commands are duplicated in a generated ''build.sh'' file . (I have had some wierd issues with running it directly, so I just run the commands therein) + bash-4.2$ cat build.sh + #!!/usr/bin/env bash + export CC=gcc + export CXX=g++ + cmake . + make + + + When CMakeVMMakerSqueak is ported to different platforms, then the ''make'' command could be replaced by a different native build system command. + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialEndUserHelp class>>overview (in category 'pages') ----- + overview + ^HelpTopic + title: 'Overview' + contents: + 'This tutorial covers how to generate a CMake build tree using an existing Builder and an existing Configuration. If you need a new Builder or Configuration see the Developer Guide. + + On a given Platform, a platform specific Builder configures a platform specific Configuration for a buildType and instructs it to write its CMake output to that Configuration''s build directory. + + This terse example shows a typicall use-case of the tools. + + In this terse example, I want to build a Cog VM for Squeak with the V3 memory model. on a SlackwareLinux64 with 32 bit Compatability libs platform. + + To do this, I ... + + 1. Select the Builder for my platform. + 2. Query the Builder + 3 Select a Configuration + 4 Instruct the Configuration (via the Builder) to configure itself for a builtType + 5. Instruct the Configuration (via the Builder) to enable message tracking (useful for debugging output) + 6. Instruct the Configuration (via the Builder) to generate its CMake output. + 7 + 8 Invoke the native build system. + 9. Test the generated VM. + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialEndUserHelp class>>pages (in category 'accessing') ----- + pages + ^#(overview selectBuilder queryBuilder selectConfiguration configureAndGenerate examiningOutput invokeCMake testDrive)! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialEndUserHelp class>>priority (in category 'pages') ----- + priority + + ^ 3! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialEndUserHelp class>>queryBuilder (in category 'pages') ----- + queryBuilder + ^HelpTopic + title: 'Query the Builder' + contents: + 'I can query the Builder for information on available Configurations and BuildTypes + + SqueakLinux64x86w32CompatBuilder + availableBuildConfigurations. + + SqueakLinux64x86w32CompatBuilder + allBuildTypes. + + SqueakLinux64x86w32CompatBuilder + availableBuildTypesFor:(SqueakLinux64x86w32CompatBuilder availableBuildConfigurations at:1). + + SqueakLinux64x86w32CompatBuilder + buildDirectory. + + The ''queries'' protocol of the SqueakCMakeVMMakerAbstractBuilder contains additional queries. + + SqueakCMakeVMMakerAbstractBuilder class browse. + ' + + + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialEndUserHelp class>>selectBuilder (in category 'pages') ----- + selectBuilder + ^HelpTopic + title: 'Select a Builder' + contents: + 'I select the appropriate Builder from the CMakeVMMakerSqueak-Builder category for my platform; in my case it is the SqueakLinux64x86w32CompatBuilder. + + + SqueakLinux64x86w32CompatBuilder browseHierarchy. + + SqueakCMakeVMMakerAbstractBuilder browseHierarchy. + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialEndUserHelp class>>selectConfiguration (in category 'pages') ----- + selectConfiguration + ^HelpTopic + title: 'Select a Configuration' + contents: + 'The Configuration Linux64x86w32BitSqueakCogV3Config is available for my platform. (i.e. a developer has done the work of encapsulating the custom CMake for us). + + As stated before, I can view what Configurations are available for a platform by asking the platform Builder what it has available: + + SqueakLinux64x86w32CompatBuilder + availableBuildConfigurations. + + As of this writing the Linux64x86w32BitSqueakCogV3Config is available and I decide to use it. + + Note that the class name of the Configuration is intention-revealing. It is a Configuration for the Linux 64 platform with 32 Bit compatibility libs that encapsulates the CMake required to build the Squeak Cog V3 virtual machine. From this convention, The organization of configurations is straight-forward: + + CPlatformConfigForSqueak browseHierarchy + + Linux64x86w32BitSqueakCogV3Config browseHierarchy + ' + + + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialEndUserHelp class>>testDrive (in category 'pages') ----- + testDrive + ^HelpTopic + title: 'Test Driving the VM' + contents: + 'The Cog svn tree contains a directory named ''products'' where it stores its make output. + + The CMakeVMMakerSqueak system mirrors that with a cmake.products directory that is created at the same level. + + + The newly generated VM is stored in a subdirectory of ''cmake.products" that mimics the [Language][VM][MemoryModel] naming convention of the Configuration + + Since I built a #Linux32x86SqueakCogV3Config the cog vm is placed in the cmake.products/squeak.cog.v3 directory. + + TODO: Add a message name showing where this is customized. + '! Item was added: + CMakeVMMakerSqueakTutorialsHelp subclass: #CMakeVMMakerSqueakTutorialNewBuilderHelp + instanceVariableNames: '' + classVariableNames: '' + poolDictionaries: '' + category: 'CMakeVMMakerSqueak-Help'! + + !CMakeVMMakerSqueakTutorialNewBuilderHelp commentStamp: '<historical>' prior: 0! + A CMakeVMMakerSqueakNewConfigurationStepByStepHelp itemizes the steps needed to create a new build configuration. + + HelpBrowser openOn: CMakeVMMakerSqueakNewConfigurationStepByStepHelp! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewBuilderHelp class>>bookName (in category 'accessing') ----- + bookName + ^'Tutorial: New Builder'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewBuilderHelp class>>key (in category 'accessing') ----- + key + ^'CMakeVMMakerSqueakTutorialNewBuilderHelp'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewBuilderHelp class>>overview (in category 'pages') ----- + overview + ^HelpTopic + title:'Overview' + contents: + 'WRITE ME + + + + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewBuilderHelp class>>pages (in category 'accessing') ----- + pages + + ^#( overview ) + + ! Item was added: + CMakeVMMakerSqueakTutorialsHelp subclass: #CMakeVMMakerSqueakTutorialNewConfigurationHelp + instanceVariableNames: '' + classVariableNames: '' + poolDictionaries: '' + category: 'CMakeVMMakerSqueak-Help'! + + !CMakeVMMakerSqueakTutorialNewConfigurationHelp commentStamp: 'tty 6/16/2014 12:19' prior: 0! + A CMakeVMMakerSqueakNewConfigurationStepByStepHelp itemizes the steps needed to create a new build configuration. + + HelpBrowser openOn: CMakeVMMakerSqueakNewConfigurationStepByStepHelp! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>addVMPlugins (in category 'pages') ----- + addVMPlugins + ^HelpTopic + title:'addVMPlugins' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + addVMPlugins depends on custom configuration provided in our Configuration; the method depends on three other methods as described below + + VMPlugins are similar to built-in plugins yet are critical for running squeak on particular systems. + + The CMake configuration data needed for building them is encapsulated in sublcasses of CMakeVMPlugin. + + CMakeVMPlugin browseHierarchy + + You see that they are predominantly display and sound drivers. + + The process of customization ''starts'' in the initialze method of CPlatformConfigForSqueak + + ToolSet browse: CPlatformConfigForSqueak selector: #initialize + + In CPlatformConfigForSqueak>>initializeVMDrivers an OrderedCollection of CMakeVMPlugin subclasses are initialzed and stored. This collection is the universe of possible vm plugins. + + In our custom Configuration, we need a subset of that universe. The CPlatformConfigForSqueak>>customizeVMDrivers forces this with a ''self subclassResponsibility'' + + In our new Configuration we have this method already as we copied from an existing Configuration + + ToolSet browse: Linux64x86w32BitConfigUsrLib selector: #customizeVMPlugins + + We see that the code selects specific vm plugin templates from the universe of available ones and then customizes each one. + + Taking Linux64x86w32BitConfigUsrLib>>customizeCMakeVMDisplayNull as an example... + + ToolSet browse: Linux64x86w32BitConfigUsrLib selector: #customizeCMakeVMDisplayNull + + We see that we set the sources, compiler definitions, flags, external libraries, linker flags and include directories needed to compile the vm plugin here. + + So, if we have trouble with a vm plugin, we need to look in its customzeCMakeVMXYZ method and fix it there. + + These configurations are extracted from our Configuration and written out to that vm plugins directory and placed in its CMakeLists.txt file. + + Here is an example of the CMakeLists.txt file for the vm-display-null plugin + + bash-4.2$ cat oscogvm/cmake.build.linux64x86w32BitCompatibility/squeak.cog.v3/build/vm-display-null/CMakeLists.txt + # This is automatically generated file using Linux64x86w32BitSqueakCogSpurConfig on 1 May 2016 8:40:02.153261 am + project (vm-display-null) + cmake_minimum_required(VERSION 2.8.12) + include (/home/wm/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/cmake.build.linux64x86w32BitCompatibility/squeak.cog.v3/build/directories.cmake) + add_definitions(-DNDEBUG -DDEBUGVM=0 -DLSB_FIRST=1 -D_GNU_SOURCE -D_FILE_OFFSET_BITS=64 -DCOGMTVM=0) + add_definitions(-w -m32 -msse2 -O1) + add_definitions(-fPIC -DPIC) + set(sources ${targetPlatform}/vm-display-null/sqUnixDisplayNull) + add_library(vm-display-null SHARED ${sources}) + include_directories( ${crossDir}/plugins/FilePlugin ${targetPlatform}/plugins/B3DAcceleratorPlugin ${crossDir}/plugins/B3DAcceleratorPlugin) + set(LIBRARY_OUTPUT_PATH "/home/wm/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/cmake.products/squeak.cog.v3") + target_link_libraries(vm-display-null ${LINKLIBS}) + set_target_properties(vm-display-null PROPERTIES PREFIX "" SUFFIX "" LINK_FLAGS "-w -m32 -msse2 -O1") + + + To modify the above output, we modify our Configuration''s customizeCMakeVMXyz methods . + To add or remove a vm-plugin from our configuration, we edit the customizeVMPlugins method. + To expand the universe of available vm plugins, we modify the CMakeConfigForSqueak >>initializeVMDrivers method. + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>bookName (in category 'accessing') ----- + bookName + ^'Tutorial: New Configuration'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>builderConfigurationInteraction (in category 'pages') ----- + builderConfigurationInteraction + ^HelpTopic + title:'Builder Configuration Interaction' + contents: + 'Within the broad terms of this tutorial, you are here: + 4. Interaction of the Builder and your Configuration + + I can query the Builder for information about its Configurations: + + SqueakLinux64x86w32CompatBuilder availableBuildConfigurations + a SortedCollection(#Linux64x86w32BitSqueakCogV3Config) <--A Cog V3 configuration exists. + + SqueakLinux64x86w32CompatBuilder unAvailableBuildConfigurations + --> a SortedCollection(#Linux64x86w32BitConfigUsrLib #Linux64x86w32BitConfigUsrLib32) + These two Configurations are platform specific Abstract Base Classes. Abstract Base Classes cannot be built, hence they are unavailable. + + The Bulder can query Configurations about input and output directory paths it uses and/or creates: + + SqueakLinux64x86w32CompatBuilder buildDirectory + -->''cmake.build.linux64x86w32BitCompatibility'' <--this matches my platform + + ' + + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cPlatformConfigForSqueak (in category 'pages') ----- + cPlatformConfigForSqueak + "This method was automatically generated. Edit it using:" + "a HelpBrowser edit: #cPlatformConfigForSqueak" + ^HelpTopic + title: 'CPlatformConfigForSqueak' + contents: + 'Within the broad outline of this tutorial, you are here: + 7. Some high level classes and concepts + 7.a CPlatformConfigForSqueak + + CPlatformConfForSqueak encapsulates CMake constructs. + CPlatformConfForSqueak encapsulates CMake constructs that are common to all computer platforms. + + Its child classes progressively specialized CMake constructs. + + + CPlatformConfigForSqueak browseHierarchy + + The immediate children of CPlatformConfigForSqueak + + SqueakMacintoshConfig + SqueakUnixConfig + SqueakWindowsConfig + + begin the specialization required for the Macintiosh , Unix and Windows machines. Adding a new platform, say VAX, is as easy as + CPlatformConfigForSqueak subclass:#SqueakVAXConfig and configure its relevant data/methods for that platform. + + An example of Configuration customization at the platform level is in the executableType method. + + SystemNavigation default browseMethodsWhoseNamesContain: ''executableType'' + + Here, we see that CPlatformConfForSqueak requires that a subclass implement it. The other subclasses may impliment it with an appropriate return value. + + Configurations are further refined as we proceed down the heirarchy. + + SqueakMacOSX32x86Config browseHierarchy + + Here we see a (stub) configuration for Mac OSX32 on the x86 processor. + + Our new Linux64x86w32BitSqueakCogSpurConfig configuration fits into its expected place under the Unix hierarchy. + + Linux64x86w32BitSqueakCogSpurConfig browseHierarchy + + The key and art of customizing our Linux64x86w32BitSqueakCogSpurConfig is to customize our Configuration at the appropriate level. + Higher levels should provide existing, appropriate configuration. Our job is to then implement and customize at the finest level of customization. + + To understand the how and why of customizing a Configuration, we turn to the heavily implemented design pattern I call the "Method Redirect Pattern". + + We cover that next. + + + N.B. The ''Squeak'' prefix is unfortunate as it violates the naming convention. It is a holdover from initial attempts with the Pharo CMakeVMMaker code base. + I will attempt to remember to rename these after the Pharo dependency is removed. + + + + CPlatformConfigForSqueak is a child of CPlatformConfig, the root Configuration in Pharo''''s CMakeVMMaker. + + This is temporary as I have decided to de-couple CMakeVMMakerSqueak from CMakeVMMaker. + + ToolSet browseMessageCategory:''cmake'' inClass: CPlatformConfigForSqueak!!' readStream nextChunkText! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cPlatformConfigForSqueakInitialize (in category 'pages') ----- + cPlatformConfigForSqueakInitialize + ^HelpTopic + title: 'Configuration Initialization' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + + ToolSet browse: CPlatformConfigForSqueak selector: #initialize + + The relevant section is.. + + self + initializePlatformSources; + initializeVMPlugins; + customizeVMPlugins. + + We will take each in turn. + ' + + + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cmakeAddDefinitions (in category 'pages') ----- + cmakeAddDefinitions + ^HelpTopic + title:'cmakeAddDefinitions' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + + SystemNavigation browseAllImplementorsOf: #cmakeAddDefinitions + + We see that the CPlatformConfigForSqueak routes the method based on the buildType #build via the Method Redirect pattern to cmakeAddDefinitionsBuild + + SystemNavigation browseAllImplementorsOf: #cmakeAddDefinitionsBuild + + We see that our Linux64x86w32BitSqueakCogSpurConfig already implements it due to our copying of an existing configuration. + + We need to modify this for our Configuration. The current method (minus commented out elements) reads as: + + definitions:=#( + ''-DNDEBUG'' + ''-DDEBUGVM=0'' + '' -DLSB_FIRST=1'' + ''-D_GNU_SOURCE'' + ''-D_FILE_OFFSET_BITS=64'' + ''-DCOGMTVM=0'') . + + Like the cmakeCFlags method, we look at the mvm file + + cat ~/.../Cog/build.linux32x86/squeak.cog.spur/build/mvm + + And see the + 3.4.*) OPT=''-g -O1 -fwrapv -DNDEBUG -DDEBUGVM=o'';; + *) OPT=''-g -O2 -DNDEBUG -DDEBUGVM=0'';; + + lines and the + + CFLAGS=''$OPT -msse2 -D_GNU_SOURCE -D_FILE_OFFSET_BITS=64 -DCOGMTVM=0'' \ + + Based on these mvm file details, I modify the method to read as such: + + definitions:=#( + ''-DNDEBUG'' + ''-DDEBUGVM=0'' + ''-D_GNU_SOURCE'' + ''-D_FILE_OFFSET_BITS=64'' + ''-DCOGMTVM=0'') . + + To match the directives specified in the mvm file + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cmakeAddExecutableNameOptionSource (in category 'pages') ----- + cmakeAddExecutableNameOptionSource + ^HelpTopic + title:'cmakeAddExecutableNameOptionSource:' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + SystemNavigation browseAllImplementorsOf: #cmakeAddExecutableNameOptionSource: + + We see this is a top-level method implemented only by CPlatformConfigForSqueak + + The method creates a new CMakeAddExecutableNameOptionSource template + + CMakeAddExecutableNameOptionSource browse + + and the class comment says it "Add an executable to the project using the specified source files." + + To get a sense of the CMake output print the following: + + ((CMakeAddExecutableNameOptionSource new) + executableName: ''cog'' + optionalproperty: '''' + sources: (OrderedCollection with: ''${coreSources} ${crossVMSources} ${platformVMSources} ${extraSources}'')) content + + In looking at this, the exectuableName worries me. I am not sure that ''cog'' is what we want. + + Looking at it... + SystemNavigation browseAllImplementorsOf: #executableName + + it is something we can customize or code if we need. + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cmakeCFlags (in category 'pages') ----- + cmakeCFlags + ^HelpTopic + title:'cmakeCFlags' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + + SystemNavigation browseAllImplementorsOf: #cmakeCFlags + + We see that CPlatformConfigForSqueak implements it + + The method comment reads in part: + + ''self deprecated: this catchall method has been split into dedicated methods: cmakePrefixPath cmakeIncludePath cmakeLibraryPath cmakeIncludeModules; cmakeCFlags; ...'' + + + And that this method will be refactored out of existence ''soon''. + + Looking at it, we see that the method implements the Method Redirect pattern + + Since we have configured for buildType: #build, the Method Redirect Pattern will invoke the cmakeCFlagsBuild method. + + So we look at the implementors of it.. + + SystemNavigation browseAllImplementorsOf: #cmakeCFlagsBuild + + Here we see that our new Linux64x86w32BitSqueakCogSpurConfig configuration implements it (since we copied an existing Configuration that implemented it) + + We now have something to customize. + + We look at the line: cflags:= String streamContents: [:stream | (self compilerFlags) asStringOn: stream delimiter: '' '' ]. + + and see that our ''self compilerFlags'' method is used. + + SystemNavigation browseAllImplementorsOf: #compilerFlags + + These are flags to pass to the compiler. Take a look at the mwm file in the GNU config + + cat ~/.../Cog/build.linux32x86/squeak.cog.spur/build/mvm + + We see an OPT variable being populated... + + + OPT=''-g -O1 -fwrapv -DNDEBUG -DDEBUGVM=0'';; + OPT=''-g -O2 -DNDEBUG -DDEBUGVM=0'';; + esac + + And later in the file we see the CFLAGS variable being populated with the $OPT variable and some other flags. + + CC=''gcc -m32'' \ + CXX=''g++ -m32'' \ + CFLAGS=''$OPT -msse2 -D_GNU_SOURCE -D_FILE_OFFSET_BITS=64 -DCOGMTVM=0'' \ + LIBS=''-lpthread -luuid'' \ + LDFLAGS=-Wl,-z,now + + That CFLAGS variable is what we are mimicing here. with some caveats... + + The pharo code just dumped all that stuff into one method, whereas I split them up. + + We are ommitting the Compiler defines like -D_GNU_SOURCE as we will be setting those in cmakeAddDefinitions. + + My current compilerFlags (minus commented out elements) method reads like this: + + compilerFlags + ^#( ''-w'' + ''-m32'' + ''-msse2'' + ''-O1'') + + + checking my compiler version + bash-4.2$ gcc --version + gcc (GCC) 4.8.2 + Copyright (C) 2013 Free Software Foundation, Inc. + This is free software; see the source for copying conditions. There is NO + warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + + I see I need some options from the OPT=''-g -O1 -fwrapv -DNDEBUG -DDEBUGVM=0'' line + line + + + Mimicing the mvm file, I modify it to read as such: + + compilerFlags + ^#(''-g'' + ''-O1'' + ''-fwrapv'' + ''-m32'' + ''-msse2'' + ) + + In doing this, I am congizant that I may have to return to this method as I fiddle around getting this configuration correct. + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cmakeIncludeDirectories (in category 'pages') ----- + cmakeIncludeDirectories + ^HelpTopic + title:'cmakeIncludeDirectories' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + + SystemNavigation browseAllImplementorsOf: #cmakeIncludeDirectories: + + We see that the sole implementor of the method is the top level configuration CPlatformConfigForSqueak + + The method creates an instance of the CMakeTemplate CMakeIncludeDirectories + + CMakeIncludeDirectories browse + + where the class comment tells us that it tells CMake to add extra ''include'' directories to the build. + + Currently a variable placeholder is hard-coded in CMakeVMGeneratorForSqueak>>includeDirs + You can print the following to see them: + (CMakeVMGeneratorForSqueak new) includeDirs + + And the generated CMake by printing the following: + + ((CMakeIncludeDirectories new) dirs: (OrderedCollection with: (CMakeVMGeneratorForSqueak new) includeDirs)) content + + What you see when you print it are variable placeholders that CMake will populate with the value of CMake variables ${crossDir} + , ${srcVMDir} and ${targetPlatform} that we will be defining or have already been defined in our configuration. + + This is truly a global method and would only change if Eliot changed the layout of the underlying build structure. + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cmakeIncludeModules (in category 'pages') ----- + cmakeIncludeModules + ^HelpTopic + title:'cmakeIncludeModules' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + + CMake allows the user to include custom CMake library files (modules). + This construct allows the developer to include those modules. + + cmakeIncludeModules implements the Method Redirect pattern. + + ToolSet browse: CPlatformConfigForSqueak selector: #cmakeIncludeModules + + Since the configuration is configured for buildType: #build the method redirect pattern will redirect to + + SystemNavigation browseAllImplementorsOf: #cmakeIncludeModulesBuild. + + We see in CPlatformConfigForSqueak that a sublcass must implement it via ''self subclassResponsibility''. + + We see that (as of this writing) the SqueakUnixConfig handles the method by including some custom modules + Utils.cmake + Plugins.cmake + TestBigEndian + CheckIncludeFile + CheckLibraryExists + CheckTypeSize + CheckFunctionExists + CheckVariableExists + CheckStructHasMember + FindPkgConfig + + These Module wrap CMake constructs and can be thought of as CMake ''include files''. and they are implemented high in the Configuration platform hierarchy. + + Our new Configuration need not override anything here. + + Let''s move on...'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cmakeIncludePath (in category 'pages') ----- + cmakeIncludePath + ^HelpTopic + title:'cmakeIncludePath' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + + cmakeIncludePath implements the Method Redirect pattern. + + ToolSet browse: CPlatformConfigForSqueak selector: #cmakeIncludePath + + Since the configuration is configured for buildType: #build the method redirect pattern will redirect to + + SystemNavigation browseAllImplementorsOf: #cmakeIncludePathBuild + + We see in CPlatformConfigForSqueak that a sublcass must implement it via ''self subclassResponsibility''. + + We see that (as of this writing) the SqueakUnixConfig handles the method, but only for debug messages. + + There is a possibility a sub-platform will have include files in a non-standard directories and a specific Configuration + will have to implement this to generate appropriate CMake output. + + At this moment, we conclude we don''t need to. + + Since I am writing this help in tandem with generating a new Configuration, there is the possibility I am wrong and that I will need this. + + Since I don''t know for a fact that it is, I leave it alone for now.'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cmakeLibraryPath (in category 'pages') ----- + cmakeLibraryPath + ^HelpTopic + title:'cmakeLibraryPath' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + cmakeLibraryPath implements the Method Redirect pattern. + + ToolSet browse: CPlatformConfigForSqueak selector: #cmakeLibraryPath + + Since the configuration is configured for buildType: #build the method redirect pattern will redirect to + + SystemNavigation browseAllImplementorsOf: #cmakeLibraryPathBuild. + + We see in CPlatformConfigForSqueak that a sublcass must implement it via ''self subclassResponsibility''. + + We see that (as of this writing) the SqueakUnixConfig handles the method, but only for debug messages. + + There is a possibility a sub-platform will have libraries in a non-standard directories and a specific Configuration + will have to implement this to generate appropriate CMake output. + + At this moment, we conclude we don''t need to. + + Since I am writing this help in tandem with generating a new Configuration, there is the possibility I am wrong and that I will need this. + + Since I don''t know for a fact that it is, I leave it alone for now. + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cmakeListAppend: (in category 'pages') ----- + cmakeListAppend:LINKLIBSelements + ^HelpTopic + title:'cmakeListAppend:LINKLIBSelements' + contents: + ' + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cmakeListAppendLINKLIBSelements (in category 'pages') ----- + cmakeListAppendLINKLIBSelements + ^HelpTopic + title:'cmakeListAppendLINKLIBSelements' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + SystemNavigation browseAllImplementorsOf: #cmakeListAppend:elements: + + We see this is a top-level method. + + The method creates a new CMakeListAppend which according to the class comment ''I handle the APPEND functionality for the cmake list commmand.''. + + Here we are appending libraries to link to the list LINKLIBS. + + You can get a sense of the CMake output by evaluating. + + ((CMakeListAppend new) list:''LINKLIBS'' elements:#((''-L/usr/lib'' ''-L/usr/lib/X11'' ''uuid'' ''ssl'' ''crypto'' ''m'' ''dl'' ''pthread'' ''SM'' ''ICE'' ''GL'' ''X11'' ''nsl''))) content + + The list of libraries is available via the configurations ''externalLibs'' method. + + SystemNavigation browseAllImplementorsOf: #externalLibs + + Which we see implements the Method Redirect pattern. + + Since this is a #build buildType we look in + + SystemNavigation browseAllImplementorsOf: #externalLibsBuild + + And we see the CPlatformConfigForSqueak subclasses responsibility and that our new Linux64x86w32BitSqueakCogSpurConfig implements it as + + externalLibsBuild + ^self externalLibraries asOrderedCollection. + + which is contained in its parent as + + externalLibraries + ^#( + ''-L/usr/lib'' + ''-L/usr/lib/X11'' + ...... + etc... + ) + + + So, we see the ability to specify what libraries we want to link against in our configuration. + + Where to do this in the Configuration heirarchy is a matter of judgement. + + We will leave this one alone, bearing in mind that if we have a library linking problem, we have an idea where to look for it. + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cmakePrefixPath (in category 'pages') ----- + cmakePrefixPath + ^HelpTopic + title:'cmakePrefixPath' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + ToolSet browse: CPlatformConfigForSqueak selector: #cmakePrefixPath + + cmakePrefixPath implements the Method Redirect pattern. + + Since the configuration is configured for buildType: #build the method redirect pattern will redirect to + + SystemNavigation browseAllImplementorsOf: #cmakePrefixPathBuild + + We see in CPlatformConfigForSqueak that a sublcass must implement it via ''self subclassResponsibility''. + + We see that (as of this writing) the SqueakUnixConfig handles the method. + + We reason that this method generates platform specific CMake output and our lower-level Configuration need not override it. + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cmakeSetSourceFilesProperties (in category 'pages') ----- + cmakeSetSourceFilesProperties + ^HelpTopic + title:'cmakeSetSourceFilesProperties' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + This is a legacy method from the pharo system. I expect it to be refactored. + + SystemNavigation browseAllImplementorsOf: #cmakeSetSourceFilesProperties + + Here we see the Method Redirect Pattern + + SystemNavigation browseAllImplementorsOf: #cmakeSetSourceFilesPropertiesBuild + + We see that the CPlatformConfigForSqueak subclasses responsibility (scroll down past the method comment) + + We also see that our new Linux64x86w32BitSqueakCogSpurConfig Configuration implements it. + + I suspect this method will be refactored upwards. It appears to be passing distinct compiler flags to the cogit.c and sqUnixHeartbeat.c. + + Let''s leave this one alone. + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>cmakeWriteDirectoriesDotCmake (in category 'pages') ----- + cmakeWriteDirectoriesDotCmake + ^HelpTopic + title:'cmakeWriteDirectoriesDotCmake' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + + SystemNavigation browseAllImplementorsOf: #cmakeWriteDirectoriesDotCmake: + + Here we see that the CPlatformConfigForSqueak forces subclasses to implement this . + + This method sets some CMake variables to platform specific values and writes them to a file named ''directories.cmake'' + + Here is the directories.cmake file contents on my platform + + bash-4.2$ cat directories.cmake + set(topDir "/home/tty/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm") + set(buildDir "/home/tty/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/cmake.build.linux64x86w32BitCompatibility/squeak.cog.v3/build") + set(thirdpartyDir "${buildDir}/thirdParty") + set(platformsDir "/home/tty/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/platforms") + set(srcDir "/home/tty/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/src") + set(srcPluginsDir "${srcDir}/plugins") + set(srcVMDir "${srcDir}/vm") + set(platformName "unix") + set(targetPlatform "${platformsDir}/${platformName}") + set(crossDir "${platformsDir}/Cross") + set(platformVMDir "${targetPlatform}/vm}") + set(outputDir "/home/tty/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/cmake.products/squeak.cog.v3") + set(externalModulesDir "${outputDir}") + + EOF + + The file contains CMake ''set'' commands that bind a variable to a value. + + In this application, CMake commands are encapsulated as objects and the CMake Set command is no exception: + + CMakeSet browse + + Taking the set(platformName,"unix") command as an example, we see the rationale for sublcassing this construct to the platform specific subclasses. + + + There is nothing for us to do here, HOWEVER, we will be customizing some variables that compose this. For example: + set(srcDir "some path to a source directory") can take any of the below directory names: + + nsspur64src + nsspursrc + nsspurstack64src + nsspurstacksrc + nssrc + spur64src + spursistasrc + spursrc + spurstack64src + spurstacksrc + src + stacksrc + + + + + + + + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>compilingLinkingSetup (in category 'pages') ----- + compilingLinkingSetup + ^HelpTopic + title:'Compiling and Linking Setup' + contents: + 'In your concrete configuration''s ''compiling'' protocol contains the methods that you must customize for your Configuration + + cmakeAddDefinitionsBuild + cmakeCFlagsBuild + externalLibsBuild + linkerFlags + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>configGenerateByTemplate (in category 'pages') ----- + configGenerateByTemplate + ^HelpTopic + title:'Config Generate By Template' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + A Configuration starts generating CMakeOutput when a Builder sends it the #generateByTemplate message. + + ToolSet browse: SqueakCMakeVMMakerAbstractBuilder selector:#generateByTemplate + see the ''ifFalse:[config genrateByTemplate]] '' line. + + SystemNavigation browseAllImplementorsOf: #generateByTemplate + + Looking at the SqueakUnixConfig>>generateByTemplate we see the Configuration writes some CMake supporting files via some method calls + + generatePluginsList; + generateLicense; + generateUtilsCmake; + generatePluginsCmake; + generateVmBuildCmake; + generateVmConfigCmake; + generateVmConfigIn; + generateTestDoubleWordAlignmentC; + generateTestDoubleWordOrderC; + generateTestLanginfoCodesetC. + + Each of the above writes a file to the build directory. The contents of which are hard-coded on the class side of the CPlatformConfigForSqueak + + For example the class method CPlatformConfigForSqueak>utilsCMake has some CMake Macros Ian wrote. + + ToolSet browse: (CPlatformConfigForSqueak class) selector: #utilsCMake + + This is high level stuff. It will probably be refactored once the CMake system matures. + + For now, its enough to know it exists. + + Looking at the SqueakWindowsConfig and SqueakMacintoshConfig in their generateByTemplate method, these calls do not (presently) exist. + + ToolSet browse: SqueakWindowsConfig selector: #generateByTemplate + ToolSet browse: SqueakMacintoshConfig selector: #generateByTemplate + + While you probably will not be modifying this, this IS part of customizating a Configuration should you need these things + + ' + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>configureAbstractBaseClass (in category 'pages') ----- + configureAbstractBaseClass + ^HelpTopic + title:'Configure Abstract Base Class' + contents: + 'Abstract Base Classes contain configuration information for a specific platform. + + Let''s start from the top and work are way down. evaluate: + + CPlatformConfigForSqueak browseHierarchy + + CPlatformConfigForSqueak is a fairly involved class, but focusing on the protocol ''cmake directory'' for now, we see a bunch of dirFOO methods. + + selectinng: + + CPlatformConfigForSqueak >>dirLinux32x86 + ^''cmake.build.linux32x86'' + + We see the top-level directory for our new platform specific build. + + The next level down in our hierarchy is SqueakUnixConfig which contains configuration info specific to Unix platforms. An example being: + + SqueakUnixConfig>>platformName + ^self unixPlatformName + + + The next level down is our Abstract Base Class for our specific variant of Unix--specifically Linux32x86Config. + + The methods in this class contain system wide configuratin information for this Platform. On a mature platform tree, this class''s configuration should be rock-solid. However, as of 2014.12.09, the Abstract Base Class has not been configured correctly and I must set it up here. + + Setting it up is not difficult and an existing Abstract Base Class can provide a good starting point. However, a familiarity with the design patterns of the Configurations is helpful (particularly the Redirect Method pattern) + + HelpBrowser openOn: CMakeVMMakerSqueakDesignPatternsHelp + + + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>createTheConfiguration (in category 'pages') ----- + createTheConfiguration + ^HelpTopic + title:'Create the Configuration' + contents: + 'Within the broad outline of this tutorial, you are here: + 4. Create your Configuration + + Our new Concrete Configuration must be created as a subclass of our Platform''s Abstract Base Class. + + SInce I am creating a Squeak Cog Spur config for the CMakeVMMakerSqueak-Linux64X86-32BitCompatibility Platform I choose the name: + + Linux64x86w32BitSqueakCogSpurConfig. + + (For a discussion on naming conventions evaluate: + HelpBrowser openOn: CMakeVMMakerSqueakOverviewHelp + ) + + To create it, I must subclass the Abstract Base Class for my Platform like so: + + Linux64x86w32BitConfigUsrLib subclass: #Linux64x86w32BitSqueakCogSpurConfig + instanceVariableNames: '' + classVariableNames: '' + poolDictionaries: '' + category: ''CMakeVMMakerSqueak-Linux64X86-32BitCompatibility'' + + However, being lazy, I am going to copy an existing Configuration that is similar to what I want. + + Today I choose Linux64x86w32BitSqueakCogV3Config from the CMakeVMMakerSqueak-Linux64X86-32BitCompatibility Platform category + + I copy the class and then change its name, parent and class category to get: + + Linux64x86w32BitConfigUsrLib subclass: #Linux64x86w32BitSqueakCogSpurConfig + instanceVariableNames: '' + classVariableNames: '' + poolDictionaries: '' + category: ''CMakeVMMakerSqueak-Linux64X86-32BitCompatibility'' + + + I then query by Builder to see if it sees the new Configuration in the platform: + + SqueakLinux64x86w32CompatBuilder configurationsCategory + --> ''CMakeVMMakerSqueak-Linux64X86-32BitCompatibility'' + + SqueakLinux64x86w32CompatBuilder availableBuildConfigurations + --> a SortedCollection(#Linux64x86w32BitSqueakCogSpurConfig #Linux64x86w32BitSqueakCogV3Config) + "Here we see our new Configuration is visible to the Builder" + + SqueakLinux64x86w32CompatBuilder unAvailableBuildConfigurations + --> a SortedCollection(#Linux64x86w32BitConfigUsrLib #Linux64x86w32BitConfigUsrLib32) "Our Abstract Base Classes are not available to be built" + + SqueakLinux64x86w32CompatBuilder availableBuildTypesFor: #Linux64x86w32BitSqueakCogSpurConfig + --> an OrderedCollection(#build #buildAssert) "The Configuration I copied has two Build Types coded and available." + + + SqueakLinux64x86w32CompatBuilder sourceDirectoryFor:#Linux64x86w32BitSqueakCogSpurConfig + --> "src" "Where the vm source code is located (we will be changing this)" + + My new configuration is correctly named and in the correct place. + + At this point I re-run all my Tests. + TestRunner open + For me, all tests pass. + + In the next topic we cover how to hide our new Configuration from a builder. + + ' + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>customizePlatformSources (in category 'pages') ----- + customizePlatformSources + "This method was automatically generated. Edit it using:" + "a HelpBrowser edit: #customizePlatformSources" + ^HelpTopic + title: 'Customize Platform Sources' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + In the previous topic we saw where the universe of possible platform sources was populated in the initializePlatformSources method of our platform level Configuration. + + What we need to do now is have our custom Configuration return a subset of that that universe. + + This is done in the setPlatformSources method. + + ToolSet browse: CPlatformConfigForSqueak selector: #setPlatformSources: + + Here we see the Method Redirect Pattern. Since I am building my Configuration for the buildType build, I must override that method + + SystemNavigation browseAllImplementorsOf: #setPlatformSourcesBuild: + + Here we see that the Linux64x86w32BitSqueakCogV3Config selects a subset of the available platform sources that it needs to build itself. + The super call at the end of the method invokes Linux64x86w32BitSqueakCogV3Config>>setPlatformSourcesBuild:aMaker which writes the actual CMake output. + + If you compare the + + Linux64x86w32BitSqueakCogV3Config>>setPlatformSourcesBuild: aMaker method + + to + + the Linux64x86w32BitSqueakCogSpurConfig>>setPlatformSourcesBuild: aMaker + + you will see that the latter has an additional source file ''sqUnixSpurMemory.c'' . + + That difference is a good example of what customizing platform sources means. + + !!' readStream nextChunkText! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>customizePlugins (in category 'pages') ----- + customizePlugins + ^HelpTopic + title:'customize Plugins' + contents: + 'We can customize which plugins we want on our configuration by overriding our platform''s defaultExternalPlugins and defaultInternalPlugins methods. + + The default set can be further customized according to buildType if desired via the externalPlugins[BuildType] and internalPlugins[BuildType] redirect pattern + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>customizeVMPlugins (in category 'pages') ----- + customizeVMPlugins + ^HelpTopic + title:'Customize VM Plugins' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + As we saw in the previous page the CPlatformConfigForSqueak maintains a list of the available VM plugins in the form of ''data-bucket'' objects. + + Since every configuration does not use every VM plugin, our configuration can customize that master list. + + It can do this in one of two ways. + + First, We can do this by overloading the SqueakUnixConfig>>customizeVMPlugins method.. + SystemNavigation browseAllImplementorsOf: #customizeVMPlugins + This customization occures before the buildType has been set in the Configuration. + So this selection will be used regardless of buildType unless....... + + + + Second, we override the addVMPlugins[buildType] : aMaker method in our Configuration and set our vmplugins variable there similar to how we do it in this method. + SystemNavigation browseAllImplementorsOf: #addVMPluginsBuild: + + + It is my opinion that the selecting vm plugins based on buildType will not happen and that that those selected at the initialization change will be the default. + + + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>dirBuildLanguageVMMM (in category 'pages') ----- + dirBuildLanguageVMMM + ^HelpTopic + title:'Specify dirBuildLanguageVMMM' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + SystemNavigation new browseAllImplementorsOf: #dirBuildLanguageVMMM localTo:CPlatformConfigForSqueak. + + We scroll down to our Linux64x86w32BitSqueakCogSpurConfig which we copied from the existing Linux64x86w32BitSqueakCogV3Config. + + Looking at the dirBuildLanguageVMMM it initially reads (due to the copying of the existing class) + + dirBuildLanguageVMMM + ^self squeakCogV3 + + Since this is a configuration for Squeak Cog Spur, I modify the method to return + + dirBuildLanguageVMMM + ^self squeakCogSpur + + + As a sanity check, I verify that the method squeakCogSpur exists... + + SystemNavigation new browseAllImplementorsOf: #squeakCogSpur + + And we see the method exists and will return the string ''squeak.cog.spur''. + + (CPlatformConfigForSqueak basicNew) squeakCogSpur + + + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>dirSource (in category 'pages') ----- + dirSource + ^HelpTopic + title:'Specify Source Directory' + contents: + ' + Eliot''s VMMaker.oscog package outputs c-source code to varios directories depending ont he vm type. + + SystemNavigation new browseAllImplementorsOf: #dirSource localTo:CPlatformConfigForSqueak. + + Evaluating the above, we see that the CPlatformConfigForSqueak lists the available source directories. + + The string values for these things are hard-coded in CPlatformConfigForSqueak in the ''cmake source names'' category. + + ToolSet browse: CPlatformConfigForSqueak category: ''cmake source names'' + + For our Linux64x86w32BitSqueakCogSpurConfig we choose ''spursrc'' as our dirSource return value + + dirSource + ^self spursrc + + which you can test here. + + (Linux64x86w32BitSqueakCogSpurConfig basicNew) dirSource + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>excludingConfigFromBuilds (in category 'pages') ----- + excludingConfigFromBuilds + ^HelpTopic + title:'Excluding a Config From Builds' + contents: + 'Within the broad outline of this tutorial, you are here: + 5. Interaction of the Builder and your Configuration + + Configurations can hide themselves from , or make themselves visible to Builders via their ''excludeFromBuild'' method. + + excludeFromBuild + ^false "build this configuration" + " ^true do not build this configuration" + + In our case, the Builder shows us that Linux32x86SqueakCogSpurConfig is capable of being built (I had copied an existing, working Configuration): + + SqueakLinux64x86w32CompatBuilder availableBuildConfigurations + --> a SortedCollection(#Linux64x86w32BitSqueakCogSpurConfig #Linux64x86w32BitSqueakCogV3Config) + + + To exclude it, override (or alter) the Configurations ''excludeFromBuild'' method + + Linux64x86w32BitSqueakCogSpurConfig >>excludeFromBuild + "over-ride to exclude yourself from a build" + ^true + + And the Configuration is hidden from the Builder... + + SqueakLinux64x86w32CompatBuilder availableBuildConfigurations + --> a SortedCollection(#Linux64x86w32BitSqueakCogV3Config) + + + However, since I am developing locally, I need it to be visible to the Builder , so I set it as so: + + Linux64x86w32BitSqueakCogSpurConfig >>excludeFromBuild + "over-ride to exclude yourself from a build" + ^false + + And my Builder can see it again... + + SqueakLinux64x86w32CompatBuilder availableBuildConfigurations + --> a SortedCollection(#Linux64x86w32BitSqueakCogSpurConfig #Linux64x86w32BitSqueakCogV3Config) + + + N.B. tty. My opinion is that this is a weak way of doing this, but I have not thought through how to do this elegantly. + This functionality is included with an eye towards easing automated builds for all platforms and configurations.'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>extraVMSettings (in category 'pages') ----- + extraVMSettings + ^HelpTopic + title:'extraVMSettings' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + SystemNavigation browseAllImplementorsOf: #extraVMSettings: + + + In the CPlatformConfigForSqueak>>extraVMSettings: aMaker, we see the Method Redirect Pattern employed. Since this is for buildType #build, the method will re-route to self extraVMSettingsBuild: + + SystemNavigation browseAllImplementorsOf: #extraVMSettingsBuild: + + We see the CPLatformConfigForSqueak forces a subclass to implement it and the SqueakUnixConfig implements it. + + In SqueakUnixConfig a CMakeAddCustomCommandOutput is created and initialized. + + CMakeAddCustomCommandOutput browse + + The class comment says that: ''Add a custom build rule to the generated build system.'' + + + If you look in the file Cog/platforms/unix/config/verstamp you see that this is (looks like) the definition/implemenation of the command CMake + will invoke. + + + Currently this is a platform level method. Honestly, I have no idea why it is there. (: + + For our purposes, there is nothing we need to do. + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>fin (in category 'pages') ----- + fin + ^HelpTopic + title:'fin' + contents: + 'Within the broad outline of this tutorial, you are here: + + done!! + + To recap you have covered: + + 1. Tests + 2. Where to place your new Configuration + 3. What Builder to use + 4. Create your Configuration + 5. Interaction of the Builder and your Configuration + 6. Generating a proof-of-concept CMake build tree. + 7. Some high level classes and concepts + 7.a CPlatformConfigForSqueak + 7b. The Method Redirect Pattern (a broadly used design pattern in the system) + 7c. The CMakeVMGeneratorForSqueak + 8. Customizing your Configuration. + + + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>firstCMakeGeneration (in category 'pages') ----- + firstCMakeGeneration + "This method was automatically generated. Edit it using:" + "a HelpBrowser edit: #firstCMakeGeneration" + ^HelpTopic + title: 'First CMake Generation' + contents: + 'Within the broad outline of this tutorial, you are here: + 6. Generating a proof-of-concept CMake build tree. + + For didactic purposes I am going to do a sanity check and generate CMake code from the configuration for the first time. + + If you are not familiar with the CMakeVMMakerSqueak naming conventions, please evaluate: + HelpBrowser openOn: CMakeVMMakerSqueakOverviewHelp + + On my system a copy of the Cog svn tree is located under my current working Squeak directory in the folder ''oscogvm". + + It looks like this: + + bash-4.2$ ls --width=1 ~/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/ + README + build + build.linux32ARM + build.linux32x86 + build.linux64x64 + build.macos32x86 + build.macos64x64 + build.win32x86 + history + mkNamedPrims.sh + nsspur64src + nsspursrc + nsspurstack64src + nsspurstacksrc + nssrc + platforms + processors + products + scripts + sources + spur64src + spursistasrc + spursrc + spurstack64src + spurstacksrc + src + stacksrc + + What I want to do is see if my configuration will write its output to an appropriate CMake subfolder. + + To do this, I ask the Builder to configure my new configuration for a buildType and output its contents. I do so by evaluating: + + SqueakLinux64x86w32CompatBuilder + configureA: #Linux32x86SqueakCogSpurConfig forBuildType:#build; + enableMessageTracking: true; + generateByTemplate. + + + and look again + bash-4.2$ ls --width=1 usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/ + CHANGES + LICENSE + README + build + build.linux32ARM + build.linux32x86 + build.linux64x64 + build.macos32x86 + build.macos64x64 + build.win32x86 + cmake.build.linux64x86w32BitCompatibility <--Here is the directory created by my configuration. + history + .... + + Above we see that a new cmake.build.linux64x86w32BitCompatibility directory has been created. Let''s look at its contents + + tree -d ~/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/cmake.build.linux64x86w32BitCompatibility/ + `-- squeak.cog.v3 <--We will be changing this later as we want a squeak.cog.spur directory, not a V3 directory + `-- build <--our build type is #build + |-- ADPCMCodecPlugin + |-- AsynchFilePlugin + |-- B2DPlugin + |-- BMPReadWriterPlugin + |-- BitBltPlugin + |-- CroquetPlugin + |-- DSAPrims + |-- DropPlugin + |-- FFTPlugin + |-- FileCopyPlugin + |-- FilePlugin + |-- FloatArrayPlugin + |-- FloatMathPlugin + |-- JoystickTabletPlugin + |-- Klatt + |-- LargeIntegers + |-- LocalePlugin + |-- MIDIPlugin + |-- Matrix2x3Plugin + |-- MiscPrimitivePlugin + |-- Mpeg3Plugin + |-- SecurityPlugin + |-- SerialPlugin + |-- SocketPlugin + |-- SoundCodecPrims + |-- SoundGenerationPlugin + |-- SoundPlugin + |-- StarSqueakPlugin + |-- SurfacePlugin + |-- ZipPlugin + |-- vm-display-X11 + |-- vm-display-null + |-- vm-sound-ALSA + `-- vm-sound-null + + ...etc + We see that the configuration has output a CMake build tree and we have done a sanity check. + + Next we take stock of what we have accomplished and preview the remaining tasks. + + !!' readStream nextChunkText! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>generateBuildScript (in category 'pages') ----- + generateBuildScript + ^HelpTopic + title:'Generate Build Script' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + ToolSet browse: CPlatformConfigForSqueak selector: buildScript + + This generates a bash shell script that can be used in place of manuallinvoking cmake and make. + + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>generatePluginConfigs (in category 'pages') ----- + generatePluginConfigs + ^HelpTopic + title:'generatePluginConfigs' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + This method iterates over a collection of InterpreterPlugin subclasses and asks each class to populate itself with some basic information and write out its own CMakeLists.txt in a directory named after the plugin name. + + The processing is a bit complicated, but the setup is easy. + + The collections of plugin classes are stored in our Configuration. We cover that next in Specifying Plugins'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>identifyBuilder (in category 'pages') ----- + identifyBuilder + ^HelpTopic + title:'Identify Builder' + contents: + 'Within the broad outline of this tutorial, you are here: + 3. What Builder to use + + My new Configuration will be managed by a Builder. + + Builders are located in the CMakeVMMakerSqueak-Builder class category. + + Builders are subclasses of SqueakCMakeVMMakerAbstractBuilder. + SqueakCMakeVMMakerAbstractBuilder browseHierarchy + + Builders are named according to the Platform they manage. + + (For a discussion on naming conventions evaluate: + HelpBrowser openOn: CMakeVMMakerSqueakOverviewHelp + ) + + Builders manage configurations for one Platform in one class category. + + + My platform is Linux Linux64x86 with 32 bit compatability libs stored in /usr/lib (other linux use /usr/lib32 for this.) + + I suspect that the SqueakLinux64x86w32CompatBuilder as the Builder that will manage my new configuration. + + I confirm this by sending it the ''configurationsCategory'' message as shown below: + + SqueakLinux64x86w32CompatBuilder configurationsCategory + -->''CMakeVMMakerSqueak-Linux64X86-32BitCompatibility'' <---this is the correct class category for my Platform. + + This is correct Builder for my new Configuration. + + I can query the Builder for some more information: + + SqueakLinux64x86w32CompatBuilder availableBuildConfigurations + a SortedCollection(#Linux64x86w32BitSqueakCogV3Config) <--A Cog V3 configuration exists. + + SqueakLinux64x86w32CompatBuilder unAvailableBuildConfigurations + --> a SortedCollection(#Linux64x86w32BitConfigUsrLib #Linux64x86w32BitConfigUsrLib32) + <--these are platform specific Abstract Base Classes. Abstract Base Classes cannot be built, hence they are unavailable. + + SqueakLinux64x86w32CompatBuilder buildDirectory + -->''cmake.build.linux64x86w32BitCompatibility'' <--this matches my platform + + We will be using the SqueakLinux64x86w32CompatBuilder in tandem with Tests during Configuration development.' + + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>identifyPlatform (in category 'pages') ----- + identifyPlatform + ^HelpTopic + title:'Identify Platform' + contents: + ' Within the broad outline of this tutorial, you are here: + 2. Where to place your new Configuration + + My target platform is 64 bit Linux on X86 with 32 bit compatibility libraries stored in /usr/lib. + + I identify my Platform in the existing CMakeVMMakerSqueak-xyz class categories. + + If I wanted a configuration for MacOSX32x86, I would place my configuration in CMakeVMMakerSqueak-MacOSX32x86. + If SunOSx3x86 then CMakeVMMakerSqueak-SunOS32x86. + etc. + + For a discussion on naming conventions evaluate: + HelpBrowser openOn: CMakeVMMakerSqueakOverviewHelp + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>identifyPlatformAbstractBaseClass (in category 'pages') ----- + identifyPlatformAbstractBaseClass + ^HelpTopic + title:'Identify Abstract Base Class ' + contents: + 'Within the broad outline of this tutorial, you are here: + 2. Where to place your new Configuration + + My new configuration must be a subclass of my Platform''s Abstract Base Class. + + A Platform Abstract Base Class encapsulates common platform information. + + In CMakeVMMakerSqueak-Linux64X86-32BitCompatibility class category I see two Abstract Base Classes (typically there is only one). They are: + + Linux64x86w32BitConfigUsrLib + Linux64x86w32BitConfigUsrLib32 + + The Suffixes ''UsrLib'' and ''UsrLib32'' refer to the location of the 32 bit compatablity libs. + On my system they are in /usr/lib, so I choose Linux64x86w32BitConfigUsrLib as my Abstract Base Class + + Examples of Abstract Base Classes in other class categories include: + + CMakeVMMakerSqueak-BSD32x86 -> SqueakBSD32x86Config + CMakeVMMakerSqueak-IA32-Bochs -> SqueakIA32BochsConfig + CMakeVMMakerSqueak-IOS -> SqueakIOSConfig + CMakeVMMakerSqueak-IOS -> SqueakIOSConfig + CMakeVMMakerSqueak-Linux32ARMv6 -> Linux32ARMv6Config + CMakeVMMakerSqueak-Linux64x64 -> Linux64x64Config + CMakeVMMakerSqueak-MacOSPowerPC -> SqueakMacOSXPowerPCConfig + CMakeVMMakerSqueak-MacOSX32x86 -> SqueakMacOSX32x86Config + CMakeVMMakerSqueak-SunOS32x86 -> SqueakSunOS32x86Config + CMakeVMMakerSqueak-Win32x86 -> SqueakWin32x86Config + + I can identify the Abstract Base Class in several ways + + 1. It is a topmost class in the class heirarchy for that platform/class category + 2. It is named after its platform + 3. It answers #true to the message isAbstractBaseClass + Linux64x86w32BitConfigUsrLib isAbstractBaseClass + --> true + + In this workflow example I ideduce that the AbstractBaseClass for my Platform is Linux64x86w32BitConfigUsrLib'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>initializePlatformSources (in category 'pages') ----- + initializePlatformSources + ^HelpTopic + title:'Initialize Platform Sources' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + Platform Sources are platform dependent source files in the Cog development tree.. + To build the VM, CMake needs to know their names. + + They reside in subdirectories of Cog/platforms + + bash-4.2$ ls -1 Cog/platforms/ + Cross + Mac OS + Plan9 + RiscOS + iOS + unix + win32 + + On the unix platform the VM depends on some platform sources they are stored in the platforms/unix/vm directory.. + + bash-4.2$ ls -1 Cog/platforms/unix/vm/*.[ch] + Cog/platforms/unix/vm/SqDisplay.h + Cog/platforms/unix/vm/SqModule.h + Cog/platforms/unix/vm/SqSound.h + Cog/platforms/unix/vm/aio.c + Cog/platforms/unix/vm/debug.c + Cog/platforms/unix/vm/debug.h + Cog/platforms/unix/vm/dlfcn-dyld.c + Cog/platforms/unix/vm/feedback.h + Cog/platforms/unix/vm/glibc.h + Cog/platforms/unix/vm/mac-alias.c + Cog/platforms/unix/vm/osExports.c + Cog/platforms/unix/vm/sqConfig.h + Cog/platforms/unix/vm/sqGnu.h + Cog/platforms/unix/vm/sqPlatformSpecific.h + Cog/platforms/unix/vm/sqUnixCharConv.c + Cog/platforms/unix/vm/sqUnixCharConv.h + Cog/platforms/unix/vm/sqUnixEvent.c + Cog/platforms/unix/vm/sqUnixExternalPrims.c + Cog/platforms/unix/vm/sqUnixGL.h + Cog/platforms/unix/vm/sqUnixGlobals.h + Cog/platforms/unix/vm/sqUnixHeartbeat.c + Cog/platforms/unix/vm/sqUnixITimerHeartbeat.c + Cog/platforms/unix/vm/sqUnixITimerTickerHeartbeat.c + Cog/platforms/unix/vm/sqUnixMain.c + Cog/platforms/unix/vm/sqUnixMain.h + Cog/platforms/unix/vm/sqUnixMemory.c + Cog/platforms/unix/vm/sqUnixSpurMemory.c + Cog/platforms/unix/vm/sqUnixThreads.c + Cog/platforms/unix/vm/sqUnixVMProfile.c + Cog/platforms/unix/vm/sqUnixWindow.h + Cog/platforms/unix/vm/sqaio.h + Cog/platforms/unix/vm/sunos.h + + A subset of these must be customized in our Configuration. + In the initializePlatformSources step, the universe of possible sources is hard coded by hand* + + If you look at the system level configurations you can see the files listed + SystemNavigation browseAllImplementorsOf: #initializePlatformSources + + + There are different sources for the Windows and Mac platforms which I do not cover here. As of 20160530 the Dos and Mac code has not been developed beyond what I inherited from the Pharo code.. + + *This has already bitten me. The sqUnixSpurMemory was added as I was developing this system and was not originally in my list of initialized files. I had to debug the problem and then add it by hand. + + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>initializeVMPlugins (in category 'pages') ----- + initializeVMPlugins + ^HelpTopic + title:'Initialize VM Plugins' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + VM Pluings are a type of plugin that is unique to Unix. Their directories exist in the Cog/Platforms/unix directory + Shown here: + + bash-4.2$ ls -1d Cog/platforms/unix/vm-* + Cog/platforms/unix/vm-display-Quartz + Cog/platforms/unix/vm-display-X11 + Cog/platforms/unix/vm-display-custom + Cog/platforms/unix/vm-display-fbdev + Cog/platforms/unix/vm-display-null + Cog/platforms/unix/vm-sound-ALSA + Cog/platforms/unix/vm-sound-MacOSX + Cog/platforms/unix/vm-sound-NAS + Cog/platforms/unix/vm-sound-OSS + Cog/platforms/unix/vm-sound-Sun + Cog/platforms/unix/vm-sound-custom + Cog/platforms/unix/vm-sound-null + Cog/platforms/unix/vm-sound-pulse + + + + ToolSet browse: CPlatformConfigForSqueak selector: #initializeVMPlugins + + is a hard-coded list of these VM Plugins but expressed as a list of encapsulating objects. + These objects are just data buckets for carrying information that will be used to build them. + + CMakeVMPlugin browseHierarchy + + On initialization, the CPlatformConfgiForSqueak stores them in its vmplugins instance variable where we will customize them later. + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>key (in category 'accessing') ----- + key + ^'CMakeVMMakerSqueakStepByStepNewConfigurationHelp'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>methodRedirectPattern (in category 'pages') ----- + methodRedirectPattern + ^HelpTopic + title:'Review of Method Redirect Pattern' + contents: + 'Within the broad outline of this tutorial, you are here: + 7. Some high level classes and concepts + 7b. The Method Redirect Pattern (a broadly used design pattern in the system) + + The CPlatformConfigForSqueak provides methods that must be implemented at some level in the CPlatformConfigForSqueak hierarchy. + The design pattern is heavily used and you can get a sense of its scope by evaluating: + + ToolSet browseMessageCategory: ''cmake buildType redirects'' inClass:CPlatformConfigForSqueak + + The naming of the redirect methods follows a consistent pattern. + + fooBuild; + fooBuildAssert + fooBuildAssertITimerHeartbeat + fooBuildDebug + fooBuildDebugITimerHeartbeat + fooBuildITimerHeartbeat + fooBuildMultiThreaded + fooBuildMultiThreadedAssert + fooBuildMultiThreadedDebug + fooNoBuildType + + Where the suffix to ''foo'' denotes a specific buildType out of the available pool specified here: + + SqueakCMakeVMMakerAbstractBuilder allBuildTypes + + + The CPlatformConfigForSqueak either (rarely) implements or requires that at least one of these methods are implemented as such: + + fooBuild + self subclassResponsibility + + + At the same time, it does not require that all of them be implemented. It accomplishes this by defaulting to the ''fooBuild'' method: + + fooBuildAssertITimerHeartbeat + ^ self fooBuild + + You can see the ''foo'' pattern here in the ''cmakeAddDefinitions'' method + + SystemNavigation new browseAllImplementorsOf: #cmakeAddDefinitionsBuildMultiThreadedAssert localTo: CPlatformConfigForSqueak. + + Most buildTypes are redirected to a default implementation. This default implementation is implemented at an appropriate level in the CPlatformConfigHeirarchy + + There are some redirect methods that are appropriate to CPlatformConfigForSqueak; for example: + + SystemNavigation new browseAllImplementorsOf: #setGlobalOptionsBuild: localTo: CPlatformConfigForSqueak. + + Most methods are implemented lower in the hierarchy. + + When we implement a Configuration, we are implementing and or overriding methods in CMakePlatformConfigForSqueak that are appropriate for our buildType. + + The Method Redirect Pattern is covered in detail in an existing Help topic. + + HelpBrowser openOn: CMakeVMMakerSqueakDesignPatternsHelp + + Invocation of the Method Redirect Pattern occurs in the VMGenerator. We cover that next. + + ' + + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>overview (in category 'pages') ----- + overview + "This method was automatically generated. Edit it using:" + "a HelpBrowser edit: #overview" + ^HelpTopic + title: 'Overview' + contents: + 'This Help Topic presents the workflow the author used in creating the Squeak, Cog, Spur CMake configuration for a 64 bit Slackware 14.1 system.with 32 bit compatability libs in /usr/lib + + The broad outline of this tutorial covers + + 1. Tests + 2. Where to place your new Configuration + 3. What Builder to use + 4. Create your Configuration + 5. Interaction of the Builder and your Configuration + 6. Generating a proof-of-concept CMake build tree. + 7. Some high level classes and concepts + 7.a CPlatformConfigForSqueak + 7b. The Method Redirect Pattern (a broadly used design pattern in the system) + 7c. The CMakeVMGeneratorForSqueak + 8. Customizing your Configuration. + + + Although some details will be different, the steps involved should be the same for any platform. + + + + + + !!' readStream nextChunkText! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>pages (in category 'accessing') ----- + pages + + "platformSources...cogitClass...src vs vmsrc" + ^#( + overview + tests + identifyPlatform + identifyPlatformAbstractBaseClass + identifyBuilder + createTheConfiguration + excludingConfigFromBuilds + setAvailableBuildTypes + firstCMakeGeneration + tackingStockOne + cPlatformConfigForSqueak + methodRedirectPattern + theVMGenerator + tackingStockTwo + cPlatformConfigForSqueakInitialize + initializePlatformSources + customizePlatformSources + initializeVMPlugins + customizeVMPlugins + configGenerateByTemplate + specifyCogitClass + + vmsrc + + specifyDirectories + dirBuildLanguageVMMM + setGlobalOptions + cmakePrefixPath + cmakeIncludePath + cmakeLibraryPath + cmakeIncludeModules + cmakeCFlags + cmakeAddDefinitions + cmakeWriteDirectoriesDotCmake + cmakeIncludeDirectories + preferredIncludes + standardIncludes + setGlobalOptionsAfterDetermineSystem + extraVMSettings + setCoreSources + setPlatformSources + setCrossSources + setExtraSources + cmakeSetSourceFilesProperties + cmakeListAppendLINKLIBSelements + cmakeAddExecutableNameOptionSource + setExecutableOutputPath + addVMPlugins + generatePluginConfigs + specifyPlugins + processThirdpartyLibraries + processPlugins + postBuildActions + generateBuildScript + fin + ) + + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>postBuildActions (in category 'pages') ----- + postBuildActions + ^HelpTopic + title:'postBuildActions:' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + postBuildActions: implements the Method Redirect pattern. + + ToolSet browse: CPlatformConfigForSqueak selector: #postBuildActions: + + Since the configuration is configured for buildType: #build the method redirect pattern will redirect to + + SystemNavigation browseAllImplementorsOf: #postBuildActionsBuild: + + We see in CPlatformConfigForSqueak that a sublcass must implement it via ''self subclassResponsibility''. + + The platform Config SqueakUnixConfig implements this. It can be over-ridden or extended as needed. + + We have nothing new to do here. + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>preferredIncludes (in category 'pages') ----- + preferredIncludes + ^HelpTopic + title:'preferredIncludes' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + SystemNavigation browseAllImplementorsOf: #preferredIncludes + + CPlatformConfig browseHierarchy + + As of CMakeVMMakerSqueak-tty.114 the method is a legacy method from the pharo CPlatformConfig. It is expect it (and this help page!!) will go away on a refactoring pass when the dependency on the pharo package is removed. + + + In the CPlatformConfigForSqueak>>preferredIncludes, we see the Method Redirect Pattern employed. Since this is for buildType #build, the method will re-route to self preferredIncludesBuild. + + SystemNavigation browseAllImplementorsOf: #preferredIncludesBuild + + We see that #preferredIncludesBuild is subclassed and implemented below the the platform level and down at the architecture/library location, one level above our new configuration. + + Linux64x86w32BitConfigUsrLib browseHierarchy + + The method itself creates a CMakeIncludeDirectories CMake template + + CMakeIncludeDirectories browse + + The class comment tells us that we can add custom include directories for CMake to use. + + The CMake template class initializes itself with some default data, which you can print out here: + + (CMakeIncludeDirectories new) content + + Since this is handled for us one level above our new configuration, we will leave this one untouched. If it turns out that we need to include some other directories, we can override the method.'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>processPlugins (in category 'pages') ----- + processPlugins + ^HelpTopic + title:'Process Plugins' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + SystemNavigation browseAllImplementorsOf: #processPlugins: + + This method is inhereted from the pharo code. I do not fully understand the reasoning behind it. I expect it will be refactored or rewritten. + See the method comment in + + SystemNavigation browseAllImplementorsOf: #initializeConfigDotCmakeFiles + + Presently it does (at least) three things. + + First, it adds plugin information to the master CMakeLists.txt file typically the add_subdirectory(''PluginName'') cmake command. + + Second, it adds plugin information to the master CMakeLists.txt file from the CMakePluginGeneratorForSqueak>>configDotSomePluginName group of methods + + + SystemNavigation browseAllImplementorsOf: #configDotFilePlugin + + + Third it generates the sqNamedPrims.h file reproduced below. + + bash-4.2$ cat sqNamedPrims.h + /* This is automatically generated file using CVMMaker on 9 May 2016 2:26:20.906098 pm */ + extern sqExport vm_exports[]; + extern sqExport os_exports[]; + extern sqExport ADPCMCodecPlugin_exports []; + extern sqExport AsynchFilePlugin_exports []; + extern sqExport B2DPlugin_exports []; + extern sqExport BitBltPlugin_exports []; + extern sqExport BMPReadWriterPlugin_exports []; + extern sqExport CroquetPlugin_exports []; + extern sqExport ZipPlugin_exports []; + extern sqExport DropPlugin_exports []; + extern sqExport DSAPrims_exports []; + extern sqExport FFTPlugin_exports []; + extern sqExport FileCopyPlugin_exports []; + extern sqExport FilePlugin_exports []; + extern sqExport FloatArrayPlugin_exports []; + extern sqExport FloatMathPlugin_exports []; + extern sqExport JoystickTabletPlugin_exports []; + extern sqExport Klatt_exports []; + extern sqExport LargeIntegers_exports []; + extern sqExport Matrix2x3Plugin_exports []; + extern sqExport MIDIPlugin_exports []; + extern sqExport MiscPrimitivePlugin_exports []; + extern sqExport Mpeg3Plugin_exports []; + extern sqExport SecurityPlugin_exports []; + extern sqExport SerialPlugin_exports []; + extern sqExport SocketPlugin_exports []; + extern sqExport SoundCodecPrims_exports []; + extern sqExport SoundPlugin_exports []; + extern sqExport StarSqueakPlugin_exports []; + extern sqExport SurfacePlugin_exports []; + extern sqExport LocalePlugin_exports []; + + sqExport *pluginExports[] = { + vm_exports, + os_exports, + ADPCMCodecPlugin_exports, + AsynchFilePlugin_exports, + B2DPlugin_exports, + BitBltPlugin_exports, + BMPReadWriterPlugin_exports, + CroquetPlugin_exports, + ZipPlugin_exports, + DropPlugin_exports, + DSAPrims_exports, + FFTPlugin_exports, + FileCopyPlugin_exports, + FilePlugin_exports, + FloatArrayPlugin_exports, + FloatMathPlugin_exports, + JoystickTabletPlugin_exports, + Klatt_exports, + LargeIntegers_exports, + Matrix2x3Plugin_exports, + MIDIPlugin_exports, + MiscPrimitivePlugin_exports, + Mpeg3Plugin_exports, + SecurityPlugin_exports, + SerialPlugin_exports, + SocketPlugin_exports, + SoundCodecPrims_exports, + SoundPlugin_exports, + StarSqueakPlugin_exports, + SurfacePlugin_exports, + LocalePlugin_exports, + NULL + + + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>processThirdpartyLibraries (in category 'pages') ----- + processThirdpartyLibraries + ^HelpTopic + title:'Process Third Party Libraries' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + SystemNavigation browseAllImplementorsOf: #processThirdpartyLibraries + + I have no idea what this does. It exists in the pharo codebase. + + If I do figure out its utility, then the processing architecture will be similar or identical to the Plugin processing. + + i.e. Libraries will be represented by objects which will have the responsibility of generating ''stuff''. + + + + .'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>setAvailableBuildTypes (in category 'pages') ----- + setAvailableBuildTypes + ^HelpTopic + title:'Setting Available Build Types' + contents: + 'Within the broad outline of this tutorial, you are here: + 5. Interaction of the Builder and your Configuration + + Configurations inform Builders what BuildTypes they support. via the availableBuildTypes method + + Here is my Builder asking my new Configuration what build types it supports (remember, this Configuration was copied, so it has been configured already) + + SqueakLinux64x86w32CompatBuilder availableBuildTypesFor: #Linux64x86w32BitSqueakCogSpurConfig + --> an OrderedCollection(#build #buildAssert) + + + In our Abstract Base Class (Which, you recall cannot be built )for our Platform, we default to no build types. + + Linux64x86w32BitConfigUsrLib>>availableBuildTypes + ^SqueakCMakeVMMakerAbstractBuilder default noBuildTypes + + + To get an idea of what buildTypes are available system wide evaluate + SqueakCMakeVMMakerAbstractBuilder default allBuildTypes + -->an OrderedCollection(#build #buildAssert #buildAssertITimerHeartbeat #buildDebug #buildDebugITimerHeartbeat #buildITimerHeartbeat #buildMultiThreaded #buildMultiThreadedAssert #buildMultiThreadedDebug #buildNone) + + + To set the available build types for a Concrete Configurations we override the AbstactBaseClass''s method and SUBTRACT OUT what we do not want. Like so: + + Since I am starting simple, I want my configuration to build a vanilla build. To do this I remove all but #build buildType like so + + Linux64x86w32BitSqueakCogSpurConfig >> availableBuildTypes + ^SqueakCMakeVMMakerAbstractBuilder default allBuildTypes copyWithoutAll: #( #buildAssert #buildAssertITimerHeartbeat #buildDebug #buildDebugITimerHeartbeat #buildITimerHeartbeat #buildMultiThreaded #buildMultiThreadedAssert #buildMultiThreadedDebug #buildNone) + + + As I code more build types in my configuration, I subtract out + + Linux32x86SqueakCogV3Config >> availableBuildTypes + ^SqueakCMakeVMMakerAbstractBuilder default allBuildTypes copyWithoutAll: #( #buildMultiThreadedDebug #buildNone) + + With the result that my Builder shows the removed items as Available Build Types: + + SqueakLinux32x86Builder availableBuildTypesFor: #Linux32x86SqueakCogV3Config + --> an OrderedCollection(#build #buildAssert #buildAssertITimerHeartbeat #buildDebug #buildDebugITimerHeartbeat #buildITimerHeartbeat #buildMultiThreaded #buildMultiThreadedAssert) + + Since I will only be developing the #build buildType for now, I put it as so: + + Linux32x86SqueakCogV3Config>>availableBuildTypes + ^SqueakCMakeVMMakerAbstractBuilder default allBuildTypes copyWithoutAll: #( #buildAssert #buildAssertITimerHeartbeat #buildDebug #buildDebugITimerHeartbeat #buildITimerHeartbeat #buildMultiThreaded #buildMultiThreadedAssert #buildMultiThreadedDebug #buildNone) + + + and verify it is correct: + + SqueakLinux32x86Builder availableBuildTypesFor: #Linux32x86SqueakCogV3Config + -->an OrderedCollection(#build) + + + *N.B. tty. In my opinion, this is a weak design on my part. as it relies on the developer to set it up. If there is an elegant way to do this , I am for it. + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>setConfigurationDirectory (in category 'pages') ----- + setConfigurationDirectory + ^HelpTopic + title:'Set Configuration Directory' + contents: + ' + Need the squeak.cog.spur directory here. + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>setCoreSources (in category 'pages') ----- + setCoreSources + ^HelpTopic + title:'setCoreSources' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + SystemNavigation browseAllImplementorsOf: #setCoreSources: + + The ''self coreSources'' message is a Method Redirect Pattern. + + ToolSet browse: CPlatformConfigForSqueak selector:#coreSources + + SystemNavigation browseAllImplementorsOf: #coreSourcesBuild + + Here we see a hard-coded list returned (this will probably be refactored on a refactoring pass) + + The ''${srcVMDir}'' is a variable placeholder in CMake. It contains a path name that resolves to where those files listed above exist. + + We set that in (FIX ME AND IDENTIFY PRECISIELY WHERE srcVMDir gets its value) + + ' + + + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>setCrossSources (in category 'pages') ----- + setCrossSources + ^HelpTopic + title:'setCrossSources' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + SystemNavigation browseAllImplementorsOf: #setCrossSources: + + We see that this is a top-level Configuration method that writes a CMake Set(foo, bar) construct. + + crossSources is another hard-coded list of source files + + ToolSet browse: SqueakUnixConfig selector: #crossSources + + This list of sources is in the Cog subversion build tree under: + + bash-4.2$ ls -1 Cog/platforms/Cross/vm/*.c + oscogvm/platforms/Cross/vm/sqExternalSemaphores.c + oscogvm/platforms/Cross/vm/sqHeapMap.c + oscogvm/platforms/Cross/vm/sqNamedPrims.c + oscogvm/platforms/Cross/vm/sqTicker.c + oscogvm/platforms/Cross/vm/sqVirtualMachine.c + + The ''${crossDir}'' is a variable placeholder that CMake will populate. The variable value is held in our configuration + It will resolve to "oscogvm/platforms/Cross/vm'' + + What this is doing is creating a list of paths to files. + + If any Cross platform files are ever added, we will have to modify the #crossSources return value. + + + + ' + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>setExecutableOutputPath (in category 'pages') ----- + setExecutableOutputPath + "This method was automatically generated. Edit it using:" + "a HelpBrowser edit: #setExecutableOutputPath" + ^HelpTopic + title: 'setExecutableOutputPath' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + SystemNavigation browseAllImplementorsOf: #setExecutableOutputPath + + We see that this is implemtented in CPlatformConfigForSqueak. + + It creates a CMakeSet object and sets the ''EXECUTABLE_OUTPUT_PATH'' variable to self outputDir + + SystemNavigation browseAllImplementorsOf: #outputDir + + Which redirects to + + (CPlatformConfigForSqueak basicNew) outputDirName + + The #outputDir method is a legacy method from the pharo code. It should be factored out after the dependency on the pharo code is removed.!!' readStream nextChunkText! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>setExtraSources (in category 'pages') ----- + setExtraSources + ^HelpTopic + title:'setExtraSources' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + SystemNavigation browseAllImplementorsOf: #setExtraSources + + We see that this is a top-level Configuration method that writes a CMake Set(foo, bar) construct. + + You can see the CMake generated by evaluating + + ((CMakeSet new) variable:''extraSources'' value:((SqueakUnixConfig basicNew) extraSources)) content + + The #extraSources method contains some hard coded values (expect refactoring) + + SystemNavigation browseAllImplementorsOf: #extraSources + + ToolSet browse: SqueakUnixConfig selector: #extraSources + + If we needed to we could add or remove these in our Configuration. + + For us, there is nothing to do here. + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>setGlobalOptions (in category 'pages') ----- + setGlobalOptions + ^HelpTopic + title:'setGlobalOptions: self' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + For this method there is nothing to do. Here is why. + + Let''s start by seeing what classes implement the method + + SystemNavigation browseAllImplementorsOf: #setGlobalOptions: + + We see that CPlatformConfigForSqueak implements it (The other classes are from the pharo package. These will go way after the dependency on the pharo code is factored out). + + Looking at it, we see that the method implements the Method Redirect pattern + + Since we have configured for buildType: #build, the Method Redirect Pattern will invoke the setGlobalOptionsBuild: aMaker method. + + So we look at the implementors of it.. + + SystemNavigation browseAllImplementorsOf: #setGlobalOptionsBuild: + + We see only CPlatformConfigForSqueak implements the method. Reading the method comments, we see that it generates CMakeLists.txt commands that span all platforms. + + No subclasses of CPlatformConfigForSqueak override it. + + There is nothing for us to override here. Let''s move on. + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>setGlobalOptionsAfterDetermineSystem (in category 'pages') ----- + setGlobalOptionsAfterDetermineSystem + ^HelpTopic + title:'setGlobalOptionsAfterDetermineSystem' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + SystemNavigation browseAllImplementorsOf: #setGlobalOptionsAfterDetermineSystem: + + + In the CPlatformConfigForSqueak>>setGlobalOptionsAfterDetermineSystem: aMaker, we see the Method Redirect Pattern employed. Since this is for buildType #build, the method will re-route to self setGlobalOptionsAfterDetermineSystemBuild + + SystemNavigation browseAllImplementorsOf: #setGlobalOptionsAfterDetermineSystemBuild: + + We see the CPLatformConfigForSqueak forces a subclass to implement it and the SqueakUnixConfig implements it. + + In SqueakUnixConfig a CMakeSet is created and initialized. You can see the resultant output by printing the below expression: + + ((CMakeSet new) variable:''CMAKE_C_COMPILER'' value:''gcc'') content + + Currently this is a platform level method, however, we can envision it being set lower when ''gcc'' is not the default compiler. + + For our purposes, there is nothing we need to do. + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>setPlatformSources (in category 'pages') ----- + setPlatformSources + ^HelpTopic + title:'setPlatformSources' + contents:' + Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + SystemNavigation browseAllImplementorsOf: #setPlatformSources: + + We see the Method Redirect Pattern. + + SystemNavigation browseAllImplementorsOf: #setPlatformSourcesBuild: + + Looking at Linux64x86w32BitSqueakCogSpurConfig>>setPlatformSourceBuild: aMaker + + we see work we did earlier in this tutorial. + + If you recall, on Configuration initialization the platformSources variable was populated with the names of source files in Cog/platforms/unix/vm + + Here we must return a subset of that data. + + .' + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>specifyCogitClass (in category 'pages') ----- + specifyCogitClass + ^HelpTopic + title:'Specify Cogit Class' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + Depending on the type of vm we are building, we must specify the cogit class + + ToolSet browse: CPlatformConfigForSqueak selector: #cogitClass + + The types we can return are + + ^SimpleStackBasedCogit + ^ StackToRegisterMappingCogit + ^SistaStackToRegisterMappingCogit + + These are subclasses of Cogit. + Cogit browseHierarchy + + Since we are building a Cog VM we need the StackToRegisterMappingCogit. + + (I need to get with Eliot to specify this exactly) + + For our purposes in this tutorial, we have our Linux64x86w32BitSqueakCogSpurConfig>>cogitClass return StackToRegisterMappingCogit. + + ToolSet browse: Linux64x86w32BitSqueakCogSpurConfig selector: #cogitClass + + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>specifyDirectories (in category 'pages') ----- + specifyDirectories + ^HelpTopic + title:'Specify Directories' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + Our new Configuration must correctly name two directory trees. + + The first is the cmake.build.* directory tree where the generated CMake output is placed. + The second is the cmake.products/* directory tree where the compiled vm is placed. + + + Correctly naming these is a courtesy you should extend as the system grows*. + + + For this particular Configuration, we want a cmake.build.* directory that looks like this: + + oscogvm/cmake.products/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur + + + and we want a cmake.products/* directory that looks like this: + + oscogvm/cmake.products/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur/build + + + Each directory in those trees is accessible viathe the CPlatformConfigForSqueak in the ''cmake directory'' category. + + ToolSet browseClass: CPlatformConfigForSqueak category: ''cmake directory''. + + There are two method variants. + + The first variant is hardcoded in the method itself. For example the platform directories are stored as... + + dirLinux32Armv6 + ^''cmake.build.linux32armv6'' + + or, for our configuration + + dirLinux64x86w32BitCompatibility + ^''cmake.build.linux64x86w32BitCompatibility'' + + The second variant accesses the name of a buildType directory via the SqueakCMakeVMMakerAbstractBuilder (do a printIt or doIt). + + dirBuild + ^SqueakCMakeVMMakerAbstractBuilder default buildTypeAndDirectoryInfo at: #build + + + + Each part of the directory tree is contained/accessible via these methods. It is our job to select the corect ones for our purposes. + + Here is an example of mapping this output directory path + ''oscogvm/cmake.products/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur/build'' + + to the methods that output each part. + + |c| + c:=(CPlatformConfigForSqueak basicNew). + (c oscogvm), ''/'', (c dirOutput), ''/'', (c dirLinux64x86w32BitCompatibility), ''/'', (c squeakCogSpur), ''/'', (c dirBuild) + + + The methods corresponding to each of the above directory names are: + + topDir + dirOutput + dirBuildPlatform + dirBuildLanguageVMMM + buildType (not a method,this is a private instance variable in the configuration) + + The first two, topDir and dirOutput are contained in CPlatformConfigForSqueak + dirBuildPlatform is contained at the platform level + + SystemNavigation new browseAllImplementorsOf: #dirBuildPlatform localTo:CPlatformConfigForSqueak. + + dirBuildLangaugeVMMM is at the specific Configuration level + SystemNavigation new browseAllImplementorsOf: #dirBuildLanguageVMMM localTo:CPlatformConfigForSqueak. + + buildType is set when we configure the Configuration for a particular buildType and is stored in the SqueakCMakeVMMakerAbstractBuilder at its initialization. + + SystemNavigation new browseAllImplementorsOf: #initializeBuildTypeAndDirectoryInfo + + It is this values that the CPlatformConfigForSqueak access via dirBuild, dirBuildAssert etc... + SystemNavigation new browseAllImplementorsOf: #dirBuild + + + Similarly, the build directory tree + ''oscogvm/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur/build/'' + + has methods corresponding to each of the above directory names. they are: + + topDir + dirBuildPlatform + dirBuildLanguageVMMM + buildType (not a method,this is a private instance variable in the configuration) + + It follows then, that for our Configuration we need to make the method dirBuildLanguageVMMM return ''squeak.cog.spur''. + + We cover that in the next Help page. + + + *The naming convention is straightforward and convered in the ''Naming Convetions'' page of the Developer Guide Overview Help. + + + (HelpBrowser openOn: CMakeVMMakerSqueakOverviewHelp) model + showTopicThat: [:topic | topic key = #namingConventions]. + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>specifyPlugins (in category 'pages') ----- + specifyPlugins + ^HelpTopic + title:'Specify Plugins' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + We can specify which plugins we want on our configuration by overriding our platform''s defaultExternalPlugins and defaultInternalPlugins methods. + + The default set can be further customized according to buildType if desired via the externalPlugins[BuildType] and internalPlugins[BuildType] redirect pattern + + We will cover only the internalPlugins scenario here. The methodology is exactly the same for externalPlugins. + + Let''s look first at the defaultInternalPlugins + + SystemNavigation browseAllImplementorsOf: #defaultInternalPlugins + + Looking at the Linux64x86w32BitConfigUsrLib we see that it just returns a default collection of class names. + + The defaultInternalPlugins message is typically sent from the internalPlugins[buildType] method. + + SystemNavigation browseAllImplementorsOf: #internalPlugins + + Here we see that CPlatformConfigForSqueak implements the message redirect pattern. + + SystemNavigation browseAllImplementorsOf: #internalPluginsBuild + + In CPlatformConfigForSqueak >> internalPluginsBuild forces subclasses to implement the method. + + Looking at + + SystemNavigation browseAllImplementorsOf: #internalPluginsBuildMultiThreadedDebug + we see the default is to return the default list provided in internalPluginsBuild. + + This enables configurations to customize their plugins with a good degree of granularity should we want to change the plugins we use based on buildType while keeping things simple in the default case. + + To summarize, a Configuration specifies what plugins it wants to build (either internal or external) by modifying or overriding the list of Plugin class names stored in defaultInternalPlugins or defaultExternalPlugins by overriding the internalPlugins[buildType] method or externalPlugins[buildType] method + + + + + + + + + + + + + + + + + + + + + + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>standardIncludes (in category 'pages') ----- + standardIncludes + ^HelpTopic + title:'standardIncludes' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + + As of CMakeVMMakerSqueak-tty.114 the method is a legacy method from the pharo CPlatformConfig. It is expect it (and this help page!!) will go away on a refactoring pass when the dependency on the pharo package is removed. + + + SystemNavigation browseAllImplementorsOf: #standardIncludes + + CPlatformConfig browseHierarchy + + In the CPlatformConfigForSqueak>>standardIncludes, we see the Method Redirect Pattern employed. Since this is for buildType #build, the method will re-route to self standardIncludesBuild. + + SystemNavigation browseAllImplementorsOf: #standardIncludesBuild + + The SqueakUnixConfig just writes some debug messages. + + There is nothing for us to do here.'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>tackingStockOne (in category 'pages') ----- + tackingStockOne + ^HelpTopic + title:'Taking Stock' + contents: + 'Let''s take stock of where we are. + + At this point, we have + 1. Created a Configuration for a specific platform, language, VM and memory model . + 2. Invoked the appropriate Builder for that Configuration asking it to ... + 2.a configure itself for a specific BuildType and + 2.b asked it to ouput its content to a specific directory. + 3. Confirmed that the Configuration outputs its data. + + Within the broad outline of this tutorial, you have covered the following + 1. Tests + 2. Where to place your new Configuration + 3. What Builder to use + 4. Create your Configuration + 5. Interaction of the Builder and your Configuration + 6. Generating a proof-of-concept CMake build tree. + + + The remainder of our task is customizing our Configuration so that the generated data correctly builds as the intention revealing name of the Configuration implies. I.e. we expect a Linux64x86w32BitSqueakCogSpurConfig, when configured for the buildType #build to generate CMake (and other) files that in fact, creates a release version of a squeak.cog.spur vm that runs on Linux64 with 32 bit compat libs stored in /usr/lib. + + Before we dive into customizing our new Configuration, we step back to gain some perspective so that if there are problems, you know where to look. + + We will start by a quick summary of.. + + 1. The root Configuration class CPlatformConfigForSqueak + 2. The ''method redirect'' design pattern. + 3. The CMakeVMGeneratorForSqueak class + + + After that, we will take stock again and proceed with the customization of our example Linux64x86w32BitSqueakCogSpurConfig + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>tackingStockTwo (in category 'pages') ----- + tackingStockTwo + ^HelpTopic + title:'Taking Stock II' + contents: + 'Within the broad outline of this tutorial, you have covered the following: + 1. Tests + 2. Where to place your new Configuration + 3. What Builder to use + 4. Create your Configuration + 5. Interaction of the Builder and your Configuration + 6. Generating a proof-of-concept CMake build tree. + 7. Some high level classes and concepts + 7.a CPlatformConfigForSqueak + 7b. The Method Redirect Pattern (a broadly used design pattern in the system) + 7c. The CMakeVMGeneratorForSqueak + + + The remainder of this Example Workflow will be the customization of the Linux64x86w32BitSqueakCogSpurConfig and generating a working build. + + To do this by + + Examining the CPlatformConfigForSqueak>>initialize process + Working through each statement in the CMakeVMGeneratorForSqueak>>generateByTemplate cascade in turn. + '! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>tests (in category 'pages') ----- + tests + "This method was automatically generated. Edit it using:" + "a HelpBrowser edit: #tests" + ^HelpTopic + title: 'Tests' + contents: + 'Within the broad outline of this tutorial, you are here: + 1. Tests. + + The Tests are in class category CMakeVMMakerSqueak-Tests. + + They are: + + CMakeVMMakerSqueakBuildersTest + CMakeVMMakerSqueakCommonConfigTest + CMakeVMMakerSqueakMacintoshConfigTest + CMakeVMMakerSqueakRedirectMethodsTest + CMakeVMMakerSqueakRedirectMethodsWithArgTest + CMakeVMMakerSqueakUnixConfigTest + CMakeVMMakerSqueakWindowsConfigTest + + As of 2014.12.09 all tests pass. + + As we create the Configuration these tests will be an important check on our work and we will return to them often.!!' readStream nextChunkText! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>theVMGenerator (in category 'pages') ----- + theVMGenerator + ^HelpTopic + title:'The CMakeVMGeneratorForSqueak class' + contents: + 'Within the broad outline of this tutorial, you are here: + 7. Some high level classes and concepts + 7c. The CMakeVMGeneratorForSqueak + + Before we move onto setting the most common directives and flags in the Concrete Configuration, lets take a quick look at the class and method that actually generates the CMake files for us. + + CMakeVMGeneratorForSqueak browseHierarchy + + CMakeVMGeneratorForSqueak implements the Visitor Design pattern. It takes as input a Configuration and it operates on that Configuration in a methodical manner. + + The CMakeVMGeneratorForSqueak has in instance variable named ''config''. This variable is our Configuration. + + The methodical operation and generation of CMake output occurs in two places. + + 1. In the Configuration>>initialize method + ToolSet browse: CPlatformConfigForSqueak selector: #initialize + 2. In the CMakeVMGeneratorForSqueak>>generateByTemplate method. + ToolSet browse: CMakeVMGeneratorForSqueak selector: #generateByTemplate + + The long cascade that starts with : + + config + setGlobalOptions: self; + cmakePrefixPath; + cmakeIncludePath;..... + + is the bulk of the CMake generation. + + Here you see the CMakeVMGeneratorForSqueak iterating over the CPlatformConfigForSqueak Method Redirect methods. + + Taking the ''cmakeIncludePath'' method for example... + SystemNavigation new browseAllImplementorsOf: #cmakeIncludePath localTo: CPlatformConfigForSqueak. + + you see that based on the Configurations buildType, the appropriate Redirect Method out of : + + cmakeIncludePathBuild + cmakeIncludePathBuildAssert + cmakeIncludePathBuildAssertITimerHeartbeat + cmakeIncludePathBuildDebug + cmakeIncludePathBuildDebugITimerHeartbeat + cmakeIncludePathBuildITimerHeartbeat + cmakeIncludePathBuildMultiThreaded + cmakeIncludePathBuildMultiThreadedAssert + cmakeIncludePathBuildMultiThreadedDebug + cmakeIncludePathNoBuildType + + will be executed based on the Configurations buildType (which you set with your Builder earlier) + + + For debugging and troubleshooting you new Configuration, CMakeVMGeneratorForSqueak>>generateByTemplate enables you to step through CMake generation in an entirely predictable way. + + Let''s recap next. + ' + + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialNewConfigurationHelp class>>vmsrc (in category 'pages') ----- + vmsrc + ^HelpTopic + title:'vmsrc' + contents: + 'Within the broad outline of this tutorial, you are here: + 8. Customizing your Configuration. + + + write me. + '! Item was added: + CMakeVMMakerSqueakHelp subclass: #CMakeVMMakerSqueakTutorialsHelp + instanceVariableNames: '' + classVariableNames: '' + poolDictionaries: '' + category: 'CMakeVMMakerSqueak-Help'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialsHelp class>>bookName (in category 'accessing') ----- + bookName + ^'Tutorials'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialsHelp class>>key (in category 'accessing') ----- + key + ^'CMakeVMMakerSqueakTutorialsHelp'! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialsHelp class>>pages (in category 'pages') ----- + pages + ^#( CMakeVMMakerSqueakTutorialEndUserHelp CMakeVMMakerSqueakTutorialNewConfigurationHelp CMakeVMMakerSqueakTutorialNewBuilderHelp) + + ! Item was added: + ----- Method: CMakeVMMakerSqueakTutorialsHelp class>>priority (in category 'accessing') ----- + priority + + ^ 2! Item was removed: - ----- Method: CMakeVMMakerSqueakUnixConfigTest>>testAddVMDrivers (in category 'as yet unclassified') ----- - testAddVMDrivers - self flag:'tty'. "Is the self shouldnt sufficient?" - #( #SqueakUnixConfig ) - do:[:each | - (Smalltalk at:each) - allSubclassesDo:[:configuration | | o buildTypes vmGenerator| - o:= configuration basicNew. - o enabledebugmessages:true. - o templates: OrderedCollection new. - (o excludeFromBuild not) & (configuration isAbstractBaseClass not) - ifTrue:[ - buildTypes:=o availableBuildTypes copyWithoutAll:#(#buildNone). - buildTypes do:[:buildType | - o configureForBuildType: buildType. - o initialize. - vmGenerator:=CMakeVMGeneratorForSqueak new. - vmGenerator config: o. - vmGenerator output:(String new writeStream). - self shouldnt: [o addVMPlugins: vmGenerator] raise: Error]]]]. - ! Item was added: + CMakeVMPlugin subclass: #CMakeVMSoundPulse + instanceVariableNames: '' + classVariableNames: '' + poolDictionaries: '' + category: 'CMakeVMMakerSqueak-VMPlugins'! + + !CMakeVMSoundPulse commentStamp: 'tty 5/30/2016 11:56' prior: 0! + A CMakeVMSoundPulse is a data-bucket that holds configration information! Item was added: + ----- Method: CMakeVMSoundPulse>>initialize (in category 'initialize-release') ----- + initialize + super initialize. + module :='vm-sound-pulse'! Item was removed: - ----- Method: CPlatformConfigForSqueak>>addVMDrivers: (in category 'cmake buildType redirects') ----- - addVMDrivers: aMaker - "CMakeVMMaker compat" - self deprecated:'CMakeVMMaker holdover from pharo. use addVMPlugins: aMaker'. - ^self addVMPlugins: aMaker - ! Item was changed: ----- Method: CPlatformConfigForSqueak>>addVMPlugins: (in category 'cmake buildType redirects') ----- addVMPlugins: aMaker "Route this message send to the message appropriate for my buildType " |d | d:= SqueakCMakeVMMakerAbstractBuilder default buildTypeAndDirectoryInfo copy. d at: #build put: [self addVMPluginsBuild: aMaker]; at: #buildAssert put: [self addVMPluginsBuildAssert: aMaker]; at: #buildAssertITimerHeartbeat put: [self addVMPluginsBuildAssertITimerHeartbeat: aMaker]; at:#buildDebug put: [self addVMPluginsBuildDebug: aMaker]; at: #buildDebugITimerHeartbeat put: [self addVMPluginsBuildDebugITimerHeartbeat: aMaker ]; at: #buildITimerHeartbeat put: [self addVMPluginsBuildITimerHeartbeat: aMaker]; at: #buildMultiThreaded put: [self addVMPluginsBuildMultiThreaded: aMaker ]; at: #buildMultiThreadedAssert put: [self addVMPluginsBuildMultiThreadedAssert: aMaker]; at: #buildMultiThreadedDebug put: [self addVMPluginsBuildMultiThreadedDebug: aMaker ]; at: #buildNone put:[self addVMPluginsNoBuildType: aMaker]. ^(d at: buildType) value ! Item was changed: ----- Method: CPlatformConfigForSqueak>>customizeVMPlugins (in category 'initialize-release') ----- customizeVMPlugins + "This customization happens on CPlatformForSqueak>>initialization BEFORE the buildType has been set. + + The initial customization will probably be the general case. + + HOWEVER, should a subclass of me want further granularity of included vm plugins based on buildType. + + simply override the + + SqueakUnixConfig>>addVMPlugins[BuildType]: aMaker method + + and modify/limit the vmplugins variable there before the CMake configuration is written out. + + " - self flag:'tty'. "is this needed on all platforms? consider moving down" self subclassResponsibility! Item was changed: ----- Method: CPlatformConfigForSqueak>>initialize (in category 'initialize-release') ----- initialize enabledebugmessages := false. + buildType:=cogDir:=templates:=platformSources:=vmplugins:=nil. self initializePlatformSources; + initializeVMPlugins; - initializeVMDrivers; customizeVMPlugins. ! Item was removed: - ----- Method: CPlatformConfigForSqueak>>initializeVMDrivers (in category 'initialize-release') ----- - initializeVMDrivers - vmplugins := OrderedCollection new. - vmplugins - addLast:(CMakeVMDisplayCustom new); - addLast:(CMakeVMDisplayFbdev new); - addLast:(CMakeVMDisplayNull new); - addLast:(CMakeVMDisplayQuartz new); - addLast:(CMakeVMDisplayX11 new); - addLast:(CMakeVMSoundALSA new); - addLast:(CMakeVMSoundCustom new); - addLast:(CMakeVMSoundMacOSX new); - addLast:(CMakeVMSoundNAS new); - addLast:(CMakeVMSoundNull new); - addLast:(CMakeVMSoundOSS new); - addLast:(CMakeVMSoundSun new). - ! Item was added: + ----- Method: CPlatformConfigForSqueak>>initializeVMPlugins (in category 'initialize-release') ----- + initializeVMPlugins + vmplugins := OrderedCollection new. + vmplugins + addLast:(CMakeVMDisplayCustom new); + addLast:(CMakeVMDisplayFbdev new); + addLast:(CMakeVMDisplayNull new); + addLast:(CMakeVMDisplayQuartz new); + addLast:(CMakeVMDisplayX11 new); + addLast:(CMakeVMSoundALSA new); + addLast:(CMakeVMSoundCustom new); + addLast:(CMakeVMSoundMacOSX new); + addLast:(CMakeVMSoundNAS new); + addLast:(CMakeVMSoundNull new); + addLast:(CMakeVMSoundOSS new); + addLast:(CMakeVMSoundPulse new); + addLast:(CMakeVMSoundSun new). + ! Item was removed: - ----- Method: CPlatformConfigForSqueak>>platformSources (in category 'source files') ----- - platformSources - - " - SystemNavigation default browseMethodsWhoseNamesContain: 'platformSources' - - ^#( platform specific array) - " - - self subclassResponsibility! Item was removed: - ----- Method: CPlatformConfigForSqueak>>vmDrivers (in category 'plugins') ----- - vmDrivers - "SystemNavigation default browseMethodsWhoseNamesContain: 'vmDrivers' - " - self subclassResponsibility! Item was removed: - ----- Method: Linux32ARMv6Config>>addVMPluginsBuild: (in category 'cmake buildType redirects') ----- - addVMPluginsBuild: aMaker - |temp o| - self flag:'tty'. "I am writing sub-directory CMakeLists.txt here. Should I also write the config.cmake files?" - enabledebugmessages - ifTrue: [templates "this message will go to the top level CMakeLists.txt file" - addLast: (CMakeMessage new message: self class name , 'addVMPluginsBuild: aMaker')]. - vmplugins do:[ :vmp | - o := String new writeStream. "each VMPlugin gets its own CMakeLists.txt file in its own directory" - temp := OrderedCollection new. - temp - addAllLast:((CMakePluginVm new) "this is the CMakeCompositTemplate" - config: self - definitions: (vmp compilerdefinitions) - module: (vmp module) - sources: (vmp sources) - includedirectories: (vmp includedirectories)). - temp do: [:each | o nextPutAll: (each content); cr]. - ((self buildDir) directoryExists: (vmp module)) - ifFalse:[ (self buildDir) createDirectory: (vmp module)]. - self write: (o contents) toFile: vmp module , FileDirectory slash , aMaker outputFileName. - templates "this will go to the top level CMakeLists.txt file" - addLast: ((CMakeAddSubDirectory new) sourcedir: (vmp module)) - ]. - - - - - - - - - - ! Item was removed: - ----- Method: Linux32ARMv6Config>>customizeCMakeVMDisplayNull (in category 'plugins') ----- - customizeCMakeVMDisplayNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #('${targetPlatform}/vm-display-null/sqUnixDisplayNull') ; - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: #(); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - self flag:'tty'. "I don't think includedirectories is correct. revisit" - - - - - - - ! Item was removed: - ----- Method: Linux32ARMv6Config>>customizeCMakeVMDisplayX11 (in category 'plugins') ----- - customizeCMakeVMDisplayX11 - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayX11 = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-display-X11/sqUnixX11' '${targetPlatform}/vm-display-X11/sqUnixMozilla' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - ! Item was removed: - ----- Method: Linux32ARMv6Config>>customizeCMakeVMSoundALSA (in category 'plugins') ----- - customizeCMakeVMSoundALSA - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundALSA = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-ALSA/sqUnixSoundALSA' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories: #(). - ! Item was removed: - ----- Method: Linux32ARMv6Config>>customizeCMakeVMSoundNull (in category 'plugins') ----- - customizeCMakeVMSoundNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-null/sqUnixSoundNull' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:#() - - ! Item was removed: - ----- Method: Linux32ARMv6Config>>customizeVMPlugins (in category 'plugins') ----- - customizeVMPlugins - |mysubset iwantonly| - "trim the vmdrivers ordered collection of CMakeVMDriver subclasses to only those I want. then customize them for use on this OS/platform" - " iwantonly := #(#CMakeVMDisplayNull #CMakeVMDisplayX11 #CMakeVMSoundALSA #CMakeVMSoundNull ). - mysubset := vmplugins select: [:vmd | 0 < (iwantonly occurrencesOf: (vmd class name) asSymbol)]. - vmplugins := mysubset. - self - customizeCMakeVMDisplayNull; - customizeCMakeVMDisplayX11; - customizeCMakeVMSoundALSA; - customizeCMakeVMSoundNull."! Item was removed: - ----- Method: Linux32x86Config>>addVMPluginsBuild: (in category 'cmake buildType redirects') ----- - addVMPluginsBuild: aMaker - |temp o| - self flag:'tty'. "I am writing sub-directory CMakeLists.txt here. Should I also write the config.cmake files?" - enabledebugmessages - ifTrue: [templates "this message will go to the top level CMakeLists.txt file" - addLast: (CMakeMessage new message: self class name , 'addVMPluginsBuild: aMaker')]. - vmplugins do:[ :vmp | - o := String new writeStream. "each VMPlugin gets its own CMakeLists.txt file in its own directory" - temp := OrderedCollection new. - temp - addAllLast:((CMakePluginVm new) "this is the CMakeCompositTemplate" - config: self - definitions: (vmp compilerdefinitions) - module: (vmp module) - sources: (vmp sources) - includedirectories: (vmp includedirectories)). - temp do: [:each | o nextPutAll: (each content); cr]. - ((self buildDir) directoryExists: (vmp module)) - ifFalse:[ (self buildDir) createDirectory: (vmp module)]. - self write: (o contents) toFile: vmp module , FileDirectory slash , aMaker outputFileName. - templates "this will go to the top level CMakeLists.txt file" - addLast: ((CMakeAddSubDirectory new) sourcedir: (vmp module)) - ]. - - - - - - - - - - ! Item was removed: - ----- Method: Linux32x86Config>>customizeCMakeVMDisplayNull (in category 'plugins') ----- - customizeCMakeVMDisplayNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #('${targetPlatform}/vm-display-null/sqUnixDisplayNull') ; - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: #(); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - self flag:'tty'. "I don't think includedirectories is correct. revisit" - - - - - - - ! Item was removed: - ----- Method: Linux32x86Config>>customizeCMakeVMDisplayX11 (in category 'plugins') ----- - customizeCMakeVMDisplayX11 - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayX11 = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-display-X11/sqUnixX11' '${targetPlatform}/vm-display-X11/sqUnixMozilla' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - ! Item was removed: - ----- Method: Linux32x86Config>>customizeCMakeVMSoundALSA (in category 'plugins') ----- - customizeCMakeVMSoundALSA - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundALSA = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-ALSA/sqUnixSoundALSA' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories: #(). - ! Item was removed: - ----- Method: Linux32x86Config>>customizeCMakeVMSoundNull (in category 'plugins') ----- - customizeCMakeVMSoundNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-null/sqUnixSoundNull' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:#() - - ! Item was removed: - ----- Method: Linux32x86Config>>customizeVMPlugins (in category 'plugins') ----- - customizeVMPlugins - |mysubset iwantonly| - "trim the vmdrivers ordered collection of CMakeVMDriver subclasses to only those I want. then customize them for use on this OS/platform" - iwantonly := #(#CMakeVMDisplayNull #CMakeVMDisplayX11 #CMakeVMSoundALSA #CMakeVMSoundNull ). - mysubset := vmplugins select: [:vmd | 0 < (iwantonly occurrencesOf: (vmd class name) asSymbol)]. - vmplugins := mysubset. - self - customizeCMakeVMDisplayNull; - customizeCMakeVMDisplayX11; - customizeCMakeVMSoundALSA; - customizeCMakeVMSoundNull. - - - - ! Item was removed: - ----- Method: Linux64x64Config>>addVMPluginsBuild: (in category 'cmake buildType redirects') ----- - addVMPluginsBuild: aMaker - |temp o| - self flag:'tty'. "I am writing sub-directory CMakeLists.txt here. Should I also write the config.cmake files?" - enabledebugmessages - ifTrue: [templates "this message will go to the top level CMakeLists.txt file" - addLast: (CMakeMessage new message: self class name , 'addVMPluginsBuild: aMaker')]. - vmplugins do:[ :vmp | - o := String new writeStream. "each VMPlugin gets its own CMakeLists.txt file in its own directory" - temp := OrderedCollection new. - temp - addAllLast:((CMakePluginVm new) "this is the CMakeCompositTemplate" - config: self - definitions: (vmp compilerdefinitions) - module: (vmp module) - sources: (vmp sources) - includedirectories: (vmp includedirectories)). - temp do: [:each | o nextPutAll: (each content); cr]. - ((self buildDir) directoryExists: (vmp module)) - ifFalse:[ (self buildDir) createDirectory: (vmp module)]. - self write: (o contents) toFile: vmp module , FileDirectory slash , aMaker outputFileName. - templates "this will go to the top level CMakeLists.txt file" - addLast: ((CMakeAddSubDirectory new) sourcedir: (vmp module)) - ]. - - - - - - - - - - ! Item was removed: - ----- Method: Linux64x64Config>>customizeCMakeVMDisplayNull (in category 'plugins') ----- - customizeCMakeVMDisplayNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #('${targetPlatform}/vm-display-null/sqUnixDisplayNull') ; - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: #(); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - self flag:'tty'. "I don't think includedirectories is correct. revisit" - - - - - - - ! Item was removed: - ----- Method: Linux64x64Config>>customizeCMakeVMDisplayX11 (in category 'plugins') ----- - customizeCMakeVMDisplayX11 - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayX11 = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-display-X11/sqUnixX11' '${targetPlatform}/vm-display-X11/sqUnixMozilla' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - ! Item was removed: - ----- Method: Linux64x64Config>>customizeCMakeVMSoundALSA (in category 'plugins') ----- - customizeCMakeVMSoundALSA - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundALSA = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-ALSA/sqUnixSoundALSA' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories: #(). - ! Item was removed: - ----- Method: Linux64x64Config>>customizeCMakeVMSoundNull (in category 'plugins') ----- - customizeCMakeVMSoundNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-null/sqUnixSoundNull' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:#() - - ! Item was removed: - ----- Method: Linux64x64Config>>customizeVMPlugins (in category 'plugins') ----- - customizeVMPlugins - |mysubset iwantonly| - "trim the vmdrivers ordered collection of CMakeVMDriver subclasses to only those I want. then customize them for use on this OS/platform" - iwantonly := #(#CMakeVMDisplayNull #CMakeVMDisplayX11 #CMakeVMSoundALSA #CMakeVMSoundNull ). - mysubset := vmplugins select: [:vmd | 0 < (iwantonly occurrencesOf: (vmd class name) asSymbol)]. - vmplugins := mysubset. - self - customizeCMakeVMDisplayNull; - customizeCMakeVMDisplayX11; - customizeCMakeVMSoundALSA; - customizeCMakeVMSoundNull. - - - - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib>>addVMPluginsBuild: (in category 'cmake buildType redirects') ----- - addVMPluginsBuild: aMaker - |temp o| - self flag:'tty'. "I am writing sub-directory CMakeLists.txt here. Should I also write the config.cmake files?" - enabledebugmessages - ifTrue: [templates "this message will go to the top level CMakeLists.txt file" - addLast: (CMakeMessage new message: self class name , 'addVMPluginsBuild: aMaker')]. - vmplugins do:[ :vmp | - o := String new writeStream. "each VMPlugin gets its own CMakeLists.txt file in its own directory" - temp := OrderedCollection new. - temp - addAllLast:((CMakePluginVm new) "this is the CMakeCompositTemplate" - config: self - definitions: (vmp compilerdefinitions) - module: (vmp module) - sources: (vmp sources) - includedirectories: (vmp includedirectories)). - temp do: [:each | o nextPutAll: (each content); cr]. - ((self buildDir) directoryExists: (vmp module)) - ifFalse:[ (self buildDir) createDirectory: (vmp module)]. - self write: (o contents) toFile: vmp module , FileDirectory slash , aMaker outputFileName. - templates "this will go to the top level CMakeLists.txt file" - addLast: ((CMakeAddSubDirectory new) sourcedir: (vmp module)) - ]. - - - - - - - - - - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib>>customizeCMakeVMDisplayNull (in category 'plugins') ----- - customizeCMakeVMDisplayNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #('${targetPlatform}/vm-display-null/sqUnixDisplayNull') ; - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: #(); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - self flag:'tty'. "I don't think includedirectories is correct. revisit" - - - - - - - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib>>customizeCMakeVMDisplayX11 (in category 'plugins') ----- - customizeCMakeVMDisplayX11 - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayX11 = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-display-X11/sqUnixX11' '${targetPlatform}/vm-display-X11/sqUnixMozilla' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib>>customizeCMakeVMSoundALSA (in category 'plugins') ----- - customizeCMakeVMSoundALSA - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundALSA = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-ALSA/sqUnixSoundALSA' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories: #(). - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib>>customizeCMakeVMSoundNull (in category 'plugins') ----- - customizeCMakeVMSoundNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-null/sqUnixSoundNull' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:#() - - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib>>customizeVMPlugins (in category 'plugins') ----- - customizeVMPlugins - |mysubset iwantonly| - self flag: 'tty: consider pushing up to platform level on refactor'. - "trim the vmdrivers ordered collection of CMakeVMDriver subclasses to only those I want. then customize them for use on this OS/platform" - iwantonly := #(#CMakeVMDisplayNull #CMakeVMDisplayX11 #CMakeVMSoundALSA #CMakeVMSoundNull ). - mysubset := vmplugins select: [:vmd | 0 < (iwantonly occurrencesOf: (vmd class name) asSymbol)]. - vmplugins := mysubset. - self - customizeCMakeVMDisplayNull; - customizeCMakeVMDisplayX11; - customizeCMakeVMSoundALSA; - customizeCMakeVMSoundNull. - - - - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib32>>addVMPluginsBuild: (in category 'cmake buildType redirects') ----- - addVMPluginsBuild: aMaker - |temp o| - self flag:'tty'. "I am writing sub-directory CMakeLists.txt here. Should I also write the config.cmake files?" - enabledebugmessages - ifTrue: [templates "this message will go to the top level CMakeLists.txt file" - addLast: (CMakeMessage new message: self class name , 'addVMPluginsBuild: aMaker')]. - vmplugins do:[ :vmp | - o := String new writeStream. "each VMPlugin gets its own CMakeLists.txt file in its own directory" - temp := OrderedCollection new. - temp - addAllLast:((CMakePluginVm new) "this is the CMakeCompositTemplate" - config: self - definitions: (vmp compilerdefinitions) - module: (vmp module) - sources: (vmp sources) - includedirectories: (vmp includedirectories)). - temp do: [:each | o nextPutAll: (each content); cr]. - ((self buildDir) directoryExists: (vmp module)) - ifFalse:[ (self buildDir) createDirectory: (vmp module)]. - self write: (o contents) toFile: vmp module , FileDirectory slash , aMaker outputFileName. - templates "this will go to the top level CMakeLists.txt file" - addLast: ((CMakeAddSubDirectory new) sourcedir: (vmp module)) - ]. - - - - - - - - - - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib32>>customizeCMakeVMDisplayNull (in category 'plugins') ----- - customizeCMakeVMDisplayNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #('${targetPlatform}/vm-display-null/sqUnixDisplayNull') ; - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: #(); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - self flag:'tty'. "I don't think includedirectories is correct. revisit" - - - - - - - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib32>>customizeCMakeVMDisplayX11 (in category 'plugins') ----- - customizeCMakeVMDisplayX11 - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayX11 = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-display-X11/sqUnixX11' '${targetPlatform}/vm-display-X11/sqUnixMozilla' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib32>>customizeCMakeVMSoundALSA (in category 'plugins') ----- - customizeCMakeVMSoundALSA - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundALSA = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-ALSA/sqUnixSoundALSA' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories: #(). - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib32>>customizeCMakeVMSoundNull (in category 'plugins') ----- - customizeCMakeVMSoundNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-null/sqUnixSoundNull' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:#() - - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib32>>customizeVMPlugins (in category 'plugins') ----- - customizeVMPlugins - |mysubset iwantonly| - "trim the vmdrivers ordered collection of CMakeVMDriver subclasses to only those I want. then customize them for use on this OS/platform" - iwantonly := #(#CMakeVMDisplayNull #CMakeVMDisplayX11 #CMakeVMSoundALSA #CMakeVMSoundNull ). - mysubset := vmplugins select: [:vmd | 0 < (iwantonly occurrencesOf: (vmd class name) asSymbol)]. - vmplugins := mysubset. - self - customizeCMakeVMDisplayNull; - customizeCMakeVMDisplayX11; - customizeCMakeVMSoundALSA; - customizeCMakeVMSoundNull. - - - - ! Item was removed: - ----- Method: SqueakBSD32x86Config>>addVMPluginsBuild: (in category 'cmake buildType redirects') ----- - addVMPluginsBuild: aMaker - |temp o| - self flag:'tty'. "I am writing sub-directory CMakeLists.txt here. Should I also write the config.cmake files?" - enabledebugmessages - ifTrue: [templates "this message will go to the top level CMakeLists.txt file" - addLast: (CMakeMessage new message: self class name , 'addVMPluginsBuild: aMaker')]. - vmplugins do:[ :vmp | - o := String new writeStream. "each VMPlugin gets its own CMakeLists.txt file in its own directory" - temp := OrderedCollection new. - temp - addAllLast:((CMakePluginVm new) "this is the CMakeCompositTemplate" - config: self - definitions: (vmp compilerdefinitions) - module: (vmp module) - sources: (vmp sources) - includedirectories: (vmp includedirectories)). - temp do: [:each | o nextPutAll: (each content); cr]. - ((self buildDir) directoryExists: (vmp module)) - ifFalse:[ (self buildDir) createDirectory: (vmp module)]. - self write: (o contents) toFile: vmp module , FileDirectory slash , aMaker outputFileName. - templates "this will go to the top level CMakeLists.txt file" - addLast: ((CMakeAddSubDirectory new) sourcedir: (vmp module)) - ]. - - - - - - - - - - ! Item was removed: - ----- Method: SqueakBSD32x86Config>>customizeCMakeVMDisplayNull (in category 'plugins') ----- - customizeCMakeVMDisplayNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #('${targetPlatform}/vm-display-null/sqUnixDisplayNull') ; - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: #(); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - self flag:'tty'. "I don't think includedirectories is correct. revisit" - - - - - - - ! Item was removed: - ----- Method: SqueakBSD32x86Config>>customizeCMakeVMDisplayX11 (in category 'plugins') ----- - customizeCMakeVMDisplayX11 - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayX11 = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-display-X11/sqUnixX11' '${targetPlatform}/vm-display-X11/sqUnixMozilla' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - ! Item was removed: - ----- Method: SqueakBSD32x86Config>>customizeCMakeVMSoundALSA (in category 'plugins') ----- - customizeCMakeVMSoundALSA - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundALSA = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-ALSA/sqUnixSoundALSA' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories: #(). - ! Item was removed: - ----- Method: SqueakBSD32x86Config>>customizeCMakeVMSoundNull (in category 'plugins') ----- - customizeCMakeVMSoundNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-null/sqUnixSoundNull' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:#() - - ! Item was removed: - ----- Method: SqueakBSD32x86Config>>customizeVMPlugins (in category 'plugins') ----- - customizeVMPlugins - |mysubset iwantonly| - "trim the vmdrivers ordered collection of CMakeVMDriver subclasses to only those I want. then customize them for use on this OS/platform" - iwantonly := #(#CMakeVMDisplayNull #CMakeVMDisplayX11 #CMakeVMSoundALSA #CMakeVMSoundNull ). - mysubset := vmplugins select: [:vmd | 0 < (iwantonly occurrencesOf: (vmd class name) asSymbol)]. - vmplugins := mysubset. - self - customizeCMakeVMDisplayNull; - customizeCMakeVMDisplayX11; - customizeCMakeVMSoundALSA; - customizeCMakeVMSoundNull. - - - - ! Item was changed: ----- Method: SqueakCMakeVMMakerAbstractBuilder>>generateByTemplate (in category 'building') ----- generateByTemplate self flag:'tty'. "If we ever script builds, this inform must by bypassed" + (config isKindOf: CPlatformConfigForSqueak) - (config isKindOf: CPlatformConfig) ifTrue:[ (config excludeFromBuild) ifTrue:[self inform: '', config class, ' >>"excludeFromBuild" answers #true. Most likely because it is under development'] ifFalse: [config generateByTemplate]] ! Item was changed: ----- Method: SqueakIA32BochsConfig>>customizeVMPlugins (in category 'plugins') ----- customizeVMPlugins "do nothing,. only used on linux?"! Item was removed: - ----- Method: SqueakIOSConfig>>addVMPluginsBuild: (in category 'cmake buildType redirects') ----- - addVMPluginsBuild: aMaker - |temp o| - self flag:'tty'. "I am writing sub-directory CMakeLists.txt here. Should I also write the config.cmake files?" - enabledebugmessages - ifTrue: [templates "this message will go to the top level CMakeLists.txt file" - addLast: (CMakeMessage new message: self class name , 'addVMPluginsBuild: aMaker')]. - vmplugins do:[ :vmp | - o := String new writeStream. "each VMPlugin gets its own CMakeLists.txt file in its own directory" - temp := OrderedCollection new. - temp - addAllLast:((CMakePluginVm new) "this is the CMakeCompositTemplate" - config: self - definitions: (vmp compilerdefinitions) - module: (vmp module) - sources: (vmp sources) - includedirectories: (vmp includedirectories)). - temp do: [:each | o nextPutAll: (each content); cr]. - ((self buildDir) directoryExists: (vmp module)) - ifFalse:[ (self buildDir) createDirectory: (vmp module)]. - self write: (o contents) toFile: vmp module , FileDirectory slash , aMaker outputFileName. - templates "this will go to the top level CMakeLists.txt file" - addLast: ((CMakeAddSubDirectory new) sourcedir: (vmp module)) - ]. - - - - - - - - - - ! Item was removed: - ----- Method: SqueakIOSConfig>>customizeCMakeVMDisplayNull (in category 'plugins') ----- - customizeCMakeVMDisplayNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #('${targetPlatform}/vm-display-null/sqUnixDisplayNull') ; - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: #(); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - self flag:'tty'. "I don't think includedirectories is correct. revisit" - - - - - - - ! Item was removed: - ----- Method: SqueakIOSConfig>>customizeCMakeVMDisplayX11 (in category 'plugins') ----- - customizeCMakeVMDisplayX11 - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayX11 = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-display-X11/sqUnixX11' '${targetPlatform}/vm-display-X11/sqUnixMozilla' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - ! Item was removed: - ----- Method: SqueakIOSConfig>>customizeCMakeVMSoundALSA (in category 'plugins') ----- - customizeCMakeVMSoundALSA - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundALSA = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-ALSA/sqUnixSoundALSA' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories: #(). - ! Item was removed: - ----- Method: SqueakIOSConfig>>customizeCMakeVMSoundNull (in category 'plugins') ----- - customizeCMakeVMSoundNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-null/sqUnixSoundNull' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:#() - - ! Item was removed: - ----- Method: SqueakIOSConfig>>customizeVMPlugins (in category 'plugins') ----- - customizeVMPlugins - |mysubset iwantonly| - "trim the vmdrivers ordered collection of CMakeVMDriver subclasses to only those I want. then customize them for use on this OS/platform" - iwantonly := #(#CMakeVMDisplayNull #CMakeVMDisplayX11 #CMakeVMSoundALSA #CMakeVMSoundNull ). - mysubset := vmplugins select: [:vmd | 0 < (iwantonly occurrencesOf: (vmd class name) asSymbol)]. - vmplugins := mysubset. - self - customizeCMakeVMDisplayNull; - customizeCMakeVMDisplayX11; - customizeCMakeVMSoundALSA; - customizeCMakeVMSoundNull. - - - - ! Item was changed: ----- Method: SqueakMacintoshConfig>>addVMPluginsBuild: (in category 'cmake buildType redirects') ----- addVMPluginsBuild: aMaker + "do nothing. "! - "do nothing. Unless Mac uses this, then push me down"! Item was removed: - ----- Method: SqueakMacintoshConfig>>customizeVMDrivers (in category 'initialize-release') ----- - customizeVMDrivers - " - SystemNavigation default browseMethodsWhoseNamesContain:'customizeVMDrivers' - - force platform level or lower customization of vm-display-X11 vm-sound-ALSA, etc. - The configurations can select what subset they want using something like this. - - |subset iwantonly| - iwantonly := #(#CMakeVMDisplayNull #CMakeVMDisplayX11 #CMakeVMSoundALSA #CMakeVMSoundNull ). - subset := vmdrivers select: [:vmd | 0 < (iwantonly occurrencesOf: (vmd class name) asSymbol)]. - vmdrivers := subset. - - self - customizeCMakeVMDisplayNull; - customizeCMakeVMDisplayX11; - customizeCMakeVMSoundALSA; - customizeCMakeVMSoundNull - - - " - self flag:'tty'. "revisit this design strategy" - self subclassResponsibility! Item was changed: ----- Method: SqueakMacintoshConfig>>customizeVMPlugins (in category 'plugins') ----- customizeVMPlugins "do nothing,. only used on linux?"! Item was added: + ----- Method: SqueakMacintoshConfig>>generateByTemplate (in category 'source generation') ----- + generateByTemplate + "You can write out supporting CMake output here. See this method in SqueakUnixConfig for example" + ^ CMakeVMGeneratorForSqueak generateByTemplate: self ! Item was removed: - ----- Method: SqueakSunOS32x86Config>>addVMPluginsBuild: (in category 'cmake buildType redirects') ----- - addVMPluginsBuild: aMaker - |temp o| - self flag:'tty'. "I am writing sub-directory CMakeLists.txt here. Should I also write the config.cmake files?" - enabledebugmessages - ifTrue: [templates "this message will go to the top level CMakeLists.txt file" - addLast: (CMakeMessage new message: self class name , 'addVMPluginsBuild: aMaker')]. - vmplugins do:[ :vmp | - o := String new writeStream. "each VMPlugin gets its own CMakeLists.txt file in its own directory" - temp := OrderedCollection new. - temp - addAllLast:((CMakePluginVm new) "this is the CMakeCompositTemplate" - config: self - definitions: (vmp compilerdefinitions) - module: (vmp module) - sources: (vmp sources) - includedirectories: (vmp includedirectories)). - temp do: [:each | o nextPutAll: (each content); cr]. - ((self buildDir) directoryExists: (vmp module)) - ifFalse:[ (self buildDir) createDirectory: (vmp module)]. - self write: (o contents) toFile: vmp module , FileDirectory slash , aMaker outputFileName. - templates "this will go to the top level CMakeLists.txt file" - addLast: ((CMakeAddSubDirectory new) sourcedir: (vmp module)) - ]. - - - - - - - - - - ! Item was removed: - ----- Method: SqueakSunOS32x86Config>>customizeCMakeVMDisplayNull (in category 'plugins') ----- - customizeCMakeVMDisplayNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #('${targetPlatform}/vm-display-null/sqUnixDisplayNull') ; - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: #(); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - self flag:'tty'. "I don't think includedirectories is correct. revisit" - - - - - - - ! Item was removed: - ----- Method: SqueakSunOS32x86Config>>customizeCMakeVMDisplayX11 (in category 'plugins') ----- - customizeCMakeVMDisplayX11 - |module| - module := vmplugins detect: [:vmd | #CMakeVMDisplayX11 = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-display-X11/sqUnixX11' '${targetPlatform}/vm-display-X11/sqUnixMozilla' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:(OrderedCollection - with:'${crossDir}/plugins/FilePlugin' - with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' - with: '${crossDir}/plugins/B3DAcceleratorPlugin'). - ! Item was removed: - ----- Method: SqueakSunOS32x86Config>>customizeCMakeVMSoundALSA (in category 'plugins') ----- - customizeCMakeVMSoundALSA - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundALSA = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-ALSA/sqUnixSoundALSA' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories: #(). - ! Item was removed: - ----- Method: SqueakSunOS32x86Config>>customizeCMakeVMSoundNull (in category 'plugins') ----- - customizeCMakeVMSoundNull - |module| - module := vmplugins detect: [:vmd | #CMakeVMSoundNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" - module - sources: #( '${targetPlatform}/vm-sound-null/sqUnixSoundNull' ); - compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); - compilerflags: (self compilerFlags); - externallibraries: (self externalLibraries); - linkerflags: (self linkerFlags); - includedirectories:#() - - ! Item was removed: - ----- Method: SqueakSunOS32x86Config>>customizeVMPlugins (in category 'plugins') ----- - customizeVMPlugins - |mysubset iwantonly| - "trim the vmdrivers ordered collection of CMakeVMDriver subclasses to only those I want. then customize them for use on this OS/platform" - iwantonly := #(#CMakeVMDisplayNull #CMakeVMDisplayX11 #CMakeVMSoundALSA #CMakeVMSoundNull ). - mysubset := vmplugins select: [:vmd | 0 < (iwantonly occurrencesOf: (vmd class name) asSymbol)]. - vmplugins := mysubset. - self - customizeCMakeVMDisplayNull; - customizeCMakeVMDisplayX11; - customizeCMakeVMSoundALSA; - customizeCMakeVMSoundNull. - - - - ! Item was added: + ----- Method: SqueakUnixConfig>>addVMPluginsBuild: (in category 'cmake buildType redirects') ----- + addVMPluginsBuild: aMaker + "instance variable vmplugins was populated in CPlatformConfigForSqueak>>initialize then customized by >>customizeVMPlugins + That initial customization will probably be the general case. + + However, a subclass of me, may want further granularity on included vm plugins based on buildType. + Simply override me (or my addVMPlugins[buildType] cousins) and extract the subset of vmplugins you want to generate. + + see the ''hack'' section below. + " + + |temp o| + self flag:'tty'. "I am writing sub-directory CMakeLists.txt here. Should I also write the config.cmake files?" + enabledebugmessages + ifTrue: [templates "this message will go to the top level CMakeLists.txt file" + addLast: (CMakeMessage new message: self class name , 'addVMPluginsBuild: aMaker')]. + + " + hack := the subset of vmplugins that I want for this particular buildType. + hack do:[:vmp| ..... + " + vmplugins do:[ :vmp | + o := String new writeStream. "each VMPlugin gets its own CMakeLists.txt file in its own directory" + temp := OrderedCollection new. + temp + addAllLast:((CMakePluginVm new) "this is the CMakeCompositTemplate" + config: self + definitions: (vmp compilerdefinitions) + module: (vmp module) + sources: (vmp sources) + includedirectories: (vmp includedirectories)). + temp do: [:each | o nextPutAll: (each content); cr]. + ((self buildDir) directoryExists: (vmp module)) + ifFalse:[ (self buildDir) createDirectory: (vmp module)]. + self write: (o contents) toFile: vmp module , FileDirectory slash , aMaker outputFileName. + templates "this will go to the top level CMakeLists.txt file" + addLast: ((CMakeAddSubDirectory new) sourcedir: (vmp module)) + ]. + + + + + + + + + + ! Item was added: + ----- Method: SqueakUnixConfig>>customizeCMakeVMDisplayNull (in category 'initialize-release') ----- + customizeCMakeVMDisplayNull + |module| + module := vmplugins detect: [:vmd | #CMakeVMDisplayNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" + module + sources: #('${targetPlatform}/vm-display-null/sqUnixDisplayNull') ; + compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); + compilerflags: (self compilerFlags); + externallibraries: #(); + linkerflags: (self linkerFlags); + includedirectories:(OrderedCollection + with:'${crossDir}/plugins/FilePlugin' + with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' + with: '${crossDir}/plugins/B3DAcceleratorPlugin'). + self flag:'tty'. "I don't think includedirectories is correct. revisit" + + + + + + + ! Item was added: + ----- Method: SqueakUnixConfig>>customizeCMakeVMDisplayX11 (in category 'initialize-release') ----- + customizeCMakeVMDisplayX11 + |module| + module := vmplugins detect: [:vmd | #CMakeVMDisplayX11 = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" + module + sources: #( '${targetPlatform}/vm-display-X11/sqUnixX11' '${targetPlatform}/vm-display-X11/sqUnixMozilla' ); + compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); + compilerflags: (self compilerFlags); + externallibraries: (self externalLibraries); + linkerflags: (self linkerFlags); + includedirectories:(OrderedCollection + with:'${crossDir}/plugins/FilePlugin' + with: '${targetPlatform}/plugins/B3DAcceleratorPlugin' + with: '${crossDir}/plugins/B3DAcceleratorPlugin'). + ! Item was added: + ----- Method: SqueakUnixConfig>>customizeCMakeVMSoundALSA (in category 'initialize-release') ----- + customizeCMakeVMSoundALSA + |module| + module := vmplugins detect: [:vmd | #CMakeVMSoundALSA = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" + module + sources: #( '${targetPlatform}/vm-sound-ALSA/sqUnixSoundALSA' ); + compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); + compilerflags: (self compilerFlags); + externallibraries: (self externalLibraries); + linkerflags: (self linkerFlags); + includedirectories: #(). + ! Item was added: + ----- Method: SqueakUnixConfig>>customizeCMakeVMSoundNull (in category 'initialize-release') ----- + customizeCMakeVMSoundNull + |module| + module := vmplugins detect: [:vmd | #CMakeVMSoundNull = ((vmd class name) asSymbol)] ifNone:[nil]. "error handling?" + module + sources: #( '${targetPlatform}/vm-sound-null/sqUnixSoundNull' ); + compilerdefinitions:(OrderedCollection with: '-fPIC' with: '-DPIC'); + compilerflags: (self compilerFlags); + externallibraries: (self externalLibraries); + linkerflags: (self linkerFlags); + includedirectories:#() + + ! Item was removed: - ----- Method: SqueakUnixConfig>>customizeVMDrivers (in category 'initialize-release') ----- - customizeVMDrivers - " - SystemNavigation default browseMethodsWhoseNamesContain:'customizeVMDrivers' - - force platform level or lower customization of vm-display-X11 vm-sound-ALSA, etc. - The configurations can select what subset they want using something like this. - - |subset iwantonly| - iwantonly := #(#CMakeVMDisplayNull #CMakeVMDisplayX11 #CMakeVMSoundALSA #CMakeVMSoundNull ). - subset := vmdrivers select: [:vmd | 0 < (iwantonly occurrencesOf: (vmd class name) asSymbol)]. - vmdrivers := subset. - - self - customizeCMakeVMDisplayNull; - customizeCMakeVMDisplayX11; - customizeCMakeVMSoundALSA; - customizeCMakeVMSoundNull - - - " - self flag:'tty'. "revisit this design strategy" - self subclassResponsibility! Item was added: + ----- Method: SqueakUnixConfig>>customizeVMPlugins (in category 'initialize-release') ----- + customizeVMPlugins + "override me if you want a different subset of vm plugins at initialization time. + for customization of plugins used based on buildType, override an addVMPlugins[buildType]: aMaker method and + modify that method for whatever subset of plugins you want to use. + + I doubt if buildType plugin selection will be used much. The list created at initialization will probably be sufficient. + " + |mysubset iwantonly| + iwantonly := #(#CMakeVMDisplayNull #CMakeVMDisplayX11 #CMakeVMSoundALSA #CMakeVMSoundNull ). + mysubset := vmplugins select: [:vmd | 0 < (iwantonly occurrencesOf: (vmd class name) asSymbol)]. + vmplugins := mysubset. + self + customizeCMakeVMDisplayNull; + customizeCMakeVMDisplayX11; + customizeCMakeVMSoundALSA; + customizeCMakeVMSoundNull. + + self flag:'tty: complete the customizeVMPlugin stack'. + "The following need to be thought through then written: + + customizeCMakeVMDisplayCustom + customizeCMakeVMDisplayFbdev + customizeCMakeVMDisplayQuartz + customizeCMakeVMSoundCustom + customizeCMakeVMSoundMacOSX + customizeCMakeVMSoundNAS + customizeCMakeVMSoundOSS + customizeCMakeVMSoundPulse + customizeCMakeVMSoundSun + + " + + + ! Item was changed: ----- Method: SqueakUnixConfig>>initializePlatformSources (in category 'source files') ----- initializePlatformSources + " This list of files is taken directly from the Cog build tree. + + ls -1 Cog/platforms/unix/vm/*.c + + Your configuration will need a subset of these based on buildType - " Your configuration will need a subset of these based on buildType SystemNavigation browseAllImplementorsOf: #setPlatformSourcesBuild: + " platformSources:= #( 'aio.c' 'debug.c' 'dlfcn-dyld.c' 'mac-alias.c' 'osExports.c' 'sqUnixCharConv.c' 'sqUnixEvent.c' 'sqUnixExternalPrims.c' + 'sqUnixHeartbeat.c' 'sqUnixITimerHeartbeat.c' 'sqUnixITimerTickerHeartbeat.c' - 'sqUnixHeartbeat.c' 'sqUnixMain.c' 'sqUnixMemory.c' 'sqUnixSpurMemory.c' 'sqUnixThreads.c' 'sqUnixVMProfile.c' ) ! Item was removed: - ----- Method: SqueakUnixConfig>>vmDrivers (in category 'plugins') ----- - vmDrivers - "SystemNavigation default browseMethodsWhoseNamesContain: 'vmDrivers' - " - ^#( - 'vm-display-Quartz' - 'vm-display-X11' - 'vm-display-custom' - 'vm-display-fbdev' - 'vm-display-null' - 'vm-sound-ALSA' - 'vm-sound-MacOSX' - 'vm-sound-NAS' - 'vm-sound-OSS' - 'vm-sound-Sun' - 'vm-sound-custom' - 'vm-sound-null' - ) - ! Item was added: + ----- Method: SqueakWindowsConfig>>addVMPluginsBuild: (in category 'cmake buildType redirects') ----- + addVMPluginsBuild: aMaker + "do nothing. "! Item was removed: - ----- Method: SqueakWindowsConfig>>customizeVMDrivers (in category 'initialize-release') ----- - customizeVMDrivers - " - SystemNavigation default browseMethodsWhoseNamesContain:'customizeVMDrivers' - - force platform level or lower customization of vm-display-X11 vm-sound-ALSA, etc. - The configurations can select what subset they want using something like this. - - |subset iwantonly| - iwantonly := #(#CMakeVMDisplayNull #CMakeVMDisplayX11 #CMakeVMSoundALSA #CMakeVMSoundNull ). - subset := vmdrivers select: [:vmd | 0 < (iwantonly occurrencesOf: (vmd class name) asSymbol)]. - vmdrivers := subset. - - self - customizeCMakeVMDisplayNull; - customizeCMakeVMDisplayX11; - customizeCMakeVMSoundALSA; - customizeCMakeVMSoundNull - - - - " - self flag:'tty'. "revisit this design strategy" - self subclassResponsibility! Item was changed: ----- Method: SqueakWindowsConfig>>customizeVMPlugins (in category 'plugins') ----- customizeVMPlugins "do nothing,. only used on linux?"! Item was added: + ----- Method: SqueakWindowsConfig>>generateByTemplate (in category 'source generation') ----- + generateByTemplate + "You can write out supporting CMake output here. See this method in SqueakUnixConfig for example" + ^ CMakeVMGeneratorForSqueak generateByTemplate: self !

1 0

VM Maker: CMakeVMMakerSqueak-tty.121.mcz
by commits＠source.squeak.org 29 May '16

29 May '16

Timothy M uploaded a new version of CMakeVMMakerSqueak to project VM Maker: http://source.squeak.org/VMMaker/CMakeVMMakerSqueak-tty.121.mcz ==================== Summary ==================== Name: CMakeVMMakerSqueak-tty.121 Author: tty Time: 29 May 2016, 11:42:57.940314 am UUID: e5307b7c-d390-4c55-bb6c-4e21acf240a1 Ancestors: CMakeVMMakerSqueak-tty.120 refactored platformSources to use the method redirect pattern. Modified existing cog v3 and cog spur configurations to return a subset of source files based on build type. generated a squeak.cog.spur configuration . I am running that VM as I type this which is a really cool feeling. Next up: continue work on Help for creating a new Configuration. Fix/refactor tests =============== Diff against CMakeVMMakerSqueak-tty.120 =============== Item was changed: CPlatformConfig subclass: #CPlatformConfigForSqueak + instanceVariableNames: 'buildType cogDir generateBuild generateBuildAssert generateBuildAssertITimerHeartbeat generateBuildDebug generateBuildDebugITimerHeartbeat generateBuildDebugMultiThreaded generateBuildIHeartbeatTimer generateBuildMultiThreaded generateBuildMultiThreadedAssert generateBuildMultiThreadedDebug templates enabledebugmessages platformSources vmplugins' - instanceVariableNames: 'buildType cogDir generateBuild generateBuildAssert generateBuildAssertITimerHeartbeat generateBuildDebug generateBuildDebugITimerHeartbeat generateBuildDebugMultiThreaded generateBuildIHeartbeatTimer generateBuildMultiThreaded generateBuildMultiThreadedAssert generateBuildMultiThreadedDebug templates enabledebugmessages vmplugins' classVariableNames: '' poolDictionaries: '' category: 'CMakeVMMakerSqueak'! CPlatformConfigForSqueak class instanceVariableNames: 'isAbstractBaseClass'! !CPlatformConfigForSqueak commentStamp: 'tty 12/8/2014 11:28' prior: 0! A CPlatformConfigForSqueak acts as a compatability layer for Squeak and an Abstract Base Class for extended functionality required for the Squeak CMakeVMMaker use-case. I make (very) heavy use of a specific design pattern for configuring myself and remaining compatible with pharo's CMakeVMMaker. The entry point for that pattern is my method 'configureForBuildType: aSymbol' . Each method send in there detects my buildType and routes the send to the approriate method for that buildType. Subclasses of me 'must' configure themselves for each build type per that pattern. However this can be very easy by just returning the base configuration. Tests are written to verify that this support infrastructure is in place. I have two important methods. excludeFromBuild and isAbstractBaseClass. excludeFromBuild is used to exclude a configuration from being built by a Builder. is used to exclude a configuration from Testing. isAbstractBaseClass is used by configurations that exclude themselves from being built by a Builder BUT need to be included in Testing. excludeFromBuild | isAbstractBaseClass | should build | should test T T NO YES T F NO NO F T YES YES F F YES YES The use-case is as follows. An abstract base class contains a lot of functionality that must be implemented and tested for the system to work, but it is not meant to be compiled. concrete classes of that AbstractBase class can exclude themselves from being built by builders and by doing so are not tested. However, once a concrete configuration is enabled to be built, it must pass all tests. Linux32x86Config is an example of an AbstractBase class that must pass all testing, but is not buildable. Its subclass Linux32x86SqueakCogV3Config needs testing, but a developer can toggle 'exclude from build' to hide it from Builders or make it available to them. Tests make the decision on what configurations to test. Here are some examples. (o excludeFromBuild not) & (configuration isAbstractBaseClass not) this is a concrete [Lang][VM][MemoryManager][etc] configuration that will be built. No platform classes considered (o excludeFromBuild) & (configuration isAbstractBaseClass not) This is a concrete [Lang][VM][MemoryManager][etc] configuration that will be NOT built. (o excludeFromBuild not) | (configuration isAbstractBaseClass) concrete implementation may depend on its [OS][VMWordSize][Processor] AbstractBaseClass for platform level methods. example: Linux32x86Config ccBuild has the '-m32' compiler flag that is common to all builds on that platform (o excludeFromBuild not) & (configuration isAbstractBaseClass) Not allowed. [OS][VMWordSize][Processor] AbstractBaseClasses should not be built. This is a useful test in its own right. (o excludeFromBuild) & (configuration isAbstractBaseClass) These are the AbstractBaseClasses. An AbstractBaseClass should always be excluded from a build HelpBrowser openOn: CMakeVMMakerSqueakDeveloperHelp tty.! CPlatformConfigForSqueak class instanceVariableNames: 'isAbstractBaseClass'! Item was changed: ----- Method: CPlatformConfigForSqueak>>initialize (in category 'initialize-release') ----- initialize enabledebugmessages := false. + self + initializePlatformSources; + initializeVMDrivers; + customizeVMPlugins. + ! - self initializeVMDrivers. - self customizeVMPlugins! Item was added: + ----- Method: CPlatformConfigForSqueak>>initializePlatformSources (in category 'initialize-release') ----- + initializePlatformSources + self subclassResponsibility! Item was changed: + ----- Method: CPlatformConfigForSqueak>>setPlatformSources: (in category 'cmake buildType redirects') ----- - ----- Method: CPlatformConfigForSqueak>>setPlatformSources: (in category 'cmake') ----- setPlatformSources: aMaker - |platform | - (enabledebugmessages) - ifTrue:[ templates - addLast:((CMakeMessage new) message: (self class name) , 'setPlatformSources: aMaker') - ]. - platform := aMaker append: '${targetPlatform}/vm/' toAll: (self platformSources). - templates - addLast:((CMakeSet new) variable:'platformVMSources' value: platform) + "Route this message send to the message appropriate for my buildType " + |d | + d:= SqueakCMakeVMMakerAbstractBuilder default buildTypeAndDirectoryInfo copy. + d + at: #build put: [self setPlatformSourcesBuild: aMaker]; + at: #buildAssert put: [self setPlatformSourcesBuildAssert: aMaker]; + at: #buildAssertITimerHeartbeat put: [self setPlatformSourcesBuildAssertITimerHeartbeat: aMaker]; + at:#buildDebug put: [self setPlatformSourcesBuildDebug: aMaker]; + at: #buildDebugITimerHeartbeat put: [self setPlatformSourcesBuildDebugITimerHeartbeat: aMaker ]; + at: #buildITimerHeartbeat put: [self setPlatformSourcesBuildITimerHeartbeat: aMaker]; + at: #buildMultiThreaded put: [self setPlatformSourcesBuildMultiThreaded: aMaker ]; + at: #buildMultiThreadedAssert put: [self setPlatformSourcesBuildMultiThreadedAssert: aMaker]; + at: #buildMultiThreadedDebug put: [self setPlatformSourcesBuildMultiThreadedDebug: aMaker ]; + at: #buildNone put:[self setPlatformSourcesNoBuildType: aMaker]. + ^(d at: buildType) value + ! - ! Item was added: + ----- Method: CPlatformConfigForSqueak>>setPlatformSourcesBuild: (in category 'cmake buildType redirects') ----- + setPlatformSourcesBuild: aMaker + |sourcefiles | + "a subclass of mine has presumably set my platformSources instance variable and invoked super" + (enabledebugmessages) + ifTrue:[ templates + addLast:((CMakeMessage new) message: (self class name) , 'setPlatformSources: aMaker') + ]. + + sourcefiles := aMaker append: '${targetPlatform}/vm/' toAll: (platformSources). + templates + addLast:((CMakeSet new) variable:'platformVMSources' value: sourcefiles) + + ! Item was added: + ----- Method: CPlatformConfigForSqueak>>setPlatformSourcesBuildAssert: (in category 'cmake buildType redirects') ----- + setPlatformSourcesBuildAssert: aMaker + "SystemNavigation default browseMethodsWhoseNamesContain: 'setPlatformSources:'" + + ^self setPlatformSourcesBuild: aMaker! Item was added: + ----- Method: CPlatformConfigForSqueak>>setPlatformSourcesBuildAssertITimerHeartbeat: (in category 'cmake buildType redirects') ----- + setPlatformSourcesBuildAssertITimerHeartbeat: aMaker + "SystemNavigation default browseMethodsWhoseNamesContain: 'setPlatformSources:'" + + ^self setPlatformSourcesBuild: aMaker! Item was added: + ----- Method: CPlatformConfigForSqueak>>setPlatformSourcesBuildDebug: (in category 'cmake buildType redirects') ----- + setPlatformSourcesBuildDebug: aMaker + "SystemNavigation default browseMethodsWhoseNamesContain: 'setPlatformSources'" + ^self setPlatformSourcesBuild: aMaker! Item was added: + ----- Method: CPlatformConfigForSqueak>>setPlatformSourcesBuildDebugITimerHeartbeat: (in category 'cmake buildType redirects') ----- + setPlatformSourcesBuildDebugITimerHeartbeat: aMaker + "SystemNavigation default browseMethodsWhoseNamesContain: 'setPlatformSources'" + ^self setPlatformSourcesBuild: aMaker! Item was added: + ----- Method: CPlatformConfigForSqueak>>setPlatformSourcesBuildITimerHeartbeat: (in category 'cmake buildType redirects') ----- + setPlatformSourcesBuildITimerHeartbeat: aMaker + "SystemNavigation default browseMethodsWhoseNamesContain: 'setPlatformSources'" + ^self setPlatformSourcesBuild: aMaker! Item was added: + ----- Method: CPlatformConfigForSqueak>>setPlatformSourcesBuildMultiThreaded: (in category 'cmake buildType redirects') ----- + setPlatformSourcesBuildMultiThreaded: aMaker + "SystemNavigation default browseMethodsWhoseNamesContain: 'setPlatformSources'" + ^self setPlatformSourcesBuild: aMaker! Item was added: + ----- Method: CPlatformConfigForSqueak>>setPlatformSourcesBuildMultiThreadedAssert: (in category 'cmake buildType redirects') ----- + setPlatformSourcesBuildMultiThreadedAssert: aMaker + "SystemNavigation default browseMethodsWhoseNamesContain: 'setPlatformSources'" + ^self setPlatformSourcesBuild: aMaker! Item was added: + ----- Method: CPlatformConfigForSqueak>>setPlatformSourcesBuildMultiThreadedDebug: (in category 'cmake buildType redirects') ----- + setPlatformSourcesBuildMultiThreadedDebug: aMaker + "SystemNavigation default browseMethodsWhoseNamesContain: 'setPlatformSources'" + ^self setPlatformSourcesBuild: aMaker! Item was added: + ----- Method: CPlatformConfigForSqueak>>setPlatformSourcesNoBuildType: (in category 'cmake buildType redirects') ----- + setPlatformSourcesNoBuildType: aMaker + "SHOULD NOT GET HERE" + self shouldNotImplement.! Item was changed: ----- Method: Linux64x86w32BitConfigUsrLib>>coreSourcesBuild (in category 'cmake buildType redirects') ----- coreSourcesBuild "files to include from src/vm dir" + self flag:'tty revisit this. This should return a subset of the available files there'. ^ #( 'cogit.c' 'gcc3x-cointerp.c' )! Item was removed: - ----- Method: Linux64x86w32BitSqueakCogSpurConfig>>defaultInternalPlugins (in category 'plugins') ----- - defaultInternalPlugins - "" - ^#()! Item was added: + ----- Method: Linux64x86w32BitSqueakCogSpurConfig>>setPlatformSourcesBuild: (in category 'cmake buildType redirects') ----- + setPlatformSourcesBuild:aMaker + |mysubset iwantonly| + + "trim the platformSources collection .c files I want. for this OS/platform" + self flag:'tty. go through the Cog svn tree and see exactly what files should be included here. debug.c feels wrong'. + iwantonly := #( + 'aio.c' + 'debug.c' + 'osExports.c' + 'sqUnixCharConv.c' + 'sqUnixExternalPrims.c' + 'sqUnixHeartbeat.c' + 'sqUnixMain.c' + 'sqUnixMemory.c' + 'sqUnixSpurMemory.c' + 'sqUnixThreads.c' + 'sqUnixVMProfile.c' + ). + mysubset := platformSources select: [:c | 0 < (iwantonly occurrencesOf: c)]. + platformSources := mysubset. + super setPlatformSourcesBuild:aMaker! Item was added: + ----- Method: Linux64x86w32BitSqueakCogV3Config>>setPlatformSourcesBuild: (in category 'cmake buildType redirects') ----- + setPlatformSourcesBuild:aMaker + |mysubset iwantonly| + + "trim the platformSources collection .c files I want. for this OS/platform" + self flag:'tty. go through the Cog svn tree and see exactly what files should be included here.'. + iwantonly := #( + 'aio.c' + 'debug.c' + 'osExports.c' + 'sqUnixCharConv.c' + 'sqUnixExternalPrims.c' + 'sqUnixHeartbeat.c' + 'sqUnixMain.c' + 'sqUnixMemory.c' + 'sqUnixThreads.c' + 'sqUnixVMProfile.c' + ). + mysubset := platformSources select: [:c | 0 < (iwantonly occurrencesOf: c)]. + platformSources := mysubset. + super setPlatformSourcesBuild:aMaker! Item was added: + ----- Method: Linux64x86w32BitSqueakCogV3Config>>setPlatformSourcesBuildAssert: (in category 'cmake buildType redirects') ----- + setPlatformSourcesBuildAssert:aMaker + |mysubset iwantonly| + + "trim the platformSources collection .c files I want. for this OS/platform" + self flag:'tty. go through the Cog svn tree and see exactly what files should be included here.'. + iwantonly := #( + 'aio.c' + 'debug.c' + 'osExports.c' + 'sqUnixCharConv.c' + 'sqUnixExternalPrims.c' + 'sqUnixHeartbeat.c' + 'sqUnixMain.c' + 'sqUnixMemory.c' + 'sqUnixThreads.c' + 'sqUnixVMProfile.c' + ). + mysubset := platformSources select: [:c | 0 < (iwantonly occurrencesOf: c)]. + platformSources := mysubset. + super setPlatformSourcesBuild:aMaker! Item was added: + ----- Method: SqueakMacintoshConfig>>initializePlatformSources (in category 'source files') ----- + initializePlatformSources + "files added from platform/Mac OS/vm dir Your configuration will need a subset of these based on buildType + SystemNavigation browseAllImplementorsOf: #setPlatformSourcesBuild: + " + + platformSources :=#( + 'NSCursorWrappers.m' + 'nsPoolManagement.m' + 'osExports.c' + 'sqMacEncoding.c' + 'sqMacImageIO.c' + 'sqMacMain.c' + 'sqMacMemory.c' + 'sqMacNSPluginUILogic2.c' + 'sqMacTime.c' + 'sqMacUIAppleEvents.c' + 'sqMacUIClipBoard.c' + 'sqMacUIEventsUniversal.c' " instead of: sqMacUIEvents.c " + 'sqMacUIMenuBarUniversal.c' + 'sqMacUnixCommandLineInterface.c' + 'sqMacUnixExternalPrims.c' + 'sqMacWindowUniversal.c' + 'version.c' + )! Item was removed: - ----- Method: SqueakMacintoshConfig>>platformSources (in category 'source files') ----- - platformSources - "files added from platform/Mac OS/vm dir " - ^ #( - 'NSCursorWrappers.m' - 'nsPoolManagement.m' - 'osExports.c' - 'sqMacEncoding.c' - 'sqMacImageIO.c' - 'sqMacMain.c' - 'sqMacMemory.c' - 'sqMacNSPluginUILogic2.c' - 'sqMacTime.c' - 'sqMacUIAppleEvents.c' - 'sqMacUIClipBoard.c' - 'sqMacUIEventsUniversal.c' " instead of: sqMacUIEvents.c " - 'sqMacUIMenuBarUniversal.c' - 'sqMacUnixCommandLineInterface.c' - 'sqMacUnixExternalPrims.c' - 'sqMacWindowUniversal.c' - 'version.c' - )! Item was added: + ----- Method: SqueakUnixConfig>>initializePlatformSources (in category 'source files') ----- + initializePlatformSources + " Your configuration will need a subset of these based on buildType + SystemNavigation browseAllImplementorsOf: #setPlatformSourcesBuild: + " + + platformSources:= #( + 'aio.c' + 'debug.c' + 'dlfcn-dyld.c' + 'mac-alias.c' + 'osExports.c' + 'sqUnixCharConv.c' + 'sqUnixEvent.c' + 'sqUnixExternalPrims.c' + 'sqUnixITimerHeartbeat.c' + 'sqUnixITimerTickerHeartbeat.c' + 'sqUnixHeartbeat.c' + 'sqUnixMain.c' + 'sqUnixMemory.c' + 'sqUnixSpurMemory.c' + 'sqUnixThreads.c' + 'sqUnixVMProfile.c' + ) + + + + ! Item was removed: - ----- Method: SqueakUnixConfig>>platformSources (in category 'source files') ----- - platformSources - "files added from platform/unix/vm dir " - ^ #( - 'aio.c' - 'debug.c' - 'osExports.c' - 'sqUnixCharConv.c' - - 'sqUnixExternalPrims.c' - 'sqUnixHeartbeat.c' - 'sqUnixMain.c' - 'sqUnixMemory.c' - 'sqUnixSpurMemory.c' - 'sqUnixThreads.c' - 'sqUnixVMProfile.c' - ) - - " - 'dlfcn-dyld.c' - 'mac-alias.c' - 'sqUnixEvent.c' - - 'sqUnixITimerHeartbeat.c' - 'sqUnixITimerTickerHeartbeat.c' - - " - ! Item was added: + ----- Method: SqueakWindowsConfig>>initializePlatformSources (in category 'source files') ----- + initializePlatformSources + "files from platform/win32/vm dir + Your configuration will need a subset of these based on buildType + SystemNavigation browseAllImplementorsOf: #setPlatformSourcesBuild: + " + platformSources:= #( + 'sqWin32Alloc.c' + 'sqWin32Directory.c' + 'sqWin32Heartbeat.c' + 'sqWin32Service.c' + 'sqWin32VMProfile.c' + 'sqWin32Args.c' + 'sqWin32Exports.c' + 'sqWin32Intel.c' + 'sqWin32Stubs.c' + 'sqWin32Window.c' + 'sqWin32Backtrace.c' + 'sqWin32ExternalPrims.c' + 'sqWin32PluginSupport.c' + 'sqWin32Threads.c' + 'version.c' + 'sqWin32DirectInput.c' + 'sqWin32GUID.c' + 'sqWin32Prefs.c' + 'sqWin32Utils.c' + )! Item was removed: - ----- Method: SqueakWindowsConfig>>platformSources (in category 'source files') ----- - platformSources - "files added from platform/win32/vm dir " - ^ #( - 'sqWin32Alloc.c' - 'sqWin32Directory.c' - 'sqWin32Heartbeat.c' - 'sqWin32Service.c' - 'sqWin32VMProfile.c' - 'sqWin32Args.c' - 'sqWin32Exports.c' - 'sqWin32Intel.c' - 'sqWin32Stubs.c' - 'sqWin32Window.c' - 'sqWin32Backtrace.c' - 'sqWin32ExternalPrims.c' - 'sqWin32PluginSupport.c' - 'sqWin32Threads.c' - 'version.c' - 'sqWin32DirectInput.c' - 'sqWin32GUID.c' - 'sqWin32Prefs.c' - 'sqWin32Utils.c' - )!

1 0

VM Maker: CMakeVMMakerSqueak-tty.120.mcz
by commits＠source.squeak.org 29 May '16

29 May '16

Timothy M uploaded a new version of CMakeVMMakerSqueak to project VM Maker: http://source.squeak.org/VMMaker/CMakeVMMakerSqueak-tty.120.mcz ==================== Summary ==================== Name: CMakeVMMakerSqueak-tty.120 Author: tty Time: 28 May 2016, 6:08:43.532617 pm UUID: 5fc6ab13-f0cb-4611-8132-f903d7168fd1 Ancestors: CMakeVMMakerSqueak-tty.119 squeak.cog.spur compiles cog -version reports: ./cog -version -3732 Sat May 28 18:02:46 EDT 2016 gcc 4.8.2 [Production Spur VM] CoInterpreter VMMaker.oscog-eem.1872 uuid: 6db6d610-b1a5-4f4d-978d-22c917bdb3e4 May 28 2016 StackToRegisterMappingCogit VMMaker.oscog-eem.1860 uuid: 4d58d995-ee0c-4330-9190-adfa038e8f24 May 28 2016 VM: r3732 http://www.squeakvm.org/svn/squeak/branches/Cog Date: 2016-05-26 16:01:37 -0400 Plugins: r3730 http://squeakvm.org/svn/squeak/trunk/platforms/Cross/plugins Linux flipper 3.10.17 #2 SMP Wed Oct 23 16:34:38 CDT 2013 x86_64 AMD Phenom(tm) II X4 965 Processor AuthenticAMD GNU/Linux plugin path: ....etc woot! Learned that a Configs platformSources must be customized depending on build type, so need to refactor that. added notes to Help customizable methods I missed on initial pass. =============== Diff against CMakeVMMakerSqueak-tty.119 =============== Item was changed: ----- Method: CMakeVMGeneratorForSqueak>>generateByTemplate (in category 'code generation') ----- generateByTemplate "attempt to move way from string based writing to template based. Think Seaside renderOn composition" | extPlugins intPlugins | self flag: 'tty'. "refactor so that the cascade reflects CMake terminilogy" output := String new writeStream. config templates: OrderedCollection new. config setGlobalOptions: self; cmakePrefixPath; cmakeIncludePath; cmakeLibraryPath; cmakeIncludeModules; cmakeCFlags; cmakeAddDefinitions; cmakeWriteDirectoriesDotCmake: self; cmakeIncludeDirectories: self; "<---" preferredIncludes; "<---why 3 of em?" standardIncludes; "<---" setGlobalOptionsAfterDetermineSystem: self; extraVMSettings: self; "<--catch-all method. os/platform specific" setCoreSources: self; setPlatformSources: self; setCrossSources: self; setExtraSources; cmakeSetSourceFilesProperties; cmakeListAppend:'LINKLIBS' elements: (config externalLibs); cmakeAddExecutableNameOptionSource: self; setExecutableOutputPath; addVMPlugins: self. config templates do: [:each | self puts: each content]. config templates: OrderedCollection new. extPlugins := self generatePluginConfigs: config internalPlugins internal: true. intPlugins := self generatePluginConfigs: config externalPlugins internal: false. self processThirdpartyLibraries. "<--unused in Pharo code? What exactly does this do?" self processPlugins: intPlugins, extPlugins. self config templates addLast:((CMakeCommand new) command:'target_link_libraries' params:(self moduleName , ' ${LINKLIBS}')). " self cmd: 'target_link_libraries' params: self moduleName , ' ${LINKLIBS}'." config postBuildActions: self.. config templates do: [:each | self puts: each content]. self saveFile. self generateBuildScript! Item was added: + ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>cogitClass (in category 'pages') ----- + cogitClass + ^HelpTopic + title:'cogitClass' + contents: + ' + write me. + '! Item was added: + ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>configGenerateByTemplate (in category 'pages') ----- + configGenerateByTemplate + ^HelpTopic + title:'config generate by template' + contents: + ' + write me: generate by template is in several places. including the unix config and the vm and plugin generators + '! Item was changed: ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>pages (in category 'accessing') ----- pages + + "platformSources...cogitClass...src vs vmsrc" + ^#( + platformSources + cogitClass + vmsrc + configGenerateByTemplate + overview - "I need the srcDir" - ^#(overview tests identifyPlatform identifyPlatformAbstractBaseClass identifyBuilder createTheConfiguration excludingConfigFromBuilds setAvailableBuildTypes firstCMakeGeneration tackingStockOne cPlatformConfigForSqueak methodRedirectPattern theVMGenerator tackingStockTwo forTheImpatient specifyDirectories setGlobalOptions cmakePrefixPath cmakeIncludePath cmakeLibraryPath cmakeIncludeModules cmakeCFlags cmakeAddDefinitions cmakeWriteDirectoriesDotCmake cmakeIncludeDirectories preferredIncludes standardIncludes setGlobalOptionsAfterDetermineSystem extraVMSettings setCoreSources setPlatformSources setCrossSources setExtraSources cmakeSetSourceFilesProperties cmakeListAppendLINKLIBSelements cmakeAddExecutableNameOptionSource setExecutableOutputPath addVMPlugins generatePluginConfigs specifyPlugins processThirdpartyLibraries processPlugins postBuildActions setConfigurationDirectory compilingLinkingSetup customizeVMDrivers aNoteOnFoo ) ! Item was added: + ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>platformSources (in category 'pages') ----- + platformSources + ^HelpTopic + title:'platformSources' + contents: + 'write me + '! Item was added: + ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>vmsrc (in category 'pages') ----- + vmsrc + ^HelpTopic + title:'vmsrc' + contents: + ' + write me. + '! Item was changed: ----- Method: CPlatformConfigForSqueak class>>vmBuildCmake (in category 'as yet unclassified') ----- vmBuildCmake self flag: 'tty'. "I probably do not want this as this is what we currently do in Squeak. Ian appears to have farmed it out to its own file" ^' LINK_DIRECTORIES (${vm_link_directories}) ADD_EXECUTABLE (squeakvm${scriptsuffix} ${bld}/${interp}.c ${unix}/vm/aio.c ${unix}/vm/debug.c ${unix}/vm/osExports.c ${unix}/vm/sqUnixCharConv.c ${unix}/vm/sqUnixExternalPrims.c ${unix}/vm/sqUnixMain.c ${unix}/vm/sqUnixMemory.c + ${unix}/vm/sqUnixSpurMemory.c ${cross}/vm/sqNamedPrims.c ${cross}/vm/sqVirtualMachine.c ${bld}/version.c ) ADD_CUSTOM_COMMAND ( OUTPUT version.c COMMAND ${config}/verstamp ${bld}/version.c ${CMAKE_C_COMPILER} ) ADD_CUSTOM_COMMAND ( DEPENDS ${src}/vm/interp.c OUTPUT ${bld}/interp.c COMMAND tr ''\\015'' ''\\012'' < ${src}/vm/interp.c > ${bld}/interp.c ) ADD_CUSTOM_COMMAND ( DEPENDS ${bld}/interp.c OUTPUT ${bld}/gnu-interp.c COMMAND ${config}/gnuify ${config}/gnuify.awk ${bld}/interp.c ${bld}/gnu-interp.c ) INCLUDE_DIRECTORIES ( ${bld} # ${src}/vm # files are now copied/generated in ${bld} ${unix}/vm ${cross}/vm ${unix}/plugins/B3DAcceleratorPlugin # for sqUnixOpenGL.h ${X11_INCLUDE_DIR} ${OPENGL_INCLUDE_DIR} ${vm_include_directories} ) SET_TARGET_PROPERTIES (squeakvm${scriptsuffix} PROPERTIES LINK_FLAGS "${CMAKE_EXE_EXPORTS_C_FLAG}") TARGET_LINK_LIBRARIES (squeakvm${scriptsuffix} m ${squeak_libs} ${vm_link_libraries}) INSTALL (PROGRAMS ${bld}/squeakvm${scriptsuffix} DESTINATION ${plgdir}) IF (vm-sound-OSS_disabled) SET (useoss "false") ELSE () SET (useoss "true") ENDIF () CONFIGURE_FILE (${config}/config.in ${bld}/config @ONLY) # launcher scripts ADD_CUSTOM_TARGET (squeak DEPENDS ${config}/squeak.in COMMAND sh ${bld}/config ${config}/squeak.in ${bld}/squeak COMMAND chmod +x ${bld}/squeak ) INSTALL (PROGRAMS ${bld}/squeak DESTINATION bin) ADD_CUSTOM_TARGET (squeak.sh DEPENDS ${config}/squeak.sh.in COMMAND sh ${bld}/config ${config}/squeak.sh.in ${bld}/squeak.sh COMMAND chmod +x ${bld}/squeak.sh ) INSTALL (PROGRAMS ${bld}/squeak.sh DESTINATION bin) ADD_EXECUTABLE (ckformat ${src}/ckformat.c ) INSTALL (PROGRAMS ${bld}/ckformat DESTINATION ${plgdir}) ADD_DEPENDENCIES (squeakvm${scriptsuffix} squeak squeak.sh ckformat) # manual page ADD_CUSTOM_TARGET (squeak.1 DEPENDS ${unix}/doc/squeak.1 COMMAND sh ${bld}/config ${unix}/doc/squeak.1 ${bld}/squeak.1 ) ADD_DEPENDENCIES (squeakvm${scriptsuffix} squeak.1) INSTALL (FILES ${bld}/squeak.1 DESTINATION share/man/man1) '! Item was changed: ----- Method: CPlatformConfigForSqueak>>dirBuildLanguageVMMM (in category 'cmake directory') ----- dirBuildLanguageVMMM + "the directory under buildPlatformDir example: newspeak.cog.spur. " - "the directory under buildPlatformDir example: newspeak.cog.spur. use squeak.cog.v3 as default" self subclassResponsibility! Item was changed: ----- Method: CPlatformConfigForSqueak>>generatePluginsList (in category 'source generation') ----- generatePluginsList self write: (self class pluginsTemplate format: { self version. String streamContents: [ :stream | self internalPlugins asStringOn: stream delimiter: String cr ]. String streamContents: [ :stream | self externalPlugins asStringOn: stream delimiter: String cr ]. self executableName }) toFile: 'PLUGINS.txt' ! Item was changed: Linux64x86w32BitConfigUsrLib subclass: #Linux64x86w32BitSqueakCogSpurConfig instanceVariableNames: '' classVariableNames: '' poolDictionaries: '' category: 'CMakeVMMakerSqueak-Linux64X86-32BitCompatibility'! + !Linux64x86w32BitSqueakCogSpurConfig commentStamp: 'tty 5/28/2016 16:21' prior: 0! - !Linux64x86w32BitSqueakCogSpurConfig commentStamp: '<historical>' prior: 0! I am a configuration for 64 bit Linux with 32 Bit compatability libraries. I have been tested with Slackware64 14.1 which uses /usr/lib for 32 bit compatability libs and /usr/lib64 for normal libs. If you have a machine which uses /usr/lib for 64 bit libs and /usr/lib32 for 32 bit compat libs then subclass me and modify (at least) the following methods: compilerFlags externalLibraries linkFlagsBuild linkerFlags SqueakLinux64x86w32CompatBuilder + configureABuildFor: #Linux64x86w32BitSqueakCogSpurConfig withBuildType: #build; - configureABuildFor: #Linux64x86w32BitSqueakCogV3Config withBuildType: #build; enableMessageTracking: true; generateByTemplate. HelpBrowser openOn: CMakeVMMakerSqueakDeveloperHelp Getting the UUIDPlugin to compile (not work, unfortunately, but compile) required modifying oscogvm/platforms/unix/plugins/acinclude.m4. to read: (my Slackware system has <uuid> and uuidgen. then setting the # -*- sh -*- AC_MSG_CHECKING([for UUID support]) AC_TRY_COMPILE([#include <sys/uuid.h>],[uuid_generatorxyz;],[ AC_MSG_RESULT(yes) AC_CHECK_LIB(uuid, uuid_generator_xyz,LIB_UUID="-luuid" ) ],[ AC_MSG_RESULT(no) AC_MSG_CHECKING([for UUID support uuid/uuid.h] and uuid_generate) AC_TRY_COMPILE([#include <uuid/uuid.h>],[uuid_generate;],[ AC_MSG_RESULT(yes) AC_CHECK_LIB(uuid, uuid_generate, LIB_UUID="-luuid")],[ AC_MSG_RESULT(no) AC_MSG_CHECKING([for UUID support uuid and uuidgen] ) AC_TRY_COMPILE([#include <uuid.h>],[uuidgen;],[ AC_MSG_RESULT(yes) AC_CHECK_LIB(uuid, uuidgen, LIB_UUID="-luuid" )],[ AC_MSG_RESULT(no) AC_PLUGIN_DISABLE ]) ]) ]) #define HAVE_UUID_H 1 #define HAVE_UUIDGEN 1 + flags in my configH method - fl;ags in my configH method ! Item was added: + ----- Method: Linux64x86w32BitSqueakCogSpurConfig>>defaultInternalPlugins (in category 'plugins') ----- + defaultInternalPlugins + "" + ^#()! Item was changed: ----- Method: SqueakIA32BochsLinuxConfig>>dirBuildLanguageVMMM (in category 'cmake') ----- dirBuildLanguageVMMM + "the directory under buildPlatformDir example: newspeak.cog.spur." - "the directory under buildPlatformDir example: newspeak.cog.spur. use squeak.cog.v3 as default" ^self squeakCogSpur! Item was changed: ----- Method: SqueakIA32BochsMacOSConfig>>dirBuildLanguageVMMM (in category 'cmake') ----- dirBuildLanguageVMMM + "the directory under buildPlatformDir example: newspeak.cog.spur. " - "the directory under buildPlatformDir example: newspeak.cog.spur. use squeak.cog.v3 as default" ^self squeakCogSpur! Item was changed: ----- Method: SqueakIA32BochsWin32Config>>dirBuildLanguageVMMM (in category 'cmake') ----- dirBuildLanguageVMMM + "the directory under buildPlatformDir example: newspeak.cog.spur. " - "the directory under buildPlatformDir example: newspeak.cog.spur. use squeak.cog.v3 as default" ^self squeakCogSpur! Item was changed: ----- Method: SqueakUnixConfig>>platformSources (in category 'source files') ----- platformSources "files added from platform/unix/vm dir " ^ #( 'aio.c' 'debug.c' - " 'dlfcn-dyld.c' - 'mac-alias.c' " 'osExports.c' 'sqUnixCharConv.c' + - " 'sqUnixEvent.c' " 'sqUnixExternalPrims.c' 'sqUnixHeartbeat.c' 'sqUnixMain.c' 'sqUnixMemory.c' + 'sqUnixSpurMemory.c' 'sqUnixThreads.c' 'sqUnixVMProfile.c' + ) + + " + 'dlfcn-dyld.c' + 'mac-alias.c' + 'sqUnixEvent.c' + + 'sqUnixITimerHeartbeat.c' + 'sqUnixITimerTickerHeartbeat.c' + + " + ! - )!

1 0

VM Maker: CMakeVMMakerSqueak-tty.119.mcz
by commits＠source.squeak.org 29 May '16

29 May '16

Timothy M uploaded a new version of CMakeVMMakerSqueak to project VM Maker: http://source.squeak.org/VMMaker/CMakeVMMakerSqueak-tty.119.mcz ==================== Summary ==================== Name: CMakeVMMakerSqueak-tty.119 Author: tty Time: 22 May 2016, 3:09:10.602694 pm UUID: fb6b7f67-d708-4b3e-b726-5552e935addb Ancestors: CMakeVMMakerSqueak-tty.118 differentiated between oscogvm/src and the various oscogvm/[where the vm lives actually lives.] CMake generates output. However linking step in compile fails. Still need to redo tests for this change =============== Diff against CMakeVMMakerSqueak-tty.118 =============== Item was changed: ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>specifyDirectories (in category 'pages') ----- specifyDirectories ^HelpTopic title:'Specify Directories' contents: 'Our new Configuration must correctly name two directory trees. The first is the cmake.build.* directory tree where the generated CMake output is placed. The second is the cmake.products/* directory tree where the compiled vm is placed. Correctly naming these is a courtesy you should extend as the system grows*. For this particular Configuration, we want a cmake.build.* directory that looks like this: oscogvm/cmake.products/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur and we want a cmake.products/* directory that looks like this: oscogvm/cmake.products/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur/build Each directory in those trees is accessible viathe the CPlatformConfigForSqueak in the ''cmake directory'' category. ToolSet browseClass: CPlatformConfigForSqueak category: ''cmake directory''. There are two method variants. The first variant is hardcoded in the method itself. For example the platform directories are stored as... dirLinux32Armv6 ^''cmake.build.linux32armv6'' or, for our configuration dirLinux64x86w32BitCompatibility ^''cmake.build.linux64x86w32BitCompatibility'' The second variant accesses the name of a buildType directory via the SqueakCMakeVMMakerAbstractBuilder (do a printIt or doIt). dirBuild ^SqueakCMakeVMMakerAbstractBuilder default buildTypeAndDirectoryInfo at: #build Each part of the directory tree is contained/accessible via these methods. It is our job to select the corect ones for our purposes. Here is an example of mapping this output directory path ''oscogvm/cmake.products/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur/build'' to the methods that output each part. |c| c:=(CPlatformConfigForSqueak basicNew). (c oscogvm), ''/'', (c dirOutput), ''/'', (c dirLinux64x86w32BitCompatibility), ''/'', (c squeakCogSpur), ''/'', (c dirBuild) The methods corresponding to each of the above directory names are: topDir dirOutput dirBuildPlatform dirBuildLanguageVMMM buildType (not a method,this is a private instance variable in the configuration) The first two, topDir and dirOutput are contained in CPlatformConfigForSqueak dirBuildPlatform is contained at the platform level SystemNavigation new browseAllImplementorsOf: #dirBuildPlatform localTo:CPlatformConfigForSqueak. dirBuildLangaugeVMMM is at the specific Configuration level SystemNavigation new browseAllImplementorsOf: #dirBuildLanguageVMMM localTo:CPlatformConfigForSqueak. buildType is set when we configure the Configuration for a particular buildType and is stored in the SqueakCMakeVMMakerAbstractBuilder at its initialization. SystemNavigation new browseAllImplementorsOf: #initializeBuildTypeAndDirectoryInfo It is this values that the CPlatformConfigForSqueak access via dirBuild, dirBuildAssert etc... SystemNavigation new browseAllImplementorsOf: #dirBuild Similarly, the build directory tree ''oscogvm/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur/build/'' has methods corresponding to each of the above directory names. they are: topDir dirBuildPlatform dirBuildLanguageVMMM buildType (not a method,this is a private instance variable in the configuration) It follows then, that for our Configuration we need to make the method dirBuildLanguageVMMM return ''squeak.cog.spur''. We cover that in the next Help page. *The naming convention is straightforward and convered in the ''Naming Convetions'' page of the Developer Guide Overview Help. - HelpBrowser openOn:CMakeVMMakerSqueakOverviewHelp + (HelpBrowser openOn: CMakeVMMakerSqueakOverviewHelp) model + showTopicThat: [:topic | topic key = #namingConventions]. + + '! Item was changed: CPlatformConfig subclass: #CPlatformConfigForSqueak + instanceVariableNames: 'buildType cogDir generateBuild generateBuildAssert generateBuildAssertITimerHeartbeat generateBuildDebug generateBuildDebugITimerHeartbeat generateBuildDebugMultiThreaded generateBuildIHeartbeatTimer generateBuildMultiThreaded generateBuildMultiThreadedAssert generateBuildMultiThreadedDebug templates enabledebugmessages vmplugins' - instanceVariableNames: 'buildType generateBuild generateBuildAssert generateBuildAssertITimerHeartbeat generateBuildDebug generateBuildDebugITimerHeartbeat generateBuildDebugMultiThreaded generateBuildIHeartbeatTimer generateBuildMultiThreaded generateBuildMultiThreadedAssert generateBuildMultiThreadedDebug templates enabledebugmessages vmplugins' classVariableNames: '' poolDictionaries: '' category: 'CMakeVMMakerSqueak'! CPlatformConfigForSqueak class instanceVariableNames: 'isAbstractBaseClass'! !CPlatformConfigForSqueak commentStamp: 'tty 12/8/2014 11:28' prior: 0! A CPlatformConfigForSqueak acts as a compatability layer for Squeak and an Abstract Base Class for extended functionality required for the Squeak CMakeVMMaker use-case. I make (very) heavy use of a specific design pattern for configuring myself and remaining compatible with pharo's CMakeVMMaker. The entry point for that pattern is my method 'configureForBuildType: aSymbol' . Each method send in there detects my buildType and routes the send to the approriate method for that buildType. Subclasses of me 'must' configure themselves for each build type per that pattern. However this can be very easy by just returning the base configuration. Tests are written to verify that this support infrastructure is in place. I have two important methods. excludeFromBuild and isAbstractBaseClass. excludeFromBuild is used to exclude a configuration from being built by a Builder. is used to exclude a configuration from Testing. isAbstractBaseClass is used by configurations that exclude themselves from being built by a Builder BUT need to be included in Testing. excludeFromBuild | isAbstractBaseClass | should build | should test T T NO YES T F NO NO F T YES YES F F YES YES The use-case is as follows. An abstract base class contains a lot of functionality that must be implemented and tested for the system to work, but it is not meant to be compiled. concrete classes of that AbstractBase class can exclude themselves from being built by builders and by doing so are not tested. However, once a concrete configuration is enabled to be built, it must pass all tests. Linux32x86Config is an example of an AbstractBase class that must pass all testing, but is not buildable. Its subclass Linux32x86SqueakCogV3Config needs testing, but a developer can toggle 'exclude from build' to hide it from Builders or make it available to them. Tests make the decision on what configurations to test. Here are some examples. (o excludeFromBuild not) & (configuration isAbstractBaseClass not) this is a concrete [Lang][VM][MemoryManager][etc] configuration that will be built. No platform classes considered (o excludeFromBuild) & (configuration isAbstractBaseClass not) This is a concrete [Lang][VM][MemoryManager][etc] configuration that will be NOT built. (o excludeFromBuild not) | (configuration isAbstractBaseClass) concrete implementation may depend on its [OS][VMWordSize][Processor] AbstractBaseClass for platform level methods. example: Linux32x86Config ccBuild has the '-m32' compiler flag that is common to all builds on that platform (o excludeFromBuild not) & (configuration isAbstractBaseClass) Not allowed. [OS][VMWordSize][Processor] AbstractBaseClasses should not be built. This is a useful test in its own right. (o excludeFromBuild) & (configuration isAbstractBaseClass) These are the AbstractBaseClasses. An AbstractBaseClass should always be excluded from a build HelpBrowser openOn: CMakeVMMakerSqueakDeveloperHelp tty.! CPlatformConfigForSqueak class instanceVariableNames: 'isAbstractBaseClass'! Item was changed: + ----- Method: CPlatformConfigForSqueak>>buildDir (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>buildDir (in category 'squeak compatability') ----- buildDir ^ buildDir ifNil: [ buildDir := ( self topDir / self buildDirName) assureExistence].! Item was changed: + ----- Method: CPlatformConfigForSqueak>>buildDirName (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>buildDirName (in category 'squeak compatability') ----- buildDirName buildType isNil ifTrue:[^self dirBuildPlatform, FileDirectory slash, self dirBuildLanguageVMMM, FileDirectory slash, 'build'] ifFalse:[^self dirBuildPlatform, FileDirectory slash, self dirBuildLanguageVMMM, FileDirectory slash, buildType asString]! Item was added: + ----- Method: CPlatformConfigForSqueak>>cogDir (in category 'cmake directory') ----- + cogDir + " topDir=oscogvm + dirSource=[nsspur64src | nsspursrc |nsspurstack64src |nsspurstacksrc |spur64src |spursistasrc |spursrc | spurstack64src |spurstacksrc | src |stacksr] Configurations customize this + srcDir=oscogvm/dirSource + cogDir=oscogvm/src (needed by CMake for access to plugins source in oscogvm/src/plugins) + " + ^ cogDir ifNil: [ cogDir := (self src) ] + + ! Item was changed: + ----- Method: CPlatformConfigForSqueak>>customizeVMPlugins (in category 'initialize-release') ----- - ----- Method: CPlatformConfigForSqueak>>customizeVMPlugins (in category 'plugins') ----- customizeVMPlugins self flag:'tty'. "is this needed on all platforms? consider moving down" self subclassResponsibility! Item was changed: ----- Method: CPlatformConfigForSqueak>>dirSource (in category 'cmake directory') ----- dirSource + " + dirSource=[nsspur64src | nsspursrc | nsspurstack64src |nsspurstacksrc |spur64src |spursistasrc |spursrc | spurstack64src |spurstacksrc | src |stacksr] Configurations must customize this + srcDir=oscogvm/dirSource + cogDir=oscogvm/src (needed by CMake for access to plugins source in oscogvm/src/plugins) - "Have your custom Configuration return the directory where the source files are. As of 2016.05.15 they are: - nsspur64src - nsspursrc - nsspurstack64src - nsspurstacksrc - spur64src - spursistasrc - spursrc - spurstack64src - spurstacksrc - src (cog.v3 lives here) - stacksrc" + + " + + self subclassResponsibility ! Item was changed: + ----- Method: CPlatformConfigForSqueak>>nsspur64src (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>nsspur64src (in category 'cmake source names') ----- nsspur64src + ^ (self topDir directoryNamed: 'nsspur64src')! - ^ 'nsspur64src'! Item was changed: + ----- Method: CPlatformConfigForSqueak>>nsspursrc (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>nsspursrc (in category 'cmake source names') ----- nsspursrc + ^ (self topDir directoryNamed: 'nsspursrc')! - ^ 'nsspursrc'! Item was changed: + ----- Method: CPlatformConfigForSqueak>>nsspurstack64src (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>nsspurstack64src (in category 'cmake source names') ----- nsspurstack64src + ^ (self topDir directoryNamed: 'nsspurstack64src')! - ^ 'nsspurstack64src'! Item was changed: + ----- Method: CPlatformConfigForSqueak>>nsspurstacksrc (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>nsspurstacksrc (in category 'cmake source names') ----- nsspurstacksrc + ^ (self topDir directoryNamed: 'nsspurstacksrc')! - ^ 'nsspurstacksrc'! Item was changed: + ----- Method: CPlatformConfigForSqueak>>outputDir (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>outputDir (in category 'squeak compatability') ----- outputDir "the directory where built binaries will be stored" ^ outputDir ifNil: [ outputDir := (self topDir / self dirOutput / self dirBuildPlatform / self dirBuildLanguageVMMM / (buildType asString)) ] ! Item was changed: + ----- Method: CPlatformConfigForSqueak>>spur64src (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>spur64src (in category 'cmake source names') ----- spur64src + ^ (self topDir directoryNamed: 'spur64src')! - ^ 'spur64src'! Item was changed: + ----- Method: CPlatformConfigForSqueak>>spursistasrc (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>spursistasrc (in category 'cmake source names') ----- spursistasrc + ^ (self topDir directoryNamed: 'spursistasrc')! - ^ 'spursistasrc'! Item was changed: + ----- Method: CPlatformConfigForSqueak>>spursrc (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>spursrc (in category 'cmake source names') ----- spursrc + ^ (self topDir directoryNamed: 'spursrc')! - ^ 'spursrc'! Item was changed: + ----- Method: CPlatformConfigForSqueak>>spurstack64src (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>spurstack64src (in category 'cmake source names') ----- spurstack64src + ^ (self topDir directoryNamed: 'spurstack64src')! - ^ 'spurstack64src'! Item was changed: + ----- Method: CPlatformConfigForSqueak>>spurstacksrc (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>spurstacksrc (in category 'cmake source names') ----- spurstacksrc + ^ (self topDir directoryNamed: 'spurstacksrc')! - ^ 'spurstacksrc'! Item was changed: + ----- Method: CPlatformConfigForSqueak>>src (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>src (in category 'cmake source names') ----- src "where cog lives" + + ^ (self topDir directoryNamed: 'src')! - ^ 'src'! Item was changed: + ----- Method: CPlatformConfigForSqueak>>srcDir (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>srcDir (in category 'squeak compatability') ----- srcDir + "pharo legacy naming convention. used in some cmake scripts like 'directories.cmake' + + topDir=oscogvm + dirSource=[nsspur64src | nsspursrc |nsspurstack64src |nsspurstacksrc |spur64src |spursistasrc |spursrc | spurstack64src |spurstacksrc | src |stacksr] Configurations customize this + srcDir=oscogvm/dirSource + cogDir=oscogvm/src (needed by CMake for access to plugins source in oscogvm/src/plugins) + " + + ^ self dirSource + ! - self flag:'tty: srcDir is a pharo thing. Factor this out in favor of the dirSource for consistency'. - ^ srcDir ifNil: [ srcDir := (self topDir directoryNamed: (self dirSource) )]! Item was changed: + ----- Method: CPlatformConfigForSqueak>>stacksrc (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>stacksrc (in category 'cmake source names') ----- stacksrc + ^ (self topDir directoryNamed: 'stacksrc' ) + ! - ^ 'stacksrc'! Item was changed: + ----- Method: CPlatformConfigForSqueak>>topDir (in category 'cmake directory') ----- - ----- Method: CPlatformConfigForSqueak>>topDir (in category 'squeak compatability') ----- topDir + " topDir=oscogvm + dirSource=[nsspur64src | nsspursrc |nsspurstack64src |nsspurstacksrc |spur64src |spursistasrc |spursrc | spurstack64src |spurstacksrc | src |stacksr] Configurations customize this + srcDir=oscogvm/dirSource + cogDir=oscogvm/src (needed by CMake for access to plugins source in oscogvm/src/plugins) + " ^ topDir ifNil: [ topDir := FileDirectory default directoryNamed: self oscogvm ] ! Item was changed: ----- Method: SqueakMacintoshConfig>>cmakeWriteDirectoriesDotCmake: (in category 'cmake') ----- cmakeWriteDirectoriesDotCmake: aMaker |temp o| "We could put these inline, but other components include the directories.cmake file. So, we continue that convention" o := String new writeStream. temp := OrderedCollection new. temp addLast: ((CMakeSet new) variable: 'topDir' quotedValue: (self topDir fullName)); addLast: ((CMakeSet new) variable: 'buildDir' quotedValue: (self buildDir ifNil: ['${topDir}/build'] ifNotNil: [self buildDir fullName])); addLast: ((CMakeSet new) variable: 'thirdpartyDir' quotedValue: '${buildDir}/thirdParty'); addLast: ((CMakeSet new) variable: 'platformsDir' quotedValue: (self platformsDir)); + addLast: ((CMakeSet new) variable: 'srcDir' quotedValue: (self dirSource pathName)); "where the vm source directory lives" + addLast: ((CMakeSet new) variable: 'cogDir' quotedValue: (self cogDir pathName)); "oscogvm/src for historical reasons" + addLast: ((CMakeSet new) variable: 'srcPluginsDir' quotedValue: (pluginsDir ifNil: [ '${cogDir}/plugins' ])); "plugin source directory only in oscogvm/src/plugins" - addLast: ((CMakeSet new) variable: 'srcDir' quotedValue: (self srcDir pathName)); - addLast: ((CMakeSet new) variable: 'srcPluginsDir' quotedValue: (pluginsDir ifNil: [ '${srcDir}/plugins' ])); addLast: ((CMakeSet new) variable: 'srcVMDir' quotedValue: '${srcDir}/vm'); addLast: ((CMakeSet new) variable: 'platformName' quotedValue: (self platformName)); addLast: ((CMakeSet new) variable: 'targetPlatform' quotedValue: '${platformsDir}/${platformName}'); addLast: ((CMakeSet new) variable: 'crossDir' quotedValue: '${platformsDir}/Cross'); addLast: ((CMakeSet new) variable: 'platformVMDir' quotedValue: '${targetPlatform}/vm}'); addLast: ((CMakeSet new) variable: 'outputDir' quotedValue: (self outputDir fullName)); addLast: ((CMakeSet new) variable: 'externalModulesDir' quotedValue: (self externalModulesDir)). temp do: [:each | o nextPutAll: (each content); cr]. self write: (o contents) toFile: 'directories.cmake'. (enabledebugmessages) ifTrue:[ templates addLast:((CMakeMessage new) message: (self class name), ' setDirectories: aMaker' ) ]. templates addLast: ((CMakeInclude new) file: 'directories.cmake'). ! Item was changed: ----- Method: SqueakUnixConfig>>cmakeWriteDirectoriesDotCmake: (in category 'cmake') ----- cmakeWriteDirectoriesDotCmake: aMaker |temp o| "We could put these inline, but other components include the directories.cmake file. So, we continue that convention" - self flag: 'tty, aMaker never used'. o := String new writeStream. temp := OrderedCollection new. temp addLast: ((CMakeSet new) variable: 'topDir' quotedValue: (self topDir fullName)); addLast: ((CMakeSet new) variable: 'buildDir' quotedValue: (self buildDir ifNil: ['${topDir}/build'] ifNotNil: [self buildDir fullName])); addLast: ((CMakeSet new) variable: 'thirdpartyDir' quotedValue: '${buildDir}/thirdParty'); addLast: ((CMakeSet new) variable: 'platformsDir' quotedValue: (self platformsDir)); + addLast: ((CMakeSet new) variable: 'srcDir' quotedValue: (self dirSource pathName)); "where the vm source directory lives" + addLast: ((CMakeSet new) variable: 'cogDir' quotedValue: (self cogDir pathName)); "oscogvm/src for historical reasons" + addLast: ((CMakeSet new) variable: 'srcPluginsDir' quotedValue: (pluginsDir ifNil: [ '${cogDir}/plugins' ])); "plugin source directory only in oscogvm/src/plugins" - addLast: ((CMakeSet new) variable: 'srcDir' quotedValue: (self srcDir pathName)); - addLast: ((CMakeSet new) variable: 'srcPluginsDir' quotedValue: (pluginsDir ifNil: [ '${srcDir}/plugins' ])); addLast: ((CMakeSet new) variable: 'srcVMDir' quotedValue: '${srcDir}/vm'); addLast: ((CMakeSet new) variable: 'platformName' quotedValue: (self platformName)); addLast: ((CMakeSet new) variable: 'targetPlatform' quotedValue: '${platformsDir}/${platformName}'); addLast: ((CMakeSet new) variable: 'crossDir' quotedValue: '${platformsDir}/Cross'); addLast: ((CMakeSet new) variable: 'platformVMDir' quotedValue: '${targetPlatform}/vm}'); addLast: ((CMakeSet new) variable: 'outputDir' quotedValue: (self outputDir fullName)); addLast: ((CMakeSet new) variable: 'externalModulesDir' quotedValue: (self externalModulesDir)). temp do: [:each | o nextPutAll: (each content); cr]. self write: (o contents) toFile: 'directories.cmake'. (enabledebugmessages) ifTrue:[ templates addLast:((CMakeMessage new) message: (self class name), ' setDirectories: aMaker' ) ]. templates addLast: ((CMakeInclude new) file: 'directories.cmake'). ! Item was changed: ----- Method: SqueakWindowsConfig>>cmakeWriteDirectoriesDotCmake: (in category 'cmake') ----- cmakeWriteDirectoriesDotCmake: aMaker |temp o| "We could put these inline, but other components include the directories.cmake file. So, we continue that convention" o := String new writeStream. temp := OrderedCollection new. temp addLast: ((CMakeSet new) variable: 'topDir' quotedValue: (self topDir fullName)); addLast: ((CMakeSet new) variable: 'buildDir' quotedValue: (self buildDir ifNil: ['${topDir}/build'] ifNotNil: [self buildDir fullName])); addLast: ((CMakeSet new) variable: 'thirdpartyDir' quotedValue: '${buildDir}/thirdParty'); addLast: ((CMakeSet new) variable: 'platformsDir' quotedValue: (self platformsDir)); + addLast: ((CMakeSet new) variable: 'srcDir' quotedValue: (self dirSource pathName)); "where the vm source directory lives" + addLast: ((CMakeSet new) variable: 'cogDir' quotedValue: (self cogDir pathName)); "oscogvm/src for historical reasons" + addLast: ((CMakeSet new) variable: 'srcPluginsDir' quotedValue: (pluginsDir ifNil: [ '${cogDir}/plugins' ])); "plugin source directory only in oscogvm/src/plugins" - addLast: ((CMakeSet new) variable: 'srcDir' quotedValue: (self srcDir pathName)); - addLast: ((CMakeSet new) variable: 'srcPluginsDir' quotedValue: (pluginsDir ifNil: [ '${srcDir}/plugins' ])); addLast: ((CMakeSet new) variable: 'srcVMDir' quotedValue: '${srcDir}/vm'); addLast: ((CMakeSet new) variable: 'platformName' quotedValue: (self platformName)); addLast: ((CMakeSet new) variable: 'targetPlatform' quotedValue: '${platformsDir}/${platformName}'); addLast: ((CMakeSet new) variable: 'crossDir' quotedValue: '${platformsDir}/Cross'); addLast: ((CMakeSet new) variable: 'platformVMDir' quotedValue: '${targetPlatform}/vm}'); addLast: ((CMakeSet new) variable: 'outputDir' quotedValue: (self outputDir fullName)); addLast: ((CMakeSet new) variable: 'externalModulesDir' quotedValue: (self externalModulesDir)). temp do: [:each | o nextPutAll: (each content); cr]. self write: (o contents) toFile: 'directories.cmake'. (enabledebugmessages) ifTrue:[ templates addLast:((CMakeMessage new) message: (self class name), ' setDirectories: aMaker' ) ]. templates addLast: ((CMakeInclude new) file: 'directories.cmake'). !

1 0

VM Maker: CMakeVMMakerSqueak-tty.118.mcz
by commits＠source.squeak.org 29 May '16

29 May '16

Timothy M uploaded a new version of CMakeVMMakerSqueak to project VM Maker: http://source.squeak.org/VMMaker/CMakeVMMakerSqueak-tty.118.mcz ==================== Summary ==================== Name: CMakeVMMakerSqueak-tty.118 Author: tty Time: 15 May 2016, 4:48:25.554663 pm UUID: 04183695-e521-4f1a-a80a-c0d640b3f355 Ancestors: CMakeVMMakerSqueak-tty.117 This commit breaks the CMake generation, but there is a lot of other work I want commited. The addition of the various 'source directories' in addition to the old 'src' directory that originally existed for Cog ..i.e. spursrc, stacksrc...etc has introduced some complexity that has to be accounted for. I will think about this next, I just want to get the documentation work stored for now. =============== Diff against CMakeVMMakerSqueak-tty.117 =============== Item was changed: ----- Method: CMakeVMGeneratorForSqueak>>generateByTemplate (in category 'code generation') ----- generateByTemplate "attempt to move way from string based writing to template based. Think Seaside renderOn composition" | extPlugins intPlugins | self flag: 'tty'. "refactor so that the cascade reflects CMake terminilogy" output := String new writeStream. config templates: OrderedCollection new. config setGlobalOptions: self; cmakePrefixPath; cmakeIncludePath; cmakeLibraryPath; cmakeIncludeModules; cmakeCFlags; cmakeAddDefinitions; cmakeWriteDirectoriesDotCmake: self; cmakeIncludeDirectories: self; "<---" preferredIncludes; "<---why 3 of em?" standardIncludes; "<---" setGlobalOptionsAfterDetermineSystem: self; extraVMSettings: self; "<--catch-all method. os/platform specific" setCoreSources: self; setPlatformSources: self; setCrossSources: self; setExtraSources; cmakeSetSourceFilesProperties; cmakeListAppend:'LINKLIBS' elements: (config externalLibs); cmakeAddExecutableNameOptionSource: self; setExecutableOutputPath; addVMPlugins: self. config templates do: [:each | self puts: each content]. config templates: OrderedCollection new. extPlugins := self generatePluginConfigs: config internalPlugins internal: true. intPlugins := self generatePluginConfigs: config externalPlugins internal: false. self processThirdpartyLibraries. "<--unused in Pharo code? What exactly does this do?" self processPlugins: intPlugins, extPlugins. self config templates addLast:((CMakeCommand new) command:'target_link_libraries' params:(self moduleName , ' ${LINKLIBS}')). " self cmd: 'target_link_libraries' params: self moduleName , ' ${LINKLIBS}'." config postBuildActions: self.. config templates do: [:each | self puts: each content]. self saveFile. self generateBuildScript! Item was changed: ----- Method: CMakeVMMakerSqueakCommonConfigTest>>testSrcDir (in category 'as yet unclassified') ----- testSrcDir + "for each builder, make sure all its configurations provide a srcDir via their dirSource method " - "for each builder, make sure all its configurations provide a srcDir " #(#SqueakMacintoshConfig #SqueakUnixConfig #SqueakWindowsConfig) do:[:each | (Smalltalk at:each) allSubclassesDo:[:configuration | | o | o:= configuration basicNew. + (o excludeFromBuild not | configuration isAbstractBaseClass not) - (o excludeFromBuild not) | (configuration isAbstractBaseClass) ifTrue:[self assert:(o srcDir isKindOf: FileDirectory)]]] ! Item was added: + ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>dirBuildLanguageVMMM (in category 'pages') ----- + dirBuildLanguageVMMM + ^HelpTopic + title:'Specify dirBuildLanguageVMMM' + contents: + ' + SystemNavigation new browseAllImplementorsOf: #dirBuildLanguageVMMM localTo:CPlatformConfigForSqueak. + + We scroll down to our Linux64x86w32BitSqueakCogSpurConfig which we copied from the existing Linux64x86w32BitSqueakCogV3Config. + + Looking at the dirBuildLanguageVMMM it initially reads (due to the copying of the existing class) + + dirBuildLanguageVMMM + ^self squeakCogV3 + + Since this is a configuration for Squeak Cog Spur, I modify the method to return + + dirBuildLanguageVMMM + ^self squeakCogSpur + + + As a sanity check, I verify that the method squeakCogSpur exists... + + SystemNavigation new browseAllImplementorsOf: #squeakCogSpur + + And we see the method exists and will return the sting ''squeak.cog.spur''. + + '! Item was added: + ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>dirSource (in category 'pages') ----- + dirSource + ^HelpTopic + title:'Specify Source Directory' + contents: + ' + Eliot''s VMMaker.oscog package outputs c-source code to varios directories depending ont he vm type. + + SystemNavigation new browseAllImplementorsOf: #dirSource localTo:CPlatformConfigForSqueak. + + Evaluating the above, we see that the CPlatformConfigForSqueak lists the available source directories. + + The string values for these things are hard-coded in CPlatformConfigForSqueak in the ''cmake source names'' category. + + ToolSet browse: CPlatformConfigForSqueak category: ''cmake source names'' + + For our Linux64x86w32BitSqueakCogSpurConfig we choose ''spursrc'' as our dirSource return value + + dirSource + ^self spursrc + + which you can test here. + + (Linux64x86w32BitSqueakCogSpurConfig basicNew) dirSource + + '! Item was changed: ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>forTheImpatient (in category 'pages') ----- forTheImpatient ^HelpTopic title:'For the impatient' contents: 'Here is the TL;DR synopsis of the methods* I implemented or overrode in creating the Linux64x86w32BitSqueakCogSpurConfig. A step-by-step exposition begins on the next page. + dirBuildLanguageVMMM + specifyProductDirectories - cmakeCFlags cmakeAddDefinitions cmakeIncludePath cmakeLibraryPath compilerFlags cmakeAddDefinitions preferredIncludes setGlobalOptionsAfterDetermineSystem: cmakeSetSourceFilesProperties externalLibs cmakeAddExecutableNameOptionSource: customizeVMPlugins specifyingPlugins *If the method uses the Method Redirect Pattern then (in most instances) the method to modify will be for the buildType. ie. ''methodnameBuildType'' '! Item was changed: ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>pages (in category 'accessing') ----- pages + "I need the srcDir" ^#(overview tests identifyPlatform identifyPlatformAbstractBaseClass identifyBuilder createTheConfiguration excludingConfigFromBuilds setAvailableBuildTypes firstCMakeGeneration tackingStockOne cPlatformConfigForSqueak methodRedirectPattern theVMGenerator tackingStockTwo forTheImpatient + specifyDirectories setGlobalOptions cmakePrefixPath cmakeIncludePath cmakeLibraryPath cmakeIncludeModules cmakeCFlags cmakeAddDefinitions cmakeWriteDirectoriesDotCmake cmakeIncludeDirectories preferredIncludes standardIncludes setGlobalOptionsAfterDetermineSystem extraVMSettings setCoreSources setPlatformSources setCrossSources setExtraSources cmakeSetSourceFilesProperties cmakeListAppendLINKLIBSelements cmakeAddExecutableNameOptionSource setExecutableOutputPath addVMPlugins generatePluginConfigs + specifyPlugins - specifyingPlugins processThirdpartyLibraries processPlugins postBuildActions setConfigurationDirectory - setOutputDirectory compilingLinkingSetup customizeVMDrivers aNoteOnFoo ) ! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>setOutputDirectory (in category 'pages') ----- - setOutputDirectory - ^HelpTopic - title:'Set Output Directory' - contents: - 'The output directory is where the finished product is placed when the compilation is successful. - - Typically this is ''oscogvm/cmake.products/foo/ - - The topmost configuration CPlatformConfigForSqueak defines the output directory as such: - - outputDir - "the directory where built binaries will be stored" - ^ outputDir ifNil: [ outputDir := (self topDir / self dirOutput / self dirInstall) ] - - which (on linux) translates to ''oscogvm/cmaike.products/(subclass resposibility))'' - - Its that (subclass responsibility) we have to customize in our new configuration. - - The convention we use is [Language][VM][MemoryModel] - - Since I am building a Squeak Cog V3 configuration, my method should return "squeak.cog.v3" - - If you look at implementors of dirInstall, you will see that they typically return some pre-defined strings that are defined in the ''cmake directory'' protocol of CPlatformConfigForSqueak. - - For my configuration you can see that I return the "^self squeakCogV3" which returns the directory name that matches the [Language][VM][Memory Model] pattern I need. - - - - - '! Item was added: + ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>specifyDirectories (in category 'pages') ----- + specifyDirectories + ^HelpTopic + title:'Specify Directories' + contents: + 'Our new Configuration must correctly name two directory trees. + + The first is the cmake.build.* directory tree where the generated CMake output is placed. + The second is the cmake.products/* directory tree where the compiled vm is placed. + + + Correctly naming these is a courtesy you should extend as the system grows*. + + + For this particular Configuration, we want a cmake.build.* directory that looks like this: + + oscogvm/cmake.products/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur + + + and we want a cmake.products/* directory that looks like this: + + oscogvm/cmake.products/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur/build + + + Each directory in those trees is accessible viathe the CPlatformConfigForSqueak in the ''cmake directory'' category. + + ToolSet browseClass: CPlatformConfigForSqueak category: ''cmake directory''. + + There are two method variants. + + The first variant is hardcoded in the method itself. For example the platform directories are stored as... + + dirLinux32Armv6 + ^''cmake.build.linux32armv6'' + + or, for our configuration + + dirLinux64x86w32BitCompatibility + ^''cmake.build.linux64x86w32BitCompatibility'' + + The second variant accesses the name of a buildType directory via the SqueakCMakeVMMakerAbstractBuilder (do a printIt or doIt). + + dirBuild + ^SqueakCMakeVMMakerAbstractBuilder default buildTypeAndDirectoryInfo at: #build + + + + Each part of the directory tree is contained/accessible via these methods. It is our job to select the corect ones for our purposes. + + Here is an example of mapping this output directory path + ''oscogvm/cmake.products/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur/build'' + + to the methods that output each part. + + |c| + c:=(CPlatformConfigForSqueak basicNew). + (c oscogvm), ''/'', (c dirOutput), ''/'', (c dirLinux64x86w32BitCompatibility), ''/'', (c squeakCogSpur), ''/'', (c dirBuild) + + + The methods corresponding to each of the above directory names are: + + topDir + dirOutput + dirBuildPlatform + dirBuildLanguageVMMM + buildType (not a method,this is a private instance variable in the configuration) + + The first two, topDir and dirOutput are contained in CPlatformConfigForSqueak + dirBuildPlatform is contained at the platform level + + SystemNavigation new browseAllImplementorsOf: #dirBuildPlatform localTo:CPlatformConfigForSqueak. + + dirBuildLangaugeVMMM is at the specific Configuration level + SystemNavigation new browseAllImplementorsOf: #dirBuildLanguageVMMM localTo:CPlatformConfigForSqueak. + + buildType is set when we configure the Configuration for a particular buildType and is stored in the SqueakCMakeVMMakerAbstractBuilder at its initialization. + + SystemNavigation new browseAllImplementorsOf: #initializeBuildTypeAndDirectoryInfo + + It is this values that the CPlatformConfigForSqueak access via dirBuild, dirBuildAssert etc... + SystemNavigation new browseAllImplementorsOf: #dirBuild + + + Similarly, the build directory tree + ''oscogvm/cmake.build.linux64x86w32BitCompatibility/squeak.cog.spur/build/'' + + has methods corresponding to each of the above directory names. they are: + + topDir + dirBuildPlatform + dirBuildLanguageVMMM + buildType (not a method,this is a private instance variable in the configuration) + + It follows then, that for our Configuration we need to make the method dirBuildLanguageVMMM return ''squeak.cog.spur''. + + We cover that in the next Help page. + + + *The naming convention is straightforward and convered in the ''Naming Convetions'' page of the Developer Guide Overview Help. + + HelpBrowser openOn:CMakeVMMakerSqueakOverviewHelp + + '! Item was added: + ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>specifyPlugins (in category 'pages') ----- + specifyPlugins + ^HelpTopic + title:'Specify Plugins' + contents: + 'We can specify which plugins we want on our configuration by overriding our platform''s defaultExternalPlugins and defaultInternalPlugins methods. + + The default set can be further customized according to buildType if desired via the externalPlugins[BuildType] and internalPlugins[BuildType] redirect pattern + + We will cover only the internalPlugins scenario here. The methodology is exactly the same for externalPlugins. + + Let''s look first at the defaultInternalPlugins + + SystemNavigation browseAllImplementorsOf: #defaultInternalPlugins + + Looking at the Linux64x86w32BitConfigUsrLib we see that it just returns a default collection of class names. + + The defaultInternalPlugins message is typically sent from the internalPlugins[buildType] method. + + SystemNavigation browseAllImplementorsOf: #internalPlugins + + Here we see that CPlatformConfigForSqueak implements the message redirect pattern. + + SystemNavigation browseAllImplementorsOf: #internalPluginsBuild + + In CPlatformConfigForSqueak >> internalPluginsBuild forces subclasses to implement the method. + + Looking at + + SystemNavigation browseAllImplementorsOf: #internalPluginsBuildMultiThreadedDebug + we see the default is to return the default list provided in internalPluginsBuild. + + This enables configurations to customize their plugins with a good degree of granularity should we want to change the plugins we use based on buildType while keeping things simple in the default case. + + To summarize, a Configuration specifies what plugins it wants to build (either internal or external) by modifying or overriding the list of Plugin class names stored in defaultInternalPlugins or defaultExternalPlugins by overriding the internalPlugins[buildType] method or externalPlugins[buildType] method + + + + + + + + + + + + + + + + + + + + + + '! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>specifyingPlugins (in category 'pages') ----- - specifyingPlugins - ^HelpTopic - title:'Specifying Plugins' - contents: - 'We can specify which plugins we want on our configuration by overriding our platform''s defaultExternalPlugins and defaultInternalPlugins methods. - - The default set can be further customized according to buildType if desired via the externalPlugins[BuildType] and internalPlugins[BuildType] redirect pattern - - We will cover only the internalPlugins scenario here. The methodology is exactly the same for externalPlugins. - - Let''s look first at the defaultInternalPlugins - - SystemNavigation browseAllImplementorsOf: #defaultInternalPlugins - - Looking at the Linux64x86w32BitConfigUsrLib we see that it just returns a default collection of class names. - - The defaultInternalPlugins message is typically sent from the internalPlugins[buildType] method. - - SystemNavigation browseAllImplementorsOf: #internalPlugins - - Here we see that CPlatformConfigForSqueak implements the message redirect pattern. - - SystemNavigation browseAllImplementorsOf: #internalPluginsBuild - - In CPlatformConfigForSqueak >> internalPluginsBuild forces subclasses to implement the method. - - Looking at - - SystemNavigation browseAllImplementorsOf: #internalPluginsBuildMultiThreadedDebug - we see the default is to return the default list provided in internalPluginsBuild. - - This enables configurations to customize their plugins with a good degree of granularity should we want to change the plugins we use based on buildType while keeping things simple in the default case. - - To summarize, a Configuration specifies what plugins it wants to build (either internal or external) by modifying or overriding the list of Plugin class names stored in defaultInternalPlugins or defaultExternalPlugins by overriding the internalPlugins[buildType] method or externalPlugins[buildType] method - - - - - - - - - - - - - - - - - - - - - - '! Item was changed: ----- Method: CMakeVMakerConfigurationInfo>>visit: (in category 'visiting') ----- visit: aVisitor |v| "I am being visited by a CMakeVMMakerSqueak configuration class. Extract its information and store it in myself" self flag:'tty'. "why am I not storing the instances itself?does this visit stuff really make sense? I am thinking its 'lightweight'. hmmm" v:= aVisitor basicNew. + (v class isAbstractBaseClass) + ifFalse:[ + availableBuildTypes := v availableBuildTypes. + dirBuildPlatform := v dirBuildPlatform. + dirSource := v dirSource. + excludeFromBuild := v excludeFromBuild. + isAbstractBaseClass := (v class) isAbstractBaseClass]. - availableBuildTypes := v availableBuildTypes. - dirBuildPlatform := v dirBuildPlatform. - dirSource := v dirSource. - excludeFromBuild := v excludeFromBuild. - isAbstractBaseClass := (v class) isAbstractBaseClass. ! Item was removed: - ----- Method: CPlatformConfigForSqueak>>dirInstall (in category 'cmake directory') ----- - dirInstall - "the directory of the finished product.. the place where 'make install' puts stuff. - SystemNavigation default browseMethodsWhoseNamesContain: 'outputDir' - " - self subclassResponsibility - ! Item was changed: ----- Method: CPlatformConfigForSqueak>>dirSource (in category 'cmake directory') ----- dirSource + "Have your custom Configuration return the directory where the source files are. As of 2016.05.15 they are: + nsspur64src + nsspursrc + nsspurstack64src + nsspurstacksrc + spur64src + spursistasrc + spursrc + spurstack64src + spurstacksrc + src (cog.v3 lives here) + stacksrc" + + self subclassResponsibility + ! - ^'src'! Item was added: + ----- Method: CPlatformConfigForSqueak>>nsspur64src (in category 'cmake source names') ----- + nsspur64src + ^ 'nsspur64src'! Item was added: + ----- Method: CPlatformConfigForSqueak>>nsspursrc (in category 'cmake source names') ----- + nsspursrc + ^ 'nsspursrc'! Item was added: + ----- Method: CPlatformConfigForSqueak>>nsspurstack64src (in category 'cmake source names') ----- + nsspurstack64src + ^ 'nsspurstack64src'! Item was added: + ----- Method: CPlatformConfigForSqueak>>nsspurstacksrc (in category 'cmake source names') ----- + nsspurstacksrc + ^ 'nsspurstacksrc'! Item was changed: ----- Method: CPlatformConfigForSqueak>>outputDir (in category 'squeak compatability') ----- outputDir - "the directory where built binaries will be stored" + ^ outputDir ifNil: [ outputDir := (self topDir / self dirOutput / self dirBuildPlatform / self dirBuildLanguageVMMM / (buildType asString)) ] - ^ outputDir ifNil: [ outputDir := (self topDir / self dirOutput / self dirInstall) ] ! Item was added: + ----- Method: CPlatformConfigForSqueak>>spur64src (in category 'cmake source names') ----- + spur64src + ^ 'spur64src'! Item was added: + ----- Method: CPlatformConfigForSqueak>>spursistasrc (in category 'cmake source names') ----- + spursistasrc + ^ 'spursistasrc'! Item was added: + ----- Method: CPlatformConfigForSqueak>>spursrc (in category 'cmake source names') ----- + spursrc + ^ 'spursrc'! Item was added: + ----- Method: CPlatformConfigForSqueak>>spurstack64src (in category 'cmake source names') ----- + spurstack64src + ^ 'spurstack64src'! Item was added: + ----- Method: CPlatformConfigForSqueak>>spurstacksrc (in category 'cmake source names') ----- + spurstacksrc + ^ 'spurstacksrc'! Item was added: + ----- Method: CPlatformConfigForSqueak>>src (in category 'cmake source names') ----- + src + "where cog lives" + ^ 'src'! Item was changed: ----- Method: CPlatformConfigForSqueak>>srcDir (in category 'squeak compatability') ----- srcDir + self flag:'tty: srcDir is a pharo thing. Factor this out in favor of the dirSource for consistency'. + ^ srcDir ifNil: [ srcDir := (self topDir directoryNamed: (self dirSource) )]! - ^ srcDir ifNil: [ srcDir := (self topDir directoryNamed: 'src' )]! Item was added: + ----- Method: CPlatformConfigForSqueak>>stacksrc (in category 'cmake source names') ----- + stacksrc + ^ 'stacksrc'! Item was removed: - ----- Method: Linux32x86SqueakCogV3Config>>dirInstall (in category 'cmake') ----- - dirInstall - "the directory of the finished product.. the place where 'make install' puts stuff. - SystemNavigation default browseMethodsWhoseNamesContain: 'outputDir' - " - ^self squeakCogV3! Item was added: + ----- Method: Linux32x86SqueakCogV3Config>>dirSource (in category 'cmake') ----- + dirSource + ^self src! Item was changed: ----- Method: Linux64x86w32BitSqueakCogSpurConfig>>dirBuildLanguageVMMM (in category 'cmake') ----- dirBuildLanguageVMMM + ^self squeakCogSpur! - ^self squeakCogV3! Item was removed: - ----- Method: Linux64x86w32BitSqueakCogSpurConfig>>dirInstall (in category 'cmake') ----- - dirInstall - "the directory of the finished product.. the place where 'make install' puts stuff. - SystemNavigation default browseMethodsWhoseNamesContain: 'outputDir' - " - ^self squeakCogV3! Item was added: + ----- Method: Linux64x86w32BitSqueakCogSpurConfig>>dirSource (in category 'cmake') ----- + dirSource + ^self spursrc! Item was removed: - ----- Method: Linux64x86w32BitSqueakCogV3Config>>dirInstall (in category 'cmake') ----- - dirInstall - "the directory of the finished product.. the place where 'make install' puts stuff. - SystemNavigation default browseMethodsWhoseNamesContain: 'outputDir' - " - ^self squeakCogV3! Item was added: + ----- Method: Linux64x86w32BitSqueakCogV3Config>>dirSource (in category 'cmake') ----- + dirSource + ^self src! Item was changed: ----- Method: SqueakCMakeVMMakerAbstractBuilder>>availableBuildConfigurationsFor: (in category 'queries') ----- availableBuildConfigurationsFor: aCategoryName + "answer the CMakeVMakerSqueak configurations in a Smalltalk category that have not excluded themselves from being built." - "answer the CMakeVMakerSqueak configurations in a Smalltalk category that havenot excluded themselves from being built." " (((self configurationDictionary:aCategoryName) keys asSortedCollection) size = 0) ifTrue:[^((self configurationDictionary:aCategoryName) keys asSortedCollection) sort]." ^(((self configurationDictionary:aCategoryName) select: [:info| info value excludeFromBuild not ]) keys asSortedCollection) sort !

1 0

VM Maker: CMakeVMMakerSqueak-tty.117.mcz
by commits＠source.squeak.org 29 May '16

29 May '16

Timothy M uploaded a new version of CMakeVMMakerSqueak to project VM Maker: http://source.squeak.org/VMMaker/CMakeVMMakerSqueak-tty.117.mcz ==================== Summary ==================== Name: CMakeVMMakerSqueak-tty.117 Author: tty Time: 9 May 2016, 4:25:46.611767 pm UUID: 394b3acb-50cc-4183-9766-25a61433ad1b Ancestors: CMakeVMMakerSqueak-tty.116 Step by step new configuration help steps written. cmake . generates a build system with some inconsistencies that I will fix next. (ie. squeak.cog.spur writes to squeak.cog.v3 directory) and I will update the help so it is correct. processPlugins needs re-thinking.. the cmake.config file is included in CMakeLists.txt and it contains all the cmake decision code needed to generate a config.h Should there be a config.h in each plugin directory? or should plugins inject their own config.h directives into the CMakeLists.txt directly? Moved some of Ian's unix specific stuff down to the SqueakUnixConf . =============== Diff against CMakeVMMakerSqueak-tty.116 =============== Item was changed: ----- Method: CMakePluginGeneratorForSqueak>>configDotCameraPlugin (in category 'cmake commands') ----- configDotCameraPlugin ^'PLUGIN_REQUIRE_INCLUDE(V4L2 linux/videodev2.h /usr/include)'! Item was changed: ----- Method: CMakePluginGeneratorForSqueak>>configDotSocketPlugin (in category 'cmake commands') ----- configDotSocketPlugin ^' PLUGIN_FIND_LIBRARY(SOCKET socket) PLUGIN_FIND_LIBRARY(NSL nsl) '! Item was changed: ----- Method: CMakePluginGeneratorForSqueak>>initializeConfigDotCmakeFiles (in category 'initialize-release') ----- initializeConfigDotCmakeFiles + "simple hard-coded Dictionary keyed by plugin name containing the contents of a Plugin's config.cmake file. + is this true? Currently we are dumping the below into the master CMakeLists.txt file. Should it be in config.cmake? + Should each plugin have its own config.cmake in its subdirectory? + + Take a look at configDotCameraPlugin and the non-portable /usr/include therein. + + This has to be rethought and specified correctly. + + In PostBuildActions the config.cmake file is included in the CMakeLists.txt. + + config.cmake is not from pharo, it is from the original CMake work done by Ian. + + This leads me to speculate that each plugin should write its 'config.cmake' data into the config.cmake file. + This data should be configuration commands like config_define(THIS_THAT_ETC) + + Looking at configDotB3DAcceleratorPlugin this makes sense. + + + " - "simple hard-coded Dictionary keyed by plugin name containing the contents of a Plugin's config.cmake file" |d| + self flag:'tty. see this method comment.'. d:=Dictionary new. d at: #ADPCMCodecPlugin put: self configDotCmakeEmpty; at: #AioPlugin put: self configDotCmakeEmpty; at: #UnixAioPlugin put: self configDotCmakeEmpty; at: #B3DAcceleratorPlugin put: self configDotCmakeEmpty; at: #BMPReadWriterPlugin put: self configDotCmakeEmpty; at: #BalloonEngineBase put: self configDotCmakeEmpty; at: #BalloonEnginePlugin put: self configDotCmakeEmpty; at: #BalloonEngineSimulation put: self configDotCmakeEmpty; at: #BrokenPlugin put: self configDotCmakeEmpty; at: #CameraPlugin put: self configDotCmakeEmpty; at: #CroquetPlugin put: self configDotCmakeEmpty; at: #DSAPlugin put: self configDotCmakeEmpty; at: #DropPlugin put: self configDotCmakeEmpty; at: #FFIPlugin put: self configDotFilePlugin; at: #FFTPlugin put: self configDotCmakeEmpty; at: #FilePlugin put: self configDotFilePlugin; at: #FilePluginSimulator put: self configDotCmakeEmpty; at: #FloatArrayPlugin put: self configDotCmakeEmpty; at: #FloatMathPlugin put: self configDotCmakeEmpty; at: #FloatMathPluginSimulator put: self configDotCmakeEmpty; at: #IA32ABIPlugin put: self configDotCmakeEmpty; at: #IA32ABIPluginSimulator put: self configDotCmakeEmpty; at: #InflatePlugin put: self configDotCmakeEmpty; at: #DeflatePlugin put: self configDotCmakeEmpty; at: #JPEGReaderPlugin put: self configDotCmakeEmpty; at: #KlattSynthesizerPlugin put: self configDotCmakeEmpty; at: #Matrix2x3Plugin put: self configDotCmakeEmpty; at: #MiscPrimitivePlugin put: self configDotCmakeEmpty; at: #NewsqueakIA32ABIPlugin put: self configDotCmakeEmpty; at: #NewsqueakIA32ABIPluginAttic put: self configDotCmakeEmpty; at: #NewsqueakIA32ABIPluginSimulator put: self configDotCmakeEmpty; at: #OSProcessPlugin put: self configDotCmakeEmpty; at: #UnixOSProcessPlugin put: self configDotCmakeEmpty; at: #Win32OSProcessPlugin put: self configDotCmakeEmpty; at: #ScratchPlugin put: self configDotCmakeEmpty; at: #SecurityPlugin put: self configDotCmakeEmpty; at: #SlangTestPlugin put: self configDotCmakeEmpty; at: #SmartSyntaxInterpreterPlugin put: self configDotCmakeEmpty; at: #AsynchFilePlugin put: self configDotCmakeEmpty; at: #BitBltSimulation put: self configDotCmakeEmpty; at: #BitBltSimulator put: self configDotCmakeEmpty; at: #BochsIA32Plugin put: self configDotCmakeEmpty; at: #ClipboardExtendedPlugin put: self configDotCmakeEmpty; at: #FT2Plugin put: self configDotCmakeEmpty; at: #FileCopyPlugin put: self configDotCmakeEmpty; at: #GdbARMPlugin put: self configDotCmakeEmpty; at: #GeniePlugin put: self configDotCmakeEmpty; at: #HostWindowPlugin put: self configDotCmakeEmpty; at: #IOSPlugin put: self configDotCmakeEmpty; at: #ImmX11Plugin put: self configDotCmakeEmpty; at: #InternetConfigPlugin put: self configDotCmakeEmpty; at: #JPEGReadWriter2Plugin put: self configDotCmakeEmpty; at: #JoystickTabletPlugin put: self configDotCmakeEmpty; at: #LargeIntegersPlugin put: self configDotCmakeEmpty; at: #LocalePlugin put: self configDotCmakeEmpty; at: #MIDIPlugin put: self configDotCmakeEmpty; at: #MacMenubarPlugin put: self configDotCmakeEmpty; at: #Mpeg3Plugin put: self configDotCmakeEmpty; at: #ObjectiveCPlugin put: self configDotCmakeEmpty; at: #QuicktimePlugin put: self configDotCmakeEmpty; at: #RePlugin put: self configDotCmakeEmpty; at: #SerialPlugin put: self configDotCmakeEmpty; at: #SocketPlugin put: self configDotCmakeEmpty; at: #SoundPlugin put: self configDotCmakeEmpty; at: #TestOSAPlugin put: self configDotCmakeEmpty; at: #UUIDPlugin put: self configDotCmakeEmpty; at: #SmartSyntaxPluginSimulator put: self configDotCmakeEmpty; at: #SoundCodecPlugin put: self configDotCmakeEmpty; at: #SoundGenerationPlugin put: self configDotCmakeEmpty; at: #SqueakSSLPlugin put: self configDotCmakeEmpty; at: #StarSqueakPlugin put: self configDotCmakeEmpty; at: #SurfacePlugin put: self configDotCmakeEmpty; at: #ThreadedFFIPlugin put: self configDotCmakeEmpty; at: #ThreadedARMFFIPlugin put: self configDotCmakeEmpty; at: #ThreadedIA32FFIPlugin put: self configDotCmakeEmpty; at: #ThreadedPPCBEFFIPlugin put: self configDotCmakeEmpty; at: #UnicodePlugin put: self configDotCmakeEmpty; at: #VMProfileLinuxSupportPlugin put: self configDotCmakeEmpty; at: #VMProfileMacSupportPlugin put: self configDotCmakeEmpty; at: #WeDoPlugin put: self configDotCmakeEmpty; at: #XDisplayControlPlugin put: self configDotCmakeEmpty. ^d. ! Item was changed: ----- Method: CMakeVMGeneratorForSqueak>>generateByTemplate (in category 'code generation') ----- generateByTemplate "attempt to move way from string based writing to template based. Think Seaside renderOn composition" | extPlugins intPlugins | self flag: 'tty'. "refactor so that the cascade reflects CMake terminilogy" output := String new writeStream. config templates: OrderedCollection new. - self break. config setGlobalOptions: self; cmakePrefixPath; cmakeIncludePath; cmakeLibraryPath; cmakeIncludeModules; cmakeCFlags; cmakeAddDefinitions; cmakeWriteDirectoriesDotCmake: self; cmakeIncludeDirectories: self; "<---" preferredIncludes; "<---why 3 of em?" standardIncludes; "<---" setGlobalOptionsAfterDetermineSystem: self; extraVMSettings: self; "<--catch-all method. os/platform specific" setCoreSources: self; setPlatformSources: self; setCrossSources: self; setExtraSources; cmakeSetSourceFilesProperties; cmakeListAppend:'LINKLIBS' elements: (config externalLibs); cmakeAddExecutableNameOptionSource: self; setExecutableOutputPath; addVMPlugins: self. config templates do: [:each | self puts: each content]. config templates: OrderedCollection new. extPlugins := self generatePluginConfigs: config internalPlugins internal: true. intPlugins := self generatePluginConfigs: config externalPlugins internal: false. self processThirdpartyLibraries. "<--unused in Pharo code? What exactly does this do?" self processPlugins: intPlugins, extPlugins. self config templates addLast:((CMakeCommand new) command:'target_link_libraries' params:(self moduleName , ' ${LINKLIBS}')). " self cmd: 'target_link_libraries' params: self moduleName , ' ${LINKLIBS}'." config postBuildActions: self.. config templates do: [:each | self puts: each content]. self saveFile. self generateBuildScript! Item was changed: ----- Method: CMakeVMGeneratorForSqueak>>processPlugins: (in category 'as yet unclassified') ----- processPlugins: pluginGenerators | libs libDeps | + self flag:'tty think this trhough. Is it redundant? answer NO. This adds plugin information to the master CMakeLists.txt file. '. + self flag: 'tty: gen configDotCMake and gen configDotCmakeEmpty should be moved out of CMakePluginGeneratorForSqueak and placed in the wrapper for the Plugin itself. (can it be?)'. - self flag:'tty think this trhough. Is it redundant?'. libs := OrderedCollection new. libDeps := Dictionary new. pluginGenerators do: [:gen | gen doNotGenerate ifFalse: [ + self puts: (gen configDotCMake at: (gen plugin name) ifAbsent:[gen configDotCmakeEmpty]). "THIS COULD BE A BUG. ONLY FileCopyPlugin is returning ConfigDotFilePlugin data" - self puts: (gen configDotCMake at: (gen plugin name) ifAbsent:[gen configDotCmakeEmpty]). gen isInternal ifTrue: [ libs add: gen plugin moduleName ] ifFalse: [ "make main module to depend on external plugin, just to make sure it is built before main module built" self cmd: 'add_dependencies' params: config executableName, ' ' , gen plugin moduleName ]. gen externalDependencies ifNotEmpty: [ :deps | libDeps at: gen plugin moduleName put: (deps fold: [ :a :b | a, ' ', b ]) ]. self addSubdirectory: gen plugin moduleName ] ]. self cmd: 'target_link_libraries' params: config executableName , ' ' , (libs inject: '' into: [:res :ea | res, ' ' , ea ]). libDeps keysAndValuesDo: [ :moduleName :dependencies | self cmd: 'add_dependencies' params: moduleName, ' ', dependencies ]. self generateExportsH: libs.! Item was changed: ----- Method: CMakeVMGeneratorForSqueak>>processThirdpartyLibraries (in category 'as yet unclassified') ----- processThirdpartyLibraries self flag:'tty'. "This generate call must be transformed to generateByTemplateFor:" config thirdpartyLibs do: [:each | each generateFor: self ] ! Item was changed: ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>forTheImpatient (in category 'pages') ----- forTheImpatient ^HelpTopic title:'For the impatient' contents: + 'Here is the TL;DR synopsis of the methods* I implemented or overrode in creating the Linux64x86w32BitSqueakCogSpurConfig. - 'Here is the TL;DR synopsis of the methods I implemented or overrode in creating the Linux64x86w32BitSqueakCogSpurConfig. - For a step-by-step exposition please continue to the next page. + A step-by-step exposition begins on the next page. + + - TODO: Fill this in as you go cmakeCFlags cmakeAddDefinitions + cmakeIncludePath + cmakeLibraryPath + compilerFlags + cmakeAddDefinitions + preferredIncludes + setGlobalOptionsAfterDetermineSystem: + cmakeSetSourceFilesProperties + externalLibs + cmakeAddExecutableNameOptionSource: + customizeVMPlugins + specifyingPlugins + *If the method uses the Method Redirect Pattern then (in most instances) the method to modify will be for the buildType. ie. ''methodnameBuildType'' + '! Item was changed: ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>generatePluginConfigs (in category 'pages') ----- generatePluginConfigs ^HelpTopic title:'generatePluginConfigs' contents: + 'This method iterates over a collection of InterpreterPlugin subclasses and asks each class to populate itself with some basic information and write out its own CMakeLists.txt in a directory named after the plugin name. - 'This method iterates over a collection of InterpreterPlugin subclasses* and asks each class to populate itself with some basic information + The processing is a bit complicated, but the setup is easy. - generateFor: aCMakeVMGenerator internal: aBoolean + The collections of plugin classes are stored in our Configuration. We cover that next in Specifying Plugins'! - ^ aCMakeVMGenerator - generatePlugin: self - internal: aBoolean - extraRules: nil - - Then it - - CMakeVMGeneratorForSqueak generatePlugin: aPlugin internal: aBoolean extraRules: aBlock - " this method called back from plugin" - ^ CMakePluginGeneratorForSqueak new - generate: aPlugin for: self internal: aBoolean extraRules: aBlock - - Which ends up at - - CMakePluginGeneratorForSqueak >> generateByTemplate - - Here we see the familiar populating of CMakeTemplate and the writing of CMake output - - bash-4.2$ cat ADPCMCodecPlugin/CMakeLists.txt - message( "Adding internal plugin: ADPCMCodecPlugin") - set(pluginName "ADPCMCodecPlugin") - set(pluginSrc "${srcPluginsDir}/ADPCMCodecPlugin") - set(pluginCross "${crossDir}/plugins/ADPCMCodecPlugin") - set(pluginPlatform "${targetPlatform}/plugins/ADPCMCodecPlugin") - set(LINKLIBS ) - add_definitions(-DSQUEAK_BUILTIN_PLUGIN) - list( APPEND sources "${pluginSrc}/ADPCMCodecPlugin.c") - include_directories( ${pluginSrc} ${pluginCross} ${targetPlatform}/plugins/${pluginName}) - add_library(ADPCMCodecPlugin STATIC ${sources}) - set(linkFlags "${linkFlags} -m32") - set_property(TARGET ADPCMCodecPlugin PROPERTY LINK_FLAGS ${linkFlags}) - - IF(ADPCMCodecPlugin_dependencies) - ADD_DEPENDENCIES( ADPCMCodecPlugin ${ADPCMCodecPlugin_dependencies}) - ENDIF( ADPCMCodecPlugin_dependencies) - - - *Where those collections of plugin classes are stored in our Configuration. We cover that next in Specifying Plugins'! Item was changed: ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>pages (in category 'accessing') ----- pages ^#(overview tests identifyPlatform identifyPlatformAbstractBaseClass identifyBuilder createTheConfiguration excludingConfigFromBuilds setAvailableBuildTypes firstCMakeGeneration tackingStockOne cPlatformConfigForSqueak methodRedirectPattern theVMGenerator tackingStockTwo forTheImpatient setGlobalOptions cmakePrefixPath cmakeIncludePath cmakeLibraryPath cmakeIncludeModules cmakeCFlags cmakeAddDefinitions cmakeWriteDirectoriesDotCmake cmakeIncludeDirectories preferredIncludes standardIncludes setGlobalOptionsAfterDetermineSystem extraVMSettings setCoreSources setPlatformSources setCrossSources setExtraSources cmakeSetSourceFilesProperties cmakeListAppendLINKLIBSelements cmakeAddExecutableNameOptionSource setExecutableOutputPath addVMPlugins generatePluginConfigs specifyingPlugins processThirdpartyLibraries processPlugins + postBuildActions - setConfigurationDirectory setOutputDirectory compilingLinkingSetup customizeVMDrivers aNoteOnFoo ) ! Item was added: + ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>postBuildActions (in category 'pages') ----- + postBuildActions + ^HelpTopic + title:'postBuildActions:' + contents: + 'postBuildActions: implements the Method Redirect pattern. + + ToolSet browse: CPlatformConfigForSqueak selector: #postBuildActions: + + Since the configuration is configured for buildType: #build the method redirect pattern will redirect to + + SystemNavigation browseAllImplementorsOf: #postBuildActionsBuild: + + We see in CPlatformConfigForSqueak that a sublcass must implement it via ''self subclassResponsibility''. + + The platform Config SqueakUnixConfig implements this. It can be over-ridden or extended as needed. + + We have nothing new to do here. + '! Item was changed: ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>processPlugins (in category 'pages') ----- processPlugins ^HelpTopic title:'Process Plugins' contents: 'SystemNavigation browseAllImplementorsOf: #processPlugins: + This method is inhereted from the pharo code. I do not fully understand the reasoning behind it. I expect it will be refactored or rewritten. + See the method comment in + SystemNavigation browseAllImplementorsOf: #initializeConfigDotCmakeFiles + + Presently it does (at least) three things. + + First, it adds plugin information to the master CMakeLists.txt file typically the add_subdirectory(''PluginName'') cmake command. + + Second, it adds plugin information to the master CMakeLists.txt file from the CMakePluginGeneratorForSqueak>>configDotSomePluginName group of methods + + + SystemNavigation browseAllImplementorsOf: #configDotFilePlugin + + + Third it generates the sqNamedPrims.h file reproduced below. + + bash-4.2$ cat sqNamedPrims.h + /* This is automatically generated file using CVMMaker on 9 May 2016 2:26:20.906098 pm */ + extern sqExport vm_exports[]; + extern sqExport os_exports[]; + extern sqExport ADPCMCodecPlugin_exports []; + extern sqExport AsynchFilePlugin_exports []; + extern sqExport B2DPlugin_exports []; + extern sqExport BitBltPlugin_exports []; + extern sqExport BMPReadWriterPlugin_exports []; + extern sqExport CroquetPlugin_exports []; + extern sqExport ZipPlugin_exports []; + extern sqExport DropPlugin_exports []; + extern sqExport DSAPrims_exports []; + extern sqExport FFTPlugin_exports []; + extern sqExport FileCopyPlugin_exports []; + extern sqExport FilePlugin_exports []; + extern sqExport FloatArrayPlugin_exports []; + extern sqExport FloatMathPlugin_exports []; + extern sqExport JoystickTabletPlugin_exports []; + extern sqExport Klatt_exports []; + extern sqExport LargeIntegers_exports []; + extern sqExport Matrix2x3Plugin_exports []; + extern sqExport MIDIPlugin_exports []; + extern sqExport MiscPrimitivePlugin_exports []; + extern sqExport Mpeg3Plugin_exports []; + extern sqExport SecurityPlugin_exports []; + extern sqExport SerialPlugin_exports []; + extern sqExport SocketPlugin_exports []; + extern sqExport SoundCodecPrims_exports []; + extern sqExport SoundPlugin_exports []; + extern sqExport StarSqueakPlugin_exports []; + extern sqExport SurfacePlugin_exports []; + extern sqExport LocalePlugin_exports []; + + sqExport *pluginExports[] = { + vm_exports, + os_exports, + ADPCMCodecPlugin_exports, + AsynchFilePlugin_exports, + B2DPlugin_exports, + BitBltPlugin_exports, + BMPReadWriterPlugin_exports, + CroquetPlugin_exports, + ZipPlugin_exports, + DropPlugin_exports, + DSAPrims_exports, + FFTPlugin_exports, + FileCopyPlugin_exports, + FilePlugin_exports, + FloatArrayPlugin_exports, + FloatMathPlugin_exports, + JoystickTabletPlugin_exports, + Klatt_exports, + LargeIntegers_exports, + Matrix2x3Plugin_exports, + MIDIPlugin_exports, + MiscPrimitivePlugin_exports, + Mpeg3Plugin_exports, + SecurityPlugin_exports, + SerialPlugin_exports, + SocketPlugin_exports, + SoundCodecPrims_exports, + SoundPlugin_exports, + StarSqueakPlugin_exports, + SurfacePlugin_exports, + LocalePlugin_exports, + NULL + + + + + '! - write me..'! Item was changed: ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>processThirdpartyLibraries (in category 'pages') ----- processThirdpartyLibraries ^HelpTopic title:'Process Third Party Libraries' contents: 'SystemNavigation browseAllImplementorsOf: #processThirdpartyLibraries + I have no idea what this does. It exists in the pharo codebase. + + If I do figure out its utility, then the processing architecture will be similar or identical to the Plugin processing. + + i.e. Libraries will be represented by objects which will have the responsibility of generating ''stuff''. + + + + .'! - write me..'! Item was changed: ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>setExecutableOutputPath (in category 'pages') ----- setExecutableOutputPath + "This method was automatically generated. Edit it using:" + "a HelpBrowser edit: #setExecutableOutputPath" ^HelpTopic + title: 'setExecutableOutputPath' + contents: - title:'setExecutableOutputPath' - contents: 'SystemNavigation browseAllImplementorsOf: #setExecutableOutputPath We see that this is implemtented in CPlatformConfigForSqueak. It creates a CMakeSet object and sets the ''EXECUTABLE_OUTPUT_PATH'' variable to self outputDir SystemNavigation browseAllImplementorsOf: #outputDir + Which redirects to - This look customizable too, but I doubt we need it. + (CPlatformConfigForSqueak basicNew) outputDirName + + The #outputDir method is a legacy method from the pharo code. It should be factored out after the dependency on the pharo code is removed.!!' readStream nextChunkText! - '! Item was changed: ----- Method: CPlatformConfigForSqueak>>generateByTemplate (in category 'source generation') ----- generateByTemplate + self subclassResponsibility + ! - self - generatePluginsList; "informative list of plugins for end user" - generateLicense; "Squeak license" - generateUtilsCmake; "Ian's useful CMake macros. used extensivelly." - generatePluginsCmake; "Ian's CMake Plugins Processing" - generateVmBuildCmake; "Ian's CMake Build script" - generateVmConfigCmake; "Ian's config.cmake file used to generate gnu config.h" - generateVmConfigIn; "Ian's code, not sure what it does yet" - generateTestDoubleWordAlignmentC; "Ian's platform tests used in configuration" - generateTestDoubleWordOrderC; - generateTestLanginfoCodesetC. - ^ CMakeVMGeneratorForSqueak generateByTemplate: self ! Item was removed: - ----- Method: Linux32ARMv6Config>>postBuildActionsBuild: (in category 'cmake buildType redirects') ----- - postBuildActionsBuild: aMaker - "SystemNavigation default browseMethodsWhoseNamesContain: 'postBuildActionsBuild:'" - (aMaker config enabledebugmessages) - ifTrue:[ - aMaker config templates - addLast: ((CMakeMessage new) message: (self class name), ' postBuildActionsBuild' ) - ]. - ! Item was removed: - ----- Method: Linux32x86Config>>postBuildActionsBuild: (in category 'cmake buildType redirects') ----- - postBuildActionsBuild: aMaker - "SystemNavigation default browseMethodsWhoseNamesContain: 'postBuildActionsBuild:'" - (aMaker config enabledebugmessages) - ifTrue:[ - aMaker config templates - addLast: ((CMakeMessage new) message: (self class name), ' postBuildActionsBuild' ) - ]. - aMaker config templates - addLast: ((CMakeMessage new) message: 'postBuildActionsBuild: aMaker' ); - addLast:((CMakeCommand new) command:'include' params:'config.cmake'); "cmake --help-command include " - addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_DUPLICATES config_vars'); "cmake --help-command LIST" - addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.in ""'); "cmake --help-command FILE" - addLast:(CMakeAppendConfigHIn new); - addLast:((CMakeCommand new) command:'CONFIGURE_FILE' params:'${CMAKE_BINARY_DIR}/config.h.in ${CMAKE_BINARY_DIR}/config.h'); - addLast:((CMakeCommand new) command:'GET_CMAKE_PROPERTY' params:'tmp VARIABLES'); - addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_ITEM tmp tmp'); - addLast:((CMakeCommand new) command:'LIST' params:'SORT tmp'); - addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.status ""'); - addLast:(CMakeAppendConfigStatus new). - - ! Item was removed: - ----- Method: Linux64x64Config>>postBuildActionsBuild: (in category 'cmake buildType redirects') ----- - postBuildActionsBuild: aMaker - "SystemNavigation default browseMethodsWhoseNamesContain: 'postBuildActionsBuild:'" - (aMaker config enabledebugmessages) - ifTrue:[ - aMaker config templates - addLast: ((CMakeMessage new) message: (self class name), ' postBuildActionsBuild' ) - ]. - aMaker config templates - addLast: ((CMakeMessage new) message: 'postBuildActionsBuild: aMaker' ); - addLast:((CMakeCommand new) command:'include' params:'config.cmake'); "cmake --help-command include " - addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_DUPLICATES config_vars'); "cmake --help-command LIST" - addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.in ""'); "cmake --help-command FILE" - addLast:(CMakeAppendConfigHIn new); - addLast:((CMakeCommand new) command:'CONFIGURE_FILE' params:'${CMAKE_BINARY_DIR}/config.h.in ${CMAKE_BINARY_DIR}/config.h'); - addLast:((CMakeCommand new) command:'GET_CMAKE_PROPERTY' params:'tmp VARIABLES'); - addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_ITEM tmp tmp'); - addLast:((CMakeCommand new) command:'LIST' params:'SORT tmp'); - addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.status ""'); - addLast:(CMakeAppendConfigStatus new). - - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib>>postBuildActionsBuild: (in category 'cmake buildType redirects') ----- - postBuildActionsBuild: aMaker - "SystemNavigation default browseMethodsWhoseNamesContain: 'postBuildActionsBuild:'" - (aMaker config enabledebugmessages) - ifTrue:[ - aMaker config templates - addLast: ((CMakeMessage new) message: (self class name), ' postBuildActionsBuild' ) - ]. - aMaker config templates - addLast: ((CMakeMessage new) message: 'postBuildActionsBuild: aMaker' ); - addLast:((CMakeCommand new) command:'include' params:'config.cmake'); "cmake --help-command include " - addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_DUPLICATES config_vars'); "cmake --help-command LIST" - addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.in ""'); "cmake --help-command FILE" - addLast:(CMakeAppendConfigHIn new); - addLast:((CMakeCommand new) command:'CONFIGURE_FILE' params:'${CMAKE_BINARY_DIR}/config.h.in ${CMAKE_BINARY_DIR}/config.h'); - addLast:((CMakeCommand new) command:'GET_CMAKE_PROPERTY' params:'tmp VARIABLES'); - addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_ITEM tmp tmp'); - addLast:((CMakeCommand new) command:'LIST' params:'SORT tmp'); - addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.status ""'); - addLast:(CMakeAppendConfigStatus new). - - ! Item was removed: - ----- Method: Linux64x86w32BitConfigUsrLib32>>postBuildActionsBuild: (in category 'cmake buildType redirects') ----- - postBuildActionsBuild: aMaker - "SystemNavigation default browseMethodsWhoseNamesContain: 'postBuildActionsBuild:'" - (aMaker config enabledebugmessages) - ifTrue:[ - aMaker config templates - addLast: ((CMakeMessage new) message: (self class name), ' postBuildActionsBuild' ) - ]. - aMaker config templates - addLast: ((CMakeMessage new) message: 'postBuildActionsBuild: aMaker' ); - addLast:((CMakeCommand new) command:'include' params:'config.cmake'); "cmake --help-command include " - addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_DUPLICATES config_vars'); "cmake --help-command LIST" - addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.in ""'); "cmake --help-command FILE" - addLast:(CMakeAppendConfigHIn new); - addLast:((CMakeCommand new) command:'CONFIGURE_FILE' params:'${CMAKE_BINARY_DIR}/config.h.in ${CMAKE_BINARY_DIR}/config.h'); - addLast:((CMakeCommand new) command:'GET_CMAKE_PROPERTY' params:'tmp VARIABLES'); - addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_ITEM tmp tmp'); - addLast:((CMakeCommand new) command:'LIST' params:'SORT tmp'); - addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.status ""'); - addLast:(CMakeAppendConfigStatus new). - - ! Item was removed: - ----- Method: SqueakBSD32x86Config>>postBuildActionsBuild: (in category 'cmake buildType redirects') ----- - postBuildActionsBuild: aMaker - "SystemNavigation default browseMethodsWhoseNamesContain: 'postBuildActionsBuild:'" - (aMaker config enabledebugmessages) - ifTrue:[ - aMaker config templates - addLast: ((CMakeMessage new) message: (self class name), ' postBuildActionsBuild' ) - ]. - aMaker config templates - addLast: ((CMakeMessage new) message: 'postBuildActionsBuild: aMaker' ); - addLast:((CMakeCommand new) command:'include' params:'config.cmake'); "cmake --help-command include " - addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_DUPLICATES config_vars'); "cmake --help-command LIST" - addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.in ""'); "cmake --help-command FILE" - addLast:(CMakeAppendConfigHIn new); - addLast:((CMakeCommand new) command:'CONFIGURE_FILE' params:'${CMAKE_BINARY_DIR}/config.h.in ${CMAKE_BINARY_DIR}/config.h'); - addLast:((CMakeCommand new) command:'GET_CMAKE_PROPERTY' params:'tmp VARIABLES'); - addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_ITEM tmp tmp'); - addLast:((CMakeCommand new) command:'LIST' params:'SORT tmp'); - addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.status ""'); - addLast:(CMakeAppendConfigStatus new). - - ! Item was removed: - ----- Method: SqueakIOSConfig>>postBuildActionsBuild: (in category 'cmake buildType redirects') ----- - postBuildActionsBuild: aMaker - "N.B. tty. This code was copied from Pharo code and converted to templates. Do not assume output it is complete or correct." - " override to add custom rules after all targets is defined " - self write: self fixLibsTemplate toFile: 'fix_libs.cmake'. - - aMaker config templates - addLast:((CMakeSet new) variable:#bundlePath value: '${outputDir}/', self executableName, '.app'); "no clue what these are. tty" - addLast:((CMakeSet new) variable: #pluginsRelPath value: '@executable_path/Plugins'); - addLast:(CMakeIOSInstallCode new). - - " FILE(GLOB_RECURSE bLibs /${externalModulesDir}/*.*) - "! Item was removed: - ----- Method: SqueakSunOS32x86Config>>postBuildActionsBuild: (in category 'cmake buildType redirects') ----- - postBuildActionsBuild: aMaker - "SystemNavigation default browseMethodsWhoseNamesContain: 'postBuildActionsBuild:'" - (aMaker config enabledebugmessages) - ifTrue:[ - aMaker config templates - addLast: ((CMakeMessage new) message: (self class name), ' postBuildActionsBuild' ) - ]. - aMaker config templates - addLast: ((CMakeMessage new) message: 'postBuildActionsBuild: aMaker' ); - addLast:((CMakeCommand new) command:'include' params:'config.cmake'); "cmake --help-command include " - addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_DUPLICATES config_vars'); "cmake --help-command LIST" - addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.in ""'); "cmake --help-command FILE" - addLast:(CMakeAppendConfigHIn new); - addLast:((CMakeCommand new) command:'CONFIGURE_FILE' params:'${CMAKE_BINARY_DIR}/config.h.in ${CMAKE_BINARY_DIR}/config.h'); - addLast:((CMakeCommand new) command:'GET_CMAKE_PROPERTY' params:'tmp VARIABLES'); - addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_ITEM tmp tmp'); - addLast:((CMakeCommand new) command:'LIST' params:'SORT tmp'); - addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.status ""'); - addLast:(CMakeAppendConfigStatus new). - - ! Item was added: + ----- Method: SqueakUnixConfig>>generateByTemplate (in category 'source generation') ----- + generateByTemplate + self flag:'tty: will need this in non-unix platforms'. + self + generatePluginsList; "informative list of plugins for end user" + generateLicense; "Squeak license" + generateUtilsCmake; "Ian's useful CMake macros. used extensivelly." + generatePluginsCmake; "Ian's CMake Plugins Processing" + generateVmBuildCmake; "Ian's CMake Build script" + generateVmConfigCmake; "Ian's config.cmake file used to generate gnu config.h" + generateVmConfigIn; "Ian's code, not sure what it does yet" + generateTestDoubleWordAlignmentC; "Ian's platform tests used in configuration" + generateTestDoubleWordOrderC; + generateTestLanginfoCodesetC. + ^ CMakeVMGeneratorForSqueak generateByTemplate: self ! Item was added: + ----- Method: SqueakUnixConfig>>postBuildActionsBuild: (in category 'cmake buildType redirects') ----- + postBuildActionsBuild: aMaker + "SystemNavigation default browseMethodsWhoseNamesContain: 'postBuildActionsBuild:'" + (aMaker config enabledebugmessages) + ifTrue:[ + aMaker config templates + addLast: ((CMakeMessage new) message: (self class name), ' postBuildActionsBuild' ) + ]. + aMaker config templates + addLast: ((CMakeMessage new) message: 'postBuildActionsBuild: aMaker' ); + addLast:((CMakeCommand new) command:'include' params:'config.cmake'); "cmake --help-command include " + addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_DUPLICATES config_vars'); "cmake --help-command LIST" + addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.in ""'); "cmake --help-command FILE" + addLast:(CMakeAppendConfigHIn new); + addLast:((CMakeCommand new) command:'CONFIGURE_FILE' params:'${CMAKE_BINARY_DIR}/config.h.in ${CMAKE_BINARY_DIR}/config.h'); + addLast:((CMakeCommand new) command:'GET_CMAKE_PROPERTY' params:'tmp VARIABLES'); + addLast:((CMakeCommand new) command:'LIST' params:'REMOVE_ITEM tmp tmp'); + addLast:((CMakeCommand new) command:'LIST' params:'SORT tmp'); + addLast:((CMakeCommand new) command:'FILE' params:'WRITE ${CMAKE_BINARY_DIR}/config.h.status ""'); + addLast:(CMakeAppendConfigStatus new). + + !

1 0

VM Maker: CMakeVMMakerSqueak-tty.116.mcz
by commits＠source.squeak.org 29 May '16

29 May '16

Timothy M uploaded a new version of CMakeVMMakerSqueak to project VM Maker: http://source.squeak.org/VMMaker/CMakeVMMakerSqueak-tty.116.mcz ==================== Summary ==================== Name: CMakeVMMakerSqueak-tty.116 Author: tty Time: 1 May 2016, 4:22:32.476697 pm UUID: 9f5266b1-3458-47a3-b550-24cdc055ab78 Ancestors: CMakeVMMakerSqueak-tty.115 stage save. Almost done with the step-by-step guide to creating a new configuration. =============== Diff against CMakeVMMakerSqueak-tty.115 =============== Item was changed: ----- Method: CMakeVMGeneratorForSqueak>>processPlugins: (in category 'as yet unclassified') ----- processPlugins: pluginGenerators | libs libDeps | + self flag:'tty think this trhough. Is it redundant?'. libs := OrderedCollection new. libDeps := Dictionary new. pluginGenerators do: [:gen | gen doNotGenerate ifFalse: [ self puts: (gen configDotCMake at: (gen plugin name) ifAbsent:[gen configDotCmakeEmpty]). gen isInternal ifTrue: [ libs add: gen plugin moduleName ] ifFalse: [ "make main module to depend on external plugin, just to make sure it is built before main module built" self cmd: 'add_dependencies' params: config executableName, ' ' , gen plugin moduleName ]. gen externalDependencies ifNotEmpty: [ :deps | libDeps at: gen plugin moduleName put: (deps fold: [ :a :b | a, ' ', b ]) ]. self addSubdirectory: gen plugin moduleName ] ]. self cmd: 'target_link_libraries' params: config executableName , ' ' , (libs inject: '' into: [:res :ea | res, ' ' , ea ]). libDeps keysAndValuesDo: [ :moduleName :dependencies | self cmd: 'add_dependencies' params: moduleName, ' ', dependencies ]. self generateExportsH: libs.! Item was changed: ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>addVMPlugins (in category 'pages') ----- addVMPlugins ^HelpTopic title:'addVMPlugins' contents: + 'addVMPlugins depends on custom configuration provided in our Configuration; the method depends on three other methods as described below + + VMPlugins are similar to built-in plugins yet are critical for running squeak on particular systems. + + The CMake configuration data needed for building them is encapsulated in sublcasses of CMakeVMPlugin. + + CMakeVMPlugin browseHierarchy + + You see that they are predominantly display and sound drivers. + + The process of customization ''starts'' in the initialze method of CPlatformConfigForSqueak + + ToolSet browse: CPlatformConfigForSqueak selector: #initialize + + In CPlatformConfigForSqueak>>initializeVMDrivers an OrderedCollection of CMakeVMPlugin subclasses are initialzed and stored. This collection is the universe of possible vm plugins. + + In our custom Configuration, we need a subset of that universe. The CPlatformConfigForSqueak>>customizeVMDrivers forces this with a ''self subclassResponsibility'' + + In our new Configuration we have this method already as we copied from an existing Configuration + + ToolSet browse: Linux64x86w32BitConfigUsrLib selector: #customizeVMPlugins + + We see that the code selects specific vm plugin templates from the universe of available ones and then customizes each one. + + Taking Linux64x86w32BitConfigUsrLib>>customizeCMakeVMDisplayNull as an example... + + ToolSet browse: Linux64x86w32BitConfigUsrLib selector: #customizeCMakeVMDisplayNull + + We see that we set the sources, compiler definitions, flags, external libraries, linker flags and include directories needed to compile the vm plugin here. + + So, if we have trouble with a vm plugin, we need to look in its customzeCMakeVMXYZ method and fix it there. + + These configurations are extracted from our Configuration and written out to that vm plugins directory and placed in its CMakeLists.txt file. + + Here is an example of the CMakeLists.txt file for the vm-display-null plugin + + bash-4.2$ cat oscogvm/cmake.build.linux64x86w32BitCompatibility/squeak.cog.v3/build/vm-display-null/CMakeLists.txt + # This is automatically generated file using Linux64x86w32BitSqueakCogSpurConfig on 1 May 2016 8:40:02.153261 am + project (vm-display-null) + cmake_minimum_required(VERSION 2.8.12) + include (/home/wm/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/cmake.build.linux64x86w32BitCompatibility/squeak.cog.v3/build/directories.cmake) + add_definitions(-DNDEBUG -DDEBUGVM=0 -DLSB_FIRST=1 -D_GNU_SOURCE -D_FILE_OFFSET_BITS=64 -DCOGMTVM=0) + add_definitions(-w -m32 -msse2 -O1) + add_definitions(-fPIC -DPIC) + set(sources ${targetPlatform}/vm-display-null/sqUnixDisplayNull) + add_library(vm-display-null SHARED ${sources}) + include_directories( ${crossDir}/plugins/FilePlugin ${targetPlatform}/plugins/B3DAcceleratorPlugin ${crossDir}/plugins/B3DAcceleratorPlugin) + set(LIBRARY_OUTPUT_PATH "/home/wm/usr/src/smalltalk/CMake.oscog/cogspurVMMaker/oscogvm/cmake.products/squeak.cog.v3") + target_link_libraries(vm-display-null ${LINKLIBS}) + set_target_properties(vm-display-null PROPERTIES PREFIX "" SUFFIX "" LINK_FLAGS "-w -m32 -msse2 -O1") + + + To modify the above output, we modify our Configuration''s customizeCMakeVMXyz methods . + To add or remove a vm-plugin from our configuration, we edit the customizeVMPlugins method. + To expand the universe of available vm plugins, we modify the CMakeConfigForSqueak >>initializeVMDrivers method. + + - ' '! Item was added: + ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>generatePluginConfigs (in category 'pages') ----- + generatePluginConfigs + ^HelpTopic + title:'generatePluginConfigs' + contents: + 'This method iterates over a collection of InterpreterPlugin subclasses* and asks each class to populate itself with some basic information + + generateFor: aCMakeVMGenerator internal: aBoolean + + ^ aCMakeVMGenerator + generatePlugin: self + internal: aBoolean + extraRules: nil + + Then it + + CMakeVMGeneratorForSqueak generatePlugin: aPlugin internal: aBoolean extraRules: aBlock + " this method called back from plugin" + ^ CMakePluginGeneratorForSqueak new + generate: aPlugin for: self internal: aBoolean extraRules: aBlock + + Which ends up at + + CMakePluginGeneratorForSqueak >> generateByTemplate + + Here we see the familiar populating of CMakeTemplate and the writing of CMake output + + bash-4.2$ cat ADPCMCodecPlugin/CMakeLists.txt + message( "Adding internal plugin: ADPCMCodecPlugin") + set(pluginName "ADPCMCodecPlugin") + set(pluginSrc "${srcPluginsDir}/ADPCMCodecPlugin") + set(pluginCross "${crossDir}/plugins/ADPCMCodecPlugin") + set(pluginPlatform "${targetPlatform}/plugins/ADPCMCodecPlugin") + set(LINKLIBS ) + add_definitions(-DSQUEAK_BUILTIN_PLUGIN) + list( APPEND sources "${pluginSrc}/ADPCMCodecPlugin.c") + include_directories( ${pluginSrc} ${pluginCross} ${targetPlatform}/plugins/${pluginName}) + add_library(ADPCMCodecPlugin STATIC ${sources}) + set(linkFlags "${linkFlags} -m32") + set_property(TARGET ADPCMCodecPlugin PROPERTY LINK_FLAGS ${linkFlags}) + + IF(ADPCMCodecPlugin_dependencies) + ADD_DEPENDENCIES( ADPCMCodecPlugin ${ADPCMCodecPlugin_dependencies}) + ENDIF( ADPCMCodecPlugin_dependencies) + + + *Where those collections of plugin classes are stored in our Configuration. We cover that next in Specifying Plugins'! Item was changed: ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>pages (in category 'accessing') ----- pages ^#(overview tests identifyPlatform identifyPlatformAbstractBaseClass identifyBuilder createTheConfiguration excludingConfigFromBuilds setAvailableBuildTypes firstCMakeGeneration tackingStockOne cPlatformConfigForSqueak methodRedirectPattern theVMGenerator tackingStockTwo forTheImpatient setGlobalOptions cmakePrefixPath cmakeIncludePath cmakeLibraryPath cmakeIncludeModules cmakeCFlags cmakeAddDefinitions cmakeWriteDirectoriesDotCmake cmakeIncludeDirectories preferredIncludes standardIncludes setGlobalOptionsAfterDetermineSystem extraVMSettings setCoreSources setPlatformSources setCrossSources setExtraSources cmakeSetSourceFilesProperties cmakeListAppendLINKLIBSelements cmakeAddExecutableNameOptionSource setExecutableOutputPath addVMPlugins + generatePluginConfigs + specifyingPlugins + processThirdpartyLibraries + processPlugins + + setConfigurationDirectory setOutputDirectory - settingPlugins compilingLinkingSetup customizeVMDrivers + - customizePlugins aNoteOnFoo ) + ! - " ^#(overview - tests - identifyPlatform - identifyPlatformAbstractBaseClass - identifyBuilder - createTheConfiguration - excludingConfigFromBuilds - setAvailableBuildTypes - firstCMakeGeneration - theVMGenerator - reviewMethodRedirectPattern - setOutputDirectory - settingPlugins - compilingLinkingSetup - customizeVMDrivers - customizePlugins - aNoteOnFoo - )"! Item was added: + ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>processPlugins (in category 'pages') ----- + processPlugins + ^HelpTopic + title:'Process Plugins' + contents: + 'SystemNavigation browseAllImplementorsOf: #processPlugins: + + write me..'! Item was added: + ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>processThirdpartyLibraries (in category 'pages') ----- + processThirdpartyLibraries + ^HelpTopic + title:'Process Third Party Libraries' + contents: + 'SystemNavigation browseAllImplementorsOf: #processThirdpartyLibraries + + write me..'! Item was removed: - ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>settingPlugins (in category 'pages') ----- - settingPlugins - ^HelpTopic - title:'Setting Plugins' - contents: - 'Write Me.'! Item was added: + ----- Method: CMakeVMMakerSqueakStepByStepNewConfigurationHelp class>>specifyingPlugins (in category 'pages') ----- + specifyingPlugins + ^HelpTopic + title:'Specifying Plugins' + contents: + 'We can specify which plugins we want on our configuration by overriding our platform''s defaultExternalPlugins and defaultInternalPlugins methods. + + The default set can be further customized according to buildType if desired via the externalPlugins[BuildType] and internalPlugins[BuildType] redirect pattern + + We will cover only the internalPlugins scenario here. The methodology is exactly the same for externalPlugins. + + Let''s look first at the defaultInternalPlugins + + SystemNavigation browseAllImplementorsOf: #defaultInternalPlugins + + Looking at the Linux64x86w32BitConfigUsrLib we see that it just returns a default collection of class names. + + The defaultInternalPlugins message is typically sent from the internalPlugins[buildType] method. + + SystemNavigation browseAllImplementorsOf: #internalPlugins + + Here we see that CPlatformConfigForSqueak implements the message redirect pattern. + + SystemNavigation browseAllImplementorsOf: #internalPluginsBuild + + In CPlatformConfigForSqueak >> internalPluginsBuild forces subclasses to implement the method. + + Looking at + + SystemNavigation browseAllImplementorsOf: #internalPluginsBuildMultiThreadedDebug + we see the default is to return the default list provided in internalPluginsBuild. + + This enables configurations to customize their plugins with a good degree of granularity should we want to change the plugins we use based on buildType while keeping things simple in the default case. + + To summarize, a Configuration specifies what plugins it wants to build (either internal or external) by modifying or overriding the list of Plugin class names stored in defaultInternalPlugins or defaultExternalPlugins by overriding the internalPlugins[buildType] method or externalPlugins[buildType] method + + + + + + + + + + + + + + + + + + + + + + '! Item was changed: ----- Method: Linux64x86w32BitConfigUsrLib>>customizeVMPlugins (in category 'plugins') ----- customizeVMPlugins |mysubset iwantonly| + self flag: 'tty: consider pushing up to platform level on refactor'. "trim the vmdrivers ordered collection of CMakeVMDriver subclasses to only those I want. then customize them for use on this OS/platform" iwantonly := #(#CMakeVMDisplayNull #CMakeVMDisplayX11 #CMakeVMSoundALSA #CMakeVMSoundNull ). mysubset := vmplugins select: [:vmd | 0 < (iwantonly occurrencesOf: (vmd class name) asSymbol)]. vmplugins := mysubset. self customizeCMakeVMDisplayNull; customizeCMakeVMDisplayX11; customizeCMakeVMSoundALSA; customizeCMakeVMSoundNull. ! Item was changed: ----- Method: Linux64x86w32BitConfigUsrLib32>>addVMPluginsBuild: (in category 'cmake buildType redirects') ----- addVMPluginsBuild: aMaker |temp o| self flag:'tty'. "I am writing sub-directory CMakeLists.txt here. Should I also write the config.cmake files?" enabledebugmessages ifTrue: [templates "this message will go to the top level CMakeLists.txt file" addLast: (CMakeMessage new message: self class name , 'addVMPluginsBuild: aMaker')]. vmplugins do:[ :vmp | o := String new writeStream. "each VMPlugin gets its own CMakeLists.txt file in its own directory" temp := OrderedCollection new. temp addAllLast:((CMakePluginVm new) "this is the CMakeCompositTemplate" config: self definitions: (vmp compilerdefinitions) module: (vmp module) sources: (vmp sources) includedirectories: (vmp includedirectories)). temp do: [:each | o nextPutAll: (each content); cr]. ((self buildDir) directoryExists: (vmp module)) ifFalse:[ (self buildDir) createDirectory: (vmp module)]. self write: (o contents) toFile: vmp module , FileDirectory slash , aMaker outputFileName. templates "this will go to the top level CMakeLists.txt file" addLast: ((CMakeAddSubDirectory new) sourcedir: (vmp module)) ]. !

1 0

Jump to page:

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

Vm-dev May 2016