From: Ian Jackson <ijackson@chiark.greenend.org.uk>
Date: Sun, 10 Jun 2012 21:47:29 +0000 (+0100)
Subject: extend the example
X-Git-Tag: debian/2.1.1~5
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?p=authbind.git;a=commitdiff_plain;h=4fb8dbb04eb972be4957cdc573b7e9ef0e8ca84a;ds=sidebyside

extend the example
---

diff --git a/authbind.1 b/authbind.1
index 2cc5a75..4376a53 100644
--- a/authbind.1
+++ b/authbind.1
@@ -104,16 +104,6 @@ each 16-byte chunk expressed in the minimal nonzero number
 of hex digits (i.e. with leading zeroes removed), the chunks
 being separated by colons as is conventional.
 .PP
-So for example an attempt to bind to [2620:106:e002:f00f::21]:80
-would result in authbind calling
-.I access(2)
-on
-.B /etc/authbind/byport/80
-and then
-.B /etc/authbind/byaddr/2620:106:e002:f00f::21,80
-and then
-.BR /etc/authbind/byaddr/2620:106:e002:f00f:0:0:0:21,80 .
-.PP
 Fourthly, if the question is still unresolved, the file
 .BI /etc/authbind/byuid/ uid
 will be opened and read.  If the file does not exist then the binding
@@ -149,6 +139,30 @@ will fail with
 .B ENOENT
 .RI ( "No such file or directory" ).
 .PP
+So for example an attempt by uid 432
+to bind to [2620:106:e002:f00f::21]:80
+would result in authbind calling
+.I access(2)
+on, in order,
+.RS
+.B /etc/authbind/byport/80
+.br
+.B /etc/authbind/byaddr/2620:106:e002:f00f::21,80
+.br
+.B /etc/authbind/byaddr/2620:106:e002:f00f:0:0:0:21,80
+.RE
+If none of these files exist, authbind will read
+.RS
+.B /etc/authbind/byuid/432
+.RE
+and search for a line to permit
+the relevant access; examples of lines which would do so are:
+.RS
+.B 2620:106:e002:f00f::21,80
+.br
+.B ::/0,80
+.RE
+.PP
 If a read error occurs, or the directory
 .B /etc/authbind
 cannot be accessed, then not only will
diff --git a/debian/changelog b/debian/changelog
index b87f1b2..d3c6b8c 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,6 +1,6 @@
 authbind (2.1.1) unstable; urgency=low
 
-  * Manpage has an example of which files will be checked for IPv6.
+  * Manpage has an example of which files will be checked and read
     Closes: #676540.
 
  --