Eliminate buggy clone-and-hack keyreport functions.
[u/mdw/catacomb] / catcrypt.c
1 /* -*-c-*-
2 *
3 * $Id$
4 *
5 * Command-line encryption tool
6 *
7 * (c) 2004 Straylight/Edgeware
8 */
9
10 /*----- Licensing notice --------------------------------------------------*
11 *
12 * This file is part of Catacomb.
13 *
14 * Catacomb is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU Library General Public License as
16 * published by the Free Software Foundation; either version 2 of the
17 * License, or (at your option) any later version.
18 *
19 * Catacomb is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 * GNU Library General Public License for more details.
23 *
24 * You should have received a copy of the GNU Library General Public
25 * License along with Catacomb; if not, write to the Free
26 * Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
27 * MA 02111-1307, USA.
28 */
29
30 /*----- Header files ------------------------------------------------------*/
31
32 #include "config.h"
33
34 #include <errno.h>
35 #include <stdio.h>
36 #include <stdlib.h>
37 #include <string.h>
38
39 #include <mLib/base64.h>
40 #include <mLib/dstr.h>
41 #include <mLib/mdwopt.h>
42 #include <mLib/quis.h>
43 #include <mLib/report.h>
44 #include <mLib/sub.h>
45
46 #include "buf.h"
47 #include "rand.h"
48 #include "noise.h"
49 #include "mprand.h"
50 #include "key.h"
51 #include "cc.h"
52
53 #include "ectab.h"
54 #include "ptab.h"
55
56 /*----- Utilities ---------------------------------------------------------*/
57
58 /*----- Static variables --------------------------------------------------*/
59
60 static const char *keyring = "keyring";
61
62 /*----- Data format -------------------------------------------------------*/
63
64 /* --- Overview --- *
65 *
66 * The encrypted message is divided into chunks, each preceded by a two-octet
67 * length. The chunks don't need to be large -- the idea is that we can
68 * stream the chunks in and out.
69 *
70 * The first chunk is a header. It contains the decryption key-id, and maybe
71 * the verification key-id if the message is signed.
72 *
73 * Next comes the key-encapsulation chunk. This is decrypted in some
74 * KEM-specific way to yield a secret hash. The hash is expanded using an
75 * MGF (or similar) to make a symmetric encryption and MAC key.
76 *
77 * If the message is signed, there comes a signature chunk. The signature is
78 * on the further output of the MGF. This means that the recipient can
79 * modify the message and still have a valid signature, so it's not useful
80 * for proving things to other people; but it also means that the recipient
81 * knows that the message is from someone who knows the hash, which limits
82 * the possiblities to (a) whoever encrypted the message (good!) and (b)
83 * whoever knows the recipient's private key.
84 *
85 * Then come message chunks. Each one begins with a MAC over an implicit
86 * sequence number and the ciphertext. The final chunk's ciphertext is
87 * empty; no other chunk is empty. Thus can the correct end-of-file be
88 * discerned.
89 */
90
91 /*----- Chunk I/O ---------------------------------------------------------*/
92
93 static void chunk_write(enc *e, buf *b)
94 {
95 octet l[2];
96 size_t n = BLEN(b);
97 assert(n <= MASK16);
98 STORE16(l, n);
99 if (e->ops->write(e, l, 2) ||
100 e->ops->write(e, BBASE(b), BLEN(b)))
101 die(EXIT_FAILURE, "error writing output: %s", strerror(errno));
102 }
103
104 static void chunk_read(enc *e, dstr *d, buf *b)
105 {
106 octet l[2];
107 size_t n;
108
109 dstr_reset(d);
110 errno = 0;
111 if (e->ops->read(e, l, 2) != 2)
112 goto err;
113 n = LOAD16(l);
114 dstr_ensure(d, n);
115 if (e->ops->read(e, d->buf, n) != n)
116 goto err;
117 d->len = n;
118 buf_init(b, d->buf, d->len);
119 return;
120
121 err:
122 if (!errno) die(EXIT_FAILURE, "unexpected end-of-file on input");
123 else die(EXIT_FAILURE, "error reading input: %s", strerror(errno));
124 }
125
126 /*----- Encryption --------------------------------------------------------*/
127
128 static int encrypt(int argc, char *argv[])
129 {
130 const char *of = 0, *kn = "ccrypt", *skn = 0;
131 FILE *ofp = 0;
132 FILE *fp = 0;
133 const char *ef = "binary";
134 const char *err;
135 int i;
136 int en;
137 size_t n;
138 dstr d = DSTR_INIT;
139 octet *tag, *ct;
140 buf b;
141 size_t seq;
142 char bb[16384];
143 unsigned f = 0;
144 key_file kf;
145 key *k;
146 key *sk = 0;
147 kem *km;
148 sig *s = 0;
149 gcipher *cx, *c;
150 gmac *m;
151 ghash *h;
152 const encops *eo;
153 enc *e;
154
155 #define f_bogus 1u
156
157 for (;;) {
158 static const struct option opt[] = {
159 { "key", OPTF_ARGREQ, 0, 'k' },
160 { "sign-key", OPTF_ARGREQ, 0, 's' },
161 { "armour", 0, 0, 'a' },
162 { "armor", 0, 0, 'a' },
163 { "format", OPTF_ARGREQ, 0, 'f' },
164 { "output", OPTF_ARGREQ, 0, 'o' },
165 { 0, 0, 0, 0 }
166 };
167 i = mdwopt(argc, argv, "k:s:af:o:", opt, 0, 0, 0);
168 if (i < 0) break;
169 switch (i) {
170 case 'k': kn = optarg; break;
171 case 's': skn = optarg; break;
172 case 'a': ef = "pem"; break;
173 case 'f': ef = optarg; break;
174 case 'o': of = optarg; break;
175 default: f |= f_bogus; break;
176 }
177 }
178 if (argc - optind > 1 || (f & f_bogus))
179 die(EXIT_FAILURE, "Usage: encrypt [-OPTIONS] [FILE]");
180
181 if (key_open(&kf, keyring, KOPEN_READ, key_moan, 0))
182 die(EXIT_FAILURE, "can't open keyring `%s'", keyring);
183 if ((k = key_bytag(&kf, kn)) == 0)
184 die(EXIT_FAILURE, "key `%s' not found", kn);
185 if (skn && (sk = key_bytag(&kf, skn)) == 0)
186 die(EXIT_FAILURE, "key `%s' not found", skn);
187
188 if ((eo = getenc(ef)) == 0)
189 die(EXIT_FAILURE, "encoding `%s' not found", ef);
190
191 if (optind == argc)
192 fp = stdin;
193 else if (strcmp(argv[optind], "-") == 0) {
194 fp = stdin;
195 optind++;
196 } else if ((fp = fopen(argv[optind], "rb")) == 0) {
197 die(EXIT_FAILURE, "couldn't open file `%s': %s",
198 argv[optind], strerror(errno));
199 } else
200 optind++;
201
202 if (!of || strcmp(of, "-") == 0)
203 ofp = stdout;
204 else if ((ofp = fopen(of, eo->wmode)) == 0) {
205 die(EXIT_FAILURE, "couldn't open file `%s' for output: %s",
206 ofp, strerror(errno));
207 }
208
209 dstr_reset(&d);
210 key_fulltag(k, &d);
211 e = initenc(eo, ofp, "CATCRYPT ENCRYPTED MESSAGE");
212 km = getkem(k, "cckem", 0);
213 if ((err = km->ops->check(km)) != 0)
214 moan("key %s fails check: %s", d.buf, err);
215 if (sk) {
216 dstr_reset(&d);
217 key_fulltag(sk, &d);
218 s = getsig(sk, "ccsig", 1);
219 if ((err = s->ops->check(s)) != 0)
220 moan("key %s fails check: %s", d.buf, err);
221 }
222
223 /* --- Build the header chunk --- */
224
225 dstr_reset(&d);
226 dstr_ensure(&d, 256);
227 buf_init(&b, d.buf, 256);
228 buf_putu32(&b, k->id);
229 if (sk) buf_putu32(&b, sk->id);
230 assert(BOK(&b));
231 chunk_write(e, &b);
232
233 /* --- Build the KEM chunk --- */
234
235 dstr_reset(&d);
236 if (setupkem(km, &d, &cx, &c, &m))
237 die(EXIT_FAILURE, "failed to encapsulate key");
238 buf_init(&b, d.buf, d.len);
239 BSTEP(&b, d.len);
240 chunk_write(e, &b);
241
242 /* --- Write the signature chunk --- */
243
244 if (s) {
245 GC_ENCRYPT(cx, 0, bb, 1024);
246 GH_HASH(s->h, bb, 1024);
247 dstr_reset(&d);
248 if ((en = s->ops->doit(s, &d)) != 0)
249 die(EXIT_FAILURE, "error creating signature: %s", key_strerror(en));
250 buf_init(&b, d.buf, d.len);
251 BSTEP(&b, d.len);
252 chunk_write(e, &b);
253 }
254
255 /* --- Now do the main crypto --- */
256
257 assert(GC_CLASS(c)->blksz <= sizeof(bb));
258 dstr_ensure(&d, sizeof(bb) + GM_CLASS(m)->hashsz);
259 seq = 0;
260 for (;;) {
261 h = GM_INIT(m);
262 GH_HASHU32(h, seq);
263 seq++;
264 if (GC_CLASS(c)->blksz) {
265 GC_ENCRYPT(cx, 0, bb, GC_CLASS(c)->blksz);
266 GC_SETIV(c, bb);
267 }
268 n = fread(bb, 1, sizeof(bb), fp);
269 if (!n) break;
270 buf_init(&b, d.buf, d.sz);
271 tag = buf_get(&b, GM_CLASS(m)->hashsz);
272 ct = buf_get(&b, n);
273 assert(tag); assert(ct);
274 GC_ENCRYPT(c, bb, ct, n);
275 GH_HASH(h, ct, n);
276 GH_DONE(h, tag);
277 GH_DESTROY(h);
278 chunk_write(e, &b);
279 }
280
281 /* --- Final terminator packet --- */
282
283 buf_init(&b, d.buf, d.sz);
284 tag = buf_get(&b, GM_CLASS(m)->hashsz);
285 assert(tag);
286 GH_DONE(h, tag);
287 GH_DESTROY(h);
288 chunk_write(e, &b);
289
290 /* --- All done --- */
291
292 e->ops->encdone(e);
293 GM_DESTROY(m);
294 GC_DESTROY(c);
295 GC_DESTROY(cx);
296 freeenc(e);
297 if (s) freesig(s);
298 freekem(km);
299 if (fp != stdin) fclose(fp);
300 if (of) fclose(ofp);
301 key_close(&kf);
302 dstr_destroy(&d);
303 return (0);
304
305 #undef f_bogus
306 }
307
308 /*---- Decryption ---------------------------------------------------------*/
309
310 static int decrypt(int argc, char *argv[])
311 {
312 const char *of = 0;
313 FILE *ofp = 0, *rfp = 0;
314 FILE *fp = 0;
315 const char *ef = "binary";
316 int i;
317 size_t n;
318 dstr d = DSTR_INIT;
319 buf b;
320 key_file kf;
321 size_t seq;
322 uint32 id;
323 key *k;
324 key *sk = 0;
325 kem *km;
326 sig *s = 0;
327 gcipher *cx;
328 gcipher *c;
329 ghash *h;
330 gmac *m;
331 octet *tag;
332 unsigned f = 0;
333 const encops *eo;
334 const char *err;
335 int verb = 1;
336 enc *e;
337
338 #define f_bogus 1u
339 #define f_buffer 2u
340
341 for (;;) {
342 static const struct option opt[] = {
343 { "armour", 0, 0, 'a' },
344 { "armor", 0, 0, 'a' },
345 { "buffer", 0, 0, 'b' },
346 { "verbose", 0, 0, 'v' },
347 { "quiet", 0, 0, 'q' },
348 { "format", OPTF_ARGREQ, 0, 'f' },
349 { "output", OPTF_ARGREQ, 0, 'o' },
350 { 0, 0, 0, 0 }
351 };
352 i = mdwopt(argc, argv, "abf:o:qv", opt, 0, 0, 0);
353 if (i < 0) break;
354 switch (i) {
355 case 'a': ef = "pem"; break;
356 case 'b': f |= f_buffer; break;
357 case 'v': verb++; break;
358 case 'q': if (verb) verb--; break;
359 case 'f': ef = optarg; break;
360 case 'o': of = optarg; break;
361 default: f |= f_bogus; break;
362 }
363 }
364 if (argc - optind > 1 || (f & f_bogus))
365 die(EXIT_FAILURE, "Usage: decrypt [-OPTIONS] [FILE]");
366
367 if ((eo = getenc(ef)) == 0)
368 die(EXIT_FAILURE, "encoding `%s' not found", ef);
369
370 if (optind == argc)
371 fp = stdin;
372 else if (strcmp(argv[optind], "-") == 0) {
373 fp = stdin;
374 optind++;
375 } else if ((fp = fopen(argv[optind], eo->rmode)) == 0) {
376 die(EXIT_FAILURE, "couldn't open file `%s': %s",
377 argv[optind], strerror(errno));
378 } else
379 optind++;
380
381 if (key_open(&kf, keyring, KOPEN_READ, key_moan, 0))
382 die(EXIT_FAILURE, "can't open keyring `%s'", keyring);
383
384 e = initdec(eo, fp, checkbdry, "CATCRYPT ENCRYPTED MESSAGE");
385
386 /* --- Read the header chunk --- */
387
388 chunk_read(e, &d, &b);
389 if (buf_getu32(&b, &id)) {
390 if (verb) printf("FAIL malformed header: missing keyid\n");
391 exit(EXIT_FAILURE);
392 }
393 if ((k = key_byid(&kf, id)) == 0) {
394 if (verb) printf("FAIL key id %08lx not found\n", (unsigned long)id);
395 exit(EXIT_FAILURE);
396 }
397 if (BLEFT(&b)) {
398 if (buf_getu32(&b, &id)) {
399 if (verb) printf("FAIL malformed header: missing signature keyid\n");
400 exit(EXIT_FAILURE);
401 }
402 if ((sk = key_byid(&kf, id)) == 0) {
403 if (verb) printf("FAIL key id %08lx not found\n", (unsigned long)id);
404 exit(EXIT_FAILURE);
405 }
406 }
407 if (BLEFT(&b)) {
408 if (verb) printf("FAIL malformed header: junk at end\n");
409 exit(EXIT_FAILURE);
410 }
411
412 /* --- Find the key --- */
413
414 km = getkem(k, "cckem", 1);
415
416 /* --- Read the KEM chunk --- */
417
418 chunk_read(e, &d, &b);
419 if (setupkem(km, &d, &cx, &c, &m)) {
420 if (verb) printf("FAIL failed to decapsulate key\n");
421 exit(EXIT_FAILURE);
422 }
423
424 /* --- Verify the signature, if there is one --- */
425
426 if (sk) {
427 s = getsig(sk, "ccsig", 0);
428 dstr_reset(&d);
429 key_fulltag(sk, &d);
430 if (verb && (err = s->ops->check(s)) != 0)
431 printf("WARN verification key %s fails check: %s\n", d.buf, err);
432 dstr_reset(&d);
433 dstr_ensure(&d, 1024);
434 GC_ENCRYPT(cx, 0, d.buf, 1024);
435 GH_HASH(s->h, d.buf, 1024);
436 chunk_read(e, &d, &b);
437 if (s->ops->doit(s, &d)) {
438 if (verb) printf("FAIL signature verification failed\n");
439 exit(EXIT_FAILURE);
440 }
441 if (verb) {
442 dstr_reset(&d);
443 key_fulltag(sk, &d);
444 printf("INFO good-signature %s\n", d.buf);
445 }
446 freesig(s);
447 } else if (verb)
448 printf("INFO no-signature\n");
449
450 /* --- Now decrypt the main body --- */
451
452 if (!of || strcmp(of, "-") == 0) {
453 ofp = stdout;
454 f |= f_buffer;
455 }
456 if (!(f & f_buffer)) {
457 if ((ofp = fopen(of, "wb")) == 0) {
458 die(EXIT_FAILURE, "couldn't open file `%s' for output: %s",
459 ofp, strerror(errno));
460 }
461 rfp = ofp;
462 } else if ((rfp = tmpfile()) == 0)
463 die(EXIT_FAILURE, "couldn't create temporary file: %s", strerror(errno));
464
465 seq = 0;
466 dstr_ensure(&d, GC_CLASS(c)->blksz);
467 dstr_ensure(&d, 4);
468 for (;;) {
469 if (GC_CLASS(c)->blksz) {
470 GC_ENCRYPT(cx, 0, d.buf, GC_CLASS(c)->blksz);
471 GC_SETIV(c, d.buf);
472 }
473 h = GM_INIT(m);
474 GH_HASHU32(h, seq);
475 seq++;
476 chunk_read(e, &d, &b);
477 if ((tag = buf_get(&b, GM_CLASS(m)->hashsz)) == 0) {
478 if (verb) printf("FAIL bad ciphertext chunk: no tag\n");
479 exit(EXIT_FAILURE);
480 }
481 GH_HASH(h, BCUR(&b), BLEFT(&b));
482 if (memcmp(tag, GH_DONE(h, 0), GM_CLASS(m)->hashsz) != 0) {
483 if (verb)
484 printf("FAIL bad ciphertext chunk: authentication failure\n");
485 exit(EXIT_FAILURE);
486 }
487 GH_DESTROY(h);
488 if (!BLEFT(&b))
489 break;
490 GC_DECRYPT(c, BCUR(&b), BCUR(&b), BLEFT(&b));
491 if (fwrite(BCUR(&b), 1, BLEFT(&b), rfp) != BLEFT(&b)) {
492 if (verb) printf("FAIL error writing output: %s\n", strerror(errno));
493 exit(EXIT_FAILURE);
494 }
495 }
496
497 if (fflush(rfp) || ferror(rfp)) {
498 if (verb) printf("FAIL error writing output: %s\n", strerror(errno));
499 exit(EXIT_FAILURE);
500 }
501 if (f & f_buffer) {
502 if (!ofp && (ofp = fopen(of, "wb")) == 0) {
503 die(EXIT_FAILURE, "couldn't open file `%s' for output: %s",
504 of, strerror(errno));
505 }
506 rewind(rfp);
507 dstr_reset(&d);
508 dstr_ensure(&d, 65536);
509 if (verb && ofp == stdout) printf("DATA\n");
510 for (;;) {
511 n = fread(d.buf, 1, d.sz, rfp);
512 if (!n) break;
513 if (fwrite(d.buf, 1, n, ofp) < n)
514 die(EXIT_FAILURE, "error writing output: %s", strerror(errno));
515 }
516 if (ferror(rfp) || fclose(rfp))
517 die(EXIT_FAILURE, "error unbuffering output: %s", strerror(errno));
518 }
519 if (ofp && (fflush(ofp) || ferror(ofp) || fclose(ofp)))
520 die(EXIT_FAILURE, "error writing output: %s", strerror(errno));
521
522 e->ops->decdone(e);
523 if (verb && ofp != stdout)
524 printf("OK decrypted successfully\n");
525 freeenc(e);
526 GC_DESTROY(c);
527 GC_DESTROY(cx);
528 GM_DESTROY(m);
529 freekem(km);
530 if (fp != stdin) fclose(fp);
531 if (of) fclose(ofp);
532 key_close(&kf);
533 dstr_destroy(&d);
534 return (0);
535
536 #undef f_bogus
537 #undef f_buffer
538 }
539
540 /*----- Main code ---------------------------------------------------------*/
541
542 #define LISTS(LI) \
543 LI("Lists", list, \
544 listtab[i].name, listtab[i].name) \
545 LI("Key-encapsulation mechanisms", kem, \
546 kemtab[i].name, kemtab[i].name) \
547 LI("Signature schemes", sig, \
548 sigtab[i].name, sigtab[i].name) \
549 LI("Encodings", enc, \
550 enctab[i].name, enctab[i].name) \
551 LI("Symmetric encryption algorithms", cipher, \
552 gciphertab[i], gciphertab[i]->name) \
553 LI("Hash functions", hash, \
554 ghashtab[i], ghashtab[i]->name) \
555 LI("Message authentication codes", mac, \
556 gmactab[i], gmactab[i]->name)
557
558 MAKELISTTAB(listtab, LISTS)
559
560 int cmd_show(int argc, char *argv[])
561 {
562 return (displaylists(listtab, argv + 1));
563 }
564
565 static int cmd_help(int, char **);
566
567 static cmd cmdtab[] = {
568 { "help", cmd_help, "help [COMMAND...]" },
569 { "show", cmd_show, "show [ITEM...]" },
570 CMD_ENCODE,
571 CMD_DECODE,
572 { "encrypt", encrypt,
573 "encrypt [-a] [-k TAG] [-s TAG] [-f FORMAT]\n\t\
574 [-o OUTPUT] [FILE]", "\
575 Options:\n\
576 \n\
577 -a, --armour Same as `-f pem'.\n\
578 -f, --format=FORMAT Encode as FORMAT.\n\
579 -k, --key=TAG Use public encryption key named by TAG.\n\
580 -s, --sign-key=TAG Use private signature key named by TAG.\n\
581 -o, --output=FILE Write output to FILE.\n\
582 " },
583 { "decrypt", decrypt,
584 "decrypt [-abqv] [-f FORMAT] [-o OUTPUT] [FILE]", "\
585 Options:\n\
586 \n\
587 -a, --armour Same as `-f pem'.\n\
588 -b, --buffer Buffer output until we're sure we have it all.\n\
589 -f, --format=FORMAT Decode as FORMAT.\n\
590 -o, --output=FILE Write output to FILE.\n\
591 -q, --quiet Produce fewer messages.\n\
592 -v, --verbose Produce more verbose messages.\n\
593 " }, /* ' emacs is confused */
594 { 0, 0, 0 }
595 };
596
597 static int cmd_help(int argc, char **argv)
598 {
599 sc_help(cmdtab, stdout, argv + 1);
600 return (0);
601 }
602
603 void version(FILE *fp)
604 {
605 pquis(fp, "$, Catacomb version " VERSION "\n");
606 }
607
608 static void usage(FILE *fp)
609 {
610 pquis(fp, "Usage: $ [-k KEYRING] COMMAND [ARGS]\n");
611 }
612
613 void help_global(FILE *fp)
614 {
615 usage(fp);
616 fputs("\n\
617 Encrypt and decrypt files.\n\
618 \n\
619 Global command-line options:\n\
620 \n\
621 -h, --help [COMMAND...] Show this help message, or help for COMMANDs.\n\
622 -v, --version Show program version number.\n\
623 -u, --usage Show a terse usage message.\n\
624 \n\
625 -k, --keyring=FILE Read keys from FILE.\n",
626 fp);
627 }
628
629 /* --- @main@ --- *
630 *
631 * Arguments: @int argc@ = number of command line arguments
632 * @char *argv[]@ = vector of command line arguments
633 *
634 * Returns: Zero if successful, nonzero otherwise.
635 *
636 * Use: Encrypts or decrypts files.
637 */
638
639 int main(int argc, char *argv[])
640 {
641 unsigned f = 0;
642
643 #define f_bogus 1u
644
645 /* --- Initialize the library --- */
646
647 ego(argv[0]);
648 sub_init();
649 rand_noisesrc(RAND_GLOBAL, &noise_source);
650 rand_seed(RAND_GLOBAL, 160);
651
652 /* --- Parse options --- */
653
654 for (;;) {
655 static struct option opts[] = {
656 { "help", 0, 0, 'h' },
657 { "version", 0, 0, 'v' },
658 { "usage", 0, 0, 'u' },
659 { "keyring", OPTF_ARGREQ, 0, 'k' },
660 { 0, 0, 0, 0 }
661 };
662 int i = mdwopt(argc, argv, "+hvu k:", opts, 0, 0, 0);
663 if (i < 0)
664 break;
665 switch (i) {
666 case 'h':
667 sc_help(cmdtab, stdout, argv + optind);
668 exit(0);
669 break;
670 case 'v':
671 version(stdout);
672 exit(0);
673 break;
674 case 'u':
675 usage(stdout);
676 exit(0);
677 case 'k':
678 keyring = optarg;
679 break;
680 default:
681 f |= f_bogus;
682 break;
683 }
684 }
685
686 argc -= optind;
687 argv += optind;
688 optind = 0;
689 if (f & f_bogus || argc < 1) {
690 usage(stderr);
691 exit(EXIT_FAILURE);
692 }
693
694 /* --- Dispatch to the correct subcommand handler --- */
695
696 return (findcmd(cmdtab, argv[0])->cmd(argc, argv));
697
698 #undef f_bogus
699 }
700
701 /*----- That's all, folks -------------------------------------------------*/