diff options
| -rw-r--r-- | Makefile | 7 | ||||
| -rw-r--r-- | afssh.1.md | 38 |
2 files changed, 43 insertions, 2 deletions
@@ -21,7 +21,10 @@ CXXFLAGS ?= -g -O2 -Wall -Wold-style-cast CXXFLAGS += -std=c++11 LDFLAGS += -lboost_program_options -lboost_filesystem -lboost_system -lnettle -all: ssh-agent-filter.1 +all: ssh-agent-filter.1 afssh.1 + +%.1: %.1.md + pandoc -s -w man $< -o $@ ssh-agent-filter.1: ssh-agent-filter help2man -n $< -o $@ -N ./$< @@ -34,6 +37,6 @@ version.h: test ! -d .git || git describe | sed 's/^.*$$/#define SSH_AGENT_FILTER_VERSION "ssh-agent-filter \0"/' > $@ clean: - $(RM) ssh-agent-filter.1 ssh-agent-filter *.o + $(RM) *.1 ssh-agent-filter *.o .PHONY: version.h diff --git a/afssh.1.md b/afssh.1.md new file mode 100644 index 0000000..5d17d2e --- /dev/null +++ b/afssh.1.md @@ -0,0 +1,38 @@ +% AFSSH(1) +% Timo Weingärtner <timo@tiwe.de> +% 2013-07-01 + +# NAME + +afssh - wrapper around ssh-agent-filter and ssh + +# SYNOPSIS + +*afssh* [*ssh-agent-filter options*] -- [*ssh arguments*] + +*afssh* -- [*ssh arguments*] + +# DESCRIPTION + +afssh (agent filtered ssh) start ssh-agent-filter(1), passing it the arguments given to afssh before the separator `--`. +If there are no arguments before `--`, whiptail(1) or dialog(1) is used to ask the user which keys to forward. + +After setting up the ssh-agent-filter(1) ssh(1) is started with `-A` and the rest of the arguments (after `--`). + +When ssh(1) exits, the ssh-agent-filter(1) is killed to not leave tons of them + +# OPTIONS + +-h, \--help +: prints a short usage description, then runs ssh-agent-filter(1) with `--help` and ssh(1) with `--help` + +\-- +: mandatory separator between the options passed to ssh-agent-filter(1) and those passed to ssh(1) + +# RETURN VALUES + +Returns the return value of ssh(1) unless setting up the ssh-agent-filter failed, in which case the return value might be any non-zero value. + +# SEE ALSO + +ssh-agent-filter(1), ssh(1), ssh-agent(1), ssh-add(1), whiptail(1), dialog(1) |