|
|
thinglaunch.1 - thinglaunch - A simple command and password promtper for X11. |
|
|
 |
git clone git://bitreich.org/thinglaunch (git://bitreich.org) |
|
|
 |
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 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 |
|