SYNOPSIS

[-hX ] [-u username ] [-g groupname ] [-T twistd ] [-f carddavd.plist ]

DESCRIPTION

is a front end to the Darwin Address Book Server. The Darwin Address Book Server is a web server which implements the HTTP, WebDAV, WebDAV ACL, and CardDAV protocols.

is a simple tool for starting the server.

OPTIONS

-h

Displays usage information

-X

Starts the server but does not daemonize it.

-u username

Drops privileges to the given username.

-g groupname

Drops privileges to the given groupname.

-f carddavd.plist

Specifies the path of the configuration file to read.

-T twistd

Specifies the path to the twistd binary.

FILES

/etc/carddavd/carddavd.plist

The Address Book Server configuration file. It is an XML property list specifying server options such as the port to bind to, whether to use SSL, and the names of other configuration files.

/etc/carddavd/server.pem

PEM-format server keys for use with SSL.

/Library/AddressBookServer/Documents

The server's document root, which is used as the backing store for the HTTP resources on the server.

/var/log/carddavd/access.log

The server's access log file, in a format similar to Apache HTTPd's access log.

/var/log/carddavd/error.log

The server's main log file.

/var/run/carddavd.pid

The server's process ID file.

/usr/share/carddavd

Server implementation and support files.

STANDARDS

complies with draft-ietf-vcarddav-carddav (CardDAV), RFC 2518 (WebDAV) and RFC 3744 (WebDAV ACL).

HISTORY

was first introduced as part of Darwin 10 and Mac OS 10.6.