NAME

start_stdout_shadow - Begins stdout 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_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.

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 , stop_stdout_shadow , start_stderr_shadow , stop_stderr_shadow , kjb_glob , kjb_simple_glob