]> thyrsus.com Git - ssh-installkeys.git/commitdiff
Initial revision
authorEric S. Raymond <esr@thyrsus.com>
Tue, 30 Dec 2003 00:05:19 +0000 (00:05 +0000)
committerEric S. Raymond <esr@thyrsus.com>
Tue, 30 Dec 2003 00:05:19 +0000 (00:05 +0000)
Makefile [new file with mode: 0644]
ssh-installkeys.xml [new file with mode: 0644]

diff --git a/Makefile b/Makefile
new file mode 100644 (file)
index 0000000..b43dbe4
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,32 @@
+# Makefile for the ssh-installkeys project
+
+# Don't forget to change the spec file when you bump the version number.
+VERS=$(shell sed <ssh-installkeys.spec -n -e '/Version: \(.*\)/s//\1/p')
+
+MANDIR=/usr/share/man/man1
+BINDIR=/usr/bin
+
+DOCS    = README COPYING ssh-installkeys.xml ssh-installkeys.1 TODO
+SOURCES = ssh-installkeys Makefile $(DOCS) ssh-installkeys.spec
+
+all: ssh-installkeys-$(VERS).tar.gz
+
+install: ssh-installkeys.1
+       cp ssh-installkeys $(BINDIR)
+       gzip <ssh-installkeys.1 >$(MANDIR)/ssh-installkeys.1.gz
+
+ssh-installkeys.1: ssh-installkeys.xml
+       xmlto man ssh-installkeys.xml
+
+ssh-installkeys.html: ssh-installkeys.xml
+       xmlto html-nochunks ssh-installkeys.xml
+
+ssh-installkeys-$(VERS).tar.gz: $(SOURCES) ssh-installkeys.1
+       mkdir ssh-installkeys-$(VERS)
+       cp $(SOURCES) ssh-installkeys.1 ssh-installkeys-$(VERS)
+       tar -czf ssh-installkeys-$(VERS).tar.gz ssh-installkeys-$(VERS)
+       rm -fr ssh-installkeys-$(VERS)
+       ls -l ssh-installkeys-$(VERS).tar.gz
+
+dist: ssh-installkeys-$(VERS).tar.gz ssh-installkeys.html
+       ln -sf ssh-installkeys-$(VERS).tar.gz ssh-installkeys.tar.gz
diff --git a/ssh-installkeys.xml b/ssh-installkeys.xml
new file mode 100644 (file)
index 0000000..7c0446a
--- /dev/null
@@ -0,0 +1,77 @@
+<!DOCTYPE refentry PUBLIC 
+   "-//OASIS//DTD DocBook XML V4.1.2//EN"
+   "docbook/docbookx.dtd">
+<refentry id='ssh-installkeys.1'>
+<refmeta>
+<refentrytitle>ssh-installkeys</refentrytitle>
+<manvolnum>1</manvolnum>
+</refmeta>
+<refnamediv id='name'>
+<refname> ssh-installkeys</refname>
+<refpurpose>install ssh keys on local and remote servers</refpurpose>
+</refnamediv>
+<refsynopsisdiv id='synopsis'>
+
+<cmdsynopsis>
+  <command>ssh-installkeys</command>  
+  <arg choice='opt'>-h</arg>
+  <arg choice='opt'>-c</arg>
+  <arg choice='opt'>-d</arg>
+  <arg choice='opt'>-v</arg>
+  <arg choice='plain' rep='repeat'><replaceable>name@host</replaceable></arg>
+</cmdsynopsis>
+
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+
+<para>This script tries to export ssh public keys to a specified site.
+It will walk the user through generating key pairs if it doesn't find
+any to export.  It handles all the fiddly details, like remembering
+the ssh keyfile names and making sure local and remote permissions are
+correct.  It tells you what it's doing if it has to change
+anything.</para>
+
+<para>The name@host argument is the name of the host where your
+public keys should be installed.  If it contains a @, the part before
+the @ will be clipped off and used as the login name. Otherwise your
+local login name will be used.</para>
+
+<para>Invoked with the <option>-h</option> option, the program prints
+a usage summary and exits.</para>
+
+<para>Invoked with the <option>-c</option> option, the program checks
+your local and remote ssh configuration for problems without changing
+anything.</para>
+
+<para>Invoked with the <option>-d</option> option, the program deletes
+any public keys under the specified login at the specified host.</para>
+
+<para>The <option>-v</option> option says to report all commands and
+responses during the session. It's mainly useful for debugging.</para>
+</refsect1>
+
+<refsect1><title>Requirements</title>
+<para><command>ssh-installkeys</command> was written in Python 2.2a1.  It
+will not work under Python 1.5.2. </para>
+</refsect1>
+
+<refsect1><title>See Also</title>
+<para><citerefentry><refentrytitle>ssh</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
+<citerefentry><refentrytitle>ssh-keygen</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+</refsect1>
+
+<refsect1><title>Author</title>
+<para>Eric S. Raymond <email>esr@thyrsus.com</email>.</para>
+
+<para>There is a project web page at
+<ulink
+url="http://www.catb.org/~esr/ssh-installkeys/">http://www.catb.org/~esr/ssh-installkeys/</ulink>.</para>
+</refsect1>
+</refentry>
+
+<!--
+Local Variables:
+compile-command: "make ssh-installkeys.html"
+End:
+-->