chiark / gitweb /
do not die straight away on errors
[chiark-utils.git] / cprogs / writebuffer.1
1 .TH writebuffer 1 2001-10-21 chiark-backup
2 .SH NAME
3 writebuffer \- write output to devices which don't like constant stopping and starting
4 .SH SYNOPSIS
5 .B writebuffer
6 .RB [ --mlock ]
7 .RI [ size ]
8 .SH DESCRIPTION
9 .B writebuffer
10 reads data on standard input and writes it to standard output.  It
11 will buffer internally up to \fIsize\fR megabytes and will only write
12 data when the buffer is at least 75% full or when there is no more
13 input to fill the buffer.
14 .PP
15 It is intended for use in situations where many small writes are
16 undesirable for performance reasons, e.g. tape drives.
17 .SH OPTIONS
18 .TP
19 .B --mlock
20 Calls
21 .BR mlock (2)
22 to lock the buffer into memory.
23 .SH "SEE ALSO"
24 .BR readbuffer (1),
25 .BR mlock (2)