blob: 014226a26238bc2d55c424ed75e3fa3c7447dce9 [file] [log] [blame]
Andrea Falcone1c4977f2020-07-23 10:58:25 -04001/* $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
51struct 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 */
72int 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 */
77int 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 */
84extern int optreset;
85#endif
86
87__END_DECLS