Implemented an Enforced FIPS mode.
[libgcrypt.git] / NEWS
1 Noteworthy changes in version 1.4.3
2 ------------------------------------------------
3
4  * Try to auto-initialize Libgcrypt to minimize the effect of
5    applications not doing that correctly.  This is not a perfect
6    solution but given that many applicationion would totally fail
7    without such a hack, we try to help at least with the most common
8    cases.  Folks, please read the manual to learn how to properly
9    initialize Libgcrypt!
10
11  * Log fatal errors via syslog.
12
13  * Auto-initialize the secure memory to 32k instead of aborting the
14    process.
15
16  * Changed the name and the semantics of the fips mode config file.
17
18  * More self-tests.
19
20  * Documentation cleanups.
21
22
23 Noteworthy changes in version 1.4.2 (2008-09-08)
24 ------------------------------------------------
25
26  * The long missing gcry_mpi_lshift function has been added.
27
28  * RSA key generation now supports a "transient-key" flag.
29
30  * The keygrip computation for ECDSA has been implemented thus ECDSA
31    is now fully supported.
32
33  * A few macros have been replaced by functions for better type
34    checking.
35
36  * The thread initialization structure now carries version
37    information.
38
39  * The manual describes more clearly how to initialize Libgcrypt.
40
41  * The library may now be switched into a FIPS mode.
42
43  * Interface changes relative to the 1.3.0 release:
44  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
45  GCRYCTL_OPERATIONAL_P   NEW.
46  GCRYCTL_FIPS_MODE_P     NEW.
47  GCRYCTL_FORCE_FIPS_MODE NEW.
48  gcry_cipher_setkey      NEW: Replaces macro.
49  gcry_cipher_setiv       NEW: Replaces macro.
50  gcry_cipher_setctr      NEW: Replaces macro.
51  gcry_mpi_lshift         NEW.
52  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
53
54
55 Noteworthy changes in version 1.4.1 (2008-04-25)
56 ------------------------------------------------
57
58  * Fixed a bug introduced by 1.3.1 which led to the comsumption of far
59    too much entropy for the intial seeding.
60
61  * Improved AES performance for CFB and CBC modes.
62
63  * Removed build problems for the Padlock support.
64
65
66 Noteworthy changes in version 1.4.0 (2007-12-10)
67 ------------------------------------------------
68
69  * New configure option --disable-padlock-support which is mostly
70    useful in case of build problems.
71
72
73 Noteworthy changes in version 1.3.2 (2007-12-03)
74 ------------------------------------------------
75
76  * The visibility attribute is now used if supported by the toolchain.
77
78  * The ACE engine of VIA processors is now used for AES-128.
79
80  * The ASN.1 DER template for SHA-224 has been fixed.
81
82
83 Noteworthy changes in version 1.3.1 (2007-10-26)
84 ------------------------------------------------
85
86  * The entire library is now under the LGPL. The helper programs and
87    the manual are under the GPL.  Kudos to Peter Gutmann for giving
88    permissions to relicense the rndw32 and rndunix modules.
89
90  * The Camellia cipher is now under the LGPL and included by default.
91
92  * Fixed a bug in the detection of symbol prefixes which inhibited the
93    build of optimzied assembler code on certain systems.
94
95  * Updated the entropy gatherer for W32.
96
97
98 Noteworthy changes in version 1.3.0 (2007-05-04)
99 ------------------------------------------------
100
101  * Changed the way the RNG gets initialized. This allows to keep it
102    uninitialized as long as no random numbers are used.  To override
103    this, the new macro gcry_fast_random_poll may be used.  It is in
104    general a good idea to spread this macro into the application code
105    to make sure that these polls happen often enough.
106
107  * Made the RNG immune against fork without exec.
108
109  * Reading and writing the random seed file is now protected by a
110    fcntl style file lock on systems that provide this function.
111
112  * Support for SHA-224 and HMAC using SHA-384 and SHA-512.
113
114  * Support for the SEED cipher.
115
116  * Support for the Camellia cipher.  Note that Camellia is disabled by
117    default, and that enabling it changes the license of libgcrypt from
118    LGPL to GPL.
119
120  * Support for OFB encryption mode.
121
122  * gcry_mpi_rshift does not anymore truncate the shift count.
123
124  * Reserved algorithm ranges for use by applications.
125
126  * Support for DSA2.
127
128  * The new function gcry_md_debug should be used instead of the
129    gcry_md_start_debug and gcry_md_stop_debug macros.
130
131  * New configure option --enable-random-daemon to support a system
132    wide random daemon.  The daemon code is experimental and not yet
133    very well working.  It will eventually allow to keep a global
134    random pool for the sake of short living processes.
135
136  * Non executable stack support is now used by default on systems
137    supporting it.
138
139  * Support for Microsoft Windows.
140
141  * Assembler support for the AMD64 architecture.
142
143  * New configure option --enable-mpi-path for optimized builds.
144
145  * Experimental support for ECDSA; should only be used for testing.
146
147  * New control code GCRYCTL_PRINT_CONFIG to print the build
148    configuration.
149
150  * Minor changes to some function declarations.  Buffer arguments are
151    now typed as void pointer.  This should not affect any compilation.
152    Fixed two bugs in return values and clarified documentation.
153
154  * Interface changes relative to the 1.2.0 release:
155  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
156  gcry_fast_random_poll   NEW
157  gcry_md_debug           NEW
158  gcry_sexp_nth_string    NEW
159  GCRY_MD_SHA224          NEW
160  GCRY_PK_USAGE_CERT      NEW
161  GCRY_PK_USAGE_AUTH      NEW
162  GCRY_PK_USAGE_UNKN      NEW
163  GCRY_PK_ECDSA           NEW
164  GCRY_CIPHER_SEED        NEW
165  GCRY_CIPHER_CAMELLIA128 NEW
166  GCRY_CIPHER_CAMELLIA192 NEW
167  GCRY_CIPHER_CAMELLIA256 NEW
168  GCRYCTL_FAKED_RANDOM_P  NEW 
169  GCRYCTL_PRINT_CONFIG    NEW
170  GCRYCTL_SET_RNDEGD_SOCKET  NEW.
171  gcry_mpi_scan           CHANGED: Argument BUFFER is now void*.
172  gcry_pk_algo_name       CHANGED: Returns "?" instead of NULL.
173  gcry_cipher_algo_name   CHANGED: Returns "?" instead of "".
174  gcry_pk_spec_t          CHANGED: Element ALIASES is now const ptr.
175  gcry_md_write_t         CHANGED: Argument BUF is now a const void*.
176  gcry_md_ctl             CHANGED: Argument BUFFER is now void*.
177  gcry_cipher_encrypt     CHANGED: Arguments IN and OUT are now void*.
178  gcry_cipher_decrypt     CHANGED: Arguments IN and OUT are now void*.
179  gcry_sexp_sprint        CHANGED: Argument BUFFER is now void*.
180  gcry_create_nonce       CHANGED: Argument BUFFER is now void*.
181  gcry_randomize          CHANGED: Argument BUFFER is now void*.
182  gcry_cipher_register    CHANGED: Argument ALGORITHM_ID is now int*.
183  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
184
185
186 Noteworthy changes in version 1.2.0 (2004-04-15)
187 ------------------------------------------------
188
189  * First stable release.
190
191
192 Noteworthy changes in version 1.1.94 (2004-03-29)
193 -------------------------------------------------
194
195  * The support for multi-threaded users goes into its third
196    incarnation.  We removed compile time support for thread libraries.
197    To support the thread library of your choice, you have to set up
198    callback handlers at initialization time.  New data structures, a
199    new control command, and default initializers are provided for this
200    purpose.
201
202  * Interface changes relative to the 1.1.93 release:
203 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
204 libgcrypt-config --thread       OBSOLETE
205 libgcrypt-pth.la                REMOVED
206 libgcrypt-pthread.la            REMOVED
207 GCRYCTL_SET_THREAD_CBS          NEW
208 struct gcrypt_thread_cbs        NEW
209 enum gcry_thread_option         NEW
210 GCRY_THREAD_OPTION_PTH_IMPL     NEW
211 GCRY_THREAD_OPTION_PTHREAD_IMPL NEW
212 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
213
214 Noteworthy changes in version 1.1.93 (2004-03-06)
215 -------------------------------------------------
216
217  * The automatic thread library detection has finally been removed.
218    From now on, only linking explicitely to libgcrypt, libgcrypt-pth
219    or libgcrypt-pthread is supported.
220
221 Noteworthy changes in version 1.1.92 (2004-02-20)
222 -------------------------------------------------
223
224  * Minor bug fixes.
225
226  * Included a limited implementation of RFC2268.
227
228  * Changed API of the gcry_ac_ functions.  Only a very few programs
229    should be affected by this.
230
231  * Interface changes relative to the 1.1.91 release:
232 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
233 GCRY_CIPHER_RFC2268_40          NEW.
234 gcry_ac_data_set                CHANGED: New argument FLAGS.
235 gcry_ac_data_get_name           CHANGED: New argument FLAGS.
236 gcry_ac_data_get_index          CHANGED: New argument FLAGS.
237 gcry_ac_key_pair_generate       CHANGED: New and reordered arguments.
238 gcry_ac_key_test                CHANGED: New argument HANDLE.
239 gcry_ac_key_get_nbits           CHANGED: New argument HANDLE.
240 gcry_ac_key_get_grip            CHANGED: New argument HANDLE.
241 gcry_ac_data_search             REMOVED.
242 gcry_ac_data_add                REMOVED.
243 GCRY_AC_DATA_FLAG_NO_BLINDING   REMOVED.
244 GCRY_AC_FLAG_NO_BLINDING        NEW: Replaces above.
245
246
247 Noteworthy changes in version 1.1.91 (2003-12-19)
248 -------------------------------------------------
249
250  * Code cleanups and minor bug fixes.
251
252
253 Noteworthy changes in version 1.1.90 (2003-11-14)
254 -------------------------------------------------
255
256  * The use of the GCRY_WEAK_RANDOM level is now deprecated in favor of
257    the new gcry_create_nonce function.
258
259  * gcry_sexp_build now supports a "%b" format to include a memory buffer.
260
261  * Minor configuration fixes.
262  
263  * Interface changes relative to the 1.1.44 release:
264 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
265 gcry_create_nonce               NEW
266 gcry_sexp_build                 ENHANCED
267
268
269 Noteworthy changes in version 1.1.44 (2003-10-31)
270 -------------------------------------------------
271
272  * Bug fixes and more code cleanups.
273
274  * Enhanced the prime API.
275
276  * Interface changes relative to the 1.1.43 release:
277 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
278 gcry_prime_group_generator      NEW
279 gcry_prime_release_factors      NEW
280
281
282 Noteworthy changes in version 1.1.43 (2003-09-04)
283 -------------------------------------------------
284
285  * Bug fixes and internal code cleanups.
286
287  * Support for the Serpent cipher algorithm.
288
289  * Interface changes relative to the 1.1.42 release:
290 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
291 gcry_prime_generate             NEW
292 gcry_prime_check                NEW
293
294
295 Noteworthy changes in version 1.1.42 (2003-07-31)
296 -------------------------------------------------
297
298  * Major API cleanup.  Applications need to be converted to the new
299    API.  See README.apichanges for hints on how to do that.  Backward
300    compatibility is provided where it was possible without too much
301    effort and did not collide with the overall sanitization effort.
302    However, this is only for ease of transition.  NO DEPRECATED
303    FUNCTION OR DATA TYPE IS CONSIDERED A PART OF THE API OR ABI AND
304    WILL BE DROPPED IN THE FUTURE WITHOUT CHANGING THE SONAME OF THE
305    LIBRARY. 
306
307  * If gcrypt.h is included in sources compiled by GCC 3.1 or later,
308    deprecated attributes will warn about use of obsolete functions and
309    type definitions.  You can suppress these warnings by passing
310    -Wno-deprecated-declarations to the gcc command.
311
312  * gcry_check_version must be called from now on to initialize the
313    library, it is not longer optional.
314
315  * Removed `libgcrypt errno' concept.
316
317  * Libgcrypt depends on libgpg-error, a library that provides error
318    codes and according functions for all GnuPG components.  Functions
319    that used to return error codes asa `int' have been changed to
320    return a code of type `gcry_error_t'.  All GCRYERR_* error symbols
321    have been removed, since they are now contained in libgpg-error
322    (GPG_ERR_*). All functions and types in libgpg-error have also been
323    wrapped in Libgcrypt. The new types are gcry_err_code_t and
324    gcry_err_source_t.  The new functions are gcry_err_code,
325    gcry_err_source, gcry_error, gcry_err_make, gcry_error_from_errno,
326    gcry_err_make_from_errno, gcry_err_code_from_errno,
327    gcry_err_code_to_errno, gcry_strsource.
328
329  * New function gcry_mpi_dump to help in debugging. 
330
331  * Added alternative interface for asymmetric cryptography.
332
333  * CRC-32, CRC-32 a'la RFC 1510, CRC-24 a'la RFC 2440 are now
334    supported.
335
336  * SHA-256, SHA-384 and SHA-512 are now supported.
337
338  * 128 bit Twofish is now supported.
339
340  * The random module won't print the "not enough random bytes
341    available" anymore.  A new progress status is issued instead.
342
343  * CBC-MAC for block ciphers is now supported, by using a
344    GCRY_CIPHER_CBC_MAC cipher flag.
345
346  * CTR mode for block ciphers is now supported.
347
348  * The public RSA exponent can now be specified in key generation. 
349
350  * RSA blinding is now supported and is used automatically for RSA
351    decryption.  It can be explicitely disabled by using the
352    `no-blinding' symbol in the `flags' S-Expression or by using the
353    GCRY_AC_FLAG_DATA_NO_BLINDING flag when using the ac interface.
354
355  * gcry_sexp_canon_len does not use a `historically encoded' error
356    code anymore.
357
358
359  * Interface changes relative to the 1.1.12 release:
360 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
361 GCRY_MPI                        DEPRECATED; Use: gcry_mpi_t
362 GcryMPI                         DEPRECATED; Use: gcry_mpi_t
363 GCRY_SEXP                       DEPRECATED; Use: gcry_sexp_t
364 GcrySexp                        DEPRECATED; Use: gcry_sexp_t
365 GCRY_CIPHER_HD                  DEPRECATED; Use: gcry_cipher_hd_t
366 GcryCipherHd                    DEPRECATED; Use: gcry_cipher_hd_t
367 GCRY_MD_HD                      DEPRECATED; Use: gcry_md_hd_t
368 GcryMDHd                        DEPRECATED; Use: gcry_md_hd_t
369 gcry_error_t                    NEW
370 gcry_err_code_t                 NEW
371 gcry_err_source_t               NEW
372 gcry_err_make                   NEW
373 gcry_error                      NEW
374 gcry_err_code                   NEW
375 gcry_err_source                 NEW
376 gcry_err_code_from_errno        NEW
377 gcry_err_code_to_errno          NEW
378 gcry_err_make_from_errno        NEW
379 gcry_error_from_errno           NEW
380 gcry_strsource                  NEW
381 GCRYERR_{some error code}       REMOVED; Use GPG_ERR_*
382                                          from libgpg-error instead.
383 gcry_errno                      REMOVED
384 gcry_sexp_canon_len             CHANGED
385 gcry_sexp_build_array           NEW
386 gcry_mpi_scan                   CHANGED: New argument to separate in/out args.
387 gcry_mpi_print                  CHANGED: Ditto.
388 gcry_mpi_dump                   NEW
389 gcry_cipher_open                CHANGED
390 gcry_cipher_reset               NEW
391 gcry_cipher_register            NEW
392 gcry_cipher_unregister          NEW
393 gcry_cipher_list                NEW
394 gcry_cipher_algo_keylen         REPLACED macro with function.
395 gcry_cipher_algo_blklen         REPLACED macro with function.
396 gcry_pk_register                NEW
397 gcry_pk_unregister              NEW
398 gcry_pk_list                    NEW
399 gcry_pk_decrypt                 ENHANCED: Allows flag to return
400                                           complete S-expression.
401 gcry_md_open                    CHANGED
402 gcry_md_copy                    CHANGED
403 gcry_md_is_enabled              NEW
404 gcry_md_is_secure               NEW
405 gcry_md_register                NEW
406 gcry_md_unregister              NEW
407 gcry_md_list                    NEW
408 gcry_ac_data_t                  NEW
409 gcry_ac_key_t                   NEW
410 gcry_ac_key_pair_t              NEW
411 gcry_ac_handle_t                NEW
412 gcry_ac_key_spec_rsa_t          NEW
413 gcry_ac_data_new                NEW
414 gcry_ac_data_destroy            NEW
415 gcry_ac_data_set                NEW
416 gcry_ac_data_copy               NEW
417 gcry_ac_data_length             NEW
418 gcry_ac_data_get_name           NEW
419 gcry_ac_data_get_index          NEW
420 gcry_ac_data_clear              NEW
421 gcry_ac_open                    NEW
422 gcry_ac_close                   NEW
423 gcry_ac_key_init                NEW
424 gcry_ac_key_pair_generate       NEW
425 gcry_ac_key_pair_extract        NEW
426 gcry_ac_key_data_get            NEW
427 gcry_ac_key_test                NEW
428 gcry_ac_key_get_nbits           NEW
429 gcry_ac_key_get_grip            NEW
430 gcry_ac_key_destroy             NEW
431 gcry_ac_key_pair_destroy        NEW
432 gcry_ac_data_encrypt            NEW
433 gcry_ac_data_decrypt            NEW
434 gcry_ac_data_sign               NEW
435 gcry_ac_data_verify             NEW
436 gcry_ac_id_to_name              NEW
437 gcry_ac_name_to_id              NEW
438 gcry_handler_progress_t         NEW
439 gcry_handler_alloc_t            NEW
440 gcry_handler_secure_check_t     NEW
441 gcry_handle_realloc_t           NEW
442 gcry_handler_free_t             NEW
443 gcry_handler_no_mem_t           NEW
444 gcry_handler_error_t            NEW
445 gcry_handler_log_t              NEW
446 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
447
448 Noteworthy changes in version 1.1.12 (2003-01-20)
449 -------------------------------------------------
450
451  * gcry_pk_sign, gcry_pk_verify and gcry_pk_encrypt can now handle an
452    optional pkcs1 flags parameter in the S-expression.  A similar flag
453    may be passed to gcry_pk_decrypt but it is only syntactically
454    implemented.
455
456  * New convenience macro gcry_md_get_asnoid.
457
458  * There is now some real stuff in the manual.
459
460
461 Noteworthy changes in version 1.1.11 (2002-12-21)
462 -------------------------------------------------
463
464  * Don't export internal symbols anymore (currently only for GNU systems)
465
466  * New algorithm: MD4
467
468  * Implemented ciphertext stealing.
469
470  * Smaller bugs fixes and a few new OIDs.
471
472  * Interface changes relative to the 1.1.8 release:
473 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
474 gcry_cipher_cts                   NEW
475 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
476
477
478 Noteworthy changes in version 1.1.10 (2002-09-20)
479 -------------------------------------------------
480
481  * Fixed shared library builds for i386, PPC and Sparc.
482
483  * Added simple benchmark tool.
484
485  * Replaced the internal mutexes by code which automatically adapts to
486    the used threading library.  Currently Pth and Pthread are
487    supported.  For non-ELF systems the GNU toolchain is now required..
488
489  * Added untested support to build Windows DLLs.
490
491 Noteworthy changes in version 1.1.9 (2002-08-23)
492 ------------------------------------------------
493
494  * Support for plain old DES.
495
496
497 Noteworthy changes in version 1.1.8 (2002-06-25)
498 ------------------------------------------------
499
500  * Minor cleanups and exported a few new functions.
501
502  * Interface changes relative to the 1.1.7 release:
503 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
504 gcry_mpi_div                      NEW
505 gcry_mpi_mod                      NEW
506 gcry_mpi_invm                     NEW
507 gcry_mpi_swap                     NEW
508 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
509
510 Noteworthy changes in version 1.1.7 (2002-05-21)
511 ------------------------------------------------
512
513 * Libgcrypt is now distributed under the terms of the GNU Lesser
514   General Public License; see the README file for details.    
515   
516 * It is possible to use libgcrypt w/o intialized secure memory.
517
518 * Libgcrypt should now be thread safe after the initialization.
519   gcry_control (GCRYCRL_INITIALIZATION_FINISHED,NULL,0) should have
520   been called before creating additional threads.
521
522  * Interface changes relative to the 1.1.6 release:
523 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
524 GCRYCTL_DISABLE_INTERNAL_LOCKING  NEW
525 GCRYCTL_DISABLE_SECMEM            NEW
526 GCRYCTL_INITIALIZATION_FINISHED   NEW
527 GCRYCTL_INITIALIZATION_FINISHED_P NEW
528 GCRYCTL_ANY_INITIALIZATION_P      NEW
529 gcry_strdup                       NEW
530 gcry_sexp_create                  NEW
531 gcry_sexp_new                     NEW
532 gcry_set_progress_handler         NEW
533 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
534
535 Noteworthy changes in version 1.1.6 (2002-02-07)
536 ------------------------------------------------
537
538   * Enhanced the S-expression conversion functions.
539         
540 Noteworthy changes in version 1.1.5 (2001-12-18)
541 ------------------------------------------------
542
543   * gcry_{cipher,md}_map_name are now able to map stringified object IDs.
544
545   * New functions gcry_sexp_canon_len and gcry_cipher_mode_from_oid.
546
547   * Closed some memory leaks.
548
549
550 Noteworthy changes in version 1.1.4 (2001-08-03)
551 ------------------------------------------------
552
553   * Arcfour does now work.                   
554
555   * Some minor fixes.
556
557   * Added a first test program
558
559   * Migrated to autoconf 2.52.
560
561
562 Noteworthy changes in version 1.1.3 (2001-05-31)
563 ------------------------------------------------
564
565   * First release of Libgcrypt which is a result of splitting GnuPG
566     into into libgcrypt and GnuPG.
567
568
569 Copyright 2001, 2002, 2003, 2004, 2007, 2008 Free Software Foundation, Inc.
570
571 This file is free software; as a special exception the author gives
572 unlimited permission to copy and/or distribute it, with or without
573 modifications, as long as this notice is preserved.
574
575 This file is distributed in the hope that it will be useful, but
576 WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
577 implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.