src/include/posix/base/posixlog.h

00001 /*
00002  * Funambol is a mobile platform developed by Funambol, Inc. 
00003  * Copyright (C) 2003 - 2007 Funambol, Inc.
00004  * 
00005  * This program is free software; you can redistribute it and/or modify it under
00006  * the terms of the GNU Affero General Public License version 3 as published by
00007  * the Free Software Foundation with the addition of the following permission 
00008  * added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED
00009  * WORK IN WHICH THE COPYRIGHT IS OWNED BY FUNAMBOL, FUNAMBOL DISCLAIMS THE 
00010  * WARRANTY OF NON INFRINGEMENT  OF THIRD PARTY RIGHTS.
00011  * 
00012  * This program is distributed in the hope that it will be useful, but WITHOUT
00013  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
00014  * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
00015  * details.
00016  * 
00017  * You should have received a copy of the GNU Affero General Public License 
00018  * along with this program; if not, see http://www.gnu.org/licenses or write to
00019  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
00020  * MA 02110-1301 USA.
00021  * 
00022  * You can contact Funambol, Inc. headquarters at 643 Bair Island Road, Suite 
00023  * 305, Redwood City, CA 94063, USA, or at email address info@funambol.com.
00024  * 
00025  * The interactive user interfaces in modified source and object code versions
00026  * of this program must display Appropriate Legal Notices, as required under
00027  * Section 5 of the GNU Affero General Public License version 3.
00028  * 
00029  * In accordance with Section 7(b) of the GNU Affero General Public License
00030  * version 3, these Appropriate Legal Notices must retain the display of the
00031  * "Powered by Funambol" logo. If the display of the logo is not reasonably 
00032  * feasible for technical reasons, the Appropriate Legal Notices must display
00033  * the words "Powered by Funambol".
00034  */
00035 
00036 #ifndef INCL_AUTOTOOLS_LOG
00037 # define INCL_AUTOTOOLS_LOG
00038 
00040 #include <base/fscapi.h>
00041 
00042 /*
00043  * Opens the specified file for logging of messages.
00044  *
00045  * By default the LOG instance of the Log class will
00046  * create the file specified via its set methods
00047  * as soon as the first message needs to be printed or
00048  * when explicitly asking for a reset.
00049  *
00050  * By calling this function instead one gets more detailed
00051  * control over logging and avoids the (currently) insecurely
00052  * implemented handling of file name strings in the Log class.
00053  *
00054  * @param path            directory where file is to be created, can be NULL
00055  * @param name            file name relative to path or "-" when asking for
00056  *                        logging to stdout
00057  * @param redirectStderr  if TRUE, then file descriptor 2 (stderr)
00058  *                        will also be redirected into the log file;
00059  *                        the original stderr is preserved and will be
00060  *                        restored when turning this redirection off
00061  */
00062 void setLogFile(const char *path, const char* name, BOOL redirectStderr = FALSE);
00063 
00065 void setLogFile(const char* name, BOOL redirectStderr = FALSE);
00066 
00068 #endif

Generated on Mon Feb 4 09:50:48 2008 for Funambol Outlook Plug-in Library by  doxygen 1.5.2