debian man page for buffer_mmapread

buffer_mmapread(3)					     Library Functions Manual						buffer_mmapread(3)

NAME
       buffer_mmapread - create read-only memory-mapped file buffer

SYNTAX
       #include <buffer.h>

       int buffer_mmapread(buffer &b,const char* filename);

DESCRIPTION
       buffer_mmapread	opens filename for reading and fills b so that the contents of the file can be read from it.  Using mmap is more efficient
       than reading through a real buffer, but you have to call buffer_close to unmap the memory in the end.

EXAMPLE
	 #include <buffer.h>
	 #include <open.h>

	 buffer input;
	 char x;

	 buffer_mmapread(&input,"/etc/passwd");
	 while (buffer_get(&input,&x,1)==1) {
	   buffer_put(buffer_1,&x,1);
	   if (x=='
') break;
	 }
	 buffer_flush(buffer_1);
	 buffer_close(&input);

RETURN VALUE
       buffer_mmapread returns 0 if everything was fine, -1 on error (setting errno).

SEE ALSO
       buffer_flush(3), buffer(3)

																buffer_mmapread(3)