diff --git a/README b/README index 955320e..a6b9776 100644 --- a/README +++ b/README @@ -18,30 +18,30 @@ Fuzz 1% of the input bits of the "cat" program using seed 94324: # zzuf -s 94324 -r 0.01 cat /etc/motd Fuzz the input of the "convert" program, using file foo.jpeg as the original -input and restricting fuzzing to filenames matching the regular expression -"foo[.]jpeg" (because convert will also open its own configuration files and -we do not want zzuf to fuzz them): +input and excluding .xml files from fuzzing (because convert will also open +its own configuration files and we do not want zzuf to fuzz them): - # zzuf -I 'foo[.]jpeg' convert -- foo.jpeg -format tga /dev/null + # zzuf -E '\.xml$' convert -- foo.jpeg -format tga /dev/null -Fuzz the input of VLC, using file movie.avi as the original input, and +Fuzz the input of VLC, using file movie.avi as the original input and +restricting fuzzing to filenames that appear on the command line, then generate fuzzy-movie.avi which is a file that can be fed to VLC to reproduce the behaviour without using zzuf: - # zzuf -s 87423 -r 0.01 vlc movie.avi + # zzuf -c -s 87423 -r 0.01 vlc movie.avi - # zzuf -s 87423 -r 0.01 cp movie.avi fuzzy-movie.avi + # zzuf -c -s 87423 -r 0.01 cp movie.avi fuzzy-movie.avi # vlc fuzzy-movie.avi Fuzz mplayer's input with seeds 0 to 9999 and kill processes that take more than one minute to read the movie file: - # zzuf -q -s 0:10000 -T 60 -r 0.02 -I movie.avi \ + # zzuf -c -q -s 0:10000 -T 60 -r 0.02 \ mplayer movie.avi -- -benchmark -vo null -fps 1000 Same as above with up to 15 simultaneous child processes because we are playing a sound file: - # zzuf -F 15 -q -s 0:10000 -T 60 -r 0.02 -I song.mp3 \ + # zzuf -c -F 15 -q -s 0:10000 -T 60 -r 0.02 \ mplayer song.mp3 -- -benchmark -ao null diff --git a/doc/zzuf.1 b/doc/zzuf.1 index 2bd2cae..a17ff85 100644 --- a/doc/zzuf.1 +++ b/doc/zzuf.1 @@ -183,24 +183,24 @@ Fuzz the input of the .B convert program, using file .B foo.jpeg -as the original input and restricting fuzzing to filenames matching the -regular expression -.B "foo[.]jpeg" -(because +as the original input and excluding +.B .xml +files from fuzzing (because .B convert will also open its own configuration files and we do not want .B zzuf to fuzz them): .nf -.B % zzuf -I "foo[.]jpeg" convert -- foo.jpeg -format tga /dev/null +.B % zzuf -E "\\.xml$" convert -- foo.jpeg -format tga /dev/null .fi Fuzz the input of .BR vlc , using file .B movie.avi -as the original input, and generate +as the original input and restricting fuzzing to filenames that appear on +the command line, then generate .B fuzzy-movie.avi which is a file that can be fed to .B vlc @@ -208,9 +208,9 @@ to reproduce the same behaviour without using .BR zzuf : .fn -.B % zzuf -s 87423 -r 0.01 vlc movie.avi +.B % zzuf -c -s 87423 -r 0.01 vlc movie.avi -.B % zzuf -s 87423 -r 0.01 cp movie.avi fuzzy-movie.avi +.B % zzuf -c -s 87423 -r 0.01 cp movie.avi fuzzy-movie.avi .B % vlc fuzzy-movie.avi @@ -223,7 +223,7 @@ and killing if it takes more than one minute to read the file: .fn -.B % zzuf -q -s 0:10000 -F 3 -T 60 -r 0.02 -I movie.avi mplayer movie.avi -- -benchmark -vo null -fps 1000 +.B % zzuf -c -q -s 0:10000 -F 3 -T 60 -r 0.02 mplayer movie.avi -- -benchmark -vo null -fps 1000 .fi .RI