add new code to support cmdline args and the config directory.

src/include/ZMap/zmapCmdLineArgs.h

+/*  File: zmapCmdLineArgs.h
+ *  Author: Ed Griffiths (edgrif@sanger.ac.uk)
+ *  Copyright (c) Sanger Institute, 2005
+ *-------------------------------------------------------------------
+ * ZMap is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ * 
+ * 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ * or see the on-line version at http://www.gnu.org/copyleft/gpl.txt
+ *-------------------------------------------------------------------
+ * This file is part of the ZMap genome database package
+ * originated by
+ * 	Ed Griffiths (Sanger Institute, UK) edgrif@sanger.ac.uk,
+ *      Roy Storey (Sanger Institute, UK) rds@sanger.ac.uk,
+ *      Rob Clack (Sanger Institute, UK) rnc@sanger.ac.uk
+ *
+ * Description: Interface to retrieve command line args given to the
+ *              program.
+ *
+ * HISTORY:
+ * Last edited: Feb 10 16:09 2005 (edgrif)
+ * Created: Mon Feb  7 08:19:50 2005 (edgrif)
+ * CVS info:   $Id: zmapCmdLineArgs.h,v 1.1 2005-02-10 16:31:15 edgrif Exp $
+ *-------------------------------------------------------------------
+ */
+#ifndef ZMAP_CMDLINEARGS_H
+#define ZMAP_CMDLINEARGS_H
+
+#include <glib.h>
+
+
+/* These are all the keywords that can be used as command line option flags (e.g. --start) */
+#define ZMAPARG_SEQUENCE_START "start"
+#define ZMAPARG_SEQUENCE_END   "end"
+#define ZMAPARG_CONFIG_FILE    "conf_file"
+#define ZMAPARG_CONFIG_DIR     "conf_dir"
+
+
+/* The value (if any) for the command line option is returned in this union.
+ * NOTE that since the code that uses the option _must_ know what sort of data it is, ther
+ * is no type field here to record which member of the union is valid. */
+typedef union
+{
+  gboolean b ;
+  int i ;
+  char *s ;
+  double f ;
+} ZMapCmdLineArgsType ;
+
+
+/* There is no context here because these commands create a global context for the whole
+ * application so there is no point in returning it from the create. */
+void zMapCmdLineArgsCreate(int argc, char *argv[]) ;
+gboolean zMapCmdLineArgsValue(char *arg_name, ZMapCmdLineArgsType *result) ;
+char *zMapCmdLineFinalArg(void) ;
+void zMapCmdLineArgsDestroy(void) ;
+
+
+#endif /* !ZMAP_CMDLINEARGS_H */
+

src/include/ZMap/zmapConfigDir.h

+/*  File: zmapConfigDir.h
+ *  Author: Ed Griffiths (edgrif@sanger.ac.uk)
+ *  Copyright (c) Sanger Institute, 2005
+ *-------------------------------------------------------------------
+ * ZMap is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ * 
+ * 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ * or see the on-line version at http://www.gnu.org/copyleft/gpl.txt
+ *-------------------------------------------------------------------
+ * This file is part of the ZMap genome database package
+ * originated by
+ * 	Ed Griffiths (Sanger Institute, UK) edgrif@sanger.ac.uk,
+ *      Roy Storey (Sanger Institute, UK) rds@sanger.ac.uk,
+ *      Rob Clack (Sanger Institute, UK) rnc@sanger.ac.uk
+ *
+ * Description: Interface to get/set ZMap configuration directory
+ *              and files.
+ *
+ * HISTORY:
+ * Last edited: Feb 10 16:10 2005 (edgrif)
+ * Created: Thu Feb 10 10:33:49 2005 (edgrif)
+ * CVS info:   $Id: zmapConfigDir.h,v 1.1 2005-02-10 16:31:16 edgrif Exp $
+ *-------------------------------------------------------------------
+ */
+#ifndef ZMAP_CONFIGDIR_H
+#define ZMAP_CONFIGDIR_H
+
+
+/* Default config directory name (in users home directory). */
+#define ZMAP_USER_CONFIG_DIR    ".ZMap"
+
+/* Default configuration file name within configuration directory. */
+#define ZMAP_USER_CONFIG_FILE   "ZMap"
+
+
+/* There is no context here because these commands create a global context for the whole
+ * application so there is no point in returning it from the create. */
+gboolean zMapConfigDirCreate(char *config_dir, char *config_file) ;
+const char *zMapConfigDirDefaultName(void) ;
+char *zMapConfigDirGetDir(void) ;
+char *zMapConfigDirGetFile(void) ;
+char *zMapConfigDirFindFile(char *filename) ;
+void zMapConfigDirDestroy(void) ;
+
+#endif /* !ZMAP_CONFIGDIR_H */
+

src/zmapUtils/zmapCmdLineArgs.c

+/*  File: zmapCmdLineArgs.c
+ *  Author: Ed Griffiths (edgrif@sanger.ac.uk)
+ *  Copyright (c) Sanger Institute, 2005
+ *-------------------------------------------------------------------
+ * ZMap is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ * 
+ * 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ * or see the on-line version at http://www.gnu.org/copyleft/gpl.txt
+ *-------------------------------------------------------------------
+ * This file is part of the ZMap genome database package
+ * originated by
+ * 	Ed Griffiths (Sanger Institute, UK) edgrif@sanger.ac.uk,
+ *      Roy Storey (Sanger Institute, UK) rds@sanger.ac.uk,
+ *      Rob Clack (Sanger Institute, UK) rnc@sanger.ac.uk
+ *
+ * Description: Creates a global object that contains command line
+ *              args, the init function should be called once at 
+ *              application start up. The object is accessed via a
+ *              global reference. The code is not thread safe.
+ *
+ * Exported functions: See ZMap/zmapCmdLine.h
+ * HISTORY:
+ * Last edited: Feb 10 15:38 2005 (edgrif)
+ * Created: Fri Feb  4 18:24:37 2005 (edgrif)
+ * CVS info:   $Id: zmapCmdLineArgs.c,v 1.1 2005-02-10 16:31:50 edgrif Exp $
+ *-------------------------------------------------------------------
+ */
+
+#include <stdlib.h>
+#include <glib.h>
+#include <ZMap/zmapUtils.h>
+#include <zmapCmdLineArgs_P.h>
+
+
+
+gboolean checkForCmdLineSequenceArgs(int argc, char *argv[],
+				     char **sequence_out, int *start_out, int *end_out) ;
+static void makeContext(int argc, char *argv[]) ;
+static void makePoptContext(ZMapCmdLineArgs arg_context) ;
+void setPoptArgPtr(char *arg_name, void *value_ptr) ;
+void setPoptValPtr(char *arg_name, int new_val) ;
+struct poptOption *findPoptEntry(char *arg_name) ;
+
+
+static ZMapCmdLineArgs arg_context_G = NULL ;
+
+
+
+/* The context is only created the first time this function is called, after that
+ * it just returns a reference to the existing context.
+ * 
+ * Note that as this routine should be called once per application it is not
+ * thread safe, it could be made so but is overkill as the GUI/master thread is
+ * not thread safe anyway.
+ * 
+ *  */
+void zMapCmdLineArgsCreate(int argc, char *argv[])
+{
+  static ZMapCmdLineArgs arg_context = NULL ;
+
+  zMapAssert(!arg_context_G) ;
+
+  zMapAssert(argc >= 1 && argv) ;
+
+  makeContext(argc, argv) ;
+
+  return ;
+}
+
+
+
+char *zMapCmdLineFinalArg(void)
+{
+  char *final_arg = NULL ;
+  ZMapCmdLineArgs arg_context ;
+
+  zMapAssert(arg_context_G) ;
+  arg_context = arg_context_G ;
+
+  if (arg_context->sequence_arg)
+    final_arg = arg_context->sequence_arg ;
+
+  return final_arg ;
+}
+
+
+
+gboolean zMapCmdLineArgsValue(char *arg_name, ZMapCmdLineArgsType *result)
+{
+  gboolean val_set = FALSE ;
+  gboolean found ;
+  ZMapCmdLineArgs arg_context ;
+  struct poptOption *options_table, *option ;
+
+  zMapAssert(arg_name && result) ;
+
+  zMapAssert(arg_context_G) ;
+  arg_context = arg_context_G ;
+
+  options_table = arg_context->options_table ;
+  found = FALSE ;
+  while (!found && options_table->argInfo != 0)
+    {
+      option = options_table->arg ;
+
+      while (!found && option->longName != NULL)
+	{
+
+	  if (strcmp(arg_name, option->longName) == 0)
+	    {
+	      found = TRUE ;
+
+	      if (option->val == ARG_SET)
+		{
+		  if (option->argInfo == POPT_ARG_INT)
+		    result->i = *((int *)option->arg) ;
+		  else if (option->argInfo == POPT_ARG_DOUBLE)
+		    result->f = *((double *)option->arg) ;
+		  else if (option->argInfo == POPT_ARG_STRING)
+		    result->s = *((char **)option->arg) ;
+		  else if (option->argInfo == POPT_ARG_NONE)
+		    result->b = *((gboolean *)option->arg) ;
+		  else
+		    zMapAssert("bad coding") ;
+
+		  val_set = TRUE ;
+		}
+	    }
+
+	  option++ ;
+	}
+
+      options_table++ ;
+    }
+
+  return val_set ;
+}
+
+
+/* 
+ * 
+ * 
+ *  */
+void zMapCmdLineArgsDestroy(void)
+{
+  ZMapCmdLineArgs arg_context ;
+
+  zMapAssert(arg_context_G) ;
+  arg_context = arg_context_G ;
+
+  arg_context->opt_context = poptFreeContext(arg_context->opt_context) ;
+
+  g_free(arg_context) ;
+
+  return ;
+}
+
+
+
+
+/* 
+ *                     Internal routines. 
+ * 
+ */
+
+
+static void makeContext(int argc, char *argv[])
+{
+  ZMapCmdLineArgs arg_context ;
+
+  arg_context_G = arg_context = g_new0(ZMapCmdLineArgsStruct, 1) ;
+  arg_context->argc = argc ;
+  arg_context->argv = argv ;
+
+  /* Set default values. */
+  arg_context->start = -1 ;
+  arg_context->end = -1 ;
+  arg_context->config_file_path = arg_context->config_dir = NULL ;
+
+  makePoptContext(arg_context) ;
+
+  return ;
+}
+
+
+/* Note that long args must be specified as:   --opt=arg  -opt1=arg  etc. */
+static void makePoptContext(ZMapCmdLineArgs arg_context)
+{
+  /* These are global tables in the sense that options for all parts of the program are registered
+   * here. We could have a really fancy system where subcomponents of the code register their
+   * flags/args but that introduces its own problems and seems not worth it for this application.
+   * Note that they are static because we need to look in the tables to retrieve values later. */
+  static struct poptOption sequenceOptionsTable[] =
+    {
+      {ZMAPARG_SEQUENCE_START, '\0', POPT_ARG_INT, NULL, ARG_START,
+       "Start coord in sequence, must be in range 1 -> seq_length.", "coord"},
+      {ZMAPARG_SEQUENCE_END, '\0', POPT_ARG_INT, NULL, ARG_END,
+       "End coord in sequence, must be in range start -> seq_length, "
+       "but end == 0 means show to end of sequence.", "coord"},
+      POPT_TABLEEND
+    } ;
+  static struct poptOption configFileOptionsTable[] =
+    {
+      {ZMAPARG_CONFIG_FILE, '\0', POPT_ARG_STRING, NULL, ARG_CONF_FILE,
+       "Relative or full path to configuration file.", "file_path"},
+      {ZMAPARG_CONFIG_DIR, '\0', POPT_ARG_STRING, NULL, ARG_CONF_DIR,
+       "Relative or full path to configuration directory.", "directory"},
+      POPT_TABLEEND
+    } ;
+  static struct poptOption options_table[] =
+    {
+      {NULL, '\0', POPT_ARG_INCLUDE_TABLE,  NULL, 0,
+       "Sequence Args", NULL },
+      {NULL, '\0', POPT_ARG_INCLUDE_TABLE,  NULL, 0,
+       "Config File Args", NULL },
+      POPT_AUTOHELP
+      POPT_TABLEEND
+    } ;
+  int popt_rc = 0 ;
+
+
+  /* Set up the options tables....try this statically now ?? */
+  options_table[0].arg = sequenceOptionsTable ;
+  options_table[1].arg = configFileOptionsTable ;
+  arg_context->options_table = options_table ;
+
+
+  /* Fill all the stuff that STUPID ANSI-C can't manage. */
+  setPoptArgPtr(ZMAPARG_SEQUENCE_START, &arg_context->start) ;
+  setPoptArgPtr(ZMAPARG_SEQUENCE_END, &arg_context->end) ;
+  setPoptArgPtr(ZMAPARG_CONFIG_FILE, &arg_context->config_file_path) ;
+  setPoptArgPtr(ZMAPARG_CONFIG_DIR, &arg_context->config_dir) ;
+
+
+  /* Create the context. */
+  arg_context->opt_context = poptGetContext(NULL, arg_context->argc,
+					    (const char **)arg_context->argv, options_table, 0) ;
+
+  /* Parse the arguments recording which ones actually get set. */
+  while ((popt_rc = poptGetNextOpt(arg_context->opt_context)) > 0)
+    {
+      switch (popt_rc)
+	{
+	case ARG_START:
+	  setPoptValPtr(ZMAPARG_SEQUENCE_START, ARG_SET) ;
+	  break ;
+	case ARG_END:
+	  setPoptValPtr(ZMAPARG_SEQUENCE_END, ARG_SET) ;
+	  break ;
+	case ARG_CONF_FILE:
+	  setPoptValPtr(ZMAPARG_CONFIG_FILE, ARG_SET) ;
+	  break ;
+	case ARG_CONF_DIR:
+	  setPoptValPtr(ZMAPARG_CONFIG_DIR, ARG_SET) ;
+	  break ;
+	default:
+	  zMapAssert("coding error, bad popt value") ;
+	break ;
+	}
+    }
+
+
+  /* Check for errors or final args on command line. */
+  if (popt_rc < -1)
+    {
+      fprintf(stderr, "%s: bad argument %s: %s\n",
+	      *(arg_context->argv),
+	      poptBadOption(arg_context->opt_context, POPT_BADOPTION_NOALIAS),
+	      poptStrerror(popt_rc)) ;
+
+      /* Don't bother cleaning up, just exit.... */
+      exit(EXIT_FAILURE) ;
+    }
+  else /* if (popt_rc == -1) */
+    {
+      /* record the last arg if any.... */
+      arg_context->sequence_arg = (char *)poptGetArg(arg_context->opt_context) ;
+    }
+
+
+  return ;
+}
+
+
+/* Set the address of a variable to receive the option value. */
+void setPoptArgPtr(char *arg_name, void *value_ptr)
+{
+  struct poptOption *option ;
+
+  option = findPoptEntry(arg_name) ;
+
+  option->arg = value_ptr ;
+
+  return ;
+}
+
+
+/* Set the val field, perhaps to indicate a value was/was not set. */
+void setPoptValPtr(char *arg_name, int new_val)
+{
+  struct poptOption *option ;
+
+  option = findPoptEntry(arg_name) ;
+
+  option->val = new_val ;
+
+  return ;
+}
+
+
+/* Find the named entry in the popt table. */
+struct poptOption *findPoptEntry(char *arg_name)
+{
+  ZMapCmdLineArgs arg_context ;
+  struct poptOption *options_table, *option ;
+  gboolean found ;
+
+
+  zMapAssert(arg_name) ;
+
+  zMapAssert(arg_context_G) ;
+  arg_context = arg_context_G ;
+
+  options_table = arg_context->options_table ;
+  found = FALSE ;
+  while (!found && options_table->argInfo != 0)
+    {
+      option = options_table->arg ;
+
+      while (!found && option->longName != NULL)
+	{
+	  if (strcmp(arg_name, option->longName) == 0)
+	    found = TRUE ;
+	  else
+	    option++ ;
+	}
+
+      options_table++ ;
+    }
+
+  return option ;
+}
+

src/zmapUtils/zmapCmdLineArgs_P.h

+/*  File: zmapCmdLineArgs_P.h
+ *  Author: Ed Griffiths (edgrif@sanger.ac.uk)
+ *  Copyright (c) Sanger Institute, 2005
+ *-------------------------------------------------------------------
+ * ZMap is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ * 
+ * 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ * or see the on-line version at http://www.gnu.org/copyleft/gpl.txt
+ *-------------------------------------------------------------------
+ * This file is part of the ZMap genome database package
+ * originated by
+ * 	Ed Griffiths (Sanger Institute, UK) edgrif@sanger.ac.uk,
+ *      Roy Storey (Sanger Institute, UK) rds@sanger.ac.uk,
+ *      Rob Clack (Sanger Institute, UK) rnc@sanger.ac.uk
+ *
+ * Description: Internals for command line parsing.
+ *
+ * HISTORY:
+ * Last edited: Feb 10 15:19 2005 (edgrif)
+ * Created: Fri Feb  4 19:11:23 2005 (edgrif)
+ * CVS info:   $Id: zmapCmdLineArgs_P.h,v 1.1 2005-02-10 16:31:50 edgrif Exp $
+ *-------------------------------------------------------------------
+ */
+#ifndef ZMAP_CMDLINEARGS_P_H
+#define ZMAP_CMDLINEARGS_P_H
+
+#include <popt.h>
+#include <ZMap/zmapCmdLineArgs.h>
+
+
+
+enum {ARG_SET = 1,					    /* Special value, do not alter. */
+      ARG_START, ARG_END,
+      ARG_CONF_FILE, ARG_CONF_DIR} ;
+
+
+
+typedef struct _ZMapCmdLineArgsStruct
+{
+  /* The original argc/argv passed in. */
+  int argc ;
+  char **argv ;
+
+  struct poptOption *options_table ;
+
+  poptContext opt_context ;
+
+  /* This holds the final argument on the command line which is the sequence name. */
+  char *sequence_arg ;
+
+  /* All option values are stored here for later reference. */
+  int start, end ;
+
+  char *config_dir ;
+  char *config_file_path ;
+} ZMapCmdLineArgsStruct, *ZMapCmdLineArgs ;
+
+
+
+
+
+#endif /* !ZMAP_CMDLINEARGS_P_H */
+

src/zmapUtils/zmapConfigDir.c

+/*  File: zmapConfigDir.c
+ *  Author: Ed Griffiths (edgrif@sanger.ac.uk)
+ *  Copyright (c) Sanger Institute, 2005
+ *-------------------------------------------------------------------
+ * ZMap is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ * 
+ * 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ * or see the on-line version at http://www.gnu.org/copyleft/gpl.txt
+ *-------------------------------------------------------------------
+ * This file is part of the ZMap genome database package
+ * originated by
+ * 	Ed Griffiths (Sanger Institute, UK) edgrif@sanger.ac.uk,
+ *      Roy Storey (Sanger Institute, UK) rds@sanger.ac.uk,
+ *      Rob Clack (Sanger Institute, UK) rnc@sanger.ac.uk
+ *
+ * Description: 
+ *
+ * Exported functions: See ZMap/zmapConfigDir.h
+ * HISTORY:
+ * Last edited: Feb 10 14:10 2005 (edgrif)
+ * Created: Thu Feb 10 10:05:36 2005 (edgrif)
+ * CVS info:   $Id: zmapConfigDir.c,v 1.1 2005-02-10 16:31:50 edgrif Exp $
+ *-------------------------------------------------------------------
+ */
+
+#include <glib.h>
+#include <ZMap/zmapUtils.h>
+#include <zmapConfigDir_P.h>
+
+
+
+
+
+
+static ZMapConfigDir dir_context_G = NULL ;
+
+
+
+/* The context is only created the first time this function is called, after that
+ * it just returns a reference to the existing context.
+ * 
+ * Note that as this routine should be called once per application it is not
+ * thread safe, it could be made so but is overkill as the GUI/master thread is
+ * not thread safe anyway.
+ * 
+ * If config_dir is NULL, the default ~/.ZMap directory is used.
+ * If config_file is NULL, the default ZMap file is used. 
+ * 
+ * returns FALSE if the configuration directory does not exist/read/writeable.
+ * 
+ *  */
+gboolean zMapConfigDirCreate(char *config_dir, char *config_file)
+{
+  gboolean result = FALSE ;
+  ZMapConfigDir dir_context = NULL ;
+  gboolean home_relative = FALSE, make_dir = FALSE ;
+
+  zMapAssert(!dir_context_G) ;
+
+  dir_context_G = dir_context = g_new0(ZMapConfigDirStruct, 1) ;
+
+  if (!config_dir)
+    {
+      config_dir = ZMAP_USER_CONFIG_DIR ;
+      home_relative = TRUE ;
+    }
+
+  if (!config_file)
+    config_file = ZMAP_USER_CONFIG_FILE ;
+     
+  if ((dir_context->config_dir = zMapGetDir(config_dir, home_relative, make_dir))
+      && (dir_context->config_file = zMapGetFile(dir_context->config_dir, config_file, FALSE)))
+    result = TRUE ;
+
+
+  return result ;
+}
+
+
+
+#ifdef ED_G_NEVER_INCLUDE_THIS_CODE
+/* Is this needed ?? */
+
+char *zMapConfigDirSetConfigFile(char *config_file)
+{
+  char *config_path ;
+  ZMapConfigDir dir_context = dir_context_G ;
+
+  zMapAssert(dir_context) ;
+
+
+
+  config_path = dir_context->config__dir ;
+
+  return config_dir ;
+}
+#endif /* ED_G_NEVER_INCLUDE_THIS_CODE */
+
+
+
+
+/* Not sure if this is really necessary....maybe.... */
+/* DO NOT FREE THE RESULTING STRING...COPY IF NEED BE.... */
+const char *zMapConfigDirDefaultName(void)
+{
+  char *dir_name = ZMAP_USER_CONFIG_DIR ;
+
+  return dir_name ;
+}
+
+
+
+char *zMapConfigDirGetDir(void)
+{
+  char *config_dir ;
+  ZMapConfigDir dir_context = dir_context_G ;
+
+  zMapAssert(dir_context) ;
+
+  config_dir = dir_context->config_dir ;
+
+  return config_dir ;
+}
+
+
+char *zMapConfigDirGetFile(void)
+{
+  char *config_file ;
+  ZMapConfigDir dir_context = dir_context_G ;
+
+  zMapAssert(dir_context) ;
+
+  config_file = dir_context->config_file ;
+
+  return config_file ;
+}
+
+
+char *zMapConfigDirFindFile(char *filename)
+{
+  char *file_path = NULL ;
+  ZMapConfigDir dir_context = dir_context_G ;
+
+  zMapAssert(dir_context) ;
+
+  file_path = zMapGetFile(dir_context->config_dir, filename, FALSE) ;
+
+  return file_path ;
+}
+
+
+
+char *zMapConfigDirFindDir(char *directory_in)
+{
+  char *control_dir ;
+
+  control_dir = zMapGetDir(directory_in, TRUE, FALSE) ;
+
+  return control_dir ;
+}
+
+
+
+void zMapConfigDirDestroy(void)
+{
+  ZMapConfigDir dir_context = dir_context_G ;
+
+  zMapAssert(dir_context) ;
+
+  g_free(dir_context->config_dir) ;
+
+  g_free(dir_context) ;
+
+  return ;
+}
+
+

src/zmapUtils/zmapConfigDir_P.h

+/*  File: zmapConfigDir_P.h
+ *  Author: Ed Griffiths (edgrif@sanger.ac.uk)
+ *  Copyright (c) Sanger Institute, 2005
+ *-------------------------------------------------------------------
+ * ZMap is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License
+ * as published by the Free Software Foundation; either version 2
+ * of the License, or (at your option) any later version.
+ * 
+ * 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
+ * or see the on-line version at http://www.gnu.org/copyleft/gpl.txt
+ *-------------------------------------------------------------------
+ * This file is part of the ZMap genome database package
+ * originated by
+ * 	Ed Griffiths (Sanger Institute, UK) edgrif@sanger.ac.uk,
+ *      Roy Storey (Sanger Institute, UK) rds@sanger.ac.uk,
+ *      Rob Clack (Sanger Institute, UK) rnc@sanger.ac.uk
+ *
+ * Description: 
+ *
+ * Exported functions: See XXXXXXXXXXXXX.h
+ * HISTORY:
+ * Last edited: Feb 10 13:50 2005 (edgrif)
+ * Created: Thu Feb 10 10:10:27 2005 (edgrif)
+ * CVS info:   $Id: zmapConfigDir_P.h,v 1.1 2005-02-10 16:31:50 edgrif Exp $
+ *-------------------------------------------------------------------
+ */
+#ifndef ZMAP_CONFIGDIR_P_H
+#define ZMAP_CONFIGDIR_P_H
+
+#include <ZMap/zmapConfigDir.h>
+
+
+typedef struct _ZMapConfigDirStruct
+{
+  char *default_dir ;
+
+  char *config_dir ;
+
+  char *config_file ;
+} ZMapConfigDirStruct, *ZMapConfigDir ;
+
+
+
+#endif /* !ZMAP_CONFIGDIR_P_H */