Hi. I wrote the attached manpage for gpg-agent. It mainly contains information taken from gpg-agent --help, but it's far better than not having any documentation at all.
Please also note that despite your message for bug 300676, gnupg2.info is _not_ installed with the gnupg2 package, at least not with the version in Sarge (1.9.15-6, which is also currently the newest version available). Regards, Sven -- "Writing a book is like washing an elephant: there's no good place to begin or end, and it's hard to keep track of what you've already covered." -- Anonymous -- ------------------------ [ SECURITY NOTICE ] ------------------------ To: [EMAIL PROTECTED] For your security, [EMAIL PROTECTED] digitally signed this message on 15 August 2005 at 16:47:13 UTC. Verify this digital signature at http://www.ciphire.com/verify. ------------------- [ CIPHIRE DIGITAL SIGNATURE ] ------------------- Q2lwaGlyZSBTaWcuAVczMDAxMjlAYnVncy5kZWJpYW4ub3JnAHNtQGNpcGhpcmVsYWJzL mNvbQBlbWFpbCBib2R5ANcBAAB8AHwAAAABAAAAEccAQ9cBAABwAgACAAIAAgAg7o81B3 u7SGhY8TUyOasP5PM9L/eo5WaZF6DK9DcIKJkBAKe4iRF7xBuVS5ZEqDwPUnOnv+9OIOo KTcvFvXP3opHtE7miMtV6m/mRNMeZxtmEk6X2bsTyweWT9uc7NIylVWXOU2lnRW5k --------------------- [ END DIGITAL SIGNATURE ] ---------------------
.TH gpg-agent 1 .SH NAME gpg-agent \- Secret key management for GnuPG .SH SYNOPSIS .B gpg-agent [options] [command [args]] .SH DESCRIPTION .B gpg-agent handles secret keys for GnuPG similarly to what .BR ssh-agent(1) does for ssh keys. Most importantly, it allows clients which are aware of .B gpg-agent to access your keys (with .B gpg-agent automatically asking for the passphrase to the key in question. Passphrases you enter are cached and not asked for again but expire from the cache if not used for some configurable time (see .I --default-cache-ttl option). There are generally two ways to use it, one is to call it without specifying a command and .B gpg-agent will output a shell fragment for use with .I eval as in: .I eval `gpg-agent` The shell fragment will set the .I GPG_AGENT_INFO environment variable to allow subsequently started programs to access the agent. The other way to use .B gpg-agent is to call it with a command. In this case, gpg-agent directly sets the appropriate environment variable and subsequently starts the given command. This is particularly usefull when starting an X session from commandline, but can just as easily be integrated into the system Xsession scripts. .SH OPTIONS .TP 28 .B --server run in server mode (foreground) .TP 28 .B --daemon run in daemon mode (background) .TP 28 .B -v, --verbose verbose .TP 28 .B -q, --quiet be somewhat more quiet .TP 28 .B -s, --sh sh-style command output .TP 28 .B -c, --csh csh-style command output .TP 28 .B --options FILE read options from FILE .TP 28 .B --no-detach do not detach from the console .TP 28 .B --no-grab do not grab keyboard and mouse .TP 28 .B --log-file FILE use FILE as a log file for the server .TP 28 .B --disable-pth do not allow multiple connections .TP 28 .B --use-standard-socket use a standard location for the socket .TP 28 .B --pinentry-program PGM use PGM as the PIN-Entry program .TP 28 .B --scdaemon-program PGM use PGM as the SCdaemon program .TP 28 .B --keep-tty ignore requests to change the TTY .TP 28 .B --keep-display ignore requests to change the X display .TP 28 .B --default-cache-ttl N expire cached PINs after N seconds .TP 28 .B --ignore-cache-for-signing do not use the PIN cache when signing .TP 28 .B --allow-mark-trusted allow clients to mark keys as "trusted" .TP 28 .B --allow-preset-passphrase allow presetting passphrase .SH FILES ~/.gnupg/gpg-agent.conf .SH "SEE ALSO" .BR gpg (1), .BR gpgv (1) .SH BUGS Please report bugs to <[EMAIL PROTECTED]>. .SH AUTHOR Manpage written for Debian by Sven Mueller <[EMAIL PROTECTED]>, 2005-08-15. .SH COPYRIGHT Copyright (C) 2004 Free Software Foundation, Inc. This program comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to redistribute it under certain conditions. See the file COPYING for details.
------------------------ [ SECURITY NOTICE ] ------------------------ [EMAIL PROTECTED] digitally signed "gpg-agent.1" ------------------- [ CIPHIRE DIGITAL SIGNATURE ] ------------------- Q2lwaGlyZSBTaWcuAUIzMDAxMjlAYnVncy5kZWJpYW4ub3JnAHNtQGNpcGhpcmVsYWJzL mNvbQAiZ3BnLWFnZW50LjEiAKkLAAB8AHwAAAABAAAAEccAQ6kLAABMAgACAAIAAgAg7o 81B3u7SGhY8TUyOasP5PM9L/eo5WaZF6DK9DcIKJkBAKe4iRF7xBuVS5ZEqDwPUnOnv+9 OIOoKTcvFvXP3opHtHLOOyZx5kyDnieUIkBDDwzAj99eAE3USbmOGh0H4MEkX3qLYU2ln RW5k --------------------- [ END DIGITAL SIGNATURE ] ---------------------
