thinglaunch.1 - thinglaunch - A simple command and password promtper for X11.
HTML git clone git://bitreich.org/thinglaunch
DIR Log
DIR Files
DIR Refs
DIR Tags
DIR 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 do
21 various things with it. It is used as password prompt, execution prompt and
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 renaming
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 or
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 to
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 secured
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 <matt@ucc.asn.au> (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 <20h@r-36.net>.
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 20h@R-36.net
137