1 /* xargs -- build and execute command lines from standard input
2 Copyright (C) 1990, 91, 92, 93, 94, 2000, 2003, 2005 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 2, or (at your option)
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, write to the Free Software
16 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
20 /* Written by Mike Rendell <michael@cs.mun.ca>
21 and David MacKenzie <djm@gnu.org>.
30 # if defined PROTOTYPES || (defined __STDC__ && __STDC__)
31 # define PARAMS(Args) Args
33 # define PARAMS(Args) ()
39 #if !defined (isascii) || defined (STDC_HEADERS)
47 #define ISBLANK(c) (isascii (c) && isblank (c))
49 #define ISBLANK(c) ((c) == ' ' || (c) == '\t')
52 #define ISSPACE(c) (ISBLANK (c) || (c) == '\n' || (c) == '\r' \
53 || (c) == '\f' || (c) == '\v')
55 #include <sys/types.h>
61 #if defined(STDC_HEADERS)
65 #if defined(HAVE_STRING_H) || defined(STDC_HEADERS)
67 #if !defined(STDC_HEADERS)
72 #define memcpy(dest, source, count) (bcopy((source), (dest), (count)))
76 #include <sys/param.h>
84 #define LONG_MAX (~(1 << (sizeof (long) * 8 - 1)))
87 /* The presence of unistd.h is assumed by gnulib these days, so we
88 * might as well assume it too.
94 #if !defined(SIGCHLD) && defined(SIGCLD)
95 #define SIGCHLD SIGCLD
100 /* States for read_line. */
116 # include <libintl.h>
117 # define _(Text) gettext (Text)
119 # define _(Text) Text
120 #define textdomain(Domain)
121 #define bindtextdomain(Package, Directory)
124 # define N_(String) gettext_noop (String)
126 /* See locate.c for explanation as to why not use (String) */
127 # define N_(String) String
130 #include "buildcmd.h"
133 /* Return nonzero if S is the EOF string. */
134 #define EOF_STR(s) (eof_str && *eof_str == *s && !strcmp (eof_str, s))
136 extern char **environ
;
138 /* Do multibyte processing if multibyte characters are supported,
139 unless multibyte sequences are search safe. Multibyte sequences
140 are search safe if searching for a substring using the byte
141 comparison function 'strstr' gives no false positives. All 8-bit
142 encodings and the UTF-8 multibyte encoding are search safe, but
143 the EUC encodings are not.
144 BeOS uses the UTF-8 encoding exclusively, so it is search safe. */
146 # define MULTIBYTE_IS_SEARCH_SAFE 1
148 #define DO_MULTIBYTE (HAVE_MBLEN && ! MULTIBYTE_IS_SEARCH_SAFE)
154 /* Simulate mbrlen with mblen as best we can. */
155 # define mbstate_t int
156 # define mbrlen(s, n, ps) mblen (s, n)
160 /* Not char because of type promotion; NeXT gcc can't handle it. */
172 #include "closeout.h"
174 void error
PARAMS ((int status
, int errnum
, char *message
,...));
176 extern char *version_string
;
178 /* The name this program was run with. */
181 static FILE *input_stream
;
183 /* Buffer for reading arguments from input. */
184 static char *linebuf
;
186 static int keep_stdin
= 0;
188 /* Line number in stdin since the last command was executed. */
189 static int lineno
= 0;
191 static struct buildcmd_state bc_state
;
192 static struct buildcmd_control bc_ctl
;
195 /* If nonzero, when this string is read on stdin it is treated as
197 IEEE Std 1003.1, 2004 Edition allows this to be NULL.
198 In findutils releases up to and including 4.2.8, this was "_".
200 static char *eof_str
= NULL
;
202 /* Number of chars in the initial args. */
203 /* static int initial_argv_chars = 0; */
205 /* true when building up initial arguments in `cmd_argv'. */
206 static boolean initial_args
= true;
208 /* If nonzero, the maximum number of child processes that can be running
210 static int proc_max
= 1;
212 /* Total number of child processes that have been executed. */
213 static int procs_executed
= 0;
215 /* The number of elements in `pids'. */
216 static int procs_executing
= 0;
218 /* List of child processes currently executing. */
219 static pid_t
*pids
= NULL
;
221 /* The number of allocated elements in `pids'. */
222 static int pids_alloc
= 0;
224 /* Exit status; nonzero if any child process exited with a
226 volatile static int child_error
= 0;
228 volatile static int original_exit_value
;
230 /* If true, print each command on stderr before executing it. */
231 static boolean print_command
= false; /* Option -t */
233 /* If true, query the user before executing each command, and only
234 execute the command if the user responds affirmatively. */
235 static boolean query_before_executing
= false;
237 /* The delimiter for input arguments. This is only consulted if the
238 * -0 or -d option had been given.
240 static char input_delimiter
= '\0';
243 static struct option
const longopts
[] =
245 {"null", no_argument
, NULL
, '0'},
246 {"arg-file", required_argument
, NULL
, 'a'},
247 {"delimiter", required_argument
, NULL
, 'd'},
248 {"eof", optional_argument
, NULL
, 'e'},
249 {"replace", optional_argument
, NULL
, 'I'},
250 {"max-lines", optional_argument
, NULL
, 'l'},
251 {"max-args", required_argument
, NULL
, 'n'},
252 {"interactive", no_argument
, NULL
, 'p'},
253 {"no-run-if-empty", no_argument
, NULL
, 'r'},
254 {"max-chars", required_argument
, NULL
, 's'},
255 {"verbose", no_argument
, NULL
, 't'},
256 {"show-limits", no_argument
, NULL
, 'S'},
257 {"exit", no_argument
, NULL
, 'x'},
258 {"max-procs", required_argument
, NULL
, 'P'},
259 {"version", no_argument
, NULL
, 'v'},
260 {"help", no_argument
, NULL
, 'h'},
261 {NULL
, no_argument
, NULL
, 0}
264 static int read_line
PARAMS ((void));
265 static int read_string
PARAMS ((void));
266 static boolean print_args
PARAMS ((boolean ask
));
267 /* static void do_exec PARAMS ((void)); */
268 static int xargs_do_exec (const struct buildcmd_control
*cl
, struct buildcmd_state
*state
);
269 static void exec_if_possible
PARAMS ((void));
270 static void add_proc
PARAMS ((pid_t pid
));
271 static void wait_for_proc
PARAMS ((boolean all
));
272 static void wait_for_proc_all
PARAMS ((void));
273 static long parse_num
PARAMS ((char *str
, int option
, long min
, long max
, int fatal
));
274 static long env_size
PARAMS ((char **envp
));
275 static void usage
PARAMS ((FILE * stream
));
284 val
= sysconf(_SC_LINE_MAX
);
292 /* either _SC_LINE_MAX was not available or
293 * there is no particular limit.
302 return 2048L; /* a reasonable guess. */
306 get_char_oct_or_hex_escape(const char *s
)
313 assert('\\' == s
[0]);
321 else if (isdigit(s
[1]))
330 _("Invalid escape sequence %s in input delimiter specification."),
335 val
= strtoul(p
, &endp
, base
);
337 /* This if condition is carefully constructed to do
338 * the right thing if UCHAR_MAX has the same
339 * value as ULONG_MAX. IF UCHAR_MAX==ULONG_MAX,
340 * then val can never be greater than UCHAR_MAX.
342 if ((ULONG_MAX
== val
&& ERANGE
== errno
)
343 || (val
> UCHAR_MAX
))
348 _("Invalid escape sequence %s in input delimiter specification; character values must not exceed %lx."),
349 s
, (unsigned long)UCHAR_MAX
);
354 _("Invalid escape sequence %s in input delimiter specification; character values must not exceed %lo."),
355 s
, (unsigned long)UCHAR_MAX
);
359 /* check for trailing garbage */
363 _("Invalid escape sequence %s in input delimiter specification; trailing characters %s not recognised."),
372 get_input_delimiter(const char *s
)
404 return get_char_oct_or_hex_escape(s
);
410 _("Invalid input delimiter specification %s: the delimited must be either a single character or an escape sequence starting with \\."),
419 main (int argc
, char **argv
)
422 int show_limits
= 0; /* --show-limits */
423 int always_run_command
= 1;
424 char *input_file
= "-"; /* "-" is stdin */
425 long posix_arg_size_max
;
426 long posix_arg_size_min
;
428 long size_of_environment
= env_size(environ
);
429 char *default_cmd
= "/bin/echo";
430 int (*read_args
) PARAMS ((void)) = read_line
;
433 program_name
= argv
[0];
434 original_exit_value
= 0;
436 #ifdef HAVE_SETLOCALE
437 setlocale (LC_ALL
, "");
439 bindtextdomain (PACKAGE
, LOCALEDIR
);
440 textdomain (PACKAGE
);
441 atexit (close_stdout
);
442 atexit (wait_for_proc_all
);
444 /* IEEE Std 1003.1, 2003 specifies that the combined argument and
445 * environment list shall not exceed {ARG_MAX}-2048 bytes. It also
446 * specifies that it shall be at least LINE_MAX.
448 posix_arg_size_min
= get_line_max();
449 posix_arg_size_max
= bc_get_arg_max();
450 posix_arg_size_max
-= 2048; /* POSIX.2 requires subtracting 2048. */
452 bc_init_controlinfo(&bc_ctl
);
453 assert(bc_ctl
.arg_max
== posix_arg_size_max
);
455 bc_ctl
.exec_callback
= xargs_do_exec
;
458 /* Start with a reasonable default size, though this can be
459 * adjusted via the -s option.
461 arg_size
= (128 * 1024) + size_of_environment
;
463 /* Take the size of the environment into account. */
464 if (size_of_environment
> posix_arg_size_max
)
471 bc_ctl
.arg_max
= posix_arg_size_max
- size_of_environment
;
474 /* Check against the upper and lower limits. */
475 if (arg_size
> bc_ctl
.arg_max
)
476 arg_size
= bc_ctl
.arg_max
;
477 if (arg_size
< posix_arg_size_min
)
478 arg_size
= posix_arg_size_min
;
483 while ((optc
= getopt_long (argc
, argv
, "+0a:E:e::i::I:l::L:n:prs:txP:d:",
484 longopts
, (int *) 0)) != -1)
489 read_args
= read_string
;
490 input_delimiter
= '\0';
494 read_args
= read_string
;
495 input_delimiter
= get_input_delimiter(optarg
);
498 case 'E': /* POSIX */
499 case 'e': /* deprecated */
500 if (optarg
&& (strlen(optarg
) > 0))
510 case 'I': /* POSIX */
511 case 'i': /* deprecated */
513 bc_ctl
.replace_pat
= optarg
;
515 bc_ctl
.replace_pat
= "{}";
516 /* -i excludes -n -l. */
517 bc_ctl
.args_per_exec
= 0;
518 bc_ctl
.lines_per_exec
= 0;
521 case 'L': /* POSIX */
522 bc_ctl
.lines_per_exec
= parse_num (optarg
, 'L', 1L, -1L, 1);
523 /* -L excludes -i -n. */
524 bc_ctl
.args_per_exec
= 0;
525 bc_ctl
.replace_pat
= NULL
;
528 case 'l': /* deprecated */
530 bc_ctl
.lines_per_exec
= parse_num (optarg
, 'l', 1L, -1L, 1);
532 bc_ctl
.lines_per_exec
= 1;
533 /* -l excludes -i -n. */
534 bc_ctl
.args_per_exec
= 0;
535 bc_ctl
.replace_pat
= NULL
;
539 bc_ctl
.args_per_exec
= parse_num (optarg
, 'n', 1L, -1L, 1);
540 /* -n excludes -i -l. */
541 bc_ctl
.lines_per_exec
= 0;
542 if (bc_ctl
.args_per_exec
== 1 && bc_ctl
.replace_pat
)
543 /* ignore -n1 in '-i -n1' */
544 bc_ctl
.args_per_exec
= 0;
546 bc_ctl
.replace_pat
= NULL
;
549 /* The POSIX standard specifies that it is not an error
550 * for the -s option to specify a size that the implementation
551 * cannot support - in that case, the relevant limit is used.
554 arg_size
= parse_num (optarg
, 's', 1L, posix_arg_size_max
, 0);
555 if (arg_size
> posix_arg_size_max
)
557 error (0, 0, "warning: value %ld for -s option is too large, using %ld instead", arg_size
, posix_arg_size_max
);
558 arg_size
= posix_arg_size_max
;
567 print_command
= true;
571 bc_ctl
.exit_if_size_exceeded
= true;
575 query_before_executing
= true;
576 print_command
= true;
580 always_run_command
= 0;
584 proc_max
= parse_num (optarg
, 'P', 0L, -1L, 1);
592 printf (_("GNU xargs version %s\n"), version_string
);
603 /* We issue this error message after processing command line
604 * arguments so that it is possible to use "xargs --help" even if
605 * the environment is too large.
607 error (1, 0, _("environment is too large for exec"));
610 if (0 == strcmp (input_file
, "-"))
612 input_stream
= stdin
;
616 keep_stdin
= 1; /* see prep_child_for_exec() */
617 input_stream
= fopen (input_file
, "r");
618 if (NULL
== input_stream
)
621 _("Cannot open input file `%s'"),
626 if (bc_ctl
.replace_pat
|| bc_ctl
.lines_per_exec
)
627 bc_ctl
.exit_if_size_exceeded
= true;
636 /* Taking into account the size of the environment,
637 * figure out how large a buffer we need to
638 * hold all the arguments. We cannot use ARG_MAX
639 * directly since that may be arbitrarily large.
640 * This is from a patch by Bob Prolux, <bob@proulx.com>.
642 if (bc_ctl
.arg_max
> arg_size
)
647 _("Reducing arg_max (%ld) to arg_size (%ld)\n"),
648 bc_ctl
.arg_max
, arg_size
);
650 bc_ctl
.arg_max
= arg_size
;
656 _("Your environment variables take up %ld bytes\n"),
657 size_of_environment
);
659 _("POSIX lower and upper limits on argument length: %ld, %ld\n"),
663 _("Maximum length of command we could actually use: %ld\n"),
664 (posix_arg_size_max
- size_of_environment
));
666 _("Size of command buffer we are actually using: %ld\n"),
670 linebuf
= (char *) xmalloc (bc_ctl
.arg_max
+ 1);
671 bc_state
.argbuf
= (char *) xmalloc (bc_ctl
.arg_max
+ 1);
673 /* Make sure to listen for the kids. */
674 signal (SIGCHLD
, SIG_DFL
);
676 if (!bc_ctl
.replace_pat
)
678 for (; optind
< argc
; optind
++)
679 bc_push_arg (&bc_ctl
, &bc_state
,
680 argv
[optind
], strlen (argv
[optind
]) + 1,
683 initial_args
= false;
684 bc_ctl
.initial_argc
= bc_state
.cmd_argc
;
685 bc_state
.cmd_initial_argv_chars
= bc_state
.cmd_argv_chars
;
687 while ((*read_args
) () != -1)
688 if (bc_ctl
.lines_per_exec
&& lineno
>= bc_ctl
.lines_per_exec
)
690 xargs_do_exec (&bc_ctl
, &bc_state
);
694 /* SYSV xargs seems to do at least one exec, even if the
696 if (bc_state
.cmd_argc
!= bc_ctl
.initial_argc
697 || (always_run_command
&& procs_executed
== 0))
698 xargs_do_exec (&bc_ctl
, &bc_state
);
705 size_t *arglen
= (size_t *) xmalloc (sizeof (size_t) * argc
);
707 for (i
= optind
; i
< argc
; i
++)
708 arglen
[i
] = strlen(argv
[i
]);
709 bc_ctl
.rplen
= strlen (bc_ctl
.replace_pat
);
710 while ((len
= (*read_args
) ()) != -1)
712 /* Don't do insert on the command name. */
713 bc_clear_args(&bc_ctl
, &bc_state
);
714 bc_state
.cmd_argv_chars
= 0; /* begin at start of buffer */
716 bc_push_arg (&bc_ctl
, &bc_state
,
717 argv
[optind
], arglen
[optind
] + 1,
721 initial_args
= false;
723 for (i
= optind
+ 1; i
< argc
; i
++)
724 bc_do_insert (&bc_ctl
, &bc_state
,
729 xargs_do_exec (&bc_ctl
, &bc_state
);
733 original_exit_value
= child_error
;
738 /* Read a line of arguments from the input and add them to the list of
739 arguments to pass to the command. Ignore blank lines and initial blanks.
740 Single and double quotes and backslashes quote metacharacters and blanks
741 as they do in the shell.
742 Return -1 if eof (either physical or logical) is reached,
743 otherwise the length of the last string read (including the null). */
748 static boolean eof
= false;
749 /* Start out in mode SPACE to always strip leading spaces (even with -i). */
750 int state
= SPACE
; /* The type of character we last read. */
751 int prevc
; /* The previous value of c. */
752 int quotc
= 0; /* The last quote character read. */
754 boolean first
= true; /* true if reading first arg on line. */
757 /* Including the NUL, the args must not grow past this point. */
758 char *endbuf
= linebuf
+ bc_ctl
.arg_max
- bc_state
.cmd_initial_argv_chars
- 1;
765 c
= getc (input_stream
);
768 /* COMPAT: SYSV seems to ignore stuff on a line that
769 ends without a \n; we don't. */
778 error (1, 0, _("unmatched %s quote; by default quotes are special to xargs unless you use the -0 option"),
779 quotc
== '"' ? _("double") : _("single"));
781 if (first
&& EOF_STR (linebuf
))
783 if (!bc_ctl
.replace_pat
)
784 bc_push_arg (&bc_ctl
, &bc_state
,
801 if (!ISBLANK (prevc
))
802 lineno
++; /* For -l. */
811 if (EOF_STR (linebuf
))
814 return first
? -1 : len
;
816 if (!bc_ctl
.replace_pat
)
817 bc_push_arg (&bc_ctl
, &bc_state
,
823 if (!bc_ctl
.replace_pat
&& ISSPACE (c
))
827 if (EOF_STR (linebuf
))
830 return first
? -1 : len
;
832 bc_push_arg (&bc_ctl
, &bc_state
,
859 error (1, 0, _("unmatched %s quote; by default quotes are special to xargs unless you use the -0 option"),
860 quotc
== '"' ? _("double") : _("single"));
877 error (1, 0, _("argument line too long"));
881 append_char_to_buf(&linebuf
, &endbuf
, &p
, c
);
886 /* Read a null-terminated string from the input and add it to the list of
887 arguments to pass to the command.
888 Return -1 if eof (either physical or logical) is reached,
889 otherwise the length of the string read (including the null). */
894 static boolean eof
= false;
897 /* Including the NUL, the args must not grow past this point. */
898 char *endbuf
= linebuf
+ bc_ctl
.arg_max
- bc_state
.cmd_initial_argv_chars
- 1;
904 int c
= getc (input_stream
);
912 if (!bc_ctl
.replace_pat
)
913 bc_push_arg (&bc_ctl
, &bc_state
,
919 if (c
== input_delimiter
)
921 lineno
++; /* For -l. */
924 if (!bc_ctl
.replace_pat
)
925 bc_push_arg (&bc_ctl
, &bc_state
,
934 error (1, 0, _("argument line too long"));
940 /* Print the arguments of the command to execute.
941 If ASK is nonzero, prompt the user for a response, and
942 if the user responds affirmatively, return true;
943 otherwise, return false. */
946 print_args (boolean ask
)
950 for (i
= 0; i
< bc_state
.cmd_argc
- 1; i
++)
951 fprintf (stderr
, "%s ", bc_state
.cmd_argv
[i
]);
954 static FILE *tty_stream
;
959 tty_stream
= fopen ("/dev/tty", "r");
961 error (1, errno
, "/dev/tty");
963 fputs ("?...", stderr
);
965 c
= savec
= getc (tty_stream
);
966 while (c
!= EOF
&& c
!= '\n')
967 c
= getc (tty_stream
);
968 if (savec
== 'y' || savec
== 'Y')
978 /* Close stdin and attach /dev/null to it.
979 * This resolves Savannah bug #3992.
982 prep_child_for_exec (void)
986 const char inputfile
[] = "/dev/null";
987 /* fprintf(stderr, "attaching stdin to /dev/null\n"); */
990 if (open(inputfile
, O_RDONLY
) < 0)
992 /* This is not entirely fatal, since
993 * executing the child with a closed
994 * stdin is almost as good as executing it
995 * with its stdin attached to /dev/null.
997 error (0, errno
, "%s", inputfile
);
1003 /* Execute the command that has been built in `cmd_argv'. This may involve
1004 waiting for processes that were previously executed. */
1007 xargs_do_exec (const struct buildcmd_control
*ctl
, struct buildcmd_state
*state
)
1011 bc_push_arg (&bc_ctl
, &bc_state
,
1014 false); /* Null terminate the arg list. */
1016 if (!query_before_executing
|| print_args (true))
1018 if (proc_max
&& procs_executing
>= proc_max
)
1019 wait_for_proc (false);
1020 if (!query_before_executing
&& print_command
)
1022 /* If we run out of processes, wait for a child to return and
1024 while ((child
= fork ()) < 0 && errno
== EAGAIN
&& procs_executing
)
1025 wait_for_proc (false);
1029 error (1, errno
, _("cannot fork"));
1031 case 0: /* Child. */
1032 prep_child_for_exec();
1033 execvp (bc_state
.cmd_argv
[0], bc_state
.cmd_argv
);
1034 error (0, errno
, "%s", bc_state
.cmd_argv
[0]);
1035 _exit (errno
== ENOENT
? 127 : 126);
1041 bc_clear_args(&bc_ctl
, &bc_state
);
1042 return 1; /* Success */
1045 /* Execute the command if possible. */
1048 exec_if_possible (void)
1050 if (bc_ctl
.replace_pat
|| initial_args
||
1051 bc_state
.cmd_argc
== bc_ctl
.initial_argc
|| bc_ctl
.exit_if_size_exceeded
)
1053 xargs_do_exec (&bc_ctl
, &bc_state
);
1056 /* Add the process with id PID to the list of processes that have
1060 add_proc (pid_t pid
)
1064 /* Find an empty slot. */
1065 for (i
= 0; i
< pids_alloc
&& pids
[i
]; i
++)
1067 if (i
== pids_alloc
)
1069 if (pids_alloc
== 0)
1071 pids_alloc
= proc_max
? proc_max
: 64;
1072 pids
= (pid_t
*) xmalloc (sizeof (pid_t
) * pids_alloc
);
1077 pids
= (pid_t
*) xrealloc (pids
,
1078 sizeof (pid_t
) * pids_alloc
);
1080 memset (&pids
[i
], '\0', sizeof (pid_t
) * (pids_alloc
- i
));
1087 /* If ALL is true, wait for all child processes to finish;
1088 otherwise, wait for one child process to finish.
1089 Remove the processes that finish from the list of executing processes. */
1092 wait_for_proc (boolean all
)
1094 while (procs_executing
)
1102 while ((pid
= wait (&status
)) == (pid_t
) -1)
1104 error (1, errno
, _("error waiting for child process"));
1106 /* Find the entry in `pids' for the child process
1108 for (i
= 0; i
< pids_alloc
&& pid
!= pids
[i
]; i
++)
1111 while (i
== pids_alloc
); /* A child died that we didn't start? */
1113 /* Remove the child from the list. */
1117 if (WEXITSTATUS (status
) == 126 || WEXITSTATUS (status
) == 127)
1118 exit (WEXITSTATUS (status
)); /* Can't find or run the command. */
1119 if (WEXITSTATUS (status
) == 255)
1120 error (124, 0, _("%s: exited with status 255; aborting"), bc_state
.cmd_argv
[0]);
1121 if (WIFSTOPPED (status
))
1122 error (125, 0, _("%s: stopped by signal %d"), bc_state
.cmd_argv
[0], WSTOPSIG (status
));
1123 if (WIFSIGNALED (status
))
1124 error (125, 0, _("%s: terminated by signal %d"), bc_state
.cmd_argv
[0], WTERMSIG (status
));
1125 if (WEXITSTATUS (status
) != 0)
1133 /* Wait for all child processes to finish. */
1136 wait_for_proc_all (void)
1138 static boolean waiting
= false;
1144 wait_for_proc (true);
1147 if (original_exit_value
!= child_error
)
1149 /* wait_for_proc() changed the value of child_error(). This
1150 * function is registered via atexit(), and so may have been
1151 * called from exit(). We now know that the original value
1152 * passed to exit() is no longer the exit status we require.
1153 * The POSIX standard states that the behaviour if exit() is
1154 * called more than once is undefined. Therefore we now have to
1155 * exit with _exit() instead of exit().
1162 /* Return the value of the number represented in STR.
1163 OPTION is the command line option to which STR is the argument.
1164 If the value does not fall within the boundaries MIN and MAX,
1165 Print an error message mentioning OPTION. If FATAL is true,
1169 parse_num (char *str
, int option
, long int min
, long int max
, int fatal
)
1174 val
= strtol (str
, &eptr
, 10);
1175 if (eptr
== str
|| *eptr
)
1177 fprintf (stderr
, _("%s: invalid number for -%c option\n"),
1178 program_name
, option
);
1184 fprintf (stderr
, _("%s: value for -%c option should be >= %ld\n"),
1185 program_name
, option
, min
);
1196 else if (max
>= 0 && val
> max
)
1198 fprintf (stderr
, _("%s: value for -%c option should be < %ld\n"),
1199 program_name
, option
, max
);
1213 /* Return how much of ARG_MAX is used by the environment. */
1216 env_size (char **envp
)
1221 len
+= strlen (*envp
++) + 1;
1227 usage (FILE *stream
)
1229 fprintf (stream
, _("\
1230 Usage: %s [-0prtx] [--interactive] [--null] [-d|--delimiter=delim]\n\
1231 [-E eof-str] [-e[eof-str]] [--eof[=eof-str]]\n\
1232 [-L max-lines] [-l[max-lines]] [--max-lines[=max-lines]]\n\
1233 [-I replace-str] [-i[replace-str]] [--replace[=replace-str]]\n\
1234 [-n max-args] [--max-args=max-args]\n\
1235 [-s max-chars] [--max-chars=max-chars]\n\
1236 [-P max-procs] [--max-procs=max-procs]\n\
1237 [--verbose] [--exit] [--no-run-if-empty] [--arg-file=file]\n\
1238 [--version] [--help] [command [initial-arguments]]\n"),
1240 fputs (_("\nReport bugs to <bug-findutils@gnu.org>.\n"), stream
);