summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorTimo Weingärtner <timo@tiwe.de>2012-02-25 21:17:00 +0100
committerTimo Weingärtner <timo@tiwe.de>2012-02-25 21:17:00 +0100
commit4b444020fa50e4f22a427b981c582b35cdb4efb1 (patch)
treea7e31424e72b3a98053ca5b11206831cfd3322e2 /README
parent8f32f842b33bdc6617b41dc9f18b222fd3013e21 (diff)
downloadopenssh-known-hosts-4b444020fa50e4f22a427b981c582b35cdb4efb1.tar.gz
Imported Debian version 0.2debian/0.2
Diffstat (limited to 'README')
-rw-r--r--README24
1 files changed, 24 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..bcbbf4e
--- /dev/null
+++ b/README
@@ -0,0 +1,24 @@
+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)
+
+For examples see /usr/share/doc/openssh-known-hosts/examples/*.
+
+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".
+