X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?p=authbind.git;a=blobdiff_plain;f=authbind.1;h=a7e13c4918d9a00d1c7e31a44acf02ba920cbec8;hp=74d44d727d9ec00931c4bd6ec1dc601a5b5c5066;hb=b00ea62e68f29d5adda57a02c873bd602a9be5ad;hpb=32f41fed121ea4fe4e9171c509691e1b16db13f8

diff --git a/authbind.1 b/authbind.1
index 74d44d7..a7e13c4 100644
--- a/authbind.1
+++ b/authbind.1
@@ -139,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
@@ -146,11 +170,11 @@ cannot be accessed, then not only will
 fail, but an error message will be printed to stderr.  Unrecognised
 lines in
 .BI /etc/authbind/byuid/ uid
-files are silently ignored (as are lines whose
+files are silently ignored, as are lines whose
 .I addr
 has non-zero bits more than
 .I length
-from the top) or where some
+from the top or where some
 .I min
 is larger than
 .IR max .