source: zzuf/trunk/src/zzuf.c @ 1666

Last change on this file since 1666 was 1666, checked in by Sam Hocevar, 15 years ago
  • Set --version to -V, not -v. We'll use -v for verbose.
  • Property svn:keywords set to Id
File size: 24.6 KB
Line 
1/*
2 *  zzuf - general purpose fuzzer
3 *  Copyright (c) 2002, 2007 Sam Hocevar <sam@zoy.org>
4 *                All Rights Reserved
5 *
6 *  $Id: zzuf.c 1666 2007-01-14 11:03:37Z sam $
7 *
8 *  This program is free software. It comes without any warranty, to
9 *  the extent permitted by applicable law. You can redistribute it
10 *  and/or modify it under the terms of the Do What The Fuck You Want
11 *  To Public License, Version 2, as published by Sam Hocevar. See
12 *  http://sam.zoy.org/wtfpl/COPYING for more details.
13 */
14
15/*
16 *  main.c: main program
17 */
18
19#include "config.h"
20
21#if defined HAVE_STDINT_H
22#   include <stdint.h>
23#elif defined HAVE_INTTYPES_H
24#   include <inttypes.h>
25#endif
26#if defined(HAVE_GETOPT_H)
27#   include <getopt.h>
28#endif
29#include <stdio.h>
30#include <stdlib.h>
31#include <unistd.h>
32#include <regex.h>
33#include <string.h>
34#include <errno.h>
35#include <signal.h>
36#include <sys/wait.h>
37#include <sys/time.h>
38#include <sys/resource.h>
39
40#include "libzzuf.h"
41#include "random.h"
42#include "fd.h"
43#include "fuzz.h"
44#include "md5.h"
45#include "timer.h"
46
47static void loop_stdin(void);
48
49static void spawn_children(void);
50static void clean_children(void);
51static void read_children(void);
52
53static char const *sig2str(int);
54static char *merge_regex(char *, char *);
55static char *merge_file(char *, char *);
56static void set_environment(char const *);
57static void version(void);
58#if defined(HAVE_GETOPT_H)
59static void usage(void);
60#endif
61
62static struct child_list
63{
64    enum status
65    {
66        STATUS_FREE,
67        STATUS_RUNNING,
68        STATUS_SIGTERM,
69        STATUS_SIGKILL,
70        STATUS_EOF,
71    } status;
72
73    pid_t pid;
74    int fd[3]; /* 0 is debug, 1 is stderr, 2 is stdout */
75    int bytes, seed;
76    int64_t date;
77    struct md5 *ctx;
78} *child_list;
79static int maxforks = 1, child_count = 0, maxcrashes = 1, crashes = 0;
80
81static char **newargv;
82static char *protect = NULL, *refuse = NULL;
83static int seed = 0;
84static int endseed = 1;
85static int quiet = 0;
86static int maxbytes = -1;
87static int md5 = 0;
88static int checkexit = 0;
89static int maxmem = -1;
90static int64_t maxtime = -1;
91static int64_t delay = 0;
92static int64_t lastlaunch = 0;
93
94#define ZZUF_FD_SET(fd, p_fdset, maxfd) \
95    if(fd >= 0) \
96    { \
97        FD_SET(fd, p_fdset); \
98        if(fd > maxfd) \
99            maxfd = fd; \
100    }
101
102#define ZZUF_FD_ISSET(fd, p_fdset) \
103    ((fd >= 0) && (FD_ISSET(fd, p_fdset)))
104
105int main(int argc, char *argv[])
106{
107    char *parser, *include, *exclude;
108    int i, cmdline = 0;
109
110    include = exclude = NULL;
111
112#if defined(HAVE_GETOPT_H)
113    for(;;)
114    {
115#   define OPTSTR "AB:cC:dD:E:F:iI:mM:nP:qr:R:s:ST:xhV"
116#   ifdef HAVE_GETOPT_LONG
117#       define MOREINFO "Try `%s --help' for more information.\n"
118        int option_index = 0;
119        static struct option long_options[] =
120        {
121            /* Long option, needs arg, flag, short option */
122            { "autoinc",     0, NULL, 'A' },
123            { "max-bytes",   1, NULL, 'B' },
124            { "cmdline",     0, NULL, 'c' },
125            { "max-crashes", 1, NULL, 'C' },
126            { "debug",       0, NULL, 'd' },
127            { "delay",       1, NULL, 'D' },
128            { "exclude",     1, NULL, 'E' },
129            { "max-forks",   1, NULL, 'F' },
130            { "stdin",       0, NULL, 'i' },
131            { "include",     1, NULL, 'I' },
132            { "md5",         0, NULL, 'm' },
133            { "max-memory",  1, NULL, 'M' },
134            { "network",     0, NULL, 'n' },
135            { "protect",     1, NULL, 'P' },
136            { "quiet",       0, NULL, 'q' },
137            { "ratio",       1, NULL, 'r' },
138            { "refuse",      1, NULL, 'R' },
139            { "seed",        1, NULL, 's' },
140            { "signal",      0, NULL, 'S' },
141            { "max-time",    1, NULL, 'T' },
142            { "check-exit",  0, NULL, 'x' },
143            { "help",        0, NULL, 'h' },
144            { "version",     0, NULL, 'V' },
145        };
146        int c = getopt_long(argc, argv, OPTSTR, long_options, &option_index);
147#   else
148#       define MOREINFO "Try `%s -h' for more information.\n"
149        int c = getopt(argc, argv, OPTSTR);
150#   endif
151        if(c == -1)
152            break;
153
154        switch(c)
155        {
156        case 'A': /* --autoinc */
157            setenv("ZZUF_AUTOINC", "1", 1);
158            break;
159        case 'B': /* --max-bytes */
160            maxbytes = atoi(optarg);
161            break;
162        case 'c': /* --cmdline */
163            cmdline = 1;
164            break;
165        case 'C': /* --max-crashes */
166            maxcrashes = atoi(optarg);
167            if(maxcrashes <= 0)
168                maxcrashes = 0;
169            break;
170        case 'd': /* --debug */
171            setenv("ZZUF_DEBUG", "1", 1);
172            break;
173        case 'D': /* --delay */
174            delay = (int64_t)(atof(optarg) * 1000000.0);
175            break;
176        case 'E': /* --exclude */
177            exclude = merge_regex(exclude, optarg);
178            if(!exclude)
179            {
180                printf("%s: invalid regex -- `%s'\n", argv[0], optarg);
181                return EXIT_FAILURE;
182            }
183            break;
184        case 'F': /* --max-forks */
185            maxforks = atoi(optarg) > 1 ? atoi(optarg) : 1;
186            break;
187        case 'i': /* --stdin */
188            setenv("ZZUF_STDIN", "1", 1);
189            break;
190        case 'I': /* --include */
191            include = merge_regex(include, optarg);
192            if(!include)
193            {
194                printf("%s: invalid regex -- `%s'\n", argv[0], optarg);
195                return EXIT_FAILURE;
196            }
197            break;
198        case 'm': /* --md5 */
199            md5 = 1;
200            break;
201        case 'M': /* --max-memory */
202            setenv("ZZUF_MEMORY", "1", 1);
203            maxmem = atoi(optarg);
204            break;
205        case 'n': /* --network */
206            setenv("ZZUF_NETWORK", "1", 1);
207            break;
208        case 'P': /* --protect */
209            protect = optarg;
210            break;
211        case 'q': /* --quiet */
212            quiet = 1;
213            break;
214        case 'r': /* --ratio */
215            setenv("ZZUF_RATIO", optarg, 1);
216            _zz_setratio(atof(optarg));
217            break;
218        case 'R': /* --refuse */
219            refuse = optarg;
220            break;
221        case 's': /* --seed */
222            parser = strchr(optarg, ':');
223            _zz_setseed(seed = atol(optarg));
224            endseed = parser ? atoi(parser + 1) : seed + 1;
225            break;
226        case 'S': /* --signal */
227            setenv("ZZUF_SIGNAL", "1", 1);
228            break;
229        case 'T': /* --max-time */
230            maxtime = (int64_t)(atof(optarg) * 1000000.0);
231            break;
232        case 'x': /* --check-exit */
233            checkexit = 1;
234            break;
235        case 'h': /* --help */
236            usage();
237            return 0;
238        case 'V': /* --version */
239            version();
240            return 0;
241        default:
242            printf("%s: invalid option -- %c\n", argv[0], c);
243            printf(MOREINFO, argv[0]);
244            return EXIT_FAILURE;
245        }
246    }
247#else
248#   define MOREINFO "Usage: %s message...\n"
249    int optind = 1;
250#endif
251
252    /* If asked to read from the standard input */
253    if(optind >= argc)
254    {
255        if(endseed != seed + 1)
256        {
257            printf("%s: seed ranges are incompatible with stdin fuzzing\n",
258                   argv[0]);
259            printf(MOREINFO, argv[0]);
260            return EXIT_FAILURE;
261        }
262
263        loop_stdin();
264
265        return EXIT_SUCCESS;
266    }
267
268    /* If asked to launch programs */
269    if(cmdline)
270    {
271        int dashdash = 0;
272
273        for(i = optind + 1; i < argc; i++)
274        {
275            if(dashdash)
276                include = merge_file(include, argv[i]);
277            else if(!strcmp("--", argv[i]))
278                dashdash = 1;
279            else if(argv[i][0] != '-')
280                include = merge_file(include, argv[i]);
281        }
282    }
283
284    if(include)
285        setenv("ZZUF_INCLUDE", include, 1);
286    if(exclude)
287        setenv("ZZUF_EXCLUDE", exclude, 1);
288    if(protect)
289        setenv("ZZUF_PROTECT", protect, 1);
290    if(refuse)
291        setenv("ZZUF_REFUSE", refuse, 1);
292
293    /* Allocate memory for children handling */
294    child_list = malloc(maxforks * sizeof(struct child_list));
295    for(i = 0; i < maxforks; i++)
296        child_list[i].status = STATUS_FREE;
297    child_count = 0;
298
299    /* Preload libzzuf.so */
300    set_environment(argv[0]);
301
302    /* Create new argv */
303    newargv = malloc((argc - optind + 1) * sizeof(char *));
304    memcpy(newargv, argv + optind, (argc - optind) * sizeof(char *));
305    newargv[argc - optind] = (char *)NULL;
306
307    /* Main loop */
308    while(child_count || seed < endseed)
309    {
310        /* Spawn new children, if necessary */
311        spawn_children();
312
313        /* Cleanup dead or dying children */
314        clean_children();
315
316        /* Read data from children */
317        read_children();
318
319        if(maxcrashes && crashes >= maxcrashes && child_count == 0)
320            break;
321    }
322
323    /* Clean up */
324    free(newargv);
325    free(child_list);
326
327    return EXIT_SUCCESS;   
328}
329
330static void loop_stdin(void)
331{
332    uint8_t md5sum[16];
333    struct md5 *ctx = NULL;
334
335    if(md5)
336        ctx = _zz_md5_init();
337
338    if(protect)
339        _zz_protect(protect);
340    if(refuse)
341        _zz_refuse(refuse);
342
343    _zz_fd_init();
344    _zz_register(0);
345
346    for(;;)
347    {
348        uint8_t buf[BUFSIZ];
349        int ret, off = 0, nw = 0;
350
351        ret = read(0, buf, BUFSIZ);
352        if(ret <= 0)
353            break;
354
355        _zz_fuzz(0, buf, ret);
356        _zz_addpos(0, ret);
357
358        if(md5)
359            _zz_md5_add(ctx, buf, ret);
360        else while(ret)
361        {
362            if((nw = write(1, buf + off, (size_t)ret)) < 0)
363                break;
364            ret -= nw;
365            off += nw;
366        }
367    }
368
369    if(md5)
370    {
371        _zz_md5_fini(md5sum, ctx);
372        fprintf(stdout, "zzuf[seed=%i]: %.02x%.02x%.02x%.02x%.02x%.02x"
373                "%.02x%.02x%.02x%.02x%.02x%.02x%.02x%.02x%.02x%.02x\n",
374                seed, md5sum[0], md5sum[1], md5sum[2], md5sum[3],
375                md5sum[4], md5sum[5], md5sum[6], md5sum[7],
376                md5sum[8], md5sum[9], md5sum[10], md5sum[11],
377                md5sum[12], md5sum[13], md5sum[14], md5sum[15]);
378        fflush(stdout);
379    }
380
381    _zz_unregister(0);
382    _zz_fd_fini();
383}
384
385static char *merge_file(char *regex, char *file)
386{
387    char *newfile = malloc(5 + 2 * strlen(file) + 1 + 1), *tmp = newfile;
388
389    *tmp++ = '(';
390    *tmp++ = '^';
391    *tmp++ = '|';
392    *tmp++ = '/';
393    *tmp++ = ')';
394    while(*file)
395    {
396        if(strchr("^.[$()|*+?{\\", *file))
397            *tmp++ = '\\';
398        *tmp++ = *file++;
399    }
400    *tmp++ = '$';
401    *tmp++ = '\0';
402
403    tmp = merge_regex(regex, newfile);
404    free(newfile);
405    return tmp;
406}
407
408static char *merge_regex(char *regex, char *string)
409{
410    regex_t optre;
411
412    if(regex)
413    {
414        regex = realloc(regex, strlen(regex) + strlen(string) + 1 + 1);
415        sprintf(regex + strlen(regex) - 1, "|%s)", string);
416    }
417    else
418    {
419        regex = malloc(1 + strlen(string) + 1 + 1);
420        sprintf(regex, "(%s)", string);
421    }
422
423    if(regcomp(&optre, regex, REG_EXTENDED) != 0)
424    {
425        free(regex);
426        return NULL;
427    }
428    regfree(&optre);
429
430    return regex;
431}
432
433static void spawn_children(void)
434{
435    static int const files[] = { DEBUG_FILENO, STDERR_FILENO, STDOUT_FILENO };
436    char buf[BUFSIZ];
437    int fd[3][2];
438    int64_t now = _zz_time();
439    pid_t pid;
440    int i, j;
441
442    if(child_count == maxforks)
443        return; /* no slot */
444
445    if(seed == endseed)
446        return; /* job finished */
447
448    if(maxcrashes && crashes >= maxcrashes)
449        return; /* all jobs crashed */
450
451    if(delay > 0 && lastlaunch + delay > now)
452        return; /* too early */
453
454    /* Find the empty slot */
455    for(i = 0; i < maxforks; i++)
456        if(child_list[i].status == STATUS_FREE)
457            break;
458
459    /* Prepare communication pipe */
460    for(j = 0; j < 3; j++)
461        if(pipe(fd[j]) == -1)
462        {
463            perror("pipe");
464            return;
465        }
466
467    /* Fork and launch child */
468    pid = fork();
469    switch(pid)
470    {
471        case -1:
472            perror("fork");
473            return;
474        case 0:
475            /* We’re the child */
476            if(maxmem >= 0)
477            {
478                struct rlimit rlim;
479                rlim.rlim_cur = maxmem * 1000000;
480                rlim.rlim_max = maxmem * 1000000;
481                setrlimit(RLIMIT_AS, &rlim);
482            }
483
484            /* We loop in reverse order so that files[0] is done last,
485             * just in case one of the other dup2()ed fds had the value */
486            for(j = 3; j--; )
487            {
488                close(fd[j][0]);
489                if(fd[j][1] != files[j])
490                {
491                    dup2(fd[j][1], files[j]);
492                    close(fd[j][1]);
493                }
494            }
495
496            /* Set environment variables */
497            sprintf(buf, "%i", seed);
498            setenv("ZZUF_SEED", buf, 1);
499
500            /* Run our process */
501            if(execvp(newargv[0], newargv))
502            {
503                perror(newargv[0]);
504                exit(EXIT_FAILURE);
505            }
506            return;
507    }
508
509    /* We’re the parent, acknowledge spawn */
510    child_list[i].date = now;
511    child_list[i].pid = pid;
512    for(j = 0; j < 3; j++)
513    {
514        close(fd[j][1]);
515        child_list[i].fd[j] = fd[j][0];
516    }
517    child_list[i].bytes = 0;
518    child_list[i].seed = seed;
519    child_list[i].status = STATUS_RUNNING;
520    if(md5)
521        child_list[i].ctx = _zz_md5_init();
522
523    lastlaunch = now;
524    child_count++;
525    seed++;
526}
527
528static void clean_children(void)
529{
530    int64_t now = _zz_time();
531    int i, j;
532
533    /* Terminate children if necessary */
534    for(i = 0; i < maxforks; i++)
535    {
536        if(child_list[i].status == STATUS_RUNNING
537            && maxbytes >= 0 && child_list[i].bytes > maxbytes)
538        {
539            fprintf(stdout, "zzuf[seed=%i]: data exceeded, sending SIGTERM\n",
540                    child_list[i].seed);
541            kill(child_list[i].pid, SIGTERM);
542            child_list[i].date = now;
543            child_list[i].status = STATUS_SIGTERM;
544        }
545
546        if(child_list[i].status == STATUS_RUNNING
547            && maxtime >= 0
548            && now > child_list[i].date + maxtime)
549        {
550            fprintf(stdout, "zzuf[seed=%i]: time exceeded, sending SIGTERM\n",
551                    child_list[i].seed);
552            kill(child_list[i].pid, SIGTERM);
553            child_list[i].date = now;
554            child_list[i].status = STATUS_SIGTERM;
555        }
556    }
557
558    /* Kill children if necessary (still there after 2 seconds) */
559    for(i = 0; i < maxforks; i++)
560    {
561        if(child_list[i].status == STATUS_SIGTERM
562            && now > child_list[i].date + 2000000)
563        {
564            fprintf(stdout, "zzuf[seed=%i]: not responding, sending SIGKILL\n",
565                    child_list[i].seed);
566            kill(child_list[i].pid, SIGKILL);
567            child_list[i].status = STATUS_SIGKILL;
568        }
569    }
570
571    /* Collect dead children */
572    for(i = 0; i < maxforks; i++)
573    {
574        uint8_t md5sum[16];
575        int status;
576        pid_t pid;
577
578        if(child_list[i].status != STATUS_SIGKILL
579            && child_list[i].status != STATUS_SIGTERM
580            && child_list[i].status != STATUS_EOF)
581            continue;
582
583        pid = waitpid(child_list[i].pid, &status, WNOHANG);
584        if(pid <= 0)
585            continue;
586
587        if(checkexit && WIFEXITED(status) && WEXITSTATUS(status))
588        {
589            fprintf(stdout, "zzuf[seed=%i]: exit %i\n",
590                    child_list[i].seed, WEXITSTATUS(status));
591            crashes++;
592        }
593        else if(WIFSIGNALED(status)
594                 && !(WTERMSIG(status) == SIGTERM
595                       && child_list[i].status == STATUS_SIGTERM))
596        {
597            fprintf(stdout, "zzuf[seed=%i]: signal %i%s%s\n",
598                    child_list[i].seed, WTERMSIG(status),
599                    sig2str(WTERMSIG(status)),
600                      (WTERMSIG(status) == SIGKILL && maxmem >= 0) ?
601                      " (memory exceeded?)" : "");
602            crashes++;
603        }
604
605        for(j = 0; j < 3; j++)
606            if(child_list[i].fd[j] >= 0)
607                close(child_list[i].fd[j]);
608
609        if(md5)
610        {
611            _zz_md5_fini(md5sum, child_list[i].ctx);
612            fprintf(stdout, "zzuf[seed=%i]: %.02x%.02x%.02x%.02x%.02x%.02x"
613                    "%.02x%.02x%.02x%.02x%.02x%.02x%.02x%.02x%.02x%.02x\n",
614                    child_list[i].seed, md5sum[0], md5sum[1], md5sum[2],
615                    md5sum[3], md5sum[4], md5sum[5], md5sum[6], md5sum[7],
616                    md5sum[8], md5sum[9], md5sum[10], md5sum[11], md5sum[12],
617                    md5sum[13], md5sum[14], md5sum[15]);
618        }
619        child_list[i].status = STATUS_FREE;
620        child_count--;
621    }
622
623    fflush(stdout);
624}
625
626static void read_children(void)
627{
628    struct timeval tv;
629    fd_set fdset;
630    int i, j, ret, maxfd = 0;
631
632    /* Read data from all sockets */
633    FD_ZERO(&fdset);
634    for(i = 0; i < maxforks; i++)
635    {
636        if(child_list[i].status != STATUS_RUNNING)
637            continue;
638
639        for(j = 0; j < 3; j++)
640            ZZUF_FD_SET(child_list[i].fd[j], &fdset, maxfd);
641    }
642    tv.tv_sec = 0;
643    tv.tv_usec = 1000;
644
645    ret = select(maxfd + 1, &fdset, NULL, NULL, &tv);
646    if(ret < 0)
647        perror("select");
648    if(ret <= 0)
649        return;
650
651    /* XXX: cute (i, j) iterating hack */
652    for(i = 0, j = 0; i < maxforks; i += (j == 2), j = (j + 1) % 3)
653    {
654        uint8_t buf[BUFSIZ];
655
656        if(child_list[i].status != STATUS_RUNNING)
657            continue;
658
659        if(!ZZUF_FD_ISSET(child_list[i].fd[j], &fdset))
660            continue;
661
662        ret = read(child_list[i].fd[j], buf, BUFSIZ - 1);
663        if(ret > 0)
664        {
665            /* We got data */
666            if(j != 0)
667                child_list[i].bytes += ret;
668
669            if(md5 && j == 2)
670                _zz_md5_add(child_list[i].ctx, buf, ret);
671            else if(!quiet || j == 0)
672                write((j < 2) ? STDERR_FILENO : STDOUT_FILENO, buf, ret);
673        }
674        else if(ret == 0)
675        {
676            /* End of file reached */
677            close(child_list[i].fd[j]);
678            child_list[i].fd[j] = -1;
679
680            if(child_list[i].fd[0] == -1 && child_list[i].fd[1] == -1
681               && child_list[i].fd[2] == -1)
682                child_list[i].status = STATUS_EOF;
683        }
684    }
685}
686
687static char const *sig2str(int signum)
688{
689    switch(signum)
690    {
691        case SIGABRT:  return " (SIGABRT)";
692        case SIGFPE:   return " (SIGFPE)";
693        case SIGILL:   return " (SIGILL)";
694        case SIGQUIT:  return " (SIGQUIT)";
695        case SIGSEGV:  return " (SIGSEGV)";
696        case SIGTRAP:  return " (SIGTRAP)";
697#ifdef SIGSYS
698        case SIGSYS:   return " (SIGSYS)";
699#endif
700#ifdef SIGEMT
701        case SIGEMT:   return " (SIGEMT)";
702#endif
703#ifdef SIGBUS
704        case SIGBUS:   return " (SIGBUS)";
705#endif
706#ifdef SIGXCPU
707        case SIGXCPU:  return " (SIGXCPU)";
708#endif
709#ifdef SIGXFSZ
710        case SIGXFSZ:  return " (SIGXFSZ)";
711#endif
712    }
713
714    return "";
715}
716
717static void set_environment(char const *progpath)
718{
719    char *libpath, *tmp;
720    int ret, len = strlen(progpath);
721#if defined __APPLE__
722#   define FILENAME "libzzuf.dylib"
723#   define EXTRAINFO ""
724#   define PRELOAD "DYLD_INSERT_LIBRARIES"
725    setenv("DYLD_FORCE_FLAT_NAMESPACE", "1", 1);
726#elif defined __osf__
727#   define FILENAME "libzzuf.so"
728#   define EXTRAINFO ":DEFAULT"
729#   define PRELOAD "_RLD_LIST"
730#else
731#   define FILENAME "libzzuf.so"
732#   define EXTRAINFO ""
733#   define PRELOAD "LD_PRELOAD"
734#endif
735
736    libpath = malloc(len + strlen("/.libs/" FILENAME EXTRAINFO) + 1);
737    strcpy(libpath, progpath);
738
739    tmp = strrchr(libpath, '/');
740    strcpy(tmp ? tmp + 1 : libpath, ".libs/" FILENAME);
741    ret = access(libpath, R_OK);
742
743    strcpy(tmp ? tmp + 1 : libpath, ".libs/" FILENAME EXTRAINFO);
744    if(ret == 0)
745        setenv(PRELOAD, libpath, 1);
746    else
747        setenv(PRELOAD, LIBDIR "/" FILENAME EXTRAINFO, 1);
748    free(libpath);
749}
750
751static void version(void)
752{
753    printf("zzuf %s\n", VERSION);
754    printf("Copyright (C) 2002, 2007 Sam Hocevar <sam@zoy.org>\n");
755    printf("This is free software.  You may redistribute copies of it under the\n");
756    printf("terms of the Do What The Fuck You Want To Public License, Version 2\n");
757    printf("<http://sam.zoy.org/wtfpl/>.\n");
758    printf("There is NO WARRANTY, to the extent permitted by law.\n");
759    printf("\n");
760    printf("Written by Sam Hocevar. Report bugs to <sam@zoy.org>.\n");
761}
762
763#if defined(HAVE_GETOPT_H)
764static void usage(void)
765{
766    printf("Usage: zzuf [-AcdimnqSx] [-r ratio] [-s seed | -s start:stop]\n");
767    printf("                         [-D delay] [-F forks] [-C crashes] [-B bytes]\n");
768    printf("                         [-T seconds] [-M bytes] [-P protect] [-R refuse]\n");
769    printf("                         [-I include] [-E exclude] [PROGRAM [--] [ARGS]...]\n");
770#   ifdef HAVE_GETOPT_LONG
771    printf("       zzuf -h | --help\n");
772    printf("       zzuf -V | --version\n");
773#   else
774    printf("       zzuf -h\n");
775    printf("       zzuf -V\n");
776#   endif
777    printf("Run PROGRAM with optional arguments ARGS and fuzz its input.\n");
778    printf("\n");
779    printf("Mandatory arguments to long options are mandatory for short options too.\n");
780#   ifdef HAVE_GETOPT_LONG
781    printf("  -A, --autoinc            increment seed each time a new file is opened\n");
782    printf("  -B, --max-bytes <n>      kill children that output more than <n> bytes\n");
783    printf("  -c, --cmdline            only fuzz files specified in the command line\n");
784    printf("  -C, --max-crashes <n>    stop after <n> children have crashed (default 1)\n");
785    printf("  -d, --debug              print debug messages\n");
786    printf("  -D, --delay              delay between forks\n");
787    printf("  -E, --exclude <regex>    do not fuzz files matching <regex>\n");
788    printf("  -F, --max-forks <n>      number of concurrent children (default 1)\n");
789    printf("  -i, --stdin              fuzz standard input\n");
790    printf("  -I, --include <regex>    only fuzz files matching <regex>\n");
791    printf("  -m, --md5                compute the output's MD5 hash\n");
792    printf("  -M, --max-memory <n>     maximum child virtual memory size in MB\n");
793    printf("  -n, --network            fuzz network input\n");
794    printf("  -P, --protect <list>     protect bytes and characters in <list>\n");
795    printf("  -q, --quiet              do not print children's messages\n");
796    printf("  -r, --ratio <ratio>      bit fuzzing ratio (default 0.004)\n");
797    printf("  -R, --refuse <list>      refuse bytes and characters in <list>\n");
798    printf("  -s, --seed <seed>        random seed (default 0)\n");
799    printf("      --seed <start:stop>  specify a seed range\n");
800    printf("  -S, --signal             prevent children from diverting crashing signals\n");
801    printf("  -T, --max-time <n>       kill children that run for more than <n> seconds\n");
802    printf("  -x, --check-exit         report processes that exit with a non-zero status\n");
803    printf("  -h, --help               display this help and exit\n");
804    printf("  -V, --version            output version information and exit\n");
805#   else
806    printf("  -A               increment seed each time a new file is opened\n");
807    printf("  -B <n>           kill children that output more than <n> bytes\n");
808    printf("  -c               only fuzz files specified in the command line\n");
809    printf("  -C <n>           stop after <n> children have crashed (default 1)\n");
810    printf("  -d               print debug messages\n");
811    printf("  -D               delay between forks\n");
812    printf("  -E <regex>       do not fuzz files matching <regex>\n");
813    printf("  -F <n>           number of concurrent forks (default 1)\n");
814    printf("  -i               fuzz standard input\n");
815    printf("  -I <regex>       only fuzz files matching <regex>\n");
816    printf("  -m               compute the output's MD5 hash\n");
817    printf("  -M               maximum child virtual memory size in MB\n");
818    printf("  -n               fuzz network input\n");
819    printf("  -P <list>        protect bytes and characters in <list>\n");
820    printf("  -q               do not print the fuzzed application's messages\n");
821    printf("  -r <ratio>       bit fuzzing ratio (default 0.004)\n");
822    printf("  -R <list>        refuse bytes and characters in <list>\n");
823    printf("  -s <seed>        random seed (default 0)\n");
824    printf("     <start:stop>  specify a seed range\n");
825    printf("  -S               prevent children from diverting crashing signals\n");
826    printf("  -T <n>           kill children that run for more than <n> seconds\n");
827    printf("  -x               report processes that exit with a non-zero status\n");
828    printf("  -h               display this help and exit\n");
829    printf("  -V               output version information and exit\n");
830#   endif
831    printf("\n");
832    printf("Written by Sam Hocevar. Report bugs to <sam@zoy.org>.\n");
833}
834#endif
835
Note: See TracBrowser for help on using the repository browser.