iREADME.md is gone. Added manpage. - thinglaunch - A simple command and password promtper for X11. Err bitreich.org 70 hgit clone git://bitreich.org/thinglaunch URL:git://bitreich.org/thinglaunch bitreich.org 70 1Log /scm/thinglaunch/log.gph bitreich.org 70 1Files /scm/thinglaunch/files.gph bitreich.org 70 1Refs /scm/thinglaunch/refs.gph bitreich.org 70 1Tags /scm/thinglaunch/tag bitreich.org 70 1LICENSE /scm/thinglaunch/file/LICENSE.gph bitreich.org 70 i--- Err bitreich.org 70 1commit 2a3aa8ec0c8405ec71937108765bef0faf6f4d49 /scm/thinglaunch/commit/2a3aa8ec0c8405ec71937108765bef0faf6f4d49.gph bitreich.org 70 1parent f709107300338c07130648c3eb03492aef3c2880 /scm/thinglaunch/commit/f709107300338c07130648c3eb03492aef3c2880.gph bitreich.org 70 hAuthor: Christoph Lohmann <20h@r-36.net> URL:mailto:20h@r-36.net bitreich.org 70 iDate: Sat, 2 Jul 2011 12:35:56 +0200 Err bitreich.org 70 i Err bitreich.org 70 iREADME.md is gone. Added manpage. Err bitreich.org 70 i Err bitreich.org 70 iDiffstat: Err bitreich.org 70 i M Makefile | 2 +- Err bitreich.org 70 i D README.md | 53 ------------------------------ Err bitreich.org 70 i A thinglaunch.1 | 129 +++++++++++++++++++++++++++++++ Err bitreich.org 70 i Err bitreich.org 70 i3 files changed, 130 insertions(+), 54 deletions(-) Err bitreich.org 70 i--- Err bitreich.org 70 1diff --git a/Makefile b/Makefile /scm/thinglaunch/file/Makefile.gph bitreich.org 70 i@@ -39,7 +39,7 @@ clean: Err bitreich.org 70 i dist: clean Err bitreich.org 70 i @echo creating dist tarball Err bitreich.org 70 i @mkdir -p ${NAME}-${VERSION} Err bitreich.org 70 i- @cp -R LICENSE LICENSE.orig Makefile README.md config.mk \ Err bitreich.org 70 i+ @cp -R LICENSE LICENSE.orig ${NAME}.1 Makefile config.mk \ Err bitreich.org 70 i ${SRC} *.h ${NAME}-${VERSION} Err bitreich.org 70 i @tar -cf ${NAME}-${VERSION}.tar ${NAME}-${VERSION} Err bitreich.org 70 i @gzip ${NAME}-${VERSION}.tar Err bitreich.org 70 1diff --git a/README.md b/README.md /scm/thinglaunch/file/README.md.gph bitreich.org 70 i@@ -1,53 +0,0 @@ Err bitreich.org 70 i-# Thinglaunch - a simple entry box for X11 Err bitreich.org 70 i- Err bitreich.org 70 i-The first intention, as done by the original creator Matt Johnston Err bitreich.org 70 i-, was to launch simple commandlines. Err bitreich.org 70 i- Err bitreich.org 70 i-In 2011 the single file project was extended by features like Unicode Err bitreich.org 70 i-support, a prompt and an ssh-askpass compatibility layer. Err bitreich.org 70 i- Err bitreich.org 70 i-## Installation Err bitreich.org 70 i- Err bitreich.org 70 i- % tar -xzvf thinglaunch-*.tar.gz Err bitreich.org 70 i- % cd thinglaunch Err bitreich.org 70 i- % make Err bitreich.org 70 i- % sudo PREFIX=/usr make install Err bitreich.org 70 i- Err bitreich.org 70 i-This will create the executable »thinglaunch« and »thingaskpass« in Err bitreich.org 70 i-»/usr/bin«. Thinglaunch will ask for a command and execute it and Err bitreich.org 70 i-thingaskpass can be used as a SSH_ASKPASS parameter value, which will Err bitreich.org 70 i-be used by ssh-agent to gather the password for private keys. Err bitreich.org 70 i- Err bitreich.org 70 i-## Usage Err bitreich.org 70 i- Err bitreich.org 70 i- # Get some input string and print it to stdout. There will Err bitreich.org 70 i- # be the prompt prepended "to stdout> ". Err bitreich.org 70 i- % thinglaunch -o -p "to stdout> " Err bitreich.org 70 i- Err bitreich.org 70 i- # Ask for a command, which will be executed. During entering Err bitreich.org 70 i- # the command, the entered string will be replaced by asterisks. Err bitreich.org 70 i- % thinglaunch -s -p "secret cmd> " Err bitreich.org 70 i- Err bitreich.org 70 i- # This symlink predefines -s, -o and -p "secret> ". Err bitreich.org 70 i- % ln -s thinglaunch thingaskpass Err bitreich.org 70 i- % ./thingaskpass Err bitreich.org 70 i- Err bitreich.org 70 i- # This symlink predefined -s, -o and takes the prompt as first Err bitreich.org 70 i- # argument. Err bitreich.org 70 i- % ln -s thinglaunch thingsudoaskpass Err bitreich.org 70 i- % ./thingsudoaskpass Err bitreich.org 70 i- Err bitreich.org 70 i-## SSH_ASKPASS Err bitreich.org 70 i- Err bitreich.org 70 i-If you set SSH_ASKPASS to the PATH to thingaskpass (usually /usr/bin/ Err bitreich.org 70 i-thingaskpass), then ssh-agent will use this command for asking for pass- Err bitreich.org 70 i-words. Err bitreich.org 70 i- Err bitreich.org 70 i-## SUDO_ASKPASS Err bitreich.org 70 i- Err bitreich.org 70 i-This is the same as SSH_ASKPASS, but here you need to set SUDO_ASKPASS Err bitreich.org 70 i-to the PATH to thingsudoaskpass (usually /usr/bin/thingsudoaskpass). Err bitreich.org 70 i- Err bitreich.org 70 i- Err bitreich.org 70 i-Have fun! Err bitreich.org 70 i- Err bitreich.org 70 1diff --git a/thinglaunch.1 b/thinglaunch.1 /scm/thinglaunch/file/thinglaunch.1.gph bitreich.org 70 i@@ -0,0 +1,129 @@ Err bitreich.org 70 i+.Dd July 02, 2011 Err bitreich.org 70 i+.Dt THINGLAUNCH 1 Err bitreich.org 70 i+.Os Err bitreich.org 70 i+. Err bitreich.org 70 i+.Sh NAME Err bitreich.org 70 i+.Nm thinglaunch Err bitreich.org 70 i+.Nd a simple prompt for X11 Err bitreich.org 70 i+. Err bitreich.org 70 i+.Sh SYNOPSIS Err bitreich.org 70 i+.Nm Err bitreich.org 70 i+.Bk -words Err bitreich.org 70 i+.Op Fl o Err bitreich.org 70 i+.Op Fl s Err bitreich.org 70 i+.Op Fl p Ar prompt Err bitreich.org 70 i+.Ek Err bitreich.org 70 i+. Err bitreich.org 70 i+.Sh DESCRIPTION Err bitreich.org 70 i+.Bd -filled Err bitreich.org 70 i+.Nm Err bitreich.org 70 i+is a simple password prompt for X11, which will input a string and then do Err bitreich.org 70 i+various things with it. It is used as password prompt, execution prompt and Err bitreich.org 70 i+can be easily extended. Err bitreich.org 70 i+.Ed Err bitreich.org 70 i+. Err bitreich.org 70 i+.Sh IMPLEMENTATION Err bitreich.org 70 i+.Bd -filled Err bitreich.org 70 i+Installation is as straighforward as grabbing the tar.gz file, extracting Err bitreich.org 70 i+it and running Err bitreich.org 70 i+.Qq "make; make install;" Err bitreich.org 70 i+inside the Err bitreich.org 70 i+.Qq "thinglaunch-*" Err bitreich.org 70 i+directory. Err bitreich.org 70 i+The prefix for the installation can easily set using Err bitreich.org 70 i+.Qq "PREFIX=/usr make install". Err bitreich.org 70 i+.Ed Err bitreich.org 70 i+. Err bitreich.org 70 i+.Sh OPTIONS Err bitreich.org 70 i+.Nm Err bitreich.org 70 i+options and default settings. Err bitreich.org 70 i+.Pp Err bitreich.org 70 i+.Bl -tag -width ".Fl test Ao Ar string Ac" Err bitreich.org 70 i+. Err bitreich.org 70 i+.It Fl o Err bitreich.org 70 i+Print prompted string to stdout. Err bitreich.org 70 i+. Err bitreich.org 70 i+.It Fl s Err bitreich.org 70 i+The input string will be shown as Err bitreich.org 70 i+.Qq "*" Err bitreich.org 70 i+instead of cleartext. Err bitreich.org 70 i+. Err bitreich.org 70 i+.Fl Fl p Ar prompt Err bitreich.org 70 i+Specify the prompt, which should be shown before the text entry. Err bitreich.org 70 i+. Err bitreich.org 70 i+.El Err bitreich.org 70 i+. Err bitreich.org 70 i+.Sh CUSTOMIZATION Err bitreich.org 70 i+.Bd -filled Err bitreich.org 70 i+.Nm Err bitreich.org 70 i+is customized by creating a custom config.h and (re)compiling the Err bitreich.org 70 i+source code. Err bitreich.org 70 i+.Ed Err bitreich.org 70 i+. Err bitreich.org 70 i+.Sh SYMLINKS Err bitreich.org 70 i+.Bd -filled Err bitreich.org 70 i+The behaviour of Err bitreich.org 70 i+.Nm Err bitreich.org 70 i+can be controlled using various symlinks to the main executable or by renaming Err bitreich.org 70 i+the executable. Err bitreich.org 70 i+.Ed Err bitreich.org 70 i+.Bd -filled Err bitreich.org 70 i+When Err bitreich.org 70 i+.Nm is run as Err bitreich.org 70 i+.Qq "thingaskpass", Err bitreich.org 70 i+then -s and -o are implied and a prompt of Err bitreich.org 70 i+.Qq "secret> " Err bitreich.org 70 i+is set. This is useful when used with Err bitreich.org 70 i+.Qq "ssh-agent", Err bitreich.org 70 i+which respects the Err bitreich.org 70 i+.Ev SSH_ASKPASS Err bitreich.org 70 i+environment variable. Err bitreich.org 70 i+.Ed Err bitreich.org 70 i+.Bd -filled Err bitreich.org 70 i+Calling Err bitreich.org 70 i+.Nm Err bitreich.org 70 i+as Err bitreich.org 70 i+.Qq "thingsudoaskpass" Err bitreich.org 70 i+implies -s, -o and a prompt according to the first commandline parameter or Err bitreich.org 70 i+.Qq "secret sudo> ". Err bitreich.org 70 i+This mode is useful in conjunction with Err bitreich.org 70 i+.Qq "sudo", Err bitreich.org 70 i+which respects the Err bitreich.org 70 i+.Ev SUDO_ASKPASS Err bitreich.org 70 i+environment variable. Err bitreich.org 70 i+.Ed Err bitreich.org 70 i+. Err bitreich.org 70 i+.Sh EXAMPLES Err bitreich.org 70 i+.Bd -filled Err bitreich.org 70 i+Get some input string and print it to stdout. The prompt will be changed to Err bitreich.org 70 i+.Qq "to stdout> ". Err bitreich.org 70 i+.Ed Err bitreich.org 70 i+.Bd -literal Err bitreich.org 70 i+ % thinglaunch -s -p "to stdout> " Err bitreich.org 70 i+ Err bitreich.org 70 i+.Ed Err bitreich.org 70 i+.Bd -filled Err bitreich.org 70 i+Ask for a command, which will be executed. The entered string will be secured Err bitreich.org 70 i+using Err bitreich.org 70 i+.Qq "*". Err bitreich.org 70 i+.Ed Err bitreich.org 70 i+.Bd -literal Err bitreich.org 70 i+ % thinglaunch -s -p "secret cmd> " Err bitreich.org 70 i+ Err bitreich.org 70 i+.Ed Err bitreich.org 70 i+. Err bitreich.org 70 i+.Sh FILES Err bitreich.org 70 i+LICENSE, config.def.h, config.h Err bitreich.org 70 i+. Err bitreich.org 70 i+.Sh AUTHORS Err bitreich.org 70 i+See LICENSE file for authors in the distribution. Err bitreich.org 70 i+. Err bitreich.org 70 i+.Sh LICENSE Err bitreich.org 70 i+.Nm Err bitreich.org 70 i+is released under the MIT/X Consortium License. Err bitreich.org 70 i+. Err bitreich.org 70 i+.Sh BUGS Err bitreich.org 70 i+.Ss "Reporting Bugs" Err bitreich.org 70 i+Report bugs to: Err bitreich.org 70 i+.An "Christoph Lohmann" Aq 20h@R-36.net Err bitreich.org 70 i+ Err bitreich.org 70 .