new NOFORKs: pwdx,kill[all5],ttysize,realpath,readlink NOEXECs: date,resize
[oweals/busybox.git] / coreutils / date.c
index 3ce352c8d834affdc950333792e3a9c93e2f3973..89b281646e240ff2bb73c736c1523d3a38f15573 100644 (file)
@@ -7,9 +7,8 @@
  * iso-format handling added by Robert Griebl <griebl@gmx.de>
  * bugfixes and cleanup by Bernhard Reutner-Fischer
  *
- * Licensed under GPLv2 or later, see file LICENSE in this tarball for details.
-*/
-
+ * Licensed under GPLv2 or later, see file LICENSE in this source tree.
+ */
 /* This 'date' command supports only 2 time setting formats,
    all the GNU strftime stuff (its in libc, lets use it),
    setting time using UTC and displaying it, as well as
 /* Input parsing code is always bulky - used heavy duty libc stuff as
    much as possible, missed out a lot of bounds checking */
 
-/* Default input handling to save surprising some people */
+//config:config DATE
+//config:      bool "date (7.1 kb)"
+//config:      default y
+//config:      help
+//config:      date is used to set the system date or display the
+//config:      current time in the given format.
+//config:
+//config:config FEATURE_DATE_ISOFMT
+//config:      bool "Enable ISO date format output (-I)"
+//config:      default y
+//config:      depends on DATE
+//config:      help
+//config:      Enable option (-I) to output an ISO-8601 compliant
+//config:      date/time string.
+//config:
+//config:# defaults to "no": stat's nanosecond field is a bit non-portable
+//config:config FEATURE_DATE_NANO
+//config:      bool "Support %[num]N nanosecond format specifier"
+//config:      default n
+//config:      depends on DATE  # syscall(__NR_clock_gettime)
+//config:      select PLATFORM_LINUX
+//config:      help
+//config:      Support %[num]N format specifier. Adds ~250 bytes of code.
+//config:
+//config:config FEATURE_DATE_COMPAT
+//config:      bool "Support weird 'date MMDDhhmm[[YY]YY][.ss]' format"
+//config:      default y
+//config:      depends on DATE
+//config:      help
+//config:      System time can be set by 'date -s DATE' and simply 'date DATE',
+//config:      but formats of DATE string are different. 'date DATE' accepts
+//config:      a rather weird MMDDhhmm[[YY]YY][.ss] format with completely
+//config:      unnatural placement of year between minutes and seconds.
+//config:      date -s (and other commands like touch -d) use more sensible
+//config:      formats (for one, ISO format YYYY-MM-DD hh:mm:ss.ssssss).
+//config:
+//config:      With this option off, 'date DATE' is 'date -s DATE' support
+//config:      the same format. With it on, 'date DATE' additionally supports
+//config:      MMDDhhmm[[YY]YY][.ss] format.
+
+//applet:IF_DATE(APPLET_NOEXEC(date, date, BB_DIR_BIN, BB_SUID_DROP, date))
+
+//kbuild:lib-$(CONFIG_DATE) += date.o
 
 /* GNU coreutils 6.9 man page:
  * date [OPTION]... [+FORMAT]
  * date [-u|--utc|--universal] [MMDDhhmm[[CC]YY][.ss]]
  * -d, --date=STRING
- *      display time described by STRING, not `now'
+ *      display time described by STRING, not 'now'
  * -f, --file=DATEFILE
  *      like --date once for each line of DATEFILE
  * -r, --reference=FILE
  * -D FMT is a bbox extension for _input_ conversion of -d DATE
  */
 
-//kbuild:lib-$(CONFIG_DATE) += date.o
-
-//config:config DATE
-//config:      bool "date"
-//config:      default y
-//config:      help
-//config:        date is used to set the system date or display the
-//config:        current time in the given format.
-//config:
-//config:config FEATURE_DATE_ISOFMT
-//config:      bool "Enable ISO date format output (-I)"
-//config:      default y
-//config:      depends on DATE
-//config:      help
-//config:        Enable option (-I) to output an ISO-8601 compliant
-//config:        date/time string.
-//config:
-//config:config FEATURE_DATE_NANO
-//config:      bool "Support %[num]N nanosecond format specifier"
-//config:      default n
-//config:      depends on DATE && PLATFORM_LINUX # syscall(__NR_clock_gettime)
-//config:      help
-//config:        Support %[num]N format specifier. Adds ~250 bytes of code.
-//config:
-//config:config FEATURE_DATE_COMPAT
-//config:      bool "Support weird 'date MMDDhhmm[[YY]YY][.ss]' format"
-//config:      default y
-//config:      depends on DATE
-//config:      help
-//config:        System time can be set by 'date -s DATE' and simply 'date DATE',
-//config:        but formats of DATE string are different. 'date DATE' accepts
-//config:        a rather weird MMDDhhmm[[YY]YY][.ss] format with completely
-//config:        unnatural placement of year between minutes and seconds.
-//config:        date -s (and other commands like touch -d) use more sensible
-//config:        formats (for one, ISO format YYYY-MM-DD hh:mm:ss.ssssss).
-//config:
-//config:        With this option off, 'date DATE' is 'date -s DATE' support
-//config:        the same format. With it on, 'date DATE' additionally supports
-//config:        MMDDhhmm[[YY]YY][.ss] format.
+//usage:#define date_trivial_usage
+//usage:       "[OPTIONS] [+FMT] [TIME]"
+//usage:#define date_full_usage "\n\n"
+//usage:       "Display time (using +FMT), or set time\n"
+//usage:       IF_NOT_LONG_OPTS(
+//usage:     "\n       [-s] TIME       Set time to TIME"
+//usage:     "\n       -u              Work in UTC (don't convert to local time)"
+//usage:     "\n       -R              Output RFC-2822 compliant date string"
+//usage:       ) IF_LONG_OPTS(
+//usage:     "\n       [-s,--set] TIME Set time to TIME"
+//usage:     "\n       -u,--utc        Work in UTC (don't convert to local time)"
+//usage:     "\n       -R,--rfc-2822   Output RFC-2822 compliant date string"
+//usage:       )
+//usage:       IF_FEATURE_DATE_ISOFMT(
+//usage:     "\n       -I[SPEC]        Output ISO-8601 compliant date string"
+//usage:     "\n                       SPEC='date' (default) for date only,"
+//usage:     "\n                       'hours', 'minutes', or 'seconds' for date and"
+//usage:     "\n                       time to the indicated precision"
+//usage:       )
+//usage:       IF_NOT_LONG_OPTS(
+//usage:     "\n       -r FILE         Display last modification time of FILE"
+//usage:     "\n       -d TIME         Display TIME, not 'now'"
+//usage:       ) IF_LONG_OPTS(
+//usage:     "\n       -r,--reference FILE     Display last modification time of FILE"
+//usage:     "\n       -d,--date TIME  Display TIME, not 'now'"
+//usage:       )
+//usage:       IF_FEATURE_DATE_ISOFMT(
+//usage:     "\n       -D FMT          Use FMT for -d TIME conversion"
+//usage:       )
+//usage:     "\n"
+//usage:     "\nRecognized TIME formats:"
+//usage:     "\n       hh:mm[:ss]"
+//usage:     "\n       [YYYY.]MM.DD-hh:mm[:ss]"
+//usage:     "\n       YYYY-MM-DD hh:mm[:ss]"
+//usage:     "\n       [[[[[YY]YY]MM]DD]hh]mm[.ss]"
+//usage:       IF_FEATURE_DATE_COMPAT(
+//usage:     "\n       'date TIME' form accepts MMDDhhmm[[YY]YY][.ss] instead"
+//usage:       )
+//usage:
+//usage:#define date_example_usage
+//usage:       "$ date\n"
+//usage:       "Wed Apr 12 18:52:41 MDT 2000\n"
 
 #include "libbb.h"
+#include "common_bufsiz.h"
 #if ENABLE_FEATURE_DATE_NANO
 # include <sys/syscall.h>
 #endif
@@ -107,12 +152,6 @@ enum {
        OPT_HINT      = (1 << 6) * ENABLE_FEATURE_DATE_ISOFMT, /* D */
 };
 
-static void maybe_set_utc(int opt)
-{
-       if (opt & OPT_UTC)
-               putenv((char*)"TZ=UTC0");
-}
-
 #if ENABLE_LONG_OPTS
 static const char date_longopts[] ALIGN1 =
                "rfc-822\0"   No_argument       "R"
@@ -125,6 +164,19 @@ static const char date_longopts[] ALIGN1 =
                ;
 #endif
 
+/* We are a NOEXEC applet.
+ * Obstacles to NOFORK:
+ * - we change env
+ * - xasprintf result not freed
+ * - after xasprintf we use other xfuncs
+ */
+
+static void maybe_set_utc(int opt)
+{
+       if (opt & OPT_UTC)
+               putenv((char*)"TZ=UTC0");
+}
+
 int date_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
 int date_main(int argc UNUSED_PARAM, char **argv)
 {
@@ -208,6 +260,10 @@ int date_main(int argc UNUSED_PARAM, char **argv)
                ts.tv_sec = statbuf.st_mtime;
 #if ENABLE_FEATURE_DATE_NANO
                ts.tv_nsec = statbuf.st_mtim.tv_nsec;
+               /* Some toolchains use .st_mtimensec instead of st_mtim.tv_nsec.
+                * If you need #define _SVID_SOURCE 1 to enable st_mtim.tv_nsec,
+                * drop a mail to project mailing list please
+                */
 #endif
        } else {
 #if ENABLE_FEATURE_DATE_NANO
@@ -236,7 +292,9 @@ int date_main(int argc UNUSED_PARAM, char **argv)
                }
 
                /* Correct any day of week and day of year etc. fields */
-               tm_time.tm_isdst = -1;  /* Be sure to recheck dst */
+               /* Be sure to recheck dst (but not if date is time_t format) */
+               if (date_str[0] != '@')
+                       tm_time.tm_isdst = -1;
                ts.tv_sec = validate_tm_time(date_str, &tm_time);
 
                maybe_set_utc(opt);
@@ -317,16 +375,17 @@ int date_main(int argc UNUSED_PARAM, char **argv)
 #endif
 
 #define date_buf bb_common_bufsiz1
+       setup_common_bufsiz();
        if (*fmt_dt2str == '\0') {
                /* With no format string, just print a blank line */
                date_buf[0] = '\0';
        } else {
                /* Handle special conversions */
-               if (strncmp(fmt_dt2str, "%f", 2) == 0) {
+               if (is_prefixed_with(fmt_dt2str, "%f")) {
                        fmt_dt2str = (char*)"%Y.%m.%d-%H:%M:%S";
                }
                /* Generate output string */
-               strftime(date_buf, sizeof(date_buf), fmt_dt2str, &tm_time);
+               strftime(date_buf, COMMON_BUFSIZE, fmt_dt2str, &tm_time);
        }
        puts(date_buf);