See ChangeLog: Tue Jun 1 16:01:46 CEST 1999 Werner Koch
[gnupg.git] / NEWS
1
2     * New option -N to insert notations and a --set-policy-url.
3
4     * New subcommand "delsig" in the edit menu.
5
6     * The name of the output file is not anymore the one which is
7       embedded in the processed message, but the used filename with
8       the extension stripped.  To revert to the old behaviour you can
9       use the option --use-embedded-filename.
10
11 Noteworthy changes in version 0.9.7
12 -----------------------------------
13
14     * Add some work arounds for a bugs in pgp 2 which led to bad signatures
15       when used with canoncial texts in some cases.
16
17     * Enhanced some status outputs.
18
19 Noteworthy changes in version 0.9.6
20 -----------------------------------
21
22     * Twofish is now statically linked by default. The experimental 128 bit
23       version is now disabled.  Full support will be available as soon as
24       the OpenPGP WG has decided on an interpretation of rfc2440.
25
26     * Dropped support for the ancient Blowfish160 which is not OpenPGP.
27
28     * Merged gpgm and gpg into one binary.
29
30     * Add "revsig" and "revkey" commands to the edit menu.  It is now
31       possible to revoke signature and subkeys.
32
33
34 Noteworthy changes in version 0.9.5
35 -----------------------------------
36
37     * New command "lsign" in the keyedit menu to create non-exportable
38       signatures.  Removed --trusted-keys option.
39
40     * A bunch of changes to the key validation code.
41
42     * --list-trust-path now has an optional --with-colons format.
43
44     * New command --recv-keys to import keys from an keyserver.
45
46
47 Noteworthy changes in version 0.9.4
48 -----------------------------------
49
50     * New configure option --enable-static-rnd=[egd|linux|unix|none]
51       to select a random gathering module for static linking.
52
53     * The original text is now verbatim copied to a cleartext signed message.
54
55     * Bugfixes but there are still a couple of bugs.
56
57
58 Noteworthy changes in version 0.9.3
59 -----------------------------------
60
61     * Changed the internal design of getkey which now allows a
62       efficient lookup of multiple keys and add a word match mode.
63
64     * New options --[no-]encrypt-to.
65
66     * Some changes to the configure stuff.  Switched to automake 1.4.
67       Removed intl/ from CVS, autogen.sh now uses gettextize.
68
69     * Preferences now include Twofish. Removed preference to Blowfish with
70       a special hack to suppress the "not listed in preferences" warning;
71       this is to allow us to switch completely to Twofish in the near future.
72
73     * Changed the locking stuff.
74
75     * Print all user ids of a good signature.
76
77
78 Noteworthy changes in version 0.9.2
79 -----------------------------------
80
81     * add some additional time warp checks.
82
83     * Option --keyserver and command --send-keys to utilize HKP servers.
84
85     * Upgraded to zlib 1.1.3 and fixed an inflate bug
86
87     * More cleanup on the cleartext signatures.
88
89
90 Noteworthy changes in version 0.9.1
91 -----------------------------------
92
93     * Polish language support.
94
95     * When querying the passphrase, the key ID of the primary key is
96       displayed along with the one of the used secondary key.
97
98     * Fixed a bug occurring when decrypting pgp 5 encrypted messages,
99       fixed an infinite loop bug in the 3DES code and in the code
100       which looks for trusted signatures.
101
102     * Fixed a bug in the mpi library which caused signatures not to
103       compare okay.
104
105     * Rewrote the handling of cleartext signatures; the code is now
106       better maintainable (I hope so).
107
108     * New status output VALIDSIG only for valid signatures together
109       with the fingerprint of the signer's key.
110
111
112 Noteworthy changes in version 0.9.0
113 -----------------------------------
114
115     * --export does now only exports rfc2440 compatible keys; the
116       old behaviour is available with --export-all.
117       Generation of v3 ElGamal (sign and encrypt) keys is not longer
118       supported.
119
120     * Fixed the uncompress bug.
121
122     * Rewrote the rndunix module. There are two environment variables
123       used for debugging now: GNUPG_RNDUNIX_DBG give the file to write
124       debugging information (use "-" for stdout) and if GNUPG_RNDUNIX_DBGALL
125       is set, all programs which are only tried are also printed.
126
127     * New option --escape-from-lines to "dash-escape" "From " lines to
128       prevent mailers to change them to ">From ".  This is not enabled by
129       default because it is not in compliance with rfc2440 - however, you
130       should turn it on.
131
132
133 Noteworthy changes in version 0.4.5
134 -----------------------------------
135
136     * The keyrings and the trustdb is now locked, so that
137       other GnuPG processes won't damage these files.  You
138       may want to put the option --lock-once into your options file.
139
140     * The latest self-signatures are now used; this enables --import
141       to see updated preferences etc.
142
143     * Import of subkeys should now work.
144
145     * Random gathering modules may now be loaded as extensions. Add
146       such a module for most Unices but it is very experimental!
147
148     * Brazilian language support.
149
150
151 Noteworthy changes in version 0.4.4
152 -----------------------------------
153
154     * Fixed the way the key expiration time is stored. If you have
155       an expiration time on your key you should fix it with --edit-key
156       and the command "expire".  I apologize for this inconvenience.
157
158     * Add option --charset to support "koi8-r" encoding of user ids.
159       (Not yet tested).
160
161     * Preferences should now work again. You should run
162       "gpgm --check-trustdb \*" to rebuild all preferences.
163
164     * Checking of certificates should now work but this needs a lot
165       of testing.  Key validation values are now cached in the
166       trustdb; they should be recalculated as needed, but you may
167       use --check-trustdb or --update-trustdb to do this.
168
169     * Spanish translation by Urko Lusa.
170
171     * Patch files are from now on signed.  See the man page
172       for the new option --not-dash-escaped.
173
174     * New syntax: --edit-key <userID> [<commands>]
175       If you run it without --batch the commands are executed and then
176       you are put into normal mode unless you use "quit" or "save" as
177       one of the commands.  When in batch mode, the program quits after
178       the last command, so you have to use "save" if you did some changes.
179       It does not yet work completely, but may be used to list so the
180       keys etc.
181
182
183 Noteworthy changes in version 0.4.3
184 -----------------------------------
185
186     * Fixed the gettext configure bug.
187
188     * Kludge for RSA keys: keyid and length of a RSA key are
189       correctly reported, but you get an error if you try to use
190       this key (If you do not have the non-US version).
191
192     * Experimental support for keyrings stored in a GDBM database.
193       This is *much* faster than a standard keyring.  You will notice
194       that the import gets slower with time; the reason is that all
195       new keys are used to verify signatures of previous inserted
196       keys.  Use "--keyring gnupg-gdbm:<name-of-gdbm-file>".  This is
197       not (yet) supported for secret keys.
198
199     * A Russian language file in the distribution (alternatives are in
200       the contrib directory of the FTP servers)
201
202     * commandline option processing now works as expected for GNU programs
203       with the exception that you can't mix options and normal arguments.
204
205     * Now --list-key lists all matching keys.  This is needed in some
206       other places too.
207
208
209 Noteworthy changes in version 0.4.2
210 -----------------------------------
211
212     * This is only a snapshot: There are still a few bugs.
213
214     * Fixed this huge memory leak.
215
216     * Redesigned the trust database:  You should run "gpgm --check-trustdb".
217       New command --update-trustdb, which adds new key from the public
218       keyring into your trustdb
219
220     * Fixed a bug in the armor code, leading to invalid packet errors.
221       (a workaround for this was to use --no-armor).  The shorten line
222       length (64 instead of 72) fixes a problem with pgp5 and keyservers.
223
224     * comment packets are not anymore generated. "--export" filters
225       them out.  One Exception:  The comment packets in a secret keyring
226       are still used because they carry the factorization of the public
227       prime product.
228
229     * --import now only looks for KEYBLOCK headers, so you can now simply
230       remove the "- " in front of such a header if someone accidently signed
231       such a message or the keyblock is part of a cleartext signed message.
232
233     * --with-colons now lists the key expiration time and not anymore
234       the valid period.
235
236     * Some keyblocks created with old releases have a wrong sequence
237       of packets, so that the keyservers don't accept these keys.
238       Simply using "--edit-key" fixes the problem.
239
240     * New option --force-v3-sigs to generate signed messages which are
241       compatible to PGP 5.
242
243     * Add some code to support DLD (for non ELF systems) - but this is
244       not tested because my BSD box is currently broken.
245
246     * New command "expire" in the edit-key menu.
247
248
249
250 Noteworthy changes in version 0.4.1
251 -----------------------------------
252     * A secondary key is used when the primary key is specified but cannot
253       be used for the operation (if it is a sign-only key).
254
255     * GNUPG can now handle concatenated armored messages:  There is still a
256       bug if different kinds of messages are mixed.
257
258     * Iterated+Salted passphrases now work.  If want to be sure that PGP5
259       is able to handle them you may want to use the options
260         "--s2k-mode 3 --s2k-cipher-algo cast5 --s2k-digest-algo sha1"
261       when changing a passphrase.
262
263     * doc/OpenPGP talks about OpenPGP compliance, doc/HACKING gives
264       a few hints about the internal structure.
265
266     * Checked gnupg against the August 1998 draft (07) and I believe
267       it is in compliance with this document (except for one point).
268
269     * Fixed some bugs in the import merging code and rewrote some
270       code for the trustdb.
271
272
273 Noteworthy changes in version 0.4.0
274 -----------------------------------
275     * Triple DES is now supported.  Michael Roth did this piece of
276       needed work.  We have now all the coded needed to be OpenPGP
277       compliant.
278
279     * Added a simple rpm spec file (see INSTALL).
280
281     * detached and armored signatures are now using "PGP SIGNATURE",
282       except when --rfc1991 is used.
283
284     * All times which are not in the yyy-mm-dd format are now printed
285       in local time.
286
287
288 Noteworthy changes in version 0.3.5
289 -----------------------------------
290     * New option --throw-keyid to create anonymous enciphered messages.
291       If gpg detects such a message it tires all available secret keys
292       in turn so decode it.  This is a gnupg extension and not in OpenPGP
293       but it has been discussed there and afaik some products use this
294       scheme too (Suggested by Nimrod Zimmerman).
295
296     * Fixed a bug with 5 byte length headers.
297
298     * --delete-[secret-]key is now also available in gpgm.
299
300     * cleartext signatures are not anymore converted to LF only.
301
302     * Fixed a trustdb problem.  Run "gpgm --check-trustdb" to fix old
303       trust dbs.
304
305     * Building in another directory should now work.
306
307     * Weak key detection mechanism (Niklas Hernaeus).
308
309
310 Noteworthy changes in version 0.3.4
311 -----------------------------------
312     * New options --comment and --set-filename; see g10/OPTIONS
313
314     * yes/no, y/n localized.
315
316     * Fixed some bugs.
317
318 Noteworthy changes in version 0.3.3
319 -----------------------------------
320     * IMPORTANT: I found yet another bug in the way the secret keys
321       are encrypted - I did it the way pgp 2.x did it, but OpenPGP
322       and pgp 5.x specify another (in some aspects simpler) method.
323       To convert your secret keys you have to do this:
324         1. Build the new release but don't install it and keep
325            a copy of the old program.
326         2. Disable the network, make sure that you are the only
327            user, be sure that there are no Trojan horses etc ....
328         3. Use your old gpg (version 0.3.[12]) and set the
329            passphrases of ALL your secret keys to empty!
330            (gpg --change-passphrase your-user-id).
331         4. Save your ownertrusts (see the next point)
332         5. rm ~/.gnupg/trustdb.gpg
333         6. install the new version of gpg (0.3.3)
334         7. For every secret key call "gpg --edit-key your-user-id",
335            enter "passwd" at the prompt, follow the instructions and
336            change your password back, enter "save" to store it.
337         8. Restore the ownertrust (see next point).
338
339     * The format of the trust database has changed; you must delete
340       the old one, so gnupg can create a new one.
341       IMPORTANT: Use version 0.3.[12] to save your assigned ownertrusts
342       ("gpgm --list-ownertrust >saved-trust"); then build this new version
343       and restore the ownertrust with this new version
344       ("gpgm --import-ownertrust saved-trust").  Please note that
345       --list-ownertrust has been renamed to --export-ownertrust in this
346       release and it does now only export defined ownertrusts.
347
348     * The command --edit-key now provides a commandline driven menu
349       which can be used for various tasks.  --sign-key is only an
350       an alias to --edit-key and maybe removed in future: use the
351       command "sign" of this new menu - you can select which user ids
352       you want to sign.
353
354     * Alternate user ids can now be created an signed.
355
356     * Owner trust values can now be changed with --edit-key (trust)
357
358     * GNUPG can now run as a coprocess; this enables sophisticated
359       frontends.  tools/shmtest.c is a simple sample implementation.
360       This needs some more work: all tty_xxx() are to be replaced
361       by cpr_xxx() and some changes in the display logics is needed.
362
363     * Removed options --gen-prime and --gen-random.
364
365     * Removed option --add-key; use --edit-key instead.
366
367     * Removed option --change-passphrase; use --edit-key instead.
368
369     * Signatures are now checked even if the output file could not
370       be created. Command "--verify" tries to find the detached data.
371
372     * gpg now disables core dumps.
373
374     * compress and symmetric cipher preferences are now used.
375       Because there is no 3DES yet, this is replaced by Blowfish.
376
377     * We have added the Twofish as an experimental cipher algorithm.
378       Many thanks to Matthew Skala for doing this work.
379       Twofish is the AES submission from Schneier et al.; see
380       "www.counterpane.com/twofish.html" for more information.
381
382     * Started with a help system: If you enter a question mark at some
383       prompt; you should get a specific help for this prompt.
384
385     * There is no more backup copy of the secret keyring.
386
387     * A lot of new bugs. I think this release is not as stable as
388       the previous one.
389
390
391 Noteworthy changes in version 0.3.2
392 -----------------------------------
393     * Fixed some bugs when using --textmode (-seat)
394
395     * Now displays the trust status of a positive verified message.
396
397     * Keyrings are now scanned in the sequence they are added with
398       --[secret-]keyring.  Note that the default keyring is implicitly
399       added as the very first one unless --no-default-keyring is used.
400
401     * Fixed setuid and dlopen bug.
402
403 Noteworthy changes in version 0.3.1
404 -----------------------------------
405     * Partial headers are now written in the OpenPGP format if
406       a key in a v4 packet is used.
407
408     * Removed some unused options, removed the gnupg.sig stuff.
409
410     * Key lookup by name now returns a key which can be used for
411       the desired action.
412
413     * New options --list-ownertrust (gpgm) to make a backup copy
414       of the ownertrust values you assigned.
415
416     * clear signature headers are now in compliance with OpenPGP.
417
418 Noteworthy changes in version 0.3.0
419 -----------------------------------
420
421     * New option --emulate-checksum-bug.  If your passphrase does not
422       work anymore, use this option and --change-passphrase to rewrite
423       your passphrase.
424
425     * More complete v4 key support: Preferences and expiration time
426       is set into the self signature.
427
428     * Key generation defaults to DSA/ElGamal keys, so that new keys are
429       interoperable with pgp5
430
431     * DSA key generation is faster and key generation does not anymore
432       remove entropy from the random generator (the primes are public
433       parameters, so there is really no need for a cryptographic secure
434       prime number generator which we had used).
435
436     * A complete new structure for representing the key parameters.
437
438     * Removed most public key knowledge into the cipher library.
439
440     * Support for dynamic loading of new algorithms.
441
442     * Moved tiger to an extension module.
443
444
445 Noteworthy changes in version 0.2.19
446 ------------------------------------
447
448     * Replaced /dev/urandom in checks with new tool mk-tdata.
449
450     * Some assembler file cleanups; some more functions for the Alpha.
451
452     * Tiger has now the OpenPGP assigned number 6.  Because the OID has
453       changed, old signatures using this algorithm can't be verified.
454
455     * gnupg now encrypts the compressed packed and not any longer in the
456       reverse order; anyway it can decrypt both versions. Thanks to Tom
457       for telling me this (not security related) bug.
458
459     * --add-key works and you are now able to generate subkeys.
460
461     * It is now possible to generate ElGamal keys in v4 packets to create
462       valid OpenPGP keys.
463
464     * Some new features for better integration into MUAs.
465
466
467 Noteworthy changes in version 0.2.18
468 ------------------------------------
469
470     * Splitted cipher/random.c, add new option "--disable-dev-random"
471       to configure to support the development of a random source for
472       other systems. Prepared sourcefiles rand-unix.c, rand-w32.c
473       and rand-dummy.c (which is used to allow compilation on systems
474       without a random source).
475
476     * Fixed a small bug in the key generation (it was possible that 48 bits
477       of a key were not taken from the random pool)
478
479     * Add key generation for DSA and v4 signatures.
480
481     * Add a function trap_unaligned(), so that a SIGBUS is issued on
482       Alphas and not the slow emulation code is used. And success: rmd160
483       raised a SIGBUS.
484
485     * Enhanced the formatting facility of argparse and changed the use of
486       \r,\v to @ because gettext does not like it.
487
488     * New option "--compress-algo 1" to allow the creation of compressed
489       messages which are readable by PGP and "--print-md" (gpgm) to make
490       speed measurement easier.
491
492
493 Noteworthy changes in version 0.2.17
494 ------------------------------------
495
496     * Comment packets are now of private type 61.
497
498     * Passphrase code still used a 160 bit blowfish key, added a
499       silly workaround. Please change your passphrase again - sorry.
500
501     * Conventional encryption now uses a type 3 packet to describe the
502       used algorithms.
503
504     * The new algorithm number for Blowfish is 20, 16 is still used for
505       encryption only; for signing it is only used when it is in a v3 packet,
506       so that GNUPG keys are still valid.
507
508
509 Noteworthy changes in version 0.2.16
510 ------------------------------------
511
512     * Add experimental support for the TIGER/192 message digest algorithm.
513       (But there is only a dummy ASN OID).
514
515     * Standard cipher is now Blowfish with 128 bit key in OpenPGP's CFB
516       mode. I renamed the old cipher to Blowfish160. Because the OpenPGP
517       group refused to assign me a number for Blowfish160, I have to
518       drop support for this in the future. You should use
519       "--change-passphrase" to recode your current passphrase with 128
520       bit Blowfish.
521
522
523 Noteworthy changes in version 0.2.15
524 ------------------------------------
525
526     * Fixed a bug with the old checksum calculation for secret keys.
527       If you run the program without --batch, a warning does inform
528       you if your secret key needs to be converted; simply use
529       --change-passphrase to recalculate the checksum. Please do this
530       soon, as the compatible mode will be removed sometime in the future.
531
532     * CAST5 works (using the PGP's special CFB mode).
533
534     * Again somewhat more PGP 5 compatible.
535
536     * Some new test cases
537
538 Noteworthy changes in version 0.2.14
539 ------------------------------------
540
541     * Changed the internal handling of keyrings.
542
543     * Add support to list PGP 5 keyrings with subkeys
544
545     * Timestamps of signatures are now verified.
546
547     * A expiration time can now be specified during key generation.
548
549     * Some speedups for Blowfish and SHA-1, rewrote SHA-1 transform.
550       Reduced the amount of random bytes needed for key generation in
551       some cases.
552
553
554 Noteworthy changes in version 0.2.13
555 ------------------------------------
556
557     * Verify of DSA signatures works.
558
559     * Re-implemented the slower random number generator.
560
561
562 Noteworthy changes in version 0.2.12
563 ------------------------------------
564
565     * --delete-key checks that there is no secret key. The new
566       option --delete-secret-key maybe used to delete a secret key.
567
568     * "-kv" now works as expected. Options "--list-{keys,sigs]"
569       and "--check-sigs" are now working.
570
571     * New options "--verify" and "--decrypt" to better support integration
572       into MUAs (partly done for Mutt).
573
574     * New option "--with-colons" to make parsing of key lists easier.
575
576 Noteworthy changes in version 0.2.11
577 ------------------------------------
578
579     * GPG now asks for a recipient's name if option "-r" is not used.
580
581     * If there is no good trust path, the program asks whether to use
582       the public keys anyway.
583
584     * "--delete-key" works for public keys. What semantics shall I use
585       when there is a secret key too? Delete the secret key or leave him
586       and auto-regenerate the public key, next time the secret key is used?
587
588 Noteworthy changes in version 0.2.10
589 ------------------------------------
590
591     * Code for the alpha is much faster (about 20 times); the data
592       was misaligned and the kernel traps this, so nearly all time
593       was used by system to trap the misalignments and to write
594       syslog messages. Shame on me and thanks to Ralph for
595       pointing me at this while drinking some beer yesterday.
596
597     * Changed some configure options and add an option
598       --disable-m-guard to remove the memory checking code
599       and to compile everything with optimization on.
600
601     * New environment variable GNUPGHOME, which can be used to set
602       another homedir than ~/.gnupg.  Changed default homedir for
603       Windoze version to c:/gnupg.
604
605     * Fixed detached signatures; detached PGP signatures caused a SEGV.
606
607     * The Windoze version works (as usual w/o a strong RNG).
608
609
610 Noteworthy changes in version 0.2.9
611 -----------------------------------
612
613     * Fixed FreeBSD bug.
614
615     * Added a simple man page.
616
617     * Switched to automake1.2f and a newer gettext.
618
619 Noteworthy changes in version 0.2.8
620 -----------------------------------
621
622     * Changed the name to GNUPG, the binaries are called gpg and gpgm.
623       You must rename rename the directory "~/.g10" to ~/.gnupg/, rename
624       {pub,sec}ring.g10 to {pub,sec}ring.gpg, trustdb.g10 to trustdb.gpg
625       and g10.sig to gnupg.sig.
626
627     * New or changed passphrases are now salted.
628
629
630 Noteworthy changes in version 0.2.7
631 -----------------------------------
632
633     * New command "gen-revoke" to create a key revocation certificate.
634
635     * New option "homedir" to set the homedir (which defaults to "~/.g10").
636       This directory is created if it does not exists (only the last
637       part of the name and not the complete hierarchy)
638
639     * Command "import" works. (Try: "finger gcrypt@ftp.guug.de|g10 --import")
640
641     * New commands "dearmor/enarmor" for g10maint.  These are mainly
642       used for internal test purposes.
643
644     * Option --version now conforming to the GNU standards and lists
645       the available ciphers, message digests and public key algorithms.
646
647     * Assembler code for m68k (not tested).
648
649     * "make check" works.
650
651 Noteworthy changes in version 0.2.6
652 -----------------------------------
653
654     * Option "--export" works.
655
656
657 Noteworthy changes in version 0.2.5
658 -----------------------------------
659
660     * Added zlib for systems which don't have it.
661       Use "./configure --with-zlib" to link with the static version.
662
663     * Generalized some more functions and rewrote the encoding of
664       message digests into MPIs.
665
666     * Enhanced the checkit script
667
668
669 Noteworthy changes in version 0.2.4
670 -----------------------------------
671
672     * nearly doubled the speed of the ElGamal signature verification.
673
674     * backup copies of keyrings are created.
675
676     * assembler stuff for Pentium; gives about 15% better performance.
677
678     * fixed a lot of bugs.
679
680
681 Noteworthy changes in version 0.2.3
682 -----------------------------------
683
684     * Found a bug in the calculation of ELG fingerprints. This is now
685       fixed, but all existing fingerprints and keyids for ELG keys
686       are not any more valid.
687
688     * armor should now work; including clear signed text.
689
690     * moved some options to the new program g10maint
691
692     * It's now 64 bit clean and runs fine on an alpha--linux.
693
694     * Key generation is much faster now.  I fixed this by using not
695       so strong random number for the primes (this was a bug because the
696       ElGamal primes are public parameters and it does not make sense
697       to generate them from strong random).  The real secret is the x value
698       which is still generated from strong (okay: /dev/random) random bits.
699
700     * added option "--status-fd": see g10/OPTIONS
701
702     * We have secure memory on systems which support mlock().
703       It is not complete yet, because we do not have signal handler
704       which does a cleanup in very case.
705       We should also check the ulimit for the user in the case
706       that the admin does not have set a limit on locked pages.
707
708     * started with internationalization support.
709
710     * The logic to handle the web of trust is now implemented. It is
711       has some bugs; but I'm going to change the algorithm anyway.
712       It works by calculating the trustlevel on the fly.  It may ask
713       you to provide trust parameters if the calculated trust probability
714       is too low.  I will write a paper which discusses this new approach.
715
716     * a couple of changes to the configure script.
717
718     * New option "--quick-random" which uses a much quicker random
719       number generator.  Keys generated while this option is in effect
720       are flags with "INSECURE!" in the user-id.  This is a development
721       only option.
722
723     * Read support for new version packets (OpenPGP).
724
725     * Comment packets are now of correct OpenPGP type 16. Old comment
726       packets written by G10 are detected because they always start with
727       a hash which is an invalid version byte.
728
729     * The string "(INSECURE!)" is appended to a new user-id if this
730       is generated on a system without a good random number generator.
731