Page MenuHome GnuPG

documentation of Dirmngr misses "OPTION audit-events" and "LDAPSERVER".
Closed, ResolvedPublic

Description

http://cvs.gnupg.org/cgi-bin/viewcvs.cgi/trunk/doc/dirmngr.texi?rev=310&root=Dirmngr&view=markup
the section about dirmngr's protocol misses to mention the "OPTION" command
and "OPTION audit-evens".

Here is a log file showing that OPTION actually is accepted as command:
2009-04-02 12:05:18 dirmngr[272] handler for fd 564 started
dirmngr[272.564] DBG: -> # Home: C:\Dokumente und Einstellungen\All
Users\Anwendungsdaten\GNU\etc\dirmngr
dirmngr[272.564] DBG: -> # Config: C:\Dokumente und Einstellungen\All
Users\Anwendungsdaten\GNU\etc\dirmngr/dirmngr.conf
dirmngr[272.564] DBG: -> OK Dirmngr 1.0.3-svn310 at your service
dirmngr[272.564] DBG: <- OPTION audit-events=1
dirmngr[272.564] DBG: -> OK

Details

Version
svn310

Event Timeline

bernhard set Version to svn310.
bernhard added a subscriber: bernhard.

Hmmm the "LDAPSERVER" command is also not mentioned.

bernhard renamed this task from documentation of Dirmngr misses "OPTION audit-events" to documentation of Dirmngr misses "OPTION audit-events" and "LDAPSERVER"..Apr 2 2009, 3:07 PM

Okay, systematically, sending HELP to dirmngr 1.0.2 gives me the following
list:'# NOP\n# CANCEL\n# OPTION\n# BYE\n# AUTH\n# RESET\n# END\n# HELP\n#
OPTION\n# LDAPSERVER\n# ISVALID\n# CHECKCRL\n# CHECKOCSP\n# LOOKUP\n#
LOADCRL\n# LISTCRLS\n# CACHECERT\n# VALIDATE\n# INPUT\n# OUTPUT\nOK\n'

(why is "OPTION" in there twice, btw?)
http://cvs.gnupg.org/cgi-bin/viewcvs.cgi/trunk/doc/assuan.texi?rev=294&root=Libassuan&view=markup
@node Client Requests
lists the following commands: BYE RESET END HELP QUIT OPTION CANCEL AUTH
(I guess NOP should be listed there as well.)

dirmngr lists
LOOKUP ISVALID CHECKCRL CHECKOCSP CACHECERT VALIDATE

makes missing
LDAPSERVER LOADCRL LISTCRLS INPUT OUTPUT

For "OPTION" it should be listed which options are okay and "audit-events"
is not listed as a command line option in dirmngr.info.

OPTION is a generic Asssuan command and as such not Dirmngr specific.
Listed two times becuase it is two times in the table. I removed the second one
from libassuan. To go into the next libassuan release.

I'll check dirmngr docs later.

Werner, thanks for the quick response.
Yes I know that OPTION is generic, the question is what OPTIONs are supported
for a server and this is not mentioned for dirmngr and there is also no mention
of "audit-events" at all. Maybe audit-events is also generic?

http://cvs.gnupg.org/cgi-bin/viewcvs.cgi/trunk/doc/dirmngr.texi?rev=334&root=Dirmngr&view=markup
@node Dirmngr Protocol
still misses LOADCRL and others as far as I can see.

If you add LOADCRL, please also document that it only takes .der encoded
crl files. (Just had a user that tried to important an .pem here. I know this
is documented in the --load-crl command, but having this in the Protocol also
would be nice as I've first saw the protocol in the watchgnupg.)