/* vi: set sw=4 ts=4: */
/*
- * Mini usleep implementation for busybox
+ * usleep implementation for busybox
*
+ * Copyright (C) 2003 Manuel Novoa III <mjn3@codepoet.org>
*
- * Copyright (C) 1995, 1996 by Bruce Perens <bruce@pixar.com>.
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
- *
+ * Licensed under GPLv2 or later, see file LICENSE in this source tree.
*/
+//config:config USLEEP
+//config: bool "usleep (1.1 kb)"
+//config: default y
+//config: help
+//config: usleep is used to pause for a specified number of microseconds.
+
+//applet:IF_USLEEP(APPLET_NOFORK(usleep, usleep, BB_DIR_BIN, BB_SUID_DROP, usleep))
-#include "internal.h"
-#include <stdlib.h>
-#include <unistd.h>
+//kbuild:lib-$(CONFIG_USLEEP) += usleep.o
-const char usleep_usage[] = "usleep N\n"
-#ifndef BB_FEATURE_TRIVIAL_HELP
- "\nPause for N microseconds.\n"
-#endif
- ;
+/* BB_AUDIT SUSv3 N/A -- Apparently a busybox extension. */
-extern int usleep_main(int argc, char **argv)
+//usage:#define usleep_trivial_usage
+//usage: "N"
+//usage:#define usleep_full_usage "\n\n"
+//usage: "Pause for N microseconds"
+//usage:
+//usage:#define usleep_example_usage
+//usage: "$ usleep 1000000\n"
+//usage: "[pauses for 1 second]\n"
+
+#include "libbb.h"
+
+/* This is a NOFORK applet. Be very careful! */
+
+int usleep_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
+int usleep_main(int argc UNUSED_PARAM, char **argv)
{
- if ((argc < 2) || (**(argv + 1) == '-')) {
- usage(usleep_usage);
+ if (!argv[1]) {
+ bb_show_usage();
}
- usleep(atoi(*(++argv))); /* return void */
- exit(TRUE);
+ /* Safe wrt NOFORK? (noforks are not allowed to run for
+ * a long time). Try "usleep 99999999" + ^C + "echo $?"
+ * in hush with FEATURE_SH_NOFORK=y.
+ * At least on uclibc, usleep() thanslates to nanosleep()
+ * which returns early on any signal (even caught one),
+ * and uclibc does not loop back on EINTR.
+ */
+ usleep(xatou(argv[1]));
+
+ return EXIT_SUCCESS;
}