NAME

start_stderr_shadow - Begins stderr shadowing to a file

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 start_stderr_shadow(const char *file_name);

DESCRIPTION

This routine begins stderr shadowing to the file with name file_name. If stderr shadowing is already in place, the destination is switched over to file_name. More bluntly, there can be only one stderr shadow file. When shadowing is in place, lines that are written to standard error are also appended to the shadow file. This routine will fail if the shadow file cannot be opend for appending. This function is not re-entrant (i.e., not thread-safe).

RETURNS

NO_ERROR on success, ERROR on failure, with an appropriate error message being set.

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER