thinglaunch.1 - thinglaunch - A simple command and password promtper for X11.
 (HTM) 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