Starting libdms.la

8 files changed, 509 insertions, 1 deletions

diff --git a/Makefile.am b/Makefile.am
index 1cc1bc1..a2e7189 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -39,17 +39,36 @@ DEFS					= -DLOCALEDIR="\"$(localedir)\"" @DEFS@
 
 
 # automake targets
-bin_PROGRAMS                            = src/bindump src/bitcopy src/bitops src/numconvert src/typedef-info
+bin_PROGRAMS                            = src/bindump src/bitcopy src/bitops src/dmsversion src/numconvert src/typedef-info
+include_HEADERS                         = include/dms.h
+lib_LTLIBRARIES                         = lib/libdms.la
 noinst_PROGRAMS                         =
 noinst_HEADERS                          = src/common.h
 man_MANS                                = doc/codetagger.1
 
+
+# macros for lib/libotadm.la
+lib_libdms_la_DEPENDENCIES              = Makefile lib/libdms.sym
+lib_libdms_la_CFLAGS                    = $(AM_CFLAGS)
+lib_libdms_la_LIBADD                    = $(AM_LIBS)
+lib_libdms_la_LDFLAGS                   = -rpath '$(libdir)' \
+                                          -version-info $(LIB_VERSION_INFO) \
+                                          $(AM_LDFLAGS) \
+                                          -pthread \
+                                          -export-symbols $(srcdir)/lib/libdms.sym
+lib_libdms_la_SOURCES                   = include/dms.h \
+                                          lib/libdms.h \
+                                          lib/libdms_version.c \
+                                          lib/libdms_version.h
+
+
 # macros for src/bindump
 src_bindump_DEPENDENCIES                = $(lib_LTLIBRARIES) Makefile
 src_bindump_CPPFLAGS                    = -DPROGRAM_NAME="\"bindump\"" $(AM_CPPFLAGS)
 src_bindump_SOURCES                     = $(noinst_HEADERS) \
                                           src/bindump.c
 
+
 # macros for src/bitops
 src_bitcopy_DEPENDENCIES                = $(lib_LTLIBRARIES) Makefile
 src_bitcopy_CPPFLAGS                    = -DPROGRAM_NAME="\"bitcopy\"" $(AM_CPPFLAGS)
@@ -74,6 +93,14 @@ bin_PROGRAMS += src/codetagger
 endif
 
 
+# macros for src/dmsversion
+src_dmsversion_DEPENDENCIES             = $(lib_LTLIBRARIES) Makefile
+src_dmsversion_CPPFLAGS                 = -DPROGRAM_NAME="\"dmsversion\"" $(AM_CPPFLAGS)
+src_dmsversion_LDADD                    = $(AM_LDADD) lib/libdms.la
+src_dmsversion_SOURCES                  = $(noinst_HEADERS) \
+                                          src/dmsversion.c
+
+
 # macros for src/numconvert
 src_numconvert_DEPENDENCIES             = $(lib_LTLIBRARIES) Makefile
 src_numconvert_CPPFLAGS                 = -DPROGRAM_NAME="\"numconvert\"" $(AM_CPPFLAGS)
@@ -119,6 +146,7 @@ XFAIL_TESTS				=
 EXTRA_DIST                              = build-aux/config.rpath \
                                           build-aux/git-package-version \
                                           include/gettext.h \
+                                          lib/libdms.sym \
                                           $(srcdir)/dmstools.tags \
                                           $(srcdir)/doc/Doxyfile \
                                           $(srcdir)/doc/codetagger.1.in \
diff --git a/include/dms.h b/include/dms.h
new file mode 100644
index 0000000..1c9a5dd
--- /dev/null
+++ b/include/dms.h
@@ -0,0 +1,142 @@
+/*
+ *  DMS Tools and Utilities
+ *  Copyright (C) 2010 David M. Syzdek <david@syzdek.net>.
+ *
+ *  @SYZDEK_LICENSE_HEADER_START@
+ *
+ *  This program is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License Version 2 as
+ *  published by the Free Software Foundation.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ *
+ *  @SYZDEK_LICENSE_HEADER_END@
+ */
+/**
+ *  @file lib/dms.h defines API for libdms.la
+ */
+#ifndef _DMS_H
+#define _DMS_H 1
+
+//////////////
+//          //
+//  Macros  //
+//          //
+//////////////
+
+/*
+ * The macros "BEGIN_C_DECLS" and "END_C_DECLS" are taken verbatim
+ * from section 7.1 of the Libtool 1.5.14 manual.
+ */
+/* BEGIN_C_DECLS should be used at the beginning of your declarations,
+   so that C++ compilers don't mangle their names. Use END_C_DECLS at
+   the end of C declarations. */
+#undef BEGIN_C_DECLS
+#undef END_C_DECLS
+#if defined(__cplusplus) || defined(c_plusplus)
+#   define BEGIN_C_DECLS  extern "C" {    ///< exports as C functions
+#   define END_C_DECLS    }               ///< exports as C functions
+#else
+#   define BEGIN_C_DECLS  /* empty */     ///< exports as C functions
+#   define END_C_DECLS    /* empty */     ///< exports as C functions
+#endif
+
+
+/*
+ * The macro "PARAMS" is taken verbatim from section 7.1 of the
+ * Libtool 1.5.14 manual.
+ */
+/* PARAMS is a macro used to wrap function prototypes, so that
+   compilers that don't understand ANSI C prototypes still work,
+   and ANSI C compilers can issue warnings about type mismatches. */
+#undef PARAMS
+#if defined (__STDC__) || defined (_AIX) \
+        || (defined (__mips) && defined (_SYSTYPE_SVR4)) \
+        || defined(WIN32) || defined (__cplusplus)
+# define PARAMS(protos) protos   ///< wraps function arguments in order to support ANSI C
+#else
+# define PARAMS(protos) ()       ///< wraps function arguments in order to support ANSI C
+#endif
+
+
+/*
+ * The following macro is taken verbatim from section 5.40 of the GCC
+ * 4.0.2 manual.
+ */
+#if __STDC_VERSION__ < 199901L
+# if __GNUC__ >= 2
+# define __func__ __FUNCTION__
+# else
+# define __func__ "<unknown>"
+# endif
+#endif
+
+
+// Exports function type
+#ifdef WIN32
+#   ifdef DMS_LIBS_DYNAMIC
+#      define DMS_F(type)   extern __declspec(dllexport) type   ///< used for library calls
+#      define DMS_V(type)   extern __declspec(dllexport) type   ///< used for library calls
+#   else
+#      define DMS_F(type)   extern __declspec(dllimport) type   ///< used for library calls
+#      define DMS_V(type)   extern __declspec(dllimport) type   ///< used for library calls
+#   endif
+#else
+#   ifdef DMS_LIBS_DYNAMIC
+#      define DMS_F(type)   type                                ///< used for library calls
+#      define DMS_V(type)   type                                ///< used for library calls
+#   else
+#      define DMS_F(type)   extern type                         ///< used for library calls
+#      define DMS_V(type)   extern type                         ///< used for library calls
+#   endif
+#endif
+
+
+///////////////
+//           //
+//  Headers  //
+//           //
+///////////////
+
+#include <inttypes.h>
+
+
+///////////////////
+//               //
+//  Definitions  //
+//               //
+///////////////////
+
+#define DMS_TRUE   0x01
+#define DMS_FALSE  0x00
+#define DMS_YES    0x01
+#define DMS_NO     0x00
+
+
+/////////////////
+//             //
+//  Datatypes  //
+//             //
+/////////////////
+
+
+//////////////////
+//              //
+//  Prototypes  //
+//              //
+//////////////////
+BEGIN_C_DECLS
+
+// returns version info string for library
+DMS_F(const char *) dms_version PARAMS((void));
+
+
+END_C_DECLS
+#endif /* end of header file */
\ No newline at end of file
diff --git a/lib/libdms.h b/lib/libdms.h
new file mode 100644
index 0000000..e1a7ea0
--- /dev/null
+++ b/lib/libdms.h
@@ -0,0 +1,87 @@
+/*
+ *  DMS Tools and Utilities
+ *  Copyright (C) 2010 David M. Syzdek <david@syzdek.net>.
+ *
+ *  @SYZDEK_LICENSE_HEADER_START@
+ *
+ *  This program is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License Version 2 as
+ *  published by the Free Software Foundation.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ *
+ *  @SYZDEK_LICENSE_HEADER_END@
+ */
+/**
+ *  @file lib/libdms.h internal directives for libdms.la
+ */
+#ifndef _OTADM_LIB_LIBDMS_H
+#define _OTADM_LIB_LIBDMS_H 1
+
+///////////////
+//           //
+//  Headers  //
+//           //
+///////////////
+
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <dms.h>
+
+
+///////////////////
+//               //
+//  Definitions  //
+//               //
+///////////////////
+
+#ifndef DMS_LIBS_DYNAMIC
+#define DMS_LIBS_DYNAMIC 1
+#endif
+
+#ifndef PACKAGE_TARNAME
+#define PACKAGE_TARNAME "dmstools"
+#endif
+
+#ifndef SYSCONFDIR
+#define SYSCONFDIR "/usr/local/etc"
+#endif
+
+#ifndef LIBEXECDIR
+#define LIBEXECDIR "/usr/local/libexec"
+#endif
+
+#ifndef MODULEDIR
+#define MODULEDIR "/usr/local/libexec/otadm"
+#endif
+
+
+///////////////////
+//               //
+//  i18l Support //
+//               //
+///////////////////
+
+#ifdef HAVE_GETTEXT
+#   include <gettext.h>
+#   include <libintl.h>
+#   define _(String) gettext (String)
+#   define gettext_noop(String) String
+#   define N_(String) gettext_noop (String)
+#else
+#   define _(String) (String)
+#   define N_(String) String
+#   define textdomain(Domain)
+#   define bindtextdomain(Package, Directory)
+#endif
+
+#endif /* end of header file */
diff --git a/lib/libdms.sym b/lib/libdms.sym
new file mode 100644
index 0000000..5334bd1
--- /dev/null
+++ b/lib/libdms.sym
@@ -0,0 +1,42 @@
+#
+#   DMS Tools and Utilities
+#   Copyright (C) 2010 David M. Syzdek <david@syzdek.net>.
+#
+#   @SYZDEK_LICENSE_HEADER_START@
+#
+#   This program is free software; you can redistribute it and/or modify
+#   it under the terms of the GNU General Public License Version 2 as
+#   published by the Free Software Foundation.
+# 
+#   This program is distributed in the hope that it will be useful,
+#   but WITHOUT ANY WARRANTY; without even the implied warranty of
+#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#   GNU General Public License for more details.
+#
+#   You should have received a copy of the GNU General Public License
+#   along with this program; if not, write to the Free Software
+#   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+#
+#   @SYZDEK_LICENSE_HEADER_END@
+#
+#   lib/libdms.sym - list of symbols to export in libdms.la
+#
+#   Build:
+#      CFLAGS="-g -O2 -W -Wall -Werror -I../include"
+#      LDFLAGS="-g -O2 -export-symbols libdms.sym -rpath /usr/local/lib"
+#      export CFLAGS LDFLAGS
+#
+#      libtool --mode=compile gcc ${CFLAGS}  -c libdms_version.c
+#      libtool --mode=link    gcc ${LDFLAGS} -o libdms.la libdms_version.lo
+#
+#   Install:
+#      libtool --mode=install install -c libotadm.la /usr/local/lib/libacs-utils.la
+#
+#   Uninstall:
+#      libtool --mode=uninstall rm -f /usr/local/lib/libdms.la
+#
+#   Clean:
+#      libtool --mode=clean rm -f libdms.la libdms_version.lo
+#
+dms_version
+# end of symbol export file
diff --git a/lib/libdms_version.c b/lib/libdms_version.c
new file mode 100644
index 0000000..1ce7745
--- /dev/null
+++ b/lib/libdms_version.c
@@ -0,0 +1,49 @@
+/*
+ *  DMS Tools and Utilities
+ *  Copyright (C) 2010 David M. Syzdek <david@syzdek.net>.
+ *
+ *  @SYZDEK_LICENSE_HEADER_START@
+ *
+ *  This program is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License Version 2 as
+ *  published by the Free Software Foundation.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ *
+ *  @SYZDEK_LICENSE_HEADER_END@
+ */
+/**
+ *  @file lib/dms_version.c functions for querying information about the library 
+ */
+#define _DMS_LIB_LIBDMS_VERSION_C 1
+#include "libdms_version.h"
+
+///////////////
+//           //
+//  Headers  //
+//           //
+///////////////
+
+#include "libdms.h"
+
+
+/////////////////
+//             //
+//  Functions  //
+//             //
+/////////////////
+
+/// returns version info string for library
+const char * dms_version(void)
+{
+   return("libdms.la (" PACKAGE_NAME ") " PACKAGE_VERSION);
+}
+
+/* end of source code */
diff --git a/lib/libdms_version.h b/lib/libdms_version.h
new file mode 100644
index 0000000..a9cd8a2
--- /dev/null
+++ b/lib/libdms_version.h
@@ -0,0 +1,28 @@
+/*
+ *  DMS Tools and Utilities
+ *  Copyright (C) 2010 David M. Syzdek <david@syzdek.net>.
+ *
+ *  @SYZDEK_LICENSE_HEADER_START@
+ *
+ *  This program is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License Version 2 as
+ *  published by the Free Software Foundation.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ *
+ *  @SYZDEK_LICENSE_HEADER_END@
+ */
+/**
+ *  @file lib/dms_version.h functions for querying information about the library 
+ */
+#ifndef _DMS_LIB_LIBDMS_VERSION_H
+#define _DMS_LIB_LIBDMS_VERSION_H 1
+
+#endif /* end of source code */
diff --git a/po/POTFILES.in b/po/POTFILES.in
index 2d0cfa4..a970934 100644
--- a/po/POTFILES.in
+++ b/po/POTFILES.in
@@ -1,9 +1,11 @@
 # List of source files which contain translatable strings.
+lib/libdms_version.c
 src/bindump.c
 src/bitcopy.c
 src/bitops.c
 src/codetagger.c
 src/common.h
+src/dmsversion.c
 src/numconvert.c
 src/posixregex.c
 src/typedef-info.c
diff --git a/src/dmsversion.c b/src/dmsversion.c
new file mode 100644
index 0000000..d95eaab
--- /dev/null
+++ b/src/dmsversion.c
@@ -0,0 +1,130 @@
+/*
+ *  DMS Tools and Utilities
+ *  Copyright (C) 2010 David M. Syzdek <david@syzdek.net>.
+ *
+ *  @SYZDEK_LICENSE_HEADER_START@
+ *
+ *  This program is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License Version 2 as
+ *  published by the Free Software Foundation.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ *
+ *  @SYZDEK_LICENSE_HEADER_END@
+ */
+/**
+ *  @file src/dmsversion.c displays library version
+ */
+/*
+ *  Simple Build:
+ *     gcc -W -Wall -O2 -c dmsversion.c
+ *     gcc -W -Wall -O2 -o dmsversion   dmsversion.o
+ *
+ *  GNU Libtool Build:
+ *     libtool --mode=compile gcc -W -Wall -g -O2 -c dmsversion.c
+ *     libtool --mode=link    gcc -W -Wall -g -O2 -o dmsversion dmsversion.lo
+ *
+ *  GNU Libtool Install:
+ *     libtool --mode=install install -c dmsversion /usr/local/bin/dmsversion
+ *
+ *  GNU Libtool Clean:
+ *     libtool --mode=clean rm -f dmsversion.lo dmsversion
+ */
+#define _DMS_SRC_DMSVERSION_C 1
+
+///////////////
+//           //
+//  Headers  //
+//           //
+///////////////
+
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <stdio.h>
+#include <dms.h>
+
+
+///////////////////
+//               //
+//  i18l Support //
+//               //
+///////////////////
+
+#ifdef HAVE_GETTEXT
+#   include <gettext.h>
+#   include <libintl.h>
+#   define _(String) gettext (String)
+#   define gettext_noop(String) String
+#   define N_(String) gettext_noop (String)
+#else
+#   define _(String) (String)
+#   define N_(String) String
+#   define textdomain(Domain)
+#   define bindtextdomain(Package, Directory)
+#endif
+
+
+///////////////////
+//               //
+//  Definitions  //
+//               //
+///////////////////
+
+#ifndef PROGRAM_NAME
+#define PROGRAM_NAME "dmsversion"
+#endif
+#ifndef PACKAGE_BUGREPORT
+#define PACKAGE_BUGREPORT "david@syzdek.net"
+#endif
+#ifndef PACKAGE_COPYRIGHT
+#define PACKAGE_COPYRIGHT ""
+#endif
+#ifndef PACKAGE_NAME
+#define PACKAGE_NAME ""
+#endif
+#ifndef PACKAGE_VERSION
+#define PACKAGE_VERSION ""
+#endif
+
+#ifndef PARAMS
+#define PARAMS(protos) protos
+#endif
+
+
+//////////////////
+//              //
+//  Prototypes  //
+//              //
+//////////////////
+
+// main statement
+int main(int argc, char * argv[]);
+
+
+//////////////////
+//              //
+//  Prototypes  //
+//              //
+//////////////////
+
+/// main statement
+/// @param[in] argc   number of arguments
+/// @param[in] argv   array of arguments
+int main(int argc, char * argv[])
+{
+   if (argc == -1)
+      printf("%s\n", argv[0]);
+   printf("%s\n", dms_version());
+   return(0);
+}
+
+// end of source file