NAME

kjb_write - Writes a specifed number of bytes to a device

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 


long kjb_write
(
	int des,
	const void *buff,
	size_t len
);

PARAMETERS

int des: File descriptor
const void *buff: Location of bytes to write.
size_t len: Number of bytes to write.

DESCRIPTION

Similer to system write except that error handling is simplified. This routine can only write up to MIN_OF(LONG_MAX, SSIZE_MAX), bytes. If num_bytes is more than that, this routine returns ERROR. The alternative wrapper, kjb_write_2() can be used to write up to the maximun value that size_t can hold.

RETURNS

On success kjb_write returns the number of bytes written. On failure ERROR is returned and an error message is set.

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER