ntpd: default to FEATURE_NTP_AUTH=y
[oweals/busybox.git] / coreutils / usleep.c
index c67c365b8aa35f85091f9760e8bb9d06bbefe2de..684ab781b179ec73e783e2af6c5f580d7b6f94f0 100644 (file)
@@ -1,36 +1,51 @@
 /* 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 "busybox.h"
-#include <stdlib.h>
-#include <unistd.h>
+//kbuild:lib-$(CONFIG_USLEEP) += usleep.o
 
-extern int usleep_main(int argc, char **argv)
+/* BB_AUDIT SUSv3 N/A -- Apparently a busybox extension. */
+
+//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) == '-')) {
-               show_usage();
+       if (!argv[1]) {
+               bb_show_usage();
        }
 
-       usleep(atoi(*(++argv)));        /* return void */
+       /* 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;
 }