* keygen.c (generate_keypair): Create an AUTHKEYTYPE entry for cards.
[gnupg.git] / g10 / 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 #if 0  /* lety Emacs display a red warning */
22 #error fixme: this shares a lof of code with the file in ../sm
23 #endif
24
25 #include <config.h>
26 #include <stdio.h>
27 #include <stdlib.h>
28 #include <string.h>
29 #include <errno.h>
30 #include <unistd.h> 
31 #include <time.h>
32 #include <assert.h>
33 #ifdef HAVE_LOCALE_H
34 #include <locale.h>
35 #endif
36 #include <assuan.h>
37
38 #include "gpg.h"
39 #include "util.h"
40 #include "membuf.h"
41 #include "options.h"
42 #include "i18n.h"
43 #include "call-agent.h"
44
45 #ifndef DBG_ASSUAN
46 # define DBG_ASSUAN 1
47 #endif
48
49 static ASSUAN_CONTEXT agent_ctx = NULL;
50 static int force_pipe_server = 1; /* FIXME: set this back to 0. */
51
52 struct cipher_parm_s {
53   ASSUAN_CONTEXT ctx;
54   const char *ciphertext;
55   size_t ciphertextlen;
56 };
57
58 struct genkey_parm_s {
59   ASSUAN_CONTEXT ctx;
60   const char *sexp;
61   size_t sexplen;
62 };
63
64
65 \f
66 /* Try to connect to the agent via socket or fork it off and work by
67    pipes.  Handle the server's initial greeting */
68 static int
69 start_agent (void)
70 {
71   int rc = 0;
72   char *infostr, *p;
73   ASSUAN_CONTEXT ctx;
74   char *dft_display = NULL;
75   char *dft_ttyname = NULL;
76   char *dft_ttytype = NULL;
77   char *old_lc = NULL;
78   char *dft_lc = NULL;
79
80   if (agent_ctx)
81     return 0; /* fixme: We need a context for each thread or serialize
82                  the access to the agent. */
83
84   infostr = force_pipe_server? NULL : getenv ("GPG_AGENT_INFO");
85   if (!infostr)
86     {
87       const char *pgmname;
88       const char *argv[3];
89       int no_close_list[3];
90       int i;
91
92       if (opt.verbose)
93         log_info (_("no running gpg-agent - starting one\n"));
94
95       if (fflush (NULL))
96         {
97           gpg_error_t tmperr = gpg_error_from_errno (errno);
98           log_error ("error flushing pending output: %s\n", strerror (errno));
99           return tmperr;
100         }
101
102       if (!opt.agent_program || !*opt.agent_program)
103         opt.agent_program = GNUPG_DEFAULT_AGENT;
104       if ( !(pgmname = strrchr (opt.agent_program, '/')))
105         pgmname = opt.agent_program;
106       else
107         pgmname++;
108
109       argv[0] = pgmname;
110       argv[1] = "--server";
111       argv[2] = NULL;
112
113       i=0;
114       if (log_get_fd () != -1)
115         no_close_list[i++] = log_get_fd ();
116       no_close_list[i++] = fileno (stderr);
117       no_close_list[i] = -1;
118
119       /* connect to the agent and perform initial handshaking */
120       rc = assuan_pipe_connect (&ctx, opt.agent_program, (char**)argv,
121                                 no_close_list);
122     }
123   else
124     {
125       int prot;
126       int pid;
127
128       infostr = xstrdup (infostr);
129       if ( !(p = strchr (infostr, ':')) || p == infostr)
130         {
131           log_error (_("malformed GPG_AGENT_INFO environment variable\n"));
132           xfree (infostr);
133           force_pipe_server = 1;
134           return start_agent ();
135         }
136       *p++ = 0;
137       pid = atoi (p);
138       while (*p && *p != ':')
139         p++;
140       prot = *p? atoi (p+1) : 0;
141       if (prot != 1)
142         {
143           log_error (_("gpg-agent protocol version %d is not supported\n"),
144                      prot);
145           xfree (infostr);
146           force_pipe_server = 1;
147           return start_agent ();
148         }
149
150       rc = assuan_socket_connect (&ctx, infostr, pid);
151       xfree (infostr);
152       if (rc == ASSUAN_Connect_Failed)
153         {
154           log_error (_("can't connect to the agent - trying fall back\n"));
155           force_pipe_server = 1;
156           return start_agent ();
157         }
158     }
159
160   if (rc)
161     {
162       log_error ("can't connect to the agent: %s\n", assuan_strerror (rc));
163       return gpg_error (GPG_ERR_NO_AGENT);
164     }
165   agent_ctx = ctx;
166
167   if (DBG_ASSUAN)
168     log_debug ("connection to agent established\n");
169
170   rc = assuan_transact (agent_ctx, "RESET", NULL, NULL, NULL, NULL, NULL, NULL);
171   if (rc)
172     return map_assuan_err (rc);
173
174   dft_display = getenv ("DISPLAY");
175   if (opt.display || dft_display)
176     {
177       char *optstr;
178       if (asprintf (&optstr, "OPTION display=%s",
179                     opt.display ? opt.display : dft_display) < 0)
180         return gpg_error_from_errno (errno);
181       rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
182                             NULL);
183       free (optstr);
184       if (rc)
185         return map_assuan_err (rc);
186     }
187   if (!opt.ttyname)
188     {
189       dft_ttyname = getenv ("GPG_TTY");
190       if ((!dft_ttyname || !*dft_ttyname) && ttyname (0))
191         dft_ttyname = ttyname (0);
192     }
193   if (opt.ttyname || dft_ttyname)
194     {
195       char *optstr;
196       if (asprintf (&optstr, "OPTION ttyname=%s",
197                     opt.ttyname ? opt.ttyname : dft_ttyname) < 0)
198         return gpg_error_from_errno (errno);
199       rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
200                             NULL);
201       free (optstr);
202       if (rc)
203         return map_assuan_err (rc);
204     }
205   dft_ttytype = getenv ("TERM");
206   if (opt.ttytype || (dft_ttyname && dft_ttytype))
207     {
208       char *optstr;
209       if (asprintf (&optstr, "OPTION ttytype=%s",
210                     opt.ttyname ? opt.ttytype : dft_ttytype) < 0)
211         return gpg_error_from_errno (errno);
212       rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
213                             NULL);
214       free (optstr);
215       if (rc)
216         return map_assuan_err (rc);
217     }
218 #if defined(HAVE_SETLOCALE) && defined(LC_CTYPE)
219   old_lc = setlocale (LC_CTYPE, NULL);
220   if (old_lc)
221     {
222       old_lc = strdup (old_lc);
223       if (!old_lc)
224         return gpg_error_from_errno (errno);
225
226     }
227   dft_lc = setlocale (LC_CTYPE, "");
228 #endif
229   if (opt.lc_ctype || (dft_ttyname && dft_lc))
230     {
231       char *optstr;
232       if (asprintf (&optstr, "OPTION lc-ctype=%s",
233                     opt.lc_ctype ? opt.lc_ctype : dft_lc) < 0)
234         rc = gpg_error_from_errno (errno);
235       else
236         {
237           rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
238                                 NULL);
239           free (optstr);
240           if (rc)
241             rc = map_assuan_err (rc);
242         }
243     }
244 #if defined(HAVE_SETLOCALE) && defined(LC_CTYPE)
245   if (old_lc)
246     {
247       setlocale (LC_CTYPE, old_lc);
248       free (old_lc);
249     }
250 #endif
251   if (rc)
252     return rc;
253 #if defined(HAVE_SETLOCALE) && defined(LC_MESSAGES)
254   old_lc = setlocale (LC_MESSAGES, NULL);
255   if (old_lc)
256     {
257       old_lc = strdup (old_lc);
258       if (!old_lc)
259         return gpg_error_from_errno (errno);
260     }
261   dft_lc = setlocale (LC_MESSAGES, "");
262 #endif
263   if (opt.lc_messages || (dft_ttyname && dft_lc))
264     {
265       char *optstr;
266       if (asprintf (&optstr, "OPTION lc-messages=%s",
267                     opt.lc_messages ? opt.lc_messages : dft_lc) < 0)
268         rc = gpg_error_from_errno (errno);
269       else
270         {
271           rc = assuan_transact (agent_ctx, optstr, NULL, NULL, NULL, NULL, NULL,
272                                 NULL);
273           free (optstr);
274           if (rc)
275             rc = map_assuan_err (rc);
276         }
277     }
278 #if defined(HAVE_SETLOCALE) && defined(LC_MESSAGES)
279   if (old_lc)
280     {
281       setlocale (LC_MESSAGES, old_lc);
282       free (old_lc);
283     }
284 #endif
285
286   return rc;
287 }
288
289
290 /* Return a new malloced string by unescaping the string S.  Escaping
291    is percent escaping and '+'/space mapping.  A binary nul will
292    silently be replaced by a 0xFF.  Function returns NULL to indicate
293    an out of memory status. */
294 static char *
295 unescape_status_string (const unsigned char *s)
296 {
297   char *buffer, *d;
298
299   buffer = d = xtrymalloc (strlen (s)+1);
300   if (!buffer)
301     return NULL;
302   while (*s)
303     {
304       if (*s == '%' && s[1] && s[2])
305         { 
306           s++;
307           *d = xtoi_2 (s);
308           if (!*d)
309             *d = '\xff';
310           d++;
311           s += 2;
312         }
313       else if (*s == '+')
314         {
315           *d++ = ' ';
316           s++;
317         }
318       else
319         *d++ = *s++;
320     }
321   *d = 0; 
322   return buffer;
323 }
324
325 /* Take a 20 byte hexencoded string and put it into the the provided
326    20 byte buffer FPR in binary format. */
327 static int
328 unhexify_fpr (const char *hexstr, unsigned char *fpr)
329 {
330   const char *s;
331   int n;
332
333   for (s=hexstr, n=0; hexdigitp (s); s++, n++)
334     ;
335   if (*s || (n != 40))
336     return 0; /* no fingerprint (invalid or wrong length). */
337   n /= 2;
338   for (s=hexstr, n=0; *s; s += 2, n++)
339     fpr[n] = xtoi_2 (s);
340   return 1; /* okay */
341 }
342
343 /* Take the serial number from LINE and return it verbatim in a newly
344    allocated string.  We make sure that only hex characters are
345    returned. */
346 static char *
347 store_serialno (const char *line)
348 {
349   const char *s;
350   char *p;
351
352   for (s=line; hexdigitp (s); s++)
353     ;
354   p = xtrymalloc (s + 1 - line);
355   if (p)
356     {
357       memcpy (p, line, s-line);
358       p[s-line] = 0;
359     }
360   return p;
361 }
362
363
364 \f
365 #if 0
366 /* Handle a KEYPARMS inquiry.  Note, we only send the data,
367    assuan_transact takes care of flushing and writing the end */
368 static AssuanError
369 inq_genkey_parms (void *opaque, const char *keyword)
370 {
371   struct genkey_parm_s *parm = opaque; 
372   AssuanError rc;
373
374   rc = assuan_send_data (parm->ctx, parm->sexp, parm->sexplen);
375   return rc; 
376 }
377
378
379 \f
380 /* Call the agent to generate a new key */
381 int
382 agent_genkey (KsbaConstSexp keyparms, KsbaSexp *r_pubkey)
383 {
384   int rc;
385   struct genkey_parm_s gk_parm;
386   membuf_t data;
387   size_t len;
388   char *buf;
389
390   *r_pubkey = NULL;
391   rc = start_agent ();
392   if (rc)
393     return rc;
394
395   rc = assuan_transact (agent_ctx, "RESET", NULL, NULL,
396                         NULL, NULL, NULL, NULL);
397   if (rc)
398     return map_assuan_err (rc);
399
400   init_membuf (&data, 1024);
401   gk_parm.ctx = agent_ctx;
402   gk_parm.sexp = keyparms;
403   gk_parm.sexplen = gcry_sexp_canon_len (keyparms, 0, NULL, NULL);
404   if (!gk_parm.sexplen)
405     return gpg_error (GPG_ERR_INV_VALUE);
406   rc = assuan_transact (agent_ctx, "GENKEY",
407                         membuf_data_cb, &data, 
408                         inq_genkey_parms, &gk_parm, NULL, NULL);
409   if (rc)
410     {
411       xfree (get_membuf (&data, &len));
412       return map_assuan_err (rc);
413     }
414   buf = get_membuf (&data, &len);
415   if (!buf)
416     return gpg_error (GPG_ERR_ENOMEM);
417   if (!gcry_sexp_canon_len (buf, len, NULL, NULL))
418     {
419       xfree (buf);
420       return gpg_error (GPG_ERR_INV_SEXP);
421     }
422   *r_pubkey = buf;
423   return 0;
424 }
425 #endif /*0*/
426
427
428 \f
429 /* Ask the agent whether the corresponding secret key is available for
430    the given keygrip. */
431 int
432 agent_havekey (const char *hexkeygrip)
433 {
434   int rc;
435   char line[ASSUAN_LINELENGTH];
436
437   rc = start_agent ();
438   if (rc)
439     return rc;
440
441   if (!hexkeygrip || strlen (hexkeygrip) != 40)
442     return gpg_error (GPG_ERR_INV_VALUE);
443
444   snprintf (line, DIM(line)-1, "HAVEKEY %s", hexkeygrip);
445   line[DIM(line)-1] = 0;
446
447   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
448   return map_assuan_err (rc);
449 }
450
451 \f
452 /* Release the card info structure INFO. */
453 void
454 agent_release_card_info (struct agent_card_info_s *info)
455 {
456   if (!info)
457     return;
458
459   xfree (info->serialno); info->serialno = NULL;
460   xfree (info->disp_name); info->disp_name = NULL;
461   xfree (info->pubkey_url); info->pubkey_url = NULL;
462   info->fpr1valid = info->fpr2valid = info->fpr3valid = 0;
463 }
464
465 static AssuanError
466 learn_status_cb (void *opaque, const char *line)
467 {
468   struct agent_card_info_s *parm = opaque;
469   const char *keyword = line;
470   int keywordlen;
471
472   for (keywordlen=0; *line && !spacep (line); line++, keywordlen++)
473     ;
474   while (spacep (line))
475     line++;
476
477   if (keywordlen == 8 && !memcmp (keyword, "SERIALNO", keywordlen))
478     {
479       parm->serialno = store_serialno (line);
480     }
481   else if (keywordlen == 9 && !memcmp (keyword, "DISP-NAME", keywordlen))
482     {
483       parm->disp_name = unescape_status_string (line);
484     }
485   else if (keywordlen == 10 && !memcmp (keyword, "PUBKEY-URL", keywordlen))
486     {
487       parm->pubkey_url = unescape_status_string (line);
488     }
489   else if (keywordlen == 7 && !memcmp (keyword, "KEY-FPR", keywordlen))
490     {
491       int no = atoi (line);
492       while (!spacep (line))
493         line++;
494       while (spacep (line))
495         line++;
496       if (no == 1)
497         parm->fpr1valid = unhexify_fpr (line, parm->fpr1);
498       else if (no == 2)
499         parm->fpr2valid = unhexify_fpr (line, parm->fpr2);
500       else if (no == 3)
501         parm->fpr3valid = unhexify_fpr (line, parm->fpr3);
502     }
503   
504   return 0;
505 }
506
507 /* Call the agent to learn about a smartcard */
508 int
509 agent_learn (struct agent_card_info_s *info)
510 {
511   int rc;
512
513   rc = start_agent ();
514   if (rc)
515     return rc;
516
517   memset (info, 0, sizeof *info);
518   rc = assuan_transact (agent_ctx, "LEARN --send",
519                         NULL, NULL, NULL, NULL,
520                         learn_status_cb, info);
521   
522   return map_assuan_err (rc);
523 }
524
525 \f
526 /* Send an setattr command to the SCdaemon. */
527 int
528 agent_scd_setattr (const char *name,
529                    const unsigned char *value, size_t valuelen)
530 {
531   int rc;
532   char line[ASSUAN_LINELENGTH];
533   char *p;
534
535   if (!*name || !valuelen)
536     return gpg_error (GPG_ERR_INV_VALUE);
537
538   /* We assume that NAME does not need escaping. */
539   if (12 + strlen (name) > DIM(line)-1)
540     return gpg_error (GPG_ERR_TOO_LARGE);
541       
542   p = stpcpy (stpcpy (line, "SCD SETATTR "), name); 
543   *p++ = ' ';
544   for (; valuelen; value++, valuelen--)
545     {
546       if (p >= line + DIM(line)-5 )
547         return gpg_error (GPG_ERR_TOO_LARGE);
548       if (*value < ' ' || *value == '+' || *value == '%')
549         {
550           sprintf (p, "%%%02X", *value);
551           p += 3;
552         }
553       else if (*value == ' ')
554         *p++ = '+';
555       else
556         *p++ = *value;
557     }
558   *p = 0;
559
560   rc = start_agent ();
561   if (rc)
562     return rc;
563
564   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
565   return map_assuan_err (rc);
566 }
567
568 \f
569 /* Status callback for the SCD GENKEY command. */
570 static AssuanError
571 scd_genkey_cb (void *opaque, const char *line)
572 {
573   struct agent_card_genkey_s *parm = opaque;
574   const char *keyword = line;
575   int keywordlen;
576   gpg_error_t rc;
577
578   log_debug ("got status line `%s'\n", line);
579   for (keywordlen=0; *line && !spacep (line); line++, keywordlen++)
580     ;
581   while (spacep (line))
582     line++;
583
584   if (keywordlen == 7 && !memcmp (keyword, "KEY-FPR", keywordlen))
585     {
586       parm->fprvalid = unhexify_fpr (line, parm->fpr);
587     }
588   if (keywordlen == 8 && !memcmp (keyword, "KEY-DATA", keywordlen))
589     {
590       gcry_mpi_t a;
591       const char *name = line;
592
593       while (!spacep (line))
594         line++;
595       while (spacep (line))
596         line++;
597
598       rc = gcry_mpi_scan (&a, GCRYMPI_FMT_HEX, line, 0);
599       if (rc)
600         log_error ("error parsing received key data: %s\n", gpg_strerror (rc));
601       else if (*name == 'n' && spacep (name+1))
602         parm->n = a;
603       else if (*name == 'e' && spacep (name+1))
604         parm->e = a;
605       else
606         {
607           log_info ("unknown parameter name in received key data\n");
608           gcry_mpi_release (a);
609         }
610     }
611   else if (keywordlen == 14 && !memcmp (keyword,"KEY-CREATED-AT", keywordlen))
612     {
613       parm->created_at = (u32)strtoul (line, NULL, 10);
614     }
615
616   return 0;
617 }
618
619 /* Send a GENKEY command to the SCdaemon. */
620 int
621 agent_scd_genkey (struct agent_card_genkey_s *info, int keyno, int force)
622 {
623   int rc;
624   char line[ASSUAN_LINELENGTH];
625
626   rc = start_agent ();
627   if (rc)
628     return rc;
629
630   memset (info, 0, sizeof *info);
631   snprintf (line, DIM(line)-1, "SCD GENKEY %s%d",
632             force? "--force ":"", keyno);
633   line[DIM(line)-1] = 0;
634
635   memset (info, 0, sizeof *info);
636   rc = assuan_transact (agent_ctx, line,
637                         NULL, NULL, NULL, NULL,
638                         scd_genkey_cb, info);
639   
640   return map_assuan_err (rc);
641 }
642
643 \f
644 static AssuanError
645 membuf_data_cb (void *opaque, const void *buffer, size_t length)
646 {
647   membuf_t *data = opaque;
648
649   if (buffer)
650     put_membuf (data, buffer, length);
651   return 0;
652 }
653   
654 /* Send a sign command to the scdaemon via gpg-agent's pass thru
655    mechanism. */
656 int
657 agent_scd_pksign (const char *serialno, int hashalgo,
658                   const unsigned char *indata, size_t indatalen,
659                   char **r_buf, size_t *r_buflen)
660 {
661   int rc, i;
662   char *p, line[ASSUAN_LINELENGTH];
663   membuf_t data;
664   size_t len;
665
666   /* Note, hashalgo is not yet used but hardwired to SHA1 in SCdaemon. */
667
668   *r_buf = NULL;
669   *r_buflen = 0;
670
671   rc = start_agent ();
672   if (rc)
673     return rc;
674
675   if (indatalen*2 + 50 > DIM(line))
676     return gpg_error (GPG_ERR_GENERAL);
677
678   sprintf (line, "SCD SETDATA ");
679   p = line + strlen (line);
680   for (i=0; i < indatalen ; i++, p += 2 )
681     sprintf (p, "%02X", indata[i]);
682   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
683   if (rc)
684     return map_assuan_err (rc);
685
686   init_membuf (&data, 1024);
687 #if 0
688   if (!hashalgo) /* Temporary test hack. */
689     snprintf (line, DIM(line)-1, "SCD PKAUTH %s", serialno);
690   else
691 #endif
692    snprintf (line, DIM(line)-1, "SCD PKSIGN %s", serialno);
693   line[DIM(line)-1] = 0;
694   rc = assuan_transact (agent_ctx, line, membuf_data_cb, &data,
695                         NULL, NULL, NULL, NULL);
696   if (rc)
697     {
698       xfree (get_membuf (&data, &len));
699       return map_assuan_err (rc);
700     }
701   *r_buf = get_membuf (&data, r_buflen);
702
703   return 0;
704 }
705
706
707 /* Decrypt INDATA of length INDATALEN using the card identified by
708    SERIALNO.  Return the plaintext in a nwly allocated buffer stored
709    at the address of R_BUF. 
710
711    Note, we currently support only RSA or more exactly algorithms
712    taking one input data element. */
713 int
714 agent_scd_pkdecrypt (const char *serialno,
715                      const unsigned char *indata, size_t indatalen,
716                      char **r_buf, size_t *r_buflen)
717 {
718   int rc, i;
719   char *p, line[ASSUAN_LINELENGTH];
720   membuf_t data;
721   size_t len;
722
723   *r_buf = NULL;
724   rc = start_agent ();
725   if (rc)
726     return rc;
727
728   /* FIXME: use secure memory where appropriate */
729   if (indatalen*2 + 50 > DIM(line))
730     return gpg_error (GPG_ERR_GENERAL);
731
732   sprintf (line, "SCD SETDATA ");
733   p = line + strlen (line);
734   for (i=0; i < indatalen ; i++, p += 2 )
735     sprintf (p, "%02X", indata[i]);
736   rc = assuan_transact (agent_ctx, line, NULL, NULL, NULL, NULL, NULL, NULL);
737   if (rc)
738     return map_assuan_err (rc);
739
740   init_membuf (&data, 1024);
741   snprintf (line, DIM(line)-1, "SCD PKDECRYPT %s", serialno);
742   line[DIM(line)-1] = 0;
743   rc = assuan_transact (agent_ctx, line,
744                         membuf_data_cb, &data,
745                         NULL, NULL, NULL, NULL);
746   if (rc)
747     {
748       xfree (get_membuf (&data, &len));
749       return map_assuan_err (rc);
750     }
751   *r_buf = get_membuf (&data, r_buflen);
752   if (!*r_buf)
753     return gpg_error (GPG_ERR_ENOMEM);
754
755   return 0;
756 }
757
758
759 /* Change the PIN of an OpenPGP card or reset the retry counter.
760    CHVNO 1: Change the digital signature PIN
761          2: Change the decryption and authentication PIN
762          3: Change the admin PIN
763        101: Set a new digital signature PIN and reset the retry counter
764        102: Set a decryption and authentication PIN
765             and reset the retry counter
766  */
767 int
768 agent_scd_change_pin (int chvno)
769 {
770   int rc;
771   char line[ASSUAN_LINELENGTH];
772   const char *reset = "";
773
774   if (chvno >= 100)
775     reset = "--reset";
776   chvno %= 100;
777
778   rc = start_agent ();
779   if (rc)
780     return rc;
781
782   snprintf (line, DIM(line)-1, "SCD PASSWD %s %d", reset, chvno);
783   line[DIM(line)-1] = 0;
784   rc = assuan_transact (agent_ctx, line, NULL, NULL,
785                         NULL, NULL, NULL, NULL);
786   return map_assuan_err (rc);
787 }
788