doc: od --strings: clarify operation
[coreutils.git] / src / nproc.c
blobf4e655946ff0e85409450dcb941d522c54f6bae8
1 /* nproc - print the number of processors.
2 Copyright (C) 2009-2023 Free Software Foundation, Inc.
4 This program is free software: you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation, either version 3 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program. If not, see <https://www.gnu.org/licenses/>. */
17 /* Written by Giuseppe Scrivano. */
19 #include <config.h>
20 #include <getopt.h>
21 #include <stdio.h>
22 #include <sys/types.h>
24 #include "system.h"
25 #include "error.h"
26 #include "nproc.h"
27 #include "quote.h"
28 #include "xdectoint.h"
30 /* The official name of this program (e.g., no 'g' prefix). */
31 #define PROGRAM_NAME "nproc"
33 #define AUTHORS proper_name ("Giuseppe Scrivano")
35 enum
37 ALL_OPTION = CHAR_MAX + 1,
38 IGNORE_OPTION
41 static struct option const longopts[] =
43 {"all", no_argument, NULL, ALL_OPTION},
44 {"ignore", required_argument, NULL, IGNORE_OPTION},
45 {GETOPT_HELP_OPTION_DECL},
46 {GETOPT_VERSION_OPTION_DECL},
47 {NULL, 0, NULL, 0}
50 void
51 usage (int status)
53 if (status != EXIT_SUCCESS)
54 emit_try_help ();
55 else
57 printf (_("Usage: %s [OPTION]...\n"), program_name);
58 fputs (_("\
59 Print the number of processing units available to the current process,\n\
60 which may be less than the number of online processors\n\
61 \n\
62 "), stdout);
63 fputs (_("\
64 --all print the number of installed processors\n\
65 --ignore=N if possible, exclude N processing units\n\
66 "), stdout);
68 fputs (HELP_OPTION_DESCRIPTION, stdout);
69 fputs (VERSION_OPTION_DESCRIPTION, stdout);
70 emit_ancillary_info (PROGRAM_NAME);
72 exit (status);
75 int
76 main (int argc, char **argv)
78 unsigned long nproc, ignore = 0;
79 initialize_main (&argc, &argv);
80 set_program_name (argv[0]);
81 setlocale (LC_ALL, "");
82 bindtextdomain (PACKAGE, LOCALEDIR);
83 textdomain (PACKAGE);
85 atexit (close_stdout);
87 enum nproc_query mode = NPROC_CURRENT_OVERRIDABLE;
89 while (true)
91 int c = getopt_long (argc, argv, "", longopts, NULL);
92 if (c == -1)
93 break;
94 switch (c)
96 case_GETOPT_HELP_CHAR;
98 case_GETOPT_VERSION_CHAR (PROGRAM_NAME, AUTHORS);
100 case ALL_OPTION:
101 mode = NPROC_ALL;
102 break;
104 case IGNORE_OPTION:
105 ignore = xdectoumax (optarg, 0, ULONG_MAX, "", _("invalid number"),0);
106 break;
108 default:
109 usage (EXIT_FAILURE);
113 if (argc != optind)
115 error (0, 0, _("extra operand %s"), quote (argv[optind]));
116 usage (EXIT_FAILURE);
119 nproc = num_processors (mode);
121 if (ignore < nproc)
122 nproc -= ignore;
123 else
124 nproc = 1;
126 printf ("%lu\n", nproc);
128 return EXIT_SUCCESS;