Debian Codegraph @

debian/patches/document-buffer-limits

raw
1 --- a/buffer.man
2 +++ b/buffer.man
3 @@ -130,6 +130,25 @@
4 $ \fBtar cf - . | buffer |
5 .br
6 \ \ \ rsh somehost 'buffer -S 500K -p 75 > /dev/rst0'\fP
7 +.SH BUFFER LIMITS
8 +There are 2 limits in
9 +.I buffer
10 +affecting the maximum total buffer size: The maximum number of blocks (2048)
11 +and the maximum size of a block (512kB). This results in a maximum total
12 +buffer size of 1GB.
13 +.PP
14 +
15 +Note that there is also a kernel limit for the maximum size of a shared
16 +memory segment (used by
17 +.I buffer
18 +internally) which is typically much lower than the limits in
19 +.IR buffer .
20 +So if
21 +.I buffer
22 +complains about not being able to create a shared memory segment, this limit
23 +might have to be raised using the command \fBsysctl kernel.shmmax=\fP\fIXXX\fP (see also
24 +sysctl(1) and proc(5)).
25 +
26 .SH BUGS
27 Internally, for printing purposes, buffer counts in terms of the
28 number of kilobytes output. If the blocksize you use is not a whole