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