libcwd: The C++ Debugging Support Library - Reference Manual
Author: Carlo Wood
Description: C++ debugging support library with ostream debug output
Keywords: libcwd, debug output, debug facility, debug channel, object orientation, OO, C++, nested debug output, ostream, memory allocation, debugging, source file and line number

Main Page Reference Manual Namespace List Compound List Namespace Members Compound Members File Members

# Runtime Configuration File (rcfile)

## Classes
class | libcwd::rcfile_ct
| This object represents a runtime configuration file. More...

In order to use `attach_gdb()` and/or to read debug channel states from an external file, you should call `read_rcfile()`, for example,

    int main()
    {
      Debug( libcw_do.on() );               // In order to get RCFILE messages.
      Debug( read_rcfile() );

`read_rcfile()` can be used to turn on or off debug channels, but you still have to turn on the debug object(s); in particular the debug object `libcw_do` that is used to print WARNING messages in case something is wrong with your rcfile.

The default rcfile is .libcwdrc (you can change that by setting the environment variable LIBCWD_RCFILE_NAME ). The application will first attempt to read this file from the current directory. If that fails then it will try to read the rcfile from the users home directory. If that fails too then it will fall back to reading <install-prefix>/share/libcwd/libcwdrc . You can use the latter as a template and/or example
file for writing your own rcfile.