[BACK]Return to ssh-keygen.c CVS log [TXT][DIR] Up to [local] / src / usr.bin / ssh

Diff for /src/usr.bin/ssh/ssh-keygen.c between version 1.25.2.4 and 1.57

version 1.25.2.4, 2001/03/12 15:44:16 version 1.57, 2001/04/22 13:25:37
Line 19 
Line 19 
   
 #include "xmalloc.h"  #include "xmalloc.h"
 #include "key.h"  #include "key.h"
   #include "rsa.h"
 #include "authfile.h"  #include "authfile.h"
 #include "uuencode.h"  #include "uuencode.h"
 #include "buffer.h"  #include "buffer.h"
Line 46 
Line 47 
   
 /* Flag indicating that we just want to see the key fingerprint */  /* Flag indicating that we just want to see the key fingerprint */
 int print_fingerprint = 0;  int print_fingerprint = 0;
   int print_bubblebabble = 0;
   
 /* The identity file name, given on the command line or entered by the user. */  /* The identity file name, given on the command line or entered by the user. */
 char identity_file[1024];  char identity_file[1024];
Line 106 
Line 108 
         have_identity = 1;          have_identity = 1;
 }  }
   
 int  Key *
 try_load_key(char *filename, Key *k)  try_load_pem_key(char *filename)
 {  {
         int success = 1;          char *pass;
         if (!load_private_key(filename, "", k, NULL)) {          Key *prv;
                 char *pass = read_passphrase("Enter passphrase: ", 1);  
                 if (!load_private_key(filename, pass, k, NULL)) {          prv = key_load_private(filename, "", NULL);
                         success = 0;          if (prv == NULL) {
                 }                  pass = read_passphrase("Enter passphrase: ", 1);
                   prv = key_load_private(filename, pass, NULL);
                 memset(pass, 0, strlen(pass));                  memset(pass, 0, strlen(pass));
                 xfree(pass);                  xfree(pass);
         }          }
         return success;          return prv;
 }  }
   
 #define SSH_COM_PUBLIC_BEGIN            "---- BEGIN SSH2 PUBLIC KEY ----"  #define SSH_COM_PUBLIC_BEGIN            "---- BEGIN SSH2 PUBLIC KEY ----"
Line 129 
Line 132 
 void  void
 do_convert_to_ssh2(struct passwd *pw)  do_convert_to_ssh2(struct passwd *pw)
 {  {
         Key *k;          Key *prv;
         int len;          int len;
         u_char *blob;          u_char *blob;
         struct stat st;          struct stat st;
Line 140 
Line 143 
                 perror(identity_file);                  perror(identity_file);
                 exit(1);                  exit(1);
         }          }
         k = key_new(KEY_UNSPEC);          prv = try_load_pem_key(identity_file);
         if (!try_load_key(identity_file, k)) {          if (prv == NULL) {
                 fprintf(stderr, "load failed\n");                  fprintf(stderr, "load failed\n");
                 exit(1);                  exit(1);
         }          }
         key_to_blob(k, &blob, &len);          key_to_blob(prv, &blob, &len);
         fprintf(stdout, "%s\n", SSH_COM_PUBLIC_BEGIN);          fprintf(stdout, "%s\n", SSH_COM_PUBLIC_BEGIN);
         fprintf(stdout,          fprintf(stdout,
             "Comment: \"%d-bit %s, converted from OpenSSH by %s@%s\"\n",              "Comment: \"%d-bit %s, converted from OpenSSH by %s@%s\"\n",
             key_size(k), key_type(k),              key_size(prv), key_type(prv),
             pw->pw_name, hostname);              pw->pw_name, hostname);
         dump_base64(stdout, blob, len);          dump_base64(stdout, blob, len);
         fprintf(stdout, "%s\n", SSH_COM_PUBLIC_END);          fprintf(stdout, "%s\n", SSH_COM_PUBLIC_END);
         key_free(k);          key_free(prv);
         xfree(blob);          xfree(blob);
         exit(0);          exit(0);
 }  }
Line 163 
Line 166 
 {  {
         int bits = buffer_get_int(b);          int bits = buffer_get_int(b);
         int bytes = (bits + 7) / 8;          int bytes = (bits + 7) / 8;
   
         if (buffer_len(b) < bytes)          if (buffer_len(b) < bytes)
                 fatal("buffer_get_bignum_bits: input buffer too small");                  fatal("buffer_get_bignum_bits: input buffer too small: "
                       "need %d have %d", bytes, buffer_len(b));
         BN_bin2bn((u_char *)buffer_ptr(b), bytes, value);          BN_bin2bn((u_char *)buffer_ptr(b), bytes, value);
         buffer_consume(b, bytes);          buffer_consume(b, bytes);
 }  }
Line 173 
Line 178 
 do_convert_private_ssh2_from_blob(char *blob, int blen)  do_convert_private_ssh2_from_blob(char *blob, int blen)
 {  {
         Buffer b;          Buffer b;
         DSA *dsa;  
         Key *key = NULL;          Key *key = NULL;
         int ignore, magic, rlen;          int ignore, magic, rlen, ktype;
         char *type, *cipher;          char *type, *cipher;
   
         buffer_init(&b);          buffer_init(&b);
Line 193 
Line 197 
         ignore = buffer_get_int(&b);          ignore = buffer_get_int(&b);
         ignore = buffer_get_int(&b);          ignore = buffer_get_int(&b);
         ignore = buffer_get_int(&b);          ignore = buffer_get_int(&b);
         xfree(type);  
   
         if (strcmp(cipher, "none") != 0) {          if (strcmp(cipher, "none") != 0) {
                 error("unsupported cipher %s", cipher);                  error("unsupported cipher %s", cipher);
                 xfree(cipher);                  xfree(cipher);
                 buffer_free(&b);                  buffer_free(&b);
                   xfree(type);
                 return NULL;                  return NULL;
         }          }
         xfree(cipher);          xfree(cipher);
   
         key = key_new(KEY_DSA);          if (strstr(type, "dsa")) {
         dsa = key->dsa;                  ktype = KEY_DSA;
         dsa->priv_key = BN_new();          } else if (strstr(type, "rsa")) {
         if (dsa->priv_key == NULL) {                  ktype = KEY_RSA;
                 error("alloc priv_key failed");          } else {
                 key_free(key);                  xfree(type);
                 return NULL;                  return NULL;
         }          }
         buffer_get_bignum_bits(&b, dsa->p);          key = key_new_private(ktype);
         buffer_get_bignum_bits(&b, dsa->g);          xfree(type);
         buffer_get_bignum_bits(&b, dsa->q);  
         buffer_get_bignum_bits(&b, dsa->pub_key);          switch (key->type) {
         buffer_get_bignum_bits(&b, dsa->priv_key);          case KEY_DSA:
                   buffer_get_bignum_bits(&b, key->dsa->p);
                   buffer_get_bignum_bits(&b, key->dsa->g);
                   buffer_get_bignum_bits(&b, key->dsa->q);
                   buffer_get_bignum_bits(&b, key->dsa->pub_key);
                   buffer_get_bignum_bits(&b, key->dsa->priv_key);
                   break;
           case KEY_RSA:
                   if (!BN_set_word(key->rsa->e, (u_long) buffer_get_char(&b))) {
                           buffer_free(&b);
                           key_free(key);
                           return NULL;
                   }
                   buffer_get_bignum_bits(&b, key->rsa->d);
                   buffer_get_bignum_bits(&b, key->rsa->n);
                   buffer_get_bignum_bits(&b, key->rsa->iqmp);
                   buffer_get_bignum_bits(&b, key->rsa->q);
                   buffer_get_bignum_bits(&b, key->rsa->p);
                   generate_additional_parameters(key->rsa);
                   break;
           }
         rlen = buffer_len(&b);          rlen = buffer_len(&b);
         if(rlen != 0)          if(rlen != 0)
                 error("do_convert_private_ssh2_from_blob: remaining bytes in key blob %d", rlen);                  error("do_convert_private_ssh2_from_blob: "
                       "remaining bytes in key blob %d", rlen);
         buffer_free(&b);          buffer_free(&b);
   #ifdef DEBUG_PK
           {
                   u_int slen;
                   u_char *sig, data[10] = "abcde12345";
   
                   key_sign(key, &sig, &slen, data, sizeof data);
                   key_verify(key, sig, slen, data, sizeof data);
                   xfree(sig);
           }
   #endif
         return key;          return key;
 }  }
   
Line 282 
Line 317 
                 exit(1);                  exit(1);
         }          }
         ok = private ?          ok = private ?
             PEM_write_DSAPrivateKey(stdout, k->dsa, NULL, NULL, 0, NULL, NULL) :              (k->type == KEY_DSA ?
                    PEM_write_DSAPrivateKey(stdout, k->dsa, NULL, NULL, 0, NULL, NULL) :
                    PEM_write_RSAPrivateKey(stdout, k->rsa, NULL, NULL, 0, NULL, NULL)) :
             key_write(k, stdout);              key_write(k, stdout);
         if (!ok) {          if (!ok) {
                 fprintf(stderr, "key write failed");                  fprintf(stderr, "key write failed");
Line 297 
Line 334 
 void  void
 do_print_public(struct passwd *pw)  do_print_public(struct passwd *pw)
 {  {
         Key *k;          Key *prv;
         struct stat st;          struct stat st;
   
         if (!have_identity)          if (!have_identity)
Line 306 
Line 343 
                 perror(identity_file);                  perror(identity_file);
                 exit(1);                  exit(1);
         }          }
         k = key_new(KEY_UNSPEC);          prv = try_load_pem_key(identity_file);
         if (!try_load_key(identity_file, k)) {          if (prv == NULL) {
                 fprintf(stderr, "load failed\n");                  fprintf(stderr, "load failed\n");
                 exit(1);                  exit(1);
         }          }
         if (!key_write(k, stdout))          if (!key_write(prv, stdout))
                 fprintf(stderr, "key_write failed");                  fprintf(stderr, "key_write failed");
         key_free(k);          key_free(prv);
         fprintf(stdout, "\n");          fprintf(stdout, "\n");
         exit(0);          exit(0);
 }  }
Line 321 
Line 358 
 void  void
 do_fingerprint(struct passwd *pw)  do_fingerprint(struct passwd *pw)
 {  {
   
         FILE *f;          FILE *f;
         Key *public;          Key *public;
         char *comment = NULL, *cp, *ep, line[16*1024];          char *comment = NULL, *cp, *ep, line[16*1024], *fp;
         int i, skip = 0, num = 1, invalid = 1, success = 0;          int i, skip = 0, num = 1, invalid = 1, rep, fptype;
         struct stat st;          struct stat st;
   
           fptype = print_bubblebabble ? SSH_FP_SHA1 : SSH_FP_MD5;
           rep =    print_bubblebabble ? SSH_FP_BUBBLEBABBLE : SSH_FP_HEX;
   
         if (!have_identity)          if (!have_identity)
                 ask_filename(pw, "Enter file in which the key is");                  ask_filename(pw, "Enter file in which the key is");
         if (stat(identity_file, &st) < 0) {          if (stat(identity_file, &st) < 0) {
                 perror(identity_file);                  perror(identity_file);
                 exit(1);                  exit(1);
         }          }
         public = key_new(KEY_RSA1);          public = key_load_public(identity_file, &comment);
         if (load_public_key(identity_file, public, &comment)) {          if (public != NULL) {
                 success = 1;                  fp = key_fingerprint(public, fptype, rep);
         } else {                  printf("%d %s %s\n", key_size(public), fp, comment);
                 key_free(public);                  key_free(public);
                 public = key_new(KEY_UNSPEC);  
                 if (try_load_public_key(identity_file, public, &comment))  
                         success = 1;  
                 else  
                         debug("try_load_public_key KEY_UNSPEC failed");  
         }  
         if (success) {  
                 printf("%d %s %s\n", key_size(public), key_fingerprint(public), comment);  
                 key_free(public);  
                 xfree(comment);                  xfree(comment);
                   xfree(fp);
                 exit(0);                  exit(0);
         }          }
           if (comment)
                   xfree(comment);
   
         f = fopen(identity_file, "r");          f = fopen(identity_file, "r");
         if (f != NULL) {          if (f != NULL) {
Line 399 
Line 432 
                                 }                                  }
                         }                          }
                         comment = *cp ? cp : comment;                          comment = *cp ? cp : comment;
                         printf("%d %s %s\n", key_size(public),                          fp = key_fingerprint(public, fptype, rep);
                             key_fingerprint(public),                          printf("%d %s %s\n", key_size(public), fp,
                             comment ? comment : "no comment");                              comment ? comment : "no comment");
                           xfree(fp);
                           key_free(public);
                         invalid = 0;                          invalid = 0;
                 }                  }
                 fclose(f);                  fclose(f);
         }          }
         key_free(public);  
         if (invalid) {          if (invalid) {
                 printf("%s is not a valid key file.\n", identity_file);                  printf("%s is not a valid key file.\n", identity_file);
                 exit(1);                  exit(1);
Line 425 
Line 459 
         char *old_passphrase, *passphrase1, *passphrase2;          char *old_passphrase, *passphrase1, *passphrase2;
         struct stat st;          struct stat st;
         Key *private;          Key *private;
         Key *public;  
         int type = KEY_RSA1;  
   
         if (!have_identity)          if (!have_identity)
                 ask_filename(pw, "Enter file in which the key is");                  ask_filename(pw, "Enter file in which the key is");
Line 434 
Line 466 
                 perror(identity_file);                  perror(identity_file);
                 exit(1);                  exit(1);
         }          }
         public = key_new(type);  
         if (!load_public_key(identity_file, public, NULL)) {  
                 type = KEY_UNSPEC;  
         } else {  
                 /* Clear the public key since we are just about to load the whole file. */  
                 key_free(public);  
         }  
         /* Try to load the file with empty passphrase. */          /* Try to load the file with empty passphrase. */
         private = key_new(type);          private = key_load_private(identity_file, "", &comment);
         if (!load_private_key(identity_file, "", private, &comment)) {          if (private == NULL) {
                 if (identity_passphrase)                  if (identity_passphrase)
                         old_passphrase = xstrdup(identity_passphrase);                          old_passphrase = xstrdup(identity_passphrase);
                 else                  else
                         old_passphrase = read_passphrase("Enter old passphrase: ", 1);                          old_passphrase = read_passphrase("Enter old passphrase: ", 1);
                 if (!load_private_key(identity_file, old_passphrase, private, &comment)) {                  private = key_load_private(identity_file, old_passphrase , &comment);
                         memset(old_passphrase, 0, strlen(old_passphrase));                  memset(old_passphrase, 0, strlen(old_passphrase));
                         xfree(old_passphrase);                  xfree(old_passphrase);
                   if (private == NULL) {
                         printf("Bad passphrase.\n");                          printf("Bad passphrase.\n");
                         exit(1);                          exit(1);
                 }                  }
                 memset(old_passphrase, 0, strlen(old_passphrase));  
                 xfree(old_passphrase);  
         }          }
         printf("Key has comment '%s'\n", comment);          printf("Key has comment '%s'\n", comment);
   
Line 483 
Line 507 
         }          }
   
         /* Save the file using the new passphrase. */          /* Save the file using the new passphrase. */
         if (!save_private_key(identity_file, passphrase1, private, comment)) {          if (!key_save_private(private, identity_file, passphrase1, comment)) {
                 printf("Saving the key failed: %s: %s.\n",                  printf("Saving the key failed: %s.\n", identity_file);
                        identity_file, strerror(errno));  
                 memset(passphrase1, 0, strlen(passphrase1));                  memset(passphrase1, 0, strlen(passphrase1));
                 xfree(passphrase1);                  xfree(passphrase1);
                 key_free(private);                  key_free(private);
Line 508 
Line 531 
 void  void
 do_change_comment(struct passwd *pw)  do_change_comment(struct passwd *pw)
 {  {
         char new_comment[1024], *comment;          char new_comment[1024], *comment, *passphrase;
         Key *private;          Key *private;
         Key *public;          Key *public;
         char *passphrase;  
         struct stat st;          struct stat st;
         FILE *f;          FILE *f;
           int fd;
   
         if (!have_identity)          if (!have_identity)
                 ask_filename(pw, "Enter file in which the key is");                  ask_filename(pw, "Enter file in which the key is");
Line 521 
Line 544 
                 perror(identity_file);                  perror(identity_file);
                 exit(1);                  exit(1);
         }          }
         /*          private = key_load_private(identity_file, "", &comment);
          * Try to load the public key from the file the verify that it is          if (private == NULL) {
          * readable and of the proper format.  
          */  
         public = key_new(KEY_RSA1);  
         if (!load_public_key(identity_file, public, NULL)) {  
                 printf("%s is not a valid key file.\n", identity_file);  
                 printf("Comments are only supported in RSA1 keys\n");  
                 exit(1);  
         }  
   
         private = key_new(KEY_RSA1);  
         if (load_private_key(identity_file, "", private, &comment))  
                 passphrase = xstrdup("");  
         else {  
                 if (identity_passphrase)                  if (identity_passphrase)
                         passphrase = xstrdup(identity_passphrase);                          passphrase = xstrdup(identity_passphrase);
                 else if (identity_new_passphrase)                  else if (identity_new_passphrase)
Line 543 
Line 553 
                 else                  else
                         passphrase = read_passphrase("Enter passphrase: ", 1);                          passphrase = read_passphrase("Enter passphrase: ", 1);
                 /* Try to load using the passphrase. */                  /* Try to load using the passphrase. */
                 if (!load_private_key(identity_file, passphrase, private, &comment)) {                  private = key_load_private(identity_file, passphrase, &comment);
                   if (private == NULL) {
                         memset(passphrase, 0, strlen(passphrase));                          memset(passphrase, 0, strlen(passphrase));
                         xfree(passphrase);                          xfree(passphrase);
                         printf("Bad passphrase.\n");                          printf("Bad passphrase.\n");
                         exit(1);                          exit(1);
                 }                  }
           } else {
                   passphrase = xstrdup("");
         }          }
           if (private->type != KEY_RSA1) {
                   fprintf(stderr, "Comments are only supported for RSA1 keys.\n");
                   key_free(private);
                   exit(1);
           }
         printf("Key now has comment '%s'\n", comment);          printf("Key now has comment '%s'\n", comment);
   
         if (identity_comment) {          if (identity_comment) {
Line 567 
Line 585 
         }          }
   
         /* Save the file using the new passphrase. */          /* Save the file using the new passphrase. */
         if (!save_private_key(identity_file, passphrase, private, new_comment)) {          if (!key_save_private(private, identity_file, passphrase, new_comment)) {
                 printf("Saving the key failed: %s: %s.\n",                  printf("Saving the key failed: %s.\n", identity_file);
                        identity_file, strerror(errno));  
                 memset(passphrase, 0, strlen(passphrase));                  memset(passphrase, 0, strlen(passphrase));
                 xfree(passphrase);                  xfree(passphrase);
                 key_free(private);                  key_free(private);
Line 578 
Line 595 
         }          }
         memset(passphrase, 0, strlen(passphrase));          memset(passphrase, 0, strlen(passphrase));
         xfree(passphrase);          xfree(passphrase);
           public = key_from_private(private);
         key_free(private);          key_free(private);
   
         strlcat(identity_file, ".pub", sizeof(identity_file));          strlcat(identity_file, ".pub", sizeof(identity_file));
         f = fopen(identity_file, "w");          fd = open(identity_file, O_WRONLY | O_CREAT | O_TRUNC, 0644);
         if (!f) {          if (fd == -1) {
                 printf("Could not save your public key in %s\n", identity_file);                  printf("Could not save your public key in %s\n", identity_file);
                 exit(1);                  exit(1);
         }          }
           f = fdopen(fd, "w");
           if (f == NULL) {
                   printf("fdopen %s failed", identity_file);
                   exit(1);
           }
         if (!key_write(public, f))          if (!key_write(public, f))
                 fprintf(stderr, "write key failed");                  fprintf(stderr, "write key failed");
         key_free(public);          key_free(public);
Line 601 
Line 624 
 void  void
 usage(void)  usage(void)
 {  {
         printf("Usage: %s [-lpqxXyc] [-t type] [-b bits] [-f file] [-C comment] [-N new-pass] [-P pass]\n", __progname);          printf("Usage: %s [-lBpqxiec] [-t type] [-b bits] [-f file] [-C comment] "
               "[-N new-pass] [-P pass]\n", __progname);
         exit(1);          exit(1);
 }  }
   
Line 612 
Line 636 
 main(int ac, char **av)  main(int ac, char **av)
 {  {
         char dotsshdir[16 * 1024], comment[1024], *passphrase1, *passphrase2;          char dotsshdir[16 * 1024], comment[1024], *passphrase1, *passphrase2;
           Key *private, *public;
         struct passwd *pw;          struct passwd *pw;
         int opt, type;          int opt, type, fd;
         struct stat st;          struct stat st;
         FILE *f;          FILE *f;
         Key *private;  
         Key *public;  
   
         extern int optind;          extern int optind;
         extern char *optarg;          extern char *optarg;
Line 635 
Line 658 
                 exit(1);                  exit(1);
         }          }
   
         while ((opt = getopt(ac, av, "dqpclRxXyb:f:t:P:N:C:")) != -1) {          while ((opt = getopt(ac, av, "deiqpclBRxXyb:f:t:P:N:C:")) != -1) {
                 switch (opt) {                  switch (opt) {
                 case 'b':                  case 'b':
                         bits = atoi(optarg);                          bits = atoi(optarg);
Line 649 
Line 672 
                         print_fingerprint = 1;                          print_fingerprint = 1;
                         break;                          break;
   
                   case 'B':
                           print_bubblebabble = 1;
                           break;
   
                 case 'p':                  case 'p':
                         change_passphrase = 1;                          change_passphrase = 1;
                         break;                          break;
Line 683 
Line 710 
                         exit(0);                          exit(0);
                         break;                          break;
   
                   case 'e':
                 case 'x':                  case 'x':
                           /* export key */
                         convert_to_ssh2 = 1;                          convert_to_ssh2 = 1;
                         break;                          break;
   
                   case 'i':
                 case 'X':                  case 'X':
                           /* import key */
                         convert_from_ssh2 = 1;                          convert_from_ssh2 = 1;
                         break;                          break;
   
Line 716 
Line 747 
                 printf("Can only have one of -p and -c.\n");                  printf("Can only have one of -p and -c.\n");
                 usage();                  usage();
         }          }
         if (print_fingerprint)          if (print_fingerprint || print_bubblebabble)
                 do_fingerprint(pw);                  do_fingerprint(pw);
         if (change_passphrase)          if (change_passphrase)
                 do_change_passphrase(pw);                  do_change_passphrase(pw);
Line 800 
Line 831 
         }          }
   
         /* Save the key with the given passphrase and comment. */          /* Save the key with the given passphrase and comment. */
         if (!save_private_key(identity_file, passphrase1, private, comment)) {          if (!key_save_private(private, identity_file, passphrase1, comment)) {
                 printf("Saving the key failed: %s: %s.\n",                  printf("Saving the key failed: %s.\n", identity_file);
                     identity_file, strerror(errno));  
                 memset(passphrase1, 0, strlen(passphrase1));                  memset(passphrase1, 0, strlen(passphrase1));
                 xfree(passphrase1);                  xfree(passphrase1);
                 exit(1);                  exit(1);
Line 819 
Line 849 
                 printf("Your identification has been saved in %s.\n", identity_file);                  printf("Your identification has been saved in %s.\n", identity_file);
   
         strlcat(identity_file, ".pub", sizeof(identity_file));          strlcat(identity_file, ".pub", sizeof(identity_file));
         f = fopen(identity_file, "w");          fd = open(identity_file, O_WRONLY | O_CREAT | O_TRUNC, 0644);
         if (!f) {          if (fd == -1) {
                 printf("Could not save your public key in %s\n", identity_file);                  printf("Could not save your public key in %s\n", identity_file);
                 exit(1);                  exit(1);
         }          }
           f = fdopen(fd, "w");
           if (f == NULL) {
                   printf("fdopen %s failed", identity_file);
                   exit(1);
           }
         if (!key_write(public, f))          if (!key_write(public, f))
                 fprintf(stderr, "write key failed");                  fprintf(stderr, "write key failed");
         fprintf(f, " %s\n", comment);          fprintf(f, " %s\n", comment);
         fclose(f);          fclose(f);
   
         if (!quiet) {          if (!quiet) {
                   char *fp = key_fingerprint(public, SSH_FP_MD5, SSH_FP_HEX);
                 printf("Your public key has been saved in %s.\n",                  printf("Your public key has been saved in %s.\n",
                     identity_file);                      identity_file);
                 printf("The key fingerprint is:\n");                  printf("The key fingerprint is:\n");
                 printf("%s %s\n", key_fingerprint(public), comment);                  printf("%s %s\n", fp, comment);
                   xfree(fp);
         }          }
   
         key_free(public);          key_free(public);
Legend:
Removed from v.1.25.2.4  
changed lines
  Added in v.1.57