From 8d177fb1f42cb80ffbf678669cd726d40f26f123 Mon Sep 17 00:00:00 2001
From: Timo Weingärtner <timo@tiwe.de>
Date: Fri, 4 Jan 2013 21:16:37 +0100
Subject: implement hostname filtering

Fixes GH-1.
---
 README | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

(limited to 'README')

diff --git a/README b/README
index 54c06ca..1953dd1 100644
--- a/README
+++ b/README
@@ -13,6 +13,21 @@ The rest of the variables is plugin-specific.
 
 For examples see /usr/share/doc/openssh-known-hosts/examples/*.
 
+Writing a hostname filter:
+==========================
+
+Place a file $source.filter next to your $source in
+/etc/openssh-known-hosts/sources.
+
+Each line shall contain a rule consisting of an action, a space and a pattern.
+The first rule with a matching pattern decides: If the action starts with a,
+o, p or y (for accept, admit, allow, ok, pass, permit, print, yes, ...) the
+hostname will be used, otherwise it is discarded. If a key has no hostnames
+left it is discarded as a whole.
+
+An example filter can be found in
+/usr/share/doc/openssh-known-hosts/examples/curl.filter.
+
 Writing a plugin:
 =================
 
-- 
cgit v1.2.3