/*                                                   W3C Sample Code Library libwww Log Class
                                       LOG MANAGER
                                             
 */
/*
**      (c) COPYRIGHT MIT 1995.
**      Please first read the full copyright statement in the file COPYRIGH.
*/
/*

   This is a generic log object which can be used to log events to a file.
   
   This module is implemented by HTLog.c, and it is a part of the W3C Sample Code Library.
   
 */
#ifndef HTLIBLOG_H
#define HTLIBLOG_H

#include "HTReq.h"
/*

CREATE A NEW LOG OBJECT

   Create a new object and open the log file. The time used in the log file is either GMT
   or local dependent on local.
   
 */
typedef struct _HTLog HTLog;

extern HTLog * HTLog_open (const char * filename, BOOL local, BOOL append);
/*

DELETE A LOG OBJECT

   Close the log file and delete the object
   
 */
extern BOOL HTLog_close (HTLog * log);
/*

HOW MANY TIMES HAS LOG OBJECT BEEN ACCESSED?

   Returns access count number or -1
   
 */
extern int HTLog_accessCount (HTLog * log);
/*

LOG A CLIENT REQUEST IN CLF

   This functions logs the result of a request in what's close to CLF. It can be used on
   client side to track user behavior.
   
 */
extern BOOL HTLog_addCLF (HTLog * log, HTRequest * request, int status);
/*

LOG REFERER FIELDS

   This functions logs the referer logs of where the user has been.
   
 */
extern BOOL HTLog_addReferer (HTLog * log, HTRequest * request, int status);
/*

LOG THE FOLLOWING LINE

   A generic logger - logs whatever you put in as the line. The caller is responsible for
   adding a line feed if desired.
   
 */
extern BOOL HTLog_addLine (HTLog * log, const char * line);
/*

LOG THE FOLLOWING VARIABLE ARGUMENTS

   A generic logger with variable arguments
   
 */
extern BOOL HTLog_addText (HTLog * log, const char * fmt, ...);
/*

 */
#endif
/*

   
   ___________________________________
   
                             @(#) $Id: HTLog.html,v 2.16 1998/02/01 19:04:11 frystyk Exp $
                                                                                          
   */