zombiezen.com/go/lua@v0.0.0-20231013005828-290725fb9140/internal/lua54/loslib.c (about)

     1  /*
     2  ** $Id: loslib.c $
     3  ** Standard Operating System library
     4  ** See Copyright Notice in lua.h
     5  */
     6  
     7  #define loslib_c
     8  #define LUA_LIB
     9  
    10  #include "lprefix.h"
    11  
    12  
    13  #include <errno.h>
    14  #include <locale.h>
    15  #include <stdlib.h>
    16  #include <string.h>
    17  #include <time.h>
    18  
    19  #include "lua.h"
    20  
    21  #include "lauxlib.h"
    22  #include "lualib.h"
    23  
    24  
    25  /*
    26  ** {==================================================================
    27  ** List of valid conversion specifiers for the 'strftime' function;
    28  ** options are grouped by length; group of length 2 start with '||'.
    29  ** ===================================================================
    30  */
    31  #if !defined(LUA_STRFTIMEOPTIONS)	/* { */
    32  
    33  #if defined(LUA_USE_WINDOWS)
    34  #define LUA_STRFTIMEOPTIONS  "aAbBcdHIjmMpSUwWxXyYzZ%" \
    35      "||" "#c#x#d#H#I#j#m#M#S#U#w#W#y#Y"  /* two-char options */
    36  #elif defined(LUA_USE_C89)  /* ANSI C 89 (only 1-char options) */
    37  #define LUA_STRFTIMEOPTIONS  "aAbBcdHIjmMpSUwWxXyYZ%"
    38  #else  /* C99 specification */
    39  #define LUA_STRFTIMEOPTIONS  "aAbBcCdDeFgGhHIjmMnprRStTuUVwWxXyYzZ%" \
    40      "||" "EcECExEXEyEY" "OdOeOHOIOmOMOSOuOUOVOwOWOy"  /* two-char options */
    41  #endif
    42  
    43  #endif					/* } */
    44  /* }================================================================== */
    45  
    46  
    47  /*
    48  ** {==================================================================
    49  ** Configuration for time-related stuff
    50  ** ===================================================================
    51  */
    52  
    53  /*
    54  ** type to represent time_t in Lua
    55  */
    56  #if !defined(LUA_NUMTIME)	/* { */
    57  
    58  #define l_timet			lua_Integer
    59  #define l_pushtime(L,t)		lua_pushinteger(L,(lua_Integer)(t))
    60  #define l_gettime(L,arg)	luaL_checkinteger(L, arg)
    61  
    62  #else				/* }{ */
    63  
    64  #define l_timet			lua_Number
    65  #define l_pushtime(L,t)		lua_pushnumber(L,(lua_Number)(t))
    66  #define l_gettime(L,arg)	luaL_checknumber(L, arg)
    67  
    68  #endif				/* } */
    69  
    70  
    71  #if !defined(l_gmtime)		/* { */
    72  /*
    73  ** By default, Lua uses gmtime/localtime, except when POSIX is available,
    74  ** where it uses gmtime_r/localtime_r
    75  */
    76  
    77  #if defined(LUA_USE_POSIX)	/* { */
    78  
    79  #define l_gmtime(t,r)		gmtime_r(t,r)
    80  #define l_localtime(t,r)	localtime_r(t,r)
    81  
    82  #else				/* }{ */
    83  
    84  /* ISO C definitions */
    85  #define l_gmtime(t,r)		((void)(r)->tm_sec, gmtime(t))
    86  #define l_localtime(t,r)	((void)(r)->tm_sec, localtime(t))
    87  
    88  #endif				/* } */
    89  
    90  #endif				/* } */
    91  
    92  /* }================================================================== */
    93  
    94  
    95  /*
    96  ** {==================================================================
    97  ** Configuration for 'tmpnam':
    98  ** By default, Lua uses tmpnam except when POSIX is available, where
    99  ** it uses mkstemp.
   100  ** ===================================================================
   101  */
   102  #if !defined(lua_tmpnam)	/* { */
   103  
   104  #if defined(LUA_USE_POSIX)	/* { */
   105  
   106  #include <unistd.h>
   107  
   108  #define LUA_TMPNAMBUFSIZE	32
   109  
   110  #if !defined(LUA_TMPNAMTEMPLATE)
   111  #define LUA_TMPNAMTEMPLATE	"/tmp/lua_XXXXXX"
   112  #endif
   113  
   114  #define lua_tmpnam(b,e) { \
   115          strcpy(b, LUA_TMPNAMTEMPLATE); \
   116          e = mkstemp(b); \
   117          if (e != -1) close(e); \
   118          e = (e == -1); }
   119  
   120  #else				/* }{ */
   121  
   122  /* ISO C definitions */
   123  #define LUA_TMPNAMBUFSIZE	L_tmpnam
   124  #define lua_tmpnam(b,e)		{ e = (tmpnam(b) == NULL); }
   125  
   126  #endif				/* } */
   127  
   128  #endif				/* } */
   129  /* }================================================================== */
   130  
   131  
   132  #if !defined(l_system)
   133  #if defined(LUA_USE_IOS)
   134  /* Despite claiming to be ISO C, iOS does not implement 'system'. */
   135  #define l_system(cmd) ((cmd) == NULL ? 0 : -1)
   136  #else
   137  #define l_system(cmd)	system(cmd)  /* default definition */
   138  #endif
   139  #endif
   140  
   141  
   142  static int os_execute (lua_State *L) {
   143    const char *cmd = luaL_optstring(L, 1, NULL);
   144    int stat;
   145    errno = 0;
   146    stat = l_system(cmd);
   147    if (cmd != NULL)
   148      return luaL_execresult(L, stat);
   149    else {
   150      lua_pushboolean(L, stat);  /* true if there is a shell */
   151      return 1;
   152    }
   153  }
   154  
   155  
   156  static int os_remove (lua_State *L) {
   157    const char *filename = luaL_checkstring(L, 1);
   158    return luaL_fileresult(L, remove(filename) == 0, filename);
   159  }
   160  
   161  
   162  static int os_rename (lua_State *L) {
   163    const char *fromname = luaL_checkstring(L, 1);
   164    const char *toname = luaL_checkstring(L, 2);
   165    return luaL_fileresult(L, rename(fromname, toname) == 0, NULL);
   166  }
   167  
   168  
   169  static int os_tmpname (lua_State *L) {
   170    char buff[LUA_TMPNAMBUFSIZE];
   171    int err;
   172    lua_tmpnam(buff, err);
   173    if (l_unlikely(err))
   174      return luaL_error(L, "unable to generate a unique filename");
   175    lua_pushstring(L, buff);
   176    return 1;
   177  }
   178  
   179  
   180  static int os_getenv (lua_State *L) {
   181    lua_pushstring(L, getenv(luaL_checkstring(L, 1)));  /* if NULL push nil */
   182    return 1;
   183  }
   184  
   185  
   186  static int os_clock (lua_State *L) {
   187    lua_pushnumber(L, ((lua_Number)clock())/(lua_Number)CLOCKS_PER_SEC);
   188    return 1;
   189  }
   190  
   191  
   192  /*
   193  ** {======================================================
   194  ** Time/Date operations
   195  ** { year=%Y, month=%m, day=%d, hour=%H, min=%M, sec=%S,
   196  **   wday=%w+1, yday=%j, isdst=? }
   197  ** =======================================================
   198  */
   199  
   200  /*
   201  ** About the overflow check: an overflow cannot occur when time
   202  ** is represented by a lua_Integer, because either lua_Integer is
   203  ** large enough to represent all int fields or it is not large enough
   204  ** to represent a time that cause a field to overflow.  However, if
   205  ** times are represented as doubles and lua_Integer is int, then the
   206  ** time 0x1.e1853b0d184f6p+55 would cause an overflow when adding 1900
   207  ** to compute the year.
   208  */
   209  static void setfield (lua_State *L, const char *key, int value, int delta) {
   210    #if (defined(LUA_NUMTIME) && LUA_MAXINTEGER <= INT_MAX)
   211      if (l_unlikely(value > LUA_MAXINTEGER - delta))
   212        luaL_error(L, "field '%s' is out-of-bound", key);
   213    #endif
   214    lua_pushinteger(L, (lua_Integer)value + delta);
   215    lua_setfield(L, -2, key);
   216  }
   217  
   218  
   219  static void setboolfield (lua_State *L, const char *key, int value) {
   220    if (value < 0)  /* undefined? */
   221      return;  /* does not set field */
   222    lua_pushboolean(L, value);
   223    lua_setfield(L, -2, key);
   224  }
   225  
   226  
   227  /*
   228  ** Set all fields from structure 'tm' in the table on top of the stack
   229  */
   230  static void setallfields (lua_State *L, struct tm *stm) {
   231    setfield(L, "year", stm->tm_year, 1900);
   232    setfield(L, "month", stm->tm_mon, 1);
   233    setfield(L, "day", stm->tm_mday, 0);
   234    setfield(L, "hour", stm->tm_hour, 0);
   235    setfield(L, "min", stm->tm_min, 0);
   236    setfield(L, "sec", stm->tm_sec, 0);
   237    setfield(L, "yday", stm->tm_yday, 1);
   238    setfield(L, "wday", stm->tm_wday, 1);
   239    setboolfield(L, "isdst", stm->tm_isdst);
   240  }
   241  
   242  
   243  static int getboolfield (lua_State *L, const char *key) {
   244    int res;
   245    res = (lua_getfield(L, -1, key) == LUA_TNIL) ? -1 : lua_toboolean(L, -1);
   246    lua_pop(L, 1);
   247    return res;
   248  }
   249  
   250  
   251  static int getfield (lua_State *L, const char *key, int d, int delta) {
   252    int isnum;
   253    int t = lua_getfield(L, -1, key);  /* get field and its type */
   254    lua_Integer res = lua_tointegerx(L, -1, &isnum);
   255    if (!isnum) {  /* field is not an integer? */
   256      if (l_unlikely(t != LUA_TNIL))  /* some other value? */
   257        return luaL_error(L, "field '%s' is not an integer", key);
   258      else if (l_unlikely(d < 0))  /* absent field; no default? */
   259        return luaL_error(L, "field '%s' missing in date table", key);
   260      res = d;
   261    }
   262    else {
   263      if (!(res >= 0 ? res - delta <= INT_MAX : INT_MIN + delta <= res))
   264        return luaL_error(L, "field '%s' is out-of-bound", key);
   265      res -= delta;
   266    }
   267    lua_pop(L, 1);
   268    return (int)res;
   269  }
   270  
   271  
   272  static const char *checkoption (lua_State *L, const char *conv,
   273                                  ptrdiff_t convlen, char *buff) {
   274    const char *option = LUA_STRFTIMEOPTIONS;
   275    int oplen = 1;  /* length of options being checked */
   276    for (; *option != '\0' && oplen <= convlen; option += oplen) {
   277      if (*option == '|')  /* next block? */
   278        oplen++;  /* will check options with next length (+1) */
   279      else if (memcmp(conv, option, oplen) == 0) {  /* match? */
   280        memcpy(buff, conv, oplen);  /* copy valid option to buffer */
   281        buff[oplen] = '\0';
   282        return conv + oplen;  /* return next item */
   283      }
   284    }
   285    luaL_argerror(L, 1,
   286      lua_pushfstring(L, "invalid conversion specifier '%%%s'", conv));
   287    return conv;  /* to avoid warnings */
   288  }
   289  
   290  
   291  static time_t l_checktime (lua_State *L, int arg) {
   292    l_timet t = l_gettime(L, arg);
   293    luaL_argcheck(L, (time_t)t == t, arg, "time out-of-bounds");
   294    return (time_t)t;
   295  }
   296  
   297  
   298  /* maximum size for an individual 'strftime' item */
   299  #define SIZETIMEFMT	250
   300  
   301  
   302  static int os_date (lua_State *L) {
   303    size_t slen;
   304    const char *s = luaL_optlstring(L, 1, "%c", &slen);
   305    time_t t = luaL_opt(L, l_checktime, 2, time(NULL));
   306    const char *se = s + slen;  /* 's' end */
   307    struct tm tmr, *stm;
   308    if (*s == '!') {  /* UTC? */
   309      stm = l_gmtime(&t, &tmr);
   310      s++;  /* skip '!' */
   311    }
   312    else
   313      stm = l_localtime(&t, &tmr);
   314    if (stm == NULL)  /* invalid date? */
   315      return luaL_error(L,
   316                   "date result cannot be represented in this installation");
   317    if (strcmp(s, "*t") == 0) {
   318      lua_createtable(L, 0, 9);  /* 9 = number of fields */
   319      setallfields(L, stm);
   320    }
   321    else {
   322      char cc[4];  /* buffer for individual conversion specifiers */
   323      luaL_Buffer b;
   324      cc[0] = '%';
   325      luaL_buffinit(L, &b);
   326      while (s < se) {
   327        if (*s != '%')  /* not a conversion specifier? */
   328          luaL_addchar(&b, *s++);
   329        else {
   330          size_t reslen;
   331          char *buff = luaL_prepbuffsize(&b, SIZETIMEFMT);
   332          s++;  /* skip '%' */
   333          s = checkoption(L, s, se - s, cc + 1);  /* copy specifier to 'cc' */
   334          reslen = strftime(buff, SIZETIMEFMT, cc, stm);
   335          luaL_addsize(&b, reslen);
   336        }
   337      }
   338      luaL_pushresult(&b);
   339    }
   340    return 1;
   341  }
   342  
   343  
   344  static int os_time (lua_State *L) {
   345    time_t t;
   346    if (lua_isnoneornil(L, 1))  /* called without args? */
   347      t = time(NULL);  /* get current time */
   348    else {
   349      struct tm ts;
   350      luaL_checktype(L, 1, LUA_TTABLE);
   351      lua_settop(L, 1);  /* make sure table is at the top */
   352      ts.tm_year = getfield(L, "year", -1, 1900);
   353      ts.tm_mon = getfield(L, "month", -1, 1);
   354      ts.tm_mday = getfield(L, "day", -1, 0);
   355      ts.tm_hour = getfield(L, "hour", 12, 0);
   356      ts.tm_min = getfield(L, "min", 0, 0);
   357      ts.tm_sec = getfield(L, "sec", 0, 0);
   358      ts.tm_isdst = getboolfield(L, "isdst");
   359      t = mktime(&ts);
   360      setallfields(L, &ts);  /* update fields with normalized values */
   361    }
   362    if (t != (time_t)(l_timet)t || t == (time_t)(-1))
   363      return luaL_error(L,
   364                    "time result cannot be represented in this installation");
   365    l_pushtime(L, t);
   366    return 1;
   367  }
   368  
   369  
   370  static int os_difftime (lua_State *L) {
   371    time_t t1 = l_checktime(L, 1);
   372    time_t t2 = l_checktime(L, 2);
   373    lua_pushnumber(L, (lua_Number)difftime(t1, t2));
   374    return 1;
   375  }
   376  
   377  /* }====================================================== */
   378  
   379  
   380  static int os_setlocale (lua_State *L) {
   381    static const int cat[] = {LC_ALL, LC_COLLATE, LC_CTYPE, LC_MONETARY,
   382                        LC_NUMERIC, LC_TIME};
   383    static const char *const catnames[] = {"all", "collate", "ctype", "monetary",
   384       "numeric", "time", NULL};
   385    const char *l = luaL_optstring(L, 1, NULL);
   386    int op = luaL_checkoption(L, 2, "all", catnames);
   387    lua_pushstring(L, setlocale(cat[op], l));
   388    return 1;
   389  }
   390  
   391  
   392  static int os_exit (lua_State *L) {
   393    int status;
   394    if (lua_isboolean(L, 1))
   395      status = (lua_toboolean(L, 1) ? EXIT_SUCCESS : EXIT_FAILURE);
   396    else
   397      status = (int)luaL_optinteger(L, 1, EXIT_SUCCESS);
   398    if (lua_toboolean(L, 2))
   399      lua_close(L);
   400    if (L) exit(status);  /* 'if' to avoid warnings for unreachable 'return' */
   401    return 0;
   402  }
   403  
   404  
   405  static const luaL_Reg syslib[] = {
   406    {"clock",     os_clock},
   407    {"date",      os_date},
   408    {"difftime",  os_difftime},
   409    {"execute",   os_execute},
   410    {"exit",      os_exit},
   411    {"getenv",    os_getenv},
   412    {"remove",    os_remove},
   413    {"rename",    os_rename},
   414    {"setlocale", os_setlocale},
   415    {"time",      os_time},
   416    {"tmpname",   os_tmpname},
   417    {NULL, NULL}
   418  };
   419  
   420  /* }====================================================== */
   421  
   422  
   423  
   424  LUAMOD_API int luaopen_os (lua_State *L) {
   425    luaL_newlib(L, syslib);
   426    return 1;
   427  }
   428