NAME

start_stderr_shadow - Begins stderr shadowing to a file

SYNOPSIS

#include "l/l_sys_io.h"

Example compile flags (system dependent):
  -DLINUX_386 -DLINUX_386_P4  
   -I/home/kobus/include
   -L/home/kobus/load/linux_386_p4 -L/usr/local/lib -L/usr/lib
  -lKJB         -llapack -lblas -lg2c          -lXext -lX11 


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.

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

DOCUMENTOR

Kobus Barnard

SEE ALSO

kjb_read_exact , kjb_read , kjb_read_2 , safe_pipe_write , kjb_write , kjb_write_2 , kjb_fread_exact , kjb_fread , kjb_fread_2 , kjb_fwrite , kjb_fwrite_2 , kjb_fflush , kjb_ioctl , set_blocking , set_no_blocking , fget_line , dget_line , fput_line , kjb_mkdir , kjb_mkdir_2 , kjb_unlink , kjb_unlink_2 , kjb_rmdir , kjb_fopen , kjb_freopen , kjb_fdopen , kjb_fclose , kjb_realpath , get_fd_name , get_user_fd_name , kjb_fseek , kjb_ftell , kjb_fputs , kjb_fgetc , kjb_fputc , pso , p_stderr , kjb_fprintf , pdo , kjb_vfprintf , is_file , is_directory , fp_get_path_type , get_path_type , get_file_size , fp_get_byte_size , get_file_age , get_file_mod_time , print_underlined , start_stdout_shadow , stop_stdout_shadow , stop_stderr_shadow , kjb_glob , kjb_simple_glob