Changeset 2353 for zzuf/trunk/doc


Ignore:
Timestamp:
Jun 10, 2008, 6:21:11 PM (12 years ago)
Author:
Sam Hocevar
Message:
  • Started writing a manual page for libzzuf.
Location:
zzuf/trunk/doc
Files:
1 added
2 edited

Legend:

Unmodified
Added
Removed
  • zzuf/trunk/doc/Makefile.am

    r1507 r2353  
    11# $Id: Makefile.am 871 2006-09-25 15:58:33Z sam $
    22
    3 EXTRA_DIST = zzuf.1
     3EXTRA_DIST = zzuf.1 libzzuf.3
    44
    5 man_MANS = zzuf.1
     5man_MANS = zzuf.1 libzzuf.3
    66
  • zzuf/trunk/doc/zzuf.1

    r2345 r2353  
    409409behaviour with multithreaded applications where more than one thread does file
    410410descriptor operations is undefined.
    411 .SH NOTES
    412 In order to intercept file and network operations, signal handlers and memory
    413 allocations, \fBzzuf\fR diverts and reimplements the following functions,
    414 which can be private libc symbols, too:
    415 .TP
    416 Unix file descriptor handling:
    417 \fBopen\fR(), \fBdup\fR(), \fBdup2\fR(), \fBlseek\fR(), \fBread\fR(),
    418 \fBreadv\fR(), \fBpread\fR(), \fBaccept\fR(), \fBsocket\fR(), \fBrecv\fR(),
    419 \fBrecvfrom\fR(), \fBrecvmsg\fR(), \fBaio_read\fR(), \fBaio_return\fR(),
    420 \fBclose\fR()
    421 .TP
    422 Standard IO streams:
    423 \fBfopen\fR(), \fBfreopen\fR(), \fBfseek\fR(), \fBfseeko\fR(), \fBrewind\fR(),
    424 \fBfread\fR(), \fBgetc\fR(), \fBgetchar\fR(), \fBfgetc\fR(), \fBfgets\fR(),
    425 \fBungetc\fR(), \fBfclose\fR()
    426 .TP
    427 Memory management:
    428 \fBmmap\fR(), \fBmunmap\fR(), \fBmalloc\fR(), \fBcalloc\fR(), \fBvalloc\fR(),
    429 \fBfree\fR(), \fBmemalign\fR(), \fBposix_memalign\fR()
    430 .TP
    431 Linux-specific:
    432 \fBopen64\fR(), \fBlseek64\fR(), \fBmmap64\fR(), \fB_IO_getc\fR(),
    433 \fBgetline\fR(), \fBgetdelim\fR(), \fB__getdelim\fR(), \fBgetc_unlocked\fR(),
    434 \fBgetchar_unlocked\fR(), \fBfgetc_unlocked\fR(), \fBfgets_unlocked\fR(),
    435 \fBfread_unlocked\fR()
    436 .TP
    437 BSD-specific:
    438 \fBfgetln\fR(), \fB__srefill\fR()
    439 .TP
    440 Mac OS X-specific:
    441 \fBmap_fd\fR()
    442 .TP
    443 Signal handling:
    444 \fBsignal\fR(), \fBsigaction\fR()
    445 .PP
    446 If an application manipulates file descriptors (reading data, seeking around)
    447 using functions that are not in that list, \fBzzuf\fR will not fuzz its
    448 input consistently and the results should not be trusted. You can use a tool
    449 such as \fBltrace(1)\fR on Linux to know the missing functions.
    450 .PP
    451 On BSD systems, such as FreeBSD or Mac OS X, \fB__srefill\fR() is enough to
    452 monitor all standard IO streams functions. On other systems, such as Linux,
    453 each function is reimplemented on a case by case basis. One important
    454 unimplemented function is \fBfscanf\fR(), because of its complexity. Missing
    455 functions will be added upon user request.
    456411.SH HISTORY
    457412.PP
    458413\fBzzuf\fR started its life in 2002 as the \fBstreamfucker\fR tool, a small
    459414multimedia stream corrupter used to find bugs in the VLC media player.
     415.SH SEE ALSO
     416.PP
     417\fBlibzzuf(3)\fR
    460418.SH AUTHOR
    461419.PP
Note: See TracChangeset for help on using the changeset viewer.