Simon Glass | 8a3e035 | 2012-02-15 15:51:16 -0800 | [diff] [blame] | 1 | /* |
| 2 | * Code for setting up command line flags like `./u-boot --help` |
| 3 | * |
| 4 | * Copyright (c) 2011 The Chromium OS Authors. |
| 5 | * |
| 6 | * Licensed under the GPL-2 or later. |
| 7 | */ |
| 8 | |
| 9 | #ifndef __SANDBOX_GETOPT_H |
| 10 | #define __SANDBOX_GETOPT_H |
| 11 | |
| 12 | struct sandbox_state; |
| 13 | |
| 14 | /* |
| 15 | * Internal structure for storing details about the flag. |
| 16 | * Most people should not have to dig around in this as |
| 17 | * it only gets parsed by the core sandbox code. End |
| 18 | * consumer code should focus on the macros below and |
| 19 | * the callback function. |
| 20 | */ |
Simon Glass | 64367c8 | 2013-12-03 16:43:23 -0700 | [diff] [blame] | 21 | struct sandbox_cmdline_option { |
Simon Glass | 8a3e035 | 2012-02-15 15:51:16 -0800 | [diff] [blame] | 22 | /* The long flag name: "help" for "--help" */ |
| 23 | const char *flag; |
| 24 | /* The (optional) short flag name: "h" for "-h" */ |
| 25 | int flag_short; |
| 26 | /* The help string shown to the user when processing --help */ |
| 27 | const char *help; |
| 28 | /* Whether this flag takes an argument */ |
| 29 | int has_arg; |
| 30 | /* Callback into the end consumer code with the option */ |
| 31 | int (*callback)(struct sandbox_state *state, const char *opt); |
| 32 | }; |
| 33 | |
| 34 | /* |
| 35 | * Internal macro to expand the lower macros into the necessary |
| 36 | * magic junk that makes this all work. |
| 37 | */ |
Simon Glass | 64367c8 | 2013-12-03 16:43:23 -0700 | [diff] [blame] | 38 | #define _SANDBOX_CMDLINE_OPT(f, s, ha, h) \ |
| 39 | static struct sandbox_cmdline_option sandbox_cmdline_option_##f = { \ |
Simon Glass | 8a3e035 | 2012-02-15 15:51:16 -0800 | [diff] [blame] | 40 | .flag = #f, \ |
| 41 | .flag_short = s, \ |
| 42 | .help = h, \ |
| 43 | .has_arg = ha, \ |
Simon Glass | 64367c8 | 2013-12-03 16:43:23 -0700 | [diff] [blame] | 44 | .callback = sandbox_cmdline_cb_##f, \ |
Simon Glass | 8a3e035 | 2012-02-15 15:51:16 -0800 | [diff] [blame] | 45 | }; \ |
| 46 | /* Ppointer to the struct in a special section for the linker script */ \ |
Marek BehĂșn | 4bebdd3 | 2021-05-20 13:23:52 +0200 | [diff] [blame] | 47 | static __used __section(".u_boot_sandbox_getopt") \ |
Simon Glass | 64367c8 | 2013-12-03 16:43:23 -0700 | [diff] [blame] | 48 | struct sandbox_cmdline_option \ |
| 49 | *sandbox_cmdline_option_##f##_ptr = \ |
| 50 | &sandbox_cmdline_option_##f |
Simon Glass | 8a3e035 | 2012-02-15 15:51:16 -0800 | [diff] [blame] | 51 | |
| 52 | /** |
| 53 | * Macros for end code to declare new command line flags. |
| 54 | * |
| 55 | * @param f The long flag name e.g. help |
| 56 | * @param ha Does the flag have an argument e.g. 0/1 |
| 57 | * @param h The help string displayed when showing --help |
| 58 | * |
| 59 | * This invocation: |
Simon Glass | 64367c8 | 2013-12-03 16:43:23 -0700 | [diff] [blame] | 60 | * SANDBOX_CMDLINE_OPT(foo, 0, "The foo arg"); |
Simon Glass | 8a3e035 | 2012-02-15 15:51:16 -0800 | [diff] [blame] | 61 | * Will create a new flag named "--foo" (no short option) that takes |
| 62 | * no argument. If the user specifies "--foo", then the callback func |
Simon Glass | 64367c8 | 2013-12-03 16:43:23 -0700 | [diff] [blame] | 63 | * sandbox_cmdline_cb_foo() will automatically be called. |
Simon Glass | 8a3e035 | 2012-02-15 15:51:16 -0800 | [diff] [blame] | 64 | */ |
Simon Glass | 64367c8 | 2013-12-03 16:43:23 -0700 | [diff] [blame] | 65 | #define SANDBOX_CMDLINE_OPT(f, ha, h) _SANDBOX_CMDLINE_OPT(f, 0, ha, h) |
Simon Glass | 8a3e035 | 2012-02-15 15:51:16 -0800 | [diff] [blame] | 66 | /* |
| 67 | * Same as above, but @s is used to specify a short flag e.g. |
Simon Glass | 64367c8 | 2013-12-03 16:43:23 -0700 | [diff] [blame] | 68 | * SANDBOX_CMDLINE_OPT(foo, 'f', 0, "The foo arg"); |
Simon Glass | 8a3e035 | 2012-02-15 15:51:16 -0800 | [diff] [blame] | 69 | */ |
Simon Glass | 64367c8 | 2013-12-03 16:43:23 -0700 | [diff] [blame] | 70 | #define SANDBOX_CMDLINE_OPT_SHORT(f, s, ha, h) _SANDBOX_CMDLINE_OPT(f, s, ha, h) |
Simon Glass | 8a3e035 | 2012-02-15 15:51:16 -0800 | [diff] [blame] | 71 | |
| 72 | #endif |