<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>liblogging: config.h File Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.3.2 -->
<div class="qindex"><a class="qindex" href="index.html">Main Page</a> | <a class="qindex" href="annotated.html">Compound List</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="functions.html">Compound Members</a> | <a class="qindex" href="globals.html">File Members</a> | <a class="qindex" href="pages.html">Related Pages</a></div>
<h1>config.h File Reference</h1>configuration settings for liblogging.
<a href="#_details">More...</a>
<p>
<code>#include <stdio.h></code><br>
<code>#include <stdlib.h></code><br>
<code>#include <string.h></code><br>
<p>
<a href="config_8h-source.html">Go to the source code of this file.</a><table border=0 cellpadding=0 cellspacing=0>
<tr><td></td></tr>
<tr><td colspan=2><br><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a name="a0" doxytag="config.h::__LIB3195_CONFIG_H_INCLUDED__"></a>
#define </td><td class="memItemRight" valign=bottom><b>__LIB3195_CONFIG_H_INCLUDED__</b> 1</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>#define </td><td class="memItemRight" valign=bottom><a class="el" href="config_8h.html#a1">BEEP_DEFAULT_WINDOWSIZE</a> 4096</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Default TCP Windows size as defined in RFC 3081. </em> <a href="#a1"></a><em><br><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a name="a2" doxytag="config.h::BEEPFRAMEMAX"></a>
#define </td><td class="memItemRight" valign=bottom><a class="el" href="config_8h.html#a2">BEEPFRAMEMAX</a> BEEP_DEFAULT_WINDOWSIZE</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Maximum size of a single BEEP frame. <br><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>#define </td><td class="memItemRight" valign=bottom><a class="el" href="config_8h.html#a3">SOCKETMAXINBUFSIZE</a> BEEP_DEFAULT_WINDOWSIZE</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Maximum size of the socket layer receive buffer. </em> <a href="#a3"></a><em><br><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>#define </td><td class="memItemRight" valign=bottom><a class="el" href="config_8h.html#a4">STRINGBUF_ALLOC_INCREMENT</a> 1024</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Size of dynamic string buffer growth. </em> <a href="#a4"></a><em><br><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>#define </td><td class="memItemRight" valign=bottom><a class="el" href="config_8h.html#a5">STRINGBUF_TRIM_ALLOCSIZE</a> 0</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This is an important setting for the dynamic string object. </em> <a href="#a5"></a><em><br><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a name="a6" doxytag="config.h::DEBUGLEVEL"></a>
#define </td><td class="memItemRight" valign=bottom><a class="el" href="config_8h.html#a6">DEBUGLEVEL</a> 1</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Enables debug aids if defined to 1, disables them otherwise. <br><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>#define </td><td class="memItemRight" valign=bottom><a class="el" href="config_8h.html#a7">SECURITY_PEER_ERRREPORT_LEVEL</a> 1</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">This is a security relevant setting. </em> <a href="#a7"></a><em><br><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a name="a8" doxytag="config.h::FEATURE_LISTENER"></a>
#define </td><td class="memItemRight" valign=bottom><a class="el" href="config_8h.html#a8">FEATURE_LISTENER</a> 1</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Should the listener features be provided? <br><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a name="a9" doxytag="config.h::FEATURE_UDP"></a>
#define </td><td class="memItemRight" valign=bottom><a class="el" href="config_8h.html#a9">FEATURE_UDP</a> 1</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Should UDP (RFC 3164) features be provided? <br><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a name="a10" doxytag="config.h::FEATURE_UNIX_DOMAIN_SOCKETS"></a>
#define </td><td class="memItemRight" valign=bottom><a class="el" href="config_8h.html#a10">FEATURE_UNIX_DOMAIN_SOCKETS</a> 1</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Should Unix Domain Sockets feature be provided? <br><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a name="a11" doxytag="config.h::FEATURE_COOKED"></a>
#define </td><td class="memItemRight" valign=bottom><a class="el" href="config_8h.html#a11">FEATURE_COOKED</a> 1</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Should the COOKED profile be provided? If set to 1, COOKED will be implemented for the client and, if FEATURE_LISTNER is set, for the listener part, too. <br><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>#define </td><td class="memItemRight" valign=bottom><a class="el" href="config_8h.html#a12">FEATURE_MSGAPI</a> 1</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Should the syslog message API be provided? Please note that some limited functionality of the API is provided in any case if FEATURE_LISTENER is turned on. </em> <a href="#a12"></a><em><br><br></td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a name="a13" doxytag="config.h::TRUE"></a>
#define </td><td class="memItemRight" valign=bottom><b>TRUE</b> 1</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a name="a14" doxytag="config.h::FALSE"></a>
#define </td><td class="memItemRight" valign=bottom><b>FALSE</b> 0</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a name="a15" doxytag="config.h::SLEEP"></a>
#define </td><td class="memItemRight" valign=bottom><b>SLEEP</b>(x) sleep(x)</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a name="a16" doxytag="config.h::SR_SOCKET"></a>
#define </td><td class="memItemRight" valign=bottom><b>SR_SOCKET</b> int</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top>#define </td><td class="memItemRight" valign=bottom><a class="el" href="config_8h.html#a17">INVALID_SOCKET</a> 0</td></tr>
<tr><td class="memItemLeft" nowrap align=right valign=top><a name="a18" doxytag="config.h::SNPRINTF"></a>
#define </td><td class="memItemRight" valign=bottom><b>SNPRINTF</b> snprintf</td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
configuration settings for liblogging.
<p>
This file includes all global defines as well as configuration settings. If you intend the lib to another environment, THIS is the place to add portability macros.<p>
<dl compact><dt><b>Author:</b></dt><dd>Rainer Gerhards <<a href="mailto:rgerhards@adiscon.com">rgerhards@adiscon.com</a>> </dd></dl>
<dl compact><dt><b>Date:</b></dt><dd>2003-08-04 0.1 version created.</dd></dl>
Copyright 2002-2003 Rainer Gerhards and Adiscon GmbH. All Rights Reserved.<p>
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:<p>
* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.<p>
* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.<p>
* Neither the name of Adiscon GmbH or Rainer Gerhards nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.<p>
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.<hr><h2>Define Documentation</h2>
<a name="a1" doxytag="config.h::BEEP_DEFAULT_WINDOWSIZE"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> #define BEEP_DEFAULT_WINDOWSIZE 4096
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Default TCP Windows size as defined in RFC 3081.
<p>
We may also define a value that suites us better... </td>
</tr>
</table>
<a name="a12" doxytag="config.h::FEATURE_MSGAPI"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> #define FEATURE_MSGAPI 1
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Should the syslog message API be provided? Please note that some limited functionality of the API is provided in any case if FEATURE_LISTENER is turned on.
<p>
However, even in that case no parsing will take place if FEATURE_MSGAPI is not turned on. </td>
</tr>
</table>
<a name="a17" doxytag="config.h::INVALID_SOCKET"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> #define INVALID_SOCKET 0
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
<dl compact><dt><b><a class="el" href="todo.html#_todo000015">Todo:</a></b></dt><dd>verify this value is indeed invalid under *nix</dd></dl>
</td>
</tr>
</table>
<a name="a7" doxytag="config.h::SECURITY_PEER_ERRREPORT_LEVEL"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> #define SECURITY_PEER_ERRREPORT_LEVEL 1
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
This is a security relevant setting.
<p>
It specifies how channel 0 error messages are sent. We support full-fledged error messages which make diagnosing the error cause (hopefully) relatively easy. On the other hand, though, they may be abused to find something out about the inner workings or state of the server process. This setting allows to tune the level of information provided to the remote peer: 0 - totally unspecifc error message, all replies will be 550 "error occured". 1 - all error codes are reported as they are provided EXCEPT for the 451s (which reaveal internal errors). 451s are reported as 550 "error occured" 2 - all error codes (including 451s) are sent in full </td>
</tr>
</table>
<a name="a3" doxytag="config.h::SOCKETMAXINBUFSIZE"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> #define SOCKETMAXINBUFSIZE BEEP_DEFAULT_WINDOWSIZE
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Maximum size of the socket layer receive buffer.
<p>
<dl compact><dt><b>Note:</b></dt><dd>A too-small buffer can cause performance degradation but can not break the implementation. This is just a buffer used when reading incoming data. The upper layers read byte by byte and the lower layer re-reads data when the buffer is empty. Anyhow, it is a good idea to leave it as default. </dd></dl>
</td>
</tr>
</table>
<a name="a4" doxytag="config.h::STRINGBUF_ALLOC_INCREMENT"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> #define STRINGBUF_ALLOC_INCREMENT 1024
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Size of dynamic string buffer growth.
<p>
The dynamic string buffer object allocates memory in STRINGBUF_ALLOC_INCREMENT increments. This is to avoid too many malloc calls. If this number is too large, probably time and memory is wasted. However, if it is too low, too many allocations happen which in turn, too, results in performance degradation. It should not be set to below 128 bytes. The default value of 1024 is a good estimate and works well with most processor page sizes. You should only change this value after you have thought a while over the implications. </td>
</tr>
</table>
<a name="a5" doxytag="config.h::STRINGBUF_TRIM_ALLOCSIZE"></a><p>
<table class="mdTable" width="100%" cellpadding="2" cellspacing="0">
<tr>
<td class="mdRow">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> #define STRINGBUF_TRIM_ALLOCSIZE 0
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
This is an important setting for the dynamic string object.
<p>
If set to 1, the dynamic string object trims the string to its maximum size once string processing is finished and the resulting string is returned to the caller. To do so, it needs to allocate a new buffer, copy the string over to that new buffer and then free the old one. If set to 0, the old (existing) buffer is simply returned. This will result in more memory being used (because the buffer most probably is a bit oversized), but it safes the extra processing time for the additional alloc, free and STRING COPY. We recommend using mode 0 for all environments, except when memory ressources are really constraint, in which case mode 1 should be selected. Do not use mode 1 unless you have a very good reason to do so! </td>
</tr>
</table>
<hr size="1"><address style="align: right;"><small>Generated on Mon Oct 3 12:29:56 2005 for liblogging by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border=0 >
</a>1.3.2 </small></address>
</body>
</html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-release
>
by-pkgid
>
e9fca32892116c2c27cf46145520942a
>
files
>
46
