2004-04-26 Marcus Brinkmann <marcus@g10code.de>
[gnupg.git] / doc / gpg-agent.texi
index 793d093..e199109 100644 (file)
@@ -118,7 +118,9 @@ $ eval `gpg-agent --daemon`
 @item --options @var{file}
 @opindex options
 Reads configuration from @var{file} instead of from the default
-per-user configuration file.
+per-user configuration file.  The default configuration file is named
+@file{gpg-agent.conf} and expected in the @file{.gnupg} directory directly
+below the home directory of the user.
 
 @item -v
 @item --verbose
@@ -144,11 +146,34 @@ This option is only useful for testing; it sets the system time back or
 forth to @var{epoch} which is the number of seconds elapsed since the year
 1970.
 
+@item --debug-level @var{level}
+@opindex debug-level
+Select the debug level for investigating problems. @var{level} may be
+one of:
+
+   @table @code
+   @item none
+   no debugging at all.
+   @item basic  
+   some basic debug messages
+   @item advanced
+   more verbose debug messages
+   @item expert
+   even more detailed messages
+   @item guru
+   all of the debug messages you can get
+   @end table
+
+How these messages are mapped to the actual debugging flags is not
+specified and may change with newer releaes of this program. They are
+however carefully selected to best aid in debugging.
+
 @item --debug @var{flags}
 @opindex debug
 This option is only useful for debugging and the behaviour may change at
 any time without notice.  FLAGS are bit encoded and may be given in
 usual C-Syntax. The currently defined bits are:
+
    @table @code
    @item 0  (1)
    X.509 or OpenPGP protocol related data
@@ -224,15 +249,16 @@ control this behaviour but this command line option takes precedence.
 Set the time a cache entry is valid to @var{n} seconds.  The default are
 600 seconds.
 
-@item --pinentry-program @var{path}
+@item --pinentry-program @var{filename}
 @opindex pinentry-program
-Use program @var{path} as the PIN entry.  The default is installation
+Use program @var{filename} as the PIN entry.  The default is installation
 dependend and can be shown with the @code{--version} command.
 
-@item --scdaemon-program @var{path}
+@item --scdaemon-program @var{filename}
 @opindex scdaemon-program
-Use program @var{path} as the Smartcard daemon.  The default is installation
-dependend and can be shown with the @code{--version} command.
+Use program @var{filename} as the Smartcard daemon.  The default is
+installation dependend and can be shown with the @code{--version}
+command.
 
 
 @item --display @var{string}
@@ -286,15 +312,6 @@ implementation, which calls the scdaemon only once, it is not of much
 use.
 
 
-@item SIGUSR1
-@cpindex SIGUSR1
-This signal increases the verbosity of the logging by one up to a value
-of 5.
-
-@item SIGUSR2
-@cpindex SIGUSR2
-This signal decreases the verbosity of the logging by one.
-
 @item SIGTERM
 @cpindex SIGTERM
 Shuts down the process but waits until all current requests are
@@ -305,6 +322,13 @@ are still pending, a shutdown is forced.
 @cpindex SIGINT
 Shuts down the process immediately.
 
+
+@item SIGUSR1
+@itemx SIGUSR2
+@cpindex SIGUSR1
+@cpindex SIGUSR2
+These signals are used for internal purposes.
+
 @end table
 
 @c