ossp-pkg/l2/l2_ch_file.c
1.10
/*
** L2 - OSSP Logging Library
** Copyright (c) 2001 The OSSP Project (http://www.ossp.org/)
** Copyright (c) 2001 Cable & Wireless Deutschland (http://www.cw.com/de/)
**
** This file is part of OSSP L2, a flexible logging library which
** can be found at http://www.ossp.org/pkg/l2/.
**
** Permission to use, copy, modify, and distribute this software for
** any purpose with or without fee is hereby granted, provided that
** the above copyright notice and this permission notice appear in all
** copies.
**
** THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED 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 AUTHORS AND COPYRIGHT HOLDERS AND THEIR
** 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.
**
** l2_ch_file.c: file channel implementation
*/
#include "l2.h"
#include "l2_p.h"
#include <fcntl.h>
#include <unistd.h>
#include <sys/stat.h>
/* declare private channel configuration */
typedef struct {
int fd;
char *path;
int append;
long perm;
} l2_ch_file_t;
/* create channel */
static int hook_create(l2_context_t *ctx, l2_channel_t *ch)
{
l2_ch_file_t *cfg;
/* allocate private channel configuration */
if ((cfg = (l2_ch_file_t *)malloc(sizeof(l2_ch_file_t))) == NULL)
return L2_ERROR;
/* initialize configuration with reasonable defaults */
cfg->fd = -1;
cfg->path = NULL;
cfg->append = TRUE;
cfg->perm = (S_IRUSR|S_IWUSR|S_IRGRP|S_IROTH);
/* link private channel configuration into channel context */
ctx->vp = cfg;
return L2_OK;
}
/* configure channel */
static int hook_configure(l2_context_t *ctx, l2_channel_t *ch, const char *fmt, va_list ap)
{
l2_ch_file_t *cfg;
l2_param_t pa[4];
l2_result_t rv;
/* parameter checks */
if ((cfg = (l2_ch_file_t *)ctx->vp) == NULL)
return L2_ERROR;
/* feed and call generic parameter parsing engine */
L2_PARAM_SET(pa[0], path, CHARPTR, &cfg->path);
L2_PARAM_SET(pa[1], append, INT, &cfg->append);
L2_PARAM_SET(pa[2], perm, LONG, &cfg->perm);
L2_PARAM_END(pa[3]);
rv = l2_util_setparams(pa, fmt, ap);
return rv;
}
/* open channel */
static int hook_open(l2_context_t *ctx, l2_channel_t *ch)
{
l2_ch_file_t *cfg;
l2_channel_t *downstream;
int mode;
/* parameter checks */
if ((cfg = (l2_ch_file_t *)ctx->vp) == NULL)
return L2_ERROR;
if (cfg->path == NULL)
return L2_ERROR;
/* open channel file */
mode = O_WRONLY|O_CREAT;
if (cfg->append)
mode |= O_APPEND;
if ((cfg->fd = open(cfg->path, mode, cfg->perm)) == -1)
return L2_ERROR;
/* optionally open downstream channel, too */
if ((downstream = l2_channel_downstream(ch)) != NULL)
if (l2_channel_open(downstream) == L2_ERROR)
return L2_ERROR;
return L2_OK;
}
/* write to channel */
static int hook_write(l2_context_t *ctx, l2_channel_t *ch,
const char *buf, size_t buf_size)
{
l2_ch_file_t *cfg;
l2_channel_t *downstream;
/* parameter checks */
if ((cfg = (l2_ch_file_t *)ctx->vp) == NULL)
return L2_ERROR;
if (cfg->fd == -1)
return L2_ERROR;
/* write message to channel file */
if (write(cfg->fd, buf, buf_size) == -1)
return L2_ERROR;
/* optionally write to downstream channel, too */
if ((downstream = l2_channel_downstream(ch)) != NULL)
if (l2_channel_write(downstream, buf, buf_size) == L2_ERROR)
return L2_ERROR;
return L2_OK;
}
/* flush channel */
static int hook_flush(l2_context_t *ctx, l2_channel_t *ch)
{
l2_channel_t *downstream;
/* NOP for this channel, because Unix I/O files are unbuffered! */
/* optionally flush downstream channel, too */
if ((downstream = l2_channel_downstream(ch)) != NULL)
if (l2_channel_flush(downstream) == L2_ERROR)
return L2_ERROR;
return L2_OK;
}
/* close channel */
static int hook_close(l2_context_t *ctx, l2_channel_t *ch)
{
l2_ch_file_t *cfg;
l2_channel_t *downstream;
/* optionally close downstream channel, too */
if ((downstream = l2_channel_downstream(ch)) != NULL)
if (l2_channel_close(downstream) == L2_ERROR)
return L2_ERROR;
/* parameter checks */
if ((cfg = (l2_ch_file_t *)ctx->vp) == NULL)
return L2_ERROR;
if (cfg->fd == -1)
return L2_ERROR;
/* close channel file */
close(cfg->fd);
cfg->fd = -1;
return L2_OK;
}
/* destroy channel */
static int hook_destroy(l2_context_t *ctx, l2_channel_t *ch)
{
/* parameter checks */
if (ctx->vp == NULL)
return L2_ERROR;
/* destroy channel configuration */
free(ctx->vp);
return L2_OK;
}
/* exported channel handler structure */
l2_handler_t l2_handler_file = {
L2_CHANNEL_OUTPUT,
hook_create,
hook_configure,
hook_open,
hook_write,
hook_flush,
hook_close,
hook_destroy
};