From Linux Man Pages
NAME
mod_mono - apache module that enables ASP.NET pages. Works together
with mod-mono-server.exe
DESCRIPTION
mod_mono is a simple module that works with both 1.3 and 2.0 versions
of apache.
It needs mod-mono-server.exe installed on the system. By default, it
will attemp to run mod-mono-server.exe if it doesn't find it's running.
CONFIGURATION DIRECTIVES
All the directives but MonoSetServerAlias accept an optional first
argument that is the mod-mono-server instance alias for which the
directive applies. If only one argument is provided for them, thr
directive will apply to the 'default' mod-mono-server instance. Refer
to the monodoc documentation on configuring mod_mono for more examples.
MonoUnixSocket
It accepts a file name as argument. That file will be a named
pipe used to send/receive data from/to mod_mono to/from mod-
mono-server. You cannot use MonoListenPort and MonoUnixSocket
at the same time. Default value: "/tmp/mod_mono_server".
MonoListenPort
TCP port on which mod-mono-server should listen/is listening on.
Mutually exclusive with MonoUnixSocket. When this options is
specified, mod-mono-server and mod_mono will use a TCP socket
for communication. Default value: none
MonoListenAddress
IP address where mod-mono-server should listen/is listening on.
Can only be used when MonoListenPort is specified. Default
value: "127.0.0.1"
MonoRunXSP
If the value is True, it tells mod_mono to spawn mod-mono-
server.exe if it's not already running. If set to False, most of
these directives are useless. Default value: True
MonoExecutablePath
The full path to mono executable. Default value:
"/usr/bin/mono"
MonoPath
This value will be used to set the MONO_PATH environment vari-
able. Default value: ""
MonoServerPath
The full path to mod-mono-server.exe. Default value:
"/usr/bin/mod-mono-server.exe"
MonoWapiDir
The directory where mono runtime will create the ".wapi" direc-
tory used to emulate windows I/O. It's used to set
MONO_SHARED_DIR. Default value: "/tmp"
MonoDocumentRootDir
The directory passed in --root argument when launching mod-mono-
server.
MonoMaxCPUTime
If MonoRunXSP is True, CPU time limit in seconds allowed for the
spawned mono process. Beyond that, it will be restarted. If this
capability is not available on your system, the directive will
be ignored. Default value: system default
MonoMaxMemory
If MonoRunXSP is True, the maximum size of the process's data
segment (data size) in bytes allowed for the spawned mono pro-
cess. It will be restarted when the limit is reached. If this
capability is not available on your system, the directive will
be ignored. Default value: system default
MonoApplications
AddMonoApplications
This value will be passed to mod-mono-server.exe in the --appli-
cations option. See xsp(1) manual page for details.
MonoApplicationsConfigFile
The argument passed in --appconfigfile argument to mod-mono-
server. Default value: NULL.
MonoApplicationsConfigDir
The argument passed in --appconfigdir argument to mod-mono-
server. Default value: config/mod-mono-applications
Note that you must specify at least one of MonoApplications, MonoAppli-
cationsConfigFile and MonoApplicationsConfigDir.
MonoDebug
Runs mono in debug mode, which produces stack traces with line
numbers. Default value: false.
MonoSetServerAlias
Takes a server alias name. This is to be used inside <Directory>
or <Location>. Default value: 'default' if the directive is not
used.
MonoSetEnv
Takes a string of 'name=value' pairs separated by semicolons.
For each pair, it calls setenv (name, value) before running mod-
mono-server.
SAMPLE CONFIGURATION
This one using <Directory>:
LoadModule mono_module /usr/lib/apache/1.3/libmod_mono.so
AddModule mod_mono.c
Alias /mono "/usr/share/doc/xsp/test"
AddMonoApplications default "/mono:/usr/share/doc/xsp/test"
<Directory /usr/share/doc/xsp/test>
SetHandler mono
<IfModule mod_dir.c>
DirectoryIndex index.aspx
</IfModule>
</Directory>
This one using <Location>:
LoadModule mono_module modules/libmod_mono.so
Alias /demo "/usr/share/doc/xsp/test"
AddMonoApplications default "/demo:/usr/share/doc/xsp/test"
<Location /demo>
SetHandler mono
</Location>
If you prefer to .webapp configuration file(s) (see manual page of
xsp), you can change MonoApplications in the above samples by:
MonoApplicationsConfigFile default "/var/www/applications.webapp"
replacing the path to the file with yours.
If you want to use several .webapp files, use this instead:
MonoApplicationsConfigDir default "/var/www/webapp"
and all the .webapp files found in the directory /var/www/webapp will
be loaded.
Refer to monodoc documentation on configuring mod_mono for more exam-
ples.
ENVIRONMENT VARIABLES
It may modify MONO_PATH, PATH and MONO_SHARED_DIR when starting mod-
mono-server.
FILES
httpd.conf
MAILING LISTS
See http://mail.ximian.com/mailman/mono-list for details.
WEB SITE
Visit http://www.go-mono.com for details.
RELATED
xsp(1),mod-mono-server(1),mono(1),mcs(1)
CATEGORY