From 891c7069c0ca1cceeaee83d9e18b46b68f9a7aaa Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Thu, 19 Jan 2006 02:48:40 +0000 Subject: big doc update git-svn-id: file:///home/lennart/svn/public/mod_dnssd/trunk@16 634eccf8-0006-0410-930e-e16565b0b7de --- doc/README.html.in | 84 ++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 79 insertions(+), 5 deletions(-) (limited to 'doc/README.html.in') diff --git a/doc/README.html.in b/doc/README.html.in index 6098dca..72d9679 100644 --- a/doc/README.html.in +++ b/doc/README.html.in @@ -71,17 +71,91 @@ 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 + +

Advanced Features

+ +

Five 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. +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.

+<VirtualHost> or <Location> section +can be used to define additional services for publishing or to +finetune the service name or types of virtual hosts. If placed inside +a <VirtualHost> you can change the service types and +name of the attached service (if used with +DNSSDAutoRegisterVHosts set to on) or to register a +service for the virtual host (if used with +DNSSDAutoRegisterVHosts disabled). DNSSDServiceTypes +takes a list of at least one DNS-SD service type (defaults to +_http._tcp). A good example when to pass more than one +service type is a WebDAV server:

+ +
+DNSSDServiceTypes _http._tcp _webdav._tcp
+
+ +

This will register the server both as HTTP and as WebDAV +service. Please note that both services do have different types but +share the same name! Other areas where this might become handy is when registering RSS formatted blogs or XMLRPC services.

+ +

DNSSDServiceName and DNSSDServiceTypes are +especially useful inside a <Location> block. Using this +notation you can register additional services in subdirectories of the +server. A quick and incomplete example:

+ +
+...
+DNSSDEnable On
+DNSSDAutoRegisterVHosts On
+DNSSDAutoRegisterUserDir On
+
+<VirtualHost *>
+    DocumentRoot /var/www
+    DNSSDServiceName "Our Little Home Web Server"
+
+    <Location /doc>
+        DNSSDServiceName "Documentation"
+        ...
+    </Location>
+
+    <Location /squirrelmail>
+        DNSSDServiceName "Webmail"
+        ...
+    </Location>
+
+    <Location /webdav>
+        DAV On
+        DNSSDServiceName "Our WebDAV folder"
+        DNSSDServiceTypes _webdav._tcp _http._tcp
+        ...
+    </Location>
+
+    <Location /blog.rss>
+        DNSSDServiceName "The Blog"
+        DNSSDServiceTypes _rss._tcp
+        ...
+    </Location>
+
+    ...
+</VirtualHost>
+
+...
+
+ +

This will register six services: Our Little Home Web Server, +Documentation, Webmail and Our WebDAV folder as +type _http._tcp, Our WebDAV folder a second time under +the type _webdav._tcp and finally The Blog as type +_rss._tcp.

+ +

The directive DNSSDServicePort can be used to tell +mod_dnssd the right port number in complicated setups, where +it fails to detect the correct one to use. It is seldomly used and you +probably shouldn't bother.

Requirements

-- cgit