diff options
author | Sergey Poznyakoff <gray@gnu.org> | 2014-09-26 23:34:25 +0300 |
---|---|---|
committer | Sergey Poznyakoff <gray@gnu.org> | 2014-09-26 23:34:25 +0300 |
commit | ff44149876c41edb6bfb4f08df1de5e68b0adbb6 (patch) | |
tree | 349a1b23160e81647233c903018e4320efe3b9f2 | |
parent | 8802b2f585911bf1a5eefcce1bf4e68bbdedaf6e (diff) | |
download | dico-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-- | NEWS | 12 | ||||
-rw-r--r-- | doc/dico.texi | 63 |
2 files changed, 57 insertions, 18 deletions
@@ -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} |