.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "SECRET-QUERY" "1" "10 March 2003" "Quintuple Agent" ""

.SH NAME
secret-query \- Ask for a secret in a secure way
.SH SYNOPSIS

\fBsecret-query\fR [ \fB\fIOPTION\fB\fR\fI ...\fR ] [ \fB\fIQUESTION\fB\fR ]

.SH "DESCRIPTION"
.PP
The \fBsecret-query\fR program will pop up a window,
asking for the entry of a secret. It is usually called by
\fBq-agent\fR, or \fBq-client\fR when no terminal
interaction with the user is possible. You can use it for other
things, too, as the interface is very simple, and in the default mode
not specific to the Quintuple Agent suite.
.PP
If \fIQUESTION\fR is given, it will be used as the
prompt text in the window.
.PP
All the necessary precautions are taken so that your secret
stays that way while under control of \fBsecret-query\fR: the
keyboard is grabbed to prevent sniffing, an amount of memory is locked (if
possible) so that paging will not write the secret to disk.
.PP
After a secret has been entered and the OK button
is pressed, \fBsecret-query\fR will output the secret to stdout,
and exit with code 0.
.PP
Cancelling entry with the appropriate button or by closing
the window will produce an exit code of 1.
.TP
\fB-g, --no-global-grab\fR
usually, as soon as the query window appears the
keyboard is grabbed, diverting any keyboard input to
\fBsecret-query\fR - this option will prevent grabbing until the
query window gets keyboard focus by normal means. This retains
security, while doing away with the somewhat obnoxious
snatching-from-under-your-fingers aspect
.TP
\fB-e, --enhanced\fR
turns on the enhanced interface, normally only useful
to \fBq-agent\fR: time-to-live and other options are queried
along with the secret, and later output in rfc822-like
\fIKeyword\fR: \fIValue\fR style
.TP
\fB-d, --debug\fR
turn on debugging output
.TP
\fB--help\fR
print a usage synopsis, then exit
.TP
\fB--version\fR
print version information, then exit
.SH "SEE ALSO"

\fBq-agent\fR(1)

\fBq-client\fR(1)
.SH "AUTHOR"
.PP
Robert Bihlmeyer <robbe@orcus.priv.at>
.SH "COPYRIGHT"
.PP
Copyright © 2000 Robert Bihlmeyer
.PP
This is free software; see the source for copying
conditions. There is \fBno\fR warranty; not even for
\fBmerchantability\fR or \fBfitness for a
particular purpose\fR.