thinglaunch

A simple command and password prompter for X11.
git clone git://r-36.net/thinglaunch
Log | Files | Refs | 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