mono/linux-packaging-mono
0
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Imported Upstream version 4.6.0.125

Browse Source 
Former-commit-id: a2155e9bd80020e49e72e86c44da02a8ac0e57a4
This commit is contained in:
Xamarin Public Jenkins (auto-signing)
2016-08-03 10:59:49 +00:00
parent a569aebcfd
commit e79aa3c0ed
17047 changed files with 3137615 additions and 392334 deletions
Download Patch File Download Diff File Expand all files Collapse all files

370
man/ChangeLog
View File

@@ -1,370 +0,0 @@
2010-08-03 Andrés G. Aragoneses <andres@lindenlab.com>
* monolinker.1: Add the name="..." notation to the field examples too
(besides the signature="..." one).
2010-07-12 Rolf Bjarne Kvinge <RKvinge@novell.com>
* mono.1: Document MONO_DEBUG's new reverse-pinvoke-exceptions option.
2010-04-23 Miguel de Icaza <miguel@novell.com>
* mono.1: Sort environment variables, update a couple of docs.
2010-04-07 Andrés G. Aragoneses <andres@lindenlab.com>
* monolinker.1: Fix typo.
2010-04-01 Sebastien Pouliot <sebastien@ximian.com>
* mono.1: Document the new "security" option for logging
2010-03-26 Zoltan Varga <vargaz@gmail.com>
* mono.1: Document the MONO_ENABLE_SHM env variable.
2010-03-03 Rolf Bjarne Kvinge <RKvinge@novell.com>
* mono.1: Document exception tracing.
2010-02-18 Marek Habersack <mhabersack@novell.com>
* mono-configuration-crypto.1: added
* Makefile.am (man_MANS): added mono-configuration-crypto.1
2010-02-10 Geoff Norton <gnorton@novell.com>
* mono.1: Document the aot compiler options.
2010-02-08 Ankit Jain <jankit@novell.com>
* lc.1: Fix typos.
2009-12-11 Marek Habersack <mhabersack@novell.com>
* mono.1: documented the IOMAP report profiler module
2009-11-23 Marek Habersack <mhabersack@novell.com>
* mono.1: documented the 'report' option for MONO_IOMAP
2009-10-11 Ankit Jain <jankit@novell.com>
* xbuild.1: Add info about env var XBUILD_COLORS.
2009-10-09 Zoltan Varga <vargaz@gmail.com>
* mono.1: Document --debug=gdb option.
2009-09-24 Ankit Jain <jankit@novell.com>
* xbuild.1: Add info about env var XBUILD_EMIT_SOLUTION.
2009-09-14 Massimiliano Mantione <massi@ximian.com>
* mono.1: Updated the profiler documentation, removing the obsolete
signal related options and adding the description of the new socket
based command interface.
2009-08-21 Ankit Jain <jankit@novell.com>
* Makefile.am (man_MANS): Add xbuild.1
* xbuild.1: New.
2009-06-12 Jb Evain <jbevain@novell.com>
* mcs.1: update the /platform information.
2009-05-12 Tor Lillqvist <tml@novell.com>
* mkbundle.1: Document MONO_BUNDLED_OPTIONS.
2009-04-09 Jonathan Pryor <jpryor@novell.com>
* mdoc-update.1: Document -L, -r options.
2009-04-06 Jonathan Pryor <jpryor@novell.com>
* mdoc.5: Document //code/@src attribute.
2009-04-03 Andrés G. Aragoneses <aaragoneses@novell.com>
* monolinker.1: Document -m modifier.
2009-03-31 Jonathan Pryor <jpryor@novell.com>
* mdoc-update.1: Fix --out=DIRECTORY formatting. (It was causing the
remaining text to be bolded within monodoc).
2009-03-30 Jonathan Pryor <jpryor@novell.com>
* mdoc-update.1: Add new --exceptions=added functionality.
2009-03-23 Massimiliano Mantione <massi@ximian.com>
* mono.1: Updated the profiler documentation, removing the "gc-signal"
option (it does not exist anymore) and clarifying the role of signals
in heap profiling.
2009-03-20 Jonathan Pryor <jpryor@novell.com>
* mdoc-export-html.1: Document --force-update parameter.
2008-12-31 Massimiliano Mantione <massi@ximian.com>
* mono.1: Updated the profiler documentation, removing the "ts"
option (it does not exist anymore) and explaining the defaults for
allocation and heap profiling.
2008-12-12 Rolf Bjarne Kvinge <RKvinge@novell.com>
* Makefile.am, vbnc.1: Remove vbnc.1. It's living in the
mono-basic module now.
2008-11-20 Rodrigo Kumpera <rkumpera@novell.com>
* mono.1: Document env vars MONO_XDEBUG and MONO_VERBOSE_METHOD.
2008-10-18 Jonathan Pryor <jpryor@novell.com>
* Makefile.am (man_MANS): Remove unpackaged files.
2008-10-18 Jonathan Pryor <jpryor@novell.com>
* mdvalidator.1: Rename to mdvalidater.1.
* Makefile.am (man_MANS): Rename to mdvalidator.1 to mdvalidater.1.
2008-10-18 Jonathan Pryor <jpryor@novell.com>
* Makefile.am (man_MANS): Add mdoc.5 and mono-config.5.
2008-10-18 Mark Probst <mark.probst@gmail.com>
* mono.1: Documentation for "--no-x86-stack-align" option.
2008-10-17 Jonathan Pryor <jpryor@novell.com>
* Makefile: Add man pages added from monodoc/man...
2008-10-12 Atsushi Enomoto <atsushi@ximian.com>
* mono.1 : svn.myrealbox -> anonsvn.mono-project .
2008-10-10 Massimiliano Mantione <massi@ximian.com>
* mono.1: Document the new "sas" option.
2008-09-11 Daniel Morgan <monodanmorg@yahoo.com>
* sqlsharp.1: added commands
\bcs, \cs, \listproviders, \p
2008-08-27 Zoltan Varga <vargaz@gmail.com>
* mono-config.5: Fix a typo.
2008-08-22 Massimiliano Mantione <massi@ximian.com>
* mono.1: Restore original nonvisible formatting (' ', '\-', and '"'
were added everywhere by mistake in r109428).
2008-08-21 Massimiliano Mantione <massi@ximian.com>
* mono.1: Updated description of the logging profiler.
2008-08-08 Zoltan Varga <vargaz@gmail.com>
* mono.1: Remove no-dlsym aot option for now.
* mono.1: Document the 'static' aot option.
2008-08-01 Massimiliano Mantione <massi@ximian.com>
* mono.1: Updated description of the logging profiler.
2008-04-22 Robert Jordan <robertj@gmx.net>
* mono.1: Document MONO_DEBUG=no-gdb-backtrace.
2008-04-21 Martin Baulig <martin@ximian.com>
* mono.1: Documented the new --debug=mdb-optimizations option.
2008-04-17 Marek Habersack <mhabersack@novell.com>
* mono.1: add description of the new NullFileWatcher to the
documentation of the MONO_MANAGED_WATCHER envvar.
2008-03-26 Massimiliano Mantione <massi@ximian.com>
* mono.1: Added description of the logging profiler.
2008-03-08 Zoltan Varga <vargaz@gmail.com>
* mono.1: Fix a typo.
2008-03-07 Rodrigo Kumpera <rkumpera@novell.com>
* mono.1: Documented new --security options validil
and verifiable.
2007-12-08 Jonathan Pryor <jpryor@novell.com>
* wsdl.1: Fix groff comment (so that it doesn't appear in monodoc's
man-provider output).
2007-12-08 Marek Habersack <mhabersack@novell.com>
* mono.1: added short documentation about the
MONO_ASPNET_INHIBIT_SETTINGSMAP environment variable.
2007-12-07 Mark Probst <mark.probst@gmail.com>
* mono.1: Added a short paragraph on the MONO_GENERIC_SHARING
environment variable.
2007-11-21 Marek Habersack <mhabersack@novell.com>
* mconfig.1: modify to reflect parameter changes in mconfig.
2007-10-23 Marek Habersack <mhabersack@novell.com>
* mconfig.1: added
* Makefile.am (man_MANS): added mconfig.1
2007-10-17 Sebastien Pouliot <sebastien@ximian.com>
* sn.1: Fix help for -T / -t as this shows the public key token
(and not the public key).
2007-08-31 Sebastien Pouliot <sebastien@ximian.com>
* permview.1: add documentation for the -xml option now available
with the Cecil-enabled version of permview.
2007-07-17 Jb Evain <jbevain@novell.com>
* monolinker.1: add monolinker man page.
2007-07-11 Jb Evain <jbevain@novell.com>
* mcs.1: add info about smcs.
2007-07-04 Atsushi Enomoto <atsushi@ximian.com>
* mcs.1 : we do not use fixed Latin1 by default.
2007-07-02 Jackson Harper <jackson@ximian.com>
* xamlg.1:
* Makefile.am: Moved to more appropriate place.
2007-07-02 Jackson Harper <jackson@ximian.com>
* xamlg.1:
* Makefile.am: Add man page for xamlg.
2007-04-26 Dick Porter <dick@ximian.com>
* mono.1: Document MONO_DISABLE_SHM
2007-02-20 Rolf Bjarne Kvinge <RKvinge@novell.com>
* vbnc.1: Added man entry for vbnc.
* mbas.1: Deleted.
* Makefile.am: Added vbnc.1
Mon Jan 22 11:15:26 CET 2007 Paolo Molaro <lupus@ximian.com>
* mono.1: typo fixes from jessemerriman@warpmail.net (Jesse Merriman).
2007-01-17 Alp Toker <alp@atoker.com>
* gacutil.1: Spelling and grammar fixes.
2007-01-17 Alp Toker <alp@atoker.com>
* sn.1: Spelling and grammar fixes.
2006-12-08 Sebastien Pouliot <sebastien@ximian.com>
* mono.1: Document the MONO_TLS_SESSION_CACHE_TIMEOUT environment
variable that can be used to control the validity period of the
SSL/TLS negotiation cache.
2006-11-29 Joshua Tauberer <jit@occams.info>
* mkbundle.1: Corrected minor errors, added --nomain option.
2006-11-14 Atsushi Enomoto <atsushi@ximian.com>
* genxs.1 : introduced <baseSerializer> and <implementation>
elements. See also sgen.
2006-11-14 Atsushi Enomoto <atsushi@ximian.com>
* sgen.1, Makefile: revised a bit, to not mislead as if the output
were sources. It indeed generates an assembly.
2006-11-14 Atsushi Enomoto <atsushi@ximian.com>
* sgen.1, Makefile: added manpage for sgen.
2006-10-03 Dick Porter <dick@ximian.com>
* mono.1: Document the new MONO_IO_PORTABILITY_HELP environment
variable
2006-09-08 Robert Jordan <robertj@gmx.net>
* mkbundle.1: The `-z' option is now supported under Windows.
2006-08-31 Geoff Norton <gnorton@customerdna.com>
* macpack.1: Fix a typo for the -appname option.
2006-08-23 Wade Berrier <wberrier@novell.com>
* gacutil.1 : Change automake usage example because we always use $(prefix)/lib
for the gac, even on 64 bit systems.
2006-08-20 Gert Driesen <drieseng@users.sourceforge.net>
* mono.1 : Document MONO_EVENTLOG_TYPE, replaces MONO_EVENTLOG_PATH.
2006-08-17 Sebastien Pouliot <sebastien@ximian.com>
* sn.1: Document the (new - 1.1.17) support for PKCS#12/PFX password
protected files to sign assemblies.
2006-08-14 Atsushi Enomoto <atsushi@ximian.com>
* mono.1 : MONO_LOCAL_EVENTLOG_PATH -> MONO_EVENTLOG_PATH.
2006-08-14 Atsushi Enomoto <atsushi@ximian.com>
* mono.1 : description on MONO_LOCAL_EVENTLOG_PATH.
2006-03-15 Miguel de Icaza <miguel@novell.com>
* mono.1: Document MONO_XEXCEPTIONS and MONO_XSYNC, create new
section, sort the previous enviornment section.
2006-03-06 Lluis Sanchez Gual <lluis@novell.com>
* mono.1: Updated MONO_XMLSERIALIZER_THS option information.
2006-02-22 Jelmer Vernooij <jelmer@samba.org>
* mbas.1, Makefile.am: Add manpage for mbas (based on mcs.1)
2006-01-26 Jonathan Pryor <jonpryor@vt.edu>
* ChangeLog: Started
* mono-shlib-cop.1: Document another BUG/design issue that it doesn't check
for; formatting/style changes.
2009-05-22 Michael Barker <mike@middlesoft.co.uk>
* man.1: Added documentation for MONO_MESSAGING_PROVIDER environment
variable.

4
man/Makefile.in
View File

@@ -80,7 +80,7 @@ host_triplet = @host@
target_triplet = @target@
subdir = man
DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \
$(top_srcdir)/mkinstalldirs ChangeLog
$(top_srcdir)/mkinstalldirs
ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
am__aclocal_m4_deps = $(top_srcdir)/m4/iconv.m4 \
$(top_srcdir)/m4/lib-ld.m4 $(top_srcdir)/m4/lib-link.m4 \
@@ -243,8 +243,6 @@ NM = @NM@
NMEDIT = @NMEDIT@
OBJDUMP = @OBJDUMP@
OBJEXT = @OBJEXT@
OPROFILE_CFLAGS = @OPROFILE_CFLAGS@
OPROFILE_LIBS = @OPROFILE_LIBS@
OTOOL = @OTOOL@
OTOOL64 = @OTOOL64@
PACKAGE = @PACKAGE@

4
man/mkbundle.1
View File

@@ -43,11 +43,11 @@ targets, and the "--cross" argument to specify the target, like this:
default - Current System Mono
4.4.0-macosx-x86
4.4.0-debian-8-arm64
$ mkbundle --cross 4.4.0-debian-8-arm64 hello.exe -o hello-debian
$ mkbundle --cross 4.4.0-debian-8-powerpc hello.exe -o hello-debian
.fi
.PP
The above will bundle your native library into hello-debian for
a Debian 8 system running on an ARM64 machine.
a Debian 8 system running on a PowerPC machine.
.SH OLD EMBEDDING
.PP
For example, to create a bundle for hello world, use the following

25
man/mono-symbolicate.1
View File

@@ -9,26 +9,23 @@
mono-symbolicate \- Mono Symbolicate Tool
.SH SYNOPSIS
.PP
.B mono-symbolicate exefile stacktracesfile [directories...]
.B mono-symbolicate <msym dir> <input file>
.PP
.B mono-symbolicate store-symbols <msym dir> [<dir>]+
.SH DESCRIPTION
mono-symbolicate is a tool that converts a stack trace with <filename unknown>:0
into one with file names and line numbers.
.PP
The output of calling this tool will be the provided
.I stacktracesfile
where <filename unknown>:0 parts are replaced by
a file name and a line number.
When mono-symbolicate is called with a symbol directory and a file containing a stacktrace:
.P
.B mono-symbolicate <msym dir> <input file>
.PP
For the tool to work it needs to load referenced assemblies, it will first look
in the same folder as
.I exefile
then from one of the provided
.I directories.
The tool writes into stdout the file contents while adding file location to stack frames when
it is possible to symbolicate with the symbols available on the symbol directory.
.PP
The tool assumes that the folder with a referenced assembly called for example
name.dll will also include name.dll.mdb,
if the referenced assembly is AOT compiled then the tool is also expecting to find
name.dll.msym.
Managed symbols .exe/.dll can be added to the symbol directory by doing:
.P
.B mono-symbolicate store-symbols <msym dir> [<dir>]+
.SH AUTHOR
Written by Marcos Henrich
.SH COPYRIGHT

50
man/mono.1
View File

@@ -142,10 +142,10 @@ instead of going through the operating system symbol lookup operation.
.I llvm-path=<PREFIX>
Same for the llvm tools 'opt' and 'llc'.
.TP
.I gen-seq-points-file=FILE.msym
.I msym-dir=<PATH>
Instructs the AOT compiler to generate offline sequence points .msym files.
The path is optional, if none is passed then a .msym file will be generated
next to the input assembly.
The generated .msym files will be stored into a subfolder of <PATH> named as the
compilation AOTID.
.TP
.I mtriple=<TRIPLE>
Use the GNU style target triple <TRIPLE> to determine some code generation options, i.e.
@@ -154,8 +154,7 @@ only supported by the ARM backend. In LLVM mode, this triple is passed on to the
llc compiler.
.TP
.I nimt-trampolines=[number]
When compiling in full aot mthis data at startup
usingode, the IMT trampolines must be precreated
When compiling in full aot mode, the IMT trampolines must be precreated
in the AOT image. You can add additional method trampolines with this argument.
Defaults to 128.
.TP
@@ -1095,11 +1094,6 @@ 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_ENABLE_SHM\fR
Unix only: Enable support for cross-process handles. Cross-process
handles are used to expose process handles, thread handles, named
mutexes, named events and named semaphores across Unix processes.
.TP
\fBMONO_ENV_OPTIONS\fR
This environment variable allows you to pass command line arguments to
a Mono process through the environment. This is useful for example
@@ -1514,24 +1508,6 @@ For a complete description of recommended practices for application
deployment, see
http://www.mono-project.com/docs/getting-started/application-deployment/
.TP
\fBMONO_RTC\fR
Experimental RTC support in the statistical profiler: if the user has
the permission, more accurate statistics are gathered. The MONO_RTC
value must be restricted to what the Linux rtc allows: power of two
from 64 to 8192 Hz. To enable higher frequencies like 4096 Hz, run as root:
.nf
echo 4096 > /proc/sys/dev/rtc/max-user-freq
.fi
.Sp
For example:
.nf
MONO_RTC=4096 mono --profiler=default:stat program.exe
.fi
.TP
\fBMONO_SHARED_DIR\fR
If set its the directory where the ".wapi" handle state is stored.
This is the directory where the Windows I/O Emulation layer stores its
@@ -1639,6 +1615,10 @@ option.
When this option is set, the runtime will invalidate the domain memory
pool instead of destroying it.
.TP
\fBdisable_omit_fp\fR
Disables a compiler optimization where the frame pointer is omitted
from the stack. This optimization can interact badly with debuggers.
.TP
\fBdont-free-domains\fR
This is an Optimization for multi-AppDomain applications (most
commonly ASP.NET applications). Due to internal limitations Mono,
@@ -1672,11 +1652,11 @@ Automatically generates sequence points where the
IL stack is empty. These are places where the debugger can set a
breakpoint.
.TP
\fBgen-compact-seq-points\fR
This option generates sequence points data that maps native offsets to
IL offsets. Sequence point data is used to display IL offset in
stacktraces. Stacktraces with IL offsets can be symbolicated using
mono-symbolicate tool.
\fBno-compact-seq-points\fR
Unless the option is used, the runtime generates sequence points data that
maps native offsets to IL offsets. Sequence point data is used to
display IL offset in stacktraces. Stacktraces with IL offsets can be
symbolicated using mono-symbolicate tool.
.TP
\fBhandle-sigint\fR
Captures the interrupt signal (Control-C) and displays a stack trace
@@ -1806,6 +1786,10 @@ Enables the maximum JIT verbosity for the specified method. This is
very helpfull to diagnose a miscompilation problems of a specific
method.
.TP
\fBMONO_JIT_DUMP_METHOD\fR
Enables sending of the JITs intermediate representation for a specified
method to the IdealGraphVisualizer tool.
.TP
\fBMONO_VERBOSE_HWCAP\fR
If set, makes the JIT output information about detected CPU features
(such as SSE, CMOV, FCMOV, etc) to stdout.

24
man/mprof-report.1
View File

@@ -137,9 +137,9 @@ to the control port
.IP \[bu] 2
\f[I]sample[=TYPE[/FREQ]]\f[]: collect statistical samples of the
program behaviour.
The default is to collect a 1000 times per second the instruction
pointer.
This is equivalent to the value \[lq]cycles/1000\[rq] for
The default is to collect a 100 times per second (100 Hz) the
instruction pointer.
This is equivalent to the value \[lq]cycles/100\[rq] for
\f[I]TYPE\f[].
On some systems, like with recent Linux kernels, it is possible to
cause the sampling to happen for other events provided by the
@@ -171,6 +171,24 @@ TIMER can have the following values:
collect \f[I]NUM\f[] frames at the most.
The default is 8.
.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