e2fsck/argv_parse.h

   1 /*
   2  * argv_parse.h --- header file for the argv parser.
   3  *
   4  * This file defines the interface for the functions argv_parse() and
   5  * argv_free().
   6  *
   7  ***********************************************************************
   8  * int argv_parse(char *in_buf, int *ret_argc, char ***ret_argv)
   9  *
  10  * This function takes as its first argument a string which it will
  11  * parse into an argv argument vector, with each white-space separated
  12  * word placed into its own slot in the argv.  This function handles
  13  * double quotes and backslashes so that the parsed words can contain
  14  * special characters.   The count of the number words found in the
  15  * parsed string, as well as the argument vector, are returned into
  16  * ret_argc and ret_argv, respectively.
  17  ***********************************************************************
  18  * extern void argv_free(char **argv);
  19  *
  20  * This function frees the argument vector created by argv_parse().
  21  ***********************************************************************
  22  *
  23  * Copyright 1999 by Theodore Ts'o.
  24  *
  25  * Permission to use, copy, modify, and distribute this software for
  26  * any purpose with or without fee is hereby granted, provided that
  27  * the above copyright notice and this permission notice appear in all
  28  * copies.  THE SOFTWARE IS PROVIDED "AS IS" AND THEODORE TS'O (THE
  29  * AUTHOR) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
  30  * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
  31  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
  32  * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
  33  * RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
  34  * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
  35  * IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.  (Isn't
  36  * it sick that the U.S. culture of lawsuit-happy lawyers requires
  37  * this kind of disclaimer?)
  38  *
  39  * Version 1.1, modified 2/27/1999
  40  */
  41
  42 extern int argv_parse(char *in_buf, int *ret_argc, char ***ret_argv);
  43 extern void argv_free(char **argv);