mirror of
https://github.com/BepInEx/mono.git
synced 2026-11-16 11:21:08 -10:00
Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
6bf3922f3f | ||
|
|
7f6c3ef15b | ||
|
|
30441ea0ac | ||
|
|
835a98d855 | ||
|
|
bbd88d02b2 | ||
|
|
1eac626536 | ||
|
|
33652b57eb | ||
|
|
3f39812cb9 | ||
|
|
da1e498884 | ||
|
|
38502063ca | ||
|
|
3c3e692887 | ||
|
|
ab882c0c3d | ||
|
|
9a93d3e51a | ||
|
|
3e771b512a | ||
|
|
7344771071 | ||
|
|
bb9f666858 | ||
|
|
9c9140bb72 | ||
|
|
267896c45d | ||
|
|
ba2e556947 | ||
|
|
cb1747a70c | ||
|
|
2057307374 | ||
|
|
ba9ca156ea | ||
|
|
c7ec6a03ae | ||
|
|
c8921a6394 | ||
|
|
9aa78573ee | ||
|
|
3f5fd4287b | ||
|
|
253f2e9b27 | ||
|
|
e70439f186 | ||
|
|
4f8a31840c | ||
|
|
1359c52fc6 | ||
|
|
ce89e4c5fa | ||
|
|
9bd33ec5b6 | ||
|
|
63e8dc6ea1 | ||
|
|
e65bf00e22 | ||
|
|
8f0589ae81 | ||
|
|
ab20369d5f | ||
|
|
3a134a2d8c | ||
|
|
2e775c7e39 | ||
|
|
a9a4166431 | ||
|
|
feba66a6ce | ||
|
|
6fc6ca1e18 | ||
|
|
7332690826 | ||
|
|
b64faae88c | ||
|
|
b3b0613ad3 | ||
|
|
ddeba6e1ba | ||
|
|
0360f420fe | ||
|
|
2f18e7dd23 | ||
|
|
0f53cb275c | ||
|
|
c5cd0f1e7f | ||
|
|
44bf3d084e | ||
|
|
ceab9d932c | ||
|
|
104eeba2ea | ||
|
|
f0f0ae1564 | ||
|
|
2b469fb836 | ||
|
|
2a3c5024f2 | ||
|
|
ef5b3b4663 | ||
|
|
b070dc3279 | ||
|
|
b06c50f391 | ||
|
|
a228b7348f | ||
|
|
856d9754fb | ||
|
|
efce3b256a | ||
|
|
ce9bf964bf | ||
|
|
2cc0f9029a | ||
|
|
2e5b14333c | ||
|
|
bb8ffa5d1c | ||
|
|
e64491027f | ||
|
|
4d69127d9e | ||
|
|
97bdff44d4 | ||
|
|
636b05f1d1 | ||
|
|
362293581d | ||
|
|
2cffc7014c | ||
|
|
bec9f13d05 | ||
|
|
916b2cd1d9 | ||
|
|
f60a0a2e67 | ||
|
|
1d891bf6d1 | ||
|
|
a3fb0a1208 | ||
|
|
eade041bfd | ||
|
|
1ce0cc6e4e | ||
|
|
814e9dd0db | ||
|
|
d1679702e4 | ||
|
|
3f3b106aca | ||
|
|
ef1ea85c0f | ||
|
|
d711efdd90 | ||
|
|
fbbde0f0e5 | ||
|
|
363b5a4ed0 | ||
|
|
4c935964b2 | ||
|
|
304d785bd0 | ||
|
|
bba2a47492 | ||
|
|
191756c80e | ||
|
|
3f311d3fa7 | ||
|
|
698278fede | ||
|
|
0f1f991512 | ||
|
|
ce494e3d15 | ||
|
|
99db235197 | ||
|
|
dcbdec804d | ||
|
|
56195c0cb3 | ||
|
|
ec78654bdb | ||
|
|
451857ff95 | ||
|
|
0d76dd4248 | ||
|
|
bc67eb4139 | ||
|
|
5a5ab38c9e | ||
|
|
3334f96038 | ||
|
|
9f696f0eab | ||
|
|
9f86587ade | ||
|
|
863ab3cb16 | ||
|
|
fffff22781 | ||
|
|
b471ba0bde | ||
|
|
fa75f86286 | ||
|
|
53e475652a | ||
|
|
7e1e1886da | ||
|
|
7e85cfa5d2 | ||
|
|
7275c34093 | ||
|
|
36ede942c4 | ||
|
|
96a7f0fc74 | ||
|
|
df84d55865 | ||
|
|
439e5743ad | ||
|
|
35426a484e | ||
|
|
fd72712a83 | ||
|
|
581dc8b6de | ||
|
|
4667578662 | ||
|
|
5eed3a54c5 | ||
|
|
2ed1ec984f | ||
|
|
7202dd41f0 | ||
|
|
430bee0eb4 | ||
|
|
d973c18112 | ||
|
|
2e33a4b183 | ||
|
|
49a085551e | ||
|
|
6d810db4f0 | ||
|
|
6921674e5d | ||
|
|
2d88a94f98 | ||
|
|
a3943e28cf | ||
|
|
4a46fcfe2f | ||
|
|
8a2a062862 | ||
|
|
ab951a554d | ||
|
|
91c5e1f934 | ||
|
|
7a3c71413e |
No files matched your search
@@ -1,47 +0,0 @@
|
||||
<!--
|
||||
If you are new to the project get yourself familiar with https://www.mono-project.com/community/bugs/make-a-good-bug-report/ before filling the issue
|
||||
-->
|
||||
|
||||
## Steps to Reproduce
|
||||
|
||||
1.
|
||||
2.
|
||||
3.
|
||||
|
||||
<!--
|
||||
You may drag & drop the attachment (repro code/solution, screenshot, etc.) onto the issue.
|
||||
-->
|
||||
|
||||
### Current Behavior
|
||||
|
||||
<!--
|
||||
What is the current behavior?
|
||||
-->
|
||||
|
||||
### Expected Behavior
|
||||
|
||||
<!--
|
||||
Please describe the behavior you are expecting
|
||||
-->
|
||||
|
||||
## On which platforms did you notice this
|
||||
|
||||
[ ] macOS
|
||||
[ ] Linux
|
||||
[ ] Windows
|
||||
|
||||
**Version Used**:
|
||||
|
||||
<!--
|
||||
You can use `mono --version` or About dialog to obtain this information.
|
||||
-->
|
||||
|
||||
## Stacktrace
|
||||
|
||||
```
|
||||
Please paste the stack trace here if available.
|
||||
```
|
||||
|
||||
<!--
|
||||
You can join us at https://gitter.im/mono/mono to discuss your reported issue
|
||||
-->
|
||||
@@ -1,9 +0,0 @@
|
||||
|
||||
|
||||
<!--
|
||||
Thank you for your Pull Request!
|
||||
|
||||
If you are new to contributing to Mono, please try to do your best at conforming to our coding guidelines http://www.mono-project.com/community/contributing/coding-guidelines/ but don't worry if you get something wrong. One of the project members will help you to get things landed.
|
||||
|
||||
Does your pull request fix any of the existing issues? Please use the following format: Fixes #issue-number
|
||||
-->
|
||||
+1
-4
@@ -40,12 +40,10 @@ Ankh.NoLoad
|
||||
*.gpState
|
||||
.vscode/
|
||||
*.exp
|
||||
.vs/
|
||||
|
||||
# Tooling
|
||||
_ReSharper*/
|
||||
*.resharper
|
||||
.idea/*
|
||||
[Tt]est[Rr]esult*
|
||||
*.orig
|
||||
*.rej
|
||||
@@ -90,7 +88,6 @@ stamp-h.in
|
||||
*.swp
|
||||
*.o
|
||||
.deps
|
||||
.libs
|
||||
|
||||
# Libtool
|
||||
libtool.m4
|
||||
@@ -131,4 +128,4 @@ mono-*.tar.*
|
||||
tmpinst-dir.stamp
|
||||
msvc/scripts/inputs/
|
||||
extensions-config.h
|
||||
*.mlpd
|
||||
|
||||
Vendored
-91
@@ -1,91 +0,0 @@
|
||||
{
|
||||
"configurations": [
|
||||
{
|
||||
"name": "Mac",
|
||||
"includePath": [
|
||||
"/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include/c++/v1",
|
||||
"/usr/local/include",
|
||||
"/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/clang/9.0.0/include",
|
||||
"/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include",
|
||||
"/usr/include",
|
||||
"${workspaceRoot}",
|
||||
"${workspaceRoot}/mono",
|
||||
"${workspaceRoot}/mono/eglib",
|
||||
"${workspaceRoot}/support"
|
||||
],
|
||||
"defines": [],
|
||||
"intelliSenseMode": "clang-x64",
|
||||
"browse": {
|
||||
"path": [
|
||||
"/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include/c++/v1",
|
||||
"/usr/local/include",
|
||||
"/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib/clang/9.0.0/include",
|
||||
"/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include",
|
||||
"/usr/include",
|
||||
"${workspaceRoot}",
|
||||
"${workspaceRoot}/mono",
|
||||
"${workspaceRoot}/mono/eglib",
|
||||
"${workspaceRoot}/support"
|
||||
],
|
||||
"limitSymbolsToIncludedHeaders": true,
|
||||
"databaseFilename": ""
|
||||
},
|
||||
"macFrameworkPath": [
|
||||
"/System/Library/Frameworks",
|
||||
"/Library/Frameworks"
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "Linux",
|
||||
"includePath": [
|
||||
"/usr/include",
|
||||
"/usr/local/include",
|
||||
"${workspaceRoot}",
|
||||
"${workspaceRoot}/mono",
|
||||
"${workspaceRoot}/mono/eglib",
|
||||
"${workspaceRoot}/support"
|
||||
],
|
||||
"defines": [],
|
||||
"intelliSenseMode": "clang-x64",
|
||||
"browse": {
|
||||
"path": [
|
||||
"/usr/include",
|
||||
"/usr/local/include",
|
||||
"${workspaceRoot}",
|
||||
"${workspaceRoot}/mono",
|
||||
"${workspaceRoot}/mono/eglib",
|
||||
"${workspaceRoot}/support"
|
||||
],
|
||||
"limitSymbolsToIncludedHeaders": true,
|
||||
"databaseFilename": ""
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "Win32",
|
||||
"includePath": [
|
||||
"C:/Program Files (x86)/Microsoft Visual Studio 14.0/VC/include",
|
||||
"${workspaceRoot}",
|
||||
"${workspaceRoot}/mono",
|
||||
"${workspaceRoot}/mono/eglib",
|
||||
"${workspaceRoot}/support"
|
||||
],
|
||||
"defines": [
|
||||
"_DEBUG",
|
||||
"UNICODE"
|
||||
],
|
||||
"intelliSenseMode": "msvc-x64",
|
||||
"browse": {
|
||||
"path": [
|
||||
"C:/Program Files (x86)/Microsoft Visual Studio 14.0/VC/include/*",
|
||||
"${workspaceRoot}",
|
||||
"${workspaceRoot}/mono",
|
||||
"${workspaceRoot}/mono/eglib",
|
||||
"${workspaceRoot}/support"
|
||||
],
|
||||
"limitSymbolsToIncludedHeaders": true,
|
||||
"databaseFilename": ""
|
||||
}
|
||||
}
|
||||
],
|
||||
"version": 4
|
||||
}
|
||||
+16
-28
@@ -17,12 +17,11 @@
|
||||
/acceptance-tests @akoeplinger
|
||||
/acceptance-tests/profiler-stress* @alexrp
|
||||
|
||||
/data @marek-safar @akoeplinger @luhenry
|
||||
/data @marek-safar @akoeplinger
|
||||
/data/gdb @vargaz
|
||||
/data/lldb @lewurm @vargaz
|
||||
|
||||
/docs @luhenry @marek-safar
|
||||
/docs/riscv.md @alexrp
|
||||
/docs/sources/mono-api-profiler.html @alexrp
|
||||
|
||||
/external @marek-safar @luhenry
|
||||
@@ -31,14 +30,14 @@
|
||||
/external/boringssl @baulig
|
||||
/external/nuget-buildtasks @radical @akoeplinger
|
||||
|
||||
/libgc @BrzVlad @vargaz @luhenry
|
||||
/libgc @BrzVlad @vargaz
|
||||
|
||||
/llvm @vargaz @luhenry
|
||||
/llvm @vargaz
|
||||
|
||||
/man @marek-safar @miguel @luhenry
|
||||
/man/*prof* @alexrp
|
||||
/man @marek-safar @miguel
|
||||
/man/mprof-report.1 @alexrp
|
||||
|
||||
/mcs @marek-safar @luhenry
|
||||
/mcs @marek-safar
|
||||
|
||||
/mcs/build @marek-safar @akoeplinger
|
||||
|
||||
@@ -59,14 +58,12 @@
|
||||
/mcs/errors @marek-safar
|
||||
/mcs/ilasm @marek-safar
|
||||
/mcs/jay @marek-safar
|
||||
/mcs/mcs @marek-safar @lewurm
|
||||
/mcs/mcs @marek-safar
|
||||
/mcs/tests @marek-safar
|
||||
/mcs/tools @marek-safar @akoeplinger
|
||||
|
||||
/mono @luhenry
|
||||
|
||||
/mono/arch/riscv @alexrp
|
||||
|
||||
/mono/btls @baulig
|
||||
/mono/dis @lambdageek @vargaz
|
||||
/mono/eglib @kumpera @vargaz @luhenry
|
||||
@@ -85,15 +82,14 @@
|
||||
/mono/mini/*cfgdump* @lewurm
|
||||
/mono/mini/*exceptions* @lewurm
|
||||
/mono/mini/*ppc* @lewurm
|
||||
/mono/mini/*riscv* @alexrp
|
||||
/mono/mini/*type-check* @lewurm
|
||||
/mono/mini/interp/* @lewurm @BrzVlad
|
||||
/mono/mini/interp/* @lewurm
|
||||
/mono/mini/*profiler* @alexrp
|
||||
/mono/mini/debugger-agent.c @DavidKarlas
|
||||
|
||||
/mono/profiler @alexrp @kumpera
|
||||
|
||||
/mono/sgen @BrzVlad @kumpera
|
||||
/mono/sgen @brzvlad @kumpera
|
||||
|
||||
/mono/utils @kumpera @vargaz
|
||||
/mono/utils/atomic* @alexrp
|
||||
@@ -102,34 +98,26 @@
|
||||
/mono/utils/mono-threads* @luhenry @kumpera
|
||||
/mono/utils/*-win* @lateralusX @kumpera
|
||||
|
||||
/msvc @lateralusX @luhenry
|
||||
/msvc @lateralusX
|
||||
/msvc/*profiler* @alexrp
|
||||
/msvc/scripts @akoeplinger @kg
|
||||
/msvc/scripts @akoeplinger
|
||||
|
||||
/packaging/ @alexischr @akoeplinger @luhenry @directhex
|
||||
/packaging/ @alexischr @akoeplinger
|
||||
/packaging/MacSDK/msbuild.py @radical @akoeplinger
|
||||
|
||||
/runtime @akoeplinger @marek-safar @luhenry
|
||||
/runtime @akoeplinger @marek-safar
|
||||
|
||||
/samples @luhenry
|
||||
/samples/profiler @alexrp
|
||||
/samples/size @alexrp
|
||||
|
||||
/scripts @akoeplinger @luhenry
|
||||
/scripts/ci @akoeplinger @alexischr
|
||||
/scripts @akoeplinger
|
||||
/scripts/ci @akoeplinger
|
||||
/scripts/ci/run-test-profiler-stress-tests.sh @alexrp
|
||||
|
||||
/sdks @marek-safar @luhenry
|
||||
/sdks/builds/android* @luhenry @jonpryor
|
||||
/sdks/builds/mxe* @luhenry @jonpryor
|
||||
/sdks/builds/ios* @vargaz @rolfbjarne
|
||||
/sdks/wasm @kumpera @lrz
|
||||
/sdks/ios @vargaz @rolfbjarne
|
||||
/sdks/android @luhenry @jonpryor
|
||||
|
||||
/support @luhenry @vargaz
|
||||
|
||||
/tools @kumpera @luhenry
|
||||
/tools @kumpera
|
||||
/tools/checker @tritao
|
||||
/tools/crash-bisector @kumpera
|
||||
/tools/locale-builder @marek-safar
|
||||
|
||||
@@ -32,7 +32,7 @@ file in this directory.
|
||||
CLA
|
||||
=======
|
||||
|
||||
Contributions are now taken under the [.NET Foundation CLA](https://cla.dotnetfoundation.org/).
|
||||
Contributions are now taken under the [.NET Foundation CLA](https://cla2.dotnetfoundation.org/).
|
||||
|
||||
Code Review
|
||||
=======
|
||||
@@ -46,7 +46,7 @@ embeddable runtime:
|
||||
|
||||
* mono/utils/bsearch.c: BSD license.
|
||||
|
||||
* mono/metadata/w32file-unix-glob.c, w32file-unix-glob.h: BSD license
|
||||
* mono/io-layer/wapi_glob.h, wapi_glob.c: BSD license
|
||||
|
||||
Class Library code
|
||||
==================
|
||||
|
||||
+7
-10
@@ -11,9 +11,9 @@ else
|
||||
tools_dir = tools
|
||||
endif
|
||||
|
||||
SUBDIRS = mk po $(libgc_dir) llvm mono $(ikvm_native_dir) support data runtime scripts man samples $(tools_dir) msvc $(docs_dir) acceptance-tests
|
||||
SUBDIRS = po $(libgc_dir) mono $(ikvm_native_dir) support data runtime scripts man samples $(tools_dir) msvc $(docs_dir) acceptance-tests llvm
|
||||
# Keep in sync with SUBDIRS
|
||||
DIST_SUBDIRS = m4 mk po $(libgc_dir) llvm mono ikvm-native support data runtime scripts man samples tools msvc docs acceptance-tests
|
||||
DIST_SUBDIRS = m4 po $(libgc_dir) mono ikvm-native support data runtime scripts man samples tools msvc docs acceptance-tests llvm
|
||||
|
||||
all: update_submodules
|
||||
|
||||
@@ -44,7 +44,6 @@ dist-hook:
|
||||
rm -rf `find $(top_distdir)/external -path '*\.git'`
|
||||
rm -f `find $(top_distdir)/external -path '*\.exe' -not -path '*/roslyn-binaries/*'`
|
||||
rm -f `find $(top_distdir)/external -path '*\.dll' -not -path '*/binary-reference-assemblies/*' -not -path '*/roslyn-binaries/*'`
|
||||
rm -rf "$(top_distdir)/external/linker/linker/Tests"
|
||||
|
||||
pkgconfigdir = $(libdir)/pkgconfig
|
||||
noinst_DATA = mono-uninstalled.pc
|
||||
@@ -115,7 +114,7 @@ update-csproj:
|
||||
-rm msvc/scripts/order.xml
|
||||
-rm -rf msvc/scripts/inputs
|
||||
-mkdir msvc/scripts/inputs
|
||||
(cd runtime; $(MAKE) V=1 extra_targets=csproj-local)
|
||||
(cd runtime; make V=1 extra_targets=csproj-local)
|
||||
|
||||
package-inputs:
|
||||
echo '<?xml version="1.0" encoding="utf-8"?>' > msvc/scripts/order.xml
|
||||
@@ -126,7 +125,6 @@ package-inputs:
|
||||
(echo " <project dir=\"$$1\" library=\"$$2\">"; \
|
||||
read boot; echo " <boot>$$boot</boot>"; \
|
||||
read flags; echo " <flags>$$flags</flags>"; \
|
||||
read sources;echo " <sources>$$sources</sources>"; \
|
||||
read output; echo " <output>$$output</output>"; \
|
||||
read built; echo " <built_sources>`echo $$built | sed 's/\\\/\\\\/g'`</built_sources>"; \
|
||||
read libou; echo " <library_output>$$libou</library_output>"; \
|
||||
@@ -145,10 +143,9 @@ update-llvm-version:
|
||||
|
||||
|
||||
update-solution-files:
|
||||
cd msvc/scripts && $(MAKE) genproj.exe || exit $$?;
|
||||
$(MAKE) update-csproj
|
||||
$(MAKE) package-inputs
|
||||
(cd msvc/scripts; mono --debug genproj.exe $(GENPROJ_ARGS))
|
||||
make update-csproj
|
||||
make package-inputs
|
||||
(cd msvc/scripts; make genproj.exe; mono genproj.exe $(GENPROJ_ARGS))
|
||||
|
||||
update-solution-files-with-tests:
|
||||
$(MAKE) "GENPROJ_ARGS=2012 true true" update-solution-files
|
||||
make "GENPROJ_ARGS=2012 true true" update-solution-files
|
||||
@@ -3,7 +3,7 @@ create cross platform applications. It is an open source
|
||||
implementation of Microsoft's .NET Framework based on the ECMA
|
||||
standards for C# and the Common Language Runtime.
|
||||
|
||||
The Mono project is part of the [.NET Foundation](https://www.dotnetfoundation.org/)
|
||||
The Mono project is part of the [.NET Foundation](http://www.dotnetfoundation.org/)
|
||||
|
||||
[](https://gitter.im/mono/mono?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
||||
|
||||
@@ -19,31 +19,30 @@ The Mono project is part of the [.NET Foundation](https://www.dotnetfoundation.o
|
||||
|
||||
| OS | Architecture | Status |
|
||||
|--------------|--------------------|------------------------------|
|
||||
| Debian 9 | amd64 | [![debian-9-amd64][1]][2] |
|
||||
| Debian 9 | i386 | [![debian-9-i386][3]][4] |
|
||||
| Debian 9 | armel | [![debian-9-armel][5]][6] |
|
||||
| Debian 9 | armhf | [![debian-9-armhf][7]][8] |
|
||||
| Debian 9 | arm64 | [![debian-9-arm64][9]][10] |
|
||||
| Ubuntu 14.04 | amd64 | [![ubuntu-1404-amd64][1]][2] |
|
||||
| Ubuntu 14.04 | i386 | [![ubuntu-1404-i386][3]][4] |
|
||||
| Debian 8 | armel | [![debian-8-armel][5]][6] |
|
||||
| Debian 8 | armhf | [![debian-8-armhf][7]][8] |
|
||||
| Debian 8 | arm64 | [![debian-8-arm64][9]][10] |
|
||||
| OS X | amd64 | [![osx-amd64][11]][12] |
|
||||
| OS X | i386 | [![osx-i386][13]][14] |
|
||||
| Windows | amd64 | [![windows-amd64][15]][16] |
|
||||
| Windows | i386 | [![windows-i386][17]][18] |
|
||||
| Windows | i386 | [![windows-amd64][17]][18] |
|
||||
| CentOS | s390x (cs) | [![centos-s390x][19]][20] |
|
||||
| Debian 9 | ppc64el (cs) | [![debian-9-ppc64el][21]][22]|
|
||||
| AIX | ppc64 (cs) | [![aix-ppc64][23]][24] |
|
||||
| Debian 8 | ppc64el (cs) | [![debian-8-ppc64el][21]][22]|
|
||||
|
||||
_(cs) = community supported architecture_
|
||||
|
||||
[1]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-9-amd64/badge/icon
|
||||
[2]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-9-amd64
|
||||
[3]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-9-i386/badge/icon
|
||||
[4]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-9-i386/
|
||||
[5]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-9-armel/badge/icon
|
||||
[6]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-9-armel/
|
||||
[7]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-9-armhf/badge/icon
|
||||
[8]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-9-armhf/
|
||||
[9]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-9-arm64/badge/icon
|
||||
[10]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-9-arm64/
|
||||
[1]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=ubuntu-1404-amd64/badge/icon
|
||||
[2]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=ubuntu-1404-amd64
|
||||
[3]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=ubuntu-1404-i386/badge/icon
|
||||
[4]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=ubuntu-1404-i386/
|
||||
[5]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-8-armel/badge/icon
|
||||
[6]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-8-armel/
|
||||
[7]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-8-armhf/badge/icon
|
||||
[8]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-8-armhf/
|
||||
[9]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-8-arm64/badge/icon
|
||||
[10]: https://jenkins.mono-project.com/job/test-mono-mainline-linux/label=debian-8-arm64/
|
||||
[11]: https://jenkins.mono-project.com/job/test-mono-mainline/label=osx-amd64/badge/icon
|
||||
[12]: https://jenkins.mono-project.com/job/test-mono-mainline/label=osx-amd64/
|
||||
[13]: https://jenkins.mono-project.com/job/test-mono-mainline/label=osx-i386/badge/icon
|
||||
@@ -54,10 +53,8 @@ _(cs) = community supported architecture_
|
||||
[18]: https://jenkins.mono-project.com/job/z/label=w32/
|
||||
[19]: https://jenkins.mono-project.com/job/test-mono-mainline-community/label=centos-s390x/badge/icon
|
||||
[20]: https://jenkins.mono-project.com/job/test-mono-mainline-community/label=centos-s390x
|
||||
[21]: https://jenkins.mono-project.com/job/test-mono-mainline-community-chroot/label=debian-9-ppc64el/badge/icon
|
||||
[22]: https://jenkins.mono-project.com/job/test-mono-mainline-community-chroot/label=debian-9-ppc64el
|
||||
[23]: https://jenkins.mono-project.com/job/test-mono-mainline-community/label=aix-ppc64/badge/icon
|
||||
[24]: https://jenkins.mono-project.com/job/test-mono-mainline-community/label=aix-ppc64
|
||||
[21]: https://jenkins.mono-project.com/job/test-mono-mainline-community-chroot/label=debian-8-ppc64el/badge/icon
|
||||
[22]: https://jenkins.mono-project.com/job/test-mono-mainline-community-chroot/label=debian-8-ppc64el
|
||||
|
||||
Compilation and Installation
|
||||
============================
|
||||
@@ -66,15 +63,15 @@ Building the Software
|
||||
---------------------
|
||||
|
||||
Please see our guides for building Mono on
|
||||
[Mac OS X](https://www.mono-project.com/docs/compiling-mono/mac/),
|
||||
[Linux](https://www.mono-project.com/docs/compiling-mono/linux/) and
|
||||
[Windows](https://www.mono-project.com/docs/compiling-mono/windows/).
|
||||
[Mac OS X](http://www.mono-project.com/docs/compiling-mono/mac/),
|
||||
[Linux](http://www.mono-project.com/docs/compiling-mono/linux/) and
|
||||
[Windows](http://www.mono-project.com/docs/compiling-mono/windows/).
|
||||
|
||||
Note that building from Git assumes that you already have Mono installed,
|
||||
so please download and [install the latest Mono release](https://www.mono-project.com/download/)
|
||||
so please download and [install the latest Mono release](http://www.mono-project.com/download/)
|
||||
before trying to build from Git. This is required because the Mono build
|
||||
relies on a working Mono C# compiler to compile itself
|
||||
(also known as [bootstrapping](https://en.wikipedia.org/wiki/Bootstrapping_(compilers))).
|
||||
(also known as [bootstrapping](http://en.wikipedia.org/wiki/Bootstrapping_(compilers))).
|
||||
|
||||
If you don't have a working Mono installation
|
||||
---------------------------------------------
|
||||
@@ -114,7 +111,7 @@ Once you have installed the software, you can run a few programs:
|
||||
|
||||
* `mono program.exe` runtime engine
|
||||
|
||||
* `mcs program.cs` C# compiler
|
||||
* `mcs program.cs` C# compiler
|
||||
|
||||
* `monodis program.exe` CIL Disassembler
|
||||
|
||||
@@ -131,14 +128,6 @@ Directory Roadmap
|
||||
|
||||
* `external/` - Git submodules for external libraries (Newtonsoft.Json, ikvm, etc).
|
||||
|
||||
* `ikvm-native/` - Glue code for ikvm.
|
||||
|
||||
* `libgc/` - The (deprecated) Boehm GC implementation.
|
||||
|
||||
* `llvm/` - Utility Makefiles for integrating the Mono LLVM fork.
|
||||
|
||||
* `m4/` - General utility Makefiles.
|
||||
|
||||
* `man/` - Manual pages for the various Mono commands and programs.
|
||||
|
||||
* `mcs/` - The class libraries, compiler and tools
|
||||
@@ -153,69 +142,44 @@ Directory Roadmap
|
||||
|
||||
* `arch/` - Architecture specific portions.
|
||||
|
||||
* `benchmark/` - A collection of benchmarks.
|
||||
|
||||
* `btls/` - Build files for the BTLS library which incorporates BoringSSL.
|
||||
|
||||
* `cil/` - Common Intermediate Representation, XML
|
||||
definition of the CIL bytecodes.
|
||||
|
||||
* `dis/` - CIL executable Disassembler.
|
||||
* `dis/` - CIL executable Disassembler
|
||||
|
||||
* `eglib/` - Independent implementation of the glib API.
|
||||
* `io-layer/` - The I/O layer and system abstraction for
|
||||
emulating the .NET IO model.
|
||||
|
||||
* `metadata/` - The object system and metadata reader.
|
||||
|
||||
* `mini/` - The Just in Time Compiler.
|
||||
|
||||
* `profiler/` - The profiler implementation.
|
||||
|
||||
* `sgen/` - The SGen Garbage Collector implementation.
|
||||
|
||||
* `tests/` - The main runtime tests.
|
||||
|
||||
* `unit-tests/` - Additional runtime unit tests.
|
||||
|
||||
* `utils/` - Utility functions used across the runtime codebase.
|
||||
|
||||
* `msvc/` - Logic for the MSVC / Visual Studio based runtime and BCL build system.
|
||||
The latter is experimental at the moment.
|
||||
|
||||
* `packaging/` - Packaging logic for the OS X and Windows Mono packages.
|
||||
|
||||
* `po/` - Translation files.
|
||||
|
||||
* `runtime/` - A directory that contains the Makefiles that link the
|
||||
mono/ and mcs/ build systems.
|
||||
|
||||
* `samples/` - Some simple sample programs on uses of the Mono
|
||||
runtime as an embedded library.
|
||||
* `samples/` -Some simple sample programs on uses of the Mono
|
||||
runtime as an embedded library.
|
||||
|
||||
* `scripts/` - Scripts used to invoke Mono and the corresponding program.
|
||||
|
||||
* `sdks/` - A new way of embedding Mono into Xamarin.iOS, Xamarin.Android and other products.
|
||||
|
||||
* `support/` - Various support libraries.
|
||||
|
||||
* `tools/` - A collection of tools, mostly used during Mono development.
|
||||
|
||||
Contributing to Mono
|
||||
====================
|
||||
|
||||
Before submitting changes to Mono, please review the [contribution
|
||||
guidelines](https://www.mono-project.com/community/contributing/).
|
||||
guidelines](http://www.mono-project.com/community/contributing/).
|
||||
Please pay particular attention to the [Important
|
||||
Rules](https://www.mono-project.com/community/contributing/#important-rules)
|
||||
Rules](http://www.mono-project.com/community/contributing/#important-rules)
|
||||
section.
|
||||
|
||||
Reporting bugs
|
||||
==============
|
||||
|
||||
To submit bug reports, please [open an issue on the mono GitHub repo](https://github.com/mono/mono/issues/new).
|
||||
To submit bug reports, please use [Xamarin's
|
||||
Bugzilla](https://bugzilla.xamarin.com/)
|
||||
|
||||
Please use the search facility to ensure the same bug hasn't already
|
||||
been submitted and follow our
|
||||
[guidelines](https://www.mono-project.com/community/bugs/make-a-good-bug-report/)
|
||||
[guidelines](http://www.mono-project.com/community/bugs/make-a-good-bug-report/)
|
||||
on how to make a good bug report.
|
||||
|
||||
Configuration Options
|
||||
@@ -244,12 +208,12 @@ Disables the inclusion of a Boehm garbage collector.
|
||||
|
||||
* This defaults to `included`.
|
||||
|
||||
* `--enable-cooperative-suspend`
|
||||
* `--with-cooperative-gc`
|
||||
|
||||
* If you pass this flag the Mono runtime is configured to only use
|
||||
the cooperative mode of the garbage collector. If you do not pass
|
||||
this flag, then you can control at runtime the use of the
|
||||
cooperative GC mode by setting the `MONO_ENABLE_COOP_SUSPEND` flag.
|
||||
cooperative GC mode by setting the `MONO_ENABLE_COOP` flag.
|
||||
|
||||
* `--with-tls=__thread,pthread`
|
||||
|
||||
@@ -344,6 +308,16 @@ should be used.
|
||||
|
||||
* Or you can specify a path to a libgdiplus.
|
||||
|
||||
* `--disable-shared-memory`
|
||||
|
||||
* Use this option to disable the use of shared memory in
|
||||
Mono (this is equivalent to setting the MONO_DISABLE_SHM
|
||||
environment variable, although this removes the feature
|
||||
completely).
|
||||
|
||||
* Disabling the shared memory support will disable certain
|
||||
features like cross-process named mutexes.
|
||||
|
||||
* `--enable-minimal=LIST`
|
||||
|
||||
* Use this feature to specify optional runtime
|
||||
@@ -435,7 +409,7 @@ for Mono. The LLVM code generator and optimizer will be
|
||||
used instead of Mono's built-in code generator for both
|
||||
Just in Time and Ahead of Time compilations.
|
||||
|
||||
* See https://www.mono-project.com/docs/advanced/mono-llvm/ for the
|
||||
* See http://www.mono-project.com/docs/advanced/mono-llvm/ for the
|
||||
full details and up-to-date information on this feature.
|
||||
|
||||
* You will need to have an LLVM built that Mono can link
|
||||
@@ -504,7 +478,7 @@ also, see the man page.
|
||||
|
||||
* This configures the Mono compiler to generate code
|
||||
suitable to be used by Google's Native Client:
|
||||
https://code.google.com/p/nativeclient/
|
||||
http://code.google.com/p/nativeclient/
|
||||
|
||||
* Currently this is used with Mono's AOT engine as
|
||||
Native Client does not support JIT engines yet.
|
||||
@@ -578,7 +552,7 @@ file for information about Microsoft's patent grant.
|
||||
Mono Trademark Use Policy
|
||||
=========================
|
||||
|
||||
The use of trademarks and logos for Mono can be found [here](https://www.dotnetfoundation.org/legal/mono-tm).
|
||||
The use of trademarks and logos for Mono can be found [here] (http://www.dotnetfoundation.org/legal/mono-tm).
|
||||
|
||||
Maintaining the Class Library Solution Files
|
||||
============================================
|
||||
|
||||
@@ -0,0 +1,14 @@
|
||||
using System;
|
||||
using System.IO;
|
||||
using System.Reflection;
|
||||
|
||||
namespace System.Runtime.Loader
|
||||
{
|
||||
public static class AssemblyExtensions
|
||||
{
|
||||
public static Type[] GetTypes(this Assembly assembly)
|
||||
{
|
||||
return assembly.GetTypes ();
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -5,7 +5,7 @@ CORECLR_PATH=$(ACCEPTANCE_TESTS_PATH)/coreclr
|
||||
MSTESTSUITE_PATH=$(ACCEPTANCE_TESTS_PATH)/ms-test-suite
|
||||
|
||||
CLEANFILES = *.dll *.exe *.mdb
|
||||
EXTRA_DIST=README.md SUBMODULES.json versions.mk profiler-stress.mk roslyn.mk coreclr.mk ms-test-suite.mk
|
||||
EXTRA_DIST=README.md SUBMODULES.json versions.mk roslyn.mk coreclr.mk ms-test-suite.mk
|
||||
|
||||
CLASS=$(mcs_topdir)/class/lib/$(DEFAULT_PROFILE)
|
||||
TOOLS_CLASS=$(mcs_topdir)/class/lib/build
|
||||
@@ -14,7 +14,6 @@ RUNTIME = MONO_PATH=$(CLASS) $(abs_top_builddir)/runtime/mono-wrapper --debug
|
||||
TOOLS_RUNTIME = MONO_PATH=$(TOOLS_CLASS) $(abs_top_builddir)/runtime/mono-wrapper --debug
|
||||
MCS = $(TOOLS_RUNTIME) $(CSC) -nologo -noconfig -lib:$(CLASS) -r:System.dll -r:System.Core.dll -r:System.Xml.dll -r:Microsoft.CSharp.dll
|
||||
ILASM = $(TOOLS_RUNTIME) $(TOOLS_CLASS)/ilasm.exe
|
||||
XUNIT = $(RUNTIME) $(abs_top_builddir)/external/xunit-binaries/xunit.console.exe
|
||||
|
||||
include versions.mk
|
||||
include profiler-stress.mk
|
||||
|
||||
@@ -1,16 +1,16 @@
|
||||
[
|
||||
{
|
||||
"name": "roslyn",
|
||||
"url": "git://github.com/mono/roslyn.git",
|
||||
"rev": "7a840bd5697ef6ea41f554a09d837636fba9d88d",
|
||||
"remote-branch": "origin/mono-testing",
|
||||
"branch": "mono-testing",
|
||||
"url": "git://github.com/dotnet/roslyn.git",
|
||||
"rev": "322bd5b2bbf07df6a67de35cbcb2365484412f70",
|
||||
"remote-branch": "origin/master",
|
||||
"branch": "master",
|
||||
"directory": "roslyn"
|
||||
},
|
||||
{
|
||||
"name": "coreclr",
|
||||
"url": "git://github.com/mono/coreclr.git",
|
||||
"rev": "f3d9c9f742f9dcb5faf40080db5e7f464dab7e7c",
|
||||
"rev": "d0e6a36f782f5ee1ca0b7d3ec0c55725c3571b1f",
|
||||
"remote-branch": "origin/mono",
|
||||
"branch": "mono",
|
||||
"directory": "coreclr"
|
||||
@@ -18,7 +18,7 @@
|
||||
{
|
||||
"name": "ms-test-suite",
|
||||
"url": "[email protected]:xamarin/ms-test-suite.git",
|
||||
"rev": "67f29dfc0741b5311dd746c75760963a2915e648",
|
||||
"rev": "25f495326e141163d59e52ef499227a2f38fe036",
|
||||
"remote-branch": "origin/master",
|
||||
"branch": "master",
|
||||
"directory": "ms-test-suite"
|
||||
|
||||
+11
-13
@@ -32,7 +32,7 @@ coreclr-runtest-coremanglib: coreclr-validate test-runner.exe $(CORECLR_COREMANG
|
||||
check-coreclr: coreclr-compile-tests coreclr-runtest-basic coreclr-runtest-coremanglib
|
||||
|
||||
coreclr-gcstress: coreclr-validate GCStressTests.exe $(CORECLR_STRESSTESTSI_CS)
|
||||
BVT_ROOT=$(realpath $(CORECLR_PATH)/tests/src/GC/Stress/Tests) $(RUNTIME) GCStressTests.exe $(CORECLR_PATH)/tests/src/GC/Stress/$(if $(CI_PR),testmix_gc_pr.config,testmix_gc.config); if [ $$? -ne 100 ]; then exit 1; fi
|
||||
BVT_ROOT=$(realpath $(CORECLR_PATH)/tests/src/GC/Stress/Tests) $(RUNTIME) GCStressTests.exe $(CORECLR_PATH)/tests/src/GC/Stress/testmix_gc.config; if [ $$? -ne 100 ]; then exit 1; fi
|
||||
|
||||
# Output a variable in $(2) to the file $(1), separated by newline characters
|
||||
# we need to do it in groups of 100 entries to make sure we don't exceed shell char limits
|
||||
@@ -2162,6 +2162,7 @@ CORECLR_COREMANGLIB_TEST_CS_SRC= \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/double/doubleepsilon.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/double/doubleequals1.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/double/doubleequals2.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/double/doublegethashcode.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/double/doubleiconvertibletoboolean.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/double/doubleiconvertibletobyte.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/double/doubleiconvertibletodatetime.cs \
|
||||
@@ -2216,6 +2217,7 @@ CORECLR_COREMANGLIB_TEST_CS_SRC= \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/gc/gcgettotalmemory.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/gc/gckeepalive.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/gc/gcmaxgeneration.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/gc/gcsuppressfinalize.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/gc/gcwaitforpendingfinalizers.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/globalization/calendarweekrule/calendarweekrulefirstday.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/globalization/calendarweekrule/calendarweekrulefirstfourdayweek.cs \
|
||||
@@ -3241,6 +3243,7 @@ CORECLR_COREMANGLIB_TEST_CS_SRC= \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/security/securityexception/securityexceptionctor3.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/security/securityexception/securityexceptiontostring.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/single/singleepsilon.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/single/singlegethashcode.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/single/singleisinfinity.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/single/singleisnan.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/single/singleisnegativeinfinity.cs \
|
||||
@@ -3689,8 +3692,9 @@ CORECLR_STRESSTEST_RUNNER_CS_SRC= \
|
||||
$(CORECLR_PATH)/tests/src/GC/Stress/Framework/RFLogging.cs \
|
||||
$(CORECLR_PATH)/tests/src/GC/Stress/Framework/DetourHelpers.cs \
|
||||
$(CORECLR_PATH)/tests/src/GC/Stress/Framework/LoaderClass.cs \
|
||||
GCStressTests/AssemblyLoadContext.cs
|
||||
|
||||
GCStressTests/AssemblyLoadContext.cs \
|
||||
GCStressTests/AssemblyExtensions.cs
|
||||
|
||||
CORECLR_TESTLIBRARY_CS_SRC = \
|
||||
$(CORECLR_PATH)/tests/src/Common/CoreCLRTestLibrary/TestFramework.cs \
|
||||
$(CORECLR_PATH)/tests/src/Common/CoreCLRTestLibrary/Utilities.cs \
|
||||
@@ -3712,7 +3716,7 @@ CORECLR_DISABLED_TEST_CS_SRC += \
|
||||
CORECLR_DISABLED_TEST_CS_SRC += \
|
||||
$(CORECLR_PATH)/tests/src/readytorun/main.cs \
|
||||
$(CORECLR_PATH)/tests/src/readytorun/test.cs
|
||||
|
||||
|
||||
# relies on a referenced managed or native assembly, to complicated here:
|
||||
CORECLR_DISABLED_TEST_CS_SRC += \
|
||||
$(CORECLR_PATH)/tests/src/Regressions/assemblyref/assem.cs \
|
||||
@@ -3852,7 +3856,7 @@ CORECLR_DISABLED_TEST_CS_SRC += \
|
||||
CORECLR_DISABLED_TEST_CS_SRC += \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/datetime/cfdatetimetools.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/datetime/datetimeisdaylightsavingtime.cs
|
||||
|
||||
|
||||
# relies on delegatedefinitions.cs helper
|
||||
CORECLR_DISABLED_TEST_CS_SRC += \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/multicastdelegate/multicastdelegatector.cs \
|
||||
@@ -3960,7 +3964,7 @@ CORECLR_DISABLED_TEST_CS_SRC += \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/system/delegate/threatmodel/public/testclass.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/system/delegate/threatmodel/tests/bindingtarget.cs \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/system/delegate/threatmodel/tests/testclass.cs
|
||||
|
||||
|
||||
# samples (should probably be removed upstream)
|
||||
CORECLR_DISABLED_TEST_CS_SRC += \
|
||||
$(CORECLR_PATH)/tests/src/hosting/samples/hosting/usercode/usercode.cs \
|
||||
@@ -3978,10 +3982,6 @@ CORECLR_DISABLED_TEST_CS_SRC += \
|
||||
$(CORECLR_PATH)/tests/src/JIT/Directed/newarr/newarr.cs \
|
||||
$(CORECLR_PATH)/tests/src/baseservices/exceptions/sharedexceptions/emptystacktrace/oomexception01.cs
|
||||
|
||||
# https://github.com/mono/mono/issues/7432
|
||||
CORECLR_DISABLED_TEST_CS_SRC += \
|
||||
$(CORECLR_PATH)/tests/src/CoreMangLib/cti/system/gc/gcsuppressfinalize.cs
|
||||
|
||||
CORECLR_TEST_IL_SRC = \
|
||||
$(CORECLR_PATH)/tests/src/JIT/BBT/Scenario4/Not-Int32.il \
|
||||
$(CORECLR_PATH)/tests/src/JIT/Directed/Convert/implicitConv.il \
|
||||
@@ -4966,6 +4966,7 @@ CORECLR_TEST_IL_SRC = \
|
||||
$(CORECLR_PATH)/tests/src/JIT/jit64/opt/regress/vswhidbey/223862/rem.il \
|
||||
$(CORECLR_PATH)/tests/src/JIT/jit64/opt/regress/vswhidbey/228572/conv.il \
|
||||
$(CORECLR_PATH)/tests/src/JIT/jit64/opt/regress/vswhidbey/481244/foo.il \
|
||||
$(CORECLR_PATH)/tests/src/JIT/jit64/opt/regress/vswhidbey/481244/foo2.il \
|
||||
$(CORECLR_PATH)/tests/src/JIT/jit64/regress/ddb/118414/118414.il \
|
||||
$(CORECLR_PATH)/tests/src/JIT/jit64/regress/ddb/127931/127931.il \
|
||||
$(CORECLR_PATH)/tests/src/JIT/jit64/regress/vsw/102974/test.il \
|
||||
@@ -5057,9 +5058,6 @@ CORECLR_DISABLED_TEST_IL_SRC += \
|
||||
CORECLR_DISABLED_TEST_IL_SRC += \
|
||||
$(CORECLR_PATH)/tests/src/JIT/Directed/coverage/oldtests/lcliimpl.il
|
||||
|
||||
# We use an r4 for r4-r8 stack merge so it loses precision
|
||||
CORECLR_DISABLED_TEST_IL_SRC += \
|
||||
$(CORECLR_PATH)/tests/src/JIT/jit64/opt/regress/vswhidbey/481244/foo2.il
|
||||
|
||||
# FIXME: these tests are baselined, i.e. we don't have time to investigate
|
||||
# them right now but want to make sure we don't introduce new regressions
|
||||
|
||||
@@ -57,21 +57,21 @@ namespace Mono.Profiling.Tests.Stress {
|
||||
"jit",
|
||||
};
|
||||
|
||||
static readonly TimeSpan _timeout = TimeSpan.FromHours (6);
|
||||
|
||||
const RegexOptions _regexOptions = RegexOptions.Compiled | RegexOptions.Singleline;
|
||||
static readonly TimeSpan _timeout = TimeSpan.FromHours (9);
|
||||
|
||||
static readonly Dictionary<string, Predicate<Benchmark>> _filters = new Dictionary<string, Predicate<Benchmark>> {
|
||||
{ "ironjs-v8", FilterNotOnArm },
|
||||
{ "msbiology", FilterNever },
|
||||
{ "ironjs-v8", FilterArmArchitecture },
|
||||
};
|
||||
|
||||
static bool FilterNever (Benchmark benchmark)
|
||||
{
|
||||
return false;
|
||||
static readonly Dictionary<string, Action<TestResult>> _processors = new Dictionary<string, Action<TestResult>> {
|
||||
{ "msbiology", Process32BitOutOfMemory },
|
||||
};
|
||||
|
||||
static string FilterInvalidXmlChars (string text) {
|
||||
return Regex.Replace (text, @"[^\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]", string.Empty);
|
||||
}
|
||||
|
||||
static bool FilterNotOnArm (Benchmark benchmark)
|
||||
static bool FilterArmArchitecture (Benchmark benchmark)
|
||||
{
|
||||
#if ARCH_arm || ARCH_arm64
|
||||
return false;
|
||||
@@ -80,66 +80,45 @@ namespace Mono.Profiling.Tests.Stress {
|
||||
#endif
|
||||
}
|
||||
|
||||
static void Process32BitOutOfMemory (TestResult result)
|
||||
{
|
||||
if (Environment.Is64BitProcess)
|
||||
return;
|
||||
|
||||
if (result.ExitCode == null || result.ExitCode == 0)
|
||||
return;
|
||||
|
||||
if (result.StandardError.Contains ("OutOfMemoryException"))
|
||||
result.ExitCode = 0;
|
||||
}
|
||||
|
||||
static bool IsSupported (Benchmark benchmark)
|
||||
{
|
||||
return _filters.TryGetValue (benchmark.Name, out var filter) ? filter (benchmark) : true;
|
||||
}
|
||||
|
||||
static string ReplaceInvalidXmlChars (string text) {
|
||||
return Regex.Replace (text, @"[^\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u10000-\u10FFFF]", string.Empty);
|
||||
}
|
||||
|
||||
static int Main ()
|
||||
{
|
||||
var regex = new Regex (".*", _regexOptions);
|
||||
|
||||
if (Environment.GetEnvironmentVariable ("MONO_PROFILER_STRESS_REGEX") is string envRegex)
|
||||
regex = new Regex (envRegex, _regexOptions);
|
||||
|
||||
var depDir = Path.Combine ("..", "external", "benchmarker");
|
||||
var benchDir = Path.Combine (depDir, "benchmarks");
|
||||
var testDir = Path.Combine (depDir, "tests");
|
||||
|
||||
var benchmarks = Directory.EnumerateFiles (benchDir, "*.benchmark")
|
||||
.Select (Benchmark.Load)
|
||||
.Where (b => !b.OnlyExplicit && b.ClientCommandLine == null && IsSupported (b) && regex.IsMatch (b.Name))
|
||||
.Where (b => !b.OnlyExplicit && b.ClientCommandLine == null && IsSupported (b))
|
||||
.OrderBy (b => b.Name)
|
||||
.ToArray ();
|
||||
|
||||
var monoPath = Path.GetFullPath (Path.Combine ("..", "..", "runtime", "mono-wrapper"));
|
||||
var classDir = Path.GetFullPath (Path.Combine ("..", "..", "mcs", "class", "lib", "net_4_x"));
|
||||
|
||||
var seed = Environment.TickCount;
|
||||
|
||||
if (Environment.GetEnvironmentVariable ("MONO_PROFILER_STRESS_SEED") is string envSeed)
|
||||
seed = int.Parse (envSeed);
|
||||
|
||||
var timeout = (int) _timeout.TotalMilliseconds;
|
||||
|
||||
if (Environment.GetEnvironmentVariable ("MONO_PROFILER_STRESS_TIMEOUT") is string envTimeout)
|
||||
timeout = (int) TimeSpan.Parse (envTimeout).TotalMilliseconds;
|
||||
|
||||
string options = null;
|
||||
|
||||
if (Environment.GetEnvironmentVariable ("MONO_PROFILER_STRESS_OPTIONS") is string envOptions)
|
||||
options = envOptions;
|
||||
|
||||
var suspend = false;
|
||||
|
||||
if (Environment.GetEnvironmentVariable ("MONO_PROFILER_STRESS_SUSPEND") is string envSuspend)
|
||||
suspend = bool.Parse (envSuspend);
|
||||
|
||||
var rand = new Random (seed);
|
||||
var rand = new Random ();
|
||||
var cpus = Environment.ProcessorCount;
|
||||
|
||||
var sw = Stopwatch.StartNew ();
|
||||
|
||||
Console.ForegroundColor = ConsoleColor.Magenta;
|
||||
Console.WriteLine ($"[{sw.Elapsed.ToString ("G")}] Starting test session with seed: {seed}");
|
||||
Console.ResetColor ();
|
||||
|
||||
var results = new List<TestResult> (benchmarks.Length);
|
||||
|
||||
var sw = Stopwatch.StartNew ();
|
||||
|
||||
for (var i = 0; i < benchmarks.Length; i++) {
|
||||
var bench = benchmarks [i];
|
||||
|
||||
@@ -148,24 +127,17 @@ namespace Mono.Profiling.Tests.Stress {
|
||||
var maxSamples = rand.Next (0, cpus * 2000 + 1);
|
||||
var heapShotFreq = rand.Next (-10, 11);
|
||||
var maxFrames = rand.Next (0, 33);
|
||||
var flags = _options.ToDictionary (x => x, _ => rand.Next (0, 2) == 1)
|
||||
.Select (x => (x.Value ? string.Empty : "no") + x.Key)
|
||||
.ToArray ();
|
||||
var options = _options.ToDictionary (x => x, _ => rand.Next (0, 2) == 1)
|
||||
.Select (x => (x.Value ? string.Empty : "no") + x.Key)
|
||||
.ToArray ();
|
||||
|
||||
var profOptions = "nodefaults,output=/dev/null,";
|
||||
var profOptions = $"maxframes={maxFrames},{string.Join (",", options)},output=/dev/null";
|
||||
|
||||
if (options == null) {
|
||||
profOptions += $"maxframes={maxFrames},";
|
||||
if (sampleFreq > 0)
|
||||
profOptions += $",sample{sampleMode}={sampleFreq},maxsamples={maxSamples}";
|
||||
|
||||
if (sampleFreq > 0)
|
||||
profOptions += $"sample{sampleMode}={sampleFreq},maxsamples={maxSamples},";
|
||||
|
||||
if (heapShotFreq > 0)
|
||||
profOptions += $"heapshot={heapShotFreq}gc,";
|
||||
|
||||
profOptions += string.Join (",", flags);
|
||||
} else
|
||||
profOptions += options;
|
||||
if (heapShotFreq > 0)
|
||||
profOptions += $",heapshot={heapShotFreq}gc";
|
||||
|
||||
var info = new ProcessStartInfo {
|
||||
UseShellExecute = false,
|
||||
@@ -179,9 +151,6 @@ namespace Mono.Profiling.Tests.Stress {
|
||||
info.EnvironmentVariables.Clear ();
|
||||
info.EnvironmentVariables.Add ("MONO_PATH", classDir);
|
||||
|
||||
if (suspend)
|
||||
info.EnvironmentVariables.Add ("MONO_DEBUG", "suspend-on-native-crash,suspend-on-unhandled");
|
||||
|
||||
var progress = $"({i + 1}/{benchmarks.Length})";
|
||||
|
||||
Console.ForegroundColor = ConsoleColor.Blue;
|
||||
@@ -218,7 +187,7 @@ namespace Mono.Profiling.Tests.Stress {
|
||||
proc.BeginOutputReadLine ();
|
||||
proc.BeginErrorReadLine ();
|
||||
|
||||
if (!proc.WaitForExit (timeout)) {
|
||||
if (!proc.WaitForExit ((int) _timeout.TotalMilliseconds)) {
|
||||
// Force a thread dump.
|
||||
Syscall.kill (proc.Id, Signum.SIGQUIT);
|
||||
Thread.Sleep (1000);
|
||||
@@ -258,6 +227,9 @@ namespace Mono.Profiling.Tests.Stress {
|
||||
Console.WriteLine (result.StandardError);
|
||||
}
|
||||
|
||||
if (_processors.TryGetValue (bench.Name, out var processor))
|
||||
processor (result);
|
||||
|
||||
results.Add (result);
|
||||
}
|
||||
|
||||
@@ -274,7 +246,7 @@ namespace Mono.Profiling.Tests.Stress {
|
||||
|
||||
using (var writer = XmlWriter.Create ("TestResult-profiler-stress.xml", settings)) {
|
||||
writer.WriteStartDocument ();
|
||||
writer.WriteComment ($"This file represents the results of running a test suite (seed: {seed})");
|
||||
writer.WriteComment ("This file represents the results of running a test suite");
|
||||
|
||||
writer.WriteStartElement ("test-results");
|
||||
writer.WriteAttributeString ("name", "profiler-stress-tests.dummy");
|
||||
@@ -335,11 +307,11 @@ namespace Mono.Profiling.Tests.Stress {
|
||||
writer.WriteStartElement ("failure");
|
||||
|
||||
writer.WriteStartElement ("message");
|
||||
writer.WriteCData (ReplaceInvalidXmlChars (result.StandardOutput));
|
||||
writer.WriteCData (FilterInvalidXmlChars (result.StandardOutput));
|
||||
writer.WriteEndElement ();
|
||||
|
||||
writer.WriteStartElement ("stack-trace");
|
||||
writer.WriteCData (ReplaceInvalidXmlChars (result.StandardError));
|
||||
writer.WriteCData (FilterInvalidXmlChars (result.StandardError));
|
||||
writer.WriteEndElement ();
|
||||
|
||||
writer.WriteEndElement ();
|
||||
|
||||
@@ -1,5 +1,18 @@
|
||||
check-roslyn:
|
||||
@$(MAKE) validate-roslyn RESET_VERSIONS=1
|
||||
@if [ -z $$PREFIX ]; then echo "You need to set PREFIX to the prefix of the Mono installation that should be used for testing Roslyn." && exit 1; fi
|
||||
sed -i -e 's/\\4.5-api"/\\4.5"/g' $$PREFIX/lib/mono/xbuild-frameworks/.NETFramework/v4.5/RedistList/FrameworkList.xml; \
|
||||
export MSBuildExtensionsPath=$$PREFIX/lib/mono/xbuild; \
|
||||
MONO_DOTNET_PORTABLE_DIR=$$PREFIX/lib/mono/xbuild-frameworks/.NETPortable/; \
|
||||
if [ ! -d "$$MONO_DOTNET_PORTABLE_DIR/v4.6" ]; then \
|
||||
mkdir -p $$MONO_DOTNET_PORTABLE_DIR; \
|
||||
curl -SL "http://download.mono-project.com/third-party/RoslynBuildDependencies.zip" > /tmp/RoslynBuildDependencies.zip; \
|
||||
unzip -o /tmp/RoslynBuildDependencies.zip -d /tmp/RoslynBuildDependencies; \
|
||||
cp -r /tmp/RoslynBuildDependencies/PortableReferenceAssemblies/* $$MONO_DOTNET_PORTABLE_DIR; \
|
||||
fi; \
|
||||
cd $(ROSLYN_PATH); \
|
||||
./build.sh --restore --build --test --mono || exit; \
|
||||
echo "done"
|
||||
sed -i -e 'N; s/bootstrapArg=".*\n.*"/bootstrapArg=""/g' cibuild.sh; \
|
||||
sed -i -e 's#-xml Binaries/\$$BUILD_CONFIGURATION/xUnitResults/#-nunit $(abs_top_builddir)/acceptance-tests/TestResult-#g' cibuild.sh; \
|
||||
./cibuild.sh --mono-path $$PREFIX/bin || EXIT_CODE=1; \
|
||||
sed -i -e 's/\\4.5"/\\4.5-api"/g' $$PREFIX/lib/mono/xbuild-frameworks/.NETFramework/v4.5/RedistList/FrameworkList.xml; \
|
||||
exit $$EXIT_CODE
|
||||
+3
-5
@@ -89,11 +89,9 @@ if test x$NOCONFIGURE = x && test -z "$*"; then
|
||||
echo
|
||||
fi
|
||||
|
||||
am_opt="--add-missing --copy --gnu -Wno-portability -Wno-obsolete"
|
||||
|
||||
case $CC in
|
||||
xlc )
|
||||
am_opt="$am_opt --include-deps";;
|
||||
am_opt=--include-deps;;
|
||||
esac
|
||||
|
||||
|
||||
@@ -144,8 +142,8 @@ if grep "^AC_CONFIG_HEADERS" configure.ac >/dev/null; then
|
||||
autoheader || { echo "**Error**: autoheader failed."; exit 1; }
|
||||
fi
|
||||
|
||||
echo "Running automake $am_opt ..."
|
||||
automake $am_opt ||
|
||||
echo "Running automake --gnu $am_opt ..."
|
||||
automake --add-missing --gnu -Wno-portability -Wno-obsolete $am_opt ||
|
||||
{ echo "**Error**: automake failed."; exit 1; }
|
||||
echo "Running autoconf ..."
|
||||
autoconf || { echo "**Error**: autoconf failed."; exit 1; }
|
||||
|
||||
+485
-1486
File diff suppressed because it is too large.
Load diff
@@ -11,8 +11,6 @@
|
||||
<dllmap dll="oci" target="libclntsh@libsuffix@" os="!windows"/>
|
||||
<dllmap dll="db2cli" target="libdb2_36@libsuffix@" os="!windows"/>
|
||||
<dllmap dll="MonoPosixHelper" target="$mono_libdir/libMonoPosixHelper@libsuffix@" os="!windows" />
|
||||
<dllmap dll="System.Native" target="$mono_libdir/libmono-system-native@libsuffix@" os="!windows" />
|
||||
<dllmap dll="System.Net.Security.Native" target="$mono_libdir/libmono-system-net-security-native@libsuffix@" os="!windows" />
|
||||
<dllmap dll="libmono-btls-shared" target="$mono_libdir/libmono-btls-shared@libsuffix@" os="!windows" />
|
||||
<dllmap dll="i:msvcrt" target="@LIBC@" os="!windows"/>
|
||||
<dllmap dll="i:msvcrt.dll" target="@LIBC@" os="!windows"/>
|
||||
|
||||
+12
-12
@@ -53,7 +53,7 @@ def stringify_class_name(ns, name):
|
||||
if ns == "":
|
||||
return name
|
||||
else:
|
||||
return "{0}.{1}".format (ns, name)
|
||||
return "{}.{}".format (ns, name)
|
||||
|
||||
class ArrayPrinter:
|
||||
"Print a C# array"
|
||||
@@ -66,7 +66,7 @@ class ArrayPrinter:
|
||||
def to_string(self):
|
||||
obj = self.val.cast (gdb.lookup_type ("MonoArray").pointer ()).dereference ()
|
||||
length = obj ['max_length']
|
||||
return "{0} [{1}]".format (stringify_class_name (self.class_ns, self.class_name [0:len (self.class_name) - 2]), int (length))
|
||||
return "{} [{}]".format (stringify_class_name (self.class_ns, self.class_name [0:len (self.class_name) - 2]), int (length))
|
||||
|
||||
class ObjectPrinter:
|
||||
"Print a C# object"
|
||||
@@ -96,7 +96,7 @@ class ObjectPrinter:
|
||||
return (field.name, self.obj [field.name])
|
||||
except:
|
||||
# Superclass
|
||||
return (field.name, self.obj.cast (gdb.lookup_type ("{0}".format (field.name))))
|
||||
return (field.name, self.obj.cast (gdb.lookup_type ("{}".format (field.name))))
|
||||
|
||||
def children(self):
|
||||
# FIXME: It would be easier if gdb.Value would support iteration itself
|
||||
@@ -109,7 +109,7 @@ class ObjectPrinter:
|
||||
class_name = obj ['vtable'].dereference ()['klass'].dereference ()['name'].string ()
|
||||
if class_name [-2:len(class_name)] == "[]":
|
||||
return {}.__iter__ ()
|
||||
gdb_type = gdb.lookup_type ("struct {0}_{1}".format (class_ns.replace (".", "_"), class_name))
|
||||
gdb_type = gdb.lookup_type ("struct {}_{}".format (class_ns.replace (".", "_"), class_name))
|
||||
return self._iterator(obj.cast (gdb_type))
|
||||
except:
|
||||
print (sys.exc_info ()[0])
|
||||
@@ -129,12 +129,12 @@ class ObjectPrinter:
|
||||
return ArrayPrinter (self.val,class_ns,class_name).to_string ()
|
||||
if class_ns != "":
|
||||
try:
|
||||
gdb_type = gdb.lookup_type ("struct {0}.{1}".format (class_ns, class_name))
|
||||
gdb_type = gdb.lookup_type ("struct {}.{}".format (class_ns, class_name))
|
||||
except:
|
||||
# Maybe there is no debug info for that type
|
||||
return "{0}.{1}".format (class_ns, class_name)
|
||||
return "{}.{}".format (class_ns, class_name)
|
||||
#return obj.cast (gdb_type)
|
||||
return "{0}.{1}".format (class_ns, class_name)
|
||||
return "{}.{}".format (class_ns, class_name)
|
||||
return class_name
|
||||
except:
|
||||
print (sys.exc_info ()[0])
|
||||
@@ -154,9 +154,9 @@ class MonoMethodPrinter:
|
||||
val = self.val.dereference ()
|
||||
klass = val ["klass"].dereference ()
|
||||
class_name = stringify_class_name (klass ["name_space"].string (), klass ["name"].string ())
|
||||
return "\"{0}:{1} ()\"".format (class_name, val ["name"].string ())
|
||||
return "\"{}:{} ()\"".format (class_name, val ["name"].string ())
|
||||
# This returns more info but requires calling into the inferior
|
||||
#return "\"{0}\"".format (gdb.parse_and_eval ("mono_method_full_name ({0}, 1)".format (str (int (self.val.cast (gdb.lookup_type ("guint64")))))).string ())
|
||||
#return "\"{}\"".format (gdb.parse_and_eval ("mono_method_full_name ({}, 1)".format (str (int (self.val.cast (gdb.lookup_type ("guint64")))))).string ())
|
||||
|
||||
class MonoClassPrinter:
|
||||
"Print a MonoClass structure"
|
||||
@@ -169,9 +169,9 @@ class MonoClassPrinter:
|
||||
return "0x0"
|
||||
klass = self.val.dereference ()
|
||||
class_name = stringify_class_name (klass ["name_space"].string (), klass ["name"].string ())
|
||||
return "\"{0}\"".format (class_name)
|
||||
return "\"{}\"".format (class_name)
|
||||
# This returns more info but requires calling into the inferior
|
||||
#return "\"{0}\"".format (gdb.parse_and_eval ("mono_type_full_name (&((MonoClass*){0})->byval_arg)".format (str (int ((self.val).cast (gdb.lookup_type ("guint64")))))))
|
||||
#return "\"{}\"".format (gdb.parse_and_eval ("mono_type_full_name (&((MonoClass*){})->byval_arg)".format (str (int ((self.val).cast (gdb.lookup_type ("guint64")))))))
|
||||
|
||||
def lookup_pretty_printer(val):
|
||||
t = str (val.type)
|
||||
@@ -245,4 +245,4 @@ exec_file = gdb.current_objfile ().filename
|
||||
if os.stat (exec_file).st_size != os.lstat (exec_file).st_size:
|
||||
exec_file = os.readlink (exec_file)
|
||||
exec_dir = os.path.dirname (exec_file)
|
||||
gdb.execute ("source {0}/{1}-gdbinit".format (exec_dir, os.path.basename (exec_file)))
|
||||
gdb.execute ("source {}/{}-gdbinit".format (exec_dir, os.path.basename (exec_file)))
|
||||
+16
-16
@@ -48,7 +48,7 @@ def stringify_class_name(ns, name):
|
||||
if ns == "":
|
||||
return name
|
||||
else:
|
||||
return "{0}.{1}".format (ns, name)
|
||||
return "{}.{}".format (ns, name)
|
||||
|
||||
class ArrayPrinter:
|
||||
"Print a C# array"
|
||||
@@ -61,7 +61,7 @@ class ArrayPrinter:
|
||||
def to_string(self):
|
||||
obj = self.val.cast (gdb.lookup_type ("MonoArray").pointer ()).dereference ()
|
||||
length = obj ['max_length']
|
||||
return "{0} [{1}]".format (stringify_class_name (self.class_ns, self.class_name [0:len(self.class_name) - 2]), int(length))
|
||||
return "{} [{}]".format (stringify_class_name (self.class_ns, self.class_name [0:len(self.class_name) - 2]), int(length))
|
||||
|
||||
class ObjectPrinter:
|
||||
"Print a C# object"
|
||||
@@ -91,7 +91,7 @@ class ObjectPrinter:
|
||||
return (field.name, self.obj [field.name])
|
||||
except:
|
||||
# Superclass
|
||||
return (field.name, self.obj.cast (gdb.lookup_type ("{0}".format (field.name))))
|
||||
return (field.name, self.obj.cast (gdb.lookup_type ("{}".format (field.name))))
|
||||
|
||||
def children(self):
|
||||
# FIXME: It would be easier if gdb.Value would support iteration itself
|
||||
@@ -105,7 +105,7 @@ class ObjectPrinter:
|
||||
if class_name [-2:len(class_name)] == "[]":
|
||||
return {}.__iter__ ()
|
||||
try:
|
||||
gdb_type = gdb.lookup_type ("struct {0}_{1}".format (class_ns.replace (".", "_"), class_name))
|
||||
gdb_type = gdb.lookup_type ("struct {}_{}".format (class_ns.replace (".", "_"), class_name))
|
||||
return self._iterator(obj.cast (gdb_type))
|
||||
except:
|
||||
return {}.__iter__ ()
|
||||
@@ -127,12 +127,12 @@ class ObjectPrinter:
|
||||
return ArrayPrinter (self.val,class_ns,class_name).to_string ()
|
||||
if class_ns != "":
|
||||
try:
|
||||
gdb_type = gdb.lookup_type ("struct {0}.{1}".format (class_ns, class_name))
|
||||
gdb_type = gdb.lookup_type ("struct {}.{}".format (class_ns, class_name))
|
||||
except:
|
||||
# Maybe there is no debug info for that type
|
||||
return "{0}.{1}".format (class_ns, class_name)
|
||||
return "{}.{}".format (class_ns, class_name)
|
||||
#return obj.cast (gdb_type)
|
||||
return "{0}.{1}".format (class_ns, class_name)
|
||||
return "{}.{}".format (class_ns, class_name)
|
||||
return class_name
|
||||
except:
|
||||
print (sys.exc_info ()[0])
|
||||
@@ -152,9 +152,9 @@ class MonoMethodPrinter:
|
||||
val = self.val.dereference ()
|
||||
klass = val ["klass"].dereference ()
|
||||
class_name = stringify_class_name (klass ["name_space"].string (), klass ["name"].string ())
|
||||
return "\"{0}:{1} ()\"".format (class_name, val ["name"].string ())
|
||||
return "\"{}:{} ()\"".format (class_name, val ["name"].string ())
|
||||
# This returns more info but requires calling into the inferior
|
||||
#return "\"{0}\"".format (gdb.parse_and_eval ("mono_method_full_name ({0}, 1)".format (str (int (self.val.cast (gdb.lookup_type ("guint64")))))).string ())
|
||||
#return "\"{}\"".format (gdb.parse_and_eval ("mono_method_full_name ({}, 1)".format (str (int (self.val.cast (gdb.lookup_type ("guint64")))))).string ())
|
||||
|
||||
class MonoClassPrinter:
|
||||
"Print a MonoClass structure"
|
||||
@@ -168,11 +168,11 @@ class MonoClassPrinter:
|
||||
klass = self.val.dereference ()
|
||||
class_name = stringify_class_name (klass ["name_space"].string (), klass ["name"].string ())
|
||||
if add_quotes:
|
||||
return "\"{0}\"".format (class_name)
|
||||
return "\"{}\"".format (class_name)
|
||||
else:
|
||||
return class_name
|
||||
# This returns more info but requires calling into the inferior
|
||||
#return "\"{0}\"".format (gdb.parse_and_eval ("mono_type_full_name (&((MonoClass*){0})->byval_arg)".format (str (int ((self.val).cast (gdb.lookup_type ("guint64")))))))
|
||||
#return "\"{}\"".format (gdb.parse_and_eval ("mono_type_full_name (&((MonoClass*){})->byval_arg)".format (str (int ((self.val).cast (gdb.lookup_type ("guint64")))))))
|
||||
|
||||
def to_string(self):
|
||||
try:
|
||||
@@ -220,7 +220,7 @@ class MonoGenericClassPrinter:
|
||||
method_inst_str = ""
|
||||
if int(method_inst.cast (gdb.lookup_type ("guint64"))) != 0:
|
||||
method_inst_str = str(method_inst)
|
||||
return "{0}, [{1}], [{2}]>".format (container_str, class_inst_str, method_inst_str)
|
||||
return "{}, [{}], [{}]>".format (container_str, class_inst_str, method_inst_str)
|
||||
|
||||
def to_string(self):
|
||||
try:
|
||||
@@ -250,9 +250,9 @@ class MonoTypePrinter:
|
||||
info = str(t ["data"]["generic_class"])
|
||||
|
||||
if info != "":
|
||||
return "{{{0}, {1}}}".format (kind, info)
|
||||
return "{{{}, {}}}".format (kind, info)
|
||||
else:
|
||||
return "{{{0}}}".format (kind)
|
||||
return "{{{}}}".format (kind)
|
||||
except:
|
||||
#print (sys.exc_info ()[0])
|
||||
#print (sys.exc_info ()[1])
|
||||
@@ -281,7 +281,7 @@ class MonoMethodRgctxPrinter:
|
||||
if i > 0:
|
||||
inst_str = inst_str + ", "
|
||||
inst_str = inst_str + type_printer.to_string ()
|
||||
return "MRGCTX[{0}, [{1}]]".format (klass_printer.to_string(), inst_str)
|
||||
return "MRGCTX[{}, [{}]]".format (klass_printer.to_string(), inst_str)
|
||||
|
||||
class MonoVTablePrinter:
|
||||
"Print a MonoVTable structure"
|
||||
@@ -296,7 +296,7 @@ class MonoVTablePrinter:
|
||||
klass = vtable ["klass"]
|
||||
klass_printer = MonoClassPrinter (klass)
|
||||
|
||||
return "vtable({0})".format (klass_printer.to_string ())
|
||||
return "vtable({})".format (klass_printer.to_string ())
|
||||
|
||||
def lookup_pretty_printer(val):
|
||||
t = str (val.type)
|
||||
|
||||
+2
-2
@@ -11,9 +11,9 @@ def print_frames(thread, num_frames, current_thread):
|
||||
pc = str(frame.addr)
|
||||
var = frame
|
||||
function_name = frame.GetFunctionName()
|
||||
if function_name == "interp_exec_method_full":
|
||||
if function_name == "ves_exec_method_with_context":
|
||||
try:
|
||||
s = 'frame->imethod->method'
|
||||
s = 'frame->runtime_method->method'
|
||||
klassname = frame.EvaluateExpression('(char*) ' + s + '->klass->name').summary[1:-1]
|
||||
methodname = frame.EvaluateExpression('(char*) ' + s + '->name').summary[1:-1]
|
||||
|
||||
|
||||
@@ -116,7 +116,7 @@
|
||||
<add prefix="http" type="System.Net.HttpRequestCreator, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="https" type="System.Net.HttpRequestCreator, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="file" type="System.Net.FileWebRequestCreator, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="ftp" type="System.Net.FtpWebRequestCreator, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="ftp" type="System.Net.FtpRequestCreator, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
</webRequestModules>
|
||||
</system.net>
|
||||
|
||||
|
||||
@@ -132,7 +132,7 @@
|
||||
<add prefix="http" type="System.Net.HttpRequestCreator, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="https" type="System.Net.HttpRequestCreator, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="file" type="System.Net.FileWebRequestCreator, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="ftp" type="System.Net.FtpWebRequestCreator, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="ftp" type="System.Net.FtpRequestCreator, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
</webRequestModules>
|
||||
<settings>
|
||||
<ipv6 enabled="false"/>
|
||||
|
||||
@@ -133,7 +133,7 @@
|
||||
<add prefix="http" type="System.Net.HttpRequestCreator, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="https" type="System.Net.HttpRequestCreator, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="file" type="System.Net.FileWebRequestCreator, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="ftp" type="System.Net.FtpWebRequestCreator, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="ftp" type="System.Net.FtpRequestCreator, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
</webRequestModules>
|
||||
</system.net>
|
||||
|
||||
|
||||
@@ -11,11 +11,11 @@
|
||||
<section name="assemblyBinding" type="System.Configuration.IgnoreSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowLocation="false" />
|
||||
<section name="satelliteassemblies" type="System.Configuration.IgnoreSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowLocation="false" />
|
||||
<section name="startup" type="System.Configuration.IgnoreSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowLocation="false"/>
|
||||
<section name="system.codedom" type="System.CodeDom.Compiler.CodeDomConfigurationHandler, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<section name="system.data" type="System.Data.Common.DbProviderFactoriesConfigurationHandler, System.Data, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<section name="system.diagnostics" type="System.Diagnostics.SystemDiagnosticsSection, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<section name="system.runtime.remoting" type="System.Configuration.IgnoreSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowLocation="false"/>
|
||||
<section name="system.windows.forms" type="System.Windows.Forms.WindowsFormsSection, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<section name="system.codedom" type="System.CodeDom.Compiler.CodeDomConfigurationHandler, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<section name="windows" type="System.Configuration.IgnoreSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowLocation="false" />
|
||||
<section name="strongNames" type="System.Configuration.IgnoreSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowLocation="false"/>
|
||||
<sectionGroup name="system.runtime.serialization" type="System.Runtime.Serialization.Configuration.SerializationSectionGroup, System.Runtime.Serialization, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">
|
||||
@@ -136,7 +136,7 @@
|
||||
<add prefix="http" type="System.Net.HttpRequestCreator, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="https" type="System.Net.HttpRequestCreator, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="file" type="System.Net.FileWebRequestCreator, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="ftp" type="System.Net.FtpWebRequestCreator, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
<add prefix="ftp" type="System.Net.FtpRequestCreator, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
|
||||
</webRequestModules>
|
||||
</system.net>
|
||||
|
||||
|
||||
@@ -43,16 +43,6 @@
|
||||
line-height: 0px;
|
||||
}
|
||||
|
||||
.mapi-codeblock {
|
||||
display: block;
|
||||
padding: 5pt 5pt;
|
||||
margin: 10pt;
|
||||
white-space: pre;
|
||||
font-family: monospace;
|
||||
border: 1px solid rgba(233,233,233,1);
|
||||
background-color: rgba(249,249,249,1);
|
||||
}
|
||||
|
||||
.mapi-entry code {
|
||||
border: none;
|
||||
background-color: transparent;
|
||||
|
||||
+2
-2
@@ -13,10 +13,10 @@ ASSEMBLED_DOCS = \
|
||||
monoapi.tree monoapi.zip
|
||||
|
||||
convert.exe: $(srcdir)/convert.cs AgilityPack.dll
|
||||
$(CSCOMPILE) -r:$(topdir)/class/lib/$(PROFILE)/mscorlib.dll -r:$(topdir)/class/lib/$(PROFILE)/System.Xml.dll -out:$@ $< -r:AgilityPack.dll
|
||||
$(CSCOMPILE) -r:$(topdir)/class/lib/$(PROFILE)/System.Xml.dll -out:$@ $< -r:AgilityPack.dll
|
||||
|
||||
AgilityPack.dll:
|
||||
$(CSCOMPILE) -r:$(topdir)/class/lib/$(PROFILE)/mscorlib.dll -r:$(topdir)/class/lib/$(PROFILE)/System.dll -r:$(topdir)/class/lib/$(PROFILE)/System.Xml.dll -target:library -out:$@ $(srcdir)/HtmlAgilityPack/*.cs
|
||||
$(CSCOMPILE) -r:$(topdir)/class/lib/$(PROFILE)/System.dll -r:$(topdir)/class/lib/$(PROFILE)/System.Xml.dll -target:library -out:$@ $(srcdir)/HtmlAgilityPack/*.cs
|
||||
|
||||
monoapi.zip: monoapi.tree
|
||||
@test -f $@ || { rm -f $< && $(MAKE) $<; }
|
||||
|
||||
+1
-1
@@ -69,5 +69,5 @@ object for filters is passed in a local variable (cfg->exvar).
|
||||
throw: we first save all regs into a sigcontext struct and then call the stack
|
||||
unwinding code.
|
||||
|
||||
catch handler: catch handlers are always called from the stack unwinding
|
||||
catch handler: catch hanlders are always called from the stack unwinding
|
||||
code. The exception object is passed in a local variable (cfg->exvar).
|
||||
+4
-20
@@ -124,7 +124,6 @@ sub process_function {
|
||||
my $body = '';
|
||||
my $returns = '';
|
||||
my $prototype = '';
|
||||
my $codeblock = 'false';
|
||||
|
||||
while (<$file>) {
|
||||
|
||||
@@ -157,6 +156,7 @@ sub process_function {
|
||||
if (defined($deprecated)) {
|
||||
process_formatting(\$deprecated, $file_path, $.);
|
||||
}
|
||||
$body =~ s/\n/ /g;
|
||||
|
||||
if (exists($docs->{body}->{$name})) {
|
||||
my $origin = $docs->{origin}->{$name};
|
||||
@@ -180,16 +180,8 @@ sub process_function {
|
||||
chomp;
|
||||
s/^ +\*//;
|
||||
|
||||
if (/\s*\\code$/) {
|
||||
$codeblock = 'true';
|
||||
} elsif (/\s*\\endcode$/) {
|
||||
$codeblock = 'false';
|
||||
}
|
||||
|
||||
# Replace blank lines with paragraph breaks if we're not in a code block.
|
||||
if (/^\s*$/) {
|
||||
$_ = '<p>' if $codeblock eq 'false';
|
||||
}
|
||||
# Replace blank lines with paragraph breaks.
|
||||
$_ = '<p>' if /^\s*$/;
|
||||
|
||||
if ($section == $PARAMETER_SECTION) {
|
||||
if (/\s*\\param +(\w+)(.*)/) {
|
||||
@@ -218,7 +210,7 @@ sub process_function {
|
||||
$returns = "\t$_\n";
|
||||
$section = $RETURN_SECTION;
|
||||
} else {
|
||||
$body .= "\n$_";
|
||||
$body .= "\n\t$_";
|
||||
}
|
||||
} elsif ($section == $RETURN_SECTION) {
|
||||
$returns .= "\n\t$_";
|
||||
@@ -235,12 +227,6 @@ sub process_formatting {
|
||||
my ($content, $file_path, $current_line) = @_;
|
||||
$_ = $$content;
|
||||
|
||||
# General formatting
|
||||
s{\\b +(\w+)}{<strong>$1</strong>}g;
|
||||
s{\\a +(\w+)}{<i>$1</i>}g;
|
||||
s{\\e +(\w+)}{<i>$1</i>}g;
|
||||
s{\\em +(\w+)}{<i>$1</i>}g;
|
||||
|
||||
# Constants
|
||||
s{NULL}{<code>NULL</code>}g;
|
||||
s{TRUE}{<code>TRUE</code>}g;
|
||||
@@ -257,8 +243,6 @@ sub process_formatting {
|
||||
warn "$file_path:$current_line: Old-style monodoc notation '`code`' used\n"
|
||||
if s{\`((?!api:)[:.\w\*]+)\`}{<code>$1</code>}g && $WARNINGS;
|
||||
s{\\c +(\S+(?<![.,:;]))}{<code>$1</code>}g;
|
||||
s{\\code}{<pre><code class="mapi-codeblock">}g;
|
||||
s{\\endcode}{</code></pre>}g;
|
||||
|
||||
$$content = $_;
|
||||
}
|
||||
|
||||
-109
@@ -1,109 +0,0 @@
|
||||
# Mono RISC-V Port
|
||||
|
||||
These are some useful links and notes pertaining to the RISC-V port of Mono.
|
||||
|
||||
## Useful RISC-V documents
|
||||
|
||||
* [RISC-V User-Level ISA Specification](https://riscv.org/specifications/)
|
||||
* [RISC-V Privileged ISA Specification](https://riscv.org/specifications/privileged-isa/)
|
||||
* [RISC-V Debug Specification Standard](https://github.com/riscv/riscv-debug-spec/blob/master/riscv-debug-spec.pdf)
|
||||
* [RISC-V Assembly Programmer's Manual](https://github.com/riscv/riscv-asm-manual/blob/master/riscv-asm.md)
|
||||
* [RISC-V ELF psABI Specification](https://github.com/riscv/riscv-elf-psabi-doc/blob/master/riscv-elf.md)
|
||||
|
||||
## Useful RISC-V repositories
|
||||
|
||||
* [RISC-V Organization](https://github.com/riscv)
|
||||
* [RISC-V Linux](https://github.com/riscv/riscv-linux)
|
||||
* [RISC-V LLD](https://github.com/riscv/riscv-lld)
|
||||
* [RISC-V Tools](https://github.com/riscv/riscv-tools)
|
||||
* [RISC-V GNU Toolchain](https://github.com/riscv/riscv-gnu-toolchain)
|
||||
* [RISC-V Binutils](https://github.com/riscv/riscv-binutils-gdb)
|
||||
* [RISC-V GCC](https://github.com/riscv/riscv-gcc)
|
||||
* [RISC-V Glibc](https://github.com/riscv/riscv-glibc)
|
||||
* [RISC-V Newlib](https://github.com/riscv/riscv-newlib)
|
||||
* [RISC-V QEMU](https://github.com/riscv/riscv-qemu)
|
||||
* [RISC-V Opcodes](https://github.com/riscv/riscv-opcodes)
|
||||
* [RISC-V Tests](https://github.com/riscv/riscv-tests)
|
||||
* [lowRISC Organization](https://github.com/lowrisc)
|
||||
* [RISC-V LLVM](https://github.com/lowrisc/riscv-llvm)
|
||||
|
||||
## Setting up a cross environment
|
||||
|
||||
Setting up a cross environment with a Linux toolchain and QEMU is quite easy.
|
||||
|
||||
First, add these to your `.bashrc` (or some other script that you run):
|
||||
|
||||
```bash
|
||||
export RISCV=$HOME/riscv
|
||||
export PATH=$RISCV/bin:$PATH
|
||||
export QEMU_LD_PREFIX=$RISCV/sysroot
|
||||
```
|
||||
|
||||
Install some dependencies needed to build the toolchain:
|
||||
|
||||
```console
|
||||
# apt install sudo apt-get install autoconf automake autotools-dev curl libmpc-dev libmpfr-dev libgmp-dev libusb-1.0-0-dev gawk build-essential bison flex texinfo gperf libtool patchutils bc zlib1g-dev device-tree-compiler pkg-config libexpat-dev
|
||||
```
|
||||
|
||||
Now you can build the toolchain:
|
||||
|
||||
```console
|
||||
$ git clone --recursive [email protected]:riscv/riscv-tools.git
|
||||
$ cd riscv-tools
|
||||
$ ./build.sh
|
||||
$ cd riscv-gnu-toolchain
|
||||
$ ./configure --prefix=$RISCV --enable-multilib
|
||||
$ make linux
|
||||
$ cd ../..
|
||||
$ git clone --recursive [email protected]:riscv/riscv-qemu.git
|
||||
$ cd riscv-qemu
|
||||
$ mkdir build
|
||||
$ cd build
|
||||
$ ../configure --prefix=$RISCV --disable-werror
|
||||
$ make
|
||||
$ make install
|
||||
```
|
||||
|
||||
## Building Mono with a cross toolchain
|
||||
|
||||
Building Mono is quite straightforward:
|
||||
|
||||
```console
|
||||
$ ./autogen.sh --prefix=$RISCV/sysroot --host=riscv64-unknown-linux-gnu
|
||||
$ make
|
||||
$ make install
|
||||
```
|
||||
|
||||
You can set `CFLAGS` as appropriate to change the RISC-V options, such as which
|
||||
standard extensions and ABI to use. For example, to use the 64-bit soft float
|
||||
ABI:
|
||||
|
||||
```console
|
||||
$ CFLAGS="-mabi=lp64" ./autogen.sh --prefix=$RISCV/sysroot --host=riscv64-unknown-linux-gnu
|
||||
```
|
||||
|
||||
Note that, since this is a cross build, the `mcs` directory won't be built. You
|
||||
will have to build the managed libraries and tools through a native build of
|
||||
Mono and copy them into `$RISCV/sysroot`.
|
||||
|
||||
You can run Mono with QEMU like this:
|
||||
|
||||
```console
|
||||
$ qemu-riscv64 $RISCV/sysroot/bin/mono hello.exe
|
||||
```
|
||||
|
||||
## Things to be done
|
||||
|
||||
In no particular order:
|
||||
|
||||
* Complete the soft float port.
|
||||
* Complete the 32-bit port.
|
||||
* Add unwind info to trampolines.
|
||||
* Implement AOT support.
|
||||
* Implement interpreter support.
|
||||
* Implement LLVM support.
|
||||
* Implement SDB support.
|
||||
* Implement `dyn_call` support.
|
||||
* Ensure all runtime tests pass.
|
||||
* Ensure all corlib tests pass.
|
||||
* Set up CI on Jenkins.
|
||||
@@ -1,193 +1,73 @@
|
||||
<h1>Runtime Profiler API</h1>
|
||||
<h1>Profiling Interface</h1>
|
||||
|
||||
<p>The profiler API can be used by dynamically loaded profiler
|
||||
modules to monitor different aspects of a running program. The
|
||||
API is also usable by embedders without having to compile a
|
||||
profiler module.
|
||||
<h3>Profiler Operation</h3>
|
||||
|
||||
<h2>Profiler Modules</h2>
|
||||
<p>The following methods can be used by dynamic profiler
|
||||
methods to monitor different aspects of the program.
|
||||
|
||||
<p>A profiler module is simply a shared library with a single
|
||||
exported function which is the entry point that Mono calls at
|
||||
startup. It must have the following signature:
|
||||
<p>A custom profiler will have one public method defined in
|
||||
the shared library which is the entry point that Mono calls at
|
||||
startup, it has the following signature:
|
||||
|
||||
<pre><code class="mapi-codeblock">
|
||||
void mono_profiler_startup_example (const char *desc)
|
||||
</code></pre>
|
||||
<pre>
|
||||
void mono_profiler_startup (const char *desc)
|
||||
</pre>
|
||||
|
||||
<p>Here, the <code>example</code> portion of the function name is
|
||||
the name of the profiler module. It must match the shared library
|
||||
name (i.e. <code>libmono-profiler-example.so</code>). <i>desc</i>
|
||||
is the set of arguments that were passed from the command line.
|
||||
<p>Where "desc" is the set of arguments that were passed from
|
||||
the command line. This routine will call
|
||||
<tt>mono_profiler_install</tt> to activate the profiler and
|
||||
will install one or more filters (one of the various
|
||||
<tt>mono_profiler_install_</tt> functions).
|
||||
|
||||
<p>For example, a bare bones profiler module might look like this
|
||||
(<code>example.c</code>):
|
||||
<p>In addition, a profiler developer will typically call
|
||||
<tt>mono_profiler_set_events</tt> to register which kinds of
|
||||
traces should be enabled, these can be an OR-ed combination of
|
||||
the following:
|
||||
|
||||
<pre><code class="mapi-codeblock">
|
||||
#include <mono/metadata/profiler.h>
|
||||
#include <stdio.h>
|
||||
<pre>
|
||||
MONO_PROFILE_NONE
|
||||
MONO_PROFILE_APPDOMAIN_EVENTS
|
||||
MONO_PROFILE_ASSEMBLY_EVENTS
|
||||
MONO_PROFILE_MODULE_EVENTS
|
||||
MONO_PROFILE_CLASS_EVENTS
|
||||
MONO_PROFILE_JIT_COMPILATION
|
||||
MONO_PROFILE_INLINING
|
||||
MONO_PROFILE_EXCEPTIONS
|
||||
MONO_PROFILE_ALLOCATIONS
|
||||
MONO_PROFILE_GC
|
||||
MONO_PROFILE_THREADS
|
||||
MONO_PROFILE_REMOTING
|
||||
MONO_PROFILE_TRANSITIONS
|
||||
MONO_PROFILE_ENTER_LEAVE
|
||||
MONO_PROFILE_COVERAGE
|
||||
MONO_PROFILE_INS_COVERAGE
|
||||
MONO_PROFILE_STATISTICAL
|
||||
</pre>
|
||||
|
||||
struct _MonoProfiler {
|
||||
int dummy;
|
||||
}
|
||||
<p>Developers can change the set of monitored events at
|
||||
runtime by calling <tt>mono_profiler_set_events</tt>.
|
||||
|
||||
<h4><a name="api:mono_profiler_install">mono_profiler_install</a></h4>
|
||||
<h4><a name="api:mono_profiler_install_allocation">mono_profiler_install_allocation</a></h4>
|
||||
<h4><a name="api:mono_profiler_install_appdomain">mono_profiler_install_appdomain</a></h4>
|
||||
<h4><a name="api:mono_profiler_install_assembly">mono_profiler_install_assembly</a></h4>
|
||||
<h4><a name="api:mono_profiler_install_class">mono_profiler_install_class</a></h4>
|
||||
<h4><a name="api:mono_profiler_install_coverage_filter">mono_profiler_install_coverage_filter</a></h4>
|
||||
<h4><a name="api:mono_profiler_install_enter_leave">mono_profiler_install_enter_leave</a></h4>
|
||||
<h4><a name="api:mono_profiler_install_jit_compile">mono_profiler_install_jit_compile</a></h4>
|
||||
<h4><a name="api:mono_profiler_install_module">mono_profiler_install_module</a></h4>
|
||||
<h4><a name="api:mono_profiler_install_thread">mono_profiler_install_thread</a></h4>
|
||||
<h4><a name="api:mono_profiler_install_transition">mono_profiler_install_transition</a></h4>
|
||||
<h4><a name="api:mono_profiler_install_gc">mono_profiler_install_gc</a></h4>
|
||||
<h4><a name="api:mono_profiler_install_statistical">mono_profiler_install_statistical</a></h4>
|
||||
<h4><a name="api:mono_profiler_set_events">mono_profiler_set_events</a></h4>
|
||||
<h4><a name="api:mono_profiler_get_events">mono_profiler_get_events</a></h4>
|
||||
|
||||
static MonoProfiler profiler;
|
||||
<h3>Coverage</h3>
|
||||
|
||||
static void
|
||||
runtime_inited (MonoProfiler *prof)
|
||||
{
|
||||
printf ("Hello World");
|
||||
}
|
||||
<p>To support profiling modules that need to do code coverage
|
||||
analysis, the following routines is provided:
|
||||
|
||||
<h4><a name="api:mono_profiler_coverage_get">mono_profiler_coverage_get</a></h4>
|
||||
|
||||
void
|
||||
mono_profiler_init_example (const char *desc)
|
||||
{
|
||||
MonoProfilerHandle handle = mono_profiler_create (&profiler);
|
||||
mono_profiler_set_runtime_initialized_callback (handle, runtime_inited);
|
||||
}
|
||||
</code></pre>
|
||||
|
||||
<p>To compile this module, a C compiler must be invoked in a
|
||||
similar fashion to this, on Linux:
|
||||
|
||||
<pre><code class="mapi-codeblock">
|
||||
gcc -fPIC -shared -o libmono-profiler-example.so example.c `pkg-config --cflags mono-2`
|
||||
</code></pre>
|
||||
|
||||
<p>Or on OS X:
|
||||
|
||||
<pre><code class="mapi-codeblock">
|
||||
gcc -undefined suppress -flat_namespace -o libmono-profiler-example.so example.c `pkg-config --cflags mono-2`
|
||||
</code></pre>
|
||||
|
||||
<p>You can then load the module using:
|
||||
|
||||
<pre><code class="mapi-codeblock">
|
||||
mono --profile=example hello.exe
|
||||
</code></pre>
|
||||
|
||||
<p>(Note that adjusting <code>LD_LIBRARY_PATH</code> may be
|
||||
necessary in order for the dynamic linker to find the module.)
|
||||
|
||||
<h2>Profiler Functions</h2>
|
||||
|
||||
<p>These are the functions usable for profiling programs.
|
||||
|
||||
<p>Each function has a note indicating whether they're async
|
||||
safe. An async safe function can be invoked in a signal handler
|
||||
or when the world is stopped by the GC. Conversely, a function
|
||||
that is not async safe must not be invoked in such a context or
|
||||
undefined behavior can occur (crashes, deadlocks, etc).
|
||||
|
||||
<p>Some functions may only be invoked from a profiler module's
|
||||
init function (or prior to running managed code in the case of
|
||||
embedding). This is noted explicitly only if applicable to a
|
||||
function.
|
||||
|
||||
<h3>Basic Functions</h3>
|
||||
|
||||
<p>These functions are used to load and install profilers.
|
||||
|
||||
<h4><a name="api:mono_profiler_load">mono_profiler_load</a></h4>
|
||||
<h4><a name="api:mono_profiler_create">mono_profiler_create</a></h4>
|
||||
<h4><a name="api:mono_profiler_set_cleanup_callback">mono_profiler_set_cleanup_callback</a></h4>
|
||||
|
||||
<h3>Code Coverage</h3>
|
||||
|
||||
<p>These functions provide access to the JIT compiler's code
|
||||
coverage support. This functionality can be used to collect
|
||||
information about how many times certain code paths have been
|
||||
executed.
|
||||
|
||||
<h4><a name="api:mono_profiler_enable_coverage">mono_profiler_enable_coverage</a></h4>
|
||||
<h4><a name="api:mono_profiler_set_coverage_filter_callback">mono_profiler_set_coverage_filter_callback</a></h4>
|
||||
<h4><a name="api:mono_profiler_get_coverage_data">mono_profiler_get_coverage_data</a></h4>
|
||||
|
||||
<h3>Statistical Sampling</h3>
|
||||
|
||||
<p>Statistical sampling can be used to interrupt managed threads
|
||||
based on a certain mode and frequency for the purpose of
|
||||
collecting data about their current work.
|
||||
|
||||
<p>One common use case for this functionality, usually referred
|
||||
to as call sampling, is to collect a backtrace from every thread
|
||||
when a sampling hit event arrives. This data can then be compiled
|
||||
into a report indicating where a program spends most of its time.
|
||||
|
||||
<h4><a name="api:mono_profiler_enable_sampling">mono_profiler_enable_sampling</a></h4>
|
||||
<h4><a name="api:mono_profiler_set_sample_mode">mono_profiler_set_sample_mode</a></h4>
|
||||
<h4><a name="api:mono_profiler_get_sample_mode">mono_profiler_get_sample_mode</a></h4>
|
||||
|
||||
<p>A callback must be registered to receive sample hit events.
|
||||
Please see the <i>Callback Registration</i> section below.
|
||||
|
||||
<h3>GC Allocations</h3>
|
||||
|
||||
<p>Profilers can be notified about all GC allocations performed
|
||||
by a program or the Mono runtime.
|
||||
|
||||
<h4><a name="api:mono_profiler_enable_allocations">mono_profiler_enable_allocations</a></h4>
|
||||
|
||||
<p>A callback must be registered to receive allocation events.
|
||||
Please see the <i>Callback Registration</i> section below.
|
||||
|
||||
<h3>Call Instrumentation</h3>
|
||||
|
||||
<p>The JIT compiler supports instrumenting managed method entry
|
||||
and exit points so that a profiler callback will be invoked.
|
||||
|
||||
<p>While such callbacks by themselves have traditionally only
|
||||
been useful for call count profiling and the like, Mono gives
|
||||
these callbacks access to the arguments, locals, and return
|
||||
value of instrumented methods (together referred to as the 'call
|
||||
context'). This enables many profiling scenarios that would
|
||||
otherwise have required explicit hooks in the base class
|
||||
libraries.
|
||||
|
||||
<h4><a name="api:mono_profiler_set_call_instrumentation_filter_callback">mono_profiler_set_call_instrumentation_filter_callback</a></h4>
|
||||
<h4><a name="api:mono_profiler_enable_call_context_introspection">mono_profiler_enable_call_context_introspection</a></h4>
|
||||
<h4><a name="api:mono_profiler_call_context_get_this">mono_profiler_call_context_get_this</a></h4>
|
||||
<h4><a name="api:mono_profiler_call_context_get_argument">mono_profiler_call_context_get_argument</a></h4>
|
||||
<h4><a name="api:mono_profiler_call_context_get_local">mono_profiler_call_context_get_local</a></h4>
|
||||
<h4><a name="api:mono_profiler_call_context_get_result">mono_profiler_call_context_get_result</a></h4>
|
||||
<h4><a name="api:mono_profiler_call_context_free_buffer">mono_profiler_call_context_free_buffer</a></h4>
|
||||
|
||||
<p>Callbacks must be registered to receive method entry and exit
|
||||
events. Please see the <i>Callback Registration</i> section
|
||||
below.
|
||||
|
||||
<h3>Callback Registration</h3>
|
||||
|
||||
<p>In addition to the above functions, there's a large set of
|
||||
functions for installing generic profiler event callbacks. These
|
||||
are generated from C macros and so are not documented here.
|
||||
Please refer to the <code>mono/metadata/profiler.h</code> and
|
||||
<code>mono/metadata/profiler-events.h</code> headers for a full
|
||||
listing of these.
|
||||
|
||||
<p>Callback registration functions are all async safe and can be
|
||||
safely invoked from multiple threads at the same time, with the
|
||||
caveat that altering a registered callback from one thread will
|
||||
not immediately affect another thread that is already invoking
|
||||
the current callback.
|
||||
|
||||
<h2>API Stability</h2>
|
||||
|
||||
<p>The profiler API does not have the same API stability
|
||||
garantees that the rest of the Mono embedding API does. While
|
||||
a breaking change to the profiler API is extremely rare, it has
|
||||
happened in the past when changing the API in a backwards
|
||||
compatible way was deemed to be too much work for too little
|
||||
gain.
|
||||
|
||||
<p>Therefore, developers of profiler modules may rarely need to
|
||||
update their code to work with new versions of the profiler API.
|
||||
|
||||
<p>Developers who wish to support older versions of the API can
|
||||
perform a compile time check of the
|
||||
<code>MONO_PROFILER_API_VERSION</code> macro and maintain code
|
||||
for both old and new versions.
|
||||
|
||||
<p>To aid with transitioning to a new version of the profiler
|
||||
API, the Mono runtime will detect and reject loading profiler
|
||||
modules which were compiled against older profiler API versions.
|
||||
Vendored
+1
-1
Submodule external/api-snapshot updated: ddf8f364be...6668c80a94.
Vendored
+1
-1
Submodule external/binary-reference-assemblies updated: bdc6cdaabf...e048fe4a88.
Vendored
+1
-1
Submodule external/bockbuild updated: 4d68269934...cb4545409d.
Vendored
+1
-1
Submodule external/boringssl updated: 41221b45aa...3e0770e188.
Vendored
+1
-1
Submodule external/cecil updated: b6c50e3d34...76ffcdabae.
Vendored
+1
-1
Submodule external/corefx updated: 492f805884...b965d1f8b5.
Vendored
+1
-1
Submodule external/corert updated: efd29b5cf8...48dba73801.
Vendored
+1
-1
Submodule external/ikdasm updated: 471d5827c9...465c081555.
Vendored
+1
-1
Submodule external/linker updated: db6d1a3246...c62335c350.
Vendored
+1
-1
Submodule external/nuget-buildtasks updated: 9955847957...b2c30bc81b.
Vendored
+1
-1
Submodule external/nunit-lite updated: e64e0197a8...764656cdaf.
Vendored
+1
-1
Submodule external/roslyn-binaries updated: 09a97af42a...e484c75e2e.
Vendored
+1
-1
Submodule external/xunit-binaries updated: 3c3659bc0f...d4433b0972.
@@ -1,11 +1,9 @@
|
||||
|
||||
AM_CPPFLAGS = $(GLIB_CFLAGS)
|
||||
|
||||
glib_libs = $(top_builddir)/mono/eglib/libeglib.la
|
||||
|
||||
lib_LTLIBRARIES = libikvm-native.la
|
||||
|
||||
libikvm_native_la_SOURCES = jni.c os.c jni.h
|
||||
|
||||
libikvm_native_la_LDFLAGS = -avoid-version
|
||||
libikvm_native_la_LIBADD = $(glib_libs)
|
||||
libikvm_native_la_LIBADD = $(GLIB_LIBS)
|
||||
+1
-1
@@ -49,7 +49,7 @@ obj_map.c os_dep.c pcr_interface.c ptr_chck.c real_malloc.c reclaim.c \
|
||||
solaris_pthreads.c solaris_threads.c specific.c stubborn.c typd_mlc.c \
|
||||
backgraph.c win32_threads.c \
|
||||
pthread_support.c pthread_stop_world.c darwin_stop_world.c \
|
||||
mach_dep.c $(asm_libgc_sources)
|
||||
openbsd_stop_world.c mach_dep.c $(asm_libgc_sources)
|
||||
|
||||
# Include THREADDLLIBS here to ensure that the correct versions of
|
||||
# linuxthread semaphore functions get linked:
|
||||
|
||||
+4
-5
@@ -74,13 +74,12 @@ if test x$NOCONFIGURE = x && test -z "$*"; then
|
||||
echo
|
||||
fi
|
||||
|
||||
am_opt="--add-missing --copy --gnu -Wno-obsolete"
|
||||
|
||||
case $CC in
|
||||
xlc )
|
||||
am_opt="$am_opt --include-deps";;
|
||||
am_opt=--include-deps;;
|
||||
esac
|
||||
|
||||
|
||||
if grep "^AC_PROG_LIBTOOL" configure.ac >/dev/null; then
|
||||
if test -z "$NO_LIBTOOLIZE" ; then
|
||||
echo "Running libtoolize..."
|
||||
@@ -105,8 +104,8 @@ if grep "^AC_CONFIG_HEADERS" configure.ac >/dev/null; then
|
||||
autoheader || { echo "**Error**: autoheader failed."; exit 1; }
|
||||
fi
|
||||
|
||||
echo "Running automake $am_opt ..."
|
||||
automake $am_opt ||
|
||||
echo "Running automake --gnu $am_opt ..."
|
||||
automake --add-missing --gnu -Wno-obsolete $am_opt ||
|
||||
{ echo "**Error**: automake failed."; exit 1; }
|
||||
echo "Running autoconf ..."
|
||||
autoconf || { echo "**Error**: autoconf failed."; exit 1; }
|
||||
|
||||
@@ -104,10 +104,6 @@ case "$THREADS" in
|
||||
AC_DEFINE(GC_AIX_THREADS)
|
||||
AC_DEFINE(_REENTRANT)
|
||||
;;
|
||||
*-*-haiku*)
|
||||
AC_DEFINE(GC_HAIKU_THREADS)
|
||||
AC_DEFINE(_REENTRANT)
|
||||
;;
|
||||
*-*-hpux*)
|
||||
AC_MSG_WARN("Only HP/UX 11 threads are supported.")
|
||||
AC_DEFINE(GC_HPUX_THREADS)
|
||||
|
||||
+2
-20
@@ -59,7 +59,7 @@
|
||||
!(defined(FREEBSD) && defined(__ELF__)) && \
|
||||
!(defined(OPENBSD) && (defined(__ELF__) || defined(M68K))) && \
|
||||
!(defined(NETBSD) && defined(__ELF__)) && !defined(HURD) && \
|
||||
!defined(DARWIN) && !defined(HAIKU)
|
||||
!defined(DARWIN)
|
||||
--> We only know how to find data segments of dynamic libraries for the
|
||||
--> above. Additional SVR4 variants might not be too
|
||||
--> hard to add.
|
||||
@@ -396,8 +396,7 @@ GC_bool GC_register_main_static_data()
|
||||
|
||||
# if (defined(LINUX) || defined (__GLIBC__) || defined(NACL)) /* Are others OK here, too? */ \
|
||||
&& (__GLIBC__ > 2 || (__GLIBC__ == 2 && __GLIBC_MINOR__ > 2) \
|
||||
|| (__GLIBC__ == 2 && __GLIBC_MINOR__ == 2 && defined(DT_CONFIG))) \
|
||||
|| defined(OPENBSD)
|
||||
|| (__GLIBC__ == 2 && __GLIBC_MINOR__ == 2 && defined(DT_CONFIG)))
|
||||
|
||||
/* We have the header files for a glibc that includes dl_iterate_phdr. */
|
||||
/* It may still not be available in the library on the target system. */
|
||||
@@ -1259,23 +1258,6 @@ GC_bool GC_register_main_static_data()
|
||||
|
||||
#endif /* DARWIN */
|
||||
|
||||
#if defined(HAIKU)
|
||||
|
||||
#include <kernel/image.h>
|
||||
|
||||
void GC_register_dynamic_libraries()
|
||||
{
|
||||
image_info info;
|
||||
int32 cookie = 0;
|
||||
while (get_next_image_info(0, &cookie, &info) == B_OK)
|
||||
{
|
||||
void *data = info.data;
|
||||
GC_add_roots_inner(data, data + info.data_size, TRUE);
|
||||
}
|
||||
}
|
||||
|
||||
#endif /* HAIKU */
|
||||
|
||||
#else /* !DYNAMIC_LOADING */
|
||||
|
||||
#ifdef PCR
|
||||
|
||||
+9
-49
@@ -42,6 +42,11 @@
|
||||
# define GC_CONST
|
||||
# endif
|
||||
|
||||
# ifdef __cplusplus
|
||||
extern "C" {
|
||||
# endif
|
||||
|
||||
|
||||
/* Define word and signed_word to be unsigned and signed types of the */
|
||||
/* size as char * or void *. There seems to be no way to do this */
|
||||
/* even semi-portably. The following is probably no better/worse */
|
||||
@@ -61,10 +66,6 @@
|
||||
typedef __int64 GC_signed_word;
|
||||
#endif
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/* Public read-only variables */
|
||||
|
||||
GC_API GC_word GC_gc_no;/* Counter incremented per collection. */
|
||||
@@ -500,17 +501,7 @@ GC_API GC_PTR GC_malloc_atomic_ignore_off_page GC_PROTO((size_t lb));
|
||||
#endif
|
||||
|
||||
#if defined(__linux__) || defined(__GLIBC__)
|
||||
|
||||
#ifdef __cplusplus
|
||||
} // extern "C"
|
||||
#endif
|
||||
|
||||
# include <features.h>
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
# if (__GLIBC__ == 2 && __GLIBC_MINOR__ >= 1 || __GLIBC__ > 2) \
|
||||
&& !defined(__ia64__)
|
||||
# ifndef GC_HAVE_BUILTIN_BACKTRACE
|
||||
@@ -844,18 +835,6 @@ typedef GC_PTR (*GC_fn_type) GC_PROTO((GC_PTR client_data));
|
||||
GC_API GC_PTR GC_call_with_alloc_lock
|
||||
GC_PROTO((GC_fn_type fn, GC_PTR client_data));
|
||||
|
||||
/*
|
||||
* These are similar to GC_do_blocking () in upstream bdwgc. The design is
|
||||
* simpler in that there is no distinction between active and inactive stack
|
||||
* frames; instead, while a thread is in blocking state, it promises to not
|
||||
* interact with the GC at all, and to not keep any pointers to GC memory
|
||||
* around from before entering blocking state. Additionally, these can be
|
||||
* called unbalanced (they simply set a flag internally).
|
||||
*/
|
||||
GC_API void GC_start_blocking GC_PROTO((void));
|
||||
|
||||
GC_API void GC_end_blocking GC_PROTO((void));
|
||||
|
||||
/* The following routines are primarily intended for use with a */
|
||||
/* preprocessor which inserts calls to check C pointer arithmetic. */
|
||||
/* They indicate failure by invoking the corresponding _print_proc. */
|
||||
@@ -974,17 +953,7 @@ GC_API void (*GC_is_visible_print_proc)
|
||||
|
||||
#if !defined(GC_USE_LD_WRAP) && \
|
||||
(defined(GC_PTHREADS) || defined(GC_SOLARIS_THREADS) || defined(GC_DARWIN_THREADS) || defined(GC_MACOSX_THREADS))
|
||||
|
||||
#ifdef __cplusplus
|
||||
} // extern "C"
|
||||
#endif
|
||||
|
||||
# include "gc_pthread_redirects.h"
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
#endif
|
||||
|
||||
# if defined(PCR) || defined(GC_SOLARIS_THREADS) || \
|
||||
@@ -1004,17 +973,8 @@ extern void GC_thr_init(void); /* Needed for Solaris/X86 */
|
||||
#endif /* THREADS && !SRC_M3 */
|
||||
|
||||
#if defined(GC_WIN32_THREADS) && !defined(__CYGWIN32__) && !defined(__CYGWIN__)
|
||||
|
||||
#ifdef __cplusplus
|
||||
} // extern "C"
|
||||
#endif
|
||||
|
||||
# include <windows.h>
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
# ifdef GC_INSIDE_DLL
|
||||
BOOL WINAPI GC_DllMain(HINSTANCE inst, ULONG reason, LPVOID reserved);
|
||||
# endif
|
||||
@@ -1109,10 +1069,6 @@ extern "C" {
|
||||
GC_API void GC_win32_free_heap ();
|
||||
#endif
|
||||
|
||||
#ifdef __cplusplus
|
||||
} // extern "C"
|
||||
#endif
|
||||
|
||||
#if ( defined(_AMIGA) && !defined(GC_AMIGA_MAKINGLIB) )
|
||||
/* Allocation really goes through GC_amiga_allocwrapper_do */
|
||||
# include "gc_amiga_redirects.h"
|
||||
@@ -1122,4 +1078,8 @@ extern "C" {
|
||||
# include "gc_local_alloc.h"
|
||||
#endif
|
||||
|
||||
#ifdef __cplusplus
|
||||
} /* end of extern "C" */
|
||||
#endif
|
||||
|
||||
#endif /* _GC_H */
|
||||
@@ -57,7 +57,7 @@
|
||||
defined(GC_HPUX_THREADS) || defined(GC_OSF1_THREADS) || \
|
||||
defined(GC_DGUX386_THREADS) || defined(GC_DARWIN_THREADS) || \
|
||||
defined(GC_AIX_THREADS) || defined(GC_NETBSD_THREADS) || \
|
||||
defined(GC_OPENBSD_THREADS) || defined(GC_HAIKU_THREADS) ||\
|
||||
defined(GC_OPENBSD_THREADS) || \
|
||||
(defined(GC_WIN32_THREADS) && defined(__CYGWIN32__))
|
||||
# define GC_PTHREADS
|
||||
# endif
|
||||
|
||||
@@ -44,10 +44,6 @@
|
||||
# include "gc.h"
|
||||
#endif
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/* The following allocators signal an out of memory condition with */
|
||||
/* return GC_oom_fn(bytes); */
|
||||
|
||||
@@ -114,8 +110,4 @@ extern int GC_gcj_debug_kind;
|
||||
GC_gcj_malloc_ignore_off_page(s,d)
|
||||
# endif
|
||||
|
||||
#ifdef __cplusplus
|
||||
} // extern "C"
|
||||
#endif
|
||||
|
||||
#endif /* GC_GCJ_H */
|
||||
@@ -49,10 +49,6 @@
|
||||
#ifndef GC_LOCAL_ALLOC_H
|
||||
#define GC_LOCAL_ALLOC_H
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/* We assume ANSI C for this interface. */
|
||||
|
||||
GC_PTR GC_local_malloc(size_t bytes);
|
||||
@@ -66,10 +62,6 @@ GC_PTR GC_local_malloc_atomic(size_t bytes);
|
||||
void * ptr_to_struct_containing_descr);
|
||||
#endif
|
||||
|
||||
#ifdef __cplusplus
|
||||
} // extern "C"
|
||||
#endif
|
||||
|
||||
# ifdef GC_DEBUG
|
||||
/* We don't really use local allocation in this case. */
|
||||
# define GC_LOCAL_MALLOC(s) GC_debug_malloc(s,GC_EXTRAS)
|
||||
|
||||
@@ -15,11 +15,6 @@
|
||||
/* facility in thr_keycreate. Alternatively, keep a redundant pointer */
|
||||
/* to thread specific data on the thread stack. */
|
||||
# include <thread.h>
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
int GC_thr_create(void *stack_base, size_t stack_size,
|
||||
void *(*start_routine)(void *), void *arg, long flags,
|
||||
thread_t *new_thread);
|
||||
@@ -31,22 +26,11 @@ extern "C" {
|
||||
# define thr_join GC_thr_join
|
||||
# define thr_suspend GC_thr_suspend
|
||||
# define thr_continue GC_thr_continue
|
||||
|
||||
#ifdef __cplusplus
|
||||
} // extern "C"
|
||||
#endif
|
||||
|
||||
#endif /* GC_SOLARIS_THREADS */
|
||||
|
||||
#if defined(GC_SOLARIS_PTHREADS)
|
||||
|
||||
# include <pthread.h>
|
||||
# include <signal.h>
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
extern int GC_pthread_create(pthread_t *new_thread,
|
||||
const pthread_attr_t *attr,
|
||||
void * (*thread_execp)(void *), void *arg);
|
||||
@@ -55,11 +39,6 @@ extern "C" {
|
||||
# define pthread_join GC_pthread_join
|
||||
# define pthread_create GC_pthread_create
|
||||
# define pthread_detach GC_pthread_detach
|
||||
|
||||
#ifdef __cplusplus
|
||||
} // extern "C"
|
||||
#endif
|
||||
|
||||
#endif
|
||||
|
||||
#if defined(GC_SOLARIS_PTHREADS) || defined(GC_SOLARIS_THREADS)
|
||||
@@ -72,10 +51,6 @@ extern "C" {
|
||||
# include <pthread.h>
|
||||
# include <signal.h>
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
int GC_pthread_create(pthread_t *new_thread,
|
||||
const pthread_attr_t *attr,
|
||||
void *(*start_routine)(void *), void *arg);
|
||||
@@ -112,10 +87,6 @@ extern "C" {
|
||||
# define dlopen GC_dlopen
|
||||
#endif
|
||||
|
||||
#ifdef __cplusplus
|
||||
} // extern "C"
|
||||
#endif
|
||||
|
||||
#endif /* GC_xxxxx_THREADS */
|
||||
|
||||
#endif /* GC_PTHREAD_REDIRECTS_H */
|
||||
@@ -43,17 +43,7 @@
|
||||
*
|
||||
*/
|
||||
# ifdef THREADS
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
void GC_noop1 GC_PROTO((word));
|
||||
|
||||
#ifdef __cplusplus
|
||||
} // extern "C"
|
||||
#endif
|
||||
|
||||
# ifdef PCR_OBSOLETE /* Faster, but broken with multiple lwp's */
|
||||
# include "th/PCR_Th.h"
|
||||
# include "th/PCR_ThCrSec.h"
|
||||
|
||||
@@ -366,10 +366,6 @@ void GC_print_callers GC_PROTO((struct callinfo info[NFRAMES]));
|
||||
# define BZERO(x,n) bzero((char *)(x),(int)(n))
|
||||
# endif
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
#if defined(DARWIN)
|
||||
# if defined(POWERPC)
|
||||
# define GC_MACH_THREAD_STATE_FLAVOR PPC_THREAD_STATE
|
||||
@@ -417,18 +413,7 @@ extern "C" {
|
||||
* Stop and restart mutator threads.
|
||||
*/
|
||||
# ifdef PCR
|
||||
|
||||
#ifdef __cplusplus
|
||||
} // extern "C"
|
||||
#endif
|
||||
|
||||
# include "th/PCR_ThCtl.h"
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
|
||||
# define STOP_WORLD() \
|
||||
PCR_ThCtl_SetExclusiveMode(PCR_ThCtl_ExclusiveMode_stopNormal, \
|
||||
PCR_allSigsBlocked, \
|
||||
@@ -1330,7 +1315,7 @@ void GC_initiate_gc GC_PROTO((void));
|
||||
/* If the mark state is invalid, this */
|
||||
/* becomes full colleection. Otherwise */
|
||||
/* it's partial. */
|
||||
void GC_push_all (void* bottom, void* top);
|
||||
void GC_push_all GC_PROTO((ptr_t bottom, ptr_t top));
|
||||
/* Push everything in a range */
|
||||
/* onto mark stack. */
|
||||
void GC_push_selected GC_PROTO(( \
|
||||
@@ -1975,10 +1960,6 @@ void GC_err_puts GC_PROTO((GC_CONST char *s));
|
||||
/* some other reason. */
|
||||
# endif /* PARALLEL_MARK */
|
||||
|
||||
#ifdef __cplusplus
|
||||
} // extern "C"
|
||||
#endif
|
||||
|
||||
# if defined(GC_PTHREADS) && !defined(GC_SOLARIS_THREADS)
|
||||
/* We define the thread suspension signal here, so that we can refer */
|
||||
/* to it in the dirty bit implementation, if necessary. Ideally we */
|
||||
@@ -1998,8 +1979,6 @@ void GC_err_puts GC_PROTO((GC_CONST char *s));
|
||||
/* Linuxthreads itself uses SIGUSR1 and SIGUSR2. */
|
||||
# define SIG_SUSPEND SIGPWR
|
||||
# endif
|
||||
# elif defined(GC_OPENBSD_THREADS)
|
||||
# define SIG_SUSPEND SIGXFSZ
|
||||
# else /* !GC_LINUX_THREADS */
|
||||
# if defined(_SIGRTMIN)
|
||||
# define SIG_SUSPEND _SIGRTMIN + 6
|
||||
|
||||
@@ -238,16 +238,6 @@
|
||||
# define BEOS
|
||||
# define mach_type_known
|
||||
# endif
|
||||
# if defined(__HAIKU__) && defined(_X86_)
|
||||
# define I386
|
||||
# define HAIKU
|
||||
# define mach_type_known
|
||||
# endif
|
||||
# if defined(__HAIKU__) && defined(__amd64__)
|
||||
# define X86_64
|
||||
# define HAIKU
|
||||
# define mach_type_known
|
||||
# endif
|
||||
# if defined(LINUX) && (defined(i386) || defined(__i386__))
|
||||
# define I386
|
||||
# define mach_type_known
|
||||
@@ -1174,15 +1164,6 @@
|
||||
extern int etext[];
|
||||
# define DATASTART ((ptr_t)((((word) (etext)) + 0xfff) & ~0xfff))
|
||||
# endif
|
||||
# ifdef HAIKU
|
||||
# define OS_TYPE "HAIKU"
|
||||
# include <OS.h>
|
||||
# define GETPAGESIZE() B_PAGE_SIZE
|
||||
extern int etext[];
|
||||
# define DATASTART ((ptr_t)((((word) (etext)) + 0xfff) & ~0xfff))
|
||||
# define DYNAMIC_LOADING
|
||||
# define MPROTECT_VDB
|
||||
# endif
|
||||
# ifdef SUNOS5
|
||||
# define OS_TYPE "SUNOS5"
|
||||
extern int _etext[], _end[];
|
||||
@@ -2153,15 +2134,6 @@
|
||||
/* There seems to be some issues with trylock hanging on darwin. This
|
||||
should be looked into some more */
|
||||
# endif
|
||||
# ifdef HAIKU
|
||||
# define OS_TYPE "HAIKU"
|
||||
# include <OS.h>
|
||||
# define GETPAGESIZE() B_PAGE_SIZE
|
||||
extern int etext[];
|
||||
# define DATASTART ((ptr_t)((((word) (etext)) + 0xfff) & ~0xfff))
|
||||
# define DYNAMIC_LOADING
|
||||
# define MPROTECT_VDB
|
||||
# endif
|
||||
# ifdef FREEBSD
|
||||
# define OS_TYPE "FREEBSD"
|
||||
# ifndef GC_FREEBSD_THREADS
|
||||
@@ -2279,7 +2251,7 @@
|
||||
# if defined(SVR4) || defined(LINUX) || defined(IRIX5) || defined(HPUX) \
|
||||
|| defined(OPENBSD) || defined(NETBSD) || defined(FREEBSD) \
|
||||
|| defined(DGUX) || defined(BSD) || defined(SUNOS4) \
|
||||
|| defined(_AIX) || defined(DARWIN) || defined(OSF1) || defined(HAIKU)
|
||||
|| defined(_AIX) || defined(DARWIN) || defined(OSF1)
|
||||
# define UNIX_LIKE /* Basic Unix-like system calls work. */
|
||||
# endif
|
||||
|
||||
@@ -2535,9 +2507,6 @@
|
||||
# if defined(SN_TARGET_PS3)
|
||||
extern void *ps3_get_mem (size_t size);
|
||||
# define GET_MEM(bytes) (struct hblk*) ps3_get_mem (bytes)
|
||||
# elif defined(HAIKU)
|
||||
ptr_t GC_haiku_get_mem(GC_word bytes);
|
||||
# define GET_MEM(bytes) (struct hblk*)GC_haiku_get_mem(bytes)
|
||||
# else
|
||||
extern ptr_t GC_unix_get_mem(word size);
|
||||
# define GET_MEM(bytes) (struct hblk *)GC_unix_get_mem(bytes)
|
||||
|
||||
@@ -0,0 +1,12 @@
|
||||
#ifndef GC_OPENBSD_STOP_WORLD_H
|
||||
#define GC_OPENBSD_STOP_WORLD_H
|
||||
|
||||
#if !defined(GC_OPENBSD_THREADS)
|
||||
#error openbsd_stop_world.h included without GC_OPENBSD_THREADS defined
|
||||
#endif
|
||||
|
||||
struct thread_stop_info {
|
||||
ptr_t stack_ptr; /* Valid only when stopped. */
|
||||
};
|
||||
|
||||
#endif
|
||||
@@ -8,6 +8,8 @@
|
||||
|
||||
#if defined(GC_DARWIN_THREADS)
|
||||
# include "private/darwin_stop_world.h"
|
||||
#elif defined(GC_OPENBSD_THREADS)
|
||||
# include "private/openbsd_stop_world.h"
|
||||
#else
|
||||
# include "private/pthread_stop_world.h"
|
||||
#endif
|
||||
|
||||
+4
-6
@@ -1191,13 +1191,11 @@ void GC_mark_init()
|
||||
* Should only be used if there is no possibility of mark stack
|
||||
* overflow.
|
||||
*/
|
||||
void GC_push_all(void_bottom, void_top)
|
||||
void* void_bottom;
|
||||
void* void_top;
|
||||
void GC_push_all(bottom, top)
|
||||
ptr_t bottom;
|
||||
ptr_t top;
|
||||
{
|
||||
ptr_t bottom = (ptr_t)void_bottom;
|
||||
ptr_t top = (ptr_t)void_top;
|
||||
word length;
|
||||
register word length;
|
||||
|
||||
bottom = (ptr_t)(((word) bottom + ALIGNMENT-1) & ~(ALIGNMENT-1));
|
||||
top = (ptr_t)(((word) top) & ~(ALIGNMENT-1));
|
||||
|
||||
@@ -0,0 +1,161 @@
|
||||
#include "private/pthread_support.h"
|
||||
|
||||
/* derived from pthread_stop_world.c */
|
||||
|
||||
# if defined(GC_OPENBSD_THREADS)
|
||||
|
||||
#define THREAD_EQUAL(id1, id2) pthread_equal(id1, id2)
|
||||
|
||||
/* We hold allocation lock. Should do exactly the right thing if the */
|
||||
/* world is stopped. Should not fail if it isn't. */
|
||||
void GC_push_all_stacks()
|
||||
{
|
||||
GC_bool found_me = FALSE;
|
||||
size_t nthreads = 0;
|
||||
int i;
|
||||
GC_thread p;
|
||||
ptr_t lo, hi;
|
||||
pthread_t me = pthread_self();
|
||||
|
||||
if (!GC_thr_initialized) GC_thr_init();
|
||||
# if DEBUG_THREADS
|
||||
GC_printf("Pushing stacks from thread 0x%x\n", (unsigned) me);
|
||||
# endif
|
||||
for (i = 0; i < THREAD_TABLE_SZ; i++) {
|
||||
for (p = GC_threads[i]; p != 0; p = p -> next) {
|
||||
if (p -> flags & FINISHED) continue;
|
||||
++nthreads;
|
||||
if (THREAD_EQUAL(p -> id, me)) {
|
||||
# ifdef SPARC
|
||||
lo = (ptr_t)GC_save_regs_in_stack();
|
||||
# else
|
||||
lo = GC_approx_sp();
|
||||
# endif
|
||||
found_me = TRUE;
|
||||
} else {
|
||||
lo = p -> stop_info.stack_ptr;
|
||||
}
|
||||
if ((p -> flags & MAIN_THREAD) == 0) {
|
||||
hi = p -> stack_end;
|
||||
} else {
|
||||
/* The original stack. */
|
||||
hi = GC_stackbottom;
|
||||
}
|
||||
# if DEBUG_THREADS
|
||||
GC_printf("Stack for thread 0x%x = [%p,%p)\n",
|
||||
(unsigned)(p -> id), lo, hi);
|
||||
# endif
|
||||
if (0 == lo) ABORT("GC_push_all_stacks: sp not set!\n");
|
||||
# ifdef STACK_GROWS_UP
|
||||
/* We got them backwards! */
|
||||
GC_push_all_stack(hi, lo);
|
||||
# else
|
||||
GC_push_all_stack(lo, hi);
|
||||
# endif
|
||||
}
|
||||
}
|
||||
if (!found_me && !GC_in_thread_creation)
|
||||
ABORT("Collecting from unknown thread.");
|
||||
}
|
||||
|
||||
/* We hold the allocation lock. Suspend all threads that might */
|
||||
/* still be running. */
|
||||
void GC_suspend_all()
|
||||
{
|
||||
int i;
|
||||
GC_thread p;
|
||||
int result;
|
||||
pthread_t my_thread = pthread_self();
|
||||
|
||||
for (i = 0; i < THREAD_TABLE_SZ; i++) {
|
||||
for (p = GC_threads[i]; p != 0; p = p -> next) {
|
||||
if (!THREAD_EQUAL(p -> id, my_thread)) {
|
||||
if (p -> flags & FINISHED) continue;
|
||||
if (p -> thread_blocked) /* Will wait */ continue;
|
||||
# if DEBUG_THREADS
|
||||
GC_printf("Suspending thread 0x%x\n",
|
||||
(unsigned)(p -> id));
|
||||
# endif
|
||||
|
||||
if (pthread_suspend_np(p -> id) != 0)
|
||||
ABORT("pthread_suspend_np failed");
|
||||
|
||||
/*
|
||||
* This will only work for userland pthreads. It will
|
||||
* fail badly on rthreads. Perhaps we should consider
|
||||
* a pthread_sp_np() function that returns the stack
|
||||
* pointer for a suspended thread and implement in
|
||||
* both pthreads and rthreads.
|
||||
*/
|
||||
p -> stop_info.stack_ptr = *(ptr_t*)((char *)p -> id + UTHREAD_SP_OFFSET);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
void GC_stop_world()
|
||||
{
|
||||
int i;
|
||||
|
||||
GC_ASSERT(I_HOLD_LOCK());
|
||||
# if DEBUG_THREADS
|
||||
GC_printf("Stopping the world from 0x%x\n", (unsigned)pthread_self());
|
||||
# endif
|
||||
|
||||
/* Make sure all free list construction has stopped before we start. */
|
||||
/* No new construction can start, since free list construction is */
|
||||
/* required to acquire and release the GC lock before it starts, */
|
||||
/* and we have the lock. */
|
||||
# ifdef PARALLEL_MARK
|
||||
GC_acquire_mark_lock();
|
||||
GC_ASSERT(GC_fl_builder_count == 0);
|
||||
/* We should have previously waited for it to become zero. */
|
||||
# endif /* PARALLEL_MARK */
|
||||
|
||||
GC_suspend_all();
|
||||
|
||||
# ifdef PARALLEL_MARK
|
||||
GC_release_mark_lock();
|
||||
# endif
|
||||
#if DEBUG_THREADS
|
||||
GC_printf("World stopped from 0x%x\n", (unsigned)pthread_self());
|
||||
#endif
|
||||
}
|
||||
|
||||
/* Caller holds allocation lock, and has held it continuously since */
|
||||
/* the world stopped. */
|
||||
void GC_start_world()
|
||||
{
|
||||
pthread_t my_thread = pthread_self();
|
||||
register int i;
|
||||
register GC_thread p;
|
||||
register int result;
|
||||
|
||||
# if DEBUG_THREADS
|
||||
GC_printf("World starting\n");
|
||||
# endif
|
||||
|
||||
for (i = 0; i < THREAD_TABLE_SZ; i++) {
|
||||
for (p = GC_threads[i]; p != 0; p = p -> next) {
|
||||
if (!THREAD_EQUAL(p -> id, my_thread)) {
|
||||
if (p -> flags & FINISHED) continue;
|
||||
if (p -> thread_blocked) continue;
|
||||
#if DEBUG_THREADS
|
||||
GC_printf("Resuming thread 0x%x\n",
|
||||
(unsigned)(p -> id));
|
||||
#endif
|
||||
|
||||
if (pthread_resume_np(p -> id) != 0)
|
||||
ABORT("pthread_kill failed");
|
||||
}
|
||||
}
|
||||
}
|
||||
# if DEBUG_THREADS
|
||||
GC_printf("World started\n");
|
||||
# endif
|
||||
}
|
||||
|
||||
void GC_stop_init() {
|
||||
}
|
||||
|
||||
#endif
|
||||
+9
-31
@@ -609,7 +609,7 @@ void GC_enable_signals(void)
|
||||
&& !defined(MACOS) && !defined(DJGPP) && !defined(DOS4GW) \
|
||||
&& !defined(NOSYS) && !defined(ECOS) && !defined(SN_TARGET_PS3)
|
||||
|
||||
# if defined(sigmask) && !defined(UTS4) && !defined(HURD) && !defined(HAIKU)
|
||||
# if defined(sigmask) && !defined(UTS4) && !defined(HURD)
|
||||
/* Use the traditional BSD interface */
|
||||
# define SIGSET_T int
|
||||
# define SIG_DEL(set, signal) (set) &= ~(sigmask(signal))
|
||||
@@ -764,14 +764,14 @@ ptr_t GC_get_stack_base()
|
||||
|
||||
# endif /* MS Windows */
|
||||
|
||||
# ifdef HAIKU
|
||||
# ifdef BEOS
|
||||
# include <kernel/OS.h>
|
||||
ptr_t GC_get_stack_base(){
|
||||
thread_info th;
|
||||
get_thread_info(find_thread(NULL),&th);
|
||||
return th.stack_end;
|
||||
}
|
||||
# endif /* HAIKU */
|
||||
# endif /* BEOS */
|
||||
|
||||
|
||||
# ifdef OS2
|
||||
@@ -1122,7 +1122,7 @@ void *GC_set_stackbottom = NULL;
|
||||
|
||||
#endif /* FREEBSD_STACKBOTTOM */
|
||||
|
||||
#if !defined(HAIKU) && !defined(AMIGA) && !defined(MSWIN32) \
|
||||
#if !defined(BEOS) && !defined(AMIGA) && !defined(MSWIN32) \
|
||||
&& !defined(MSWINCE) && !defined(OS2) && !defined(NOSYS) && !defined(ECOS) \
|
||||
&& !defined(GC_OPENBSD_THREADS)
|
||||
|
||||
@@ -1182,7 +1182,7 @@ ptr_t GC_get_stack_base()
|
||||
# endif /* STACKBOTTOM */
|
||||
}
|
||||
|
||||
# endif /* ! AMIGA, !OS 2, ! MS Windows, !HAIKU, !NOSYS, !ECOS */
|
||||
# endif /* ! AMIGA, !OS 2, ! MS Windows, !BEOS, !NOSYS, !ECOS */
|
||||
|
||||
#if defined(GC_OPENBSD_THREADS)
|
||||
|
||||
@@ -1957,19 +1957,6 @@ word bytes;
|
||||
}
|
||||
# endif
|
||||
|
||||
#if defined(HAIKU)
|
||||
#include <stdlib.h>
|
||||
|
||||
ptr_t GC_haiku_get_mem(word bytes)
|
||||
{
|
||||
void* mem;
|
||||
if (posix_memalign(&mem, GC_page_size, bytes) == 0)
|
||||
return mem;
|
||||
else
|
||||
return NULL;
|
||||
}
|
||||
#endif
|
||||
|
||||
#ifdef USE_MUNMAP
|
||||
|
||||
/* For now, this only works on Win32/WinCE and some Unix-like */
|
||||
@@ -2406,9 +2393,7 @@ GC_bool is_ptrfree;
|
||||
|
||||
# include <sys/mman.h>
|
||||
# include <signal.h>
|
||||
# if !defined(HAIKU)
|
||||
# include <sys/syscall.h>
|
||||
# endif
|
||||
# include <sys/syscall.h>
|
||||
|
||||
# define PROTECT(addr, len) \
|
||||
if (mprotect((caddr_t)(addr), (size_t)(len), \
|
||||
@@ -2465,13 +2450,13 @@ GC_bool is_ptrfree;
|
||||
#endif /* SUNOS4 || (FREEBSD && !SUNOS5SIGS) */
|
||||
|
||||
#if defined(SUNOS5SIGS) || defined(OSF1) || defined(LINUX) \
|
||||
|| defined(HURD) || defined(HAIKU)
|
||||
|| defined(HURD)
|
||||
# ifdef __STDC__
|
||||
typedef void (* SIG_PF)(int);
|
||||
# else
|
||||
typedef void (* SIG_PF)();
|
||||
# endif
|
||||
#endif /* SUNOS5SIGS || OSF1 || LINUX || HURD || HAIKU */
|
||||
#endif /* SUNOS5SIGS || OSF1 || LINUX || HURD */
|
||||
|
||||
#if defined(MSWIN32)
|
||||
typedef LPTOP_LEVEL_EXCEPTION_FILTER SIG_PF;
|
||||
@@ -2649,13 +2634,6 @@ SIG_PF GC_old_segv_handler; /* Also old MSWIN32 ACCESS_VIOLATION filter */
|
||||
/* architectures. */
|
||||
# endif /* LINUX */
|
||||
|
||||
# if defined(HAIKU)
|
||||
# include <errno.h>
|
||||
# define CODE_OK TRUE
|
||||
# define SIG_OK (sig == SIGSEGV)
|
||||
void GC_write_failt_handler(int sig, siginfo_t *scp, void * context)
|
||||
#endif /* HAIKU */
|
||||
|
||||
# if defined(SUNOS5SIGS)
|
||||
# ifdef __STDC__
|
||||
void GC_write_fault_handler(int sig, SIGINFO_T *scp, void * context)
|
||||
@@ -2701,7 +2679,7 @@ SIG_PF GC_old_segv_handler; /* Also old MSWIN32 ACCESS_VIOLATION filter */
|
||||
# if defined(OSF1) && defined(ALPHA)
|
||||
char * addr = (char *) (scp -> sc_traparg_a0);
|
||||
# endif
|
||||
# if defined(SUNOS5SIGS) || defined(HAIKU)
|
||||
# ifdef SUNOS5SIGS
|
||||
char * addr = (char *) (scp -> si_addr);
|
||||
# endif
|
||||
# ifdef LINUX
|
||||
|
||||
@@ -2,7 +2,8 @@
|
||||
|
||||
#if defined(GC_PTHREADS) && !defined(GC_SOLARIS_THREADS) \
|
||||
&& !defined(GC_IRIX_THREADS) && !defined(GC_WIN32_THREADS) \
|
||||
&& !defined(GC_DARWIN_THREADS) && !defined(GC_AIX_THREADS)
|
||||
&& !defined(GC_DARWIN_THREADS) && !defined(GC_AIX_THREADS) \
|
||||
&& !defined(GC_OPENBSD_THREADS)
|
||||
|
||||
#include <signal.h>
|
||||
#include <semaphore.h>
|
||||
|
||||
@@ -1135,7 +1135,7 @@ void GC_thr_init()
|
||||
# if defined(GC_HPUX_THREADS)
|
||||
GC_nprocs = pthread_num_processors_np();
|
||||
# endif
|
||||
# if defined(GC_OSF1_THREADS) || defined(GC_AIX_THREADS) || defined(GC_HAIKU_THREADS)
|
||||
# if defined(GC_OSF1_THREADS) || defined(GC_AIX_THREADS)
|
||||
GC_nprocs = sysconf(_SC_NPROCESSORS_ONLN);
|
||||
if (GC_nprocs <= 0) GC_nprocs = 1;
|
||||
# endif
|
||||
@@ -1245,6 +1245,7 @@ void GC_start_blocking(void) {
|
||||
GC_thread me;
|
||||
LOCK();
|
||||
me = GC_lookup_thread(pthread_self());
|
||||
GC_ASSERT(!(me -> thread_blocked));
|
||||
# ifdef SPARC
|
||||
me -> stop_info.stack_ptr = (ptr_t)GC_save_regs_in_stack();
|
||||
# else
|
||||
@@ -1272,6 +1273,7 @@ void GC_end_blocking(void) {
|
||||
GC_thread me;
|
||||
LOCK(); /* This will block if the world is stopped. */
|
||||
me = GC_lookup_thread(pthread_self());
|
||||
GC_ASSERT(me -> thread_blocked);
|
||||
me -> thread_blocked = FALSE;
|
||||
UNLOCK();
|
||||
}
|
||||
|
||||
+1
-47
@@ -48,7 +48,6 @@ struct GC_thread_Rep {
|
||||
/* 0 ==> entry not valid. */
|
||||
/* !in_use ==> stack_base == 0 */
|
||||
GC_bool suspended;
|
||||
GC_bool thread_blocked;
|
||||
|
||||
# ifdef CYGWIN32
|
||||
void *status; /* hold exit value until join in case it's a pointer */
|
||||
@@ -175,7 +174,6 @@ static GC_thread GC_new_thread(void) {
|
||||
/* the world, wait here. Hopefully this can't happen on any */
|
||||
/* systems that don't allow us to block here. */
|
||||
while (GC_please_stop) Sleep(20);
|
||||
GC_ASSERT(!thread_table[i]->thread_blocked);
|
||||
return thread_table + i;
|
||||
}
|
||||
|
||||
@@ -225,6 +223,7 @@ static void GC_delete_thread(DWORD thread_id) {
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
#ifdef CYGWIN32
|
||||
|
||||
/* Return a GC_thread corresponding to a given pthread_t. */
|
||||
@@ -246,20 +245,6 @@ static GC_thread GC_lookup_thread(pthread_t id)
|
||||
return thread_table + i;
|
||||
}
|
||||
|
||||
#else
|
||||
|
||||
static GC_thread GC_lookup_thread(DWORD id)
|
||||
{
|
||||
int i;
|
||||
LONG max = GC_get_max_thread_index();
|
||||
|
||||
for (i = 0; i <= max; i++)
|
||||
if (thread_table[i].in_use && thread_table[i].id == id)
|
||||
return &thread_table[i];
|
||||
|
||||
return NULL;
|
||||
}
|
||||
|
||||
#endif /* CYGWIN32 */
|
||||
|
||||
void GC_push_thread_structures GC_PROTO((void))
|
||||
@@ -279,35 +264,6 @@ void GC_push_thread_structures GC_PROTO((void))
|
||||
# endif
|
||||
}
|
||||
|
||||
/* Wrappers for functions that are likely to block for an appreciable */
|
||||
/* length of time. Must be called in pairs, if at all. */
|
||||
/* Nothing much beyond the system call itself should be executed */
|
||||
/* between these. */
|
||||
|
||||
void GC_start_blocking(void) {
|
||||
GC_thread me;
|
||||
LOCK();
|
||||
#ifdef CYGWIN32
|
||||
me = GC_lookup_thread(pthread_self());
|
||||
#else
|
||||
me = GC_lookup_thread(GetCurrentThreadId());
|
||||
#endif
|
||||
me->thread_blocked = TRUE;
|
||||
UNLOCK();
|
||||
}
|
||||
|
||||
void GC_end_blocking(void) {
|
||||
GC_thread me;
|
||||
LOCK(); /* This will block if the world is stopped. */
|
||||
#ifdef CYGWIN32
|
||||
me = GC_lookup_thread(pthread_self());
|
||||
#else
|
||||
me = GC_lookup_thread(GetCurrentThreadId());
|
||||
#endif
|
||||
me->thread_blocked = FALSE;
|
||||
UNLOCK();
|
||||
}
|
||||
|
||||
/* Defined in misc.c */
|
||||
extern CRITICAL_SECTION GC_write_cs;
|
||||
|
||||
@@ -325,8 +281,6 @@ void GC_stop_world()
|
||||
for (i = 0; i <= GC_get_max_thread_index(); i++)
|
||||
if (thread_table[i].stack_base != 0
|
||||
&& thread_table[i].id != thread_id) {
|
||||
if (thread_table [i].thread_blocked)
|
||||
continue;
|
||||
# ifdef MSWINCE
|
||||
/* SuspendThread will fail if thread is running kernel code */
|
||||
while (SuspendThread(thread_table[i].handle) == (DWORD)-1)
|
||||
|
||||
@@ -1,3 +1,2 @@
|
||||
/Makefile
|
||||
/Makefile.in
|
||||
/llvm_config.mk
|
||||
+22
-48
@@ -1,56 +1,30 @@
|
||||
#
|
||||
# Conditional submodule for llvm
|
||||
#
|
||||
# make reset-llvm will checkout a version of llvm which is suitable for this version of mono
|
||||
# into $top_srcdir/llvm/llvm.
|
||||
#
|
||||
|
||||
EXTRA_DIST=SUBMODULES.json build.mk build_llvm_config.sh
|
||||
LLVM_PATH=llvm
|
||||
|
||||
if ENABLE_LLVM
|
||||
SUBMODULES_CONFIG_FILE = $(top_srcdir)/llvm/SUBMODULES.json
|
||||
include $(top_srcdir)/scripts/submodules/versions.mk
|
||||
|
||||
if HOST_WIN32
|
||||
llvm_config=llvm-config.exe
|
||||
else
|
||||
llvm_config=llvm-config
|
||||
endif
|
||||
$(eval $(call ValidateVersionTemplate,llvm,LLVM))
|
||||
|
||||
if HAVE_ZLIB
|
||||
llvm_extra_libs=-lz
|
||||
else
|
||||
llvm_extra_libs=
|
||||
endif
|
||||
# Bump the given submodule to the revision given by the REV make variable
|
||||
# If COMMIT is 1, commit the change
|
||||
bump-llvm: __bump-version-llvm
|
||||
|
||||
if INTERNAL_LLVM
|
||||
# Bump the given submodule to the branch given by the BRANCH/REMOTE_BRANCH make variables
|
||||
# If COMMIT is 1, commit the change
|
||||
bump-branch-llvm: __bump-branch-llvm
|
||||
|
||||
all-local: configure-llvm build-llvm install-llvm llvm_config.mk
|
||||
# Bump the given submodule to its current GIT version
|
||||
# If COMMIT is 1, commit the change
|
||||
bump-current-llvm: __bump-current-version-llvm
|
||||
|
||||
clean-local: clean-llvm clean-llvm-config
|
||||
clean-local:
|
||||
$(RM) -r $(LLVM_PATH)
|
||||
|
||||
$(mono_build_root)/llvm/llvm_config.mk: install-llvm
|
||||
$(top_srcdir)/llvm/build_llvm_config.sh "$(top_srcdir)/llvm/usr/bin/$(llvm_config)" "$(LLVM_CODEGEN_LIBS)" "$(llvm_extra_libs)" > $@
|
||||
|
||||
else
|
||||
all-local: llvm_config.mk
|
||||
|
||||
clean-local: clean-llvm-config
|
||||
|
||||
$(mono_build_root)/llvm/llvm_config.mk: $(top_srcdir)/llvm/Makefile.am
|
||||
$(top_srcdir)/llvm/build_llvm_config.sh "$(EXTERNAL_LLVM_CONFIG)" "$(LLVM_CODEGEN_LIBS)" "$(llvm_extra_libs)" > $@
|
||||
endif
|
||||
|
||||
llvm_config.mk: $(mono_build_root)/llvm/llvm_config.mk
|
||||
|
||||
clean-llvm-config:
|
||||
- rm -rf llvm_config.mk
|
||||
|
||||
else
|
||||
all-local:
|
||||
|
||||
clean-local:
|
||||
endif
|
||||
|
||||
# Override this so we don't try to re-copy llvm when we install mono
|
||||
install:
|
||||
|
||||
if TARGET_WASM
|
||||
LLVM_TARGET=wasm32
|
||||
else
|
||||
LLVM_TARGET=
|
||||
endif
|
||||
|
||||
include build.mk
|
||||
EXTRA_DIST=SUBMODULES.json
|
||||
@@ -2,9 +2,9 @@
|
||||
{
|
||||
"name": "llvm",
|
||||
"url": "git://github.com/mono/llvm.git",
|
||||
"rev": "81376d161cb6c2230834b2dc096ccbdae8d93020",
|
||||
"remote-branch": "origin/release_60",
|
||||
"branch": "release_60",
|
||||
"rev": "9f79399f87282524fee099b328bd8cbf07929daf",
|
||||
"remote-branch": "origin/master",
|
||||
"branch": "master",
|
||||
"directory": "llvm"
|
||||
}
|
||||
]
|
||||
@@ -1,86 +0,0 @@
|
||||
#
|
||||
# Conditional submodule for llvm
|
||||
#
|
||||
# make reset-llvm will checkout a version of llvm which is suitable for this version of mono
|
||||
# into $top_srcdir/llvm/llvm.
|
||||
#
|
||||
# Input variables
|
||||
# - LLVM_TARGET: if set to wasm32 will trigger a 32bits build that enable the experimental WebAssembly backend
|
||||
#
|
||||
|
||||
top_srcdir ?= $(abspath $(CURDIR)/..)
|
||||
|
||||
LLVM_PATH ?= $(abspath $(top_srcdir)/external/llvm)
|
||||
LLVM_BUILD ?= $(abspath $(top_srcdir)/llvm/build)
|
||||
LLVM_PREFIX ?= $(abspath $(top_srcdir)/llvm/usr)
|
||||
|
||||
# FIXME: URL should be http://xamjenkinsartifact.blob.core.windows.net/build-package-osx-llvm-$(NEEDED_LLVM_BRANCH)/llvm-osx64-$(NEEDED_LLVM_VERSION).tar.gz
|
||||
LLVM_DOWNLOAD_LOCATION = "http://xamjenkinsartifact.blob.core.windows.net/build-package-osx-llvm-release60/llvm-osx64-$(NEEDED_LLVM_VERSION).tar.gz"
|
||||
|
||||
CMAKE := $(or $(CMAKE),$(shell which cmake))
|
||||
NINJA := $(shell which ninja)
|
||||
|
||||
SUBMODULES_CONFIG_FILE = $(top_srcdir)/llvm/SUBMODULES.json
|
||||
include $(top_srcdir)/scripts/submodules/versions.mk
|
||||
|
||||
$(eval $(call ValidateVersionTemplate,llvm,LLVM))
|
||||
|
||||
# Bump the given submodule to the revision given by the REV make variable
|
||||
# If COMMIT is 1, commit the change
|
||||
bump-llvm: __bump-version-llvm
|
||||
|
||||
# Bump the given submodule to the branch given by the BRANCH/REMOTE_BRANCH make variables
|
||||
# If COMMIT is 1, commit the change
|
||||
bump-branch-llvm: __bump-branch-llvm
|
||||
|
||||
# Bump the given submodule to its current GIT version
|
||||
# If COMMIT is 1, commit the change
|
||||
bump-current-llvm: __bump-current-version-llvm
|
||||
|
||||
$(LLVM_BUILD) $(LLVM_PREFIX):
|
||||
mkdir -p $@
|
||||
|
||||
$(LLVM_PATH):
|
||||
$(MAKE) -f build.mk reset-llvm
|
||||
|
||||
$(LLVM_PATH)/CMakeLists.txt: | $(LLVM_PATH)
|
||||
|
||||
EXTRA_LLVM_ARGS = $(if $(filter $(LLVM_TARGET),wasm32), -DLLVM_BUILD_32_BITS=On -DLLVM_EXPERIMENTAL_TARGETS_TO_BUILD="WebAssembly",)
|
||||
|
||||
$(LLVM_BUILD)/$(if $(NINJA),build.ninja,Makefile): $(LLVM_PATH)/CMakeLists.txt | $(LLVM_BUILD)
|
||||
cd $(LLVM_BUILD) && $(CMAKE) \
|
||||
$(if $(NINJA),-G Ninja) \
|
||||
-DCMAKE_INSTALL_PREFIX="$(LLVM_PREFIX)" \
|
||||
-DCMAKE_BUILD_TYPE=Release \
|
||||
-DLLVM_BUILD_TESTS=Off \
|
||||
-DLLVM_INCLUDE_TESTS=Off \
|
||||
-DLLVM_BUILD_EXAMPLES=Off \
|
||||
-DLLVM_INCLUDE_EXAMPLES=Off \
|
||||
-DLLVM_TOOLS_TO_BUILD="opt;llc;llvm-config;llvm-dis" \
|
||||
-DLLVM_TARGETS_TO_BUILD="X86;ARM;AArch64" \
|
||||
$(EXTRA_LLVM_ARGS) \
|
||||
-DLLVM_ENABLE_ASSERTIONS=$(if $(INTERNAL_LLVM_ASSERTS),On,Off) \
|
||||
$(LLVM_CMAKE_ARGS) \
|
||||
$(dir $<)
|
||||
|
||||
.PHONY: configure-llvm
|
||||
configure-llvm: $(LLVM_BUILD)/$(if $(NINJA),build.ninja,Makefile)
|
||||
|
||||
# The DESTDIR fix is to prevent the build from trying to install this out-of-build-tree
|
||||
# as the DESTDIR hasn't been created when we're building mono
|
||||
|
||||
.PHONY: build-llvm
|
||||
build-llvm: configure-llvm
|
||||
DESTDIR="" $(if $(NINJA),$(NINJA),$(MAKE)) -C $(LLVM_BUILD)
|
||||
|
||||
.PHONY: install-llvm
|
||||
install-llvm: build-llvm | $(LLVM_PREFIX)
|
||||
DESTDIR="" $(if $(NINJA),$(NINJA),$(MAKE)) -C $(LLVM_BUILD) install
|
||||
|
||||
.PHONY: download-llvm
|
||||
download-llvm:
|
||||
(wget --no-verbose -O - $(LLVM_DOWNLOAD_LOCATION) || curl -L $(LLVM_DOWNLOAD_LOCATION)) | tar -xzf - -C $(dir $(LLVM_PREFIX))
|
||||
|
||||
.PHONY: clean-llvm
|
||||
clean-llvm:
|
||||
$(RM) -r $(LLVM_BUILD) $(LLVM_PREFIX)
|
||||
@@ -1,172 +0,0 @@
|
||||
#!/bin/bash
|
||||
|
||||
llvm_config=$1
|
||||
llvm_codegen_libs="$2"
|
||||
llvm_extra_libs="${@:3}"
|
||||
|
||||
use_llvm_config=1
|
||||
llvm_host_win32=0
|
||||
llvm_host_win32_wsl=0
|
||||
llvm_host_win32_cygwin=0
|
||||
|
||||
function win32_format_path {
|
||||
local formatted_path=$1
|
||||
if [[ $llvm_host_win32_wsl = 1 ]] && [[ $1 != "/mnt/"* ]]; then
|
||||
# if path is not starting with /mnt under WSL it could be a windows path, convert using wslpath.
|
||||
formatted_path="$(wslpath -a "$1")"
|
||||
elif [[ $llvm_host_win32_cygwin = 1 ]] && [[ $1 != "/cygdrive/"* ]]; then
|
||||
# if path is not starting with /cygdrive under CygWin it could be a windows path, convert using cygpath.
|
||||
formatted_path="$(cygpath -a "$1")"
|
||||
fi
|
||||
echo "$formatted_path"
|
||||
}
|
||||
|
||||
if [[ $llvm_config = *".exe" ]]; then
|
||||
llvm_host_win32=1
|
||||
# llvm-config is a windows binary. Check if we are running CygWin or WSL since then we might still be able to run llvm-config.exe
|
||||
host_uname="$(uname -a)"
|
||||
case "$host_uname" in
|
||||
*Microsoft*)
|
||||
use_llvm_config=1
|
||||
llvm_host_win32_wsl=1
|
||||
;;
|
||||
CYGWIN*)
|
||||
use_llvm_config=1
|
||||
llvm_host_win32_cygwin=1
|
||||
;;
|
||||
*)
|
||||
use_llvm_config=0
|
||||
esac
|
||||
fi
|
||||
|
||||
if [[ $llvm_host_win32 = 1 ]]; then
|
||||
llvm_config=$(win32_format_path "$llvm_config")
|
||||
fi
|
||||
|
||||
if [[ $use_llvm_config = 1 ]]; then
|
||||
llvm_api_version=`$llvm_config --mono-api-version` || "0"
|
||||
with_llvm=`$llvm_config --prefix`
|
||||
llvm_config_cflags=`$llvm_config --cflags`
|
||||
llvm_system=`$llvm_config --system-libs`
|
||||
llvm_core_components=`$llvm_config --libs analysis core bitwriter`
|
||||
if [[ $llvm_api_version -lt 600 ]]; then
|
||||
llvm_old_jit=`$llvm_config --libs mcjit jit 2>>/dev/null`
|
||||
else
|
||||
llvm_old_jit=`$llvm_config --libs mcjit 2>>/dev/null`
|
||||
fi
|
||||
llvm_new_jit=`$llvm_config --libs orcjit 2>>/dev/null`
|
||||
|
||||
if [[ ! -z $llvm_codegen_libs ]]; then
|
||||
llvm_extra=`$llvm_config --libs $llvm_codegen_libs`
|
||||
fi
|
||||
|
||||
# When building for Windows subsystem using WSL or CygWin the path returned from llvm-config.exe
|
||||
# could be a Windows style path, make sure to format it into a path usable for WSL/CygWin.
|
||||
if [[ $llvm_host_win32 = 1 ]]; then
|
||||
with_llvm=$(win32_format_path "$with_llvm")
|
||||
fi
|
||||
fi
|
||||
|
||||
# When cross compiling for Windows on system not capable of running Windows binaries, llvm-config.exe can't be used to query for
|
||||
# LLVM parameters. In that scenario we will need to fallback to default values.
|
||||
if [[ $llvm_host_win32 = 1 ]] && [[ $use_llvm_config = 0 ]]; then
|
||||
# Assume we have llvm-config sitting in llvm-install-root/bin directory, get llvm-install-root directory.
|
||||
with_llvm="$(dirname $llvm_config)"
|
||||
with_llvm="$(dirname $with_llvm)"
|
||||
llvm_config_path=$with_llvm/include/llvm/Config/llvm-config.h
|
||||
|
||||
# llvm-config.exe --mono-api-version
|
||||
llvm_api_version=`awk '/MONO_API_VERSION/ { print $3 }' $llvm_config_path`
|
||||
|
||||
# llvm-config.exe --cflags, returned information currently not used.
|
||||
llvm_config_cflags=
|
||||
|
||||
# llvm-config.exe --system-libs
|
||||
if [[ $llvm_api_version -lt 600 ]]; then
|
||||
llvm_system="-limagehlp -lpsapi -lshell32"
|
||||
else
|
||||
llvm_system="-lpsapi -lshell32 -lole32 -luuid -ladvapi32"
|
||||
fi
|
||||
|
||||
# llvm-config.exe --libs analysis core bitwriter
|
||||
if [[ $llvm_api_version -lt 600 ]]; then
|
||||
llvm_core_components="-lLLVMBitWriter -lLLVMAnalysis -lLLVMTarget -lLLVMMC -lLLVMCore -lLLVMSupport"
|
||||
else
|
||||
llvm_core_components="-lLLVMBitWriter -lLLVMAnalysis -lLLVMProfileData -lLLVMObject -lLLVMMCParser -lLLVMMC -lLLVMBitReader -lLLVMCore -lLLVMBinaryFormat -lLLVMSupport -lLLVMDemangle"
|
||||
fi
|
||||
|
||||
# llvm-config.exe --libs mcjit jit
|
||||
if [[ $llvm_api_version -lt 600 ]]; then
|
||||
llvm_old_jit="-lLLVMJIT -lLLVMCodeGen -lLLVMScalarOpts -lLLVMInstCombine -lLLVMTransformUtils -lLLVMipa -lLLVMAnalysis -lLLVMMCJIT -lLLVMTarget -lLLVMRuntimeDyld -lLLVMObject -lLLVMMCParser -lLLVMBitReader -lLLVMExecutionEngine -lLLVMMC -lLLVMCore -lLLVMSupport"
|
||||
else
|
||||
# Current build of LLVM 60 for cross Windows builds doesn't support LLVM JIT.
|
||||
llvm_old_jit=
|
||||
fi
|
||||
|
||||
# LLVM 36 doesn't support new JIT and LLVM 60 is build without LLVM JIT support for cross Windows builds.
|
||||
llvm_new_jit=
|
||||
|
||||
# Check codegen libs and add needed libraries.
|
||||
case "$llvm_codegen_libs" in
|
||||
*x86codegen*)
|
||||
# llvm-config.exe --libs x86codegen
|
||||
if [[ $llvm_api_version -lt 600 ]]; then
|
||||
llvm_extra="-lLLVMX86CodeGen -lLLVMX86Desc -lLLVMX86Info -lLLVMObject -lLLVMBitReader -lLLVMMCDisassembler -lLLVMX86AsmPrinter -lLLVMX86Utils -lLLVMSelectionDAG -lLLVMAsmPrinter -lLLVMMCParser -lLLVMCodeGen -lLLVMScalarOpts -lLLVMInstCombine -lLLVMTransformUtils -lLLVMipa -lLLVMAnalysis -lLLVMTarget -lLLVMMC -lLLVMCore -lLLVMSupport"
|
||||
else
|
||||
llvm_extra="-lLLVMX86CodeGen -lLLVMGlobalISel -lLLVMX86Desc -lLLVMX86Info -lLLVMMCDisassembler -lLLVMX86AsmPrinter -lLLVMX86Utils -lLLVMSelectionDAG -lLLVMAsmPrinter -lLLVMDebugInfoCodeView -lLLVMDebugInfoMSF -lLLVMCodeGen -lLLVMTarget -lLLVMScalarOpts -lLLVMInstCombine -lLLVMTransformUtils -lLLVMBitWriter -lLLVMAnalysis -lLLVMProfileData -lLLVMObject -lLLVMMCParser -lLLVMMC -lLLVMBitReader -lLLVMCore -lLLVMBinaryFormat -lLLVMSupport -lLLVMDemangle"
|
||||
fi
|
||||
;;
|
||||
*armcodegen*)
|
||||
# llvm-config.exe --libs armcodegen
|
||||
if [[ $llvm_api_version -lt 600 ]]; then
|
||||
llvm_extra="-lLLVMARMCodeGen -lLLVMSelectionDAG -lLLVMAsmPrinter -lLLVMMCParser -lLLVMCodeGen -lLLVMScalarOpts -lLLVMInstCombine -lLLVMTransformUtils -lLLVMipa -lLLVMAnalysis -lLLVMTarget -lLLVMCore -lLLVMARMDesc -lLLVMMCDisassembler -lLLVMARMInfo -lLLVMARMAsmPrinter -lLLVMMC -lLLVMSupport"
|
||||
else
|
||||
llvm_extra="-lLLVMARMCodeGen -lLLVMGlobalISel -lLLVMSelectionDAG -lLLVMAsmPrinter -lLLVMDebugInfoCodeView -lLLVMDebugInfoMSF -lLLVMCodeGen -lLLVMTarget -lLLVMScalarOpts -lLLVMInstCombine -lLLVMTransformUtils -lLLVMBitWriter -lLLVMAnalysis -lLLVMProfileData -lLLVMObject -lLLVMMCParser -lLLVMBitReader -lLLVMCore -lLLVMBinaryFormat -lLLVMARMDesc -lLLVMMCDisassembler -lLLVMARMInfo -lLLVMARMAsmPrinter -lLLVMARMUtils -lLLVMMC -lLLVMSupport -lLLVMDemangle"
|
||||
fi
|
||||
;;
|
||||
*aarch64codegen*)
|
||||
# llvm-config.exe --libs aarch64codegen
|
||||
if [[ $llvm_api_version -lt 600 ]]; then
|
||||
llvm_extra="-lLLVMAArch64CodeGen -lLLVMSelectionDAG -lLLVMAsmPrinter -lLLVMMCParser -lLLVMCodeGen -lLLVMScalarOpts -lLLVMInstCombine -lLLVMTransformUtils -lLLVMipa -lLLVMAnalysis -lLLVMTarget -lLLVMCore -lLLVMAArch64Desc -lLLVMAArch64Info -lLLVMAArch64AsmPrinter -lLLVMMC -lLLVMAArch64Utils -lLLVMSupport"
|
||||
else
|
||||
llvm_extra="-lLLVMAArch64CodeGen -lLLVMGlobalISel -lLLVMSelectionDAG -lLLVMAsmPrinter -lLLVMDebugInfoCodeView -lLLVMDebugInfoMSF -lLLVMCodeGen -lLLVMTarget -lLLVMScalarOpts -lLLVMInstCombine -lLLVMTransformUtils -lLLVMBitWriter -lLLVMAnalysis -lLLVMProfileData -lLLVMObject -lLLVMMCParser -lLLVMBitReader -lLLVMCore -lLLVMBinaryFormat -lLLVMAArch64Desc -lLLVMAArch64Info -lLLVMAArch64AsmPrinter -lLLVMMC -lLLVMAArch64Utils -lLLVMSupport -lLLVMDemangle"
|
||||
fi
|
||||
;;
|
||||
*)
|
||||
llvm_extra=$llvm_codegen_libs
|
||||
esac
|
||||
fi
|
||||
|
||||
if [[ $llvm_config_cflags = *"stdlib=libc++"* ]]; then
|
||||
llvm_libc_c="-stdlib=libc++"
|
||||
llvm_libc_link="-lc++"
|
||||
else
|
||||
llvm_libc_c=""
|
||||
llvm_libc_link="-lstdc++"
|
||||
fi
|
||||
|
||||
if [[ $llvm_host_win32 = 1 ]]; then
|
||||
host_cxxflag_additions="-std=gnu++11"
|
||||
host_cflag_additions="-DNDEBUG"
|
||||
else
|
||||
host_cxxflag_additions="-std=c++11"
|
||||
host_cflag_additions=""
|
||||
fi
|
||||
|
||||
if [[ ! -z $llvm_extra_libs ]]; then
|
||||
llvm_extra="$llvm_extra $llvm_extra_libs"
|
||||
fi
|
||||
|
||||
# llvm-config --clfags adds warning and optimization flags we don't want
|
||||
cflags_additions="-I$with_llvm/include -D__STDC_CONSTANT_MACROS -D__STDC_FORMAT_MACROS -D__STDC_LIMIT_MACROS -DLLVM_API_VERSION=$llvm_api_version $llvm_libc_c $host_cflag_additions"
|
||||
|
||||
cxxflag_additions="-fno-rtti -fexceptions $host_cxxflag_additions"
|
||||
|
||||
ldflags="-L$with_llvm/lib"
|
||||
|
||||
llvm_lib_components="$llvm_core_components $llvm_old_jit $llvm_new_jit $llvm_extra"
|
||||
|
||||
echo "LLVM_CFLAGS_INTERNAL=$cflags_additions"
|
||||
echo "LLVM_CXXFLAGS_INTERNAL=$cflags_additions $cxxflag_additions"
|
||||
echo "LLVM_LDFLAGS_INTERNAL=$ldflags"
|
||||
echo "LLVM_LIBS_INTERNAL=$llvm_lib_components $ldflags $llvm_system $llvm_libc_link"
|
||||
+1
-1
@@ -1 +1 @@
|
||||
EXTRA_DIST = lib-ld.m4 lib-link.m4 lib-prefix.m4 $(wildcard *.m4)
|
||||
EXTRA_DIST = iconv.m4 lib-ld.m4 lib-link.m4 lib-prefix.m4 $(wildcard *.m4)
|
||||
@@ -1,74 +0,0 @@
|
||||
# ===========================================================================
|
||||
# https://www.gnu.org/software/autoconf-archive/ax_check_compile_flag.html
|
||||
# ===========================================================================
|
||||
#
|
||||
# SYNOPSIS
|
||||
#
|
||||
# AX_CHECK_COMPILE_FLAG(FLAG, [ACTION-SUCCESS], [ACTION-FAILURE], [EXTRA-FLAGS], [INPUT])
|
||||
#
|
||||
# DESCRIPTION
|
||||
#
|
||||
# Check whether the given FLAG works with the current language's compiler
|
||||
# or gives an error. (Warnings, however, are ignored)
|
||||
#
|
||||
# ACTION-SUCCESS/ACTION-FAILURE are shell commands to execute on
|
||||
# success/failure.
|
||||
#
|
||||
# If EXTRA-FLAGS is defined, it is added to the current language's default
|
||||
# flags (e.g. CFLAGS) when the check is done. The check is thus made with
|
||||
# the flags: "CFLAGS EXTRA-FLAGS FLAG". This can for example be used to
|
||||
# force the compiler to issue an error when a bad flag is given.
|
||||
#
|
||||
# INPUT gives an alternative input source to AC_COMPILE_IFELSE.
|
||||
#
|
||||
# NOTE: Implementation based on AX_CFLAGS_GCC_OPTION. Please keep this
|
||||
# macro in sync with AX_CHECK_{PREPROC,LINK}_FLAG.
|
||||
#
|
||||
# LICENSE
|
||||
#
|
||||
# Copyright (c) 2008 Guido U. Draheim <[email protected]>
|
||||
# Copyright (c) 2011 Maarten Bosmans <[email protected]>
|
||||
#
|
||||
# This program is free software: you can redistribute it and/or modify it
|
||||
# under the terms of the GNU General Public License as published by the
|
||||
# Free Software Foundation, either version 3 of the License, or (at your
|
||||
# option) any later version.
|
||||
#
|
||||
# This program is distributed in the hope that it will be useful, but
|
||||
# WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
|
||||
# Public License for more details.
|
||||
#
|
||||
# You should have received a copy of the GNU General Public License along
|
||||
# with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
#
|
||||
# As a special exception, the respective Autoconf Macro's copyright owner
|
||||
# gives unlimited permission to copy, distribute and modify the configure
|
||||
# scripts that are the output of Autoconf when processing the Macro. You
|
||||
# need not follow the terms of the GNU General Public License when using
|
||||
# or distributing such scripts, even though portions of the text of the
|
||||
# Macro appear in them. The GNU General Public License (GPL) does govern
|
||||
# all other use of the material that constitutes the Autoconf Macro.
|
||||
#
|
||||
# This special exception to the GPL applies to versions of the Autoconf
|
||||
# Macro released by the Autoconf Archive. When you make and distribute a
|
||||
# modified version of the Autoconf Macro, you may extend this special
|
||||
# exception to the GPL to apply to your modified version as well.
|
||||
|
||||
#serial 5
|
||||
|
||||
AC_DEFUN([AX_CHECK_COMPILE_FLAG],
|
||||
[AC_PREREQ(2.63)dnl for _AC_LANG_PREFIX and AS_VAR_IF
|
||||
AS_VAR_PUSHDEF([CACHEVAR],[ax_cv_check_[]_AC_LANG_ABBREV[]flags_$4_$1])dnl
|
||||
AC_CACHE_CHECK([whether _AC_LANG compiler accepts $1], CACHEVAR, [
|
||||
ax_check_save_flags=$[]_AC_LANG_PREFIX[]FLAGS
|
||||
_AC_LANG_PREFIX[]FLAGS="$[]_AC_LANG_PREFIX[]FLAGS $4 $1"
|
||||
AC_COMPILE_IFELSE([m4_default([$5],[AC_LANG_PROGRAM()])],
|
||||
[AS_VAR_SET(CACHEVAR,[yes])],
|
||||
[AS_VAR_SET(CACHEVAR,[no])])
|
||||
_AC_LANG_PREFIX[]FLAGS=$ax_check_save_flags])
|
||||
AS_VAR_IF(CACHEVAR,yes,
|
||||
[m4_default([$2], :)],
|
||||
[m4_default([$3], :)])
|
||||
AS_VAR_POPDEF([CACHEVAR])dnl
|
||||
])dnl AX_CHECK_COMPILE_FLAGS
|
||||
+214
@@ -0,0 +1,214 @@
|
||||
# iconv.m4 serial 11 (gettext-0.18.1)
|
||||
dnl Copyright (C) 2000-2002, 2007-2010 Free Software Foundation, Inc.
|
||||
dnl This file is free software; the Free Software Foundation
|
||||
dnl gives unlimited permission to copy and/or distribute it,
|
||||
dnl with or without modifications, as long as this notice is preserved.
|
||||
|
||||
dnl From Bruno Haible.
|
||||
|
||||
AC_DEFUN([AM_ICONV_LINKFLAGS_BODY],
|
||||
[
|
||||
dnl Prerequisites of AC_LIB_LINKFLAGS_BODY.
|
||||
AC_REQUIRE([AC_LIB_PREPARE_PREFIX])
|
||||
AC_REQUIRE([AC_LIB_RPATH])
|
||||
|
||||
dnl Search for libiconv and define LIBICONV, LTLIBICONV and INCICONV
|
||||
dnl accordingly.
|
||||
AC_LIB_LINKFLAGS_BODY([iconv])
|
||||
])
|
||||
|
||||
AC_DEFUN([AM_ICONV_LINK],
|
||||
[
|
||||
dnl Some systems have iconv in libc, some have it in libiconv (OSF/1 and
|
||||
dnl those with the standalone portable GNU libiconv installed).
|
||||
AC_REQUIRE([AC_CANONICAL_HOST]) dnl for cross-compiles
|
||||
|
||||
dnl Search for libiconv and define LIBICONV, LTLIBICONV and INCICONV
|
||||
dnl accordingly.
|
||||
AC_REQUIRE([AM_ICONV_LINKFLAGS_BODY])
|
||||
|
||||
dnl Add $INCICONV to CPPFLAGS before performing the following checks,
|
||||
dnl because if the user has installed libiconv and not disabled its use
|
||||
dnl via --without-libiconv-prefix, he wants to use it. The first
|
||||
dnl AC_TRY_LINK will then fail, the second AC_TRY_LINK will succeed.
|
||||
am_save_CPPFLAGS="$CPPFLAGS"
|
||||
AC_LIB_APPENDTOVAR([CPPFLAGS], [$INCICONV])
|
||||
|
||||
AC_CACHE_CHECK([for iconv], [am_cv_func_iconv], [
|
||||
am_cv_func_iconv="no, consider installing GNU libiconv"
|
||||
am_cv_lib_iconv=no
|
||||
AC_TRY_LINK([#include <stdlib.h>
|
||||
#include <iconv.h>],
|
||||
[iconv_t cd = iconv_open("","");
|
||||
iconv(cd,NULL,NULL,NULL,NULL);
|
||||
iconv_close(cd);],
|
||||
[am_cv_func_iconv=yes])
|
||||
if test "$am_cv_func_iconv" != yes; then
|
||||
am_save_LIBS="$LIBS"
|
||||
LIBS="$LIBS $LIBICONV"
|
||||
AC_TRY_LINK([#include <stdlib.h>
|
||||
#include <iconv.h>],
|
||||
[iconv_t cd = iconv_open("","");
|
||||
iconv(cd,NULL,NULL,NULL,NULL);
|
||||
iconv_close(cd);],
|
||||
[am_cv_lib_iconv=yes]
|
||||
[am_cv_func_iconv=yes])
|
||||
LIBS="$am_save_LIBS"
|
||||
fi
|
||||
])
|
||||
if test "$am_cv_func_iconv" = yes; then
|
||||
AC_CACHE_CHECK([for working iconv], [am_cv_func_iconv_works], [
|
||||
dnl This tests against bugs in AIX 5.1, HP-UX 11.11, Solaris 10.
|
||||
am_save_LIBS="$LIBS"
|
||||
if test $am_cv_lib_iconv = yes; then
|
||||
LIBS="$LIBS $LIBICONV"
|
||||
fi
|
||||
AC_TRY_RUN([
|
||||
#include <iconv.h>
|
||||
#include <string.h>
|
||||
int main ()
|
||||
{
|
||||
/* Test against AIX 5.1 bug: Failures are not distinguishable from successful
|
||||
returns. */
|
||||
{
|
||||
iconv_t cd_utf8_to_88591 = iconv_open ("ISO8859-1", "UTF-8");
|
||||
if (cd_utf8_to_88591 != (iconv_t)(-1))
|
||||
{
|
||||
static const char input[] = "\342\202\254"; /* EURO SIGN */
|
||||
char buf[10];
|
||||
const char *inptr = input;
|
||||
size_t inbytesleft = strlen (input);
|
||||
char *outptr = buf;
|
||||
size_t outbytesleft = sizeof (buf);
|
||||
size_t res = iconv (cd_utf8_to_88591,
|
||||
(char **) &inptr, &inbytesleft,
|
||||
&outptr, &outbytesleft);
|
||||
if (res == 0)
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
/* Test against Solaris 10 bug: Failures are not distinguishable from
|
||||
successful returns. */
|
||||
{
|
||||
iconv_t cd_ascii_to_88591 = iconv_open ("ISO8859-1", "646");
|
||||
if (cd_ascii_to_88591 != (iconv_t)(-1))
|
||||
{
|
||||
static const char input[] = "\263";
|
||||
char buf[10];
|
||||
const char *inptr = input;
|
||||
size_t inbytesleft = strlen (input);
|
||||
char *outptr = buf;
|
||||
size_t outbytesleft = sizeof (buf);
|
||||
size_t res = iconv (cd_ascii_to_88591,
|
||||
(char **) &inptr, &inbytesleft,
|
||||
&outptr, &outbytesleft);
|
||||
if (res == 0)
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
#if 0 /* This bug could be worked around by the caller. */
|
||||
/* Test against HP-UX 11.11 bug: Positive return value instead of 0. */
|
||||
{
|
||||
iconv_t cd_88591_to_utf8 = iconv_open ("utf8", "iso88591");
|
||||
if (cd_88591_to_utf8 != (iconv_t)(-1))
|
||||
{
|
||||
static const char input[] = "\304rger mit b\366sen B\374bchen ohne Augenma\337";
|
||||
char buf[50];
|
||||
const char *inptr = input;
|
||||
size_t inbytesleft = strlen (input);
|
||||
char *outptr = buf;
|
||||
size_t outbytesleft = sizeof (buf);
|
||||
size_t res = iconv (cd_88591_to_utf8,
|
||||
(char **) &inptr, &inbytesleft,
|
||||
&outptr, &outbytesleft);
|
||||
if ((int)res > 0)
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
#endif
|
||||
/* Test against HP-UX 11.11 bug: No converter from EUC-JP to UTF-8 is
|
||||
provided. */
|
||||
if (/* Try standardized names. */
|
||||
iconv_open ("UTF-8", "EUC-JP") == (iconv_t)(-1)
|
||||
/* Try IRIX, OSF/1 names. */
|
||||
&& iconv_open ("UTF-8", "eucJP") == (iconv_t)(-1)
|
||||
/* Try AIX names. */
|
||||
&& iconv_open ("UTF-8", "IBM-eucJP") == (iconv_t)(-1)
|
||||
/* Try HP-UX names. */
|
||||
&& iconv_open ("utf8", "eucJP") == (iconv_t)(-1))
|
||||
return 1;
|
||||
return 0;
|
||||
}], [am_cv_func_iconv_works=yes], [am_cv_func_iconv_works=no],
|
||||
[case "$host_os" in
|
||||
aix* | hpux*) am_cv_func_iconv_works="guessing no" ;;
|
||||
*) am_cv_func_iconv_works="guessing yes" ;;
|
||||
esac])
|
||||
LIBS="$am_save_LIBS"
|
||||
])
|
||||
case "$am_cv_func_iconv_works" in
|
||||
*no) am_func_iconv=no am_cv_lib_iconv=no ;;
|
||||
*) am_func_iconv=yes ;;
|
||||
esac
|
||||
else
|
||||
am_func_iconv=no am_cv_lib_iconv=no
|
||||
fi
|
||||
if test "$am_func_iconv" = yes; then
|
||||
AC_DEFINE([HAVE_ICONV], [1],
|
||||
[Define if you have the iconv() function and it works.])
|
||||
fi
|
||||
if test "$am_cv_lib_iconv" = yes; then
|
||||
AC_MSG_CHECKING([how to link with libiconv])
|
||||
AC_MSG_RESULT([$LIBICONV])
|
||||
else
|
||||
dnl If $LIBICONV didn't lead to a usable library, we don't need $INCICONV
|
||||
dnl either.
|
||||
CPPFLAGS="$am_save_CPPFLAGS"
|
||||
LIBICONV=
|
||||
LTLIBICONV=
|
||||
fi
|
||||
AC_SUBST([LIBICONV])
|
||||
AC_SUBST([LTLIBICONV])
|
||||
])
|
||||
|
||||
dnl Define AM_ICONV using AC_DEFUN_ONCE for Autoconf >= 2.64, in order to
|
||||
dnl avoid warnings like
|
||||
dnl "warning: AC_REQUIRE: `AM_ICONV' was expanded before it was required".
|
||||
dnl This is tricky because of the way 'aclocal' is implemented:
|
||||
dnl - It requires defining an auxiliary macro whose name ends in AC_DEFUN.
|
||||
dnl Otherwise aclocal's initial scan pass would miss the macro definition.
|
||||
dnl - It requires a line break inside the AC_DEFUN_ONCE and AC_DEFUN expansions.
|
||||
dnl Otherwise aclocal would emit many "Use of uninitialized value $1"
|
||||
dnl warnings.
|
||||
m4_define([gl_iconv_AC_DEFUN],
|
||||
m4_version_prereq([2.64],
|
||||
[[AC_DEFUN_ONCE(
|
||||
[$1], [$2])]],
|
||||
[[AC_DEFUN(
|
||||
[$1], [$2])]]))
|
||||
gl_iconv_AC_DEFUN([AM_ICONV],
|
||||
[
|
||||
AM_ICONV_LINK
|
||||
if test "$am_cv_func_iconv" = yes; then
|
||||
AC_MSG_CHECKING([for iconv declaration])
|
||||
AC_CACHE_VAL([am_cv_proto_iconv], [
|
||||
AC_TRY_COMPILE([
|
||||
#include <stdlib.h>
|
||||
#include <iconv.h>
|
||||
extern
|
||||
#ifdef __cplusplus
|
||||
"C"
|
||||
#endif
|
||||
#if defined(__STDC__) || defined(__cplusplus)
|
||||
size_t iconv (iconv_t cd, char * *inbuf, size_t *inbytesleft, char * *outbuf, size_t *outbytesleft);
|
||||
#else
|
||||
size_t iconv();
|
||||
#endif
|
||||
], [], [am_cv_proto_iconv_arg1=""], [am_cv_proto_iconv_arg1="const"])
|
||||
am_cv_proto_iconv="extern size_t iconv (iconv_t cd, $am_cv_proto_iconv_arg1 char * *inbuf, size_t *inbytesleft, char * *outbuf, size_t *outbytesleft);"])
|
||||
am_cv_proto_iconv=`echo "[$]am_cv_proto_iconv" | tr -s ' ' | sed -e 's/( /(/'`
|
||||
AC_MSG_RESULT([
|
||||
$am_cv_proto_iconv])
|
||||
AC_DEFINE_UNQUOTED([ICONV_CONST], [$am_cv_proto_iconv_arg1],
|
||||
[Define as const if the declaration of iconv() needs const.])
|
||||
fi
|
||||
])
|
||||
+1
-3
@@ -13,7 +13,6 @@ man_MANS = \
|
||||
genxs.1 \
|
||||
httpcfg.1 \
|
||||
ilasm.1 \
|
||||
illinkanalyzer.1 \
|
||||
lc.1 \
|
||||
macpack.1 \
|
||||
makecert.1 \
|
||||
@@ -59,7 +58,6 @@ man_MANS = \
|
||||
mono-configuration-crypto.1 \
|
||||
ccrewrite.1 \
|
||||
cccheck.1 \
|
||||
mono-symbolicate.1 \
|
||||
mono-profilers.1
|
||||
mono-symbolicate.1
|
||||
|
||||
EXTRA_DIST = $(man_MANS)
|
||||
@@ -1,132 +0,0 @@
|
||||
.TH illinkanalyzer 1
|
||||
.SH NAME
|
||||
illinkanalyzer \- Mono's linker analyzer tool
|
||||
.SH SYNOPSIS
|
||||
.B illinkanalyzer
|
||||
\fR[\fIoptions\fR] <\fIlinker-dependency-file.xml.gz\fR>
|
||||
.SH DESCRIPTION
|
||||
Linker analyzer is a command line tool to analyze dependencies, which
|
||||
were recorded during linker processing, and led linker to mark an item
|
||||
to keep it in the resulting linked assembly.
|
||||
.PP
|
||||
It works on an oriented graph of dependencies, which are collected and
|
||||
dumped during the linker run. The vertices of this graph are the items
|
||||
of interest like assemblies, types, methods, fields, linker steps,
|
||||
etc. The edges represent the dependencies.
|
||||
.SH HOW TO DUMP DEPENDENCIES
|
||||
The linker analyzer needs a linker dependencies file as an input. It
|
||||
can be retrieved by enabling dependencies dumping during linking of a
|
||||
Xamarin.Android or a Xamarin.iOS project.
|
||||
.PP
|
||||
That can be done on the command line by setting LinkerDumpDependencies
|
||||
property to true and building the project. (make sure the
|
||||
LinkAssemblies task is called, it might require cleaning the project
|
||||
sometimes) Usually it is enough to build the project like this:
|
||||
.PP
|
||||
.nf
|
||||
.RS
|
||||
rm -f obj/Release/link.flag
|
||||
msbuild /p:LinkerDumpDependencies=true /p:Configuration=Release YourAppProject.csproj
|
||||
.RE
|
||||
.fi
|
||||
.PP
|
||||
After a successful build, there will be a linker-dependencies.xml.gz
|
||||
file created, containing the information for the analyzer.
|
||||
.SH OPTIONS
|
||||
.nf
|
||||
.RS
|
||||
-a, --alldeps show all dependencies
|
||||
--csvoutput=VALUE outputs types and optionally size analysis to CSV
|
||||
file
|
||||
-h, --help show this message and exit.
|
||||
-l, --linkedpath=VALUE sets the linked assemblies directory path. Enables
|
||||
displaying size estimates.
|
||||
-r, --rawdeps=VALUE show raw vertex dependencies. Raw vertex VALUE is
|
||||
in the raw format written by linker to the
|
||||
dependency XML file. VALUE can be regular
|
||||
expression
|
||||
--roots show root dependencies.
|
||||
--stat show statistic of loaded dependencies.
|
||||
--tree reduce the dependency graph to the tree.
|
||||
--types show all types dependencies.
|
||||
-t, --typedeps=VALUE show type dependencies. The VALUE can be regular
|
||||
expression
|
||||
-f, --flat show all dependencies per vertex and their distance
|
||||
-v, --verbose be more verbose. Enables stat and roots options.
|
||||
.RE
|
||||
.fi
|
||||
.SH EXAMPLES
|
||||
Let say you would like to know, why a type, Android.App.Activity for
|
||||
example, was marked by the linker. So run the analyzer like this:
|
||||
.PP
|
||||
.nf
|
||||
.RS
|
||||
illinkanalyzer -t Android.App.Activity linker-dependencies.xml.gz
|
||||
.fi
|
||||
.RE
|
||||
.PP
|
||||
Output:
|
||||
.PP
|
||||
.nf
|
||||
.RS
|
||||
Loading dependency tree from: linker-dependencies.xml.gz
|
||||
|
||||
--- Type dependencies: 'Android.App.Activity' -----------------------
|
||||
|
||||
--- TypeDef:Android.App.Activity dependencies -----------------------
|
||||
Dependency #1
|
||||
TypeDef:Android.App.Activity
|
||||
| TypeDef:XA.App.MainActivity [2 deps]
|
||||
| Assembly:XA.App, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null [3 deps]
|
||||
| Other:Mono.Linker.Steps.ResolveFromAssemblyStep
|
||||
.fi
|
||||
.RE
|
||||
.PP
|
||||
The output contains dependencies string(s), starting with the type and
|
||||
continuing with the item of interest, which depends on the type. The
|
||||
dependency could be result of multiple reasons. For example the type
|
||||
was referenced from a method, or the type was listed in the linker xml
|
||||
file to be protected.
|
||||
.PP
|
||||
In our example there is only one dependency string called Dependency
|
||||
#1. It shows us that the type Android.App.Activity was marked during
|
||||
processing of type XA.App.MainActivity by the linker. In this case
|
||||
because the MainActivity type is based on the Activity type and thus
|
||||
the linker marked it and kept it in the linked assembly. We can also
|
||||
see that there are 2 dependencies for the MainActivity class. Note
|
||||
that in the string (above) we see only 1st dependency of the 2, the
|
||||
dependency on the assembly XA.App. And finally the assembly vertex
|
||||
depends on the ResolveFromAssemblyStep vertex. So we see that the
|
||||
assembly was processed in the ResolveFromAssembly linker step.
|
||||
.PP
|
||||
Now we might want to see the MainActivity dependencies. That could be done by the following analyzer run:
|
||||
.PP
|
||||
.nf
|
||||
.RS
|
||||
illinkanalyzer -r TypeDef:XA.App.MainActivity linker-dependencies.xml.gz
|
||||
.fi
|
||||
.RE
|
||||
.PP
|
||||
Output:
|
||||
.PP
|
||||
.nf
|
||||
.RS
|
||||
Loading dependency tree from: linker-dependencies.xml.gz
|
||||
|
||||
--- Raw dependencies: 'TypeDef:XA.App.MainActivity' -----------------
|
||||
|
||||
--- TypeDef:XA.App.MainActivity dependencies ------------------------
|
||||
Dependency #1
|
||||
TypeDef:XA.App.MainActivity
|
||||
| Assembly:XA.App, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null [3 deps]
|
||||
| Other:Mono.Linker.Steps.ResolveFromAssemblyStep
|
||||
Dependency #2
|
||||
TypeDef:XA.App.MainActivity
|
||||
| TypeDef:XA.App.MainActivity/<>c__DisplayClass1_0 [2 deps]
|
||||
| TypeDef:XA.App.MainActivity [2 deps]
|
||||
| Assembly:XA.App, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null [3 deps]
|
||||
| Other:Mono.Linker.Steps.ResolveFromAssemblyStep
|
||||
.fi
|
||||
.RE
|
||||
.SH SEE ALSO
|
||||
\fBmsbuild\fR(1)
|
||||
+17
-144
@@ -111,11 +111,10 @@ directory.
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
.I "--config FILE"
|
||||
Specifies that a DLLMAP Mono config file must be bundled as well. In
|
||||
the simple and cross compiler modes, if no config file is specified
|
||||
the one for the current target is picked (either the system one in the
|
||||
case of the simple mode, or the one that came from the cross
|
||||
compilation target for the cross compiling mode).
|
||||
Specifies that a machine.config file must be bundled as well.
|
||||
Typically this is $prefix/etc/mono/1.0/machine.config or
|
||||
$prefix/etc/mono/2.0/machine.config depending on the profile that you
|
||||
are using (1.0 or 2.0)
|
||||
.TP
|
||||
.I "--config-dir DIR"
|
||||
When passed, DIR will be set for the MONO_CFG_DIR environment variable
|
||||
@@ -189,45 +188,15 @@ as precompiled binaries on the Mono distribution server.
|
||||
.I "--local-targets"
|
||||
Lists all of the available local cross compilation targets.
|
||||
.TP
|
||||
.I "--cil-strip PATH"
|
||||
Provides a CIL stripper that mkbundle will use if able to.
|
||||
The intended use is to help reduce file size on AOT.
|
||||
.TP
|
||||
.I "--in-tree path/to/mono/source/root"
|
||||
Provides mkbundle with a mono source repository from which to pull the necessary headers for compilation.
|
||||
This allows mkbundle to run out of the project's source tree, useful for working with multiple runtimes and for
|
||||
testing without installing.
|
||||
.TP
|
||||
.I "--managed-linker PATH"
|
||||
Provides mkbundle access to a managed linker to preprocess the assemblies.
|
||||
.TP
|
||||
.I "--machine-config FILE"
|
||||
Uses the given FILE as the machine.config file for the generated
|
||||
application. The machine config contains an XML file that is used by
|
||||
System.Configuration APIs to configure the .NET stack. Typically this
|
||||
is
|
||||
.I $prefix/etc/mono/4.5/machine.config.
|
||||
.Sp
|
||||
If you want to disable this automatic bundling, you can use the
|
||||
.I "--no-machine-config"
|
||||
flag. In the simple and cross compiler modes, if no machine.config file is specified
|
||||
the one for the current target is picked (either the system one in the
|
||||
case of the simple mode, or the one that came from the cross
|
||||
compilation target for the cross compiling mode).
|
||||
.TP
|
||||
.I "--no-config"
|
||||
In simple or cross compiling mode, this prevents mkbundle from
|
||||
automatically bundling a config file.
|
||||
application.
|
||||
.TP
|
||||
.I "--nodeps"
|
||||
This is the default: \fImkbundle\fP will only include the assemblies that
|
||||
were specified on the command line to reduce the size of the resulting
|
||||
image created.
|
||||
.TP
|
||||
.I "--no-machine-config"
|
||||
In simple or cross compiling mode, this prevents mkbundle from
|
||||
automatically bundling a machine.config file.
|
||||
.TP
|
||||
.I "-o filename"
|
||||
Places the output on `out'. If the flag -c is specified, this is the
|
||||
C host program. If not, this contains the resulting executable.
|
||||
@@ -271,36 +240,6 @@ This flag is mutually exlusive with
|
||||
By default the mkbundle tool will download from a Mono server the
|
||||
target runtimes, you can specify a different server to provide
|
||||
cross-compiled runtimes.
|
||||
.TP
|
||||
.I "--mono-api-struct-path FILE"
|
||||
FILE points to a file with the definition of the \fIBundleMonoAPI\fP structure which contains the
|
||||
required pointers to various Mono API functions used throughout the generated code. This mechanism
|
||||
is meant to be used by third parties which embed the Mono runtime and dynamically load and initialize
|
||||
it as part of the application startup, in which case the Mono APIs will not be available for the shared
|
||||
library loader and the bundle will fail to work (one example of such an embedding third party is
|
||||
Xamarin.Android).
|
||||
|
||||
After providing the definition FILE, the embedder must call the \fIvoid initialize_mono_api (const BundleMonoAPI *info)\fP
|
||||
function found in the generated code
|
||||
.B before
|
||||
calling \fIvoid mono_mkbundle_init ()\fP. The structure passed to \fIinitialize_mono_api\fP doesn't need
|
||||
to be dynamically allocated as its contents is copied to the local structure in the generated code and no
|
||||
pointer to the passed structure is retained or used after \fIinitialize_mono_api\fP returns.
|
||||
|
||||
The list of pointers is not documented here. Instead, please look at the \fIbundle-mono-api.inc\fP file
|
||||
found in the mkbundle source directory in your Mono source tree (\fImcs/tools/mkbundle\fP) or in the Mono's
|
||||
GitHub repository, https://github.com/mono/mono/blob/master/mcs/tools/mkbundle/bundle-mono-api.inc
|
||||
|
||||
Please note that your structure must match the one expected by your version of the Mono runtime.
|
||||
|
||||
The file must also define the \fImkbundle_log_error\fP function with the following signature:
|
||||
|
||||
.nf
|
||||
static void mkbundle_log_error (const char *format, ...) {}
|
||||
.fi
|
||||
|
||||
The function should implement logging API specific to the embedder.
|
||||
|
||||
.SH OLD EMBEDDING
|
||||
.PP
|
||||
The old embedding system compiles a small C stub that embeds the
|
||||
@@ -369,100 +308,34 @@ causes it to statically link instead.
|
||||
Compresses the assemblies before embedding. This results in smaller
|
||||
executable files, but increases startup time and requires zlib to be
|
||||
installed on the target system.
|
||||
|
||||
.SH AOT Options
|
||||
These options support an mkbundle using AOT compilation with static linking. A native compiler
|
||||
toolchain is required.
|
||||
.TP
|
||||
.I "--aot-runtime PATH"
|
||||
Provide the path to the mono runtime to use for AOTing assemblies.
|
||||
.TP
|
||||
.I "--aot-dedup"
|
||||
(Experimental) Deduplicate AOT'ed methods based on a unique mangling of method names.
|
||||
.TP
|
||||
.I "--aot-mode MODE"
|
||||
MODE can be either "full" or "llvmonly" at this time.
|
||||
Currently, mkbundle supports three AOT modes. The default mode (this option unset)
|
||||
will AOT methods but will fall back on runtime codegen where it is much faster or offers
|
||||
a more full compatibility profile. The "full" setting will generate the necessary stubs to
|
||||
not require runtime code generation. The "llvmonly" setting does the same, but forces all codegen
|
||||
to go through the llvm backend.
|
||||
|
||||
.SH WINDOWS
|
||||
If you are using the old embedding on Windows systems, it possible to use
|
||||
a Unix-like toolchain like cygwin's and install gcc, gcc-mingw packages or
|
||||
use Visual Studio 2015/2017 VC toolchain together with Clang for Visual Studio as assembler.
|
||||
Clang can be installed as an individual component, "Clang/C2", using Visual Studio installer.
|
||||
.PP
|
||||
Using Visual Studio toolchain, mkbundle will, by default, use latest installed Visual Studio compiler
|
||||
and linker as well as Windows SDK. If executed from one of the Visual Studio developer command prompts,
|
||||
mkbundle will retrieve information directly from that build environment.
|
||||
If you are using the old embedding on Windows systems, it it necessary
|
||||
to have Unix-like toolchain to be installed for \fImkbundle\fP to
|
||||
work. You can use cygwin's and install gcc, gcc-mingw and as
|
||||
packages.
|
||||
.SH ENVIRONMENT VARIABLES
|
||||
.TP
|
||||
.I "AS"
|
||||
Assembler command. The default is "as". For Visual Studio, default is "clang.exe".
|
||||
If "clang.exe" for Visual Studio is not installed, mkbundle will fall back using "as".
|
||||
Assembler command. The default is "as".
|
||||
.TP
|
||||
.I "CC"
|
||||
C compiler command. The default is "cc" for Linux, "gcc"
|
||||
for cygwin and "cl.exe" for Visual Studio.
|
||||
C compiler command. The default is "cc" under Linux and "gcc"
|
||||
under Windows.
|
||||
.TP
|
||||
.I "MONO_BUNDLED_OPTIONS"
|
||||
Options to be passed to the bundled
|
||||
Mono runtime, separated by spaces. See the mono(1) manual page or run mono --help.
|
||||
.SH WINDOWS VISUAL STUDIO ENVIRONMENT VARIABLES
|
||||
.TP
|
||||
.I "VisualStudioVersion"
|
||||
Visual Studio version used in mkbundle build.
|
||||
Default, latest installed Visual Studio version.
|
||||
Values, "14.0" for Visual Studio 2015 or "15.0" for Visual Studio 2017.
|
||||
.TP
|
||||
.I "WindowsSdkVersion"
|
||||
Windows SDK version used in mkbundle build.
|
||||
Default/unknown, latest installed Windows SDK.
|
||||
Values, "8.1", "10.0.10240.0", "10.0.15063.0" etc.
|
||||
.TP
|
||||
.I "VSCMD_ARG_TGT_ARCH"
|
||||
Output target architecture used in mkbundle build.
|
||||
Default/unknown, use architecture of .NET runtime executing mkbundle.
|
||||
Values, "x86" or "x64".
|
||||
NOTE, when running from a Visual Studio command prompt, this variable should already be set
|
||||
by the command prompt and match the rest of that build environment.
|
||||
.TP
|
||||
.I "INCLUDE"
|
||||
Override all custom include paths passed to "cl.exe".
|
||||
Predefined by Visual Studio developer command prompt or auto detected by mkbundle when undefined.
|
||||
.TP
|
||||
.I "LIB"
|
||||
Override all custom library paths passed to "link.exe".
|
||||
Predefined by Visual Studio developer command prompt or auto detected by mkbundle when undefined.
|
||||
.TP
|
||||
.I "MONOPREFIX"
|
||||
Use a custom Mono SDK install root matching the output target architecture (x86/x64).
|
||||
Default, mkbundle will look for installed Mono SDK’s matching targeted architecture.
|
||||
.TP
|
||||
.I "MONOLIB"
|
||||
Use a different mono library name or an absolute path to the mono library passed to linker.
|
||||
Default, mkbundle will use default mono library name depending on mkbundle dynamic/static use case.
|
||||
NOTE, supplied mono library needs to match mkbundle dynamic/static use case and target architecture.
|
||||
.TP
|
||||
.I "VCCRT"
|
||||
Override C-runtime library linker settings.
|
||||
Default "MD", mkbundle will use dynamic C-runtime linking on Windows compatible with Mono SDK distribution.
|
||||
If a custom built Mono runtime using static C-Runtime linkage is used, setting this variable to "MT"
|
||||
will link using static C-runtime libraries.
|
||||
.TP
|
||||
.I "VCSUBSYSTEM"
|
||||
Override Windows subsystem.
|
||||
Default, "windows". If console subsystem is preferred, use "console".
|
||||
NOTE, if console output is expected from output target process then
|
||||
set this variable to "console".
|
||||
.SH FILES
|
||||
This program will load referenced assemblies from the Mono assembly
|
||||
cache.
|
||||
.PP
|
||||
Targets are loaded from ~/.mono/targets/TARGETNAME/mono
|
||||
.SH BUGS
|
||||
The option "--static" is not supported under Windows when using the
|
||||
old embedding.
|
||||
Moreover, a full cygwin environment containing at least "gcc" and "as"
|
||||
is required for the build process. The generated executable does not
|
||||
depend on cygwin.
|
||||
.SH MAILING LISTS
|
||||
Visit http://lists.ximian.com/mailman/listinfo/mono-devel-list for details.
|
||||
.SH WEB SITE
|
||||
|
||||
@@ -2,17 +2,12 @@
|
||||
.SH NAME
|
||||
Mono CIL strip
|
||||
.SH SYNOPSIS
|
||||
.B mono-cil-strip [options] assembly [output-assembly]
|
||||
.B mono-cil-strip assembly [output-assembly]
|
||||
.SH DESCRIPTION
|
||||
mono-cil-strip is a tool which takes an assembly, and empty its method bodies.
|
||||
This is useful to reduce an assembly size when an assembly has already been
|
||||
compiled using Mono's Ahead Of Time compiler (AOT), where the CIL code is no
|
||||
longer necessary, but the metadata still is.
|
||||
.SH OPTIONS
|
||||
The following options are available:
|
||||
.TP
|
||||
.I "-q"
|
||||
Only output errors.
|
||||
.SH COPYRIGHT
|
||||
Copyright (C) 2008 Novell, Inc (http://www.novell.com)
|
||||
.SH MAILING LISTS
|
||||
|
||||
@@ -1,375 +0,0 @@
|
||||
.TH mono-profilers 1
|
||||
.SH NAME
|
||||
mono\-profilers \- Mono's bundled profiler modules
|
||||
.SH SYNOPSIS
|
||||
\fBmono\ \-\-profile=log\fR[:\fIoption\fR,...] \fIprogram.exe\fR [\fIargs\fR]...
|
||||
.PP
|
||||
\fBmono\ \-\-profile=coverage\fR[:\fIoption\fR,...] \fIprogram.exe\fR [\fIargs\fR]...
|
||||
.PP
|
||||
\fBmono\ \-\-profile=aot\fR[:\fIoption\fR,...] \fIprogram.exe\fR [\fIargs\fR]...
|
||||
.SH DESCRIPTION
|
||||
Mono ships with a few profiler modules that enable most typical
|
||||
profiling scenarios. This page describes each of them in the sections
|
||||
below.
|
||||
.SH LOG PROFILER
|
||||
The log profiler is Mono's general-purpose performance profiler. It
|
||||
can collect a wide variety of data that can be analyzed by tools such
|
||||
as \fBmprof\-report\fR(1) or the Xamarin Profiler.
|
||||
.PP
|
||||
By default, the log profiler writes its output to \fIoutput.mlpd\fR.
|
||||
Refer to the \fImono/profiler/log.h\fR file in the Mono source tree
|
||||
for documentation on the log profiler's file format.
|
||||
.PP
|
||||
A default invocation of the log profiler gathers only basic data:
|
||||
Metadata load and unload events, thread start and stop events,
|
||||
performance counter samples, exception throws, etc. Most users will
|
||||
want to enable some of the heavier features such as GC allocation
|
||||
recording, statistical sampling, heap snapshotting (heapshots), or
|
||||
method entry and exit instrumentation. See the \fBOptions\fR
|
||||
sub-section.
|
||||
.PP
|
||||
Note that, in most realistic scenarios, the log profiler will record
|
||||
a vast amount of data. This can lead to very large log files. (The
|
||||
\fBzip\fR and \fBreport\fR options can help deal with this.)
|
||||
.SS Options
|
||||
The log profiler supports the following options:
|
||||
.TP
|
||||
\fBhelp\fR
|
||||
Print usage instructions.
|
||||
.TP
|
||||
\fBoutput\fR=[\fI+\fR|\fI#\fR|\fI|\fR]\fIfile\fR
|
||||
Write log data to \fIfile\fR. The optional modifiers are:
|
||||
.RS
|
||||
.ne 8
|
||||
.TP
|
||||
\fB+\fR
|
||||
The program PID is appended to the file name. For example,
|
||||
\fBoutput=+out.mlpd\fR outputs to \fIout.mlpd.1234\fR if the PID is
|
||||
\fB1234\fR.
|
||||
.TP
|
||||
\fB#\fR
|
||||
\fIfile\fR is parsed as a file descriptor number, which is opened
|
||||
with \fBfdopen\fR(3). This is mainly useful in embedding scenarios.
|
||||
.TP
|
||||
\fB|\fR
|
||||
\fIfile\fR is treated as a program name. It will be started with
|
||||
\fBpopen\fR(3) and the log data will be piped to its standard input.
|
||||
.RE
|
||||
.TP
|
||||
\fBreport\fR
|
||||
Generate a report directly instead of writing the log data to a file.
|
||||
If this option is used together with the \fBoutput\fR option, the
|
||||
report will be written to the specified file instead of the log data.
|
||||
.TP
|
||||
\fBzip\fR
|
||||
Compress the output file with \fBgzip\fR(1).
|
||||
.TP
|
||||
\fBport\fR=\fIport\fR
|
||||
Use \fIport\fR to listen for command server connections. See the
|
||||
\fBCommand server\fR sub-section.
|
||||
.TP
|
||||
\fBnodefaults\fR
|
||||
Disables pre Mono 5.6 compatibility. In particular, this disables
|
||||
exception events and performance counter sampling by default. It also
|
||||
makes it so that GC move events won't be enabled by default when
|
||||
heapshots are enabled. To use this option, it must be the first
|
||||
option given to the log profiler.
|
||||
.IP
|
||||
This option will be the default in a future version of the log
|
||||
profiler.
|
||||
.TP
|
||||
[\fBno\fR]\fIevent\fR
|
||||
Enable or disable gathering data for \fIevent\fR, which can be one
|
||||
of:
|
||||
.RS
|
||||
.TP
|
||||
\fBexception\fR
|
||||
Exception throw and clause (\fBcatch\fR, \fBfinally\fR, etc)
|
||||
evaluation events. Enabled by default unless \fBnodefaults\fR is
|
||||
used.
|
||||
.TP
|
||||
\fBmonitor\fR
|
||||
Monitor lock contention, acquisition, and release events.
|
||||
.TP
|
||||
\fBgc\fR
|
||||
GC start, progress, stop, and resize events.
|
||||
.TP
|
||||
\fBgcalloc\fR
|
||||
GC allocation events.
|
||||
.TP
|
||||
\fBgcmove\fR
|
||||
GC move events.
|
||||
.TP
|
||||
\fBgcroot\fR
|
||||
GC root report events. Generated on every collection if enabled,
|
||||
unless \fBnodefaults\fR is used, in which case, they're only
|
||||
generated on heapshots.
|
||||
.TP
|
||||
\fBgchandle\fR
|
||||
GC handle creation and deletion events.
|
||||
.TP
|
||||
\fBfinalization\fR
|
||||
Object finalization events.
|
||||
.TP
|
||||
\fBcounter\fR
|
||||
Performance counter sample events. Enabled by default unless
|
||||
\fBnodefaults\fR is used.
|
||||
.TP
|
||||
\fBjit\fR
|
||||
JIT code buffer events.
|
||||
.TP
|
||||
\fBalloc\fR
|
||||
Alias for \fBgc\fR, \fBgcalloc\fR, and \fBgcmove\fR.
|
||||
.TP
|
||||
\fBlegacy\fR
|
||||
Alias for \fBexception\fR, \fBmonitor\fR, \fBgc\fR, \fBgcmove\fR,
|
||||
\fBgcroot\fR, \fBgchandle\fR, \fBfinalization\fR, and \fBcounter\fR.
|
||||
.RE
|
||||
.TP
|
||||
\fBsample\fR[\fB\-real\fR][=\fIfreq\fR]
|
||||
Enable statistical sampling. The default is to sample at a frequency
|
||||
of 100 Hz, but \fIfreq\fR can be used to override this.
|
||||
.IP
|
||||
By default, sampling uses process time (i.e., the more work a process
|
||||
does, the more samples are collected). The \fB-real\fR variant uses
|
||||
wall clock time instead. Wall clock time is better for programs that
|
||||
are I/O-bound.
|
||||
.TP
|
||||
\fBmaxsamples\fR=\fInum\fR
|
||||
Limit the number of reusable sample events to \fInum\fR allocations.
|
||||
A value of zero means no limit. By default, the value of this setting
|
||||
is based on the number of CPU cores. Some tinkering with this setting
|
||||
may be necessary for programs with an unusually high amount of
|
||||
threads.
|
||||
.TP
|
||||
\fBcalls\fR
|
||||
Enable method entry and exit instrumentation. This is an alternative
|
||||
to statistical sampling when you need more precise information. Note
|
||||
that this mode is extremely heavy and can slow most programs to a
|
||||
crawl.
|
||||
.TP
|
||||
\fBcallspec\fR=\fIspec\fR
|
||||
Limit method entry and exit instrumentation to methods matching the
|
||||
specified call spec. This uses the same syntax as the \fB--trace\fR
|
||||
option for \fBmono\fR(1), so refer to that page for more information.
|
||||
.TP
|
||||
\fBcalldepth\fR=\fInum\fR
|
||||
Limit method entry and exit event collection to a call depth of
|
||||
\fInum\fR.
|
||||
.TP
|
||||
\fBmaxframes\fR=\fInum\fR
|
||||
Limit backtraces in various events (including statistical samples) to
|
||||
\fInum\fR frames.
|
||||
.TP
|
||||
\fBheapshot\fR[=\fImode\fR]
|
||||
Enable heap snapshots. \fImode\fR, if given, can be one of:
|
||||
.RS
|
||||
.TP
|
||||
\fBondemand\fR
|
||||
Only perform a heapshot when receiving a command via the command
|
||||
server or when triggered through the managed library.
|
||||
.TP
|
||||
\fInum\fR\fBgc\fR
|
||||
Perform a heapshot on every \fInum\fR collections of the major
|
||||
generation.
|
||||
.TP
|
||||
\fInum\fR\fBms\fR
|
||||
Perform a heapshot on a major generation collection if \fInum\fR
|
||||
milliseconds have passed since the last heapshot.
|
||||
.RE
|
||||
.IP
|
||||
If \fImode\fR is not given, a heapshot will be performed on every
|
||||
collection of the major generation.
|
||||
.TP
|
||||
\fBheapshot-on-shutdown\fR
|
||||
In addition to any other heapshot settings, also perform a heapshot
|
||||
on runtime shutdown.
|
||||
.TP
|
||||
\fBdebug\fR
|
||||
Print detailed debugging information. Most users should not use this
|
||||
option.
|
||||
.SS Command server
|
||||
The log profiler features a simple command server that currently is
|
||||
only used to trigger manual heapshots (typcally when using the
|
||||
on-demand mode, but also usable with the other modes). A random port
|
||||
will be used to listen for connections unless the \fBport\fR option
|
||||
is used. To trigger a heapshot, open a TCP connection to the command
|
||||
server and send the C string \fB"heapshot\\n"\fR.
|
||||
.PP
|
||||
The command server supports multiple simultaneous connections.
|
||||
.SS Managed library
|
||||
The log profiler comes with a managed library called
|
||||
\fBMono.Profiler.Log\fR. This library allows easily reading log files
|
||||
in managed code (e.g., C#) as well as interacting with the profiler
|
||||
at run-time.
|
||||
.PP
|
||||
With the ability to easily read log files, users can write all sorts
|
||||
of interesting analyses that might not be provided by the standard
|
||||
tools (e.g., \fBmprof\-report\fR(1)).
|
||||
.PP
|
||||
The \fBLogProfiler\fR class allows users to reconfigure profiler
|
||||
settings at run-time. For example, certain event types can be toggled
|
||||
on or off, the mode and frequency of heapshots and sampling can be
|
||||
changed, etc. Heapshots can also be triggered manually.
|
||||
.PP
|
||||
To use this library, simply pass \fB\-r:Mono.Profiler.Log\fR when
|
||||
compiling your code.
|
||||
.SS Example
|
||||
Collect GC allocation and sampling data for a program, then generate
|
||||
a report:
|
||||
.PP
|
||||
.nf
|
||||
.RS
|
||||
mono \-\-profile=log:alloc,sample program.exe
|
||||
mprof\-report output.mlpd
|
||||
.RE
|
||||
.fi
|
||||
.PP
|
||||
Perform a heapshot on every 5th collection and generate a report
|
||||
directly:
|
||||
.PP
|
||||
.nf
|
||||
.RS
|
||||
mono \-\-profile=log:heapshot=5gc,report program.exe
|
||||
.RE
|
||||
.fi
|
||||
.PP
|
||||
.SH COVERAGE PROFILER
|
||||
The code coverage profiler collects information about how often code
|
||||
paths are executed. This is done by instrumenting JIT-compiled code
|
||||
at all sequence points. On program exit, the coverage profiler
|
||||
collects all execution count information and outputs it to an XML
|
||||
file. The main use case for the coverage profiler is unit testing: By
|
||||
running unit test suites with the coverage profiler, it is possible
|
||||
to determine whether the unit tests actually cover all the code that
|
||||
they should.
|
||||
.PP
|
||||
By default, the coverage profiler writes its output to
|
||||
\fIcoverage.xml\fR. Refer to the \fImono/profiler/coverage.c\fR file
|
||||
in the Mono source tree for documentation on the schema.
|
||||
.PP
|
||||
Please note that the coverage profiler currently does not support
|
||||
instrumenting AOT-compiled code. When collecting coverage data, one
|
||||
may wish to run Mono with the \fB-O=-aot\fR option to disable loading
|
||||
AOT-compiled code.
|
||||
.SS Options
|
||||
The coverage profiler supports the following options:
|
||||
.TP
|
||||
\fBhelp\fR
|
||||
Print usage instructions.
|
||||
.TP
|
||||
\fBoutput\fR=[\fI+\fR|\fI#\fR|\fI|\fR]\fIfile\fR
|
||||
Write coverage data to \fIfile\fR. The optional modifiers are:
|
||||
.RS
|
||||
.ne 8
|
||||
.TP
|
||||
\fB+\fR
|
||||
The program PID is appended to the file name. For example,
|
||||
\fBoutput=+cov.xml\fR outputs to \fIcov.xml.1234\fR if the PID is
|
||||
\fB1234\fR.
|
||||
.TP
|
||||
\fB#\fR
|
||||
\fIfile\fR is parsed as a file descriptor number, which is opened
|
||||
with \fBfdopen\fR(3). This is mainly useful in embedding scenarios.
|
||||
.TP
|
||||
\fB|\fR
|
||||
\fIfile\fR is treated as a program name. It will be started with
|
||||
\fBpopen\fR(3) and the coverage data will be piped to its standard
|
||||
input.
|
||||
.RE
|
||||
.TP
|
||||
\fBcovfilter-file\fR=\fIfile\fR
|
||||
Supply a coverage filter file. This option can be given multiple
|
||||
times. See the \fBFilter files\fR sub-section.
|
||||
.SS Filter files
|
||||
Filter files can be used to pick and choose which types should be
|
||||
considered for coverage instrumentation. A filter file consists of a
|
||||
series of lines of the form:
|
||||
.PP
|
||||
.nf
|
||||
.RS
|
||||
\fB+\fR|\fB\-\fR\fB[\fR\fIimage_name\fR\fB]\fR\fItype_name_prefix\fR
|
||||
.RE
|
||||
.fi
|
||||
.PP
|
||||
Here, \fIimage_name\fR is something like \fBmscorlib\fR.
|
||||
\fItype_name_prefix\fR can be something like \fBSystem.Int32\fR for
|
||||
a specific type or \fBSystem.App\fR to pick all types starting with
|
||||
\fBApp\fR in the \fBSystem\fR namespace.
|
||||
.PP
|
||||
Lines starting with \fB+\fR indicate that a type should be
|
||||
instrumented for coverage, whereas lines starting with \fB\-\fR
|
||||
indicate the opposite. Lines starting with \fB+\fR always override
|
||||
lines starting with \fB\-\fR regardless of the order they appear in.
|
||||
.PP
|
||||
Lines not starting with either character are ignored. This can be
|
||||
used to write comments. For example, this is a valid file:
|
||||
.PP
|
||||
.nf
|
||||
.RS
|
||||
# Ignore coverage in network-related code, except HTTP client code.
|
||||
-[MyProgram]MyProgram.Net
|
||||
+[MyProgram]MyProgram.Net.Http.HttpClient
|
||||
.RE
|
||||
.fi
|
||||
.SS Example
|
||||
Coverage data for a program can be collected like this:
|
||||
.PP
|
||||
.nf
|
||||
.RS
|
||||
mono \-O=\-aot \-\-profile=coverage:output=cov.xml program.exe
|
||||
.RE
|
||||
.fi
|
||||
.PP
|
||||
\fIcov.xml\fR will now contain the coverage data.
|
||||
.SH AOT PROFILER
|
||||
The AOT profiler will record which generic instantiations a program
|
||||
makes use of and save the information to a specified file. This data
|
||||
can then be used by the AOT compiler to compile those generic
|
||||
instantiations ahead of time to reduce program startup time.
|
||||
.PP
|
||||
By default, the AOT profiler writes its output to
|
||||
\fIoutput.aotprofile\fR. Refer to the \fImono/profiler/aot.h\fR file
|
||||
in the Mono source tree for documentation on the AOT profiler's file
|
||||
format.
|
||||
.SS Options
|
||||
The AOT profiler supports the following options:
|
||||
.TP
|
||||
\fBhelp\fR
|
||||
Print usage instructions.
|
||||
.TP
|
||||
\fBoutput\fR=[\fI+\fR|\fI#\fR|\fI|\fR]\fIfile\fR
|
||||
Write output data to \fIfile\fR. The optional modifiers are:
|
||||
.RS
|
||||
.ne 8
|
||||
.TP
|
||||
\fB+\fR
|
||||
The program PID is appended to the file name. For example,
|
||||
\fBoutput=+out.aotprofile\fR outputs to \fIout.aotprofile.1234\fR if
|
||||
the PID is \fB1234\fR.
|
||||
.TP
|
||||
\fB#\fR
|
||||
\fIfile\fR is parsed as a file descriptor number, which is opened
|
||||
with \fBfdopen\fR(3). This is mainly useful in embedding scenarios.
|
||||
.TP
|
||||
\fB|\fR
|
||||
\fIfile\fR is treated as a program name. It will be started with
|
||||
\fBpopen\fR(3) and the log data will be piped to its standard input.
|
||||
.RE
|
||||
.TP
|
||||
\fBverbose\fR
|
||||
Print detailed debugging information. Most users should not use this
|
||||
option.
|
||||
.SS Example
|
||||
A profile can be collected and used like this:
|
||||
.PP
|
||||
.nf
|
||||
.RS
|
||||
mono \-\-profile=aot:output=program.aotprofile program.exe
|
||||
mono \-\-aot=profile=program.aotprofile program.exe
|
||||
mono program.exe
|
||||
.RE
|
||||
.fi
|
||||
.PP
|
||||
.SH SEE ALSO
|
||||
\fBmono\fR(1), \fBmprof\-report\fR(1)
|
||||
@@ -26,6 +26,11 @@ and execution can be resumed by sending the SIGUSR2 signal. The
|
||||
service can be cleanly shutdown by sending the SIGTERM signal to the
|
||||
process.
|
||||
.PP
|
||||
Mono programs started with mono-service run with the
|
||||
.B MONO_DISABLE_SHM
|
||||
variable set. This means that certain Mono features that depend on
|
||||
it are not available to services.
|
||||
.PP
|
||||
The following options can be used to control the service:
|
||||
.TP
|
||||
.I "-d:DIRECTORY"
|
||||
|
||||
+185
-232
@@ -65,45 +65,6 @@ and
|
||||
See the description for
|
||||
.B MONO_IOMAP
|
||||
in the environment variables section for more details.
|
||||
.SH METHOD DESCRIPTIONS
|
||||
A number of diagnostic command line options take as argument a method
|
||||
description. A method description is a textual representation that
|
||||
can be used to uniquely identify a method. The syntax is as follows:
|
||||
.nf
|
||||
[namespace]classname:methodname[(arguments)]
|
||||
.fi
|
||||
.PP
|
||||
The values in brackets are optional, like the namespace and the
|
||||
arguments. The arguments themselves are either empty, or a
|
||||
comma-separated list of arguments. Both the
|
||||
\fBclassname\fR
|
||||
and
|
||||
\fBmethodname\fR
|
||||
can be set to the special value '*' to match any values (Unix shell
|
||||
users should escape the argument to avoid the shell interpreting
|
||||
this).
|
||||
.PP
|
||||
The arguments, if present should be a comma separated list of types
|
||||
either a full typename, or for built-in types it should use the
|
||||
low-level ILAsm type names for the built-in types,
|
||||
like 'void', 'char', 'bool', 'byte', 'sbyte', 'uint16', 'int16', 'uint',
|
||||
'int', 'ulong', 'long', 'uintptr', 'intptr', 'single', 'double', 'string', 'object'.
|
||||
.PP
|
||||
Pointer types should be the name of the type, followed by a '*',
|
||||
arrays should be the typename followed by '[' one or more commas (to
|
||||
indicate the rank of the array), and ']'.
|
||||
.PP
|
||||
Generic values should use '<', one or more type names, separated by
|
||||
both a comma and a space and '>'.
|
||||
.PP
|
||||
By-reference arguments should include a "&" after the typename.
|
||||
.PP
|
||||
Examples:
|
||||
.nf
|
||||
*:ctor(int) // All constructors that take an int as an argument
|
||||
*:Main // Methods named Main in any class
|
||||
*:Main(string[]) // Methods named Main that take a string array in any class
|
||||
.fi
|
||||
.SH RUNTIME OPTIONS
|
||||
The following options are available:
|
||||
.TP
|
||||
@@ -214,33 +175,8 @@ and
|
||||
.I llvm
|
||||
options. This feature is experimental.
|
||||
.TP
|
||||
.I llvmopts=[options]
|
||||
Use this option to override the built-in set of flags passed to the
|
||||
LLVM optimizer. The list of possible flags that can be passed can be
|
||||
obtained by calling the bundled
|
||||
.I opt
|
||||
program that comes with Mono.
|
||||
.TP
|
||||
.I llvmllc=[options]
|
||||
Use this option to override the built-in set of flags passed to the
|
||||
LLVM static compiler (llc). The list of possible flags that can be passed can be
|
||||
obtained by calling the bundled
|
||||
.I llc
|
||||
program that comes with Mono.
|
||||
.TP
|
||||
.I llvm-outfile=[filename]
|
||||
Gives the path for the temporary LLVM bitcode file created during AOT.
|
||||
.I dedup
|
||||
Each AOT module will typically contain the code for inflated methods and wrappers that
|
||||
are called by code in that module. In dedup mode, we identify and skip compiling all of those
|
||||
methods. When using this mode with fullaot, dedup-include is required or these methods will
|
||||
remain missing.
|
||||
.TP
|
||||
.I dedup-include=[filename]
|
||||
In dedup-include mode, we are in the pass of compilation where we compile the methods
|
||||
that we had previously skipped. All of them are emitted into the assembly that is passed
|
||||
as this option. We consolidate the many duplicate skipped copies of the same method into one.
|
||||
.TP
|
||||
.TP
|
||||
.I info
|
||||
Print the architecture the AOT in this copy of Mono targets and quit.
|
||||
@@ -315,14 +251,14 @@ If the AOT compiler cannot compile a method for any reason, enabling this flag
|
||||
will output the skipped methods to the console.
|
||||
.TP
|
||||
.I profile=[file]
|
||||
Specify a file to use for profile-guided optimization. See the \fBAOT profiler\fR sub-section. To specify multiple files, include the
|
||||
Specify a file to use for profile-guided optimization. See the "AOT PROFILING" section. To specify multiple files, include the
|
||||
.I profile
|
||||
option multiple times.
|
||||
.TP
|
||||
.I profile-only
|
||||
AOT *only* the methods described in the files specified with the
|
||||
.I profile
|
||||
option. See the \fBAOT profiler\fR sub-section.
|
||||
option. See the "AOT PROFILING" section.
|
||||
.TP
|
||||
.I readonly-value=namespace.typename.fieldname=type/value
|
||||
Override the value of a static readonly field. Usually, during JIT
|
||||
@@ -381,9 +317,6 @@ Prints additional information about type loading failures.
|
||||
.TP
|
||||
.I write-symbols,no-write-symbols
|
||||
Instructs the AOT compiler to emit (or not emit) debug symbol information.
|
||||
.TP
|
||||
.I no-opt
|
||||
Instructs the AOT compiler tot no call opt when compiling with LLVM.
|
||||
.PP
|
||||
For more information about AOT, see: http://www.mono-project.com/docs/advanced/aot/
|
||||
.RE
|
||||
@@ -488,9 +421,6 @@ in your program, or Mono's class libraries attempts to generate code
|
||||
dynamically. You should test your software upfront and make sure that
|
||||
you do not use any dynamic features.
|
||||
.TP
|
||||
\fB--full-aot-interp\fR
|
||||
Same as --full-aot with fallback to the interpreter.
|
||||
.TP
|
||||
\fB--gc=boehm\fR, \fB--gc=sgen\fR
|
||||
Selects the Garbage Collector engine for Mono to use, Boehm or SGen.
|
||||
Currently this merely ensures that you are running either the
|
||||
@@ -514,11 +444,6 @@ will switch to '/bin/mono64' iff '/bin/mono' is a 32-bit build).
|
||||
\fB--help\fR, \fB-h\fR
|
||||
Displays usage instructions.
|
||||
.TP
|
||||
\fB--interpreter\fR
|
||||
The Mono runtime will use its interpreter to execute a given assembly.
|
||||
The interpreter is usually slower than the JIT, but it can be useful on
|
||||
platforms where code generation at runtime is not allowed.
|
||||
.TP
|
||||
\fB--hybrid-aot\fR
|
||||
This flag allows the Mono runtime to run assemblies
|
||||
that have been stripped of IL, for example using mono-cil-strip. For this to
|
||||
@@ -601,11 +526,6 @@ Controls whether the runtime should attempt to inline (the default),
|
||||
or not inline methods invocations
|
||||
.ne
|
||||
.RE
|
||||
\fB--response=FILE\fR
|
||||
Provides a response file, this instructs the Mono command to read
|
||||
other command line options from the specified file, as if the
|
||||
options had been specified on the command line. Useful when you have
|
||||
very long command lines.
|
||||
.TP
|
||||
\fB--runtime=VERSION\fR
|
||||
Mono supports different runtime versions. The version used depends on the program
|
||||
@@ -705,12 +625,14 @@ platforms, and only when using gdb 7.0 or later.
|
||||
.ne
|
||||
.RE
|
||||
.TP
|
||||
\fB\-\-profile\fR[=\fIprofiler\fR[:\fIprofiler_args\fR]]\fR
|
||||
Loads a profiler module with the given arguments. For more information,
|
||||
see the \fBPROFILING\fR section.
|
||||
\fB--profile[=profiler[:profiler_args]]\fR
|
||||
Turns on profiling. For more information about profiling applications
|
||||
and code coverage see the sections "PROFILING" and "CODE COVERAGE"
|
||||
below.
|
||||
.Sp
|
||||
This option can be used multiple times; each time will load an additional
|
||||
profiler module.
|
||||
This option can be used multiple times, each time will load an
|
||||
additional profiler. This allows developers to use modules that
|
||||
extend the JIT through the Mono profiling interface.
|
||||
.TP
|
||||
\fB--trace[=expression]\fR
|
||||
Shows method names as they are invoked. By default all methods are
|
||||
@@ -889,81 +811,128 @@ create its own threads and return after invocation.
|
||||
This support allows for example debugging applications by having the
|
||||
csharp shell attach to running processes.
|
||||
.SH PROFILING
|
||||
The Mono runtime includes a profiler API that dynamically loaded
|
||||
profiler modules and embedders can use to collect performance-related
|
||||
data about an application. Profiler modules are loaded by passing the
|
||||
\fB\-\-profile\fR command line argument to the Mono runtime.
|
||||
The mono runtime includes a profiler that can be used to explore
|
||||
various performance related problems in your application. The
|
||||
profiler is activated by passing the --profile command line argument
|
||||
to the Mono runtime, the format is:
|
||||
.nf
|
||||
|
||||
--profile[=profiler[:profiler_args]]
|
||||
|
||||
.fi
|
||||
Mono has a built-in profiler called 'default' (and is also the default
|
||||
if no arguments are specified), but developers can write custom
|
||||
profilers, see the section "CUSTOM PROFILERS" for more details.
|
||||
.PP
|
||||
Mono ships with a few profiler modules, of which the \fBlog\fR profiler
|
||||
is the most feature-rich. It is also the default profiler if the
|
||||
\fIprofiler\fR argument is not given, or if \fBdefault\fR is given.
|
||||
It is possible to write your own profiler modules; see the
|
||||
\fBCustom profilers\fR sub-section.
|
||||
.SS Log profiler
|
||||
The log profiler can be used to collect a lot of information about
|
||||
a program running in the Mono runtime. This data can be used (both
|
||||
while the process is running and later) to do analyses of the
|
||||
program behavior, determine resource usage, performance issues or
|
||||
even look for particular execution patterns.
|
||||
If a
|
||||
.I profiler
|
||||
is not specified, the default profiler is used.
|
||||
.Sp
|
||||
The
|
||||
.I profiler_args
|
||||
is a profiler-specific string of options for the profiler itself.
|
||||
.Sp
|
||||
The default profiler accepts the following options 'alloc' to profile
|
||||
memory consumption by the application; 'time' to profile the time
|
||||
spent on each routine; 'jit' to collect time spent JIT-compiling methods
|
||||
and 'stat' to perform sample statistical profiling.
|
||||
If no options are provided the default is 'alloc,time,jit'.
|
||||
.PP
|
||||
By default the
|
||||
profile data is printed to stdout: to change this, use the 'file=filename'
|
||||
option to output the data to filename.
|
||||
.Sp
|
||||
For example:
|
||||
.nf
|
||||
|
||||
mono --profile program.exe
|
||||
|
||||
.fi
|
||||
.Sp
|
||||
That will run the program with the default profiler and will do time
|
||||
and allocation profiling.
|
||||
.Sp
|
||||
.nf
|
||||
|
||||
mono --profile=default:stat,alloc,file=prof.out program.exe
|
||||
|
||||
.fi
|
||||
Will do sample statistical profiling and allocation profiling on
|
||||
program.exe. The profile data is put in prof.out.
|
||||
.Sp
|
||||
Note that the statistical profiler has a very low overhead and should
|
||||
be the preferred profiler to use (for better output use the full path
|
||||
to the mono binary when running and make sure you have installed the
|
||||
addr2line utility that comes from the binutils package).
|
||||
.SH LOG PROFILER
|
||||
This is the most advanced profiler.
|
||||
.PP
|
||||
The Mono \f[I]log\f[] profiler can be used to collect a lot of
|
||||
information about a program running in the Mono runtime.
|
||||
This data can be used (both while the process is running and later)
|
||||
to do analyses of the program behaviour, determine resource usage,
|
||||
performance issues or even look for particular execution patterns.
|
||||
.PP
|
||||
This is accomplished by logging the events provided by the Mono
|
||||
runtime through the profiler API and periodically writing them to a
|
||||
file which can later be inspected with the \fBmprof\-report\fR(1)
|
||||
tool.
|
||||
runtime through the profiling interface and periodically writing
|
||||
them to a file which can be later inspected with the mprof-report(1)
|
||||
tool.
|
||||
.PP
|
||||
More information about how to use the log profiler is available on
|
||||
the \fBmono\-profilers\fR(1) page, under the \fBLOG PROFILER\fR
|
||||
section, as well as the \fBmprof\-report\fR(1) page.
|
||||
.SS Coverage profiler
|
||||
The code coverage profiler can instrument a program to help determine
|
||||
which classes, methods, code paths, etc are actually executed. This
|
||||
is most useful when running a test suite to determine whether the
|
||||
tests actually cover the code they're expected to.
|
||||
.PP
|
||||
More information about how to use the coverage profiler is available
|
||||
on the \fBmono\-profilers\fR(1) page, under the \fBCOVERAGE
|
||||
PROFILER\fR section.
|
||||
.SS AOT profiler
|
||||
The AOT profiler can help improve startup performance by logging
|
||||
which generic instantiations are used by a program, which the AOT
|
||||
compiler can then use to compile those instantiations ahead of time
|
||||
so that they won't have to be JIT compiled at startup.
|
||||
.PP
|
||||
More information about how to use the AOT profiler is available on
|
||||
the \fBmono\-profilers\fR(1) page, under the \fBAOT PROFILER\fR
|
||||
section.
|
||||
.SS Custom profilers
|
||||
Custom profiler modules can be loaded in exactly the same way as the
|
||||
standard modules that ship with Mono. They can also access the same
|
||||
profiler API to gather all kinds of information about the code being
|
||||
executed.
|
||||
.PP
|
||||
For example, to use a third-party profiler called \fBcustom\fR, you
|
||||
would load it like this:
|
||||
More information about how to use the log profiler is available on the
|
||||
mprof-report(1) page.
|
||||
.SH CUSTOM PROFILERS
|
||||
Mono provides a mechanism for loading other profiling modules which in
|
||||
the form of shared libraries. These profiling modules can hook up to
|
||||
various parts of the Mono runtime to gather information about the code
|
||||
being executed.
|
||||
.PP
|
||||
To use a third party profiler you must pass the name of the profiler
|
||||
to Mono, like this:
|
||||
.nf
|
||||
.RS
|
||||
mono --profile=custom program.exe
|
||||
.RE
|
||||
|
||||
mono --profile=custom program.exe
|
||||
|
||||
.fi
|
||||
.PP
|
||||
You could also pass arguments to it:
|
||||
In the above sample Mono will load the user defined profiler from the
|
||||
shared library `mono-profiler-custom.so'. This profiler module must
|
||||
be on your dynamic linker library path.
|
||||
.PP
|
||||
A list of other third party profilers is available from Mono's web
|
||||
site (www.mono-project.com/docs/advanced/performance-tips/)
|
||||
.PP
|
||||
Custom profiles are written as shared libraries. The shared library
|
||||
must be called `mono-profiler-NAME.so' where `NAME' is the name of
|
||||
your profiler.
|
||||
.PP
|
||||
For a sample of how to write your own custom profiler look in the
|
||||
Mono source tree for in the samples/profiler.c.
|
||||
.SH CODE COVERAGE
|
||||
Mono ships with a code coverage module in the \f[I]coverage\f[] profiler.
|
||||
To enable it, pass \fB--profile=coverage\fR to your mono invocation. It
|
||||
will by default output a coverage.xml in the current directory. Use
|
||||
\fBmono --profile=coverage:help sample.exe\fR for more information on the
|
||||
different options.
|
||||
.SH AOT PROFILING
|
||||
You can improve startup performance by using the AOT profiler.
|
||||
.PP
|
||||
Typically the AOT compiler (\fBmono --aot\fR) will not generate code
|
||||
for generic instantiations. To solve this, you can run Mono with the
|
||||
AOT profiler to find out all the generic instantiations that are used,
|
||||
and then instructing the AOT compiler to produce code for these.
|
||||
.PP
|
||||
This command will run the specified app.exe and produce the
|
||||
\fBout.aotprof\fR file with the data describing the generic
|
||||
instantiations that are needed:
|
||||
.nf
|
||||
.RS
|
||||
mono --profile=custom:arg1,arg2=arg3 program.exe
|
||||
.RE
|
||||
$ mono --profile=aot:output=out.aotprof app.exe
|
||||
.fi
|
||||
.PP
|
||||
In the above example, Mono will load the profiler from the shared
|
||||
library called \fIlibmono\-profiler\-custom.so\fR (name varies based
|
||||
on platform, e.g., \fIlibmono\-profiler\-custom.dylib\fR on OS X).
|
||||
This profiler module must be on your dynamic linker library path
|
||||
(\fBLD_LIBRARY_PATH\fR on most systems, \fBDYLD_LIBRARY_PATH\fR on
|
||||
OS X).
|
||||
.PP
|
||||
For a sample of how to write your own custom profiler, look at the
|
||||
\fIsamples/profiler/sample.c\fR file in the Mono source tree.
|
||||
Once you have this data, you can pass this to Mono's AOT compiler to
|
||||
instruct it to generate code for it:
|
||||
.nf
|
||||
$ mono --aot=profile=out.aotprof
|
||||
.fi
|
||||
.SH DEBUGGING AIDS
|
||||
To debug managed applications, you can use the
|
||||
.B mdb
|
||||
@@ -1014,10 +983,8 @@ If set, the log mask is changed to the set value. Possible values are
|
||||
"asm" (assembly loader), "type", "dll" (native library loader), "gc"
|
||||
(garbage collector), "cfg" (config file loader), "aot" (precompiler),
|
||||
"security" (e.g. Moonlight CoreCLR support), "threadpool" (thread pool generic),
|
||||
"io-selector" (async socket operations), "io-layer" (I/O layer - processes, files,
|
||||
sockets, events, semaphores, mutexes and handles), "io-layer-process",
|
||||
"io-layer-file", "io-layer-socket", "io-layer-event", "io-layer-semaphore",
|
||||
"io-layer-mutex", "io-layer-handle" and "all".
|
||||
"io-threadpool" (thread pool I/O), "io-layer" (I/O layer - sockets, handles, shared memory etc)
|
||||
and "all".
|
||||
The default value is "all". Changing the mask value allows you to display only
|
||||
messages for a certain component. You can use multiple masks by comma
|
||||
separating them. For example to see config file messages and assembly loader
|
||||
@@ -1151,13 +1118,15 @@ When Mono is built with a soft float fallback on ARM and this variable is set to
|
||||
"1", Mono will always emit soft float code, even if a VFP unit is
|
||||
detected.
|
||||
.TP
|
||||
\fBMONO_DARWIN_USE_KQUEUE_FSW\fR
|
||||
Fall back on the kqueue FileSystemWatcher implementation in Darwin. The default is the FSEvent implementation.
|
||||
.TP
|
||||
\fBMONO_DARWIN_WATCHER_MAXFDS\fR
|
||||
This is a debugging aid used to force limits on the kqueue FileSystemWatcher
|
||||
This is a debugging aid used to force limits on the FileSystemWatcher
|
||||
implementation in Darwin. There is no limit by default.
|
||||
.TP
|
||||
\fBMONO_DISABLE_AIO\fR
|
||||
If set, tells mono NOT to attempt using native asynchronous I/O services. In
|
||||
that case, a default select/poll implementation is used. Currently only epoll()
|
||||
is supported.
|
||||
.TP
|
||||
\fBMONO_DISABLE_MANAGED_COLLATION\fR
|
||||
If this environment variable is `yes', the runtime uses unmanaged
|
||||
collation (which actually means no culture-sensitive collation). It
|
||||
@@ -1165,6 +1134,18 @@ internally disables managed collation functionality invoked via the
|
||||
members of System.Globalization.CompareInfo class. Collation is
|
||||
enabled by default.
|
||||
.TP
|
||||
\fBMONO_DISABLE_SHM\fR
|
||||
Unix only: If set, disables the shared memory files used for
|
||||
cross-process handles: process have only private handles. This means
|
||||
that process and thread handles are not available to other processes,
|
||||
and named mutexes, named events and named semaphores are not visible
|
||||
between processes.
|
||||
.Sp
|
||||
This is can also be enabled by default by passing the
|
||||
"--disable-shared-handles" option to configure.
|
||||
.Sp
|
||||
This is the default from mono 2.8 onwards.
|
||||
.TP
|
||||
\fBMONO_DISABLE_SHARED_AREA\fR
|
||||
Unix only: If set, disable usage of shared memory for exposing
|
||||
performance counters. This means it will not be possible to both
|
||||
@@ -1183,38 +1164,19 @@ For platforms that do not otherwise have a way of obtaining random bytes
|
||||
this can be set to the name of a file system socket on which an egd or
|
||||
prngd daemon is listening.
|
||||
.TP
|
||||
\fBMONO_ENABLE_AIO\fR
|
||||
If set, tells mono to attempt using native asynchronous I/O services. If not
|
||||
set, a default select/poll implementation is used. Currently epoll and kqueue
|
||||
are supported.
|
||||
.TP
|
||||
\fBMONO_THREADS_SUSPEND\fR
|
||||
Selects a mechanism that Mono will use to suspend threads. May be set to
|
||||
"preemptive", "coop", or "hybrid". Threads may need to be suspended by the
|
||||
debugger, or using some .NET threading APIs, and most commonly when the SGen
|
||||
garbage collector needs to stop all threads during a critical phase of garbage
|
||||
collection. Preemptive mode is the mode that Mono has used historically, going
|
||||
back to the Boehm days, where the garbage collector would run at any point and
|
||||
suspend execution of all threads as required to perform a garbage collection.
|
||||
The cooperative mode on the other hand requires the cooperation of all threads
|
||||
to stop at a safe point. This makes for an easier to debug garbage collector.
|
||||
As of Mono 4.3.0 it is a work in progress, and while it works, it has not been
|
||||
used extensively. This option enables the feature and allows us to find spots
|
||||
that need to be tuned for this mode of operation. Hybrid mode is a combination
|
||||
of the two that retains better compatability with scenarios where Mono is
|
||||
embedded in another application: threads that are running managed code or code
|
||||
that comprises the Mono runtime will be cooperatively suspended, while threads
|
||||
running embedder code will be preemptively suspended.
|
||||
|
||||
Alternatively, coop and hybrid mode can be enabled at compile time by using the
|
||||
--enable-cooperative-suspend or --enable-hybrid-suspend flags, respectively,
|
||||
when calling configure. The \fBMONO_THREADS_SUSPEND\fR environment variable
|
||||
takes priority over the compiled default.
|
||||
.TP
|
||||
\fBMONO_ENABLE_COOP_SUSPEND\fR
|
||||
This environment variable is obsolete, but retained for backward compatibility.
|
||||
Use \fBMONO_THREADS_SUSPEND\fR set to "coop" instead. Note that if configure flags
|
||||
were provided to enable cooperative or hybrid suspend, this variable is ignored.
|
||||
\fBMONO_ENABLE_COOP\fR
|
||||
This makes the Mono runtime and the SGen garbage collector run in cooperative
|
||||
mode as opposed to run on preemptive mode. Preemptive mode is the mode
|
||||
that Mono has used historically, going back to the Boehm days, where the
|
||||
garbage collector would run at any point and suspend execution of all
|
||||
threads as required to perform a garbage collection. The cooperative mode
|
||||
on the other hand requires the cooperation of all threads to stop at a
|
||||
safe point. This makes for an easier to debug garbage collector. As
|
||||
of Mono 4.3.0 it is a work in progress, and while it works, it has not
|
||||
been used extensively. This option enabled the feature and allows us to
|
||||
find spots that need to be tuned for this mode of operation. Alternatively,
|
||||
this mode can be enabled at compile time by using the --with-cooperative-gc
|
||||
flag when calling configure.
|
||||
.TP
|
||||
\fBMONO_ENV_OPTIONS\fR
|
||||
This environment variable allows you to pass command line arguments to
|
||||
@@ -1567,6 +1529,29 @@ directive instead, like this:
|
||||
|
||||
.fi
|
||||
See mod_mono(8) for more details.
|
||||
|
||||
Additionally. Mono includes a profiler module which allows one to track what
|
||||
adjustements to file paths IOMAP code needs to do. The tracking code reports
|
||||
the managed location (full stack trace) from which the IOMAP-ed call was made and,
|
||||
on process exit, the locations where all the IOMAP-ed strings were created in
|
||||
managed code. The latter report is only approximate as it is not always possible
|
||||
to estimate the actual location where the string was created. The code uses simple
|
||||
heuristics - it analyzes stack trace leading back to the string allocation location
|
||||
and ignores all the managed code which lives in assemblies installed in GAC as well as in the
|
||||
class libraries shipped with Mono (since they are assumed to be free of case-sensitivity
|
||||
issues). It then reports the first location in the user's code - in most cases this will be
|
||||
the place where the string is allocated or very close to the location. The reporting code
|
||||
is implemented as a custom profiler module (see the "PROFILING" section) and can be loaded
|
||||
in the following way:
|
||||
.fi
|
||||
.Sp
|
||||
.nf
|
||||
|
||||
mono --profile=iomap yourapplication.exe
|
||||
|
||||
.fi
|
||||
Note, however, that Mono currently supports only one profiler module
|
||||
at a time.
|
||||
.TP
|
||||
\fBMONO_LLVM\fR
|
||||
When Mono is using the LLVM code generation backend you can use this
|
||||
@@ -1638,31 +1623,11 @@ home directories that might be shared over the network.
|
||||
If set, extra checks are made during IO operations. Currently, this
|
||||
includes only advisory locks around file writes.
|
||||
.TP
|
||||
\fBMONO_TLS_PROVIDER\fR
|
||||
This environment variable controls which TLS/SSL provider Mono will
|
||||
use. The options are usually determined by the operating system where
|
||||
Mono was compiled and the configuration options that were used for
|
||||
it.
|
||||
.RS
|
||||
.ne 8
|
||||
.TP
|
||||
.I default
|
||||
Uses the default TLS stack that the Mono runtime was configured with.
|
||||
Usually this is configured to use Apple's SSL stack on Apple
|
||||
platforms, and Boring SSL on other platforms.
|
||||
.TP
|
||||
.I apple
|
||||
Forces the use of the Apple SSL stack, only works on Apple platforms.
|
||||
.TP
|
||||
.I btls
|
||||
Forces the use of the BoringSSL stack. See
|
||||
https://opensource.google.com/projects/boringssl for more information
|
||||
about this stack.
|
||||
.TP
|
||||
.I legacy
|
||||
This is the old Mono stack, which only supports SSL and TLS up to
|
||||
version 1.0. It is deprecated and will be removed in the future.
|
||||
.RE
|
||||
\fBMONO_THEME\fR
|
||||
The name of the theme to be used by Windows.Forms. Available themes today
|
||||
include "clearlooks", "nice" and "win32".
|
||||
.Sp
|
||||
The default is "win32".
|
||||
.TP
|
||||
\fBMONO_TLS_SESSION_CACHE_TIMEOUT\fR
|
||||
The time, in seconds, that the SSL/TLS session cache will keep it's entry to
|
||||
@@ -1716,8 +1681,8 @@ Currently, the following options are supported:
|
||||
Enables small structs alignment to 4/8 bytes.
|
||||
.TP
|
||||
\fBarm-use-fallback-tls\fR
|
||||
When this option is set on ARM, a fallback thread local store will be used instead
|
||||
of the default fast thread local storage primitives.
|
||||
When this option is set on ARM, a fallback TLS will be used instead
|
||||
of the default fast TLS.
|
||||
.TP
|
||||
\fBbreak-on-unverified\fR
|
||||
If this variable is set, when the Mono VM runs into a verification
|
||||
@@ -1846,12 +1811,6 @@ This option will suspend the program when an exception occurs.
|
||||
.TP
|
||||
\fBsuspend-on-unhandled\fR
|
||||
This option will suspend the program when an unhandled exception occurs.
|
||||
.TP
|
||||
\fBthread-dump-dir=DIR\fR
|
||||
Use DIR for storage thread dumps created by SIGQUIT.
|
||||
.TP
|
||||
\fBverbose-gdb\fR
|
||||
Make gdb output on native crashes more verbose.
|
||||
.ne
|
||||
.RE
|
||||
.TP
|
||||
@@ -1933,10 +1892,7 @@ for example, to see managed frame names on gdb backtraces.
|
||||
\fBMONO_VERBOSE_METHOD\fR
|
||||
Enables the maximum JIT verbosity for the specified method. This is
|
||||
very helpfull to diagnose a miscompilation problems of a specific
|
||||
method. This can be a semicolon-separated list of method names to
|
||||
match. If the name is simple, this applies to any method with that
|
||||
name, otherwise you can use a mono method description (see the section
|
||||
METHOD DESCRIPTIONS).
|
||||
method.
|
||||
.TP
|
||||
\fBMONO_JIT_DUMP_METHOD\fR
|
||||
Enables sending of the JITs intermediate representation for a specified
|
||||
@@ -2052,11 +2008,8 @@ http://www.mono-project.com/community/help/mailing-lists/
|
||||
http://www.mono-project.com
|
||||
.SH SEE ALSO
|
||||
.PP
|
||||
\fBcertmgr\fR(1), \fBcert-sync\fR(1), \fBcsharp\fR(1),
|
||||
\fBgacutil\fR(1), \fBmcs\fR(1), \fBmonodis\fR(1),
|
||||
\fBmono-config\fR(5), \fBmono\-profilers\fR(1),
|
||||
\fBmprof\-report\fR(1), \fBpdb2mdb\fR(1), \fBxsp\fR(1),
|
||||
\fBmod_mono\fR(8)
|
||||
certmgr(1), cert-sync(1), csharp(1), gacutil(1), mcs(1), mdb(1), monodis(1),
|
||||
mono-config(5), mprof-report(1), pdb2mdb(1), xsp(1), mod_mono(8).
|
||||
.PP
|
||||
For more information on AOT:
|
||||
http://www.mono-project.com/docs/advanced/aot/
|
||||
|
||||
+1
-1
@@ -202,7 +202,7 @@ Specify a parameter for a custom step.
|
||||
.SH COPYRIGHT
|
||||
Copyright (C) 2007 Novell, Inc (http://www.novell.com)
|
||||
.SH BUGS
|
||||
Bugs report are welcome at https://github.com/mono/linker/issues
|
||||
Bugs report are welcome at http://bugzilla.xamarin.com
|
||||
.PP
|
||||
Product Mono Tools, Component linker.
|
||||
.SH MAILING LISTS
|
||||
|
||||
+523
-151
@@ -1,159 +1,531 @@
|
||||
.TH mprof-report 1
|
||||
.SH NAME
|
||||
mprof\-report \- report generator for Mono's log profiler
|
||||
.SH SYNOPSIS
|
||||
\fBmprof\-report\fR [\fIoption\fR]... \fIfile.mlpd\fR
|
||||
.SH DESCRIPTION
|
||||
\fBmprof\-report\fR is the report generator for Mono's \fBlog\fR
|
||||
profiler. It reads the MLPD log files produced by the log profiler
|
||||
and generates a report based on the options passed to it. The
|
||||
output is based on individual reports which can be turned on or off.
|
||||
By default, all reports are generated in summary form (i.e.,
|
||||
non-verbose output).
|
||||
.de Sp
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.TH mprof-report 1 ""
|
||||
.SH The Mono log profiler
|
||||
.PP
|
||||
\fBmprof\-report\fR can read both normal and \fBgzip\fR(1)-compressed
|
||||
log files transparently.
|
||||
The Mono \f[I]log\f[] profiler can be used to collect a lot of
|
||||
information about a program running in the Mono runtime.
|
||||
This data can be used (both while the process is running and later)
|
||||
to do analyses of the program behaviour, determine resource usage,
|
||||
performance issues or even look for particular execution patterns.
|
||||
.PP
|
||||
For information about how to use the log profiler with a program,
|
||||
see the \fBmono\-profilers\fR(1) page, under the \fBLOG PROFILER\fR
|
||||
section.
|
||||
.SH OPTIONS
|
||||
The following options are available:
|
||||
.TP
|
||||
\fB\-\-help\fR
|
||||
Displays usage instructions.
|
||||
.TP
|
||||
\fB\-\-out\fR=\fIfile\fR
|
||||
Write the report output to \fIfile\fR instead of standard output.
|
||||
.TP
|
||||
\fB\-\-traces\fR
|
||||
Show backtraces in reports when available.
|
||||
.TP
|
||||
\fB\-\-maxframes\fR=\fInum\fR
|
||||
Limit backtraces to \fInum\fR frames.
|
||||
.TP
|
||||
\fB\-\-reports\fR=\fIreports\fR
|
||||
Generate only the specified reports. \fIreports\fR is a
|
||||
comma-separated list of reports. See the \fBREPORTS\fR section.
|
||||
.TP
|
||||
\fB\-\-method\-sort\fR=\fImode\fR
|
||||
Sort methods according to \fImode\fR, which can be one of:
|
||||
.RS
|
||||
.TP
|
||||
\fBtotal\fR (default)
|
||||
Sort by the total amount of time spent in a method and its callees.
|
||||
.TP
|
||||
\fBself\fR
|
||||
Sort by the amount of time spent only within a method itself.
|
||||
.TP
|
||||
\fBcalls\fR
|
||||
Sort by the total amount of calls made to a method.
|
||||
This is accomplished by logging the events provided by the Mono
|
||||
runtime through the profiling interface and periodically writing
|
||||
them to a file which can be later inspected with the command line
|
||||
\f[I]mprof-report\f[] program or with a GUI (not developed yet).
|
||||
.PP
|
||||
The events collected include (among others):
|
||||
.IP \[bu] 2
|
||||
method enter and leave
|
||||
.IP \[bu] 2
|
||||
object allocation
|
||||
.IP \[bu] 2
|
||||
garbage collection
|
||||
.IP \[bu] 2
|
||||
JIT compilation
|
||||
.IP \[bu] 2
|
||||
metadata loading
|
||||
.IP \[bu] 2
|
||||
lock contention
|
||||
.IP \[bu] 2
|
||||
exceptions
|
||||
.PP
|
||||
In addition, the profiler can periodically collect info about all
|
||||
the objects present in the heap at the end of a garbage collection
|
||||
(this is called heap shot and currently implemented only for the
|
||||
sgen garbage collector).
|
||||
Another available profiler mode is the \f[I]sampling\f[] or
|
||||
\f[I]statistical\f[] mode: periodically the program is sampled and
|
||||
the information about what the program was busy with is saved.
|
||||
This allows to get information about the program behaviour without
|
||||
degrading its performance too much (usually less than 10%).
|
||||
.SS Basic profiler usage
|
||||
.PP
|
||||
The simpler way to use the profiler is the following:
|
||||
.PP
|
||||
\f[B]mono\ --profile=log\ program.exe\f[]
|
||||
.PP
|
||||
At the end of the execution the file \f[I]output.mlpd\f[] will be
|
||||
found in the current directory.
|
||||
A summary report of the data can be printed by running:
|
||||
.PP
|
||||
\f[B]mprof-report\ output.mlpd\f[]
|
||||
.PP
|
||||
With this invocation a huge amount of data is collected about the
|
||||
program execution and collecting and saving this data can
|
||||
significantly slow down program execution.
|
||||
If saving the profiling data is not needed, a report can be
|
||||
generated directly with:
|
||||
.PP
|
||||
\f[B]mono\ --profile=log:report\ program.exe\f[]
|
||||
.PP
|
||||
If the information about allocations is not of interest, it can be
|
||||
excluded:
|
||||
.PP
|
||||
\f[B]mono\ --profile=log:noalloc\ program.exe\f[]
|
||||
.PP
|
||||
On the other hand, if method call timing is not important, while
|
||||
allocations are, the needed info can be gathered with:
|
||||
.PP
|
||||
\f[B]mono\ --profile=log:nocalls\ program.exe\f[]
|
||||
.PP
|
||||
You will still be able to inspect information about the sequence of
|
||||
calls that lead to each allocation because at each object
|
||||
allocation a stack trace is collected if full enter/leave
|
||||
information is not available.
|
||||
.PP
|
||||
To periodically collect heap shots (and exclude method and
|
||||
allocation events) use the following options (making sure you run
|
||||
with the sgen garbage collector):
|
||||
.PP
|
||||
\f[B]mono\ --gc=sgen\ --profile=log:heapshot\ program.exe\f[]
|
||||
.PP
|
||||
To perform a sampling profiler run, use the \f[I]sample\f[] option:
|
||||
.PP
|
||||
\f[B]mono\ --profile=log:sample\ program.exe\f[]
|
||||
.SS Profiler option documentation
|
||||
.PP
|
||||
By default the \f[I]log\f[] profiler will gather all the events
|
||||
provided by the Mono runtime and write them to a file named
|
||||
\f[I]output.mlpd\f[].
|
||||
When no option is specified, it is equivalent to using:
|
||||
.PP
|
||||
\f[B]--profile=log:calls,alloc,output=output.mlpd,maxframes=32,calldepth=100\f[]
|
||||
.PP
|
||||
The following options can be used to modify this default behaviour.
|
||||
Each option is separated from the next by a \f[B],\f[] character,
|
||||
with no spaces and all the options are included after the
|
||||
\f[I]log:\f[] profile module specifier.
|
||||
.IP \[bu] 2
|
||||
\f[I]help\f[]: display concise help info about each available
|
||||
option
|
||||
.IP \[bu] 2
|
||||
\f[I][no]alloc\f[]: \f[I]noalloc\f[] disables collecting object
|
||||
allocation info, \f[I]alloc\f[] enables it if it was disabled by
|
||||
another option like \f[I]heapshot\f[].
|
||||
.IP \[bu] 2
|
||||
\f[I][no]calls\f[]: \f[I]nocalls\f[] disables collecting method
|
||||
enter and leave events.
|
||||
When this option is used at each object allocation and at some
|
||||
other events (like lock contentions and exception throws) a stack
|
||||
trace is collected by default.
|
||||
See the \f[I]maxframes\f[] option to control this behaviour.
|
||||
\f[I]calls\f[] enables method enter/leave events if they were
|
||||
disabled by another option like \f[I]heapshot\f[].
|
||||
.IP \[bu] 2
|
||||
\f[I]heapshot[=MODE]\f[]: collect heap shot data at each major
|
||||
collection.
|
||||
The frequency of the heap shots can be changed with the
|
||||
\f[I]MODE\f[] parameter.
|
||||
When this option is used allocation events and method enter/leave
|
||||
events are not recorded by default: if they are needed, they need
|
||||
to be enabled explicitly.
|
||||
The optional parameter \f[I]MODE\f[] can modify the default heap
|
||||
shot frequency.
|
||||
heapshot can be used multiple times with different modes: in that
|
||||
case a heap shot is taken if either of the conditions are met.
|
||||
MODE can be one of:
|
||||
.RS 2
|
||||
.IP \[bu] 2
|
||||
\f[I]NUM\f[]ms: perform a heap shot if at least \f[I]NUM\f[]
|
||||
milliseconds passed since the last one.
|
||||
.IP \[bu] 2
|
||||
\f[I]NUM\f[]gc: perform a heap shot every \f[I]NUM\f[] major
|
||||
garbage collections
|
||||
.IP \[bu] 2
|
||||
\f[I]ondemand\f[]: perform a heap shot when such a command is sent
|
||||
to the control port
|
||||
.RE
|
||||
.TP
|
||||
\fB\-\-alloc\-sort\fR=\fImode\fR
|
||||
Sort allocations according to \fImode\fR, which can be one of:
|
||||
.RS
|
||||
.TP
|
||||
\fBbytes\fR (default)
|
||||
Sort by the amount of heap bytes occupied by all allocated objects of
|
||||
a type.
|
||||
.TP
|
||||
\fBcount\fR
|
||||
Sort by the total amount of allocations of a type.
|
||||
.IP \[bu] 2
|
||||
\f[I]sample[=FREQ]\f[]: collect statistical samples of the
|
||||
program behaviour.
|
||||
The default is to collect a 100 times per second (100 Hz) the
|
||||
instruction pointer.
|
||||
This is equivalent to the value \[lq]100\[rq].
|
||||
A value of zero for \f[I]FREQ\f[] effectively disables sampling.
|
||||
.IP \[bu] 2
|
||||
\f[I]heapshot-on-shutdown\f[]: collect heap shot data when the runtime
|
||||
shuts down.
|
||||
.IP \[bu] 2
|
||||
\f[I]maxframes=NUM\f[]: when a stack trace needs to be performed,
|
||||
collect \f[I]NUM\f[] frames at the most.
|
||||
The default is 32.
|
||||
.IP \[bu] 2
|
||||
\f[I]maxsamples=NUM\f[]: stop allocating reusable sample events
|
||||
once \f[I]NUM\f[] events have been allocated (a value of zero for
|
||||
all intents and purposes means unlimited). By default, the value
|
||||
of this setting is the number of CPU cores multiplied by 1000. This
|
||||
is usually a good enough value for typical desktop and mobile apps.
|
||||
If you're losing too many samples due to this default (which is
|
||||
possible in apps with an unusually high amount of threads), you
|
||||
may want to tinker with this value to find a good balance between
|
||||
sample hit rate and performance impact on the app. The way it works
|
||||
is that sample events are enqueued for reuse after they're flushed
|
||||
to the output file; if a thread gets a sampling signal but there are
|
||||
no sample events in the reuse queue and the profiler has reached the
|
||||
maximum number of sample allocations, the sample gets dropped. So a
|
||||
higher number for this setting will increase the chance that a
|
||||
thread is able to collect a sample, but also necessarily means that
|
||||
there will be more work done by the profiler. You can run Mono with
|
||||
the \f[I]--stats\f[] option to see statistics about sample events.
|
||||
.IP \[bu] 2
|
||||
\f[I]calldepth=NUM\f[]: ignore method enter/leave events when the
|
||||
call chain depth is bigger than NUM.
|
||||
.IP \[bu] 2
|
||||
\f[I]zip\f[]: automatically compress the output data in gzip
|
||||
format.
|
||||
.IP \[bu] 2
|
||||
\f[I]output=OUTSPEC\f[]: instead of writing the profiling data to
|
||||
the output.mlpd file, substitute \f[I]%p\f[] in \f[I]OUTSPEC\f[]
|
||||
with the current process id and \f[I]%t\f[] with the current date
|
||||
and time, then do according to \f[I]OUTSPEC\f[]:
|
||||
.RS 2
|
||||
.IP \[bu] 2
|
||||
If \f[I]OUTSPEC\f[] begins with a \f[I]|\f[] character, execute the
|
||||
rest as a program and feed the data to its standard input.
|
||||
.IP \[bu] 2
|
||||
If \f[I]OUTSPEC\f[] begins with a \f[I]#\f[] character, parse the
|
||||
rest as a file descriptor number, and feed the data to this file
|
||||
descriptor.
|
||||
.IP \[bu] 2
|
||||
otherwise write the data the the named file: note that is a file by
|
||||
that name already exists, it is truncated.
|
||||
.RE
|
||||
.TP
|
||||
\fB\-\-counters\-sort\fR=\fImode\fR
|
||||
Sort counters according to \fImode\fR. This alters how the
|
||||
\fBcounters\fR report is presented. It can be one of:
|
||||
.RS
|
||||
.TP
|
||||
\fBtime\fR (default)
|
||||
Present a list of samples, each containing a list of counter
|
||||
name-value pairs.
|
||||
.TP
|
||||
\fBcategory\fR
|
||||
Present a list of counter names, each containing a list of sampled
|
||||
values.
|
||||
.IP \[bu] 2
|
||||
\f[I]report\f[]: the profiling data is sent to mprof-report, which
|
||||
will print a summary report.
|
||||
This is equivalent to the option: \f[B]output=mprof-report\ -\f[].
|
||||
If the \f[I]output\f[] option is specified as well, the report will
|
||||
be written to the output file instead of the console.
|
||||
.IP \[bu] 2
|
||||
\f[I]port=PORT\f[]: specify the tcp/ip port to use for the
|
||||
listening command server.
|
||||
Currently not available for windows.
|
||||
This server is started for example when heapshot=ondemand is used:
|
||||
it will read commands line by line.
|
||||
The following commands are available:
|
||||
.RS 2
|
||||
.IP \[bu] 2
|
||||
\f[I]heapshot\f[]: perform a heapshot as soon as possible
|
||||
.RE
|
||||
.IP
|
||||
This option has no effect unless \fB\-\-verbose\fR is passed.
|
||||
.TP
|
||||
\fB\-\-track\fR=\fIobjects\fR
|
||||
Track what happens to the specified objects. \fIobjects\fR is a
|
||||
comma-separated list of object addresses.
|
||||
.TP
|
||||
\fB\-\-find\fR=\fIspec\fR
|
||||
Find and track what happens to objects matching \fIspec\fR, which can
|
||||
have one of these forms:
|
||||
.RS
|
||||
.TP
|
||||
\fBS\fR:\fIminimum_size\fR
|
||||
Look for objects that are at least \fIminimum_size\fR bytes in size.
|
||||
.TP
|
||||
\fBT\fR:\fIname_fragment\fR
|
||||
Look for objects whose type name contain \fIname_fragment\fR.
|
||||
.IP \[bu] 2
|
||||
\f[I]nocounters\f[]: disables sampling of runtime and performance
|
||||
counters, which is normally done every 1 second.
|
||||
.RE
|
||||
.IP
|
||||
Both an \fBS\fR and \fBT\fR spec can be given by passing the option
|
||||
twice.
|
||||
.TP
|
||||
\fB\-\-thread\fR=\fItid\fR
|
||||
Consider only events from the thread with ID \fItid\fR.
|
||||
.TP
|
||||
\fB\-\-time\fR=\fIspan\fR
|
||||
Consider only events occurring in the specified time span. \fIspan\fR
|
||||
must be of the form \fIfrom\fR\-\fIto\fR where \fIfrom\fR and
|
||||
\fIto\fR are seconds since the program started.
|
||||
.TP
|
||||
\fB\-\-verbose\fR
|
||||
Print verbose output.
|
||||
.TP
|
||||
\fB\-\-debug\fR
|
||||
Print extremely detailed debug output. Most users should not use this
|
||||
.SS Analyzing the profile data
|
||||
.PP
|
||||
Currently there is a command line program (\f[I]mprof-report\f[])
|
||||
to analyze the data produced by the profiler.
|
||||
This is ran automatically when the \f[I]report\f[] profiler option
|
||||
is used.
|
||||
Simply run:
|
||||
.PP
|
||||
\f[B]mprof-report\ output.mlpd\f[]
|
||||
.PP
|
||||
to see a summary report of the data included in the file.
|
||||
.SS Trace information for events
|
||||
.PP
|
||||
Often it is important for some events, like allocations, lock
|
||||
contention and exception throws to know where they happened.
|
||||
Or we may want to see what sequence of calls leads to a particular
|
||||
method invocation.
|
||||
To see this info invoke mprof-report as follows:
|
||||
.PP
|
||||
\f[B]mprof-report\ --traces\ output.mlpd\f[]
|
||||
.PP
|
||||
The maximum number of methods in each stack trace can be specified
|
||||
with the \f[I]--maxframes=NUM\f[] option:
|
||||
.PP
|
||||
\f[B]mprof-report\ --traces\ --maxframes=4\ output.mlpd\f[]
|
||||
.PP
|
||||
The stack trace info will be available if method enter/leave events
|
||||
have been recorded or if stack trace collection wasn't explicitly
|
||||
disabled with the \f[I]maxframes=0\f[] profiler option.
|
||||
.PP
|
||||
The \f[I]--traces\f[] option also controls the reverse reference
|
||||
feature in the heapshot report: for each class it reports how many
|
||||
references to objects of that class come from other classes.
|
||||
.SS Sort order for methods and allocations
|
||||
.PP
|
||||
When a list of methods is printed the default sort order is based
|
||||
on the total time spent in the method.
|
||||
This time is wall clock time (that is, it includes the time spent,
|
||||
for example, in a sleep call, even if actual cpu time would be
|
||||
basically 0).
|
||||
Also, if the method has been ran on different threads, the time
|
||||
will be a sum of the time used in each thread.
|
||||
.PP
|
||||
To change the sort order, use the option:
|
||||
.PP
|
||||
\f[B]--method-sort=MODE\f[]
|
||||
.PP
|
||||
where \f[I]MODE\f[] can be:
|
||||
.IP \[bu] 2
|
||||
\f[I]self\f[]: amount of time spent in the method itself and not in
|
||||
its callees
|
||||
.IP \[bu] 2
|
||||
\f[I]calls\f[]: the number of method invocations
|
||||
.IP \[bu] 2
|
||||
\f[I]total\f[]: the total time spent in the method.
|
||||
.PP
|
||||
Object allocation lists are sorted by default depending on the
|
||||
total amount of bytes used by each type.
|
||||
.PP
|
||||
To change the sort order of object allocations, use the option:
|
||||
.PP
|
||||
\f[B]--alloc-sort=MODE\f[]
|
||||
.PP
|
||||
where \f[I]MODE\f[] can be:
|
||||
.IP \[bu] 2
|
||||
\f[I]count\f[]: the number of allocated objects of the given type
|
||||
.IP \[bu] 2
|
||||
\f[I]bytes\f[]: the total number of bytes used by objects of the
|
||||
given type
|
||||
.PP
|
||||
To change the sort order of counters, use the option:
|
||||
.PP
|
||||
\f[B]--counters-sort=MODE\f[]
|
||||
.PP
|
||||
where \f[I]MODE\f[] can be:
|
||||
.IP \[bu] 2
|
||||
\f[I]time\f[]: sort values by time then category
|
||||
.IP \[bu] 2
|
||||
\f[I]category\f[]: sort values by category then time
|
||||
.SS Selecting what data to report
|
||||
.PP
|
||||
The profiler by default collects data about many runtime subsystems
|
||||
and mprof-report prints a summary of all the subsystems that are
|
||||
found in the data file.
|
||||
It is possible to tell mprof-report to only show information about
|
||||
some of them with the following option:
|
||||
.PP
|
||||
\f[B]--reports=R1[,R2...]\f[]
|
||||
.PP
|
||||
where the report names R1, R2 etc.
|
||||
can be:
|
||||
.IP \[bu] 2
|
||||
\f[I]header\f[]: information about program startup and profiler
|
||||
version
|
||||
.IP \[bu] 2
|
||||
\f[I]jit\f[]: JIT compiler information
|
||||
.IP \[bu] 2
|
||||
\f[I]sample\f[]: statistical sampling information
|
||||
.IP \[bu] 2
|
||||
\f[I]gc\f[]: garbage collection information
|
||||
.IP \[bu] 2
|
||||
\f[I]alloc\f[]: object allocation information
|
||||
.IP \[bu] 2
|
||||
\f[I]call\f[]: method profiling information
|
||||
.IP \[bu] 2
|
||||
\f[I]metadata\f[]: metadata events like image loads
|
||||
.IP \[bu] 2
|
||||
\f[I]exception\f[]: exception throw and handling information
|
||||
.IP \[bu] 2
|
||||
\f[I]monitor\f[]: lock contention information
|
||||
.IP \[bu] 2
|
||||
\f[I]thread\f[]: thread information
|
||||
.IP \[bu] 2
|
||||
\f[I]domain\f[]: app domain information
|
||||
.IP \[bu] 2
|
||||
\f[I]context\f[]: remoting context information
|
||||
.IP \[bu] 2
|
||||
\f[I]heapshot\f[]: live heap usage at heap shots
|
||||
.IP \[bu] 2
|
||||
\f[I]counters\f[]: counters samples
|
||||
.IP \[bu] 2
|
||||
\f[I]stats\f[]: event statistics
|
||||
.PP
|
||||
It is possible to limit some of the data displayed to a timeframe
|
||||
of the program execution with the option:
|
||||
.PP
|
||||
\f[B]--time=FROM-TO\f[]
|
||||
.PP
|
||||
where \f[I]FROM\f[] and \f[I]TO\f[] are seconds since application
|
||||
startup (they can be floating point numbers).
|
||||
.PP
|
||||
Another interesting option is to consider only events happening on
|
||||
a particular thread with the following option:
|
||||
.PP
|
||||
\f[B]--thread=THREADID\f[]
|
||||
.PP
|
||||
where \f[I]THREADID\f[] is one of the numbers listed in the thread
|
||||
summary report (or a thread name when present).
|
||||
.PP
|
||||
By default long lists of methods or other information like object
|
||||
allocations are limited to the most important data.
|
||||
To increase the amount of information printed you can use the
|
||||
option:
|
||||
.PP
|
||||
\f[B]--verbose\f[]
|
||||
.SS Track individual objects
|
||||
.PP
|
||||
Instead of printing the usual reports from the profiler data, it is
|
||||
possible to track some interesting information about some specific
|
||||
object addresses.
|
||||
The objects are selected based on their address with the
|
||||
\f[I]--track\f[] option as follows:
|
||||
.PP
|
||||
\f[B]--track=0xaddr1[,0xaddr2,...]\f[]
|
||||
.PP
|
||||
The reported info (if available in the data file), will be class
|
||||
name, size, creation time, stack trace of creation (with the
|
||||
\f[I]--traces\f[] option), etc.
|
||||
If heapshot data is available it will be possible to also track
|
||||
what other objects reference one of the listed addresses.
|
||||
.PP
|
||||
The object addresses can be gathered either from the profiler
|
||||
report in some cases (like in the monitor lock report), from the
|
||||
live application or they can be selected with the
|
||||
\f[I]--find=FINDSPEC\f[] option.
|
||||
FINDSPEC can be one of the following:
|
||||
.IP \[bu] 2
|
||||
\f[I]S:SIZE\f[]: where the object is selected if its size is at
|
||||
least \f[I]SIZE\f[]
|
||||
.IP \[bu] 2
|
||||
\f[I]T:NAME\f[]: where the object is selected if \f[I]NAME\f[]
|
||||
partially matches its class name
|
||||
.PP
|
||||
This option can be specified multiple times with one of the
|
||||
different kinds of FINDSPEC.
|
||||
For example, the following:
|
||||
.PP
|
||||
\f[B]--find=S:10000\ --find=T:Byte[]\f[]
|
||||
.PP
|
||||
will find all the byte arrays that are at least 10000 bytes in
|
||||
size.
|
||||
.PP
|
||||
Note that with a moving garbage collector the object address can
|
||||
change, so you may need to track the changed address manually.
|
||||
It can also happen that multiple objects are allocated at the same
|
||||
address, so the output from this option can become large.
|
||||
.SS Saving a profiler report
|
||||
.PP
|
||||
By default mprof-report will print the summary data to the console.
|
||||
To print it to a file, instead, use the option:
|
||||
.PP
|
||||
\f[B]--out=FILENAME\f[]
|
||||
.SS Dealing with profiler slowness
|
||||
.PP
|
||||
If the profiler needs to collect lots of data, the execution of the
|
||||
program will slow down significantly, usually 10 to 20 times
|
||||
slower.
|
||||
There are several ways to reduce the impact of the profiler on the
|
||||
program execution.
|
||||
.IP "\f[I]Use the statistical sampling mode\f[]" 4
|
||||
.Sp
|
||||
Statistical sampling allows executing a program under the profiler
|
||||
with minimal performance overhead (usually less than 10%).
|
||||
This mode allows checking where the program is spending most of
|
||||
its execution time without significantly perturbing its behaviour.
|
||||
.IP "\f[I]Collect less data\f[]" 4
|
||||
.Sp
|
||||
Collecting method enter/leave events can be very expensive,
|
||||
especially in programs that perform many millions of tiny calls.
|
||||
The profiler option \f[I]nocalls\f[] can be used to avoid
|
||||
collecting this data or it can be limited to only a few call levels
|
||||
with the \f[I]calldepth\f[] option.
|
||||
.Sp
|
||||
Object allocation information is expensive as well, though much
|
||||
less than method enter/leave events.
|
||||
If it's not needed, it can be skipped with the \f[I]noalloc\f[]
|
||||
profiler option.
|
||||
Note that when method enter/leave events are discarded, by default
|
||||
stack traces are collected at each allocation and this can be
|
||||
expensive as well.
|
||||
The impact of stack trace information can be reduced by setting a
|
||||
low value with the \f[I]maxframes\f[] option or by eliminating them
|
||||
completely, by setting it to 0.
|
||||
.Sp
|
||||
The other major source of data is the \f[I]heapshot\f[] profiler
|
||||
option: especially if the managed heap is big, since every object
|
||||
needs to be inspected.
|
||||
The \f[I]MODE\f[] parameter of the \f[I]heapshot\f[] option can be
|
||||
used to reduce the frequency of the heap shots.
|
||||
.SS Dealing with the size of the data files
|
||||
.PP
|
||||
When collecting a lot of information about a profiled program, huge
|
||||
data files can be generated.
|
||||
There are a few ways to minimize the amount of data, for example by
|
||||
not collecting some of the more space-consuming information or by
|
||||
compressing the information on the fly or by just generating a
|
||||
summary report.
|
||||
.IP "\f[I]Reducing the amount of data\f[]" 4
|
||||
.Sp
|
||||
Method enter/leave events can be excluded completely with the
|
||||
\f[I]nocalls\f[] option or they can be limited to just a few levels
|
||||
of calls with the \f[I]calldepth\f[] option.
|
||||
For example, the option:
|
||||
.Sp
|
||||
\f[B]calldepth=10\f[]
|
||||
.Sp
|
||||
will ignore the method events when there are more than 10 managed
|
||||
stack frames.
|
||||
This is very useful for programs that have deep recursion or for
|
||||
programs that perform many millions of tiny calls deep enough in
|
||||
the call stack.
|
||||
The optimal number for the calldepth option depends on the program
|
||||
and it needs to be balanced between providing enough profiling
|
||||
information and allowing fast execution speed.
|
||||
.Sp
|
||||
Note that by default, if method events are not recorded at all, the
|
||||
profiler will collect stack trace information at events like
|
||||
allocations.
|
||||
To avoid gathering this data, use the \f[I]maxframes=0\f[] profiler
|
||||
option.
|
||||
.SH REPORTS
|
||||
The following reports are available:
|
||||
.TP
|
||||
\fBheader\fR
|
||||
Program startup and profiler version and operational information.
|
||||
.TP
|
||||
\fBjit\fR
|
||||
JIT compiler statistics.
|
||||
.TP
|
||||
\fBgc\fR
|
||||
Garbage collection and handle statistics.
|
||||
.TP
|
||||
\fBsample\fR
|
||||
Flat statistical sampling profile.
|
||||
.TP
|
||||
\fBalloc\fR
|
||||
Per-class GC allocation statistics and backtraces.
|
||||
.TP
|
||||
\fBcall\fR
|
||||
Method call statistics and backtraces.
|
||||
.TP
|
||||
\fBmetadata\fR
|
||||
Loaded images and assemblies.
|
||||
.TP
|
||||
\fBexception\fR
|
||||
Exception statistics and backtraces.
|
||||
.TP
|
||||
\fBmonitor\fR
|
||||
Monitor lock statistics and backtraces.
|
||||
.TP
|
||||
\fBthread\fR
|
||||
Managed thread names.
|
||||
.TP
|
||||
\fBdomain\fR
|
||||
Loaded application domains.
|
||||
.TP
|
||||
\fBcontext\fR
|
||||
Loaded remoting contexts.
|
||||
.TP
|
||||
\fBheapshot\fR
|
||||
Heap snapshot information.
|
||||
.TP
|
||||
\fBcounters\fR
|
||||
Performance counter samples.
|
||||
.Sp
|
||||
Allocation events can be eliminated with the \f[I]noalloc\f[]
|
||||
option.
|
||||
.Sp
|
||||
Heap shot data can also be huge: by default it is collected at each
|
||||
major collection.
|
||||
To reduce the frequency, you can specify a heapshot mode: for
|
||||
example to collect every 5 collections (including major and minor):
|
||||
.Sp
|
||||
\f[B]heapshot=5gc\f[]
|
||||
.Sp
|
||||
or when at least 5 seconds passed since the last heap shot:
|
||||
.Sp
|
||||
\f[B]heapshot=5000ms\f[]
|
||||
.IP "\f[I]Compressing the data\f[]" 4
|
||||
.Sp
|
||||
To reduce the amout of disk space used by the data, the data can be
|
||||
compressed either after it has been generated with the gzip
|
||||
command:
|
||||
.Sp
|
||||
\f[B]gzip\ -9\ output.mlpd\f[]
|
||||
.Sp
|
||||
or it can be compressed automatically by using the \f[I]zip\f[]
|
||||
profiler option.
|
||||
Note that in this case there could be a significant slowdown of the
|
||||
profiled program.
|
||||
.Sp
|
||||
The mprof-report program will tranparently deal with either
|
||||
compressed or uncompressed data files.
|
||||
.IP "\f[I]Generating only a summary report\f[]" 4
|
||||
.Sp
|
||||
Often it's enough to look at the profiler summary report to
|
||||
diagnose an issue and in this case it's possible to avoid saving
|
||||
the profiler data file to disk.
|
||||
This can be accomplished with the \f[I]report\f[] profiler option,
|
||||
which will basically send the data to the mprof-report program for
|
||||
display.
|
||||
.Sp
|
||||
To have more control of what summary information is reported (or to
|
||||
use a completely different program to decode the profiler data),
|
||||
the \f[I]output\f[] profiler option can be used, with \f[B]|\f[] as
|
||||
the first character: the rest of the output name will be executed
|
||||
as a program with the data fed in on the standard input.
|
||||
.Sp
|
||||
For example, to print only the Monitor summary with stack trace
|
||||
information, you could use it like this:
|
||||
.Sp
|
||||
\f[B]output=|mprof-report\ --reports=monitor\ --traces\ -\f[]
|
||||
.SH WEB SITE
|
||||
http://www.mono-project.com/docs/debug+profile/profile/profiler/
|
||||
.SH SEE ALSO
|
||||
\fBmono\fR(1), \fBmono\-profilers\fR(1)
|
||||
.PP
|
||||
mono(1)
|
||||
.SH AUTHORS
|
||||
Paolo Molaro, Alex Rønne Petersen
|
||||
+2
-2
@@ -515,10 +515,10 @@ The Mono SQL Query Tool is released under the terms of the GNU GPL.
|
||||
Please read the accompanying `COPYING' file for details. Alternative
|
||||
licenses are available from Novell or Daniel Morgan.
|
||||
.SH BUGS
|
||||
To report bugs in the compiler, you can
|
||||
To report bugs in the compiler, you can use `bug-buddy', or you can
|
||||
file bug reports in our bug tracking system:
|
||||
.nf
|
||||
https://github.com/mono/mono/issues
|
||||
http://bugzilla.xamarin.com.
|
||||
.fi
|
||||
.PP
|
||||
.SH MAILING LISTS
|
||||
|
||||
@@ -12,7 +12,6 @@ TestResult-*.xml
|
||||
TestResult*.xml
|
||||
.dep_dirs-*
|
||||
apidiff/*
|
||||
csprojdiff/*
|
||||
errors/*.log
|
||||
errors/dummy.xml
|
||||
class/Mono.Data.Sqlite/test.db
|
||||
|
||||
+6
-20
@@ -6,9 +6,9 @@ SUBDIRS := build jay mcs class nunit24 ilasm tools tests errors docs packages
|
||||
|
||||
basic_SUBDIRS := build jay class
|
||||
build_SUBDIRS := build class class/aot-compiler tools ilasm
|
||||
monodroid_SUBDIRS := build class tools
|
||||
monodroid_SUBDIRS := build class
|
||||
monodroid_tools_SUBDIRS := build class tools
|
||||
monotouch_SUBDIRS := build class tools
|
||||
monotouch_SUBDIRS := build class
|
||||
monotouch_watch_SUBDIRS := build class
|
||||
monotouch_tv_SUBDIRS := build class
|
||||
monotouch_runtime_SUBDIRS := build class
|
||||
@@ -25,7 +25,6 @@ xbuild_14_SUBDIRS := build class tools/xbuild
|
||||
winaot_SUBDIRS := build class
|
||||
orbis_SUBDIRS := build class
|
||||
unreal_SUBDIRS := build class
|
||||
wasm_SUBDIRS := build class
|
||||
|
||||
include build/rules.make
|
||||
|
||||
@@ -47,7 +46,7 @@ all-profiles $(STD_TARGETS:=-profiles): %-profiles: profiles-do--%
|
||||
@:
|
||||
|
||||
profiles-do--%:
|
||||
$(if $(PROFILES),$(MAKE) $(PROFILES:%=profile-do--%--$*))
|
||||
$(MAKE) $(PROFILES:%=profile-do--%--$*)
|
||||
|
||||
# The % below looks like profile-name--target-name
|
||||
profile-do--%:
|
||||
@@ -82,7 +81,6 @@ $(_boot_:%=profile-do--testing_aot_full--%): profile-do--testing_aot_fu
|
||||
$(_boot_:%=profile-do--winaot--%): profile-do--winaot--%: profile-do--build--%
|
||||
$(_boot_:%=profile-do--orbis--%): profile-do--orbis--%: profile-do--build--%
|
||||
$(_boot_:%=profile-do--unreal--%): profile-do--unreal--%: profile-do--build--%
|
||||
$(_boot_:%=profile-do--wasm--%): profile-do--wasm--%: profile-do--build--%
|
||||
$(_boot_:%=profile-do--build--%): profile-do--build--%: profile-do--basic--%
|
||||
|
||||
testcorlib:
|
||||
@@ -152,18 +150,14 @@ MONO_API_ASSEMBLIES_IGNORED := $(addprefix $(topdir)class/lib/$(PROFILE)/, Mono.
|
||||
MONO_API_ASSEMBLIES := $(filter-out $(MONO_API_ASSEMBLIES_IGNORED), $(wildcard $(topdir)class/lib/$(PROFILE)/*.dll)) $(wildcard $(topdir)class/lib/$(PROFILE)/Facades/*.dll)
|
||||
MONO_API_ASSEMBLIES_CS := $(MONO_API_ASSEMBLIES:$(topdir)class/lib/$(PROFILE)/%.dll=$(MONO_API_SNAPSHOT_PROFILE_PATH)%.cs)
|
||||
|
||||
apidiff/ignored-attr.txt:
|
||||
$(MONO_API_SNAPSHOT_PROFILE_PATH)%.cs: $(topdir)class/lib/$(PROFILE)/%.dll $(GENAPI) $(MONO_API_SNAPSHOT_PATH)profiles/license-header.txt
|
||||
@mkdir -p $(dir $@)
|
||||
@echo "T:System.Runtime.CompilerServices.CompilerGeneratedAttribute" > $@
|
||||
|
||||
$(MONO_API_SNAPSHOT_PROFILE_PATH)%.cs: $(topdir)class/lib/$(PROFILE)/%.dll $(GENAPI) $(MONO_API_SNAPSHOT_PATH)profiles/license-header.txt apidiff/ignored-attr.txt
|
||||
@mkdir -p $(dir $@)
|
||||
$(Q) MONO_PATH=$(topdir)class/lib/$(BUILD_TOOLS_PROFILE) $(RUNTIME) $(GENAPI) -libPath:$(topdir)class/lib/$(PROFILE),$(topdir)class/lib/$(PROFILE)/Facades -out:$(dir $@) -headerFile:$(MONO_API_SNAPSHOT_PATH)profiles/license-header.txt -assemblyAttributes -typeForwardedTo -assemblyVersion -excludeAttributesList:apidiff/ignored-attr.txt -assembly:$< || echo "Couldn't process assembly." > $@
|
||||
$(Q) MONO_PATH=$(topdir)class/lib/$(BUILD_TOOLS_PROFILE) $(RUNTIME) $(GENAPI) -libPath:$(topdir)class/lib/$(PROFILE),$(topdir)class/lib/$(PROFILE)/Facades -out:$(dir $@) -headerFile:$(MONO_API_SNAPSHOT_PATH)profiles/license-header.txt -assemblyAttributes -typeForwardedTo -assemblyVersion -assembly:$< || echo "Couldn't process assembly." > $@
|
||||
|
||||
mono-api-current: $(MONO_API_ASSEMBLIES_CS)
|
||||
|
||||
mono-api-current-clean:
|
||||
$(Q) find "$(MONO_API_SNAPSHOT_PROFILE_PATH)" -name "*.cs" -type f -delete
|
||||
$(Q) rm -rf "$(MONO_API_SNAPSHOT_PROFILE_PATH)"
|
||||
|
||||
mono-api-diff:
|
||||
@echo "Regenerating API snapshot..."
|
||||
@@ -179,11 +173,3 @@ mono-api-diff:
|
||||
@mkdir -p apidiff
|
||||
$(Q) sed -e "/@diffdata@/r temp.patch" -e "/@diffdata@/d" -e "s/@title@/Public API Diff/g" -e "s/@description@/If the changes are intentional, run <code>make -C mcs mono-api-diff<\/code> locally and commit changes in external\/api-snapshot./g" diff.html.in > apidiff/index.html
|
||||
$(Q) if [ -s temp.patch ]; then echo "Error: Found public API differences, see mcs/apidiff/index.html. If the changes are intentional, please go to external/api-snapshot and commit them."; rm -f temp.patch; exit 1; else echo "No differences found."; rm -f temp.patch; fi
|
||||
|
||||
mono-csproj-diff:
|
||||
@echo "Generating csproj diff..."
|
||||
$(Q) git add -A "*.csproj" $(topdir)../bcl.sln
|
||||
$(Q) git diff --no-renames HEAD "*.csproj" $(topdir)../bcl.sln > $(abspath $(topdir))/temp.patch
|
||||
@mkdir -p csprojdiff
|
||||
$(Q) sed -e "/@diffdata@/r temp.patch" -e "/@diffdata@/d" -e "s/@title@/Project Files Diff/g" -e "s/@description@/Use <code>@monojenkins commit csproj<\/code> to commit them./g" diff.html.in > csprojdiff/index.html
|
||||
$(Q) if [ -s temp.patch ]; then echo "Error: Found csproj differences, see mcs/csprojdiff/index.html. If the changes are intentional, please commit them."; rm -f temp.patch; exit 1; else echo "No differences found."; rm -f temp.patch; fi
|
||||
+3
-3
@@ -15,7 +15,7 @@ common/Consts.cs: common/Consts.cs.in $(wildcard config.make)
|
||||
test -n '$(MONO_CORLIB_VERSION)'
|
||||
sed -e 's,@''MONO_VERSION@,$(MONO_VERSION),' -e 's,@''MONO_CORLIB_VERSION@,$(MONO_CORLIB_VERSION),' $< > $@
|
||||
|
||||
PLATFORMS = macos linux win32 unix
|
||||
PLATFORMS = darwin linux win32
|
||||
PROFILES = \
|
||||
basic \
|
||||
build \
|
||||
@@ -33,14 +33,14 @@ COMMON_SRCS = \
|
||||
AssemblyRef.cs
|
||||
|
||||
DISTFILES = \
|
||||
README.makefiles.md \
|
||||
README.makefiles \
|
||||
README.platforms \
|
||||
README.configury \
|
||||
config-default.make \
|
||||
corcompare.make \
|
||||
corcompare-api.xsl \
|
||||
executable.make \
|
||||
gensources.cs \
|
||||
gensources.sh \
|
||||
library.make \
|
||||
rules.make \
|
||||
tests.make \
|
||||
|
||||
@@ -0,0 +1,791 @@
|
||||
The MCS makefiles (-*- outline -*-)
|
||||
Peter Williams <[email protected]>
|
||||
|
||||
The new makefiles try to abstract building on Windows and Linux. They
|
||||
try to provide a consistent set of ways to express the things that our
|
||||
build system needs to let us do, specifically:
|
||||
|
||||
* Build recursively
|
||||
* Build libraries and executables easily
|
||||
* Let developers use different runtimes and class libaries
|
||||
* Make distributions easily
|
||||
* Provide a framework for testing
|
||||
* Build platform-independently whenever possible
|
||||
* Generate, update, and build monodoc documentation.
|
||||
|
||||
|
||||
|
||||
** Makefile structure
|
||||
|
||||
A general makefile looks like this:
|
||||
|
||||
========================================
|
||||
thisdir = class/Mono.My.Library
|
||||
SUBDIRS =
|
||||
include ../../build/rules.make
|
||||
|
||||
all-local:
|
||||
do some stuff
|
||||
|
||||
install-local:
|
||||
$(MKINSTALLDIRS) $(DESTDIR)$(prefix)/share/
|
||||
$(INSTALL_DATA) myfile.txt $(DESTDIR)$(prefix)/share/myfiledir
|
||||
|
||||
clean-local:
|
||||
rm -f my-generated-file
|
||||
|
||||
test-local: my_test_program.exe
|
||||
|
||||
run-test-local:
|
||||
$(RUNTIME) my_test_program.exe
|
||||
|
||||
run-test-ondotnet-local:
|
||||
$(RUNTIME) my_test_program.exe
|
||||
|
||||
DISTFILES = myfile.txt my_test_source.cs
|
||||
|
||||
dist-local: dist-default
|
||||
|
||||
doc-update-local:
|
||||
|
||||
my_test_program.exe: my_test_source.cs
|
||||
$(CSCOMPILE) /target:exe /out:$@ $<
|
||||
========================================
|
||||
|
||||
Each makefile follows the same pattern: it does some setup, includes
|
||||
the standard make rules, and provides rules for eight standard targets:
|
||||
all, install, test, run-test, clean, dist, and doc-update.
|
||||
|
||||
"Some setup" is defining two variables: $(thisdir) and
|
||||
$(SUBDIRS). $(thisdir) is the directory that the makefile lives in,
|
||||
relative to the top directory (ie, class/corlib) and $(SUBDIRS)
|
||||
defines the subdirectories that should be built in.
|
||||
|
||||
The eight targets do the following:
|
||||
|
||||
* all-local builds whatever someone would expect to be built
|
||||
when they just type 'make'. Most likely Foo.dll or Foo.exe
|
||||
|
||||
* install-local installs whatever got built by all-local.
|
||||
|
||||
* test-local _builds_ the test programs or libraries but does
|
||||
_not_ run them.
|
||||
|
||||
* run-test-local actually runs the tests. It shouldn't
|
||||
necessarily exit in an error if the test fails, but should make that
|
||||
situation obvious. It should only run tests that take care of
|
||||
themselves automatically; interactive tests should have an individual
|
||||
target. The idea is that 'make run-test' from the toplevel should be
|
||||
able to proceed unsupervised and test everything that can be tested in
|
||||
such a manner.
|
||||
|
||||
* run-test-ondotnet-local is a variant of run-test-local. It is used only to validate if our tests themselves works fine under Microsoft runtime (on Windows). Basically, in this target, we should not use $(TEST_RUNTIME) to test our libraries.
|
||||
|
||||
* clean-local removes built files; 'make clean' should leave
|
||||
only files that go into a distribution tarball. (But it is not necessarily
|
||||
true that all files that go into a tarball need to be left after a make clean.)
|
||||
|
||||
* dist-local copies files into the distribution tree, which is
|
||||
given by the variable $(distdir). dist-local always depends on the
|
||||
target 'dist-default'. See ** 'make dist' below.
|
||||
|
||||
* doc-update-local should generate or update monodoc documentation,
|
||||
if appropriate. This is usually only appropriate for libraries. It's
|
||||
defined as a standard target so that it can easily be run recursively
|
||||
across all libraries within the module.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
** Build configuration
|
||||
|
||||
In general, MCS needs to be able to build relying only on the
|
||||
existence of a runtime and core libraries (corlib, System,
|
||||
System.Xml). So there shouldn't be any checking for libraries or
|
||||
whatnot; MCS should be able to build out of the box. We try to keep
|
||||
platform detection and feature testing (ie, for HP/UX echo) inside
|
||||
the makefiles; right now, there's no configuration script, and it'd
|
||||
be nice to keep it that way. (I am told that some people build on
|
||||
both Windows and Linux in the same tree, which would be impossible to
|
||||
do if we cached platform-related configury values.)
|
||||
|
||||
That being said, it's very convenient for developers to be able to
|
||||
customize their builds to suit their needs. To allow this, the
|
||||
Makefile rules are set up to allow people to override pretty much any
|
||||
important variable.
|
||||
|
||||
Configuration variables are given defaults in `config-default.make';
|
||||
`rules.make' optionally includes `$(topdir)/build/config.make', so you
|
||||
can customize your build without CVS trying to commit your modified
|
||||
`config-default.make' all the time. Platform-specific variables are
|
||||
defined in `$(topdir)/build/platforms/$(BUILD_PLATFORM).make', where
|
||||
$(BUILD_PLATFORM) is detected in config-default.make. (Currently, the only
|
||||
choices are linux.make and win32.make.)
|
||||
|
||||
The best way to learn what the configuration variables are is to read
|
||||
`config.make' and `platform.make'. There aren't too many and hopefully
|
||||
they should be self-explanatory; see the numerous examples below for
|
||||
more information if you're confused.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
** Recommendations for platform specifics
|
||||
|
||||
If you find yourself needing a platform-specific customization, try
|
||||
and express it in terms of a feature, rather than a platform test. In
|
||||
other words, this is good:
|
||||
|
||||
========================================
|
||||
run-test-local: my-test.exe
|
||||
ifdef PLATFORM_NEEDS_CRAZY_CRAP
|
||||
crazy-crap
|
||||
endif
|
||||
$(RUNTIME) my-test.exe
|
||||
========================================
|
||||
|
||||
and this is bad:
|
||||
|
||||
========================================
|
||||
run-test-local: my-test.exe
|
||||
ifdef WINDOWS
|
||||
crazy-crap
|
||||
else
|
||||
ifdef AMIGA
|
||||
crazy-crap
|
||||
endif
|
||||
endif
|
||||
$(RUNTIME) my-test.exe
|
||||
========================================
|
||||
|
||||
The latter accumulates and gets unpleasant and it sucks. Granted,
|
||||
right now we only have two platforms, so it's not a big deal, but it's
|
||||
good form to get used to and practice. Anyway, take a look at how we
|
||||
do the various corlib building hacks for examples of how we've done
|
||||
platform-specificity. It certainly isn't pretty, but at least it's a
|
||||
little structured.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
** Saving effort
|
||||
|
||||
The point of the build system is to abstract things and take
|
||||
care of all the easy stuff. So if you find yourself writing a
|
||||
Makefile, know that there's probably already infrastructure to do what
|
||||
you want. Here are all the common cases I can think of ...
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
* Compiling C# code? use:
|
||||
|
||||
========================================
|
||||
my-program.exe: my-source.cs
|
||||
$(CSCOMPILE) /target:exe /out:$@ $^
|
||||
========================================
|
||||
|
||||
or
|
||||
|
||||
========================================
|
||||
my-lib.dll: my-source.cs
|
||||
$(CSCOMPILE) /target:library /out:$@ $^
|
||||
========================================
|
||||
|
||||
Note the '$@' and '$^' variables. The former means "the name of the
|
||||
file that I am trying to make" and the latter means "all the
|
||||
dependencies of the file I am trying to make." USE THESE VARIABLES
|
||||
AGGRESSIVELY. Say that you add a new source to your program:
|
||||
|
||||
========================================
|
||||
my-program.exe: my-source.cs my-new-source.cs
|
||||
$(CSCOMPILE) /target:exe /out:$@ $^
|
||||
========================================
|
||||
|
||||
Because of the $^ variable, you don't need to remember to add another
|
||||
file to the command line. Similarly, if you rename your program, you
|
||||
won't need to remember to change the rule:
|
||||
|
||||
========================================
|
||||
MonoVaporizer.exe: my-source.cs my-new-source.cs
|
||||
$(CSCOMPILE) /target:exe /out:$@ $^
|
||||
========================================
|
||||
|
||||
will still work. Another useful variable is $<, which means "the first
|
||||
dependency of whatever I'm building." If you order your dependencies
|
||||
carefully it can be extremely useful.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
* Just building an executable? use:
|
||||
|
||||
========================================
|
||||
PROGRAM = myprogram.exe
|
||||
LOCAL_MCS_FLAGS = /r:System.Xml.dll
|
||||
|
||||
include ../build/executable.make
|
||||
========================================
|
||||
|
||||
executable.make builds a program in the current directory. Its name is
|
||||
held in $(PROGRAM), and its sources are listed in the file
|
||||
$(PROGRAM).sources. It might seem to make more sense to just list the
|
||||
program's sources in the Makefile, but when we build on Windows we
|
||||
need to change slashes around, which is much easier to do if the
|
||||
sources are listed in a file. The variable $(LOCAL_MCS_FLAGS) changes
|
||||
the flags given to the compiler; it is included in $(CSCOMPILE) so you
|
||||
don't need to worry about it.
|
||||
|
||||
executable.make does a lot for you: it builds the program in 'make
|
||||
all-local', installs the program in $(prefix)/bin, distributes the
|
||||
sources, and defines empty test targets. Now, if your program has a
|
||||
test, set the variable HAS_TEST:
|
||||
|
||||
========================================
|
||||
PROGRAM = myprogram.exe
|
||||
LOCAL_MCS_FLAGS = /r:System.Xml.dll
|
||||
HAS_TEST = yes
|
||||
include ../build/executable.make
|
||||
|
||||
test-local: mytester.exe
|
||||
|
||||
run-test-local: mytester.exe
|
||||
$(RUNTIME) $<
|
||||
|
||||
mytester.exe: mytester.cs
|
||||
$(CSCOMPILE) /target:exe /out:$@ mytester.cs
|
||||
========================================
|
||||
|
||||
If your program has NUnit tests, set the variable HAS_NUNIT_TEST:
|
||||
|
||||
========================================
|
||||
PROGRAM = myprogram.exe
|
||||
LOCAL_MCS_FLAGS = /r:System.Xml.dll
|
||||
HAS_NUNIT_TEST = yes
|
||||
include ../build/executable.make
|
||||
========================================
|
||||
|
||||
HAS_NUNIT_TEST tests follow library.make NUnit test conventions:
|
||||
the files should be in a subdirectory called Test/, and if
|
||||
your program is called myprogram.exe, they should be listed in
|
||||
myprogram_test.dll.sources. The names in that files should *not* have
|
||||
the Test/ prefix. 'make test' will build myprogram_test_$(PROFILE).dll
|
||||
in the current directory, automatically supplying the flags to
|
||||
reference the original program and NUnit.Framework.dll.
|
||||
|
||||
If your program has 'built sources', that is, source files generated
|
||||
from other files (say, generated by jay), define a variable called
|
||||
BUILT_SOURCES and do *not* list the sources in $(PROGRAM).sources:
|
||||
|
||||
========================================
|
||||
PROGRAM = myprogram.exe
|
||||
LOCAL_MCS_FLAGS = /r:System.Xml.dll
|
||||
BUILT_SOURCES = parser.cs
|
||||
CLEAN_FILES = y.output
|
||||
|
||||
include ../build/executable.make
|
||||
|
||||
parser.cs: parser.jay
|
||||
$(topdir)/jay/jay $< > $@
|
||||
========================================
|
||||
|
||||
executable.make will automatically delete the $(BUILT_SOURCES) files
|
||||
on 'make clean'. Since this situation is a common occurrence and jay
|
||||
happens to leave behind y.output files, you can also define a variable
|
||||
called $(CLEAN_FILES) that lists extra files to be deleted when 'make clean' is
|
||||
called. (That's in addition to your executable and the built sources).
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
* Buildling a library? Use
|
||||
|
||||
========================================
|
||||
LIBRARY = Mono.MyLib.dll
|
||||
LIB_MCS_FLAGS = /unsafe
|
||||
TEST_MCS_FLAGS = /r:System.Xml.dll
|
||||
|
||||
include ../../build/library.make
|
||||
========================================
|
||||
|
||||
Where you library is called $(LIBRARY); it will be put into
|
||||
$(topdir)/class/lib. LIB_MCS_FLAGS is the set of MCS flags to use when
|
||||
compiling the library; in addition, a global set of flags called
|
||||
$(LIBRARY_FLAGS) is added (that variable is defined in
|
||||
config-defaults.make), as well as the usual $(LOCAL_MCS_FLAGS).
|
||||
|
||||
As in executable.make, the sources for your library are listed in
|
||||
$(LIBRARY).sources. Note: these source lists should have Unix forward
|
||||
slashes and Unix newlines (\n, not \r\n.) If you get an error about
|
||||
"touch: need a filename", that means your .sources file doesn't end in
|
||||
a newline. It should.
|
||||
|
||||
Now library.make also assumes that your library has an NUnit2 test
|
||||
harness. The files should be in a subdirectory called Test/, and if
|
||||
your library is called Mono.Foo.dll, they should be listed in
|
||||
Mono.Foo_test.dll.sources. The names in that files should *not* have
|
||||
the Test/ prefix. 'make test' will build Mono.Foo_test.dll in the
|
||||
current directory, automatically supplying the flags to reference the
|
||||
original library and NUnit.Framework.dll.
|
||||
|
||||
If you don't have a test, just do this:
|
||||
|
||||
========================================
|
||||
LIBRARY = Mono.MyLib.dll
|
||||
LIB_MCS_FLAGS = /unsafe
|
||||
NO_TEST = yes
|
||||
|
||||
include ../../build/library.make
|
||||
========================================
|
||||
|
||||
and feel ashamed. Every good library has a test suite!
|
||||
|
||||
Extra flags needed to compile the test library should be listed in
|
||||
$(TEST_MCS_FLAGS); often you will have a line like this:
|
||||
|
||||
========================================
|
||||
TEST_MCS_FLAGS = $(LIB_MCS_FLAGS)
|
||||
========================================
|
||||
|
||||
Again, library.make does a lot for you: it builds the dll, it
|
||||
generates makefile fragments to track the dependencies, it installs
|
||||
the library, it builds the test dll on 'make test', it runs
|
||||
$(TEST_HARNESS) on it on 'make run-test', it removes the appropriate
|
||||
files on 'make clean', and it distributes all the source files on
|
||||
'make dist'. (TEST_HARNESS defaults to be nunit-console.exe but it may
|
||||
be overridden to, say, nunit-gtk). If you have extra files to
|
||||
distribute when using either library.make or executable.make, use the
|
||||
variable $(EXTRA_DISTFILES):
|
||||
|
||||
========================================
|
||||
EXTRA_DISTFILES = \
|
||||
Test/testcase1.in \
|
||||
Test/testcase1.out \
|
||||
README
|
||||
========================================
|
||||
|
||||
Again, library.make and executable.make do the right things so that we
|
||||
can build on Windows, doing some trickery to invert slashes and
|
||||
overcome command-line length limitations. Use them unless you have a
|
||||
really good reason not to. If you're building a bunch of small
|
||||
executables, check out tools/Makefile or tools/security/Makefile; if
|
||||
all the files are in the current directory, changing slashes isn't a
|
||||
big deal, and command-line lengths won't be a problem, so
|
||||
executable.make isn't necessary (and indeed it won't work, since it
|
||||
can only build one .exe in a directory).
|
||||
|
||||
If you're building a library, library.make is highly recommended; the
|
||||
only DLL that doesn't use it is corlib, because building corlib is a
|
||||
fair bit more complicated than it should be. Oh well.
|
||||
|
||||
library.make also automatically supports generating and updating
|
||||
monodoc documentation. Documentation is stored within the
|
||||
Documentation directory (a sibling to the Test directory), and is
|
||||
generated/updated whenever the doc-update target is executed.
|
||||
Assembling of the documentation so that the monodoc browser can
|
||||
display the documentation is handled separately within the mcs/docs
|
||||
all-local target; see mcs/docs/Makefile for details.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
* Running a C# program? Use $(RUNTIME)
|
||||
|
||||
========================================
|
||||
run-test-local: myprog.exe
|
||||
$(RUNTIME) myprog.exe
|
||||
========================================
|
||||
|
||||
$(RUNTIME) might be empty (if you're on windows), so don't expect to
|
||||
be able to give it any arguments. If you're on a platform which has an
|
||||
interpreter or jitter, $(RUNTIME_FLAGS) is included in $(RUNTIME), so
|
||||
set that variable.
|
||||
|
||||
$(TEST_RUNTIME) is the runtime to use when running tests. Right now it's
|
||||
just "mono --debug".
|
||||
|
||||
|
||||
|
||||
* Calling the compiler directly? Use $(MCS).
|
||||
|
||||
Really, you should use $(CSCOMPILE) whenever possible, but $(MCS) is
|
||||
out there. $(BOOTSTRAP_MCS) is the C# compiler that we use to build
|
||||
mcs.exe; on Linux, we then use mcs.exe to build everything else, but
|
||||
on Windows, we use csc.exe to build everything. Only use
|
||||
$(BOOTSTRAP_MCS) if you know what you're doing.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
* Compiling C code? Use $(CCOMPILE)
|
||||
|
||||
To give it flags, set $(LOCAL_CFLAGS). As with compiling C#, the
|
||||
variable $(CFLAGS) will automatically be included on the command line.
|
||||
|
||||
|
||||
* Compiling resources with resgen
|
||||
|
||||
If you have a resource that should be compiled with resgen and
|
||||
included in your assembly, you can use the RESOURCES_DEFS variable.
|
||||
This variable can contain lists of pairs that are separated by comma
|
||||
to represent the resource ID as embedded in the assembly followed by
|
||||
the file name, like this:
|
||||
|
||||
RESOURCE_DEFS = Messages,TextResources.resx Errors,ErrorList.txt
|
||||
|
||||
|
||||
* Documentation-related needs? Use $(MDOC)
|
||||
|
||||
$(MDOC) is a front-end to the monodoc documentation system, supporting
|
||||
documentation generation, updating, importing from Microsoft XML
|
||||
Documentation and ECMA documentation formats, assembling documentation
|
||||
for use within the monodoc documentation browser, and exporting
|
||||
documentation to various other output formats such as static HTML.
|
||||
|
||||
It is currently only used for library.make's doc-update-local target
|
||||
and for assembling documentation within $topdir/docs.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
* Installing files? Use $(MKINSTALLDIRS), $(INSTALL_DATA) or
|
||||
$(INSTALL_BIN), $(prefix), and $(DESTDIR).
|
||||
|
||||
Every time a file is installed the commands should look like this:
|
||||
|
||||
========================================
|
||||
install-local:
|
||||
$(MKINSTALLDIRS) $(DESTDIR)$(prefix)/my/dir
|
||||
$(INSTALL_DATA) myfile $(DESTDIR)$(prefix)/my/dir
|
||||
========================================
|
||||
|
||||
This way the directory is created recursively if needed (admittedly, we could
|
||||
probably rely on mkdir -p), the file is given the correct permissions,
|
||||
the user can override $(MKINSTALLDIRS) and $(INSTALL) if they need to,
|
||||
and we can support $(DESTDIR) installs. We use $(DESTDIR) to make
|
||||
monocharge tarballs, and it's useful otherwise, so try and use it
|
||||
consistently.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
* 'make dist'? Use $(DISTFILES)
|
||||
|
||||
The 'dist-default' target will copy the files listed in $(DISTFILES)
|
||||
into the distribution directory, as well as Makefile and ChangeLog if
|
||||
they exist. This is almost always all that you need, so ideally your
|
||||
make dist support should only be:
|
||||
|
||||
========================================
|
||||
DISTFILES = README Test/thoughts.txt
|
||||
|
||||
dist-local: dist-default
|
||||
========================================
|
||||
|
||||
DISTFILES will cope correctly with files in subdirectories, by the
|
||||
way. Note that if you put a nonexistant file or a directory in
|
||||
DISTFILES it will *not* complain; it will just ignore it.
|
||||
|
||||
If you want to test your 'make dist' code, you can try
|
||||
|
||||
========================================
|
||||
$ cd class/Mono.MyClass
|
||||
$ make dist-local distdir=TEST
|
||||
========================================
|
||||
|
||||
And your files should be copied into TEST/ in the current directory.
|
||||
There is a toplevel 'make distcheck' target, which will build a dist
|
||||
tarball, try to build it, install files to a temporary prefix, make
|
||||
clean it, make a distribution, and compare the files left over to the
|
||||
files originally in the tarball: they should be the same. But this
|
||||
takes about 15 minutes to run on my 1.1 Ghz computer, so it's not for
|
||||
the faint of heart.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
* Lots of files? Use $(wildcard *.foo)
|
||||
|
||||
When specifying the sources to a library or executable, wildcards are
|
||||
not encouraged; in fact they're not allowed if you use library.make or
|
||||
executable.make. But there are times when they're useful, eg:
|
||||
|
||||
========================================
|
||||
DISTFILES = $(wildcard Test/*.in) $(wildcard Test/*.out)
|
||||
========================================
|
||||
|
||||
Just so you know that 'make' has this feature.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
* Referencing files in other directories? Use $(topdir).
|
||||
|
||||
$(topdir) is the path to the top directory from the current build
|
||||
directory. Basically it's a sequence of ../.. computed from the value
|
||||
that you give $(thisdir) at the top of your Makefile. Try to reference
|
||||
things from $(topdir), so your code can be moved or cut-and-pasted
|
||||
around with a minimum of fuss.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
* Conditional building? Use ifdef/ifndef/endif
|
||||
|
||||
Now in general we want to avoid conditional building, but sometimes
|
||||
something doesn't work on Linux or already exists on Windows or
|
||||
whatnot. (See below on recommended form for how to build
|
||||
platform-specifically.) GNU Make supports the following construction:
|
||||
|
||||
========================================
|
||||
BUILD_EXPERIMENTAL = yes
|
||||
|
||||
ifdef BUILD_EXPERIMENTAL
|
||||
experimental_stuff = my-experiment.exe
|
||||
else
|
||||
experimental_stuff =
|
||||
endif
|
||||
|
||||
all-local: my-sane.exe $(experimental_stuff)
|
||||
========================================
|
||||
|
||||
'ifdef' means 'if the variable is set to nonempty', so you could have
|
||||
|
||||
========================================
|
||||
BUILD_EXPERIMENTAL = colorless green ideas sleep furiously
|
||||
========================================
|
||||
|
||||
and Make would be happy. I hope that the meaning of 'ifndef' should be
|
||||
obvious. If you want to only sometimes build a target, the above
|
||||
construction is the recommended way to go about it; it's nice to have
|
||||
the rules exist in a Makefile even if they aren't invoked.
|
||||
|
||||
If you want to see why conditionals aren't nice, take a look at
|
||||
library.make or class/corlib/Makefile.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
* 'Private' directories that shouldn't be built by default? Use DIST_ONLY_SUBDIRS
|
||||
|
||||
Several of the MCS class libraries have demo or experimental
|
||||
implementations that depend on things not included with MCS (say,
|
||||
Gtk#). We don't want to build them by default, because the user might
|
||||
not have those dependencies installed, but it's nice to have a
|
||||
Makefile for them to be built nicely.
|
||||
|
||||
First of all, there's nothing stopping you from writing a Makefile for
|
||||
such a directory; just don't put it in the SUBDIRS line of its parent
|
||||
directory. That way, you can do all the normal build things like 'make
|
||||
all' or 'make clean' in that directory, but people trying to bootstrap
|
||||
their system won't run into problems.
|
||||
|
||||
At the same time you probably want to include this directory in the
|
||||
distribution so that people can use your demo or experimental code if
|
||||
they know what they're doing. Hence the variable
|
||||
$(DIST_ONLY_SUBDIRS). As you might guess, it's like the SUBDIRS
|
||||
variable: it lists subdirectories that a regular shouldn't recurse
|
||||
into, but should have their 'make dist' rules invoked.
|
||||
|
||||
Say you've written Mono.MyFancyLib.dll and you have
|
||||
a demo app using Gtk# called MyFancyDemo. The Makefile rules might
|
||||
look like this:
|
||||
|
||||
class/Mono.MyFancyLib/Makefile
|
||||
========================================
|
||||
thisdir = class/Mono.MyFancyLib
|
||||
SUBDIRS =
|
||||
DIST_ONLY_SUBDIRS = MyFancyDemo
|
||||
include ../../build/rules.make
|
||||
|
||||
LIBRARY = Mono.MyFancyLib.dll
|
||||
LIB_MCS_FLAGS = /r:System.dll
|
||||
TEST_MCS_FLAGS = $(LIB_MCS_FLAGS)
|
||||
|
||||
include ../../build/library.make
|
||||
========================================
|
||||
|
||||
class/Mono.MyFancyLib/MyFancyDemo/Makefile
|
||||
========================================
|
||||
thisdir = class/Mono.MyFancyLib/MyFancyDemo
|
||||
SUBDIRS =
|
||||
include ../../../build/rules.make
|
||||
|
||||
PROGRAM = FancyDemo.exe
|
||||
LOCAL_MCS_FLAGS = /r:gtk-sharp.dll
|
||||
|
||||
include ../../../build/executable.make
|
||||
========================================
|
||||
|
||||
|
||||
|
||||
|
||||
* Special recursion needs?
|
||||
|
||||
By default, rules.make defines the all, install, clean, etc. targets
|
||||
to look something like this:
|
||||
|
||||
all: all-recursive
|
||||
$(MAKE) all-local
|
||||
|
||||
Sometimes that doesn't cut it; say for example you want to check for
|
||||
something before doing a lengthy recursive build (see
|
||||
$(topdir)/Makefile) or you have a something like this
|
||||
|
||||
class/MyLibrary:
|
||||
Build MyLibrary.dll
|
||||
class/MyLibrary/Test:
|
||||
Build TestMyLibrary.exe
|
||||
|
||||
'make clean test' will fail here, because the build will happen in
|
||||
the Test subdirectory first, so there will be no MyLibrary.dll to link
|
||||
against. (Unless you write a nasty evil relative path rule which is
|
||||
strongly discouraged.)
|
||||
|
||||
Anyway, to solve this problem you can do
|
||||
|
||||
========================================
|
||||
thisdir = class/MyLibrary
|
||||
SUBDIRS = Test
|
||||
include ../../build/rules.make
|
||||
|
||||
# Normally, make runs 'all-recursive' first, and then 'all-local'
|
||||
# With this, we ensure that 'all-local' is executed first.
|
||||
all-recursive: all-local
|
||||
|
||||
test-recursive: test-local
|
||||
...
|
||||
========================================
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
** A few implementation details
|
||||
|
||||
The way rules.make does its recursion is very standard; it maps
|
||||
{all,install,clean, dist,test} to $@-recursive, which executes that rule
|
||||
in each directory in $(SUBDIRS), and then calls $@-local in the current
|
||||
directory. So something that gets built in a subdirectory cannot rely on
|
||||
something that gets built in its parent directory. If this is a problem,
|
||||
see the previous section. Note that the recursive rule for 'dist' is
|
||||
different; it makes dist-recursive in subdirectories, so you at least
|
||||
have to define that rule.
|
||||
|
||||
Note that even a directory that doesn't, for example, have any tests
|
||||
must still define test-local; otherwise 'make test' run from the
|
||||
toplevel directory will break.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
** Flags for Tools
|
||||
|
||||
We want to make it so that the user can specify certain flags to
|
||||
always be given to a tool, so there's a general way of implementing
|
||||
FLAGS variables:
|
||||
|
||||
* $(foo_FLAGS) remains unset or defaulted to something
|
||||
sensible; the user can provide overrides this way.
|
||||
|
||||
* $(LOCAL_foo_FLAGS) is set in a specific Makefile to
|
||||
provide necessary values.
|
||||
|
||||
* $(PLATFORM_foo_FLAGS) is set in the platform configuration
|
||||
to provide platform-specific values.
|
||||
|
||||
* $(PROFILE_foo_FLAGS) is set in the profile configuration
|
||||
to provide profile-specific values.
|
||||
|
||||
* $(USE_foo_FLAGS) is defined to be the combination of all of
|
||||
the above, and it's what is actually passed to $(foo).
|
||||
|
||||
$(MCS_FLAGS) and $(CFLAGS) follow this model. If you end up finding
|
||||
that another tool is used commonly (hm, jay...), please follow this form.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
** Portability tips
|
||||
|
||||
Always use the icky Windows /argument way of passing parameters to the C#
|
||||
compiler so that csc can be used.
|
||||
|
||||
Always use /r:foo.dll, not /r:foo. Windows requires the former.
|
||||
|
||||
Use /r:$(corlib), not /r:corlib.
|
||||
|
||||
If you're writing shell script code as part of a make rule, remember
|
||||
that Windows has command-line length limits. So something like
|
||||
|
||||
========================================
|
||||
mytool $(all_the_sources_to_corlib)
|
||||
========================================
|
||||
|
||||
Is probably going to cause problems. As I understand it,
|
||||
|
||||
========================================
|
||||
for f in $(all_the_sources_to_corlib) ; do ...
|
||||
========================================
|
||||
|
||||
is ok, since the shell itself doesn't have those limitations. Other
|
||||
than that, you should still try to write fairly portable shell
|
||||
script. Linux and Cygwin both use the GNU utilities, but there's at
|
||||
least one hardy soul trying to build Mono on HP/UX, and no doubt there
|
||||
will be ports to more Unices as time goes on.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
** Misc
|
||||
|
||||
We still don't use /d:NET_1_1 ; it causes some build problems right
|
||||
now.
|
||||
|
||||
There's a hack in class/System.Data/Makefile to work around a very
|
||||
strange crash in the runtime with some custom attribute stuff. It'd be
|
||||
nice to fix it.
|
||||
|
||||
Also, there's a /lib:$(prefix)/lib in the System.dll Makefile, which
|
||||
is for some reason necessary if System.Xml.dll hasn't been built yet.
|
||||
(Well, it's necessary because of the /r:System.Xml.dll, but that
|
||||
should be in the search path, it seems.)
|
||||
|
||||
A lot of the weird targets in the old makefiles have been dropped; I
|
||||
have a feeling that a lot of them are archaic and not needed anymore.
|
||||
|
||||
I'd really like to write a build tool in C#. It would be nice to have
|
||||
something really extensible and well-designed and clean. NAnt is,
|
||||
IMHO, an apalling abomination and a tragically bad attempt at solving
|
||||
the software building problem. Just so you know.
|
||||
|
||||
(On the other hand, NUnit is really neat.)
|
||||
|
||||
Peter
|
||||
@@ -1,747 +0,0 @@
|
||||
# The MCS makefiles
|
||||
|
||||
Author: Peter Williams <peter@newton.cx>
|
||||
|
||||
The new makefiles try to abstract building on Windows and Linux. They
|
||||
try to provide a consistent set of ways to express the things that our
|
||||
build system needs to let us do, specifically:
|
||||
|
||||
* Build recursively
|
||||
* Build libraries and executables easily
|
||||
* Let developers use different runtimes and class libaries
|
||||
* Make distributions easily
|
||||
* Provide a framework for testing
|
||||
* Build platform-independently whenever possible
|
||||
* Generate, update, and build monodoc documentation.
|
||||
|
||||
Makefile structure
|
||||
==================
|
||||
|
||||
A general makefile looks like this:
|
||||
|
||||
```
|
||||
thisdir = class/Mono.My.Library
|
||||
SUBDIRS =
|
||||
include ../../build/rules.make
|
||||
|
||||
all-local:
|
||||
do some stuff
|
||||
|
||||
install-local:
|
||||
$(MKINSTALLDIRS) $(DESTDIR)$(prefix)/share/
|
||||
$(INSTALL_DATA) myfile.txt $(DESTDIR)$(prefix)/share/myfiledir
|
||||
|
||||
clean-local:
|
||||
rm -f my-generated-file
|
||||
|
||||
test-local: my_test_program.exe
|
||||
|
||||
run-test-local:
|
||||
$(RUNTIME) my_test_program.exe
|
||||
|
||||
run-test-ondotnet-local:
|
||||
$(RUNTIME) my_test_program.exe
|
||||
|
||||
DISTFILES = myfile.txt my_test_source.cs
|
||||
|
||||
dist-local: dist-default
|
||||
|
||||
doc-update-local:
|
||||
|
||||
my_test_program.exe: my_test_source.cs
|
||||
$(CSCOMPILE) /target:exe /out:$@ $<
|
||||
```
|
||||
|
||||
Each makefile follows the same pattern: it does some setup, includes
|
||||
the standard make rules, and provides rules for eight standard targets:
|
||||
`all`, `install`, `test`, `run-test`, `clean`, `dist`, and `doc-update`.
|
||||
|
||||
"Some setup" is defining two variables: `$(thisdir)` and
|
||||
`$(SUBDIRS)`. `$(thisdir)` is the directory that the makefile lives in,
|
||||
relative to the top directory (ie, `class/corlib`) and `$(SUBDIRS)`
|
||||
defines the subdirectories that should be built in.
|
||||
|
||||
The eight targets do the following:
|
||||
|
||||
* `all-local` builds whatever someone would expect to be built
|
||||
when they just type `make'` Most likely `Foo.dll` or `Foo.exe`
|
||||
|
||||
* `install-local` installs whatever got built by `all-local`.
|
||||
|
||||
* `test-local` _builds_ the test programs or libraries but does
|
||||
_not_ run them.
|
||||
|
||||
* `run-test-local` actually runs the tests. It shouldn't
|
||||
necessarily exit in an error if the test fails, but should make that
|
||||
situation obvious. It should only run tests that take care of
|
||||
themselves automatically; interactive tests should have an individual
|
||||
target. The idea is that `make run-test` from the toplevel should be
|
||||
able to proceed unsupervised and test everything that can be tested in
|
||||
such a manner.
|
||||
|
||||
* `run-xunit-test-local` this is a variation of the above, but it runs the
|
||||
tests that were built with Xunit instead of NUnit.
|
||||
|
||||
* `run-test-ondotnet-local` is a variant of `run-test-local`. It is used only to validate if our tests themselves works fine under Microsoft runtime (on Windows). Basically, in this target, we should not use $(TEST_RUNTIME) to test our libraries.
|
||||
|
||||
* `clean-local` removes built files; `make clean` should leave
|
||||
only files that go into a distribution tarball. (But it is not
|
||||
necessarily true that all files that go into a tarball need to be left
|
||||
after a make clean.)
|
||||
|
||||
* `dist-local` copies files into the distribution tree, which is
|
||||
given by the variable `$(distdir)`. `dist-local` always depends on the
|
||||
target `dist-default`. See ** `make dist` below.
|
||||
|
||||
* `doc-update-local` should generate or update monodoc documentation,
|
||||
if appropriate. This is usually only appropriate for libraries. It's
|
||||
defined as a standard target so that it can easily be run recursively
|
||||
across all libraries within the module.
|
||||
|
||||
Build configuration
|
||||
===================
|
||||
|
||||
In general, MCS needs to be able to build relying only on the
|
||||
existence of a runtime and core libraries (`mscorlib`, `System`,
|
||||
`System.Xml`). So there shouldn't be any checking for libraries or
|
||||
whatnot; MCS should be able to build out of the box. We try to keep
|
||||
platform detection and feature testing (ie, for HP/UX echo) inside
|
||||
the makefiles; right now, there's no configuration script, and it'd
|
||||
be nice to keep it that way. (I am told that some people build on
|
||||
both Windows and Linux in the same tree, which would be impossible to
|
||||
do if we cached platform-related configury values.)
|
||||
|
||||
That being said, it's very convenient for developers to be able to
|
||||
customize their builds to suit their needs. To allow this, the
|
||||
Makefile rules are set up to allow people to override pretty much any
|
||||
important variable.
|
||||
|
||||
Configuration variables are given defaults in `config-default.make`;
|
||||
`rules.make` optionally includes `$(topdir)/build/config.make`, so you
|
||||
can customize your build without CVS trying to commit your modified
|
||||
`config-default.make` all the time. Platform-specific variables are
|
||||
defined in `$(topdir)/build/platforms/$(BUILD_PLATFORM).make`, where
|
||||
`$(BUILD_PLATFORM)` is detected in `config-default.make`. (Currently, the only
|
||||
choices are `linux.make` and `win32.make`)
|
||||
|
||||
The best way to learn what the configuration variables are is to read
|
||||
`config.make` and `platform.make`. There aren't too many and hopefully
|
||||
they should be self-explanatory; see the numerous examples below for
|
||||
more information if you're confused.
|
||||
|
||||
Recommendations for platform specifics
|
||||
--------------------------------------
|
||||
|
||||
If you find yourself needing a platform-specific customization, try
|
||||
and express it in terms of a feature, rather than a platform test. In
|
||||
other words, this is good:
|
||||
|
||||
```
|
||||
run-test-local: my-test.exe
|
||||
ifdef PLATFORM_NEEDS_CRAZY_CRAP
|
||||
crazy-crap
|
||||
endif
|
||||
$(RUNTIME) my-test.exe
|
||||
```
|
||||
|
||||
and this is bad:
|
||||
|
||||
```
|
||||
run-test-local: my-test.exe
|
||||
ifdef WINDOWS
|
||||
crazy-crap
|
||||
else
|
||||
ifdef AMIGA
|
||||
crazy-crap
|
||||
endif
|
||||
endif
|
||||
$(RUNTIME) my-test.exe
|
||||
```
|
||||
|
||||
The latter accumulates and gets unpleasant and it sucks. Granted,
|
||||
right now we only have two platforms, so it's not a big deal, but it's
|
||||
good form to get used to and practice. Anyway, take a look at how we
|
||||
do the various corlib building hacks for examples of how we've done
|
||||
platform-specificity. It certainly isn't pretty, but at least it's a
|
||||
little structured.
|
||||
|
||||
Saving effort
|
||||
=============
|
||||
|
||||
The point of the build system is to abstract things and take
|
||||
care of all the easy stuff. So if you find yourself writing a
|
||||
Makefile, know that there's probably already infrastructure to do what
|
||||
you want. Here are all the common cases I can think of.
|
||||
|
||||
Compiling C# code? use:
|
||||
-----------------------
|
||||
|
||||
```
|
||||
my-program.exe: my-source.cs
|
||||
$(CSCOMPILE) /target:exe /out:$@ $^
|
||||
```
|
||||
|
||||
or
|
||||
|
||||
```
|
||||
my-lib.dll: my-source.cs
|
||||
$(CSCOMPILE) /target:library /out:$@ $^
|
||||
```
|
||||
|
||||
Note the `$@` and `$^` variables. The former means "the name of the
|
||||
file that I am trying to make" and the latter means "all the
|
||||
dependencies of the file I am trying to make." USE THESE VARIABLES
|
||||
AGGRESSIVELY. Say that you add a new source to your program:
|
||||
|
||||
```
|
||||
my-program.exe: my-source.cs my-new-source.cs
|
||||
$(CSCOMPILE) /target:exe /out:$@ $^
|
||||
```
|
||||
|
||||
Because of the $^ variable, you don't need to remember to add another
|
||||
file to the command line. Similarly, if you rename your program, you
|
||||
won't need to remember to change the rule:
|
||||
|
||||
```
|
||||
MonoVaporizer.exe: my-source.cs my-new-source.cs
|
||||
$(CSCOMPILE) /target:exe /out:$@ $^
|
||||
```
|
||||
|
||||
will still work. Another useful variable is $<, which means "the first
|
||||
dependency of whatever I'm building." If you order your dependencies
|
||||
carefully it can be extremely useful.
|
||||
|
||||
Just building an executable?
|
||||
----------------------------
|
||||
|
||||
Then use:
|
||||
|
||||
```
|
||||
PROGRAM = myprogram.exe
|
||||
LOCAL_MCS_FLAGS = /r:System.Xml.dll
|
||||
|
||||
include ../build/executable.make
|
||||
```
|
||||
|
||||
executable.make builds a program in the current directory. Its name is
|
||||
held in `$(PROGRAM)`, and its sources are listed in the file
|
||||
`$(PROGRAM).sources`. It might seem to make more sense to just list the
|
||||
program's sources in the Makefile, but when we build on Windows we
|
||||
need to change slashes around, which is much easier to do if the
|
||||
sources are listed in a file. The variable `$(LOCAL_MCS_FLAGS)` changes
|
||||
the flags given to the compiler; it is included in `$(CSCOMPILE)` so you
|
||||
don't need to worry about it.
|
||||
|
||||
`executable.make` does a lot for you: it builds the program in 'make
|
||||
all-local', installs the program in `$(prefix)/bin`, distributes the
|
||||
sources, and defines empty test targets. Now, if your program has a
|
||||
test, set the variable `HAS_TEST`:
|
||||
|
||||
```
|
||||
PROGRAM = myprogram.exe
|
||||
LOCAL_MCS_FLAGS = /r:System.Xml.dll
|
||||
HAS_TEST = yes
|
||||
include ../build/executable.make
|
||||
|
||||
test-local: mytester.exe
|
||||
|
||||
run-test-local: mytester.exe
|
||||
$(RUNTIME) $<
|
||||
|
||||
mytester.exe: mytester.cs
|
||||
$(CSCOMPILE) /target:exe /out:$@ mytester.cs
|
||||
```
|
||||
|
||||
If your program has NUnit tests, set the variable `HAS_NUNIT_TEST`:
|
||||
|
||||
```
|
||||
PROGRAM = myprogram.exe
|
||||
LOCAL_MCS_FLAGS = /r:System.Xml.dll
|
||||
HAS_NUNIT_TEST = yes
|
||||
include ../build/executable.make
|
||||
```
|
||||
|
||||
`HAS_NUNIT_TEST` tests follow `library.make` NUnit test conventions:
|
||||
the files should be in a subdirectory called `Test/`, and if
|
||||
your program is called `myprogram.exe`, they should be listed in
|
||||
`myprogram_test.dll.sources`. The names in that files should *not* have
|
||||
the `Test/` prefix. `make test'`will build `myprogram_test_$(PROFILE).dll`
|
||||
in the current directory, automatically supplying the flags to
|
||||
reference the original program and `NUnit.Framework.dll`.
|
||||
|
||||
If your program has 'built sources', that is, source files generated
|
||||
from other files (say, generated by jay), define a variable called
|
||||
`BUILT_SOURCES` and do *not* list the sources in `$(PROGRAM).sources`:
|
||||
|
||||
```
|
||||
PROGRAM = myprogram.exe
|
||||
LOCAL_MCS_FLAGS = /r:System.Xml.dll
|
||||
BUILT_SOURCES = parser.cs
|
||||
CLEAN_FILES = y.output
|
||||
|
||||
include ../build/executable.make
|
||||
|
||||
parser.cs: parser.jay
|
||||
$(topdir)/jay/jay $< > $@
|
||||
```
|
||||
|
||||
`executable.make` will automatically delete the `$(BUILT_SOURCES)` files
|
||||
on `make clean`. Since this situation is a common occurrence and jay
|
||||
happens to leave behind y.output files, you can also define a variable
|
||||
called `$(CLEAN_FILES)` that lists extra files to be deleted when
|
||||
`make clean` is called. (That's in addition to your executable and the built sources).
|
||||
|
||||
Buildling a library? Use
|
||||
------------------------
|
||||
|
||||
```
|
||||
LIBRARY = Mono.MyLib.dll
|
||||
LIB_MCS_FLAGS = /unsafe
|
||||
TEST_MCS_FLAGS = /r:System.Xml.dll
|
||||
|
||||
include ../../build/library.make
|
||||
```
|
||||
|
||||
Where you library is called `$(LIBRARY)`; it will be put into
|
||||
`$(topdir)/class/lib`. `LIB_MCS_FLAGS` is the set of MCS flags to use when
|
||||
compiling the library; in addition, a global set of flags called
|
||||
`$(LIBRARY_FLAGS)` is added (that variable is defined in
|
||||
`config-defaults.make`), as well as the usual `$(LOCAL_MCS_FLAGS)`.
|
||||
|
||||
As in `executable.make`, the sources for your library are listed in
|
||||
`$(LIBRARY).sources`. Note: these source lists should have Unix forward
|
||||
slashes and Unix newlines (\n, not \r\n.) If you get an error about
|
||||
"touch: need a filename", that means your .sources file doesn't end in
|
||||
a newline. It should.
|
||||
|
||||
Now `library.make` also assumes that your library has an NUnit2 test
|
||||
harness. The files should be in a subdirectory called `Test/`, and if
|
||||
your library is called `Mono.Foo.dll`, they should be listed in
|
||||
`Mono.Foo_test.dll.sources`. The names in that files should *not* have
|
||||
the `Test/` prefix. `make test` will build `Mono.Foo_test.dll` in the
|
||||
current directory, automatically supplying the flags to reference the
|
||||
original library and `NUnit.Framework.dll`.
|
||||
|
||||
If you don't have a test, just do this:
|
||||
|
||||
```
|
||||
LIBRARY = Mono.MyLib.dll
|
||||
LIB_MCS_FLAGS = /unsafe
|
||||
NO_TEST = yes
|
||||
|
||||
include ../../build/library.make
|
||||
```
|
||||
|
||||
and feel ashamed. Every good library has a test suite!
|
||||
|
||||
Extra flags needed to compile the test library should be listed in
|
||||
$(TEST_MCS_FLAGS); often you will have a line like this:
|
||||
|
||||
```
|
||||
TEST_MCS_FLAGS = $(LIB_MCS_FLAGS)
|
||||
```
|
||||
|
||||
Again, `library.make` does a lot for you: it builds the dll, it
|
||||
generates makefile fragments to track the dependencies, it installs
|
||||
the library, it builds the test dll on `make test`, it runs
|
||||
`$(TEST_HARNESS)` on it on `make run-test`, it removes the appropriate
|
||||
files on 'make clean', and it distributes all the source files on
|
||||
`make dist`. (`TEST_HARNESS` defaults to be `nunit-console.exe` but it may
|
||||
be overridden to, say, `nunit-gtk`). If you have extra files to
|
||||
distribute when using either `library.make` or `executable.make`, use the
|
||||
variable `$(EXTRA_DISTFILES)`:
|
||||
|
||||
```
|
||||
EXTRA_DISTFILES = \
|
||||
Test/testcase1.in \
|
||||
Test/testcase1.out \
|
||||
README
|
||||
```
|
||||
|
||||
Again, `library.make` and `executable.make` do the right things so that we
|
||||
can build on Windows, doing some trickery to invert slashes and
|
||||
overcome command-line length limitations. Use them unless you have a
|
||||
really good reason not to. If you're building a bunch of small
|
||||
executables, check out `tools/Makefile` or `tools/security/Makefile`; if
|
||||
all the files are in the current directory, changing slashes isn't a
|
||||
big deal, and command-line lengths won't be a problem, so
|
||||
executable.make isn't necessary (and indeed it won't work, since it
|
||||
can only build one .exe in a directory).
|
||||
|
||||
If you're building a library, `library.make` is highly recommended; the
|
||||
only DLL that doesn't use it is corlib, because building corlib is a
|
||||
fair bit more complicated than it should be. Oh well.
|
||||
|
||||
`library.make` also automatically supports generating and updating
|
||||
monodoc documentation. Documentation is stored within the
|
||||
Documentation directory (a sibling to the Test directory), and is
|
||||
generated/updated whenever the doc-update target is executed.
|
||||
Assembling of the documentation so that the monodoc browser can
|
||||
display the documentation is handled separately within the mcs/docs
|
||||
all-local target; see mcs/docs/Makefile for details.
|
||||
|
||||
Running a C# program? Use $(RUNTIME)
|
||||
------------------------------------
|
||||
|
||||
```
|
||||
run-test-local: myprog.exe
|
||||
$(RUNTIME) myprog.exe
|
||||
```
|
||||
|
||||
`$(RUNTIME)` might be empty (if you're on windows), so don't expect to
|
||||
be able to give it any arguments. If you're on a platform which has an
|
||||
interpreter or jitter, $(RUNTIME_FLAGS) is included in $(RUNTIME), so
|
||||
set that variable.
|
||||
|
||||
$(TEST_RUNTIME) is the runtime to use when running tests. Right now it's
|
||||
just "mono --debug".
|
||||
|
||||
|
||||
|
||||
Calling the compiler directly? Use $(MCS).
|
||||
------------------------------------------
|
||||
|
||||
Really, you should use $(CSCOMPILE) whenever possible, but $(MCS) is
|
||||
out there. $(BOOTSTRAP_MCS) is the C# compiler that we use to build
|
||||
mcs.exe; on Linux, we then use mcs.exe to build everything else, but
|
||||
on Windows, we use csc.exe to build everything. Only use
|
||||
$(BOOTSTRAP_MCS) if you know what you're doing.
|
||||
|
||||
Compiling C code? Use $(CCOMPILE)
|
||||
---------------------------------
|
||||
|
||||
To give it flags, set $(LOCAL_CFLAGS). As with compiling C#, the
|
||||
variable $(CFLAGS) will automatically be included on the command line.
|
||||
|
||||
|
||||
Compiling resources with resgen
|
||||
-------------------------------
|
||||
|
||||
If you have a resource that should be compiled with resgen and
|
||||
included in your assembly, you can use the RESOURCES_DEFS variable.
|
||||
This variable can contain lists of pairs that are separated by comma
|
||||
to represent the resource ID as embedded in the assembly followed by
|
||||
the file name, like this:
|
||||
|
||||
RESOURCE_DEFS = Messages,TextResources.resx Errors,ErrorList.txt
|
||||
|
||||
|
||||
Documentation-related needs? Use $(MDOC)
|
||||
----------------------------------------
|
||||
|
||||
$(MDOC) is a front-end to the monodoc documentation system, supporting
|
||||
documentation generation, updating, importing from Microsoft XML
|
||||
Documentation and ECMA documentation formats, assembling documentation
|
||||
for use within the monodoc documentation browser, and exporting
|
||||
documentation to various other output formats such as static HTML.
|
||||
|
||||
It is currently only used for library.make's doc-update-local target
|
||||
and for assembling documentation within $topdir/docs.
|
||||
|
||||
Installing files? Use $(MKINSTALLDIRS), $(INSTALL_DATA) or $(INSTALL_BIN), $(prefix), and $(DESTDIR).
|
||||
-----------------------------------------------------------------------------------------------------
|
||||
|
||||
Every time a file is installed the commands should look like this:
|
||||
|
||||
```
|
||||
install-local:
|
||||
$(MKINSTALLDIRS) $(DESTDIR)$(prefix)/my/dir
|
||||
$(INSTALL_DATA) myfile $(DESTDIR)$(prefix)/my/dir
|
||||
```
|
||||
|
||||
This way the directory is created recursively if needed (admittedly, we could
|
||||
probably rely on mkdir -p), the file is given the correct permissions,
|
||||
the user can override $(MKINSTALLDIRS) and $(INSTALL) if they need to,
|
||||
and we can support $(DESTDIR) installs. We use $(DESTDIR) to make
|
||||
monocharge tarballs, and it's useful otherwise, so try and use it
|
||||
consistently.
|
||||
|
||||
'make dist'? Use $(DISTFILES)
|
||||
-----------------------------
|
||||
|
||||
The 'dist-default' target will copy the files listed in $(DISTFILES)
|
||||
into the distribution directory, as well as Makefile and ChangeLog if
|
||||
they exist. This is almost always all that you need, so ideally your
|
||||
make dist support should only be:
|
||||
|
||||
```
|
||||
DISTFILES = README Test/thoughts.txt
|
||||
|
||||
dist-local: dist-default
|
||||
```
|
||||
|
||||
DISTFILES will cope correctly with files in subdirectories, by the
|
||||
way. Note that if you put a nonexistant file or a directory in
|
||||
DISTFILES it will *not* complain; it will just ignore it.
|
||||
|
||||
If you want to test your 'make dist' code, you can try
|
||||
|
||||
```
|
||||
$ cd class/Mono.MyClass
|
||||
$ make dist-local distdir=TEST
|
||||
```
|
||||
|
||||
And your files should be copied into TEST/ in the current directory.
|
||||
There is a toplevel 'make distcheck' target, which will build a dist
|
||||
tarball, try to build it, install files to a temporary prefix, make
|
||||
clean it, make a distribution, and compare the files left over to the
|
||||
files originally in the tarball: they should be the same. But this
|
||||
takes about 15 minutes to run on my 1.1 Ghz computer, so it's not for
|
||||
the faint of heart.
|
||||
|
||||
Lots of files? Use $(wildcard *.foo)
|
||||
------------------------------------
|
||||
|
||||
When specifying the sources to a library or executable, wildcards are
|
||||
not encouraged; in fact they're not allowed if you use library.make or
|
||||
executable.make. But there are times when they're useful, eg:
|
||||
|
||||
```
|
||||
DISTFILES = $(wildcard Test/*.in) $(wildcard Test/*.out)
|
||||
```
|
||||
|
||||
Just so you know that `make` has this feature.
|
||||
|
||||
Referencing files in other directories? Use $(topdir).
|
||||
------------------------------------------------------
|
||||
|
||||
$(topdir) is the path to the top directory from the current build
|
||||
directory. Basically it's a sequence of ../.. computed from the value
|
||||
that you give $(thisdir) at the top of your Makefile. Try to reference
|
||||
things from $(topdir), so your code can be moved or cut-and-pasted
|
||||
around with a minimum of fuss.
|
||||
|
||||
Conditional building? Use ifdef/ifndef/endif
|
||||
--------------------------------------------
|
||||
|
||||
Now in general we want to avoid conditional building, but sometimes
|
||||
something doesn't work on Linux or already exists on Windows or
|
||||
whatnot. (See below on recommended form for how to build
|
||||
platform-specifically.) GNU Make supports the following construction:
|
||||
|
||||
```
|
||||
BUILD_EXPERIMENTAL = yes
|
||||
|
||||
ifdef BUILD_EXPERIMENTAL
|
||||
experimental_stuff = my-experiment.exe
|
||||
else
|
||||
experimental_stuff =
|
||||
endif
|
||||
|
||||
all-local: my-sane.exe $(experimental_stuff)
|
||||
```
|
||||
|
||||
'ifdef' means 'if the variable is set to nonempty', so you could have
|
||||
|
||||
```
|
||||
BUILD_EXPERIMENTAL = colorless green ideas sleep furiously
|
||||
```
|
||||
|
||||
and Make would be happy. I hope that the meaning of 'ifndef' should be
|
||||
obvious. If you want to only sometimes build a target, the above
|
||||
construction is the recommended way to go about it; it's nice to have
|
||||
the rules exist in a Makefile even if they aren't invoked.
|
||||
|
||||
If you want to see why conditionals aren't nice, take a look at
|
||||
library.make or class/corlib/Makefile.
|
||||
|
||||
|
||||
'Private' directories that shouldn't be built by default? Use DIST_ONLY_SUBDIRS
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
Several of the MCS class libraries have demo or experimental
|
||||
implementations that depend on things not included with MCS (say,
|
||||
Gtk#). We don't want to build them by default, because the user might
|
||||
not have those dependencies installed, but it's nice to have a
|
||||
Makefile for them to be built nicely.
|
||||
|
||||
First of all, there's nothing stopping you from writing a Makefile for
|
||||
such a directory; just don't put it in the SUBDIRS line of its parent
|
||||
directory. That way, you can do all the normal build things like 'make
|
||||
all' or 'make clean' in that directory, but people trying to bootstrap
|
||||
their system won't run into problems.
|
||||
|
||||
At the same time you probably want to include this directory in the
|
||||
distribution so that people can use your demo or experimental code if
|
||||
they know what they're doing. Hence the variable
|
||||
$(DIST_ONLY_SUBDIRS). As you might guess, it's like the SUBDIRS
|
||||
variable: it lists subdirectories that a regular shouldn't recurse
|
||||
into, but should have their 'make dist' rules invoked.
|
||||
|
||||
Say you've written Mono.MyFancyLib.dll and you have
|
||||
a demo app using Gtk# called MyFancyDemo. The Makefile rules might
|
||||
look like this:
|
||||
|
||||
class/Mono.MyFancyLib/Makefile
|
||||
```
|
||||
thisdir = class/Mono.MyFancyLib
|
||||
SUBDIRS =
|
||||
DIST_ONLY_SUBDIRS = MyFancyDemo
|
||||
include ../../build/rules.make
|
||||
|
||||
LIBRARY = Mono.MyFancyLib.dll
|
||||
LIB_MCS_FLAGS = /r:System.dll
|
||||
TEST_MCS_FLAGS = $(LIB_MCS_FLAGS)
|
||||
|
||||
include ../../build/library.make
|
||||
```
|
||||
|
||||
class/Mono.MyFancyLib/MyFancyDemo/Makefile
|
||||
```
|
||||
thisdir = class/Mono.MyFancyLib/MyFancyDemo
|
||||
SUBDIRS =
|
||||
include ../../../build/rules.make
|
||||
|
||||
PROGRAM = FancyDemo.exe
|
||||
LOCAL_MCS_FLAGS = /r:gtk-sharp.dll
|
||||
|
||||
include ../../../build/executable.make
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
Special recursion needs?
|
||||
------------------------
|
||||
|
||||
By default, rules.make defines the all, install, clean, etc. targets
|
||||
to look something like this:
|
||||
|
||||
```
|
||||
all: all-recursive
|
||||
$(MAKE) all-local
|
||||
```
|
||||
|
||||
Sometimes that doesn't cut it; say for example you want to check for
|
||||
something before doing a lengthy recursive build (see
|
||||
$(topdir)/Makefile) or you have a something like this
|
||||
|
||||
```
|
||||
class/MyLibrary:
|
||||
Build MyLibrary.dll
|
||||
class/MyLibrary/Test:
|
||||
Build TestMyLibrary.exe
|
||||
```
|
||||
|
||||
`make clean test` will fail here, because the build will happen in
|
||||
the Test subdirectory first, so there will be no `MyLibrary.dll` to link
|
||||
against. (Unless you write a nasty evil relative path rule which is
|
||||
strongly discouraged.)
|
||||
|
||||
Anyway, to solve this problem you can do
|
||||
|
||||
```
|
||||
thisdir = class/MyLibrary
|
||||
SUBDIRS = Test
|
||||
include ../../build/rules.make
|
||||
|
||||
# Normally, make runs 'all-recursive' first, and then 'all-local'
|
||||
# With this, we ensure that 'all-local' is executed first.
|
||||
all-recursive: all-local
|
||||
|
||||
test-recursive: test-local
|
||||
...
|
||||
```
|
||||
|
||||
|
||||
A few implementation details
|
||||
----------------------------
|
||||
|
||||
The way rules.make does its recursion is very standard; it maps
|
||||
`{all,install,clean,dist,test}` to `$@-recursive`, which executes that rule
|
||||
in each directory in `$(SUBDIRS)`, and then calls `$@-local` bin the current
|
||||
directory. So something that gets built in a subdirectory cannot rely on
|
||||
something that gets built in its parent directory. If this is a problem,
|
||||
see the previous section. Note that the recursive rule for 'dist' is
|
||||
different; it makes dist-recursive in subdirectories, so you at least
|
||||
have to define that rule.
|
||||
|
||||
Note that even a directory that doesn't, for example, have any tests
|
||||
must still define test-local; otherwise 'make test' run from the
|
||||
toplevel directory will break.
|
||||
|
||||
Flags for Tools
|
||||
---------------
|
||||
|
||||
We want to make it so that the user can specify certain flags to
|
||||
always be given to a tool, so there's a general way of implementing
|
||||
FLAGS variables:
|
||||
|
||||
* `$(foo_FLAGS)` remains unset or defaulted to something
|
||||
sensible; the user can provide overrides this way.
|
||||
|
||||
* `$(LOCAL_foo_FLAGS)` is set in a specific Makefile to
|
||||
provide necessary values.
|
||||
|
||||
* `$(PLATFORM_foo_FLAGS)` is set in the platform configuration
|
||||
to provide platform-specific values.
|
||||
|
||||
* `$(PROFILE_foo_FLAGS)` is set in the profile configuration
|
||||
to provide profile-specific values.
|
||||
|
||||
* `$(USE_foo_FLAGS)` is defined to be the combination of all of
|
||||
the above, and it's what is actually passed to $(foo).
|
||||
|
||||
`$(MCS_FLAGS)` and `$(CFLAGS)` follow this model. If you end up finding
|
||||
that another tool is used commonly (hm, jay...), please follow this form.
|
||||
|
||||
Portability tips
|
||||
----------------
|
||||
|
||||
Always use the icky Windows /argument way of passing parameters to the C#
|
||||
compiler so that csc can be used.
|
||||
|
||||
Always use `/r:foo.dll`, not `/r:foo`. Windows requires the former.
|
||||
|
||||
Use `/r:$(corlib)`, not `/r:corlib`.
|
||||
|
||||
If you're writing shell script code as part of a make rule, remember
|
||||
that Windows has command-line length limits. So something like
|
||||
|
||||
```
|
||||
mytool $(all_the_sources_to_corlib)
|
||||
```
|
||||
|
||||
Is probably going to cause problems. As I understand it,
|
||||
|
||||
```
|
||||
for f in $(all_the_sources_to_corlib) ; do ...
|
||||
```
|
||||
|
||||
is ok, since the shell itself doesn't have those limitations. Other
|
||||
than that, you should still try to write fairly portable shell
|
||||
script. Linux and Cygwin both use the GNU utilities, but there's at
|
||||
least one hardy soul trying to build Mono on HP/UX, and no doubt there
|
||||
will be ports to more Unices as time goes on.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Misc
|
||||
----
|
||||
|
||||
We still don't use `/d:NET_1_1`; it causes some build problems right
|
||||
now.
|
||||
|
||||
There's a hack in class/System.Data/Makefile to work around a very
|
||||
strange crash in the runtime with some custom attribute stuff. It'd be
|
||||
nice to fix it.
|
||||
|
||||
Also, there's a /lib:$(prefix)/lib in the System.dll Makefile, which
|
||||
is for some reason necessary if System.Xml.dll hasn't been built yet.
|
||||
(Well, it's necessary because of the /r:System.Xml.dll, but that
|
||||
should be in the search path, it seems.)
|
||||
|
||||
A lot of the weird targets in the old makefiles have been dropped; I
|
||||
have a feeling that a lot of them are archaic and not needed anymore.
|
||||
|
||||
I'd really like to write a build tool in C#. It would be nice to have
|
||||
something really extensible and well-designed and clean. NAnt is,
|
||||
IMHO, an apalling abomination and a tragically bad attempt at solving
|
||||
the software building problem. Just so you know.
|
||||
|
||||
(On the other hand, NUnit is really neat.)
|
||||
|
||||
Peter
|
||||
@@ -38,7 +38,7 @@ static class Consts
|
||||
public const string MonoCompany = "Mono development team";
|
||||
public const string MonoProduct = "Mono Common Language Infrastructure";
|
||||
public const string MonoCopyright = "(c) Various Mono authors";
|
||||
public const string MonoCorlibVersion = "@MONO_CORLIB_VERSION@";
|
||||
public const int MonoCorlibVersion = @MONO_CORLIB_VERSION@;
|
||||
|
||||
#if MOBILE
|
||||
// Versions of .NET Framework for Silverlight 4.0
|
||||
|
||||
@@ -45,8 +45,6 @@ static partial class SR
|
||||
{
|
||||
return string.Format (CultureInfo.InvariantCulture, resourceFormat, p1, p2, p3);
|
||||
}
|
||||
|
||||
internal static string GetResourceString (string str) => str;
|
||||
}
|
||||
|
||||
#if !INSIDE_CORLIB
|
||||
|
||||
@@ -1,13 +1,14 @@
|
||||
using System;
|
||||
|
||||
interface II
|
||||
{
|
||||
|
||||
}
|
||||
|
||||
class X
|
||||
{
|
||||
static void Foo (II a = default (II), II b = default, II c = (II) null)
|
||||
class X {
|
||||
// Check installed compiler
|
||||
static void Generic<T> ()
|
||||
{
|
||||
// we use 'var' all around in the compiler sources
|
||||
var x = new X ();
|
||||
}
|
||||
|
||||
void DefaultParametersAvailable (int i = 3)
|
||||
{
|
||||
}
|
||||
|
||||
@@ -41,9 +42,9 @@ class X
|
||||
|
||||
Version min_mono_version;
|
||||
#if __MonoCS__
|
||||
min_mono_version = new Version (5, 19);
|
||||
min_mono_version = new Version (5, 5);
|
||||
#else
|
||||
min_mono_version = new Version (5, 10);
|
||||
min_mono_version = new Version (4, 9);
|
||||
#endif
|
||||
|
||||
if (version < min_mono_version)
|
||||
|
||||
@@ -10,17 +10,9 @@
|
||||
CODEPAGE = 65001
|
||||
|
||||
RUNTIME_FLAGS =
|
||||
|
||||
ifdef TEST_WITH_INTERPRETER
|
||||
TEST_RUNTIME_FLAGS = --interpreter
|
||||
else
|
||||
TEST_RUNTIME_FLAGS =
|
||||
endif
|
||||
|
||||
TEST_HARNESS = $(topdir)/class/lib/$(PROFILE_DIRECTORY)/$(PARENT_PROFILE)nunit-lite-console.exe
|
||||
PLATFORM_DEBUG_FLAGS = /debug:portable
|
||||
# Workaround for https://bugzilla.xamarin.com/show_bug.cgi?id=59967
|
||||
MCS_FLAGS = /features:peverify-compat /langversion:latest
|
||||
MCS_FLAGS =
|
||||
MBAS_FLAGS = -debug
|
||||
LIBRARY_FLAGS =
|
||||
ifndef CFLAGS
|
||||
@@ -32,10 +24,7 @@ mono_libdir = $(exec_prefix)/lib
|
||||
sysconfdir = $(prefix)/etc
|
||||
#RUNTIME = mono
|
||||
RUNTIME = false
|
||||
MONO_PATH_TOP = $(topdir)/class/lib/$(PROFILE_DIRECTORY)/
|
||||
MONO_PATH_TESTS = $(MONO_PATH_TOP)/tests
|
||||
TEST_MONO_PATH = $(MONO_PATH_TOP)$(PLATFORM_PATH_SEPARATOR)$(MONO_PATH_TESTS)
|
||||
TEST_RUNTIME = MONO_PATH="$(TEST_MONO_PATH)$(PLATFORM_PATH_SEPARATOR).$(PLATFORM_PATH_SEPARATOR)$$MONO_PATH" $(RUNTIME) --debug
|
||||
TEST_RUNTIME = MONO_PATH="./$(PLATFORM_PATH_SEPARATOR)$(topdir)/class/lib/$(PROFILE_DIRECTORY)$(PLATFORM_PATH_SEPARATOR)$(TEST_MONO_PATH)$(PLATFORM_PATH_SEPARATOR)$$MONO_PATH" $(RUNTIME) --debug
|
||||
|
||||
# In case you want to add MCS_FLAGS, this lets you not have to
|
||||
# keep track of the default value
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
API_INFO = $(MONO_PATH) $(RUNTIME) $(topdir)/class/lib/$(PROFILE)/mono-api-info.exe
|
||||
API_DIFF = $(MONO_PATH) $(RUNTIME) $(topdir)/class/lib/$(PROFILE)/mono-api-diff.exe
|
||||
API_DIFF = $(MONO_PATH) $(RUNTIME) $(topdir)/tools/corcompare/mono-api-diff.exe
|
||||
TRANSFORM = $(MONO_PATH) $(RUNTIME) $(topdir)/tools/corcompare/transform.exe
|
||||
|
||||
OBJECTS = $(topdir)/build/corcompare/$(LIBRARY_NAME:.dll=.html)
|
||||
|
||||
@@ -42,17 +42,15 @@ executable_CLEAN_FILES += $(build_lib) $(build_lib).so $(build_lib).mdb $(build_
|
||||
|
||||
makefrag = $(depsdir)/$(PROFILE)_$(base_prog).makefrag
|
||||
|
||||
LIB_REFS_ALL = $(DEFAULT_REFERENCES) $(LIB_REFS)
|
||||
|
||||
ifdef TARGET_NET_REFERENCE
|
||||
# System*, mscorlib references come from the TARGET_NET_REFERENCE dir, others from the profile dir
|
||||
LIB_REFS_MONO = $(call _FILTER_OUT,System,$(call _FILTER_OUT,mscorlib,$(LIB_REFS_ALL)))
|
||||
LIB_REFS_SYSTEM = $(filter-out $(LIB_REFS_MONO),$(LIB_REFS_ALL))
|
||||
# System.*.dll references come from the TARGET_NET_REFERENCE dir, others from the profile dir
|
||||
LIB_REFS_MONO = $(call _FILTER_OUT,System,$(LIB_REFS))
|
||||
LIB_REFS_SYSTEM = $(filter-out $(LIB_REFS_MONO),$(LIB_REFS))
|
||||
|
||||
MCS_REFERENCES = $(patsubst %,-r:$(topdir)/../external/binary-reference-assemblies/$(TARGET_NET_REFERENCE)/%.dll,$(LIB_REFS_SYSTEM))
|
||||
MCS_REFERENCES += $(patsubst %,-r:$(topdir)/class/lib/$(PROFILE_DIRECTORY)/%.dll,$(LIB_REFS_MONO))
|
||||
else
|
||||
MCS_REFERENCES = $(patsubst %,-r:$(topdir)/class/lib/$(PROFILE_DIRECTORY)/%.dll,$(LIB_REFS_ALL))
|
||||
MCS_REFERENCES = $(patsubst %,-r:$(topdir)/class/lib/$(PROFILE_DIRECTORY)/%.dll,$(LIB_REFS))
|
||||
endif
|
||||
|
||||
ifdef KEYFILE
|
||||
@@ -191,7 +189,6 @@ csproj-local:
|
||||
echo $(thisdir):$$config_file >> $(topdir)/../msvc/scripts/order; \
|
||||
(echo $(is_boot); \
|
||||
echo $(USE_MCS_FLAGS) $(LIBRARY_FLAGS) $(LIB_MCS_FLAGS) $(patsubst %,-r:%,$(LIB_REFS)); \
|
||||
echo $(sourcefile); \
|
||||
echo $(PROGRAM); \
|
||||
echo $(BUILT_SOURCES_cmdline); \
|
||||
echo $(build_lib); \
|
||||
|
||||
@@ -1,710 +0,0 @@
|
||||
using System;
|
||||
using System.Text;
|
||||
using System.Collections.Generic;
|
||||
using System.IO;
|
||||
using System.Linq;
|
||||
using System.Reflection;
|
||||
|
||||
public static class Program {
|
||||
public static int Main (string[] _args) {
|
||||
var args = new List<string> (_args);
|
||||
bool useStdout = false, showHelp = false, strictMode = false;
|
||||
string baseDir = null;
|
||||
|
||||
for (int i = 0; i < args.Count; i++) {
|
||||
var arg = args[i];
|
||||
if (!arg.StartsWith ("-"))
|
||||
continue;
|
||||
|
||||
string argValue = null;
|
||||
var offset = arg.IndexOf(':');
|
||||
if (offset >= 0) {
|
||||
argValue = arg.Substring (offset + 1);
|
||||
arg = arg.Substring (0, offset);
|
||||
}
|
||||
|
||||
switch (arg) {
|
||||
case "-?":
|
||||
case "--help":
|
||||
case "-h":
|
||||
showHelp = true;
|
||||
break;
|
||||
case "--trace":
|
||||
if (argValue != null)
|
||||
SourcesParser.TraceLevel = int.Parse(argValue);
|
||||
else
|
||||
SourcesParser.TraceLevel = 1;
|
||||
break;
|
||||
case "--stdout":
|
||||
useStdout = true;
|
||||
break;
|
||||
case "--strict":
|
||||
strictMode = true;
|
||||
break;
|
||||
case "--basedir":
|
||||
baseDir = argValue;
|
||||
break;
|
||||
default:
|
||||
Console.Error.WriteLine ($"// Unrecognized switch {arg}. Aborting.");
|
||||
return 1;
|
||||
}
|
||||
|
||||
args.RemoveAt (i);
|
||||
i--;
|
||||
}
|
||||
|
||||
if ((args.Count < 3) || (args.Count > 4))
|
||||
showHelp = true;
|
||||
|
||||
if (showHelp) {
|
||||
Console.Error.WriteLine ("Usage: mcs/build/gensources.exe [options] (outputFileName|--stdout) libraryDirectoryAndName platformName profileName");
|
||||
Console.Error.WriteLine ("or mcs/build/gensources.exe [options] (outputFileName|--stdout) (--baseDir:<dir>) sourcesFile exclusionsFile");
|
||||
Console.Error.WriteLine ("You can specify * for platformName and profileName to read all sources files");
|
||||
Console.Error.WriteLine ("Available options:");
|
||||
Console.Error.WriteLine ("--help -h -?");
|
||||
Console.Error.WriteLine (" Show command line info");
|
||||
Console.Error.WriteLine ("--trace:n");
|
||||
Console.Error.WriteLine (" Enable diagnostic output, at tracing level n (1-4)");
|
||||
Console.Error.WriteLine ("--stdout");
|
||||
Console.Error.WriteLine (" Writes results to standard output (omit outputFileName if you use this)");
|
||||
Console.Error.WriteLine ("--strict");
|
||||
Console.Error.WriteLine (" Produces an error exit code if files or directories are invalid/missing or other warnings occur");
|
||||
Console.Error.WriteLine ("--basedir:<dir>");
|
||||
Console.Error.WriteLine (" Sets the base directory when reading a single sources/exclusions pair (default is the directory containing the sources file)");
|
||||
return 1;
|
||||
}
|
||||
|
||||
var myAssembly = Assembly.GetExecutingAssembly ();
|
||||
var codeBase = new Uri (myAssembly.CodeBase);
|
||||
var executablePath = Path.GetFullPath (codeBase.LocalPath);
|
||||
var executableDirectory = Path.GetDirectoryName (executablePath);
|
||||
|
||||
var outFile = Path.GetFullPath (args[0]);
|
||||
|
||||
var platformsFolder = Path.Combine (executableDirectory, "platforms");
|
||||
var profilesFolder = Path.Combine (executableDirectory, "profiles");
|
||||
if (!Directory.Exists (platformsFolder) || !Directory.Exists (profilesFolder)) {
|
||||
Console.Error.WriteLine ($"// Platforms and/or profiles folders are missing: '{platformsFolder}' '{profilesFolder}'. Aborting.");
|
||||
return 1;
|
||||
}
|
||||
|
||||
var parser = new SourcesParser (platformsFolder, profilesFolder);
|
||||
|
||||
ParseResult result;
|
||||
|
||||
if (args.Count == 3) {
|
||||
var sourcesFile = Path.GetFullPath (args[1]);
|
||||
var excludesFile = Path.GetFullPath (args[2]);
|
||||
var directory = Path.GetDirectoryName (sourcesFile);
|
||||
if ((Path.GetDirectoryName (excludesFile) != directory) && (baseDir == null)) {
|
||||
Console.Error.WriteLine ("// Sources and exclusions files are in different directories. Aborting.");
|
||||
return 1;
|
||||
}
|
||||
|
||||
result = parser.Parse (baseDir ?? directory, sourcesFile, excludesFile);
|
||||
|
||||
if (SourcesParser.TraceLevel > 0)
|
||||
Console.Error.WriteLine ($"// Writing sources from {sourcesFile} minus {excludesFile}, to {outFile}.");
|
||||
} else if (args.Count == 4) {
|
||||
if (baseDir != null)
|
||||
Console.Error.WriteLine ($"// WARNING: baseDir has no effect in this mode");
|
||||
|
||||
var libraryFullName = Path.GetFullPath (args[1]);
|
||||
var platformName = args[2].Trim ();
|
||||
var profileName = args[3].Trim ();
|
||||
var libraryDirectory = Path.GetDirectoryName (libraryFullName);
|
||||
var libraryName = Path.GetFileName (libraryFullName);
|
||||
result = parser.Parse (libraryDirectory, libraryName, platformName, profileName);
|
||||
|
||||
if (SourcesParser.TraceLevel > 0)
|
||||
Console.Error.WriteLine ($"// Writing sources for platform {platformName} and profile {profileName}, relative to {libraryDirectory}, to {outFile}.");
|
||||
} else {
|
||||
throw new Exception ();
|
||||
}
|
||||
|
||||
var fileNames = result.GetMatches ()
|
||||
.OrderBy (e => e.RelativePath, StringComparer.Ordinal)
|
||||
.Select (e => e.RelativePath)
|
||||
.Distinct ()
|
||||
.ToList ();
|
||||
|
||||
var unexpectedEmptyResult = (fileNames.Count == 0);
|
||||
|
||||
// HACK: We have sources files that are literally empty, so as long as *some* sources files were
|
||||
// parsed during this invocation and they are all empty, producing no matching file names is not
|
||||
// an error.
|
||||
if ((result.SourcesFiles.Count > 0) && result.SourcesFiles.Values.All(sf => sf.Sources.Count == 0))
|
||||
unexpectedEmptyResult = false;
|
||||
|
||||
if ((result.ErrorCount > 0) || unexpectedEmptyResult) {
|
||||
Console.Error.WriteLine ($"// gensources produced {result.ErrorCount} error(s) and a set of {fileNames.Count} filename(s)");
|
||||
Console.Error.WriteLine ($"// Invoked with '{Environment.CommandLine}'");
|
||||
Console.Error.WriteLine ($"// Working directory was '{Environment.CurrentDirectory}'");
|
||||
|
||||
if (strictMode) {
|
||||
// HACK: Make ignores non-zero exit codes so we need to delete the sources file ???
|
||||
if (!useStdout && File.Exists (outFile))
|
||||
File.Delete (outFile);
|
||||
|
||||
return result.ErrorCount + 1;
|
||||
}
|
||||
}
|
||||
|
||||
TextWriter output;
|
||||
if (useStdout)
|
||||
output = Console.Out;
|
||||
else
|
||||
output = new StreamWriter (outFile);
|
||||
|
||||
using (output) {
|
||||
foreach (var fileName in fileNames)
|
||||
output.WriteLine (fileName);
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
public class SourcesFile {
|
||||
public readonly string FileName;
|
||||
public readonly bool IsExclusion;
|
||||
|
||||
public readonly List<ParseEntry> Sources = new List<ParseEntry> ();
|
||||
public readonly List<ParseEntry> Exclusions = new List<ParseEntry> ();
|
||||
public readonly List<SourcesFile> Includes = new List<SourcesFile> ();
|
||||
|
||||
public SourcesFile (string fileName, bool isExclusion) {
|
||||
FileName = fileName;
|
||||
IsExclusion = isExclusion;
|
||||
}
|
||||
}
|
||||
|
||||
public struct ParseEntry {
|
||||
public string Directory;
|
||||
public string Pattern;
|
||||
}
|
||||
|
||||
public struct MatchEntry {
|
||||
public SourcesFile SourcesFile;
|
||||
public string RelativePath;
|
||||
}
|
||||
|
||||
public class TargetParseResult {
|
||||
public (string hostPlatform, string profile) Key;
|
||||
public SourcesFile Sources, Exclusions;
|
||||
public bool IsFallback;
|
||||
|
||||
public override string ToString () {
|
||||
var fallbackString = IsFallback ? " fallback" : "";
|
||||
return $"{Key}{fallbackString} -> [{Sources?.FileName}, {Exclusions?.FileName}]";
|
||||
}
|
||||
}
|
||||
|
||||
public class ParseResult {
|
||||
public readonly string LibraryDirectory;
|
||||
|
||||
public readonly Dictionary<(string hostPlatform, string profile), TargetParseResult> TargetDictionary = new Dictionary<(string hostPlatform, string profile), TargetParseResult> ();
|
||||
|
||||
public readonly Dictionary<string, SourcesFile> SourcesFiles = new Dictionary<string, SourcesFile> ();
|
||||
public readonly Dictionary<string, SourcesFile> ExclusionFiles = new Dictionary<string, SourcesFile> ();
|
||||
|
||||
// FIXME: This is a bad spot for this value but enumerators don't have outparam support
|
||||
public int ErrorCount = 0;
|
||||
|
||||
public ParseResult (string libraryDirectory) {
|
||||
LibraryDirectory = Path.GetFullPath (libraryDirectory);
|
||||
}
|
||||
|
||||
public IEnumerable<TargetParseResult> Targets {
|
||||
get {
|
||||
return TargetDictionary.Values;
|
||||
}
|
||||
}
|
||||
|
||||
private string GetRelativePath (string fullPath, string relativeToDirectory) {
|
||||
fullPath = fullPath.Replace ("\\", "/");
|
||||
relativeToDirectory = relativeToDirectory.Replace ("\\", "/");
|
||||
|
||||
if (!relativeToDirectory.EndsWith ("/"))
|
||||
relativeToDirectory += "/";
|
||||
|
||||
try {
|
||||
var dirUri = new Uri (relativeToDirectory);
|
||||
var pathUri = new Uri (fullPath);
|
||||
|
||||
var relativePath = Uri.UnescapeDataString (
|
||||
dirUri.MakeRelativeUri (pathUri).OriginalString
|
||||
).Replace ("/", SourcesParser.DirectorySeparator)
|
||||
.Replace (SourcesParser.DirectorySeparator + SourcesParser.DirectorySeparator, SourcesParser.DirectorySeparator);
|
||||
|
||||
return relativePath;
|
||||
} catch (Exception) {
|
||||
Console.Error.WriteLine ($"// Parse error when treating '{fullPath}' as a URI relative to directory '{relativeToDirectory}'");
|
||||
ErrorCount += 1;
|
||||
return fullPath;
|
||||
}
|
||||
|
||||
/*
|
||||
if (SourcesParser.TraceLevel >= 4)
|
||||
Console.Error.WriteLine ($"// {fullPath} -> {relativePath}");
|
||||
*/
|
||||
}
|
||||
|
||||
public IEnumerable<MatchEntry> EnumerateMatches (
|
||||
SourcesFile sourcesFile,
|
||||
IEnumerable<ParseEntry> entries,
|
||||
bool forExclusionsList
|
||||
) {
|
||||
var patternChars = new [] { '*', '?' };
|
||||
|
||||
var isFirstError = true;
|
||||
|
||||
foreach (var entry in entries) {
|
||||
var absolutePath = Path.GetFullPath (Path.Combine (entry.Directory, entry.Pattern));
|
||||
var absoluteDirectory = Path.GetDirectoryName (absolutePath);
|
||||
var absolutePattern = Path.GetFileName (absolutePath);
|
||||
|
||||
if (SourcesParser.TraceLevel >= 4) {
|
||||
if ((absolutePattern != entry.Pattern) || (absoluteDirectory != entry.Directory))
|
||||
Console.Error.WriteLine ($"// {entry.Directory} / {entry.Pattern} -> {absoluteDirectory} / {absolutePattern}");
|
||||
}
|
||||
|
||||
if (!Directory.Exists (absoluteDirectory)) {
|
||||
if (isFirstError) {
|
||||
isFirstError = false;
|
||||
Console.Error.WriteLine ($"// Error(s) in file {sourcesFile.FileName}:");
|
||||
}
|
||||
|
||||
if (forExclusionsList) {
|
||||
Console.Error.WriteLine ($"(ignored) Directory does not exist: '{Path.GetFullPath (absoluteDirectory)}'");
|
||||
} else {
|
||||
Console.Error.WriteLine ($"Directory does not exist: '{Path.GetFullPath (absoluteDirectory)}'");
|
||||
ErrorCount += 1;
|
||||
}
|
||||
continue;
|
||||
}
|
||||
|
||||
if (absolutePattern.IndexOfAny (patternChars) >= 0) {
|
||||
var matchingFiles = Directory.GetFiles (absoluteDirectory, absolutePattern);
|
||||
if (matchingFiles.Length == 0) {
|
||||
if (SourcesParser.TraceLevel > 0)
|
||||
Console.Error.WriteLine ($"// No matches for pattern '{absolutePattern}'");
|
||||
}
|
||||
|
||||
foreach (var fileName in matchingFiles) {
|
||||
var relativePath = GetRelativePath (fileName, LibraryDirectory);
|
||||
yield return new MatchEntry {
|
||||
SourcesFile = sourcesFile,
|
||||
RelativePath = relativePath,
|
||||
};
|
||||
}
|
||||
} else {
|
||||
if (!File.Exists (absolutePath)) {
|
||||
if (isFirstError) {
|
||||
isFirstError = false;
|
||||
Console.Error.WriteLine ($"// Error(s) in file {sourcesFile.FileName}:");
|
||||
}
|
||||
|
||||
if (forExclusionsList) {
|
||||
Console.Error.WriteLine ($"(ignored) File does not exist: '{absolutePath}'");
|
||||
} else {
|
||||
Console.Error.WriteLine ($"File does not exist: '{absolutePath}'");
|
||||
ErrorCount += 1;
|
||||
}
|
||||
} else {
|
||||
var relativePath = GetRelativePath (absolutePath, LibraryDirectory);
|
||||
yield return new MatchEntry {
|
||||
SourcesFile = sourcesFile,
|
||||
RelativePath = relativePath,
|
||||
};
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private IEnumerable<MatchEntry> GetMatchesFromFile (
|
||||
SourcesFile sourcesFile, HashSet<string> excludedFiles = null
|
||||
) {
|
||||
if (sourcesFile == null)
|
||||
yield break;
|
||||
|
||||
if (excludedFiles == null)
|
||||
excludedFiles = new HashSet<string> (StringComparer.Ordinal);
|
||||
|
||||
foreach (var m in EnumerateMatches (sourcesFile, sourcesFile.Exclusions, true))
|
||||
excludedFiles.Add (m.RelativePath);
|
||||
|
||||
foreach (var include in sourcesFile.Includes) {
|
||||
foreach (var m in GetMatchesFromFile (include, excludedFiles))
|
||||
yield return m;
|
||||
}
|
||||
|
||||
// FIXME: This is order-sensitive
|
||||
foreach (var entry in EnumerateMatches (sourcesFile, sourcesFile.Sources, false)) {
|
||||
if (excludedFiles.Contains (entry.RelativePath)) {
|
||||
if (SourcesParser.TraceLevel >= 3)
|
||||
Console.Error.WriteLine ($"// Excluding {entry.RelativePath}");
|
||||
continue;
|
||||
}
|
||||
|
||||
yield return entry;
|
||||
}
|
||||
}
|
||||
|
||||
public IEnumerable<MatchEntry> GetMatches (TargetParseResult target = null) {
|
||||
var excludedFiles = new HashSet<string> (StringComparer.Ordinal);
|
||||
|
||||
if (target == null) {
|
||||
if (TargetDictionary.Count == 0)
|
||||
yield break;
|
||||
|
||||
target = Targets.First ();
|
||||
}
|
||||
|
||||
if (target == null)
|
||||
throw new ArgumentNullException ("target");
|
||||
|
||||
if (SourcesParser.TraceLevel >= 3)
|
||||
Console.Error.WriteLine ($"// Scanning sources file tree for {target.Key}");
|
||||
|
||||
int count = 0;
|
||||
foreach (var m in GetMatchesFromFile (target.Exclusions, excludedFiles))
|
||||
excludedFiles.Add (m.RelativePath);
|
||||
|
||||
foreach (var m in GetMatchesFromFile (target.Sources, excludedFiles)) {
|
||||
count++;
|
||||
yield return m;
|
||||
}
|
||||
|
||||
if (SourcesParser.TraceLevel >= 3)
|
||||
Console.Error.WriteLine ($"// Scan complete. Generated {count} successful matches.");
|
||||
}
|
||||
}
|
||||
|
||||
public class SourcesParser {
|
||||
public static readonly string DirectorySeparator = new String (Path.DirectorySeparatorChar, 1);
|
||||
public static int TraceLevel = 0;
|
||||
|
||||
private class State {
|
||||
public ParseResult Result;
|
||||
public string HostPlatform;
|
||||
public string ProfileName;
|
||||
|
||||
public int SourcesFilesParsed, ExclusionsFilesParsed;
|
||||
}
|
||||
|
||||
public readonly string[] AllHostPlatformNames;
|
||||
public readonly string[] AllProfileNames;
|
||||
|
||||
private int ParseDepth = 0;
|
||||
|
||||
public SourcesParser (
|
||||
string platformsFolder, string profilesFolder
|
||||
) {
|
||||
AllHostPlatformNames = Directory.GetFiles (platformsFolder, "*.make")
|
||||
.Select (Path.GetFileNameWithoutExtension)
|
||||
.ToArray ();
|
||||
AllProfileNames = Directory.GetFiles (profilesFolder, "*.make")
|
||||
.Select (Path.GetFileNameWithoutExtension)
|
||||
.ToArray ();
|
||||
}
|
||||
|
||||
public ParseResult Parse (string libraryDirectory, string sourcesFileName, string exclusionsFileName) {
|
||||
var state = new State {
|
||||
Result = new ParseResult (libraryDirectory)
|
||||
};
|
||||
|
||||
var tpr = new TargetParseResult {
|
||||
Key = (hostPlatform: null, profile: null)
|
||||
};
|
||||
|
||||
var parsedTarget = ParseIntoTarget (state, tpr, sourcesFileName, exclusionsFileName, null, overrideDirectory: libraryDirectory);
|
||||
|
||||
PrintSummary (state, sourcesFileName);
|
||||
return state.Result;
|
||||
}
|
||||
|
||||
public ParseResult Parse (string libraryDirectory, string libraryName, string hostPlatform, string profile) {
|
||||
var state = new State {
|
||||
Result = new ParseResult (libraryDirectory),
|
||||
ProfileName = profile,
|
||||
HostPlatform = hostPlatform
|
||||
};
|
||||
|
||||
var testPath = Path.Combine (libraryDirectory, $"{hostPlatform}_{profile}_{libraryName}");
|
||||
var ok = TryParseTargetInto (state, testPath);
|
||||
|
||||
if (ok) {
|
||||
PrintSummary (state, testPath);
|
||||
return state.Result;
|
||||
}
|
||||
|
||||
state.HostPlatform = null;
|
||||
|
||||
testPath = Path.Combine (libraryDirectory, $"{profile}_{libraryName}");
|
||||
ok = TryParseTargetInto (state, testPath);
|
||||
|
||||
if (ok) {
|
||||
PrintSummary (state, testPath);
|
||||
return state.Result;
|
||||
}
|
||||
|
||||
testPath = Path.Combine (libraryDirectory, $"{hostPlatform}_defaultprofile_{libraryName}");
|
||||
ok = TryParseTargetInto (state, testPath);
|
||||
|
||||
if (ok) {
|
||||
PrintSummary (state, testPath);
|
||||
return state.Result;
|
||||
}
|
||||
|
||||
state.ProfileName = null;
|
||||
|
||||
testPath = Path.Combine (libraryDirectory, libraryName);
|
||||
ok = TryParseTargetInto (state, testPath);
|
||||
|
||||
PrintSummary (state, testPath);
|
||||
|
||||
return state.Result;
|
||||
}
|
||||
|
||||
private void StripFallbackTargetsOrDefaultTarget (
|
||||
State state, TargetParseResult defaultTarget, List<TargetParseResult> fallbackTargets, int maximumCount
|
||||
) {
|
||||
if (fallbackTargets.Count == maximumCount) {
|
||||
// If we didn't find any platform specific targets, remove them and just leave one single
|
||||
// platform-specific target entry
|
||||
foreach (var target in fallbackTargets)
|
||||
state.Result.TargetDictionary.Remove (target.Key);
|
||||
} else if (defaultTarget != null) {
|
||||
// Otherwise, strip the non-platform-specific target
|
||||
state.Result.TargetDictionary.Remove (defaultTarget.Key);
|
||||
}
|
||||
}
|
||||
|
||||
public ParseResult Parse (string libraryDirectory, string libraryName) {
|
||||
var state = new State {
|
||||
Result = new ParseResult (libraryDirectory)
|
||||
};
|
||||
|
||||
string originalTestPath = Path.Combine (libraryDirectory, libraryName);
|
||||
var defaultTarget = ParseTarget (state, originalTestPath, null);
|
||||
var profileFallbackTargets = new List<TargetParseResult> ();
|
||||
|
||||
foreach (var profile in AllProfileNames) {
|
||||
state.ProfileName = profile;
|
||||
state.HostPlatform = null;
|
||||
|
||||
var testPath = Path.Combine (libraryDirectory, $"{profile}_{libraryName}");
|
||||
var profileTarget = ParseTarget (state, testPath, defaultTarget);
|
||||
if ((profileTarget != null) && profileTarget.IsFallback)
|
||||
profileFallbackTargets.Add (profileTarget);
|
||||
|
||||
var fallbackTargets = new List<TargetParseResult> ();
|
||||
|
||||
foreach (var hostPlatform in AllHostPlatformNames) {
|
||||
state.HostPlatform = hostPlatform;
|
||||
|
||||
testPath = Path.Combine (libraryDirectory, $"{hostPlatform}_{profile}_{libraryName}");
|
||||
var target = ParseTarget (state, testPath, profileTarget ?? defaultTarget);
|
||||
if ((target != null) && target.IsFallback)
|
||||
fallbackTargets.Add (target);
|
||||
}
|
||||
|
||||
StripFallbackTargetsOrDefaultTarget (state, profileTarget, fallbackTargets, AllHostPlatformNames.Length);
|
||||
}
|
||||
|
||||
StripFallbackTargetsOrDefaultTarget (state, defaultTarget, profileFallbackTargets, AllProfileNames.Length);
|
||||
|
||||
var platformFallbackTargets = new List<TargetParseResult> ();
|
||||
|
||||
var ambiguousSourcesNames = new List<string> ();
|
||||
|
||||
foreach (var hostPlatform in AllHostPlatformNames) {
|
||||
state.ProfileName = null;
|
||||
state.HostPlatform = hostPlatform;
|
||||
|
||||
var testPath = Path.Combine (libraryDirectory, $"{hostPlatform}_defaultprofile_{libraryName}");
|
||||
var target = ParseTarget (state, testPath, defaultTarget);
|
||||
if ((target != null) && target.IsFallback)
|
||||
platformFallbackTargets.Add (target);
|
||||
|
||||
if ((target == null) || target.IsFallback) {
|
||||
var oldTestPath = Path.Combine (libraryDirectory, $"{hostPlatform}_{libraryName}.sources");
|
||||
if (File.Exists (oldTestPath))
|
||||
ambiguousSourcesNames.Add (oldTestPath);
|
||||
|
||||
oldTestPath = Path.Combine (libraryDirectory, $"{hostPlatform}_{libraryName}.exclude.sources");
|
||||
if (File.Exists (oldTestPath))
|
||||
ambiguousSourcesNames.Add (oldTestPath);
|
||||
}
|
||||
}
|
||||
|
||||
StripFallbackTargetsOrDefaultTarget (state, defaultTarget, platformFallbackTargets, AllHostPlatformNames.Length);
|
||||
|
||||
foreach (var path in ambiguousSourcesNames) {
|
||||
if (!state.Result.SourcesFiles.ContainsKey (path) && !state.Result.ExclusionFiles.ContainsKey (path)) {
|
||||
Console.Error.WriteLine ($"// The file '{path}' was found but not used by sources parsing. Did you mean hostPlatform_defaultprofile_{libraryName}?");
|
||||
state.Result.ErrorCount += 1;
|
||||
}
|
||||
}
|
||||
|
||||
PrintSummary (state, originalTestPath);
|
||||
|
||||
return state.Result;
|
||||
}
|
||||
|
||||
private void PrintSummary (State state, string testPath) {
|
||||
if (TraceLevel > 0)
|
||||
Console.Error.WriteLine ($"// Parsed {state.SourcesFilesParsed} sources file(s) and {state.ExclusionsFilesParsed} exclusions file(s) from path '{testPath}'.");
|
||||
}
|
||||
|
||||
private void HandleMetaDirective (
|
||||
State state, SourcesFile file,
|
||||
string pathDirectory, string includeDirectory,
|
||||
bool asExclusionsList, string directive
|
||||
) {
|
||||
var include = "#include ";
|
||||
if (directive.StartsWith (include)) {
|
||||
var includeName = directive.Substring (include.Length).Trim ();
|
||||
var fileName = Path.Combine (includeDirectory, includeName);
|
||||
if (!File.Exists (fileName)) {
|
||||
Console.Error.WriteLine ($"// Include does not exist: {fileName}");
|
||||
state.Result.ErrorCount++;
|
||||
return;
|
||||
}
|
||||
|
||||
var newFile = ParseSingleFile (state, fileName, asExclusionsList, overrideDirectory: pathDirectory);
|
||||
if (newFile == null) {
|
||||
Console.Error.WriteLine ($"// Failed to parse included file: {fileName}");
|
||||
state.Result.ErrorCount++;
|
||||
return;
|
||||
}
|
||||
|
||||
file.Includes.Add (newFile);
|
||||
}
|
||||
}
|
||||
|
||||
private bool TryParseTargetInto (State state, string prefix) {
|
||||
var result = ParseTarget (state, prefix, null);
|
||||
return (result != null);
|
||||
}
|
||||
|
||||
private TargetParseResult ParseTarget (State state, string prefix, TargetParseResult fallbackTarget) {
|
||||
// FIXME: We determine the prefix for the pair of sources and exclusions,
|
||||
// which may not match intended behavior:
|
||||
// if linux_net_4_x_foo.sources is present, but linux_net_4_x_foo.exclude.sources is not present,
|
||||
// should net_4_x_foo.exclude.sources be used as a fallback? Maybe it should.
|
||||
// This won't do that though.
|
||||
|
||||
var tpr = new TargetParseResult {
|
||||
Key = (hostPlatform: state.HostPlatform, profile: state.ProfileName)
|
||||
};
|
||||
|
||||
var sourcesFileName = prefix + ".sources";
|
||||
var exclusionsFileName = prefix + ".exclude.sources";
|
||||
|
||||
return ParseIntoTarget (state, tpr, sourcesFileName, exclusionsFileName, fallbackTarget);
|
||||
}
|
||||
|
||||
private TargetParseResult ParseIntoTarget (
|
||||
State state, TargetParseResult tpr,
|
||||
string sourcesFileName, string exclusionsFileName,
|
||||
TargetParseResult fallbackTarget, string overrideDirectory = null
|
||||
) {
|
||||
if (!File.Exists (sourcesFileName)) {
|
||||
if (fallbackTarget != null) {
|
||||
if (TraceLevel >= 2)
|
||||
Console.Error.WriteLine($"// Not found: {sourcesFileName}, falling back to {fallbackTarget}");
|
||||
tpr.Sources = fallbackTarget.Sources;
|
||||
tpr.Exclusions = fallbackTarget.Exclusions;
|
||||
tpr.IsFallback = true;
|
||||
state.Result.TargetDictionary.Add (tpr.Key, tpr);
|
||||
return tpr;
|
||||
} else {
|
||||
if (TraceLevel >= 1)
|
||||
Console.Error.WriteLine($"// Not found: {sourcesFileName}");
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
tpr.Sources = ParseSingleFile (state, sourcesFileName, false, overrideDirectory: overrideDirectory);
|
||||
|
||||
if (File.Exists (exclusionsFileName))
|
||||
tpr.Exclusions = ParseSingleFile (state, exclusionsFileName, true, overrideDirectory: overrideDirectory);
|
||||
|
||||
state.Result.TargetDictionary.Add (tpr.Key, tpr);
|
||||
return tpr;
|
||||
}
|
||||
|
||||
private SourcesFile ParseSingleFile (State state, string fileName, bool asExclusionsList, string overrideDirectory = null) {
|
||||
var fileTable = asExclusionsList ? state.Result.ExclusionFiles : state.Result.SourcesFiles;
|
||||
|
||||
var nullStr = "<none>";
|
||||
|
||||
if (fileTable.ContainsKey (fileName)) {
|
||||
if (TraceLevel >= 2)
|
||||
Console.Error.WriteLine ($"// {new String (' ', ParseDepth * 2)}{fileName} (already parsed)");
|
||||
|
||||
return fileTable[fileName];
|
||||
} else {
|
||||
if (TraceLevel >= 2)
|
||||
Console.Error.WriteLine ($"// {new String (' ', ParseDepth * 2)}{fileName} [{state.HostPlatform ?? nullStr}] [{state.ProfileName ?? nullStr}]");
|
||||
}
|
||||
|
||||
ParseDepth += 1;
|
||||
|
||||
var includeDirectory = Path.GetDirectoryName (fileName);
|
||||
var pathDirectory = overrideDirectory ?? includeDirectory;
|
||||
var result = new SourcesFile (fileName, asExclusionsList);
|
||||
fileTable.Add (fileName, result);
|
||||
|
||||
using (var sr = new StreamReader (fileName)) {
|
||||
if (asExclusionsList)
|
||||
state.ExclusionsFilesParsed++;
|
||||
else
|
||||
state.SourcesFilesParsed++;
|
||||
|
||||
string line;
|
||||
while ((line = sr.ReadLine ()) != null) {
|
||||
if (line.StartsWith ("#")) {
|
||||
HandleMetaDirective (state, result, pathDirectory, includeDirectory, asExclusionsList, line);
|
||||
continue;
|
||||
}
|
||||
|
||||
line = line.Trim ();
|
||||
|
||||
if (String.IsNullOrWhiteSpace (line))
|
||||
continue;
|
||||
|
||||
var parts = line.Split (':');
|
||||
|
||||
if (parts.Length > 1) {
|
||||
var explicitExclusions = parts[1].Split (',');
|
||||
|
||||
// gensources.sh implemented these explicit exclusions like so:
|
||||
// ../foo/bar/*.cs:A.cs,B.cs
|
||||
// This would generate exclusions for ../foo/bar/A.cs and ../foo/bar/B.cs,
|
||||
// not ./A.cs and ./B.cs as you might expect
|
||||
|
||||
var mainPatternDirectory = Path.GetDirectoryName (parts[0]);
|
||||
|
||||
foreach (var pattern in explicitExclusions) {
|
||||
result.Exclusions.Add (new ParseEntry {
|
||||
Directory = pathDirectory,
|
||||
Pattern = Path.Combine (mainPatternDirectory, pattern)
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
(asExclusionsList ? result.Exclusions : result.Sources)
|
||||
.Add (new ParseEntry {
|
||||
Directory = pathDirectory,
|
||||
Pattern = parts[0]
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
ParseDepth -= 1;
|
||||
return result;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,88 @@
|
||||
#! /bin/sh
|
||||
|
||||
outfile=$1
|
||||
incfile=$2
|
||||
excfile=$3
|
||||
extfile=$4
|
||||
extexcfile=$5
|
||||
|
||||
process_includes_1() {
|
||||
sed -e '/^[ \t]*$/d' -e '/^[ \t]*#/d' $1 > $2
|
||||
if cmp -s $1 $2; then
|
||||
false
|
||||
else
|
||||
sed -n 's,^[ \t]*#include ,,p' $1 |
|
||||
while read inc; do
|
||||
cat $inc >> $2
|
||||
echo $outfile: $inc >> $outfile.makefrag
|
||||
echo $inc: >> $outfile.makefrag
|
||||
done
|
||||
fi
|
||||
}
|
||||
|
||||
process_includes() {
|
||||
i=$1; o=$2; t=${2}.tmp
|
||||
while process_includes_1 $i $o; do
|
||||
mv $o $t
|
||||
i=$t
|
||||
done
|
||||
rm -f $t
|
||||
}
|
||||
|
||||
check_newline_eof() {
|
||||
file=$1
|
||||
if ! test -f "$file"; then return; fi
|
||||
if ! test -z "$(tail -c 1 "$file")"; then echo "$file: missing newline at end of file."; exit 1; fi
|
||||
}
|
||||
|
||||
check_newline_eof $incfile
|
||||
check_newline_eof $excfile
|
||||
check_newline_eof $extfile
|
||||
check_newline_eof $extexcfile
|
||||
|
||||
rm -f $outfile.makefrag
|
||||
|
||||
process_includes $incfile $outfile.inc
|
||||
|
||||
if test x$extfile != x -a -f "$extfile"; then
|
||||
process_includes $extfile $outfile.ext.inc
|
||||
cat $outfile.ext.inc >> $outfile.inc
|
||||
rm -f $outfile.ext.inc
|
||||
fi
|
||||
|
||||
sort -u $outfile.inc > $outfile.inc_s
|
||||
rm -f $outfile.inc
|
||||
|
||||
|
||||
if test -n "$excfile" -a -f "$excfile"; then
|
||||
process_includes $excfile $outfile.exc
|
||||
fi
|
||||
|
||||
if test -n "$extexcfile"; then
|
||||
process_includes $extexcfile $outfile.ext_exc
|
||||
cat $outfile.ext_exc >> $outfile.exc
|
||||
rm -f $outfile.ext_exc
|
||||
fi
|
||||
|
||||
if test -f $outfile.exc; then
|
||||
# So what we're doing below with uniq -u is that we take
|
||||
# lines that have not been duplicated. This computes the
|
||||
# symmetric difference between the files. This is not
|
||||
# what we want. If a file is in the excludes but not in
|
||||
# the sources, we want that file not to show up. By duplicating the
|
||||
# excludes, we ensure that we won't end up in this failure state.
|
||||
sort -u $outfile.exc > $outfile.exc_s
|
||||
|
||||
# Duplicate excludes
|
||||
cat $outfile.exc_s >> $outfile.exc_s_dup
|
||||
cat $outfile.exc_s >> $outfile.exc_s_dup
|
||||
|
||||
rm -f $outfile.exc $outfile.exc_s
|
||||
|
||||
cat $outfile.inc_s $outfile.exc_s_dup | sort | uniq -u > $outfile
|
||||
rm -f $outfile.inc_s $outfile.exc_s_dup
|
||||
else
|
||||
mv $outfile.inc_s $outfile
|
||||
fi
|
||||
|
||||
|
||||
+33
-48
@@ -14,31 +14,27 @@
|
||||
# command line.
|
||||
#
|
||||
|
||||
LIB_REFS_FULL = $(call _FILTER_OUT,=, $(LIB_REFS)) $(DEFAULT_REFERENCES)
|
||||
# All dependent libs become dependent dirs for parallel builds
|
||||
# Have to rename to handle differences between assembly/directory names
|
||||
DEP_LIBS=$(patsubst System.Xml,System.XML,$(LIB_REFS))
|
||||
|
||||
LIB_REFS_FULL = $(call _FILTER_OUT,=, $(LIB_REFS))
|
||||
LIB_REFS_ALIAS = $(filter-out $(LIB_REFS_FULL),$(LIB_REFS))
|
||||
|
||||
# All dependent libs become dependent dirs for parallel builds
|
||||
DEP_LIBS = $(filter-out %=, $(subst =,= ,$(LIB_REFS)))
|
||||
|
||||
ifdef TARGET_NET_REFERENCE
|
||||
# System*, mscorlib references come from the TARGET_NET_REFERENCE dir, others from the profile dir
|
||||
LIB_REFS_MONO_FULL = $(call _FILTER_OUT,System,$(call _FILTER_OUT,mscorlib,$(LIB_REFS_FULL)))
|
||||
# System.*.dll references come from the TARGET_NET_REFERENCE dir, others from the profile dir
|
||||
LIB_REFS_MONO_FULL = $(call _FILTER_OUT,System,$(LIB_REFS_FULL))
|
||||
LIB_REFS_MONO_ALIAS = $(call _FILTER_OUT,System,$(LIB_REFS_ALIAS))
|
||||
|
||||
LIB_REFS_NET_FULL = $(filter-out $(LIB_REFS_MONO_FULL),$(LIB_REFS_FULL))
|
||||
LIB_REFS_NET_ALIAS = $(filter-out $(LIB_REFS_MONO_ALIAS),$(LIB_REFS_ALIAS))
|
||||
LIB_REFS_SYSTEM_FULL = $(filter-out $(LIB_REFS_MONO_FULL),$(LIB_REFS_FULL))
|
||||
LIB_REFS_SYSTEM_ALIAS = $(filter-out $(LIB_REFS_MONO_ALIAS),$(LIB_REFS_ALIAS))
|
||||
|
||||
LIB_MCS_FLAGS += $(patsubst %,-r:$(topdir)/../external/binary-reference-assemblies/$(TARGET_NET_REFERENCE)/%.dll,$(LIB_REFS_NET_FULL))
|
||||
LIB_MCS_FLAGS += $(patsubst %,-r:%.dll, $(subst =,=$(topdir)/../external/binary-reference-assemblies/$(TARGET_NET_REFERENCE)/,$(LIB_REFS_NET_ALIAS)))
|
||||
LIB_MCS_FLAGS += $(patsubst %,-r:$(topdir)/../external/binary-reference-assemblies/$(TARGET_NET_REFERENCE)/%.dll,$(LIB_REFS_SYSTEM_FULL))
|
||||
LIB_MCS_FLAGS += $(patsubst %,-r:%.dll, $(subst =,=$(topdir)/../external/binary-reference-assemblies/$(TARGET_NET_REFERENCE)/,$(LIB_REFS_SYSTEM_ALIAS)))
|
||||
|
||||
LIB_MCS_FLAGS += $(patsubst %,-r:$(topdir)/class/lib/$(PROFILE_DIRECTORY)/%.dll,$(LIB_REFS_MONO_FULL))
|
||||
LIB_MCS_FLAGS += $(patsubst %,-r:%.dll, $(subst =,=$(topdir)/class/lib/$(PROFILE_DIRECTORY)/,$(LIB_REFS_MONO_ALIAS)))
|
||||
else
|
||||
|
||||
ifdef API_BIN_REFS
|
||||
LIB_MCS_FLAGS += $(patsubst %,-r:$(topdir)/../external/binary-reference-assemblies/$(API_BIN_PROFILE)/%.dll,$(API_BIN_REFS))
|
||||
endif
|
||||
|
||||
LIB_MCS_FLAGS += $(patsubst %,-r:$(topdir)/class/lib/$(PROFILE_DIRECTORY)/%.dll,$(LIB_REFS_FULL))
|
||||
LIB_MCS_FLAGS += $(patsubst %,-r:%.dll, $(subst =,=$(topdir)/class/lib/$(PROFILE_DIRECTORY)/,$(LIB_REFS_ALIAS)))
|
||||
endif
|
||||
@@ -62,17 +58,19 @@ the_libdir_base = $(topdir)/class/$(lib_dir)/$(PROFILE_DIRECTORY)/$(if $(LIBRARY
|
||||
ifdef RESOURCE_STRINGS
|
||||
ifneq (basic, $(PROFILE))
|
||||
RESOURCE_STRINGS_FILES += $(RESOURCE_STRINGS:%=--resourcestrings:%)
|
||||
IL_REPLACE_FILES += $(IL_REPLACE:%=--ilreplace:%)
|
||||
endif
|
||||
endif
|
||||
|
||||
ifdef ENFORCE_LIBRARY_WARN_AS_ERROR
|
||||
ifeq ($(LIBRARY_WARN_AS_ERROR),yes)
|
||||
ifndef MCS_MODE
|
||||
LIB_MCS_FLAGS += -warnaserror
|
||||
endif
|
||||
endif
|
||||
endif
|
||||
#
|
||||
# The bare directory contains the plain versions of System and System.Xml
|
||||
#
|
||||
bare_libdir = $(the_libdir_base)bare
|
||||
|
||||
#
|
||||
# The secxml directory contains the System version that depends on
|
||||
# System.Xml and Mono.Security
|
||||
#
|
||||
secxml_libdir = $(the_libdir_base)secxml
|
||||
|
||||
the_libdir = $(the_libdir_base)$(intermediate)
|
||||
|
||||
@@ -124,7 +122,6 @@ csproj-library:
|
||||
echo $(thisdir):$$config_file >> $(topdir)/../msvc/scripts/order; \
|
||||
(echo $(is_boot); \
|
||||
echo $(USE_MCS_FLAGS) $(LIBRARY_FLAGS) $(LIB_MCS_FLAGS) $(KEYFILE_MCS_FLAGS); \
|
||||
echo $(LIBRARY); \
|
||||
echo $(LIBRARY_NAME); \
|
||||
echo $(BUILT_SOURCES_cmdline); \
|
||||
echo $(build_lib); \
|
||||
@@ -213,7 +210,7 @@ test-local run-test-local run-test-ondotnet-local:
|
||||
ccomma = ,
|
||||
define RESOURCE_template
|
||||
$(1).resources: $(2)
|
||||
$$(RESGEN) "$$<" "$$@"
|
||||
$(RESGEN) "$$<" "$$@"
|
||||
|
||||
GEN_RESOURCE_DEPS += $(1).resources
|
||||
GEN_RESOURCE_FLAGS += -resource:$(1).resources
|
||||
@@ -225,12 +222,11 @@ ifdef RESOURCE_DEFS
|
||||
$(foreach pair,$(RESOURCE_DEFS), $(eval $(call RESOURCE_template,$(word 1, $(subst $(ccomma), ,$(pair))), $(word 2, $(subst $(ccomma), ,$(pair))))))
|
||||
endif
|
||||
|
||||
DISTFILES = $(wildcard *.sources) $(EXTRA_DISTFILES) $(DIST_LISTED_RESOURCES)
|
||||
DISTFILES = $(wildcard *$(LIBRARY)*.sources) $(EXTRA_DISTFILES) $(DIST_LISTED_RESOURCES)
|
||||
|
||||
ASSEMBLY = $(LIBRARY)
|
||||
ASSEMBLY_EXT = .dll
|
||||
the_assembly = $(the_lib)
|
||||
|
||||
include $(topdir)/build/tests.make
|
||||
|
||||
ifdef HAVE_CS_TESTS
|
||||
@@ -241,7 +237,6 @@ csproj-test:
|
||||
echo $(thisdir):$$config_file >> $(topdir)/../msvc/scripts/order; \
|
||||
(echo false; \
|
||||
echo $(USE_MCS_FLAGS) -r:$(the_assembly) $(TEST_MCS_FLAGS); \
|
||||
echo $(LIBRARY); \
|
||||
echo $(test_lib); \
|
||||
echo $(BUILT_SOURCES_cmdline); \
|
||||
echo $(test_lib); \
|
||||
@@ -286,18 +281,14 @@ endif
|
||||
# The library
|
||||
|
||||
# If the directory contains the per profile include file, generate list file.
|
||||
# TODO: depend on all *.sources for now and figure out how to list only needed files later
|
||||
PROFILE_sources = $(wildcard *.sources)
|
||||
|
||||
ifneq "x" "x$(PROFILE_RUNTIME)"
|
||||
GENSOURCES_RUNTIME=$(PROFILE_RUNTIME)
|
||||
else
|
||||
GENSOURCES_RUNTIME=MONO_PATH="$(GENSOURCES_LIBDIR)$(PLATFORM_PATH_SEPARATOR)$$MONO_PATH" $(RUNTIME)
|
||||
endif
|
||||
PROFILE_sources := $(firstword $(if $(PROFILE_PLATFORM),$(wildcard $(PROFILE_PLATFORM)_$(PROFILE)_$(LIBRARY).sources)) $(wildcard $(PROFILE)_$(LIBRARY).sources) $(wildcard $(LIBRARY).sources))
|
||||
PROFILE_excludes = $(firstword $(if $(PROFILE_PLATFORM),$(wildcard $(PROFILE_PLATFORM)_$(PROFILE)_$(LIBRARY).exclude.sources)) $(wildcard $(PROFILE)_$(LIBRARY).exclude.sources))
|
||||
|
||||
# Note, gensources.sh can create a $(sourcefile).makefrag if it sees any '#include's
|
||||
# We don't include it in the dependencies since it isn't always created
|
||||
sourcefile = $(depsdir)/$(PROFILE_PLATFORM)_$(PROFILE)_$(LIBRARY_SUBDIR)_$(LIBRARY).sources
|
||||
$(sourcefile): $(PROFILE_sources) $(PROFILE_excludes) $(depsdir)/.stamp $(GENSOURCES_CS)
|
||||
$(GENSOURCES_RUNTIME) --debug $(GENSOURCES_EXE) --strict "$@" "$(LIBRARY)" "$(PROFILE_PLATFORM)" "$(PROFILE)"
|
||||
$(sourcefile): $(PROFILE_sources) $(PROFILE_excludes) $(topdir)/build/gensources.sh $(depsdir)/.stamp
|
||||
$(SHELL) $(topdir)/build/gensources.sh $@ '$(PROFILE_sources)' '$(PROFILE_excludes)'
|
||||
|
||||
library_CLEAN_FILES += $(sourcefile)
|
||||
|
||||
@@ -333,10 +324,10 @@ endif
|
||||
|
||||
ifndef NO_BUILD
|
||||
|
||||
$(build_lib): $(response) $(sn) $(BUILT_SOURCES) $(build_libdir)/.stamp $(GEN_RESOURCE_DEPS) $(MODULE_DEPS)
|
||||
$(build_lib): $(response) $(sn) $(BUILT_SOURCES) $(build_libdir)/.stamp $(GEN_RESOURCE_DEPS)
|
||||
$(LIBRARY_COMPILE) $(LIBRARY_FLAGS) $(LIB_MCS_FLAGS) $(KEYFILE_MCS_FLAGS) $(GEN_RESOURCE_FLAGS) -target:library -out:$@ $(BUILT_SOURCES_cmdline) @$(response)
|
||||
ifdef RESOURCE_STRINGS_FILES
|
||||
$(Q) $(STRING_REPLACER) $(RESOURCE_STRINGS_FILES) $(IL_REPLACE_FILES) $@
|
||||
$(Q) $(STRING_REPLACER) $(RESOURCE_STRINGS_FILES) $@
|
||||
endif
|
||||
$(Q) $(SN) -R $@ $(LIBRARY_SNK)
|
||||
|
||||
@@ -383,11 +374,5 @@ $(the_libdir)/.doc-stamp: $(the_lib)
|
||||
gen-deps:
|
||||
@echo "$(DEPS_TARGET_DIR): $(DEP_DIRS) $(DEP_LIBS)" >> $(DEPS_FILE)
|
||||
|
||||
update-corefx-sr-generic:
|
||||
ifneq ($(RESX_STRINGS),)
|
||||
MONO_PATH="$(topdir)/class/lib/$(BUILD_TOOLS_PROFILE)$(PLATFORM_PATH_SEPARATOR)$$MONO_PATH" $(RUNTIME) $(RUNTIME_FLAGS) $(topdir)/class/lib/$(BUILD_TOOLS_PROFILE)/resx2sr.exe $(RESX_EXTRA_ARGUMENTS) $(RESX_STRINGS) >$(SR_OUTPUT)
|
||||
endif
|
||||
|
||||
update-corefx-sr: $(RESX_RESOURCE_STRING) $(XTEST_RESX_RESOURCE_STRING)
|
||||
make SR_OUTPUT=corefx/SR.cs RESX_STRINGS="$(RESX_RESOURCE_STRING)" RESX_EXTRA_ARGUMENTS="$(RESX_EXTRA_ARGUMENTS)" update-corefx-sr-generic \
|
||||
&& make SR_OUTPUT=corefx/SR.tests.cs RESX_STRINGS=$(XTEST_RESX_RESOURCE_STRING) update-corefx-sr-generic
|
||||
update-corefx-sr: $(RESX_RESOURCE_STRING)
|
||||
MONO_PATH="$(topdir)/class/lib/$(BUILD_TOOLS_PROFILE)$(PLATFORM_PATH_SEPARATOR)$$MONO_PATH" $(RUNTIME) $(RUNTIME_FLAGS) $(topdir)/class/lib/$(BUILD_TOOLS_PROFILE)/resx2sr.exe $(RESX_RESOURCE_STRING) >corefx/SR.cs
|
||||
@@ -0,0 +1,36 @@
|
||||
# -*- makefile -*-
|
||||
#
|
||||
# Platform-specific makefile rules. This one's for macOS.
|
||||
#
|
||||
|
||||
PLATFORM_MCS_FLAGS =
|
||||
PLATFORM_RUNTIME = $(RUNTIME)
|
||||
PLATFORM_CORLIB = mscorlib.dll
|
||||
PLATFORM_TEST_HARNESS_EXCLUDES = NotOnMac,MacNotWorking,
|
||||
|
||||
EXTERNAL_MCS = mcs
|
||||
EXTERNAL_MBAS = mbas
|
||||
EXTERNAL_RUNTIME = mono
|
||||
#ILDISASM = monodis
|
||||
ILDISASM = false
|
||||
|
||||
PLATFORM_PATH_SEPARATOR = :
|
||||
|
||||
# Define this if this ever will work on Linux
|
||||
# PLATFORM_MAKE_CORLIB_CMP = yes
|
||||
|
||||
# This is for changing / to \ on windows
|
||||
PLATFORM_CHANGE_SEPARATOR_CMD = cat
|
||||
|
||||
hidden_prefix = .
|
||||
hidden_suffix =
|
||||
|
||||
platform-check:
|
||||
@:
|
||||
# I tried this but apparently Make's version strings aren't that
|
||||
# ... consistent between releases. Whatever.
|
||||
#
|
||||
# @if ! $(MAKE) --version |grep '^GNU Make version 3' 1>/dev/null 2>&1 ; then \
|
||||
# echo "*** You need to build MCS with GNU make. Try \`gmake'" ; \
|
||||
# exit 1 ; \
|
||||
# fi
|
||||
@@ -1,38 +0,0 @@
|
||||
# -*- makefile -*-
|
||||
#
|
||||
# Platform-specific makefile rules. This one's for macOS.
|
||||
#
|
||||
|
||||
PLATFORM_MCS_FLAGS =
|
||||
PLATFORM_RUNTIME = $(RUNTIME)
|
||||
PLATFORM_CORLIB = mscorlib.dll
|
||||
PLATFORM_TEST_HARNESS_EXCLUDES = NotOnMac,MacNotWorking,
|
||||
|
||||
EXTERNAL_MCS = mcs
|
||||
EXTERNAL_MBAS = mbas
|
||||
EXTERNAL_RUNTIME = mono
|
||||
#ILDISASM = monodis
|
||||
ILDISASM = false
|
||||
|
||||
PLATFORM_PATH_SEPARATOR = :
|
||||
|
||||
# Define this if this ever will work on Linux
|
||||
# PLATFORM_MAKE_CORLIB_CMP = yes
|
||||
|
||||
# This is for changing / to \ on windows
|
||||
PLATFORM_CHANGE_SEPARATOR_CMD = cat
|
||||
|
||||
hidden_prefix = .
|
||||
hidden_suffix =
|
||||
|
||||
platform-check:
|
||||
@:
|
||||
# I tried this but apparently Make's version strings aren't that
|
||||
# ... consistent between releases. Whatever.
|
||||
#
|
||||
# @if ! $(MAKE) --version |grep '^GNU Make version 3' 1>/dev/null 2>&1 ; then \
|
||||
# echo "*** You need to build MCS with GNU make. Try \`gmake'" ; \
|
||||
# exit 1 ; \
|
||||
# fi
|
||||
|
||||
PLATFORM_MACOS=1
|
||||
Loaded 100 of 5022 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user