NAME

start_stdout_shadow - Begins stdout 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_stdout_shadow(const char *file_name);

DESCRIPTION

This routine begins stdout shadowing to the file with name file_name. If stdout shadowing is already in place, the destination is switched over to file_name. More bluntly, there can be only one stdout shadow file. When shadowing is in place, lines that are written to standard output 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