.TH ogo-xmlrpcd 8 "October 2004" OpenGroupware.org "User Manuals"
.\" Copyright (c) 2004 Helge Hess. All rights reserved.
.\" ====================================================================
.\"
.\" Copyright (c) 2004 Helge Hess.  All rights reserved.
.\"
.\" Check the COPYING file for further information.
.\"
.\" Created with the help of:
.\"   http://www.schweikhardt.net/man_page_howto.html
.\"

.SH NAME
ogo-xmlrpcd-1.0a \- OGo XML-RPC protocol server
.SH SYNOPSIS
.B ogo-xmlrpcd-1.0a 
[
.BI \-WOPort " port"
]

.SH DESCRIPTION
The
.B ogo-xmlrpcd-1.0a
server can be used to access the OpenGroupware.org functionality and database
using the XML-RPC protocol.
.PP
Note that you should not connect
.B ogo-xmlrpcd-1.0a
directly on its port using your client, but rather use
.B mod_ngobjweb
in combination with
.B Apache.

.SH OPTIONS
.TP 12
.IP "-WOPort port"
This option sets the TCP/IP port the
.B ogo-xmlrpcd-1.0a
server is running on and which the mod_ngobjweb will connect to.

.SH FILES
.I /etc/opengroupware.org/NSGlobalDomain.plist
.RS
This file contains configurations which apply to all OpenGroupware.org
related daemons. This includes settings like the database connection
dictionary or the path where preferences of OGo accounts are stored.
.RE
.I /etc/opengroupware.org/ogo-xmlrpcd-1.0a.plist
.RS
Configurations contained in this file overwrite those in the NSGlobalDomain.
You can persist any command line option in this file using the
.BR Defaults (5)
tool.
.RE

.SH BUGS
Bugs of the XML-RPC interface are collected in the OpenGroupware.org Bugzilla:
  http://bugzilla.opengroupware.org/

.SH AUTHOR
Helge Hess <helge.hess@opengroupware.org>

.SH SEE ALSO
.BR httpd (8),
.BR ogo-webui (8),
.BR ogo-zidestore (8),
.BR Defaults (5).

.SH HISTORY
The XML-RPC interface was introduced in SKYRiX 4.1 as a language agnostic
way to script the groupware functionality. It replaced the previously used
Python/ObjC interface which was difficult to set up, insecure and bound to
a specific language (Python).
The xmlrpcd server opened OGo for almost any programming language available.