1 /* $NetBSD: getopt.h,v 1.4 2000/07/07 10:43:54 ad Exp $ */ 2 /* $FreeBSD$ */ 3 4 /*- 5 * Copyright (c) 2000 The NetBSD Foundation, Inc. 6 * All rights reserved. 7 * 8 * This code is derived from software contributed to The NetBSD Foundation 9 * by Dieter Baron and Thomas Klausner. 10 * 11 * Redistribution and use in source and binary forms, with or without 12 * modification, are permitted provided that the following conditions 13 * are met: 14 * 1. Redistributions of source code must retain the above copyright 15 * notice, this list of conditions and the following disclaimer. 16 * 2. Redistributions in binary form must reproduce the above copyright 17 * notice, this list of conditions and the following disclaimer in the 18 * documentation and/or other materials provided with the distribution. 19 * 20 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 22 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 23 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 24 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 25 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 26 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 30 * POSSIBILITY OF SUCH DAMAGE. 31 */ 32 33 #pragma once 34 35 /** 36 * @file getopt.h 37 * @brief The getopt() and getopt_long() functions. 38 */ 39 40 #include <sys/cdefs.h> 41 42 #include <bits/getopt.h> 43 44 /** A `has_arg` value for `struct option`. */ 45 #define no_argument 0 46 /** A `has_arg` value for `struct option`. */ 47 #define required_argument 1 48 /** A `has_arg` value for `struct option`. */ 49 #define optional_argument 2 50 51 struct option { 52 /** Name of long option. */ 53 const char *name; 54 55 /** 56 * One of `no_argument`, `required_argument`, or `optional_argument`. 57 */ 58 int has_arg; 59 60 /** If not NULL, set `*flag` to val when option found. */ 61 int* flag; 62 63 /** If `flag` not NULL, the value to assign to `*flag`; otherwise the return value. */ 64 int val; 65 }; 66 67 __BEGIN_DECLS 68 69 /** 70 * [getopt_long(3)](http://man7.org/linux/man-pages/man3/getopt.3.html) parses command-line options. 71 */ 72 int getopt_long(int __argc, char* const* __argv, const char* __options, const struct option* __long_options, int* __long_index); 73 74 /** 75 * [getopt_long_only(3)](http://man7.org/linux/man-pages/man3/getopt.3.html) parses command-line options. 76 */ 77 int getopt_long_only(int __argc, char* const* __argv, const char* __options, const struct option* __long_options, int* __long_index); 78 79 #ifndef _OPTRESET_DECLARED 80 #define _OPTRESET_DECLARED 81 /** 82 * Must be set to 1 to reset the `getopt` functions before scanning a new argument vector. 83 */ 84 extern int optreset; 85 #endif 86 87 __END_DECLS 88