aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org>2014-09-26 23:34:25 +0300
committerSergey Poznyakoff <gray@gnu.org>2014-09-26 23:34:25 +0300
commitff44149876c41edb6bfb4f08df1de5e68b0adbb6 (patch)
tree349a1b23160e81647233c903018e4320efe3b9f2
parent8802b2f585911bf1a5eefcce1bf4e68bbdedaf6e (diff)
downloaddico-ff44149876c41edb6bfb4f08df1de5e68b0adbb6.tar.gz
dico-ff44149876c41edb6bfb4f08df1de5e68b0adbb6.tar.bz2
Document IPv6 support.
* NEWS: Updated. * doc/dico.texi: Document all ways of specifying sockets to listen on.
-rw-r--r--NEWS12
-rw-r--r--doc/dico.texi63
2 files changed, 57 insertions, 18 deletions
diff --git a/NEWS b/NEWS
index 5026564..1f7636d 100644
--- a/NEWS
+++ b/NEWS
@@ -1,5 +1,5 @@
-GNU Dico NEWS -- history of user-visible changes. 2013-12-18
-Copyright (C) 2008-2010, 2012, 2013 Sergey Poznyakoff
+GNU Dico NEWS -- history of user-visible changes. 2014-09-26
+Copyright (C) 2008-2010, 2012-2014 Sergey Poznyakoff
See the end of file for copying conditions.
Please send Dico bug reports to <bug-dico@gnu.org.ua>
@@ -7,6 +7,12 @@ Please send Dico bug reports to <bug-dico@gnu.org.ua>
Version 2.2.90 (Git)
+* IPv6 support
+
+* Guile 2.x support
+
+* Implement info and description for gcide dictionary.
+
Version 2.2, 2012-03-04
@@ -150,7 +156,7 @@ Initial version.
=========================================================================
Copyright information:
-Copyright (C) 2008, 2009, 2010 Sergey Poznyakoff
+Copyright (C) 2008-2010, 2012-2014 Sergey Poznyakoff
Permission is granted to anyone to make or distribute verbatim copies
of this document as received, in any medium, provided that the
diff --git a/doc/dico.texi b/doc/dico.texi
index 8c55707..6b38a10 100644
--- a/doc/dico.texi
+++ b/doc/dico.texi
@@ -1061,36 +1061,69 @@ Elements of @var{list} can have the following forms:
@table @asis
@item @var{host}:@var{port}
- Specifies an @acronym{IP}v4 socket to listen on. The @var{host}
-part is either a host name or an @acronym{IP} in ``dotted-quad''
-form. The @var{port} part is either a numeric port number or a
+ Specifies an @acronym{IP} (version 4 or 6) socket to listen on. The
+@var{host} part is either an @acronym{IPv4} in ``dotted-quad''
+notation, or an @acronym{IPv6} address in square brackets, or a host
+name. In the latter case, @command{dicod} will listen on all IP
+addresses corresponding to its @samp{A} or @samp{AAAA}
+@acronym{DNS} records.
+
+The @var{port} part is either a numeric port number or a
symbolic service name which is found in @file{/etc/services} file.
Either of the two parts may be omitted. If @var{host} is omitted,
-it defaults to @samp{0.0.0.0}, which means ``listen on all
-interfaces''. If @var{port} is omitted, it defaults to 2628. In this
-case the colon may be omitted, too.
+@command{dicod} will listen on all interfaces. If @var{port} is
+omitted, it defaults to 2628. In this case the colon may be omitted,
+too.
Examples:
@example
-listen localhost:2628;
-listen 127.0.0.1;
+listen dict.example.org:2628;
+listen 198.51.100.10;
+listen [2001:DB8::11];
listen :2628;
@end example
-@item @var{filename}
- Specifies the name of a @acronym{UNIX} socket to listen on.
-@end table
+@item inet://@var{host}:@var{port}
+@itemx inet4://@var{host}:@var{port}
+ Listen on @acronym{IPv4} socket. The @var{host} is either an
+@acronym{IP} address or a host name. In the latter case,
+@command{dicod} will start listening on all @acronym{IP} addresses
+from the @samp{A} records for this host.
+
+ Either @var{host} or @var{port} (but not both) can be omitted.
+Missing @var{host} defaults to @acronym{IPv4} addresses on all available
+network interfaces, and missing @var{port} defaults to 2628.
+
+ Example:
+
+@example
+listen inet4://198.51.100.10;
+@end example
+
+@item inet6://@var{host}:@var{port}
+ Listen on @acronym{IPv6} socket. The @var{host} is either an
+@acronym{IPv6} address in square brackets, or a host name. In the
+latter case, @command{dicod} will start listening on all @acronym{IP}
+addresses from the @samp{AAAA} records for this host.
- The following statement instructs @command{dicod} to listen on
-the address @samp{10.10.10.1}, port 2628 and on the @acronym{UNIX}
-socket @file{/var/run/dict}:
+ Either @var{host} or @var{port} (but not both) can be omitted.
+Missing @var{host} defaults to @acronym{IPv6} addresses on all available
+network interfaces, and missing @var{port} defaults to 2628.
+
+ Example:
@example
-listen (10.10.10.1, /var/run/dict);
+listen inet6://[2001:DB8::11];
@end example
+@item @var{filename}
+@itemx unix://@var{filename}
+ Specifies the name of a @acronym{UNIX} socket to listen on.
+@var{Filename} must be an absolute file name of the socket.
+@end table
+
@end deffn
@deffn {Configuration} pidfile @var{string}

Return to:

Send suggestions and report system problems to the System administrator.