Adding 'zcat' widget

7 files changed, 527 insertions, 5 deletions

diff --git a/Makefile.am b/Makefile.am
index cb9aa5c..5b49f13 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -105,7 +105,9 @@ src_securecoreutils_SOURCES		= $(include_HEADERS) \
                                           src/widget-rmdir.c \
                                           src/widget-rmdir.h \
                                           src/widget-tail.c \
-                                          src/widget-tail.h
+                                          src/widget-tail.h \
+                                          src/widget-zcat.c \
+                                          src/widget-zcat.h
 
 
 # Makefile includes
@@ -127,6 +129,7 @@ install-exec-local:
         ( cd $(DESTDIR)$(bindir); ln -sf securecoreutils secrm; )
         ( cd $(DESTDIR)$(bindir); ln -sf securecoreutils secrmdir; )
         ( cd $(DESTDIR)$(bindir); ln -sf securecoreutils sectail; )
+        ( cd $(DESTDIR)$(bindir); ln -sf securecoreutils seczcat; )
 
 
 install-data-local:
diff --git a/acinclude.m4 b/acinclude.m4
index b87030d..2a27829 100644
--- a/acinclude.m4
+++ b/acinclude.m4
@@ -34,4 +34,43 @@
 #   acinclude.m4 - custom m4 macros used by configure.ac
 #
 
+# AC_OPENVPN_LDAPCMD_COMPONENTS
+# ______________________________________________________________________________
+AC_DEFUN([AC_SCU_ZCAT_DEPS],[dnl
+
+   # check zlib
+   USE_ZLIB=yes;
+   AC_CHECK_HEADERS([zlib.h],      [], [USE_ZLIB=no])
+   AC_SEARCH_LIBS([gzclose],  [z], [], [USE_ZLIB=no])
+   AC_SEARCH_LIBS([gzerror],  [z], [], [USE_ZLIB=no])
+   AC_SEARCH_LIBS([gzopen],   [z], [], [USE_ZLIB=no])
+   AC_SEARCH_LIBS([gzread],   [z], [], [USE_ZLIB=no])
+   if test "x${USE_ZLIB}" = "xyes";then
+      AC_DEFINE_UNQUOTED(USE_ZLIB, 1, [Use zlib])
+   fi
+
+   # check bzip2
+   USE_BZIP2=yes;
+   AC_CHECK_HEADERS([bzlib.h],                   [], [USE_BZIP2=no])
+   AC_SEARCH_LIBS([BZ2_bzRead],           [bz2], [], [USE_BZIP2=no])
+   AC_SEARCH_LIBS([BZ2_bzReadClose],      [bz2], [], [USE_BZIP2=no])
+   AC_SEARCH_LIBS([BZ2_bzReadGetUnused],  [bz2], [], [USE_BZIP2=no])
+   AC_SEARCH_LIBS([BZ2_bzReadOpen],       [bz2], [], [USE_BZIP2=no])
+   if test "x${USE_BZIP2}" = "xyes";then
+      AC_DEFINE_UNQUOTED(USE_BZIP2, 1, [Use bzip2])
+   fi
+
+   AC_CHECK_PROG([USE_XZ], [xz], [yes], [no])
+   if test "x${USE_XZ}" = "xyes";then
+      AC_DEFINE_UNQUOTED(USE_XZ, 1, [Use xz])
+   fi
+
+   AC_CHECK_PROG([USE_Z], [uncompress], [yes], [no])
+   if test "x${USE_Z}" = "xyes";then
+      AC_DEFINE_UNQUOTED(USE_Z, 1, [Use uncompress])
+   fi
+
+])dnl
+
+
 # end of m4 file
diff --git a/configure.ac b/configure.ac
index b8f64bb..6429221 100644
--- a/configure.ac
+++ b/configure.ac
@@ -102,6 +102,38 @@ AM_PROG_LEX
 AC_PROG_LN_S
 
 
+# check for common functions
+AC_FUNC_FORK
+AC_FUNC_MALLOC
+AC_FUNC_REALLOC
+AC_FUNC_STRERROR_R
+
+# Type checks
+AC_TYPE_INT8_T
+AC_TYPE_INT16_T
+AC_TYPE_INT32_T
+AC_TYPE_INT64_T
+AC_TYPE_OFF_T
+AC_TYPE_SIZE_T
+AC_TYPE_SSIZE_T
+AC_TYPE_UID_T
+AC_TYPE_UINT8_T
+AC_TYPE_UINT16_T
+AC_TYPE_UINT32_T
+AC_TYPE_UINT64_T
+
+# check for required functions
+AC_CHECK_FUNCS([bzero],          [], [AC_MSG_ERROR([missing required functions])])
+AC_CHECK_FUNCS([memset],         [], [AC_MSG_ERROR([missing required functions])])
+AC_CHECK_FUNCS([rmdir],          [], [AC_MSG_ERROR([missing required functions])])
+AC_CHECK_FUNCS([strcasecmp],     [], [AC_MSG_ERROR([missing required functions])])
+AC_CHECK_FUNCS([strdup],         [], [AC_MSG_ERROR([missing required functions])])
+AC_CHECK_FUNCS([strerror],       [], [AC_MSG_ERROR([missing required functions])])
+
+# check for headers
+AC_CHECK_HEADERS([fcntl.h],     [], [AC_MSG_ERROR([missing required headers])])
+AC_CHECK_HEADERS([limits.h],    [], [AC_MSG_ERROR([missing required headers])])
+
 # GNU Libtool Support
 LT_INIT(dlopen disable-fast-install win32-dll)
 
@@ -116,6 +148,7 @@ AC_BINDLE_GIT_PACKAGE_VERSION([contrib/bindletools/build-aux/git-package-version
 
 # custom configure options
 AC_BINDLE_ENABLE_WARNINGS
+AC_SCU_ZCAT_DEPS
 
 
 # enables getopt_long if header and functions were found
@@ -132,6 +165,9 @@ AC_MSG_NOTICE([ ])
 AC_MSG_NOTICE([   Secure Core Utilities $GIT_PACKAGE_VERSION ($GIT_PACKAGE_BUILD)])
 AC_MSG_NOTICE([ ])
 AC_MSG_NOTICE([   Features:])
+AC_MSG_NOTICE([      zlib support:              $USE_ZLIB])
+AC_MSG_NOTICE([      bzip2 support:             $USE_BZIP2])
+AC_MSG_NOTICE([      xz support:                $USE_XZ])
 AC_MSG_NOTICE([ ])
 AC_MSG_NOTICE([   Please send suggestions to:   $PACKAGE_BUGREPORT])
 AC_MSG_NOTICE([ ])
diff --git a/securecoreutilities.xcodeproj/project.pbxproj b/securecoreutilities.xcodeproj/project.pbxproj
index 3ea0cf7..7d78de9 100644
--- a/securecoreutilities.xcodeproj/project.pbxproj
+++ b/securecoreutilities.xcodeproj/project.pbxproj
@@ -24,6 +24,9 @@
                 A005C1831EC8C6BD00A08403 /* widget-tail.c in Sources */ = {isa = PBXBuildFile; fileRef = A005C1811EC8BDAF00A08403 /* widget-tail.c */; };
                 A0446A211F0DABB4000085C7 /* widget-rm.c in Sources */ = {isa = PBXBuildFile; fileRef = A0446A1F1F0DA0F3000085C7 /* widget-rm.c */; };
                 A0446A241F0DC853000085C7 /* widget-rmdir.c in Sources */ = {isa = PBXBuildFile; fileRef = A0446A221F0DC7D2000085C7 /* widget-rmdir.c */; };
+                A0446A271F0DDF83000085C7 /* widget-zcat.c in Sources */ = {isa = PBXBuildFile; fileRef = A0446A251F0DDF78000085C7 /* widget-zcat.c */; };
+                A0446A2F1F0DFAEB000085C7 /* libz.tbd in Frameworks */ = {isa = PBXBuildFile; fileRef = A0446A2E1F0DFAEB000085C7 /* libz.tbd */; };
+                A0446A311F0E1EAA000085C7 /* libbz2.tbd in Frameworks */ = {isa = PBXBuildFile; fileRef = A0446A301F0E1EAA000085C7 /* libbz2.tbd */; };
                 A054C3DD1B0292930036591C /* securecoreutils.c in Sources */ = {isa = PBXBuildFile; fileRef = A054C3D71B0292930036591C /* securecoreutils.c */; };
                 A054C3DE1B0292930036591C /* widget-cat.c in Sources */ = {isa = PBXBuildFile; fileRef = A054C3D91B0292930036591C /* widget-cat.c */; };
                 A054C3DF1B0292930036591C /* widget-pathcheck.c in Sources */ = {isa = PBXBuildFile; fileRef = A054C3DB1B0292930036591C /* widget-pathcheck.c */; };
@@ -58,6 +61,12 @@
                 A0446A201F0DA0F3000085C7 /* widget-rm.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = "widget-rm.h"; sourceTree = "<group>"; };
                 A0446A221F0DC7D2000085C7 /* widget-rmdir.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = "widget-rmdir.c"; sourceTree = "<group>"; };
                 A0446A231F0DC7D2000085C7 /* widget-rmdir.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = "widget-rmdir.h"; sourceTree = "<group>"; };
+                A0446A251F0DDF78000085C7 /* widget-zcat.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = "widget-zcat.c"; sourceTree = "<group>"; };
+                A0446A261F0DDF78000085C7 /* widget-zcat.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = "widget-zcat.h"; sourceTree = "<group>"; };
+                A0446A2A1F0DF1D5000085C7 /* configure.ac */ = {isa = PBXFileReference; explicitFileType = text.script; fileEncoding = 4; path = configure.ac; sourceTree = "<group>"; };
+                A0446A2B1F0DF1D5000085C7 /* TODO */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text; path = TODO; sourceTree = "<group>"; };
+                A0446A2E1F0DFAEB000085C7 /* libz.tbd */ = {isa = PBXFileReference; lastKnownFileType = "sourcecode.text-based-dylib-definition"; name = libz.tbd; path = usr/lib/libz.tbd; sourceTree = SDKROOT; };
+                A0446A301F0E1EAA000085C7 /* libbz2.tbd */ = {isa = PBXFileReference; lastKnownFileType = "sourcecode.text-based-dylib-definition"; name = libbz2.tbd; path = usr/lib/libbz2.tbd; sourceTree = SDKROOT; };
                 A054C3A51B0292600036591C /* securecoreutilities */ = {isa = PBXFileReference; explicitFileType = "compiled.mach-o.executable"; includeInIndex = 0; path = securecoreutilities; sourceTree = BUILT_PRODUCTS_DIR; };
                 A054C3AD1B0292930036591C /* acinclude.m4 */ = {isa = PBXFileReference; explicitFileType = text.script; fileEncoding = 4; path = acinclude.m4; sourceTree = "<group>"; };
                 A054C3AE1B0292930036591C /* AUTHORS */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text; path = AUTHORS; sourceTree = "<group>"; };
@@ -84,12 +93,23 @@
                         isa = PBXFrameworksBuildPhase;
                         buildActionMask = 2147483647;
                         files = (
+                                A0446A311F0E1EAA000085C7 /* libbz2.tbd in Frameworks */,
+                                A0446A2F1F0DFAEB000085C7 /* libz.tbd in Frameworks */,
                         );
                         runOnlyForDeploymentPostprocessing = 0;
                 };
 /* End PBXFrameworksBuildPhase section */
 
 /* Begin PBXGroup section */
+                A0446A2D1F0DFAEB000085C7 /* Frameworks */ = {
+                        isa = PBXGroup;
+                        children = (
+                                A0446A301F0E1EAA000085C7 /* libbz2.tbd */,
+                                A0446A2E1F0DFAEB000085C7 /* libz.tbd */,
+                        );
+                        name = Frameworks;
+                        sourceTree = "<group>";
+                };
                 A054C3951B0291F50036591C = {
                         isa = PBXGroup;
                         children = (
@@ -97,15 +117,18 @@
                                 A054C3AE1B0292930036591C /* AUTHORS */,
                                 A054C3AF1B0292930036591C /* autogen.sh */,
                                 A054C3BC1B0292930036591C /* ChangeLog */,
+                                A0446A2A1F0DF1D5000085C7 /* configure.ac */,
                                 A054C3BD1B0292930036591C /* COPYING */,
                                 A054C3D31B0292930036591C /* Makefile.am */,
                                 A054C3D41B0292930036591C /* NEWS */,
                                 A054C3D51B0292930036591C /* README */,
+                                A0446A2B1F0DF1D5000085C7 /* TODO */,
                                 A054C3B01B0292930036591C /* build-aux */,
                                 A054C3BE1B0292930036591C /* include */,
                                 A054C3C31B0292930036591C /* m4 */,
                                 A054C3D61B0292930036591C /* src */,
                                 A054C3A61B0292600036591C /* Products */,
+                                A0446A2D1F0DFAEB000085C7 /* Frameworks */,
                         );
                         sourceTree = "<group>";
                 };
@@ -157,6 +180,8 @@
                                 A0446A231F0DC7D2000085C7 /* widget-rmdir.h */,
                                 A005C1811EC8BDAF00A08403 /* widget-tail.c */,
                                 A005C1821EC8BDAF00A08403 /* widget-tail.h */,
+                                A0446A251F0DDF78000085C7 /* widget-zcat.c */,
+                                A0446A261F0DDF78000085C7 /* widget-zcat.h */,
                         );
                         path = src;
                         sourceTree = "<group>";
@@ -241,6 +266,7 @@
                                 A0446A241F0DC853000085C7 /* widget-rmdir.c in Sources */,
                                 A054C3DE1B0292930036591C /* widget-cat.c in Sources */,
                                 A005C1831EC8C6BD00A08403 /* widget-tail.c in Sources */,
+                                A0446A271F0DDF83000085C7 /* widget-zcat.c in Sources */,
                                 A054C3DF1B0292930036591C /* widget-pathcheck.c in Sources */,
                                 A054C3DD1B0292930036591C /* securecoreutils.c in Sources */,
                                 A0446A211F0DABB4000085C7 /* widget-rm.c in Sources */,
@@ -273,6 +299,10 @@
                                 ENABLE_STRICT_OBJC_MSGSEND = YES;
                                 ENABLE_TESTABILITY = YES;
                                 GCC_NO_COMMON_BLOCKS = YES;
+                                GCC_PREPROCESSOR_DEFINITIONS = (
+                                        "USE_ZLIB=1",
+                                        "USE_BZIP2=1",
+                                );
                                 GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
                                 GCC_WARN_ABOUT_RETURN_TYPE = YES;
                                 GCC_WARN_UNDECLARED_SELECTOR = YES;
@@ -302,6 +332,10 @@
                                 CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
                                 ENABLE_STRICT_OBJC_MSGSEND = YES;
                                 GCC_NO_COMMON_BLOCKS = YES;
+                                GCC_PREPROCESSOR_DEFINITIONS = (
+                                        "USE_ZLIB=1",
+                                        "USE_BZIP2=1",
+                                );
                                 GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
                                 GCC_WARN_ABOUT_RETURN_TYPE = YES;
                                 GCC_WARN_UNDECLARED_SELECTOR = YES;
@@ -354,10 +388,6 @@
                                 GCC_DYNAMIC_NO_PIC = NO;
                                 GCC_NO_COMMON_BLOCKS = YES;
                                 GCC_OPTIMIZATION_LEVEL = 0;
-                                GCC_PREPROCESSOR_DEFINITIONS = (
-                                        "DEBUG=1",
-                                        "$(inherited)",
-                                );
                                 GCC_SYMBOLS_PRIVATE_EXTERN = NO;
                                 GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
                                 GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
diff --git a/src/securecoreutils.c b/src/securecoreutils.c
index 9576027..19504b9 100644
--- a/src/securecoreutils.c
+++ b/src/securecoreutils.c
@@ -57,6 +57,7 @@
 #include "widget-rm.h"
 #include "widget-rmdir.h"
 #include "widget-tail.h"
+#include "widget-zcat.h"
 
 
 //////////////////
@@ -114,6 +115,12 @@ const scu_widget scu_widget_map[] =
       "sectail",                                      // widget alias
       scu_widget_tail,                                // widget function
    },
+   {
+      "zcat",                                         // widget name
+      "Writes contents of file to standard out.",     // widget description
+      "seczcat",                                      // widget alias
+      scu_widget_zcat,                                // widget function
+   },
    { NULL, NULL, NULL, NULL }
 };
 
diff --git a/src/widget-zcat.c b/src/widget-zcat.c
new file mode 100644
index 0000000..6ae394d
--- /dev/null
+++ b/src/widget-zcat.c
@@ -0,0 +1,337 @@
+/*
+ *  Secure Core Utilities
+ *  Copyright (C) 2015 Bindle Binaries <syzdek@bindlebinaries.com>.
+ *
+ *  @BINDLE_BINARIES_BSD_LICENSE_START@
+ *
+ *  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 Bindle Binaries 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 BINDLE BINARIES 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.
+ *
+ *  @BINDLE_BINARIES_BSD_LICENSE_END@
+ */
+#include "widget-zcat.h"
+
+///////////////
+//           //
+//  Headers  //
+//           //
+///////////////
+#ifdef __SECURECOREUTILS_PMARK
+#pragma mark - Headers
+#endif
+
+#include <assert.h>
+#include <inttypes.h>
+#include <errno.h>
+#include <stdio.h>
+#include <string.h>
+#include <strings.h>
+#include <sys/types.h>
+#include <sys/uio.h>
+#include <sys/stat.h>
+#include <unistd.h>
+#include <fcntl.h>
+#include <stdlib.h>
+
+#ifdef USE_ZLIB
+#include <zlib.h>
+#endif
+
+#ifdef USE_BZIP2
+#include <bzlib.h>
+#endif
+
+
+/////////////////
+//             //
+//  Variables  //
+//             //
+/////////////////
+
+const uint8_t scm_magic_bz2[3]   = { 0x42, 0x5a, 0x68 };                   // tar.bz2
+const uint8_t scm_magic_gz[2]    = { 0x1f, 0x8b };                         // tar.gz
+const uint8_t scm_magic_lz4[4]   = { 0x04, 0x22, 0x4d, 0x18 };             // tar.lz4
+const uint8_t scm_magic_z_lzw[2] = { 0x1f, 0x9d };                         // tar.Z
+const uint8_t scm_magic_z_lzh[2] = { 0x1f, 0xa0 };                         // tar.Z
+const uint8_t scm_magic_xz[6]    = { 0xfd, 0x37, 0x7a, 0x58, 0x5a, 0x00 }; // tar.xz
+
+
+/////////////////
+//             //
+//  Functions  //
+//             //
+/////////////////
+#ifdef __SECURECOREUTILS_PMARK
+#pragma mark - Functions
+#endif
+
+int scu_widget_zcat(scu_config * cnf)
+{
+   int            fd;
+   int            c;
+   int            opt_index;
+   int            rc;
+   int            type;
+   uint8_t        magic[16];
+   ssize_t        len;
+
+   // getopt options
+   static char   short_opt[] = "+hqVv";
+   static struct option long_opt[] =
+   {
+      {"help",             no_argument,       NULL, 'h' },
+      {"quiet",            no_argument,       NULL, 'q' },
+      {"silent",           no_argument,       NULL, 'q' },
+      {"version",          no_argument,       NULL, 'V' },
+      {"verbose",          no_argument,       NULL, 'v' },
+      { NULL, 0, NULL, 0 }
+   };
+
+   assert(cnf != NULL);
+
+   type = 0;
+   bzero(magic, sizeof(magic));
+
+   while((c = getopt_long(cnf->argc, cnf->argv, short_opt, long_opt, &opt_index)) != -1)
+   {
+      switch(c)
+      {
+         case -1:       /* no more arguments */
+         case 0:        /* long options toggles */
+         break;
+
+         case 'h':
+         scu_widget_zcat_usage();
+         return(0);
+
+         case 's':
+         cnf->quiet = 1;
+         if ((cnf->verbose))
+         {
+            fprintf(stderr, "%s: %s: incompatible options\n", PROGRAM_NAME, cnf->widget->name);
+            fprintf(stderr, "Try `%s --help' for more information.\n", PROGRAM_NAME);
+            return(1);
+         };
+         break;
+
+         case 'V':
+         printf("%s widget\n", cnf->widget->name);
+         scu_version();
+         return(0);
+
+         case 'v':
+         cnf->verbose++;
+         if ((cnf->quiet))
+         {
+            fprintf(stderr, "%s: %s: incompatible options\n", PROGRAM_NAME, cnf->widget->name);
+            fprintf(stderr, "Try `%s %s --help' for more information.\n", PROGRAM_NAME, cnf->widget->name);
+            return(1);
+         };
+         break;
+
+         case '?':
+         fprintf(stderr, "Try `%s %s --help' for more information.\n", PROGRAM_NAME, cnf->widget->name);
+         return(1);
+
+         default:
+         fprintf(stderr, "%s: %s: unrecognized option `--%c'\n", PROGRAM_NAME, cnf->widget->name, c);
+         fprintf(stderr, "Try `%s %s --help' for more information.\n", PROGRAM_NAME, cnf->widget->name);
+         return(1);
+      };
+   };
+
+   if ((cnf->argc - optind) < 1)
+   {
+      fprintf(stderr, "%s: %s: missing required argument\n", PROGRAM_NAME, cnf->widget->name);
+      fprintf(stderr, "Try `%s %s --help' for more information.\n", PROGRAM_NAME, cnf->widget->name);
+      return(1);
+   };
+   if ((cnf->argc - optind) > 1)
+   {
+      fprintf(stderr, "%s: unrecognized argument `-- %s'\n", PROGRAM_NAME, cnf->argv[optind+1]);
+      fprintf(stderr, "Try `%s %s --help' for more information.\n", PROGRAM_NAME, cnf->widget->name);
+      return(1);
+   };
+
+   // checks file for restriction validations
+   if ((rc = scu_pathcheck(cnf->argv[optind], 0)) != 0)
+   {
+      fprintf(stderr, "%s: %s: %s\n", PROGRAM_NAME, cnf->widget->name, scu_strerror(rc));
+      return(1);
+   };
+
+   // read magic number
+   if ((fd = open(cnf->argv[optind], O_RDONLY)) == -1)
+   {
+      fprintf(stderr, "%s: %s: %s\n", PROGRAM_NAME, cnf->widget->name, strerror(errno));
+      return(1);
+   };
+   if ((len = read(fd, magic, sizeof(magic))) == -1)
+   {
+      fprintf(stderr, "%s: %s: %s\n", PROGRAM_NAME, cnf->widget->name, strerror(errno));
+      close(fd);
+      return(1);
+   };
+   close(fd);
+
+
+   // processes gzip file
+#ifdef USE_ZLIB
+   if (!( memcmp(magic, scm_magic_gz, sizeof(scm_magic_gz)) ))
+      return(scu_widget_zcat_gz(cnf));
+#endif
+
+#ifdef USE_BZIP2
+   if (!( memcmp(magic, scm_magic_bz2, sizeof(scm_magic_bz2)) ))
+      return(scu_widget_zcat_bz2(cnf));
+#endif
+
+#ifdef USE_XZ
+   if (!( memcmp(magic, scm_magic_xz, sizeof(scm_magic_xz)) ))
+      return(scu_widget_zcat_prog(cnf, "xz -cd"));
+#endif
+
+#ifdef USE_Z
+   if (!( memcmp(magic, scm_magic_z_lzw, sizeof(scm_magic_z_lzw)) ))
+      return(scu_widget_zcat_prog(cnf, "/usr/bin/uncompress -c"));
+   if (!( memcmp(magic, scm_magic_z_lzh, sizeof(scm_magic_z_lzh)) ))
+      return(scu_widget_zcat_prog(cnf, "/usr/bin/uncompress -c"));
+#endif
+
+   fprintf(stderr, "%s: %s: unable to determine compression algorithms\n", PROGRAM_NAME, cnf->widget->name);
+   return(1);
+}
+
+
+#ifdef USE_BZIP2
+int scu_widget_zcat_bz2(scu_config * cnf)
+{
+   int         bzerror;
+   char        buff[16384];
+   ssize_t     len;
+   FILE      * fs;
+   BZFILE    * bz2;
+
+   if ((fs = fopen(cnf->argv[optind], "r")) == NULL)
+   {
+      fprintf(stderr, "%s: %s: %s\n", PROGRAM_NAME, cnf->widget->name, strerror(errno));
+      return(1);
+   };
+
+   bz2 = BZ2_bzReadOpen(&bzerror, fs, 0, 1, NULL, 0);
+   if (bzerror != BZ_OK)
+   {
+      fprintf(stderr, "%s: %s: error with decompression\n", PROGRAM_NAME, cnf->widget->name);
+      BZ2_bzReadClose(&bzerror, bz2);
+      fclose(fs);
+      return(1);
+   };
+
+   while ((len = BZ2_bzRead(&bzerror, bz2, buff, sizeof(buff))) > 0)
+   {
+      if ((len = write(STDOUT_FILENO, buff, len)) == -1)
+      {
+         fprintf(stderr, "%s: %s: %s\n", PROGRAM_NAME, cnf->widget->name, strerror(errno));
+         BZ2_bzReadClose(&bzerror, bz2);
+         fclose(fs);
+         return(1);
+      };
+   };
+
+   BZ2_bzReadClose(&bzerror, bz2);
+   fclose(fs);
+
+   return(0);
+}
+#endif
+
+
+#ifdef USE_ZLIB
+int scu_widget_zcat_gz(scu_config * cnf)
+{
+   gzFile   gz;
+   char     buff[4096];
+   int      gzlen;
+   ssize_t  len;
+
+   errno = 0;
+
+   if ((gz = gzopen(cnf->argv[optind], "rb")) == NULL)
+   {
+      if (errno == 0)
+      {
+         fprintf(stderr, "%s: %s: insufficient memory\n", PROGRAM_NAME, cnf->widget->name);
+         return(1);
+      };
+   };
+
+   while((gzlen = gzread(gz, buff, sizeof(buff))) > 0)
+   {
+      if ((len = write(STDOUT_FILENO, buff, gzlen)) == -1)
+      {
+         fprintf(stderr, "%s: %s: %s\n", PROGRAM_NAME, cnf->widget->name, strerror(errno));
+         gzclose(gz);
+         return(1);
+      };
+   };
+   if (gzlen == -1)
+   {
+      fprintf(stderr, "%s: %s: %s\n", PROGRAM_NAME, cnf->widget->name, gzerror(gz, NULL));
+      gzclose(gz);
+      return(1);
+   };
+
+   gzclose(gz);
+
+   return(0);
+}
+#endif
+
+
+int scu_widget_zcat_prog(scu_config * cnf, const char * prog)
+{
+   char buff[2048];
+
+   bzero(buff, sizeof(buff));
+   snprintf(buff, sizeof(buff), "%s %s", prog, cnf->argv[optind]);
+
+   return(system(buff));
+}
+
+
+void scu_widget_zcat_usage(void)
+{
+   printf("Usage: %s zcat [OPTIONS] file\n", PROGRAM_NAME);
+   printf("       zcat [OPTIONS] file\n");
+   printf("       seczcat [OPTIONS] file\n");
+   printf("\n");
+   scu_usage_options();
+   printf("\n");
+   scu_usage_restrictions();
+   printf("\n");
+   return;
+}
+
+/* end of source */
diff --git a/src/widget-zcat.h b/src/widget-zcat.h
new file mode 100644
index 0000000..277cca9
--- /dev/null
+++ b/src/widget-zcat.h
@@ -0,0 +1,70 @@
+/*
+ *  Secure Core Utilities
+ *  Copyright (C) 2015 Bindle Binaries <syzdek@bindlebinaries.com>.
+ *
+ *  @BINDLE_BINARIES_BSD_LICENSE_START@
+ *
+ *  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 Bindle Binaries 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 BINDLE BINARIES 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.
+ *
+ *  @BINDLE_BINARIES_BSD_LICENSE_END@
+ */
+/**
+ *  @file securecoreutils.c
+ *  Secure Core Utils widget wrapper
+ */
+#ifndef __SRC_WIDGET_ZCAT_H
+#define __SRC_WIDGET_ZCAT_H 1
+
+
+///////////////
+//           //
+//  Headers  //
+//           //
+///////////////
+#ifdef __SECURECOREUTILS_PMARK
+#pragma mark - Headers
+#endif
+
+#include "securecoreutils.h"
+
+
+//////////////////
+//              //
+//  Prototypes  //
+//              //
+//////////////////
+#ifdef __TALLYMARK_PMARK
+#pragma mark -
+#endif
+
+int scu_widget_zcat(scu_config * cnf);
+int scu_widget_zcat_bz2(scu_config * cnf);
+int scu_widget_zcat_gz(scu_config * cnf);
+int scu_widget_zcat_prog(scu_config * cnf, const char * prog);
+
+void scu_widget_zcat_usage(void);
+
+#endif /* end of header */