GopherProxy

	thinglaunch.1 - thinglaunch - A simple command and password promtper for X11.
	git clone git://bitreich.org/thinglaunch
	Log
	Files
	Refs
	Tags
	LICENSE
	---
	thinglaunch.1 (2710B)
	---
	1 .Dd July 02, 2011
	2 .Dt THINGLAUNCH 1
	3 .Os
	4 .
	5 .Sh NAME
	6 .Nm thinglaunch
	7 .Nd a simple prompt for X11
	8 .
	9 .Sh SYNOPSIS
	10 .Nm
	11 .Bk -words
	12 .Op Fl o
	13 .Op Fl s
	14 .Op Fl p Ar prompt
	15 .Ek
	16 .
	17 .Sh DESCRIPTION
	18 .Bd -filled
	19 .Nm
	20 is a simple password prompt for X11, which will input a string and then …
	21 various things with it. It is used as password prompt, execution prompt …
	22 can be easily extended.
	23 .Ed
	24 .
	25 .Sh IMPLEMENTATION
	26 .Bd -filled
	27 Installation is as straighforward as grabbing the tar.gz file, extracting
	28 it and running
	29 .Qq "make; make install;"
	30 inside the
	31 .Qq "thinglaunch-*"
	32 directory.
	33 The prefix for the installation can easily set using
	34 .Qq "PREFIX=/usr make install".
	35 .Ed
	36 .
	37 .Sh OPTIONS
	38 .Nm
	39 options and default settings.
	40 .Pp
	41 .Bl -tag -width ".Fl test Ao Ar string Ac"
	42 .
	43 .It Fl o
	44 Print prompted string to stdout.
	45 .
	46 .It Fl s
	47 The input string will be shown as
	48 .Qq "*"
	49 instead of cleartext.
	50 .
	51 .It Fl p Ar prompt
	52 Specify the prompt, which should be shown before the text entry.
	53 .
	54 .El
	55 .
	56 .Sh CUSTOMIZATION
	57 .Bd -filled
	58 .Nm
	59 is customized by creating a custom config.h and (re)compiling the
	60 source code.
	61 .Ed
	62 .
	63 .Sh SYMLINKS
	64 .Bd -filled
	65 The behaviour of
	66 .Nm
	67 can be controlled using various symlinks to the main executable or by re…
	68 the executable.
	69 .Ed
	70 .Bd -filled
	71 When
	72 .Nm is run as
	73 .Qq "thingaskpass",
	74 then -s and -o are implied and a prompt of
	75 .Qq "secret> "
	76 is set. This is useful when used with
	77 .Qq "ssh-agent",
	78 which respects the
	79 .Ev SSH_ASKPASS
	80 environment variable.
	81 .Ed
	82 .Bd -filled
	83 Calling
	84 .Nm
	85 as
	86 .Qq "thingsudoaskpass"
	87 implies -s, -o and a prompt according to the first commandline parameter…
	88 .Qq "secret sudo> ".
	89 This mode is useful in conjunction with
	90 .Qq "sudo",
	91 which respects the
	92 .Ev SUDO_ASKPASS
	93 environment variable.
	94 .Ed
	95 .
	96 .Sh EXAMPLES
	97 .Bd -filled
	98 Get some input string and print it to stdout. The prompt will be changed…
	99 .Qq "to stdout> ".
	100 .Ed
	101 .Bd -literal
	102 % thinglaunch -s -o "to stdout> "
	103
	104 .Ed
	105 .Bd -filled
	106 Ask for a command, which will be executed. The entered string will be se…
	107 using
	108 .Qq "*".
	109 .Ed
	110 .Bd -literal
	111 % thinglaunch -s -p "secret cmd> "
	112
	113 .Ed
	114 .
	115 .Sh FILES
	116 LICENSE, config.def.h, config.h
	117 .
	118 .Sh HISTORY
	119 .Bd -filled
	120 .Nm
	121 was originally written and named by Matt Johnston <[email protected]> (See
	122 LICENSE.orig for the original LICENSE note). Nearly all code was then
	123 changed to fit what you see now, by Christoph Lohmann <[email protected]>.
	124 .Ed
	125 .
	126 .Sh AUTHORS
	127 See LICENSE file for authors in the distribution.
	128 .
	129 .Sh LICENSE
	130 .Nm
	131 is released under the MIT/X Consortium License.
	132 .
	133 .Sh BUGS
	134 .Ss "Reporting Bugs"
	135 Report bugs to:
	136 .An "Christoph Lohmann" Aq [email protected]
	137