NAME

kjb_read_exact - Reads a specifed number of bytes from a file descriptor.

SYNOPSIS

#include "l/l_sys_io.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


int kjb_read_exact
(
	int file_des,
	void *buff,
	size_t len
);

DESCRIPTION

This routine is very similar to kjb_read, execpt that exactly "len" bytes must be successfully read for a successfull return. Otherwise, ERROR is returned, with an approapriate error measure being set.

RETURNS

On success kjb_read_exact returns NO_ERROR. Since the number of bytes that must be read is in the parameter, there is no need to return that (thus avoiding problems due to signed versus unsigned types). On failure ERROR is returned and an error message is set. Other kjb_read returns such as EOF will not occur.

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTER