src/include/posix/base/posixlog.h

00001 /*
00002  * Copyright (C) 2003-2007 Funambol, Inc
00003  *
00004  * This program is free software; you can redistribute it and/or modify
00005  * it under the terms of the GNU General Public License version 2 as
00006  * published by the Free Software Foundation.
00007  *
00008  * This program is distributed in the hope that it will be useful,
00009  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00010  * MERCHANTABILITY, TITLE, NONINFRINGEMENT or FITNESS FOR A PARTICULAR
00011  * PURPOSE.  See the GNU General Public License for more details.
00012  *
00013  * You should have received a copy of the GNU General Public License
00014  * along with this program; if not, write to the Free Software
00015  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
00016  * 02111-1307  USA
00017  */
00018 
00019 #ifndef INCL_AUTOTOOLS_LOG
00020 # define INCL_AUTOTOOLS_LOG
00021 
00023 #include <base/fscapi.h>
00024 
00025 /*
00026  * Opens the specified file for logging of messages.
00027  *
00028  * By default the LOG instance of the Log class will
00029  * create the file specified via its set methods
00030  * as soon as the first message needs to be printed or
00031  * when explicitly asking for a reset.
00032  *
00033  * By calling this function instead one gets more detailed
00034  * control over logging and avoids the (currently) insecurely
00035  * implemented handling of file name strings in the Log class.
00036  *
00037  * @param path            directory where file is to be created, can be NULL
00038  * @param name            file name relative to path or "-" when asking for
00039  *                        logging to stdout
00040  * @param redirectStderr  if TRUE, then file descriptor 2 (stderr)
00041  *                        will also be redirected into the log file;
00042  *                        the original stderr is preserved and will be
00043  *                        restored when turning this redirection off
00044  */
00045 void setLogFile(const char *path, const char* name, BOOL redirectStderr = FALSE);
00046 
00048 void setLogFile(const char* name, BOOL redirectStderr = FALSE);
00049 
00051 #endif

Generated on Fri Nov 9 12:21:26 2007 for Funambol Outlook Plug-in Library by  doxygen 1.5.2