xsp(1)

NAME
XSP - Mono ASP.NET Web Server

SYNOPSIS
mono xsp.exe [options]

or

mono mod-mono-server.exe [options]

DESCRIPTION
XSP and mod-mono-server are both hosts for ASP.NET-based applications.

If run as `xsp', the process provides a minimalistic web server which hosts the ASP.NET runtime and can be used to test and debug web applications that use the System.Web facilities in Mono. This server is most convenient for testing and running small sites, does not offer everything a production web server offers.

`mod-mono-server' is an ASP.NET runtime host that can communicate with another web server (at the time of this writing Apache 1.3 and Apache 2.0 were supported). This mechanism is better used for high-traffic servers or production systems, since it can integrate with the main HTTP server and leverage all of the optimizations and extensions of an existing server, while providing the ASP.NET runtime.

OPTIONS

--port PORT (xsp only)
    Changes the default port where the XSP server will listen to requests. By default XSP listens on port 8080. AppSettings key name: MonoServerPort

--address addr (xsp only)
    Sets the IP address to listen on. By default it's 0.0.0.0. AppSettings key name: MonoServerAddress

--filename file (mod-mono-server only)
    The unix socket file name to listen on. Default value: /tmp/mod_mono_server AppSettings key name: UnixSocketFileName

--root PATH
    The root directory for XSP. The default is the directory where XSP is executed. The current directory will be changed to this one before creating any application. AppSettings key name: MonoServerRootDir

--appconfigfile FILENAME
    Adds application definitions from the XML configuration file. See sample configuration file that comes with the server (sample.webapp) and WEBAPP FILE FORMAT below. AppSettings key name: MonoApplicationsConfigFile

--appconfigdir DIR
    Adds application definitions from all XML files found in the specified directory DIR. Files must have '.webapp' extension. AppSettings key name: MonoApplicationsConfigDir

--applications APPS
    A semicolon separated list of virtual directory and real directory for all the applications we want to manage with this server. The virtual and real dirs. are separated by a colon. The default value is '/:.'.

Some examples:

'/:.'
    The virtual / is mapped to the current directory.

'/blog:../myblog'
    The virtual /blog is mapped to ../myblog

'/:.,/blog:../myblog'
    Two applications like the above ones are handled.

myhost.someprovider.net:/blog:../myblog
    The virtual /blog at myhost.someprovider.net is mapped to ../myblog.

--nonstop
    This applies only to xsp.exe: by default xsp will stop processing requests when the return key is pressed. Use this to avoid this behavior.

--version
    Displays version information and exits.

--help
    Shows the list of options and exits.

--verbose
    Prints extra messages. Useful for debugging.

DEFAULT INDEX FILES
You can choose which files are considered as index using xsp.exe.config configuration file like this:
    <appSettings>
    <add key="MonoServerDefaultIndexFiles"
         value="index.aspx" />
    </appSettings>
By default, it has index.aspx, Default.aspx, default.aspx, index.html and index.htm. The order matters.

WEBAPP FILE FORMAT
The format of the .webapp files used for --appconfigfile and --appconfigdir is:
<apps>
<web-application>
        <name>{appname}</name>
        <vhost>{virtual host for application}</vhost>
        <vport>{port for the application}</vport>
        <vpath>{virtual directory in apache}</vpath>
        <path>{physical path to aspx files}</path>
</web-application>
</apps>
You can include any number of <web-application> nodes, one per ASP.NET application to run. There's a sample.webapp file in the XSP samples directory.

AUTHORS
The Mono XSP server was written by Gonzalo Paniagua Javier (gonzalo@ximian.com).

SEE ALSO
mono(1),dbsessmgr(1),asp_state(1),mod_mono(8)

System.Web, System.Web.Hosting namespaces.

http://www.asp.net is Microsoft's official site for ASP.NET

MORE INFORMATION
The Mono project (http://www.go-mono.com) is a collaborative effort led by Novell (http://www.novell.com) to implement an open source version of the .NET Framework.