Update error handling to match gpg-error in CVS.
[gnupg.git] / sm / call-agent.c
1 /* call-agent.c - divert operations to the agent
2  *      Copyright (C) 2001, 2002, 2003 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 #include <assuan.h>
34
35 #include "gpgsm.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           gpg_error_t tmperr = gpg_error (gpg_err_code_from_errno (errno));
163           log_error ("error flushing pending output: %s\n", strerror (errno));
164           return tmperr;
165         }
166
167       if (!opt.agent_program || !*opt.agent_program)
168         opt.agent_program = GNUPG_DEFAULT_AGENT;
169       if ( !(pgmname = strrchr (opt.agent_program, '/')))
170         pgmname = opt.agent_program;
171       else
172         pgmname++;
173
174       argv[0] = pgmname;
175       argv[1] = "--server";
176       argv[2] = NULL;
177
178       i=0;
179       if (log_get_fd () != -1)
180         no_close_list[i++] = log_get_fd ();
181       no_close_list[i++] = fileno (stderr);
182       no_close_list[i] = -1;
183
184       /* connect to the agent and perform initial handshaking */
185       rc = assuan_pipe_connect (&ctx, opt.agent_program, (char**)argv,
186                                 no_close_list);
187     }
188   else
189     {
190       int prot;
191       int pid;
192
193       infostr = xstrdup (infostr);
194       if ( !(p = strchr (infostr, ':')) || p == infostr)
195         {
196           log_error (_("malformed GPG_AGENT_INFO environment variable\n"));
197           xfree (infostr);
198           force_pipe_server = 1;
199           return start_agent ();
200         }
201       *p++ = 0;
202       pid = atoi (p);
203       while (*p && *p != ':')
204         p++;
205       prot = *p? atoi (p+1) : 0;
206       if (prot != 1)
207         {
208           log_error (_("gpg-agent protocol version %d is not supported\n"),
209                      prot);
210           xfree (infostr);
211           force_pipe_server = 1;
212           return start_agent ();
213         }
214
215       rc = assuan_socket_connect (&ctx, infostr, pid);
216       xfree (infostr);
217       if (rc == ASSUAN_Connect_Failed)
218         {
219           log_error (_("can't connect to the agent - trying fall back\n"));
220           force_pipe_server = 1;
221           return start_agent ();
222         }
223     }
224
225   if (rc)
226     {
227       log_error ("can't connect to the agent: %s\n", assuan_strerror (rc));
228       return gpg_error (GPG_ERR_NO_AGENT);
229     }
230   agent_ctx = ctx;
231
232   if (DBG_ASSUAN)
233     log_debug ("connection to agent established\n");
234
235   rc = assuan_transact (agent_ctx, "RESET", NULL, NULL, NULL, NULL, NULL, NULL);
236   if (rc)
237     return map_assuan_err (rc);
238
239   dft_display = getenv ("DISPLAY");
240   if (opt.display || dft_display)
241     {
242       char *optstr;
243       if (asprintf (&optstr, "OPTION display=%s",
244                     opt.display ? opt.display : dft_display) < 0)
245         return OUT_OF_CORE (errno);
246       rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
247                             NULL);
248       free (optstr);
249       if (rc)
250         return map_assuan_err (rc);
251     }
252   if (!opt.ttyname)
253     {
254       dft_ttyname = getenv ("GPG_TTY");
255       if ((!dft_ttyname || !*dft_ttyname) && ttyname (0))
256         dft_ttyname = ttyname (0);
257     }
258   if (opt.ttyname || dft_ttyname)
259     {
260       char *optstr;
261       if (asprintf (&optstr, "OPTION ttyname=%s",
262                     opt.ttyname ? opt.ttyname : dft_ttyname) < 0)
263         return OUT_OF_CORE (errno);
264       rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
265                             NULL);
266       free (optstr);
267       if (rc)
268         return map_assuan_err (rc);
269     }
270   dft_ttytype = getenv ("TERM");
271   if (opt.ttytype || (dft_ttyname && dft_ttytype))
272     {
273       char *optstr;
274       if (asprintf (&optstr, "OPTION ttytype=%s",
275                     opt.ttyname ? opt.ttytype : dft_ttytype) < 0)
276         return OUT_OF_CORE (errno);
277       rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
278                             NULL);
279       free (optstr);
280       if (rc)
281         return map_assuan_err (rc);
282     }
283 #if defined(HAVE_SETLOCALE) && defined(LC_CTYPE)
284   old_lc = setlocale (LC_CTYPE, NULL);
285   if (old_lc)
286     {
287       old_lc = strdup (old_lc);
288       if (!old_lc)
289         return OUT_OF_CORE (errno);
290     }
291   dft_lc = setlocale (LC_CTYPE, "");
292 #endif
293   if (opt.lc_ctype || (dft_ttyname && dft_lc))
294     {
295       char *optstr;
296       if (asprintf (&optstr, "OPTION lc-ctype=%s",
297                     opt.lc_ctype ? opt.lc_ctype : dft_lc) < 0)
298         rc = OUT_OF_CORE (errno);
299       else
300         {
301           rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
302                                 NULL);
303           free (optstr);
304           if (rc)
305             rc = map_assuan_err (rc);
306         }
307     }
308 #if defined(HAVE_SETLOCALE) && defined(LC_CTYPE)
309   if (old_lc)
310     {
311       setlocale (LC_CTYPE, old_lc);
312       free (old_lc);
313     }
314 #endif
315   if (rc)
316     return rc;
317 #if defined(HAVE_SETLOCALE) && defined(LC_MESSAGES)
318   old_lc = setlocale (LC_MESSAGES, NULL);
319   if (old_lc)
320     {
321       old_lc = strdup (old_lc);
322       if (!old_lc)
323         return OUT_OF_CORE (errno);
324     }
325   dft_lc = setlocale (LC_MESSAGES, "");
326 #endif
327   if (opt.lc_messages || (dft_ttyname && dft_lc))
328     {
329       char *optstr;
330       if (asprintf (&optstr, "OPTION lc-messages=%s",
331                     opt.lc_messages ? opt.lc_messages : dft_lc) < 0)
332         rc = OUT_OF_CORE (errno);
333       else
334         {
335           rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
336                                 NULL);
337           free (optstr);
338           if (rc)
339             rc = map_assuan_err (rc);
340         }
341     }
342 #if defined(HAVE_SETLOCALE) && defined(LC_MESSAGES)
343   if (old_lc)
344     {
345       setlocale (LC_MESSAGES, old_lc);
346       free (old_lc);
347     }
348 #endif
349
350   return rc;
351 }
352
353
354 static AssuanError
355 membuf_data_cb (void *opaque, const void *buffer, size_t length)
356 {
357   struct membuf *data = opaque;
358
359   if (buffer)
360     put_membuf (data, buffer, length);
361   return 0;
362 }
363   
364
365
366 \f
367 /* Call the agent to do a sign operation using the key identified by
368    the hex string KEYGRIP. */
369 int
370 gpgsm_agent_pksign (const char *keygrip,
371                     unsigned char *digest, size_t digestlen, int digestalgo,
372                     char **r_buf, size_t *r_buflen )
373 {
374   int rc, i;
375   char *p, line[ASSUAN_LINELENGTH];
376   struct membuf data;
377   size_t len;
378
379   *r_buf = NULL;
380   rc = start_agent ();
381   if (rc)
382     return rc;
383
384   if (digestlen*2 + 50 > DIM(line))
385     return gpg_error (GPG_ERR_GENERAL);
386
387   rc = assuan_transact (agent_ctx, "RESET", NULL, NULL, NULL, NULL, NULL, NULL);
388   if (rc)
389     return map_assuan_err (rc);
390
391   snprintf (line, DIM(line)-1, "SIGKEY %s", keygrip);
392   line[DIM(line)-1] = 0;
393   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
394   if (rc)
395     return map_assuan_err (rc);
396
397   sprintf (line, "SETHASH %d ", digestalgo);
398   p = line + strlen (line);
399   for (i=0; i < digestlen ; i++, p += 2 )
400     sprintf (p, "%02X", digest[i]);
401   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
402   if (rc)
403     return map_assuan_err (rc);
404
405   init_membuf (&data, 1024);
406   rc = assuan_transact (agent_ctx, "PKSIGN",
407                         membuf_data_cb, &data, NULL, NULL, NULL, NULL);
408   if (rc)
409     {
410       xfree (get_membuf (&data, &len));
411       return map_assuan_err (rc);
412     }
413   *r_buf = get_membuf (&data, r_buflen);
414
415   if (!gcry_sexp_canon_len (*r_buf, *r_buflen, NULL, NULL))
416     {
417       xfree (*r_buf); *r_buf = NULL;
418       return gpg_error (GPG_ERR_INV_VALUE);
419     }
420
421   return *r_buf? 0 : OUT_OF_CORE (errno);
422 }
423
424
425
426 \f
427 /* Handle a CIPHERTEXT inquiry.  Note, we only send the data,
428    assuan_transact talkes care of flushing and writing the end */
429 static AssuanError
430 inq_ciphertext_cb (void *opaque, const char *keyword)
431 {
432   struct cipher_parm_s *parm = opaque; 
433   AssuanError rc;
434
435   assuan_begin_confidential (parm->ctx);
436   rc = assuan_send_data (parm->ctx, parm->ciphertext, parm->ciphertextlen);
437   assuan_end_confidential (parm->ctx);
438   return rc; 
439 }
440
441
442 /* Call the agent to do a decrypt operation using the key identified by
443    the hex string KEYGRIP. */
444 int
445 gpgsm_agent_pkdecrypt (const char *keygrip,
446                        KsbaConstSexp ciphertext, 
447                        char **r_buf, size_t *r_buflen )
448 {
449   int rc;
450   char line[ASSUAN_LINELENGTH];
451   struct membuf data;
452   struct cipher_parm_s cipher_parm;
453   size_t n, len;
454   char *buf, *endp;
455   size_t ciphertextlen;
456   
457   if (!keygrip || strlen(keygrip) != 40 || !ciphertext || !r_buf || !r_buflen)
458     return gpg_error (GPG_ERR_INV_VALUE);
459   *r_buf = NULL;
460
461   ciphertextlen = gcry_sexp_canon_len (ciphertext, 0, NULL, NULL);
462   if (!ciphertextlen)
463     return gpg_error (GPG_ERR_INV_VALUE);
464
465   rc = start_agent ();
466   if (rc)
467     return rc;
468
469   rc = assuan_transact (agent_ctx, "RESET", NULL, NULL, NULL, NULL, NULL, NULL);
470   if (rc)
471     return map_assuan_err (rc);
472
473   assert ( DIM(line) >= 50 );
474   snprintf (line, DIM(line)-1, "SETKEY %s", keygrip);
475   line[DIM(line)-1] = 0;
476   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
477   if (rc)
478     return map_assuan_err (rc);
479
480   init_membuf (&data, 1024);
481   cipher_parm.ctx = agent_ctx;
482   cipher_parm.ciphertext = ciphertext;
483   cipher_parm.ciphertextlen = ciphertextlen;
484   rc = assuan_transact (agent_ctx, "PKDECRYPT",
485                         membuf_data_cb, &data,
486                         inq_ciphertext_cb, &cipher_parm, NULL, NULL);
487   if (rc)
488     {
489       xfree (get_membuf (&data, &len));
490       return map_assuan_err (rc);
491     }
492
493   put_membuf (&data, "", 1); /* make sure it is 0 terminated */
494   buf = get_membuf (&data, &len);
495   if (!buf)
496     return gpg_error (GPG_ERR_ENOMEM);
497   /* FIXME: We would better a return a full S-exp and not just a part */
498   assert (len);
499   len--; /* remove the terminating 0 */
500   n = strtoul (buf, &endp, 10);
501   if (!n || *endp != ':')
502     return gpg_error (GPG_ERR_INV_SEXP);
503   endp++;
504   if (endp-buf+n > len)
505     return gpg_error (GPG_ERR_INV_SEXP); /* oops len does not
506                                             match internal len*/
507   memmove (buf, endp, n);
508   *r_buflen = n;
509   *r_buf = buf;
510   return 0;
511 }
512
513
514
515
516 \f
517 /* Handle a KEYPARMS inquiry.  Note, we only send the data,
518    assuan_transact takes care of flushing and writing the end */
519 static AssuanError
520 inq_genkey_parms (void *opaque, const char *keyword)
521 {
522   struct genkey_parm_s *parm = opaque; 
523   AssuanError rc;
524
525   rc = assuan_send_data (parm->ctx, parm->sexp, parm->sexplen);
526   return rc; 
527 }
528
529
530 \f
531 /* Call the agent to generate a newkey */
532 int
533 gpgsm_agent_genkey (KsbaConstSexp keyparms, KsbaSexp *r_pubkey)
534 {
535   int rc;
536   struct genkey_parm_s gk_parm;
537   struct membuf data;
538   size_t len;
539   char *buf;
540
541   *r_pubkey = NULL;
542   rc = start_agent ();
543   if (rc)
544     return rc;
545
546   rc = assuan_transact (agent_ctx, "RESET", NULL, NULL, NULL, NULL, NULL, NULL);
547   if (rc)
548     return map_assuan_err (rc);
549
550   init_membuf (&data, 1024);
551   gk_parm.ctx = agent_ctx;
552   gk_parm.sexp = keyparms;
553   gk_parm.sexplen = gcry_sexp_canon_len (keyparms, 0, NULL, NULL);
554   if (!gk_parm.sexplen)
555     return gpg_error (GPG_ERR_INV_VALUE);
556   rc = assuan_transact (agent_ctx, "GENKEY",
557                         membuf_data_cb, &data, 
558                         inq_genkey_parms, &gk_parm, NULL, NULL);
559   if (rc)
560     {
561       xfree (get_membuf (&data, &len));
562       return map_assuan_err (rc);
563     }
564   buf = get_membuf (&data, &len);
565   if (!buf)
566     return gpg_error (GPG_ERR_ENOMEM);
567   if (!gcry_sexp_canon_len (buf, len, NULL, NULL))
568     {
569       xfree (buf);
570       return gpg_error (GPG_ERR_INV_SEXP);
571     }
572   *r_pubkey = buf;
573   return 0;
574 }
575
576 \f
577 /* Ask the agent whether the certificate is in the list of trusted
578    keys */
579 int
580 gpgsm_agent_istrusted (KsbaCert cert)
581 {
582   int rc;
583   char *fpr;
584   char line[ASSUAN_LINELENGTH];
585
586   rc = start_agent ();
587   if (rc)
588     return rc;
589
590   fpr = gpgsm_get_fingerprint_hexstring (cert, GCRY_MD_SHA1);
591   if (!fpr)
592     {
593       log_error ("error getting the fingerprint\n");
594       return gpg_error (GPG_ERR_GENERAL);
595     }
596
597   snprintf (line, DIM(line)-1, "ISTRUSTED %s", fpr);
598   line[DIM(line)-1] = 0;
599   xfree (fpr);
600
601   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
602   return map_assuan_err (rc);
603 }
604
605 /* Ask the agent to mark CERT as a trusted Root-CA one */
606 int
607 gpgsm_agent_marktrusted (KsbaCert cert)
608 {
609   int rc;
610   char *fpr, *dn;
611   char line[ASSUAN_LINELENGTH];
612
613   rc = start_agent ();
614   if (rc)
615     return rc;
616
617   fpr = gpgsm_get_fingerprint_hexstring (cert, GCRY_MD_SHA1);
618   if (!fpr)
619     {
620       log_error ("error getting the fingerprint\n");
621       return gpg_error (GPG_ERR_GENERAL);
622     }
623
624   dn = ksba_cert_get_issuer (cert, 0);
625   if (!dn)
626     {
627       xfree (fpr);
628       return gpg_error (GPG_ERR_GENERAL);
629     }
630   snprintf (line, DIM(line)-1, "MARKTRUSTED %s S %s", fpr, dn);
631   line[DIM(line)-1] = 0;
632   ksba_free (dn);
633   xfree (fpr);
634
635   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
636   return map_assuan_err (rc);
637 }
638
639
640 \f
641 /* Ask the agent whether the a corresponding secret key is available
642    for the given keygrip */
643 int
644 gpgsm_agent_havekey (const char *hexkeygrip)
645 {
646   int rc;
647   char line[ASSUAN_LINELENGTH];
648
649   rc = start_agent ();
650   if (rc)
651     return rc;
652
653   if (!hexkeygrip || strlen (hexkeygrip) != 40)
654     return gpg_error (GPG_ERR_INV_VALUE);
655
656   snprintf (line, DIM(line)-1, "HAVEKEY %s", hexkeygrip);
657   line[DIM(line)-1] = 0;
658
659   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
660   return map_assuan_err (rc);
661 }
662
663 \f
664 static AssuanError
665 learn_cb (void *opaque, const void *buffer, size_t length)
666 {
667   struct learn_parm_s *parm = opaque;
668   size_t len;
669   char *buf;
670   KsbaCert cert;
671   int rc;
672
673   if (parm->error)
674     return 0;
675
676   if (buffer)
677     {
678       put_membuf (parm->data, buffer, length);
679       return 0;
680     }
681   /* END encountered - process what we have */
682   buf = get_membuf (parm->data, &len);
683   if (!buf)
684     {
685       parm->error = gpg_error (GPG_ERR_ENOMEM);
686       return 0;
687     }
688
689
690   /* FIXME: this should go into import.c */
691   cert = ksba_cert_new ();
692   if (!cert)
693     {
694       parm->error = gpg_error (GPG_ERR_ENOMEM);
695       return 0;
696     }
697   rc = ksba_cert_init_from_mem (cert, buf, len);
698   if (rc)
699     {
700       log_error ("failed to parse a certificate: %s\n", ksba_strerror (rc));
701       ksba_cert_release (cert);
702       parm->error = map_ksba_err (rc);
703       return 0;
704     }
705
706   rc = gpgsm_basic_cert_check (cert);
707   if (gpg_err_code (rc) == GPG_ERR_MISSING_CERT)
708     { /* For later use we store it in the ephemeral database. */
709       log_info ("issuer certificate missing - storing as ephemeral\n");
710       keydb_store_cert (cert, 1, NULL);
711     }
712   else if (rc)
713     log_error ("invalid certificate: %s\n", gnupg_strerror (rc));
714   else
715     {
716       int existed;
717
718       if (!keydb_store_cert (cert, 0, &existed))
719         {
720           if (opt.verbose > 1 && existed)
721             log_info ("certificate already in DB\n");
722           else if (opt.verbose && !existed)
723             log_info ("certificate imported\n");
724         }
725     }
726
727   ksba_cert_release (cert);
728   init_membuf (parm->data, 4096);
729   return 0;
730 }
731   
732 /* Call the agent to learn about a smartcard */
733 int
734 gpgsm_agent_learn ()
735 {
736   int rc;
737   struct learn_parm_s learn_parm;
738   struct membuf data;
739   size_t len;
740
741   rc = start_agent ();
742   if (rc)
743     return rc;
744
745   init_membuf (&data, 4096);
746   learn_parm.error = 0;
747   learn_parm.ctx = agent_ctx;
748   learn_parm.data = &data;
749   rc = assuan_transact (agent_ctx, "LEARN --send",
750                         learn_cb, &learn_parm, 
751                         NULL, NULL, NULL, NULL);
752   xfree (get_membuf (&data, &len));
753   if (rc)
754     return map_assuan_err (rc);
755   return learn_parm.error;
756 }
757
758 \f
759 /* Ask the agent to change the passphrase of the key identified by HEXKEYGRIP. */
760 int
761 gpgsm_agent_passwd (const char *hexkeygrip)
762 {
763   int rc;
764   char line[ASSUAN_LINELENGTH];
765
766   rc = start_agent ();
767   if (rc)
768     return rc;
769
770   if (!hexkeygrip || strlen (hexkeygrip) != 40)
771     return gpg_error (GPG_ERR_INV_VALUE);
772
773   snprintf (line, DIM(line)-1, "PASSWD %s", hexkeygrip);
774   line[DIM(line)-1] = 0;
775
776   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
777   return map_assuan_err (rc);
778 }
779