doc/posix-functions/getopt.texi

   1 @node getopt
   2 @section @code{getopt}
   3 @findex getopt
   4
   5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/getopt.html}
   6
   7 Gnulib module: getopt-posix or getopt-gnu
   8
   9 The module @code{getopt-gnu} has support for ``long options'' and for
  10 ``options that take optional arguments''.  Compared to the API defined by POSIX,
  11 it adds a header file @code{<getopt.h>} and a function @code{getopt_long}.
  12
  13 Portability problems fixed by either Gnulib module @code{getopt-posix} or @code{getopt-gnu}:
  14 @itemize
  15 @item
  16 The @code{getopt} function keeps some internal state that cannot be explicitly
  17 reset on some platforms:
  18 mingw.
  19 @item
  20 The value of @code{optind} after a missing required argument is wrong
  21 on some platforms:
  22 MacOS 10.5, AIX 7.1.
  23 @end itemize
  24
  25 Portability problems fixed by Gnulib module @code{getopt-gnu}:
  26 @itemize
  27 @item
  28 The function @code{getopt} does not support the @samp{+} flag in the options
  29 string on some platforms:
  30 MacOS X 10.5, AIX 5.2, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 11 2010-11.
  31 @item
  32 The function @code{getopt} does not obey the combination of @samp{+}
  33 and @samp{:} flags in the options string on some platforms:
  34 glibc 2.11.
  35 @item
  36 The function @code{getopt} does not obey the @samp{-} flag in the options
  37 string when @env{POSIXLY_CORRECT} is set on some platforms:
  38 Cygwin 1.7.0.
  39 @item
  40 The function @code{getopt} does not support options with optional arguments
  41 on some platforms:
  42 MacOS X 10.5, OpenBSD 4.0, AIX 5.2, HP-UX 11, IRIX 6.5, OSF/1 5.1,
  43 Solaris 11 2010-11, Cygwin 1.5.x.
  44 @item
  45 The function @code{getopt_long} is missing on some platforms:
  46 AIX 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 9, Interix 3.5.
  47 @item
  48 The function @code{getopt_long_only} is missing on some platforms:
  49 MacOS X 10.3, FreeBSD 5.2.1, NetBSD 5.0, AIX 5.1, HP-UX 11, IRIX 6.5,
  50 OSF/1 5.1, Solaris 9, mingw, Interix 3.5.
  51 @item
  52 This function crashes if the option string includes @code{W;} on some
  53 platforms:
  54 glibc 2.14.
  55 @end itemize
  56
  57 Portability problems not fixed by Gnulib:
  58 @itemize
  59 @item
  60 The default behavior of the glibc implementation of @code{getopt} allows
  61 mixing option and non-option arguments on the command line in any order.
  62 Other implementations, such as the one in Cygwin, enforce strict POSIX
  63 compliance: they require that the option arguments precede the non-option
  64 arguments.  This is something to watch out in your program's
  65 testsuite.
  66 @item
  67 The glibc implementation allows a complete reset of the environment,
  68 including re-checking for @env{POSIXLY_CORRECT}, by setting
  69 @code{optind} to 0.  Several BSD implementations provide @code{optreset},
  70 causing a reset by setting it non-zero, although it does not
  71 necessarily re-read @env{POSIXLY_CORRECT}.  Solaris @code{getopt} does
  72 not support either reset method, but does not maintain state that
  73 needs the extra level of reset.
  74 @item
  75 On some platforms, this function does not set the stream error
  76 indicator on attempts to write to a read-only stream:
  77 glibc 2.13, Cygwin 1.7.9.
  78 @end itemize