NAME

get_config_file - Finds a configuration file

SYNOPSIS

#include "l/l_config.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 get_config_file
(
	const char *env_var,
	const char *sub_dir,
	const char *file_name,
	const char *message_name,
	char *config_file,
	size_t config_file_size
);

DESCRIPTION

This routine implements essentially a "dry run" of open_config_file(). If a config file is found, its name is put into the buffer "config_file", whose size must be passed in via "config_file_name_size". The file can be subsequently opened for use at some later point. See open_config_file() for details on the search locations used. The file name actually used is put into the buffer config_file_name whose size must be passed in via config_file_name_size; The paramter message_name can be used to specify a name for the configuration file to be used in composing an error message. Otherwise "configuration" is used.

RETURNS

Either NO_ERROR, or ERROR, 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