diff options
author | Timo Weingärtner <timo@tiwe.de> | 2014-02-18 18:25:08 +0100 |
---|---|---|
committer | Timo Weingärtner <timo@tiwe.de> | 2014-02-18 18:30:01 +0100 |
commit | f8b47031fd65b9055e6a89a961466bdb367cd710 (patch) | |
tree | d441d5fcf784e4ad901918657b94552a4f5403b7 /README | |
parent | c4c47613070b81b95434b03b6cda74daa76aada6 (diff) | |
download | openssh-known-hosts-f8b47031fd65b9055e6a89a961466bdb367cd710.tar.gz |
Documentation update, license clarification
use pandoc for manpage generation, drop now-redundant README
Diffstat (limited to 'README')
-rw-r--r-- | README | 41 |
1 files changed, 0 insertions, 41 deletions
@@ -1,41 +0,0 @@ -Writing a source definition: -============================ - -Place a file in /etc/openssh-known-hosts/sources. Its name must follow -run-parts' conventions. - -Basic variables: - * PLUGIN: name of the plugin to use - * EXIT_IGNORE: space-seperated list of exitcodes which should be ignored, no - update is performed for this source then (optional) - -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: -================= - -Place an executeable in /usr/local/share/openssh-known-hosts/plugins. Your -plugin gets the variables set in the source definition in its environment. The -working directory will be set to the source's cache directory. All your plugin -has to do is to create a file named "new". "current" must not be touched but -can be used as a hint to skip downloading the same file again. stdout and -stderr will be connected to "log", which will be output on error. You needn't -create "new" if it would be identical to "current". - |