path: root/support/dktools/dk-db2t.ctr

%%	options

copyright owner	=	Dirk Krause
copyright year	=	2016-xxxx
license		=	bsd



%%	module

/*
	Convert database to text, write to standard output.

	See help_text below.
*/

#include "dk4conf.h"

#include <stdio.h>

#if DK4_HAVE_STDLIB_H
#ifndef STDLIB_H_INCLUDED
#include <stdlib.h>
#define	STDLIB_H_INCLUDED 1
#endif
#endif

#if DK4_HAVE_UNISTD_H
#ifndef UNISTD_H_INCLUDED
#include <unistd.h>
#define	UNISTD_H_INCLUDED 1
#endif
#endif

#if DK4_HAVE_PROCESS_H
#ifndef PROCESS_H_INCLUDED
#include <process.h>
#define	PROCESS_H_INCLUDED 1
#endif
#endif

#if DK4_HAVE_IO_H
#ifndef IO_H_INCLUDED
#include <io.h>
#define IO_H_INCLUDED 1
#endif
#endif

#if DK4_HAVE_FCNTL_H
#ifndef FCNTL_H_INCLUDED
#include <fcntl.h>
#define FCNTL_H_INCLUDED 1
#endif
#endif

#if DK4_HAVE_SYS_TYPES_H
#ifndef SYS_TYPES_H_INCLUDED
#include <sys/types.h>
#define SYS_TYPES_H_INCLUDED 1
#endif
#endif

#if DK4_HAVE_SIGNAL_H
#ifndef SIGNAL_H_INCLUDED
#include <signal.h>
#define	SIGNAL_H_INCLUDED 1
#endif
#endif

#include "dk4const.h"
#include "dk4mem.h"
#include "dk4mema.h"
#include "dk4dbi.h"
#include "dk4dbit8.h"
#include "dk4dbitw.h"
#include "dk4dbit.h"
#include "dk4fput.h"
#include "dk4vers.h"
#include "dk4app.h"
#include "dk4aopt.h"
#include "dk4dbi.h"
#include "dk4dbit.h"
#include "dk4dbia.h"
#include "dk4maasz.h"



$!trace-include



/**	Options.
*/
static const dk4_option_specification_t dk_db2t_options[] = {
  { dkT('k'),	dkT("key-buffer-size"),		DK4_OPT_ARG_SIZE },
  { dkT('v'),   dkT("value-buffer-size"),	DK4_OPT_ARG_SIZE },
  { dkT('R'),	dkT("reset"),			DK4_OPT_ARG_NONE },
  { dkT('\0'),	dkT("verbose"),			DK4_OPT_ARG_NONE }
};



/**	Constant texts used by the program, not localized.
*/
const dkChar * const dk_db2t_kwnl[] = {
$!string-table	macro=dkT
#
#	0	Program group name
#
dktools
#
#	1	Help text file name
#
dk-db2t.txt
#
#	2	String table file name
#
dk-db2t.str
#
#	3	ERROR: Application startup failed!
#
ERROR: Application startup failed!\n
#
#	4 5	Preference names for key and value size.
#
text-db.key.max-size
text-db.value.max-size
#
#	6	Long option for verbose mode.
#
verbose
$!end
};



static const dkChar * const	dk_db2t_type_names[] = {
$!string-table	macro=dkT
bdb
ndbm
mem
$!end
};


static const dkChar * const	dk_db2t_kw_def[] = {
$!string-table	macro=dkT
#
#	0	Error: Failed to set up signal handlers!
#
Failed to set up signal handlers!
#
#	1	Error: Failed to restore previous signal handlers!
#
Failed to restore previous signal handlers!
#
#	2	Error: Failed to traverse database!
#
Failed to traverse database!
#
#	3	Error: At least one database name required!
#
At least one database name required!
#
#	4	Error: Write attempt to closed pipe!
#
Write attempt to closed pipe!
#
#	5	Error: Interrupted by SIGINT signal!
#
Interrupted by SIGINT signal!
#
#	6	Error: Failed to write text to standard output!
#
Failed to write text to standard output!
$!end
};



/**	Version text.
*/
static const dkChar version_text[] = {
  DKT_VERSION_DK
#if DK4_HAVE_DB_H		&& (DK4_CHAR_SIZE == 1)
  dkT(" bdb")
#endif
#if DK4_HAVE_NDBM_H		&& (DK4_CHAR_SIZE == 1)
  dkT(" ndbm")
#endif
  dkT(" mem")
};



/**	Short help text.
*/
static const dkChar * const	help_text[] = {
$!text	macro=dkT

dk-db2t - Show database as text
-------------------------------

dk-db2t [<options>] <database>

Options:

-k <size>	--key-size=<size>		Key buffer size.
-v <size>	--value-buffer-size=<size>	Value buffer size.
						Default for both: 256.
		--verbose			Show error message on SIGPIPE.

--help						Show short help text.
--manual					*** SHOW FULL MANUAL ***
--version					Show version information.
--license					Show license information.

$!end
};



/**	License conditions.
*/
static const dkChar * const	license_text[] = {
$!text	macro=dkT,preprocessor

This software uses code from the following projects, either directly or as
a library:

dktools		Dirk Krause's tools and libraries.
		See http://dktools.sourceforge.net/ for more information.
#if DK4_HAVE_DB_H		&& (DK4_CHAR_SIZE == 1)

Berkeley DB	Database library.
#endif
#if DK4_HAVE_ZLIB_H

zlib		Data compression library.
		See http://www.zlib.net/ for more information.
#endif
#if DK4_HAVE_BZLIB_H

bzip2		Data compression program and library.
		See http://www.bzip.org/ for more information.
#endif

All the licenses below apply to the program.
Licenses for used libraries are shown as found on my Scientific Linux 6.x
computer in the /usr/share/doc directory on 2015-04-01. Check the project
homepages of the used libraries for additional information and/or updated
license terms.


DK tools and libraries license
==============================
Copyright (c) 2016, Dirk Krause
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice,
  this list of conditions and the following disclaimer.
* 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.
* Neither the name of the Dirk Krause nor the names of contributors may be
  used to endorse or promote products derived from this software without
  specific prior written permission.

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.
#if DK4_HAVE_DB_H		&& (DK4_CHAR_SIZE == 1)


Berkeley DB license
===================
This package was debianized by Clint Adams <schizo@debian.org> on
Wed, 25 Jul 2007 20:37:51 +0700

It was downloaded from
http://www.oracle.com/technology/software/products/berkeley-db/db/index.html

Copyright and license:

The following is the license that applies to this copy of the Berkeley DB
software.  For a license to use the Berkeley DB software under conditions
other than those described here, or to purchase support for this software,
please contact Oracle at berkeleydb-info_us@oracle.com.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
/*
 * Copyright (c) 1990, 2010 Oracle and/or its affiliates.  All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. 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.
 * 3. Redistributions in any form must be accompanied by information on
 *    how to obtain complete source code for the DB software and any
 *    accompanying software that uses the DB software.  The source code
 *    must either be included in the distribution or be available for no
 *    more than the cost of distribution plus a nominal fee, and must be
 *    freely redistributable under reasonable conditions.  For an
 *    executable file, complete source code means the source code for all
 *    modules it contains.  It does not include source code for modules or
 *    files that typically accompany the major components of the operating
 *    system on which the executable file runs.
 *
 * THIS SOFTWARE IS PROVIDED BY ORACLE ``AS IS'' AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
 * NON-INFRINGEMENT, ARE DISCLAIMED.  IN NO EVENT SHALL ORACLE 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.
 */
/*
 * Copyright (c) 1990, 1993, 1994, 1995
 *	The Regents of the University of California.  All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. 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.
 * 3. Neither the name of the University nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE REGENTS 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 REGENTS 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.
 */
/*
 * Copyright (c) 1995, 1996
 *	The President and Fellows of Harvard University.  All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. 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.
 * 3. Neither the name of the University nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY HARVARD AND ITS 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 HARVARD OR ITS 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.
 */
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
/***
 * ASM: a very small and fast Java bytecode manipulation framework
 * Copyright (c) 2000-2005 INRIA, France Telecom
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. 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.
 * 3. Neither the name of the copyright holders nor the names of its
 *    contributors may be used to endorse or promote products derived from
 *    this software without specific prior written permission.
 *
 * 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.
 */
#endif
#if DK4_HAVE_ZLIB_H


Zlib license
============
(C) 1995-2004 Jean-loup Gailly and Mark Adler

This software is provided 'as-is', without any express or implied
warranty.  In no event will the authors be held liable for any damages
arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not
   claim that you wrote the original software. If you use this software
   in a product, an acknowledgment in the product documentation would be
   appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
   misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.

Jean-loup Gailly        Mark Adler
jloup@gzip.org          madler@alumni.caltech.edu
#endif
#if DK4_HAVE_BZLIB_H


Bzip2 and libbzip2 library license
==================================
This program, "bzip2", the associated library "libbzip2", and all
documentation, are copyright (C) 1996-2007 Julian R Seward.  All
rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

1. Redistributions of source code must retain the above copyright
   notice, this list of conditions and the following disclaimer.

2. The origin of this software must not be misrepresented; you must 
   not claim that you wrote the original software.  If you use this 
   software in a product, an acknowledgment in the product 
   documentation would be appreciated but is not required.

3. Altered source versions must be plainly marked as such, and must
   not be misrepresented as being the original software.

4. The name of the author may not be used to endorse or promote 
   products derived from this software without specific prior written 
   permission.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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.

Julian Seward, jseward@bzip.org
bzip2/libbzip2 version 1.0.5 of 10 December 2007
#endif
$!end
};



/**	Buffer for key text.
*/
static dkChar	keybuffer[1024];



/**	Buffer for value text.
*/
static dkChar	valuebuffer[1024];



/**	Localized keywords.
*/
static const dkChar * const	*dk_db2t_msg	=	dk_db2t_kw_def;



/**	Number of options in the dk_db2t_options array.
*/
static const size_t dk_db2t_sz_options =
sizeof(dk_db2t_options)/sizeof(dk4_option_specification_t);



/**	Number of keywords in the dk_db2t_msg array.
*/
static size_t	dk_db2t_sz_msg	=
(sizeof(dk_db2t_kw_def)/sizeof(DK4_PDKCHAR) - 1);



/**	Application structure.
*/
static	dk4_app_t	*app	=	NULL;



/**	Allocated buffer for key.
*/
static	dkChar		*akey	=	NULL;



/**	Allocated buffer for value.
*/
static	dkChar		*avalue	=	NULL;



/**	Pointer to key buffer to use.
*/
static	dkChar		*pkey	=	keybuffer;



/**	Pointer to value buffer to use.
*/
static	dkChar		*pvalue	=	valuebuffer;



/**	Key buffer size (number of dkChar).
*/
static	size_t		 keysz	=	DK4_SIZEOF(keybuffer,dkChar);



/**	Value buffer size (number of dkChar).
*/
static	size_t		 valsz	=	DK4_SIZEOF(valuebuffer,dkChar);



/**	Exit status code.
*/
static int	exval	=	EXIT_FAILURE;



/**	Flag: Write error occured.
*/
static int	we	=	0;



/**	Flag: Report SIGPIPE.
*/
static int	verbose	=	0;



#ifdef SIGPIPE
/**	Indicator: SIGPIPE signal received.
*/
static
DK4_VOLATILE
dk4_sig_atomic_t	sig_had_pipe	=	0;
#endif

/**	Indicator: SIGINT signal received.
*/
static
DK4_VOLATILE
dk4_sig_atomic_t	sig_had_int	=	0;

/**	Indicator: SIGTERM signal received.
*/
static
DK4_VOLATILE
dk4_sig_atomic_t	sig_had_term	=	0;



static
DK4_VOLATILE
dk4_sig_atomic_t *
sig_pass_pointer(DK4_VOLATILE dk4_sig_atomic_t *ptr)
{
  return ptr;
}



#ifdef SIGPIPE
/**	Handler for SIGPIPE signal.
	@param	signo	Signal number (always SIGPIPE, ignored).
*/
static
void
sig_handler_pipe(int signo)
{
  *sig_pass_pointer(&sig_had_pipe) = 1;
}
#endif



/**	Handler for SIGINT signal.
	@param	signo	Signal number (always SIGINT, ignored).
*/
static
void
sig_handler_int(int signo)
{
  *sig_pass_pointer(&sig_had_int) = 1;
}



/**	Handler for SIGTERM signal.
	@param	signo	Signal number (always SIGTERM, ignored).
*/
static
void
sig_handler_term(int signo)
{
  *sig_pass_pointer(&sig_had_term) = 1;
}



/**	Read value from volatile atomic type.
	This function is necessary as some compilers mis-optimize
	direct access to volatile variables (at least if you believe
	one of the coding standards).
	@param	ap	Pointer to volatile atomic variable.
	@return	Contents of the variable.
*/
static
dk4_sig_atomic_t
sig_read_atomic(DK4_VOLATILE dk4_sig_atomic_t *ap)
{
  return (*ap);
}



/**	Check whether we can continue or if a signal was received.
	@param	check_pipe	Flag: Check for occured SIGPIPE signal too.
	@return	1 if the program can continue, 0 if a signal was received.
*/
static
int
sig_can_continue(int check_pipe)
{
  int		back = 1;
#ifdef SIGPIPE
  if (0 != check_pipe) {
    if (0 != sig_read_atomic(&sig_had_pipe)) { back = 0; }
  }
#endif
  if (0 != sig_read_atomic(&sig_had_int )) { back = 0; }
  if (0 != sig_read_atomic(&sig_had_term)) { back = 0; }
  return back;
}



/**	Traverse simple database containing text.
	@param	obj	Object to modify during traversal.
	@param	k	Key text.
	@param	v	Value text.
	@return	1 on success, 0 on error (continue traversal),
		-1 on error (abort).
*/
static
int
dk_db2t_traverse(
  void		*obj,
  const dkChar	*k,
  const dkChar	*v
)
{
  int		 back	= 1;
  if (NULL != k) {
    if (NULL != v) {
      if (0 == dk4fputs(k, stdout, NULL)) {
        back = 0; we = 1;
      }
      if (0 == dk4fputc(dkT(' '), stdout, NULL)) {
        back = 0; we = 1;
      }
      if (0 == dk4fputs(v, stdout, NULL)) {
        back = 0; we = 1;
      }
      if (0 == dk4fputc(dkT('\n'), stdout, NULL)) {
        back = 0; we = 1;
      }
    } else {
      back = 0;
    }
  } else {
    back = 0;
  }
  return back;
}



/**	Run with allocated buffers.
*/
static
void
dk_db2t_run_with_buffers(void)
{
  dk4_er_t	 er;		/* Error report for size calculation */
  const dkChar	*fn;		/* File name */
  dk4_dbi_t	*dbiptr;	/* Database */
  size_t	 szbk;		/* Maximum key size in bytes */
  size_t	 szbv;		/* Maximum value size in bytes */
  int		 obj;		/* Dummy object for traversal */
  int		 xargc;		/* Number of command line arguments */
  int		 i;		/* Current command line arg index */
  int		 res;		/* Operation result */

  obj   = 0;
  xargc = dk4app_get_argc(app);
  if (0 < xargc) {
    exval = EXIT_SUCCESS;
    for (i = 0; ((i < xargc) && (0 != sig_can_continue(1))); i++) {
      fn = dk4app_get_argv(app, i);
      if (NULL != fn) {
        dk4error_init(&er);
	szbk = dk4ma_size_t_mul(keysz, sizeof(dkChar), &er);
	szbv = dk4ma_size_t_mul(valsz, sizeof(dkChar), &er);
	if (DK4_E_NONE == er.ec) {
          dbiptr = dk4dbi_open_sizes_app(fn, 0, 0, szbk, szbv, NULL, app);
	  if (NULL != dbiptr) {
	    res = dk4dbi_text_traverse(dbiptr, &obj, dk_db2t_traverse);
	    switch (res) {
	      case 1: {
	      } break;
	      case 0: {
	        exval = EXIT_FAILURE;
	      } break;
	      default: {
	        dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 2);
	        exval = EXIT_FAILURE;
	      } break;
	    }
	    dk4dbi_close(dbiptr, NULL);
	  } else {
	    exval = EXIT_FAILURE;
	  }
	} else {
	  /* ERROR: Size calculation overflow */
	  dk4app_log_base1(app, DK4_LL_ERROR, 82);
	  exval = EXIT_FAILURE;
	}
      } else {
        /* BUG: No such file name */
	exval = EXIT_FAILURE;
      }
    }
  } else {
    /* ERROR: Too few database names */
    dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 3);
	  
  }
}



/**	Run normally.
*/
static
void
dk_db2t_normal_run(void)
{
  size_t	 ks	= 0;
  size_t	 vs	= 0;
  size_t	 i	= 0;

  /*	Check for verbose mode.
  */
  if (0 != dk4app_opt_is_set_long(app, dk_db2t_kwnl[6], NULL)) {
    verbose = 1;
  }
  /*	Retrieve buffer sizes, allocate larger buffers if necessary.
  */
  if (0 != dk4app_opt_is_set_short(app, dkT('R'), NULL)) {
    if (0 != dk4app_pref_get_size(&i, app, dk_db2t_kwnl[4], 0)) {
      ks = i;
    }
    if (0 != dk4app_pref_get_size(&i, app, dk_db2t_kwnl[5], 0)) {
      vs = i;
    }
  }
  if (0 != dk4app_opt_is_set_short(app, dkT('k'), NULL)) {
    if (0 != dk4app_opt_get_size_short(&i, app, dkT('k'), NULL)) {
      ks = i;
    }
  }
  if (0 != dk4app_opt_is_set_short(app, dkT('v'), NULL)) {
    if (0 != dk4app_opt_get_size_short(&i, app, dkT('v'), NULL)) {
      vs = i;
    }
  }
  if (ks > keysz) {
    akey = dk4mem_new_app(dkChar,ks,app) ;
    if (NULL != akey) {
      pkey = akey;
      keysz = ks;
    } else {
      goto finished;
    }
  } else {
    if (0 < ks) {
      keysz = ks;
    }
  }
  if (vs > valsz) {
    avalue = dk4mem_new_app(dkChar,vs,app) ;
    if (NULL != avalue) {
      pvalue = avalue;
      valsz = vs;
    } else {
      goto finished;
    }
  } else {
    if (0 < vs) {
      valsz = vs;
    }
  }

  /*	Run either with static or allocated buffers.
  */
  dk_db2t_run_with_buffers();

  /*	Clean up, release larger buffers if allocated.
  */
  finished:
  dk4mem_release(akey) ;
  dk4mem_release(avalue) ;
}



#if	DK4_HAVE_SIGACTION
/**	Set signal handlers and run.
*/
static
void
dk_db2t_run_with_signal_handlers(void)
{
#ifdef SIGPIPE
  struct sigaction opipe;
#endif
  struct sigaction oint;
#ifdef SIGPIPE
  struct sigaction npipe;
#endif
  struct sigaction nint;
  struct sigaction oterm;
  struct sigaction nterm;
  int	 success = 0;

#ifdef SIGPIPE
  /*	Set up signal handling for SIGPIPE.
  */
  DK4_MEMRES(&npipe, sizeof(npipe));
  npipe.sa_handler = sig_handler_pipe;
  npipe.sa_flags = 0;
  if (0 != sigemptyset(&npipe.sa_mask)) {
    /* ERROR: Failed to set up masked signal set for SIGPIPE */
    dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 0);
    goto finished;
  }
  if (0 != sigaddset(&npipe.sa_mask, SIGPIPE)) {
    /* ERROR: Failed to set up masked signal set for SIGPIPE */
    dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 0);
    goto finished;
  }
  if (0 != sigaction(SIGPIPE, &npipe, &opipe)) {
    /* ERROR: Failed to set up signal handler for SIGPIPE */
    dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 0);
    goto finished;
  }
#endif

  /*	Set up signal handling for SIGINT.
  */
  DK4_MEMRES(&nint, sizeof(nint));
  nint.sa_handler = sig_handler_int;
  nint.sa_flags = 0;
  if (0 != sigemptyset(&nint.sa_mask)) {
    /* ERROR: Failed to set up masked signal set for SIGINT */
    dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 0);
    goto restore_old_pipe;
  }
  if (0 != sigaddset(&nint.sa_mask, SIGINT)) {
    /* ERROR: Failed to set up masked signal set for SIGINT */
    dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 0);
    goto restore_old_pipe;
  }
  if (0 != sigaction(SIGINT, &nint, &oint)) {
    /* ERROR: Failed to set up signal handler for SIGINT */
    dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 0);
    goto restore_old_pipe;
  }

  /*	Set up signal handling for SIGTERM
  */
  DK4_MEMRES(&nterm, sizeof(nterm));
  nterm.sa_handler = sig_handler_term;
  nterm.sa_flags = 0;
  if (0 != sigemptyset(&nterm.sa_mask)) {
    /* ERROR: Failed to set up masked signal set for SIGTERM */
    dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 0);
    goto restore_old_int;
  }
  if (0 != sigaddset(&nterm.sa_mask, SIGTERM)) {
    /* ERROR: Failed to set up masked signal set for SIGTERM */
    dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 0);
    goto restore_old_int;
  }
  if (0 != sigaction(SIGTERM, &nterm, &oterm)) {
    /* ERROR: Failed to set up signal handler for SIGTERM */
    dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 0);
    goto restore_old_int;
  }

  success = 1;
  dk_db2t_normal_run();

  /*	Restore signal handling for SIGTERM.
  */
  if (0 != sigaction(SIGTERM, &oterm, NULL)) {
    /* ERROR: Failed to restore old SIGTERM settings */
    dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 1);
    success = 0;
  }

  /*	Restore signal handling for SIGINT.
  */
  restore_old_int:
  if (0 != sigaction(SIGINT, &oint, NULL)) {
    /* ERROR: Failed to restore old SIGPIPE settings */
    dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 1);
    success = 0;
  }

#ifdef SIGPIPE
  /*	Restore signal handling for SIGPIPE.
  */
  restore_old_pipe:
  if (0 != sigaction(SIGPIPE, &opipe, NULL)) {
    /* ERROR: Failed to restore old SIGPIPE settings */
    dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 1);
    success = 0;
  }
#endif

  /*	Set exit status code if error occured.
  */
  finished:
  if (0 == success) { exval = EXIT_FAILURE; }
}
#else
#if	DK4_HAVE_SIGSET
/**	Set signal handlers and run.
*/
static
void
dk_db2t_run_with_signal_handlers(void)
{
#ifdef SIGPIPE
  dk4_sig_handler_t	*oldpipe = NULL;
#endif
  dk4_sig_handler_t	*oldint  = NULL;
  dk4_sig_handler_t	*oldterm = NULL;

#ifdef SIGPIPE
  oldpipe = sigset(SIGPIPE, sig_handler_pipe);
#endif
  oldint  = sigset(SIGINT,  sig_handler_int);
  oldterm = sigset(SIGTERM, sig_handler_term);
  dk_db2t_normal_run();
  sigset(SIGTERM, oldterm);
  sigset(SIGINT,  oldint);
#ifdef SIGPIPE
  sigset(SIGPIPE, oldpipe);
#endif
}
#else
#if	DK4_HAVE_SIGNAL
/**	Set signal handlers and run.
*/
static
void
dk_db2t_run_with_signal_handlers(void)
{
#ifdef SIGPIPE
  dk4_sig_handler_t	*oldpipe = NULL;
#endif
  dk4_sig_handler_t	*oldint  = NULL;
  dk4_sig_handler_t	*oldterm = NULL;

#ifdef SIGPIPE
  oldpipe = signal(SIGPIPE, sig_handler_pipe);
#endif
  oldint  = signal(SIGINT,  sig_handler_int);
  oldterm = signal(SIGTERM, sig_handler_term);
  dk_db2t_normal_run();
  signal(SIGTERM, oldterm);
  signal(SIGINT,  oldint);
#ifdef SIGPIPE
  signal(SIGPIPE, oldpipe);
#endif
}
#else
/**	Set signal handlers and run.
*/
static
void
dk_db2t_run_with_signal_handlers(void)
{
  dk_db2t_normal_run();
}
#endif
#endif
#endif


/**	Main function.
	@param	argc	Number of command line arguments.
	@param	argv	Command line arguments array.
	@return	0 on success, all other values indicate errors.
*/
#if DK4_CHAR_SIZE > 1
int wmain(int argc, wchar_t *argv[])
#else
int main(int argc, char *argv[])
#endif
{
  dk4_sig_atomic_t	shp	= 0;	/* Flag: Had SIGPIPE */
  $!trace-init dk-db2t.deb
  $? "+ main"
  dk4fput_initialize_stdout();
  dk4fput_initialize_stderr();
  app = dk4app_open_cmd(
    argc, argv,
    dk_db2t_options, dk_db2t_sz_options,
    dk_db2t_kwnl[0], version_text,
    dk_db2t_kwnl[1], help_text, license_text
  );
  if (NULL != app) {
    $? ". app"
    dk_db2t_sz_msg = dk4app_string_table_size(dk_db2t_kw_def);
    dk_db2t_msg    = dk4app_string_table(app, dk_db2t_kwnl[2], dk_db2t_kw_def);
    if (0 != dk4app_can_run_normally(app)) {
      $? ". can run normally"
      dk_db2t_run_with_signal_handlers();
#ifdef SIGPIPE
      shp = sig_read_atomic(&sig_had_pipe);
#endif
      if (0 != shp) {
        if (0 != verbose) {
          /* ERROR: Write attempt to closed pip */
          dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 4);
	}
	exval = EXIT_FAILURE;
      } else {
        if (0 != we) {
          /* ERROR: Failed writing output */
          dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 6);
	  exval = EXIT_FAILURE;
        }
      }
      if (0 != sig_read_atomic(&sig_had_int)) {
        /* ERROR: Aborted by SIGINT */
        dk4app_log_1(app, dk_db2t_msg, dk_db2t_sz_msg, DK4_LL_ERROR, 5);
	exval = EXIT_FAILURE;
      }
      if (0 != sig_read_atomic(&sig_had_term)) {
        exval = EXIT_FAILURE;
      }
    } else {
      $? ". can not run normally"
      if (0 != dk4app_help_version_license(app)) {
        exval = EXIT_SUCCESS;
      }
    }
    dk4app_close(app);
  } else {
    $? "! app"
    dk4fputs(dk_db2t_kwnl[3], stderr, NULL);
  }
  fflush(stdout);
  fflush(stderr);
  dk4fput_cleanup_stderr();
  dk4fput_cleanup_stdout();
  $? "- main %d", exval
  $!trace-end
  return (exval); exit(exval);
}