Updated from latest NewPG project
[gnupg.git] / sm / call-agent.c
1 /* call-agent.c - divert operations to the agent
2  *      Copyright (C) 2001, 2002 Free Software Foundation, Inc.
3  *
4  * This file is part of GnuPG.
5  *
6  * GnuPG is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * GnuPG is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
19  */
20
21 #include <config.h>
22 #include <stdio.h>
23 #include <stdlib.h>
24 #include <string.h>
25 #include <errno.h>
26 #include <unistd.h> 
27 #include <time.h>
28 #include <assert.h>
29 #include <gcrypt.h>
30 #ifdef HAVE_LOCALE_H
31 #include <locale.h>
32 #endif
33
34 #include "gpgsm.h"
35 #include "../assuan/assuan.h"
36 #include "i18n.h"
37 #include "keydb.h" /* fixme: Move this to import.c */
38
39 static ASSUAN_CONTEXT agent_ctx = NULL;
40 static int force_pipe_server = 0;
41
42 struct cipher_parm_s {
43   ASSUAN_CONTEXT ctx;
44   const char *ciphertext;
45   size_t ciphertextlen;
46 };
47
48 struct genkey_parm_s {
49   ASSUAN_CONTEXT ctx;
50   const char *sexp;
51   size_t sexplen;
52 };
53
54 struct learn_parm_s {
55   int error;
56   ASSUAN_CONTEXT ctx;
57   struct membuf *data;
58 };
59
60 struct membuf {
61   size_t len;
62   size_t size;
63   char *buf;
64   int out_of_core;
65 };
66
67
68 \f
69 /* A simple implemnation of a dynamic buffer.  Use init_membuf() to
70    create a buffer, put_membuf to append bytes and get_membuf to
71    release and return the buffer.  Allocation errors are detected but
72    only returned at the final get_membuf(), this helps not to clutter
73    the code with out of core checks.  */
74
75 static void
76 init_membuf (struct membuf *mb, int initiallen)
77 {
78   mb->len = 0;
79   mb->size = initiallen;
80   mb->out_of_core = 0;
81   mb->buf = xtrymalloc (initiallen);
82   if (!mb->buf)
83       mb->out_of_core = 1;
84 }
85
86 static void
87 put_membuf (struct membuf *mb, const void *buf, size_t len)
88 {
89   if (mb->out_of_core)
90     return;
91
92   if (mb->len + len >= mb->size)
93     {
94       char *p;
95       
96       mb->size += len + 1024;
97       p = xtryrealloc (mb->buf, mb->size);
98       if (!p)
99         {
100           mb->out_of_core = 1;
101           return;
102         }
103       mb->buf = p;
104     }
105   memcpy (mb->buf + mb->len, buf, len);
106   mb->len += len;
107 }
108
109 static void *
110 get_membuf (struct membuf *mb, size_t *len)
111 {
112   char *p;
113
114   if (mb->out_of_core)
115     {
116       xfree (mb->buf);
117       mb->buf = NULL;
118       return NULL;
119     }
120
121   p = mb->buf;
122   *len = mb->len;
123   mb->buf = NULL;
124   mb->out_of_core = 1; /* don't allow a reuse */
125   return p;
126 }
127
128
129 \f
130 /* Try to connect to the agent via socket or fork it off and work by
131    pipes.  Handle the server's initial greeting */
132 static int
133 start_agent (void)
134 {
135   int rc = 0;
136   char *infostr, *p;
137   ASSUAN_CONTEXT ctx;
138   char *dft_display = NULL;
139   char *dft_ttyname = NULL;
140   char *dft_ttytype = NULL;
141   char *old_lc = NULL;
142   char *dft_lc = NULL;
143
144   if (agent_ctx)
145     return 0; /* fixme: We need a context for each thread or serialize
146                  the access to the agent (which is suitable given that
147                  the agent is not MT */
148
149   infostr = force_pipe_server? NULL : getenv ("GPG_AGENT_INFO");
150   if (!infostr)
151     {
152       const char *pgmname;
153       const char *argv[3];
154       int no_close_list[3];
155       int i;
156
157       if (opt.verbose)
158         log_info (_("no running gpg-agent - starting one\n"));
159
160       if (fflush (NULL))
161         {
162           log_error ("error flushing pending output: %s\n", strerror (errno));
163           return seterr (Write_Error);
164         }
165
166       if (!opt.agent_program || !*opt.agent_program)
167         opt.agent_program = GNUPG_DEFAULT_AGENT;
168       if ( !(pgmname = strrchr (opt.agent_program, '/')))
169         pgmname = opt.agent_program;
170       else
171         pgmname++;
172
173       argv[0] = pgmname;
174       argv[1] = "--server";
175       argv[2] = NULL;
176
177       i=0;
178       if (log_get_fd () != -1)
179         no_close_list[i++] = log_get_fd ();
180       no_close_list[i++] = fileno (stderr);
181       no_close_list[i] = -1;
182
183       /* connect to the agent and perform initial handshaking */
184       rc = assuan_pipe_connect (&ctx, opt.agent_program, (char**)argv,
185                                 no_close_list);
186     }
187   else
188     {
189       int prot;
190       int pid;
191
192       infostr = xstrdup (infostr);
193       if ( !(p = strchr (infostr, ':')) || p == infostr)
194         {
195           log_error (_("malformed GPG_AGENT_INFO environment variable\n"));
196           xfree (infostr);
197           force_pipe_server = 1;
198           return start_agent ();
199         }
200       *p++ = 0;
201       pid = atoi (p);
202       while (*p && *p != ':')
203         p++;
204       prot = *p? atoi (p+1) : 0;
205       if (prot != 1)
206         {
207           log_error (_("gpg-agent protocol version %d is not supported\n"),
208                      prot);
209           xfree (infostr);
210           force_pipe_server = 1;
211           return start_agent ();
212         }
213
214       rc = assuan_socket_connect (&ctx, infostr, pid);
215       xfree (infostr);
216       if (rc == ASSUAN_Connect_Failed)
217         {
218           log_error (_("can't connect to the agent - trying fall back\n"));
219           force_pipe_server = 1;
220           return start_agent ();
221         }
222     }
223
224   if (rc)
225     {
226       log_error ("can't connect to the agent: %s\n", assuan_strerror (rc));
227       return seterr (No_Agent);
228     }
229   agent_ctx = ctx;
230
231   if (DBG_ASSUAN)
232     log_debug ("connection to agent established\n");
233
234   rc = assuan_transact (agent_ctx, "RESET", NULL, NULL, NULL, NULL, NULL, NULL);
235   if (rc)
236     return map_assuan_err (rc);
237
238   dft_display = getenv ("DISPLAY");
239   if (opt.display || dft_display)
240     {
241       char *optstr;
242       if (asprintf (&optstr, "OPTION display=%s",
243                     opt.display ? opt.display : dft_display) < 0)
244         return GNUPG_Out_Of_Core;
245       rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
246                             NULL);
247       free (optstr);
248       if (rc)
249         return map_assuan_err (rc);
250     }
251   if (!opt.ttyname)
252     {
253       dft_ttyname = getenv ("GPG_TTY");
254       if ((!dft_ttyname || !*dft_ttyname) && ttyname (0))
255         dft_ttyname = ttyname (0);
256     }
257   if (opt.ttyname || dft_ttyname)
258     {
259       char *optstr;
260       if (asprintf (&optstr, "OPTION ttyname=%s",
261                     opt.ttyname ? opt.ttyname : dft_ttyname) < 0)
262         return GNUPG_Out_Of_Core;
263       rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
264                             NULL);
265       free (optstr);
266       if (rc)
267         return map_assuan_err (rc);
268     }
269   dft_ttytype = getenv ("TERM");
270   if (opt.ttytype || (dft_ttyname && dft_ttytype))
271     {
272       char *optstr;
273       if (asprintf (&optstr, "OPTION ttytype=%s",
274                     opt.ttyname ? opt.ttytype : dft_ttytype) < 0)
275         return GNUPG_Out_Of_Core;
276       rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
277                             NULL);
278       free (optstr);
279       if (rc)
280         return map_assuan_err (rc);
281     }
282 #if defined(HAVE_SETLOCALE) && defined(LC_CTYPE)
283   old_lc = setlocale (LC_CTYPE, NULL);
284   if (old_lc)
285     {
286       old_lc = strdup (old_lc);
287       if (!old_lc)
288         return GNUPG_Out_Of_Core;
289     }
290   dft_lc = setlocale (LC_CTYPE, "");
291 #endif
292   if (opt.lc_ctype || (dft_ttyname && dft_lc))
293     {
294       char *optstr;
295       if (asprintf (&optstr, "OPTION lc-ctype=%s",
296                     opt.lc_ctype ? opt.lc_ctype : dft_lc) < 0)
297         rc = GNUPG_Out_Of_Core;
298       else
299         {
300           rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
301                                 NULL);
302           free (optstr);
303           if (rc)
304             rc = map_assuan_err (rc);
305         }
306     }
307 #if defined(HAVE_SETLOCALE) && defined(LC_CTYPE)
308   if (old_lc)
309     {
310       setlocale (LC_CTYPE, old_lc);
311       free (old_lc);
312     }
313 #endif
314   if (rc)
315     return rc;
316 #if defined(HAVE_SETLOCALE) && defined(LC_MESSAGES)
317   old_lc = setlocale (LC_MESSAGES, NULL);
318   if (old_lc)
319     {
320       old_lc = strdup (old_lc);
321       if (!old_lc)
322         return GNUPG_Out_Of_Core;
323     }
324   dft_lc = setlocale (LC_MESSAGES, "");
325 #endif
326   if (opt.lc_messages || (dft_ttyname && dft_lc))
327     {
328       char *optstr;
329       if (asprintf (&optstr, "OPTION lc-messages=%s",
330                     opt.lc_messages ? opt.lc_messages : dft_lc) < 0)
331         rc = GNUPG_Out_Of_Core;
332       else
333         {
334           rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
335                                 NULL);
336           free (optstr);
337           if (rc)
338             rc = map_assuan_err (rc);
339         }
340     }
341 #if defined(HAVE_SETLOCALE) && defined(LC_MESSAGES)
342   if (old_lc)
343     {
344       setlocale (LC_MESSAGES, old_lc);
345       free (old_lc);
346     }
347 #endif
348
349   return rc;
350 }
351
352
353 static AssuanError
354 membuf_data_cb (void *opaque, const void *buffer, size_t length)
355 {
356   struct membuf *data = opaque;
357
358   if (buffer)
359     put_membuf (data, buffer, length);
360   return 0;
361 }
362   
363
364
365 \f
366 /* Call the agent to do a sign operation using the key identified by
367    the hex string KEYGRIP. */
368 int
369 gpgsm_agent_pksign (const char *keygrip,
370                     unsigned char *digest, size_t digestlen, int digestalgo,
371                     char **r_buf, size_t *r_buflen )
372 {
373   int rc, i;
374   char *p, line[ASSUAN_LINELENGTH];
375   struct membuf data;
376   size_t len;
377
378   *r_buf = NULL;
379   rc = start_agent ();
380   if (rc)
381     return rc;
382
383   if (digestlen*2 + 50 > DIM(line))
384     return seterr (General_Error);
385
386   rc = assuan_transact (agent_ctx, "RESET", NULL, NULL, NULL, NULL, NULL, NULL);
387   if (rc)
388     return map_assuan_err (rc);
389
390   snprintf (line, DIM(line)-1, "SIGKEY %s", keygrip);
391   line[DIM(line)-1] = 0;
392   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
393   if (rc)
394     return map_assuan_err (rc);
395
396   sprintf (line, "SETHASH %d ", digestalgo);
397   p = line + strlen (line);
398   for (i=0; i < digestlen ; i++, p += 2 )
399     sprintf (p, "%02X", digest[i]);
400   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
401   if (rc)
402     return map_assuan_err (rc);
403
404   init_membuf (&data, 1024);
405   rc = assuan_transact (agent_ctx, "PKSIGN",
406                         membuf_data_cb, &data, NULL, NULL, NULL, NULL);
407   if (rc)
408     {
409       xfree (get_membuf (&data, &len));
410       return map_assuan_err (rc);
411     }
412   *r_buf = get_membuf (&data, r_buflen);
413
414   if (!gcry_sexp_canon_len (*r_buf, *r_buflen, NULL, NULL))
415     {
416       xfree (*r_buf); *r_buf = NULL;
417       return GNUPG_Invalid_Value;
418     }
419
420   return *r_buf? 0 : GNUPG_Out_Of_Core;
421 }
422
423
424
425 \f
426 /* Handle a CIPHERTEXT inquiry.  Note, we only send the data,
427    assuan_transact talkes care of flushing and writing the end */
428 static AssuanError
429 inq_ciphertext_cb (void *opaque, const char *keyword)
430 {
431   struct cipher_parm_s *parm = opaque; 
432   AssuanError rc;
433
434   assuan_begin_confidential (parm->ctx);
435   rc = assuan_send_data (parm->ctx, parm->ciphertext, parm->ciphertextlen);
436   assuan_end_confidential (parm->ctx);
437   return rc; 
438 }
439
440
441 /* Call the agent to do a decrypt operation using the key identified by
442    the hex string KEYGRIP. */
443 int
444 gpgsm_agent_pkdecrypt (const char *keygrip,
445                        KsbaConstSexp ciphertext, 
446                        char **r_buf, size_t *r_buflen )
447 {
448   int rc;
449   char line[ASSUAN_LINELENGTH];
450   struct membuf data;
451   struct cipher_parm_s cipher_parm;
452   size_t n, len;
453   char *buf, *endp;
454   size_t ciphertextlen;
455   
456   if (!keygrip || strlen(keygrip) != 40 || !ciphertext || !r_buf || !r_buflen)
457     return GNUPG_Invalid_Value;
458   *r_buf = NULL;
459
460   ciphertextlen = gcry_sexp_canon_len (ciphertext, 0, NULL, NULL);
461   if (!ciphertextlen)
462     return GNUPG_Invalid_Value;
463
464   rc = start_agent ();
465   if (rc)
466     return rc;
467
468   rc = assuan_transact (agent_ctx, "RESET", NULL, NULL, NULL, NULL, NULL, NULL);
469   if (rc)
470     return map_assuan_err (rc);
471
472   assert ( DIM(line) >= 50 );
473   snprintf (line, DIM(line)-1, "SETKEY %s", keygrip);
474   line[DIM(line)-1] = 0;
475   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
476   if (rc)
477     return map_assuan_err (rc);
478
479   init_membuf (&data, 1024);
480   cipher_parm.ctx = agent_ctx;
481   cipher_parm.ciphertext = ciphertext;
482   cipher_parm.ciphertextlen = ciphertextlen;
483   rc = assuan_transact (agent_ctx, "PKDECRYPT",
484                         membuf_data_cb, &data,
485                         inq_ciphertext_cb, &cipher_parm, NULL, NULL);
486   if (rc)
487     {
488       xfree (get_membuf (&data, &len));
489       return map_assuan_err (rc);
490     }
491
492   put_membuf (&data, "", 1); /* make sure it is 0 terminated */
493   buf = get_membuf (&data, &len);
494   if (!buf)
495     return seterr (Out_Of_Core);
496   /* FIXME: We would better a return a full S-exp and not just a part */
497   assert (len);
498   len--; /* remove the terminating 0 */
499   n = strtoul (buf, &endp, 10);
500   if (!n || *endp != ':')
501     return seterr (Invalid_Sexp);
502   endp++;
503   if (endp-buf+n > len)
504     return seterr (Invalid_Sexp); /* oops len does not match internal len*/
505   memmove (buf, endp, n);
506   *r_buflen = n;
507   *r_buf = buf;
508   return 0;
509 }
510
511
512
513
514 \f
515 /* Handle a KEYPARMS inquiry.  Note, we only send the data,
516    assuan_transact takes care of flushing and writing the end */
517 static AssuanError
518 inq_genkey_parms (void *opaque, const char *keyword)
519 {
520   struct genkey_parm_s *parm = opaque; 
521   AssuanError rc;
522
523   rc = assuan_send_data (parm->ctx, parm->sexp, parm->sexplen);
524   return rc; 
525 }
526
527
528 \f
529 /* Call the agent to generate a newkey */
530 int
531 gpgsm_agent_genkey (KsbaConstSexp keyparms, KsbaSexp *r_pubkey)
532 {
533   int rc;
534   struct genkey_parm_s gk_parm;
535   struct membuf data;
536   size_t len;
537   char *buf;
538
539   *r_pubkey = NULL;
540   rc = start_agent ();
541   if (rc)
542     return rc;
543
544   rc = assuan_transact (agent_ctx, "RESET", NULL, NULL, NULL, NULL, NULL, NULL);
545   if (rc)
546     return map_assuan_err (rc);
547
548   init_membuf (&data, 1024);
549   gk_parm.ctx = agent_ctx;
550   gk_parm.sexp = keyparms;
551   gk_parm.sexplen = gcry_sexp_canon_len (keyparms, 0, NULL, NULL);
552   if (!gk_parm.sexplen)
553     return GNUPG_Invalid_Value;
554   rc = assuan_transact (agent_ctx, "GENKEY",
555                         membuf_data_cb, &data, 
556                         inq_genkey_parms, &gk_parm, NULL, NULL);
557   if (rc)
558     {
559       xfree (get_membuf (&data, &len));
560       return map_assuan_err (rc);
561     }
562   buf = get_membuf (&data, &len);
563   if (!buf)
564     return GNUPG_Out_Of_Core;
565   if (!gcry_sexp_canon_len (buf, len, NULL, NULL))
566     {
567       xfree (buf);
568       return GNUPG_Invalid_Sexp;
569     }
570   *r_pubkey = buf;
571   return 0;
572 }
573
574 \f
575 /* Ask the agent whether the certificate is in the list of trusted
576    keys */
577 int
578 gpgsm_agent_istrusted (KsbaCert cert)
579 {
580   int rc;
581   char *fpr;
582   char line[ASSUAN_LINELENGTH];
583
584   rc = start_agent ();
585   if (rc)
586     return rc;
587
588   fpr = gpgsm_get_fingerprint_hexstring (cert, GCRY_MD_SHA1);
589   if (!fpr)
590     {
591       log_error ("error getting the fingerprint\n");
592       return seterr (General_Error);
593     }
594
595   snprintf (line, DIM(line)-1, "ISTRUSTED %s", fpr);
596   line[DIM(line)-1] = 0;
597   xfree (fpr);
598
599   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
600   return map_assuan_err (rc);
601 }
602
603 /* Ask the agent to mark CERT as a trusted Root-CA one */
604 int
605 gpgsm_agent_marktrusted (KsbaCert cert)
606 {
607   int rc;
608   char *fpr, *dn;
609   char line[ASSUAN_LINELENGTH];
610
611   rc = start_agent ();
612   if (rc)
613     return rc;
614
615   fpr = gpgsm_get_fingerprint_hexstring (cert, GCRY_MD_SHA1);
616   if (!fpr)
617     {
618       log_error ("error getting the fingerprint\n");
619       return seterr (General_Error);
620     }
621
622   dn = ksba_cert_get_issuer (cert, 0);
623   if (!dn)
624     {
625       xfree (fpr);
626       return seterr (General_Error);
627     }
628   snprintf (line, DIM(line)-1, "MARKTRUSTED %s S %s", fpr, dn);
629   line[DIM(line)-1] = 0;
630   ksba_free (dn);
631   xfree (fpr);
632
633   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
634   return map_assuan_err (rc);
635 }
636
637
638 \f
639 /* Ask the agent whether the a corresponding secret key is available
640    for the given keygrip */
641 int
642 gpgsm_agent_havekey (const char *hexkeygrip)
643 {
644   int rc;
645   char line[ASSUAN_LINELENGTH];
646
647   rc = start_agent ();
648   if (rc)
649     return rc;
650
651   if (!hexkeygrip || strlen (hexkeygrip) != 40)
652     return GNUPG_Invalid_Value;
653
654   snprintf (line, DIM(line)-1, "HAVEKEY %s", hexkeygrip);
655   line[DIM(line)-1] = 0;
656
657   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
658   return map_assuan_err (rc);
659 }
660
661 \f
662 static AssuanError
663 learn_cb (void *opaque, const void *buffer, size_t length)
664 {
665   struct learn_parm_s *parm = opaque;
666   size_t len;
667   char *buf;
668   KsbaCert cert;
669   int rc;
670
671   if (parm->error)
672     return 0;
673
674   if (buffer)
675     {
676       put_membuf (parm->data, buffer, length);
677       return 0;
678     }
679   /* END encountered - process what we have */
680   buf = get_membuf (parm->data, &len);
681   if (!buf)
682     {
683       parm->error = GNUPG_Out_Of_Core;
684       return 0;
685     }
686
687
688   /* FIXME: this should go into import.c */
689   cert = ksba_cert_new ();
690   if (!cert)
691     {
692       parm->error = GNUPG_Out_Of_Core;
693       return 0;
694     }
695   rc = ksba_cert_init_from_mem (cert, buf, len);
696   if (rc)
697     {
698       log_error ("failed to parse a certificate: %s\n", ksba_strerror (rc));
699       ksba_cert_release (cert);
700       parm->error = map_ksba_err (rc);
701       return 0;
702     }
703
704   rc = gpgsm_basic_cert_check (cert);
705   if (rc == GNUPG_Missing_Certificate)
706     { /* For later use we store it in the ephemeral database. */
707       log_info ("issuer certificate missing - storing as ephemeral\n");
708       keydb_store_cert (cert, 1, NULL);
709     }
710   else if (rc)
711     log_error ("invalid certificate: %s\n", gnupg_strerror (rc));
712   else
713     {
714       int existed;
715
716       if (!keydb_store_cert (cert, 0, &existed))
717         {
718           if (opt.verbose > 1 && existed)
719             log_info ("certificate already in DB\n");
720           else if (opt.verbose && !existed)
721             log_info ("certificate imported\n");
722         }
723     }
724
725   ksba_cert_release (cert);
726   init_membuf (parm->data, 4096);
727   return 0;
728 }
729   
730 /* Call the agent to learn about a smartcard */
731 int
732 gpgsm_agent_learn ()
733 {
734   int rc;
735   struct learn_parm_s learn_parm;
736   struct membuf data;
737   size_t len;
738
739   rc = start_agent ();
740   if (rc)
741     return rc;
742
743   init_membuf (&data, 4096);
744   learn_parm.error = 0;
745   learn_parm.ctx = agent_ctx;
746   learn_parm.data = &data;
747   rc = assuan_transact (agent_ctx, "LEARN --send",
748                         learn_cb, &learn_parm, 
749                         NULL, NULL, NULL, NULL);
750   xfree (get_membuf (&data, &len));
751   if (rc)
752     return map_assuan_err (rc);
753   return learn_parm.error;
754 }
755
756 \f
757 /* Ask the agent to change the passphrase of the key identified by HEXKEYGRIP. */
758 int
759 gpgsm_agent_passwd (const char *hexkeygrip)
760 {
761   int rc;
762   char line[ASSUAN_LINELENGTH];
763
764   rc = start_agent ();
765   if (rc)
766     return rc;
767
768   if (!hexkeygrip || strlen (hexkeygrip) != 40)
769     return GNUPG_Invalid_Value;
770
771   snprintf (line, DIM(line)-1, "PASSWD %s", hexkeygrip);
772   line[DIM(line)-1] = 0;
773
774   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
775   return map_assuan_err (rc);
776 }
777