1 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
4 * This package is an SSL implementation written
5 * by Eric Young (eay@cryptsoft.com).
6 * The implementation was written so as to conform with Netscapes SSL.
8 * This library is free for commercial and non-commercial use as long as
9 * the following conditions are aheared to. The following conditions
10 * apply to all code found in this distribution, be it the RC4, RSA,
11 * lhash, DES, etc., code; not just the SSL code. The SSL documentation
12 * included with this distribution is covered by the same copyright terms
13 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
15 * Copyright remains Eric Young's, and as such any Copyright notices in
16 * the code are not to be removed.
17 * If this package is used in a product, Eric Young should be given attribution
18 * as the author of the parts of the library used.
19 * This can be in the form of a textual message at program startup or
20 * in documentation (online or textual) provided with the package.
22 * Redistribution and use in source and binary forms, with or without
23 * modification, are permitted provided that the following conditions
25 * 1. Redistributions of source code must retain the copyright
26 * notice, this list of conditions and the following disclaimer.
27 * 2. Redistributions in binary form must reproduce the above copyright
28 * notice, this list of conditions and the following disclaimer in the
29 * documentation and/or other materials provided with the distribution.
30 * 3. All advertising materials mentioning features or use of this software
31 * must display the following acknowledgement:
32 * "This product includes cryptographic software written by
33 * Eric Young (eay@cryptsoft.com)"
34 * The word 'cryptographic' can be left out if the rouines from the library
35 * being used are not cryptographic related :-).
36 * 4. If you include any Windows specific code (or a derivative thereof) from
37 * the apps directory (application code) you must include an acknowledgement:
38 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
40 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
41 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
44 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
48 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
49 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
52 * The licence and distribution terms for any publically available version or
53 * derivative of this code cannot be changed. i.e. this code cannot simply be
54 * copied and put under another distribution licence
55 * [including the GNU Public Licence.]
57 /* ====================================================================
58 * Copyright (c) 1998-2006 The OpenSSL Project. All rights reserved.
60 * Redistribution and use in source and binary forms, with or without
61 * modification, are permitted provided that the following conditions
64 * 1. Redistributions of source code must retain the above copyright
65 * notice, this list of conditions and the following disclaimer.
67 * 2. Redistributions in binary form must reproduce the above copyright
68 * notice, this list of conditions and the following disclaimer in
69 * the documentation and/or other materials provided with the
72 * 3. All advertising materials mentioning features or use of this
73 * software must display the following acknowledgment:
74 * "This product includes software developed by the OpenSSL Project
75 * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
77 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
78 * endorse or promote products derived from this software without
79 * prior written permission. For written permission, please contact
80 * openssl-core@openssl.org.
82 * 5. Products derived from this software may not be called "OpenSSL"
83 * nor may "OpenSSL" appear in their names without prior written
84 * permission of the OpenSSL Project.
86 * 6. Redistributions of any form whatsoever must retain the following
88 * "This product includes software developed by the OpenSSL Project
89 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
91 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
92 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
93 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
94 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
95 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
96 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
97 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
98 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
99 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
100 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
101 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
102 * OF THE POSSIBILITY OF SUCH DAMAGE.
103 * ====================================================================
105 * This product includes cryptographic software written by Eric Young
106 * (eay@cryptsoft.com). This product includes software written by Tim
107 * Hudson (tjh@cryptsoft.com).
114 #include <openssl/bio.h>
115 #include <openssl/crypto.h>
116 #include <openssl/rand.h>
117 #include <openssl/lhash.h>
118 #include <openssl/conf.h>
119 #include <openssl/x509.h>
120 #include <openssl/pem.h>
121 #include <openssl/ssl.h>
122 #ifndef OPENSSL_NO_ENGINE
123 # include <openssl/engine.h>
125 #include <openssl/err.h>
127 # include <openssl/fips.h>
129 #define USE_SOCKETS /* needed for the _O_BINARY defs in the MS world */
131 /* Needed to get the other O_xxx flags. */
132 #ifdef OPENSSL_SYS_VMS
135 #define INCLUDE_FUNCTION_TABLE
139 #ifdef OPENSSL_NO_CAMELLIA
140 # define FORMAT "%-15s"
143 # define FORMAT "%-18s"
147 /* Special sentinel to exit the program. */
148 #define EXIT_THE_PROGRAM (-1)
151 * The LHASH callbacks ("hash" & "cmp") have been replaced by functions with
152 * the base prototypes (we cast each variable inside the function to the
153 * required type of "FUNCTION*"). This removes the necessity for
154 * macro-generated wrapper functions.
156 static LHASH_OF(FUNCTION) *prog_init(void);
157 static int do_cmd(LHASH_OF(FUNCTION) *prog, int argc, char *argv[]);
158 static void list_pkey(void);
159 static void list_type(FUNC_TYPE ft);
160 static void list_disabled(void);
161 char *default_config_file = NULL;
163 static CONF *config = NULL;
168 static int apps_startup()
171 signal(SIGPIPE, SIG_IGN);
174 /* Set non-default library initialisation settings */
175 if (!OPENSSL_init_crypto(OPENSSL_INIT_ENGINE_ALL_BUILTIN
176 | OPENSSL_INIT_LOAD_CONFIG, NULL))
184 static void apps_shutdown()
189 static char *make_config_name()
195 if ((t = getenv("OPENSSL_CONF")) != NULL)
196 return OPENSSL_strdup(t);
198 t = X509_get_default_cert_area();
199 len = strlen(t) + 1 + strlen(OPENSSL_CONF) + 1;
200 p = app_malloc(len, "config filename buffer");
202 #ifndef OPENSSL_SYS_VMS
205 strcat(p, OPENSSL_CONF);
210 static void lock_dbg_cb(int mode, int type, const char *file, int line)
212 static int modes[CRYPTO_NUM_LOCKS];
213 const char *errstr = NULL;
214 int rw = mode & (CRYPTO_READ | CRYPTO_WRITE);
216 if (rw != CRYPTO_READ && rw != CRYPTO_WRITE) {
217 errstr = "invalid mode";
221 if (type < 0 || type >= CRYPTO_NUM_LOCKS) {
222 errstr = "type out of bounds";
226 if (mode & CRYPTO_LOCK) {
228 errstr = "already locked";
229 /* must not happen in a single-threaded program --> deadlock! */
233 } else if (mode & CRYPTO_UNLOCK) {
235 errstr = "not locked";
239 if (modes[type] != rw) {
240 errstr = (rw == CRYPTO_READ) ?
241 "CRYPTO_r_unlock on write lock" :
242 "CRYPTO_w_unlock on read lock";
247 errstr = "invalid mode";
254 "openssl (lock_dbg_cb): %s (mode=%d, type=%d) at %s:%d\n",
255 errstr, mode, type, file, line);
259 #if defined( OPENSSL_SYS_VMS)
260 extern char **copy_argv(int *argc, char **argv);
263 int main(int argc, char *argv[])
266 LHASH_OF(FUNCTION) *prog = NULL;
267 char **copied_argv = NULL;
272 int first, n, i, ret = 0;
277 /* Set up some of the environment. */
278 default_config_file = make_config_name();
279 bio_in = dup_bio_in(FORMAT_TEXT);
280 bio_out = dup_bio_out(FORMAT_TEXT);
281 bio_err = BIO_new_fp(stderr, BIO_NOCLOSE | BIO_FP_TEXT);
283 #if defined( OPENSSL_SYS_VMS)
284 copied_argv = argv = copy_argv(&argc, argv);
287 p = getenv("OPENSSL_DEBUG_MEMORY");
288 if (p != NULL && strcmp(p, "on") == 0)
289 CRYPTO_set_mem_debug(1);
290 CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ON);
291 CRYPTO_set_locking_callback(lock_dbg_cb);
293 if (getenv("OPENSSL_FIPS")) {
295 if (!FIPS_mode_set(1)) {
296 ERR_print_errors(bio_err);
300 BIO_printf(bio_err, "FIPS mode not supported.\n");
309 pname = opt_progname(argv[0]);
311 /* first check the program name */
313 fp = lh_FUNCTION_retrieve(prog, &f);
316 ret = fp->func(argc, argv);
320 /* If there is stuff on the command line, run with that. */
324 ret = do_cmd(prog, argc, argv);
330 /* ok, lets enter interactive mode */
333 /* Read a line, continue reading if line ends with \ */
334 for (p = buf, n = sizeof buf, i = 0, first = 1; n > 0; first = 0) {
335 prompt = first ? "OpenSSL> " : "> ";
338 fputs(prompt, stdout);
340 if (!fgets(p, n, stdin))
347 if (p[i - 2] != '\\')
354 extern char *readline(const char *);
355 extern void add_history(const char *cp);
358 char *text = readline(prompt);
364 if (text[i - 1] != '\\') {
365 p += strlen(strcpy(p, text));
372 p += strlen(strcpy(p, text));
379 if (!chopup_args(&arg, buf)) {
380 BIO_printf(bio_err, "Can't parse (no memory?)\n");
384 ret = do_cmd(prog, arg.argc, arg.argv);
385 if (ret == EXIT_THE_PROGRAM) {
390 BIO_printf(bio_err, "error in %s\n", arg.argv[0]);
391 (void)BIO_flush(bio_out);
392 (void)BIO_flush(bio_err);
396 OPENSSL_free(copied_argv);
397 OPENSSL_free(default_config_file);
400 lh_FUNCTION_free(prog);
401 OPENSSL_free(arg.argv);
404 BIO_free_all(bio_out);
406 #ifndef OPENSSL_NO_CRYPTO_MDEBUG
407 if (CRYPTO_mem_leaks(bio_err) <= 0)
414 OPTIONS exit_options[] = {
418 static void list_cipher_fn(const EVP_CIPHER *c,
419 const char *from, const char *to, void *arg)
422 BIO_printf(arg, "%s\n", EVP_CIPHER_name(c));
425 from = "<undefined>";
428 BIO_printf(arg, "%s => %s\n", from, to);
432 static void list_md_fn(const EVP_MD *m,
433 const char *from, const char *to, void *arg)
436 BIO_printf(arg, "%s\n", EVP_MD_name(m));
439 from = "<undefined>";
442 BIO_printf((BIO *)arg, "%s => %s\n", from, to);
446 /* Unified enum for help and list commands. */
447 typedef enum HELPLIST_CHOICE {
448 OPT_ERR = -1, OPT_EOF = 0, OPT_HELP,
449 OPT_COMMANDS, OPT_DIGEST_COMMANDS,
450 OPT_DIGEST_ALGORITHMS, OPT_CIPHER_COMMANDS, OPT_CIPHER_ALGORITHMS,
451 OPT_PK_ALGORITHMS, OPT_DISABLED
454 OPTIONS list_options[] = {
455 {"help", OPT_HELP, '-', "Display this summary"},
456 {"commands", OPT_COMMANDS, '-', "List of standard commands"},
457 {"digest-commands", OPT_DIGEST_COMMANDS, '-',
458 "List of message digest commands"},
459 {"digest-algorithms", OPT_DIGEST_ALGORITHMS, '-',
460 "List of message digest algorithms"},
461 {"cipher-commands", OPT_CIPHER_COMMANDS, '-', "List of cipher commands"},
462 {"cipher-algorithms", OPT_CIPHER_ALGORITHMS, '-',
463 "List of cipher algorithms"},
464 {"public-key-algorithms", OPT_PK_ALGORITHMS, '-',
465 "List of public key algorithms"},
466 {"disabled", OPT_DISABLED, '-',
467 "List of disabled features"},
471 int list_main(int argc, char **argv)
477 prog = opt_init(argc, argv, list_options);
478 while ((o = opt_next()) != OPT_EOF) {
480 case OPT_EOF: /* Never hit, but suppresses warning */
482 BIO_printf(bio_err, "%s: Use -help for summary.\n", prog);
485 opt_help(list_options);
488 list_type(FT_general);
490 case OPT_DIGEST_COMMANDS:
493 case OPT_DIGEST_ALGORITHMS:
494 EVP_MD_do_all_sorted(list_md_fn, bio_out);
496 case OPT_CIPHER_COMMANDS:
497 list_type(FT_cipher);
499 case OPT_CIPHER_ALGORITHMS:
500 EVP_CIPHER_do_all_sorted(list_cipher_fn, bio_out);
502 case OPT_PK_ALGORITHMS:
513 BIO_printf(bio_err, "%s: Use -help for summary.\n", prog);
520 OPTIONS help_options[] = {
521 {"help", OPT_HELP, '-', "Display this summary"},
525 int help_main(int argc, char **argv)
533 prog = opt_init(argc, argv, help_options);
534 while ((o = opt_next()) != OPT_EOF) {
537 BIO_printf(bio_err, "%s: Use -help for summary.\n", prog);
540 opt_help(help_options);
544 argc = opt_num_rest();
548 BIO_printf(bio_err, "Usage: %s\n", prog);
552 BIO_printf(bio_err, "\nStandard commands");
555 for (fp = functions; fp->name != NULL; fp++) {
557 if (((i++) % COLUMNS) == 0) {
558 BIO_printf(bio_err, "\n");
561 if (fp->type != tp) {
564 BIO_printf(bio_err, "\n");
568 "\nMessage Digest commands (see the `dgst' command for more details)\n");
569 } else if (tp == FT_cipher) {
572 "\nCipher commands (see the `enc' command for more details)\n");
575 BIO_printf(bio_err, FORMAT, fp->name);
577 BIO_printf(bio_err, "\n\n");
581 int exit_main(int argc, char **argv)
583 return EXIT_THE_PROGRAM;
586 static void list_type(FUNC_TYPE ft)
591 for (fp = functions; fp->name != NULL; fp++)
592 if (fp->type == ft) {
593 if ((i++ % COLUMNS) == 0)
594 BIO_printf(bio_out, "\n");
595 BIO_printf(bio_out, FORMAT, fp->name);
597 BIO_printf(bio_out, "\n");
600 static int do_cmd(LHASH_OF(FUNCTION) *prog, int argc, char *argv[])
604 if (argc <= 0 || argv[0] == NULL)
607 fp = lh_FUNCTION_retrieve(prog, &f);
609 if (EVP_get_digestbyname(argv[0])) {
613 } else if (EVP_get_cipherbyname(argv[0])) {
620 return (fp->func(argc, argv));
622 if ((strncmp(argv[0], "no-", 3)) == 0) {
624 * User is asking if foo is unsupported, by trying to "run" the
625 * no-foo command. Strange.
627 f.name = argv[0] + 3;
628 if (lh_FUNCTION_retrieve(prog, &f) == NULL) {
629 BIO_printf(bio_out, "%s\n", argv[0]);
632 BIO_printf(bio_out, "%s\n", argv[0] + 3);
635 if (strcmp(argv[0], "quit") == 0 || strcmp(argv[0], "q") == 0 ||
636 strcmp(argv[0], "exit") == 0 || strcmp(argv[0], "bye") == 0)
637 /* Special value to mean "exit the program. */
638 return EXIT_THE_PROGRAM;
640 BIO_printf(bio_err, "Invalid command '%s'; type \"help\" for a list.\n",
645 static void list_pkey(void)
649 for (i = 0; i < EVP_PKEY_asn1_get_count(); i++) {
650 const EVP_PKEY_ASN1_METHOD *ameth;
651 int pkey_id, pkey_base_id, pkey_flags;
652 const char *pinfo, *pem_str;
653 ameth = EVP_PKEY_asn1_get0(i);
654 EVP_PKEY_asn1_get0_info(&pkey_id, &pkey_base_id, &pkey_flags,
655 &pinfo, &pem_str, ameth);
656 if (pkey_flags & ASN1_PKEY_ALIAS) {
657 BIO_printf(bio_out, "Name: %s\n", OBJ_nid2ln(pkey_id));
658 BIO_printf(bio_out, "\tAlias for: %s\n",
659 OBJ_nid2ln(pkey_base_id));
661 BIO_printf(bio_out, "Name: %s\n", pinfo);
662 BIO_printf(bio_out, "\tType: %s Algorithm\n",
663 pkey_flags & ASN1_PKEY_DYNAMIC ?
664 "External" : "Builtin");
665 BIO_printf(bio_out, "\tOID: %s\n", OBJ_nid2ln(pkey_id));
668 BIO_printf(bio_out, "\tPEM string: %s\n", pem_str);
674 static int function_cmp(const FUNCTION * a, const FUNCTION * b)
676 return strncmp(a->name, b->name, 8);
679 static unsigned long function_hash(const FUNCTION * a)
681 return lh_strhash(a->name);
684 static int SortFnByName(const void *_f1, const void *_f2)
686 const FUNCTION *f1 = _f1;
687 const FUNCTION *f2 = _f2;
689 if (f1->type != f2->type)
690 return f1->type - f2->type;
691 return strcmp(f1->name, f2->name);
694 static void list_disabled(void)
696 BIO_puts(bio_out, "Disabled algorithms:\n");
697 #ifdef OPENSSL_NO_AES
698 BIO_puts(bio_out, "AES\n");
701 BIO_puts(bio_out, "BF\n");
703 #ifdef OPENSSL_NO_CAMELLIA
704 BIO_puts(bio_out, "CAMELLIA\n");
706 #ifdef OPENSSL_NO_CAST
707 BIO_puts(bio_out, "CAST\n");
709 #ifdef OPENSSL_NO_CMAC
710 BIO_puts(bio_out, "CMAC\n");
712 #ifdef OPENSSL_NO_CMS
713 BIO_puts(bio_out, "CMS\n");
715 #ifdef OPENSSL_NO_COMP
716 BIO_puts(bio_out, "COMP\n");
718 #ifdef OPENSSL_NO_DES
719 BIO_puts(bio_out, "DES\n");
721 #ifdef OPENSSL_NO_DGRAM
722 BIO_puts(bio_out, "DGRAM\n");
725 BIO_puts(bio_out, "DH\n");
727 #ifdef OPENSSL_NO_DSA
728 BIO_puts(bio_out, "DSA\n");
730 #if defined(OPENSSL_NO_DTLS)
731 BIO_puts(bio_out, "DTLS\n");
733 #if defined(OPENSSL_NO_DTLS1)
734 BIO_puts(bio_out, "DTLS1\n");
736 #if defined(OPENSSL_NO_DTLS1_2)
737 BIO_puts(bio_out, "DTLS1_2\n");
740 BIO_puts(bio_out, "EC\n");
742 #ifdef OPENSSL_NO_EC2M
743 BIO_puts(bio_out, "EC2M\n");
745 #ifdef OPENSSL_NO_ENGINE
746 BIO_puts(bio_out, "ENGINE\n");
748 #ifdef OPENSSL_NO_GOST
749 BIO_puts(bio_out, "GOST\n");
751 #ifdef OPENSSL_NO_HEARTBEATS
752 BIO_puts(bio_out, "HEARTBEATS\n");
754 #ifdef OPENSSL_NO_HMAC
755 BIO_puts(bio_out, "HMAC\n");
757 #ifdef OPENSSL_NO_IDEA
758 BIO_puts(bio_out, "IDEA\n");
760 #ifdef OPENSSL_NO_MD2
761 BIO_puts(bio_out, "MD2\n");
763 #ifdef OPENSSL_NO_MD4
764 BIO_puts(bio_out, "MD4\n");
766 #ifdef OPENSSL_NO_MD5
767 BIO_puts(bio_out, "MD5\n");
769 #ifdef OPENSSL_NO_MDC2
770 BIO_puts(bio_out, "MDC2\n");
772 #ifdef OPENSSL_NO_OCB
773 BIO_puts(bio_out, "OCB\n");
775 #ifdef OPENSSL_NO_OCSP
776 BIO_puts(bio_out, "OCSP\n");
778 #ifdef OPENSSL_NO_PSK
779 BIO_puts(bio_out, "PSK\n");
781 #ifdef OPENSSL_NO_RC2
782 BIO_puts(bio_out, "RC2\n");
784 #ifdef OPENSSL_NO_RC4
785 BIO_puts(bio_out, "RC4\n");
787 #ifdef OPENSSL_NO_RC5
788 BIO_puts(bio_out, "RC5\n");
790 #ifdef OPENSSL_NO_RMD160
791 BIO_puts(bio_out, "RMD160\n");
793 #ifdef OPENSSL_NO_RSA
794 BIO_puts(bio_out, "RSA\n");
796 #ifdef OPENSSL_NO_SCRYPT
797 BIO_puts(bio_out, "SCRYPT\n");
799 #ifdef OPENSSL_NO_SCT
800 BIO_puts(bio_out, "SCT\n");
802 #ifdef OPENSSL_NO_SCTP
803 BIO_puts(bio_out, "SCTP\n");
805 #ifdef OPENSSL_NO_SEED
806 BIO_puts(bio_out, "SEED\n");
808 #ifdef OPENSSL_NO_SHA
809 BIO_puts(bio_out, "SHA\n");
811 #ifdef OPENSSL_NO_SOCK
812 BIO_puts(bio_out, "SOCK\n");
814 #ifdef OPENSSL_NO_SRP
815 BIO_puts(bio_out, "SRP\n");
817 #ifdef OPENSSL_NO_SRTP
818 BIO_puts(bio_out, "SRTP\n");
820 #ifdef OPENSSL_NO_SSL
821 BIO_puts(bio_out, "SSL\n");
823 #ifdef OPENSSL_NO_SSL3
824 BIO_puts(bio_out, "SSL3\n");
826 #if defined(OPENSSL_NO_TLS)
827 BIO_puts(bio_out, "TLS\n");
829 #ifdef OPENSSL_NO_TLS1
830 BIO_puts(bio_out, "TLS1\n");
832 #ifdef OPENSSL_NO_TLS1_1
833 BIO_puts(bio_out, "TLS1_1\n");
835 #ifdef OPENSSL_NO_TLS1_2
836 BIO_puts(bio_out, "TLS1_2\n");
838 #ifdef OPENSSL_NO_WHIRLPOOL
839 BIO_puts(bio_out, "WHIRLPOOL\n");
842 BIO_puts(bio_out, "ZLIB\n");
846 static LHASH_OF(FUNCTION) *prog_init(void)
848 LHASH_OF(FUNCTION) *ret;
852 /* Sort alphabetically within category. For nicer help displays. */
853 for (i = 0, f = functions; f->name != NULL; ++f, ++i) ;
854 qsort(functions, i, sizeof(*functions), SortFnByName);
856 if ((ret = lh_FUNCTION_new(function_hash, function_cmp)) == NULL)
859 for (f = functions; f->name != NULL; f++)
860 (void)lh_FUNCTION_insert(ret, f);