From 3fa15050823dd70cf2d26983a5755b68408facd7 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Thu, 19 Jan 2006 01:58:29 +0000 Subject: add preliminary documentation git-svn-id: file:///home/lennart/svn/public/mod_dnssd/trunk@13 634eccf8-0006-0410-930e-e16565b0b7de --- doc/README.html.in | 128 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 128 insertions(+) create mode 100644 doc/README.html.in (limited to 'doc/README.html.in') diff --git a/doc/README.html.in b/doc/README.html.in new file mode 100644 index 0000000..6098dca --- /dev/null +++ b/doc/README.html.in @@ -0,0 +1,128 @@ + + + + + +mod_dnssd @PACKAGE_VERSION@ + + + + +

mod_dnssd @PACKAGE_VERSION@

+ +

Copyright 2006 Lennart Poettering <@PACKAGE_BUGREPORT@>

+ + + +

License

+ +

Copyright 2006 Lennart Poettering

+ +

Licensed under the Apache License, Version 2.0 (the "License"); you +may not use this file except in compliance with the License. You may +obtain a copy of the License at

+ +

    http://www.apache.org/licenses/LICENSE-2.0

+ +

Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or +implied. See the License for the specific language governing +permissions and limitations under the License.

+ +

News

+ +
Thu Jan 19 2006:

Version 0.1 released, +initial realease

+ +

Overview

+ +

mod_dnssd is an Apache +HTTPD module which adds Zeroconf support via DNS-SD using Avahi.

+ +

Status

+ +

Version @PACKAGE_VERSION@ is more or less stable and fulfills its purpose.

+ +

Documentation

+ +

For activating mod_dnssd just load it into the server and use the global directive DNSSDEnable to enable it:

+ +
+DNSSDEnable on
+
+ +

That's it, nothing more is required! The module publishes all +configured virtual hosts and the mod_userdir directories of +all local users. For mod_userdir to work you need to load +that module and configure it for the path ~/public_html/.

+ +

Four other directives are available: the global directive +DNSSDAutoRegisterUserDir can be used to disable automatic +registration of mod_userdir directories. The global directive +DNSSDAutoRegisterVHosts can be used to disable automatic +registration of all local virtual hosts. + +

The two directives DNSSDServiceName and +DNSSDServiceTypes which can be placed inside a +<VirtualHost> or a <Location> section +can be used to define additional services for publishing or to finetune +the service name or types of virtual hosts.

+ +

Requirements

+ +

mod_dnssd requires a current release of Apache 2.0 with +apxs and a development installation of Avahi 0.6 or newer.

+ +

mod_dnssd has been developed and tested on Debian GNU/Linux +"testing" from January 2006, it should work on most other Linux +distributions and probably POSIX implementations since it uses GNU +autoconf and Apache apxs for source code configuration.

+ +

Installation

+ +

As this package is made with the GNU autotools you should run +./configure inside the distribution directory for configuring +the source tree. After that you should run make for +compilation and make install (as root) for installation of +mod_dnssd.

+ +

Acknowledgements

+ +

This work was inspired by Sander Temme's and Sebastien Estienne's mod_zeroconf module.

+ +

Download

+ +

The newest release is always available from @PACKAGE_URL@

+ +

The current release is @PACKAGE_VERSION@

+ +

Get mod_dnssd's development sources from the Subversion repository (viewcvs):

+ +
svn checkout svn://svn.0pointer.net/mod_dnssd/trunk mod_dnssd
+ +

If you want to be notified whenever I release a new version of this software use the subscription feature of Freshmeat.

+ +
+ +
Lennart Poettering <@PACKAGE_BUGREPORT@>, January 2006
+ +
$Id$
+ + + -- cgit