summaryrefslogtreecommitdiff
path: root/debian/README
diff options
context:
space:
mode:
Diffstat (limited to 'debian/README')
-rw-r--r--debian/README22
1 files changed, 22 insertions, 0 deletions
diff --git a/debian/README b/debian/README
new file mode 100644
index 0000000..8a521a8
--- /dev/null
+++ b/debian/README
@@ -0,0 +1,22 @@
+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)
+
+
+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.
+