Improve comments for JimResetHashTable()
[jimtcl.git] / jim-file.c
blob24f39e59953a196606ec19a1f65c0a76a81aa633
1 /*
2 * Implements the file command for jim
4 * (c) 2008 Steve Bennett <steveb@workware.net.au>
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above
13 * copyright notice, this list of conditions and the following
14 * disclaimer in the documentation and/or other materials
15 * provided with the distribution.
17 * THIS SOFTWARE IS PROVIDED BY THE JIM TCL PROJECT ``AS IS'' AND ANY
18 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
19 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
20 * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
21 * JIM TCL PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
22 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
23 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
26 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
28 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30 * The views and conclusions contained in the software and documentation
31 * are those of the authors and should not be interpreted as representing
32 * official policies, either expressed or implied, of the Jim Tcl Project.
34 * Based on code originally from Tcl 6.7:
36 * Copyright 1987-1991 Regents of the University of California
37 * Permission to use, copy, modify, and distribute this
38 * software and its documentation for any purpose and without
39 * fee is hereby granted, provided that the above copyright
40 * notice appear in all copies. The University of California
41 * makes no representations about the suitability of this
42 * software for any purpose. It is provided "as is" without
43 * express or implied warranty.
46 #include <limits.h>
47 #include <stdlib.h>
48 #include <string.h>
49 #include <stdio.h>
50 #include <errno.h>
51 #include <sys/stat.h>
53 #include <jimautoconf.h>
54 #include <jim-subcmd.h>
56 #ifdef HAVE_UTIMES
57 #include <sys/time.h>
58 #endif
59 #ifdef HAVE_UNISTD_H
60 #include <unistd.h>
61 #elif defined(_MSC_VER)
62 #include <direct.h>
63 #define F_OK 0
64 #define W_OK 2
65 #define R_OK 4
66 #define S_ISREG(m) (((m) & S_IFMT) == S_IFREG)
67 #define S_ISDIR(m) (((m) & S_IFMT) == S_IFDIR)
68 #endif
70 # ifndef MAXPATHLEN
71 # define MAXPATHLEN JIM_PATH_LEN
72 # endif
74 #if defined(__MINGW32__) || defined(__MSYS__) || defined(_MSC_VER)
75 #define ISWINDOWS 1
76 #else
77 #define ISWINDOWS 0
78 #endif
80 /* extract nanosecond resolution mtime from struct stat */
81 #if defined(HAVE_STRUCT_STAT_ST_MTIMESPEC)
82 #define STAT_MTIME_US(STAT) ((STAT).st_mtimespec.tv_sec * 1000000ll + (STAT).st_mtimespec.tv_nsec / 1000)
83 #elif defined(HAVE_STRUCT_STAT_ST_MTIM)
84 #define STAT_MTIME_US(STAT) ((STAT).st_mtim.tv_sec * 1000000ll + (STAT).st_mtim.tv_nsec / 1000)
85 #endif
88 *----------------------------------------------------------------------
90 * JimGetFileType --
92 * Given a mode word, returns a string identifying the type of a
93 * file.
95 * Results:
96 * A static text string giving the file type from mode.
98 * Side effects:
99 * None.
101 *----------------------------------------------------------------------
104 static const char *JimGetFileType(int mode)
106 if (S_ISREG(mode)) {
107 return "file";
109 else if (S_ISDIR(mode)) {
110 return "directory";
112 #ifdef S_ISCHR
113 else if (S_ISCHR(mode)) {
114 return "characterSpecial";
116 #endif
117 #ifdef S_ISBLK
118 else if (S_ISBLK(mode)) {
119 return "blockSpecial";
121 #endif
122 #ifdef S_ISFIFO
123 else if (S_ISFIFO(mode)) {
124 return "fifo";
126 #endif
127 #ifdef S_ISLNK
128 else if (S_ISLNK(mode)) {
129 return "link";
131 #endif
132 #ifdef S_ISSOCK
133 else if (S_ISSOCK(mode)) {
134 return "socket";
136 #endif
137 return "unknown";
141 *----------------------------------------------------------------------
143 * StoreStatData --
145 * This is a utility procedure that breaks out the fields of a
146 * "stat" structure and stores them in textual form into the
147 * elements of an associative array.
149 * Results:
150 * Returns a standard Tcl return value. If an error occurs then
151 * a message is left in interp->result.
153 * Side effects:
154 * Elements of the associative array given by "varName" are modified.
156 *----------------------------------------------------------------------
158 static void AppendStatElement(Jim_Interp *interp, Jim_Obj *listObj, const char *key, jim_wide value)
160 Jim_ListAppendElement(interp, listObj, Jim_NewStringObj(interp, key, -1));
161 Jim_ListAppendElement(interp, listObj, Jim_NewIntObj(interp, value));
164 static int StoreStatData(Jim_Interp *interp, Jim_Obj *varName, const struct stat *sb)
166 /* Just use a list to store the data */
167 Jim_Obj *listObj = Jim_NewListObj(interp, NULL, 0);
169 AppendStatElement(interp, listObj, "dev", sb->st_dev);
170 AppendStatElement(interp, listObj, "ino", sb->st_ino);
171 AppendStatElement(interp, listObj, "mode", sb->st_mode);
172 AppendStatElement(interp, listObj, "nlink", sb->st_nlink);
173 AppendStatElement(interp, listObj, "uid", sb->st_uid);
174 AppendStatElement(interp, listObj, "gid", sb->st_gid);
175 AppendStatElement(interp, listObj, "size", sb->st_size);
176 AppendStatElement(interp, listObj, "atime", sb->st_atime);
177 AppendStatElement(interp, listObj, "mtime", sb->st_mtime);
178 AppendStatElement(interp, listObj, "ctime", sb->st_ctime);
179 #ifdef STAT_MTIME_US
180 AppendStatElement(interp, listObj, "mtimeus", STAT_MTIME_US(*sb));
181 #endif
182 Jim_ListAppendElement(interp, listObj, Jim_NewStringObj(interp, "type", -1));
183 Jim_ListAppendElement(interp, listObj, Jim_NewStringObj(interp, JimGetFileType((int)sb->st_mode), -1));
185 /* Was a variable specified? */
186 if (varName) {
187 Jim_Obj *objPtr;
188 objPtr = Jim_GetVariable(interp, varName, JIM_NONE);
190 if (objPtr) {
191 Jim_Obj *objv[2];
193 objv[0] = objPtr;
194 objv[1] = listObj;
196 objPtr = Jim_DictMerge(interp, 2, objv);
197 if (objPtr == NULL) {
198 /* This message matches the one from Tcl */
199 Jim_SetResultFormatted(interp, "can't set \"%#s(dev)\": variable isn't array", varName);
200 Jim_FreeNewObj(interp, listObj);
201 return JIM_ERR;
204 Jim_InvalidateStringRep(objPtr);
206 Jim_FreeNewObj(interp, listObj);
207 listObj = objPtr;
209 Jim_SetVariable(interp, varName, listObj);
212 /* And also return the value */
213 Jim_SetResult(interp, listObj);
215 return JIM_OK;
219 * Give a path of length 'len', returns the length of the path
220 * with any trailing slashes removed.
222 static int JimPathLenNoTrailingSlashes(const char *path, int len)
224 int i;
225 for (i = len; i > 1 && path[i - 1] == '/'; i--) {
226 /* Trailing slash, so remove it */
227 if (ISWINDOWS && path[i - 2] == ':') {
228 /* But on windows, we won't remove the trailing slash from c:/ */
229 break;
232 return i;
236 * Give a path in objPtr, returns a new path with any trailing slash removed.
237 * Use Jim_DecrRefCount() on the returned object (which may be identical to objPtr).
239 static Jim_Obj *JimStripTrailingSlashes(Jim_Interp *interp, Jim_Obj *objPtr)
241 int len = Jim_Length(objPtr);
242 const char *path = Jim_String(objPtr);
243 int i = JimPathLenNoTrailingSlashes(path, len);
244 if (i != len) {
245 objPtr = Jim_NewStringObj(interp, path, i);
247 Jim_IncrRefCount(objPtr);
248 return objPtr;
251 static int file_cmd_dirname(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
253 Jim_Obj *objPtr = JimStripTrailingSlashes(interp, argv[0]);
254 const char *path = Jim_String(objPtr);
255 const char *p = strrchr(path, '/');
257 if (!p && path[0] == '.' && path[1] == '.' && path[2] == '\0') {
258 Jim_SetResultString(interp, "..", -1);
259 } else if (!p) {
260 Jim_SetResultString(interp, ".", -1);
262 else if (p == path) {
263 Jim_SetResultString(interp, "/", -1);
265 else if (ISWINDOWS && p[-1] == ':') {
266 /* z:/dir => z:/ */
267 Jim_SetResultString(interp, path, p - path + 1);
269 else {
270 /* Strip any trailing slashes from the result */
271 int len = JimPathLenNoTrailingSlashes(path, p - path);
272 Jim_SetResultString(interp, path, len);
274 Jim_DecrRefCount(interp, objPtr);
275 return JIM_OK;
278 static int file_cmd_split(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
280 Jim_Obj *listObj = Jim_NewListObj(interp, NULL, 0);
281 const char *path = Jim_String(argv[0]);
283 if (*path == '/') {
284 Jim_ListAppendElement(interp, listObj, Jim_NewStringObj(interp, "/", 1));
287 while (1) {
288 /* Remove leading slashes */
289 while (*path == '/') {
290 path++;
292 if (*path) {
293 const char *pt = strchr(path, '/');
294 if (pt) {
295 Jim_ListAppendElement(interp, listObj, Jim_NewStringObj(interp, path, pt - path));
296 path = pt;
297 continue;
299 Jim_ListAppendElement(interp, listObj, Jim_NewStringObj(interp, path, -1));
301 break;
303 Jim_SetResult(interp, listObj);
304 return JIM_OK;
307 static int file_cmd_rootname(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
309 Jim_Obj *objPtr = JimStripTrailingSlashes(interp, argv[0]);
310 const char *path = Jim_String(objPtr);
311 const char *lastSlash = strrchr(path, '/');
312 const char *p = strrchr(path, '.');
314 if (p == NULL || (lastSlash != NULL && lastSlash > p)) {
315 Jim_SetResult(interp, objPtr);
317 else {
318 Jim_SetResultString(interp, path, p - path);
320 Jim_DecrRefCount(interp, objPtr);
321 return JIM_OK;
324 static int file_cmd_extension(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
326 Jim_Obj *objPtr = JimStripTrailingSlashes(interp, argv[0]);
327 const char *path = Jim_String(objPtr);
328 const char *lastSlash = strrchr(path, '/');
329 const char *p = strrchr(path, '.');
331 if (p == NULL || (lastSlash != NULL && lastSlash >= p)) {
332 p = "";
334 Jim_SetResultString(interp, p, -1);
335 Jim_DecrRefCount(interp, objPtr);
336 return JIM_OK;
339 static int file_cmd_tail(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
341 Jim_Obj *objPtr = JimStripTrailingSlashes(interp, argv[0]);
342 const char *path = Jim_String(objPtr);
343 const char *lastSlash = strrchr(path, '/');
345 if (lastSlash) {
346 Jim_SetResultString(interp, lastSlash + 1, -1);
348 else {
349 Jim_SetResult(interp, objPtr);
351 Jim_DecrRefCount(interp, objPtr);
352 return JIM_OK;
355 static int file_cmd_normalize(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
357 #ifdef HAVE_REALPATH
358 const char *path = Jim_String(argv[0]);
359 char *newname = Jim_Alloc(MAXPATHLEN + 1);
361 if (realpath(path, newname)) {
362 Jim_SetResult(interp, Jim_NewStringObjNoAlloc(interp, newname, -1));
363 return JIM_OK;
365 else {
366 Jim_Free(newname);
367 Jim_SetResultFormatted(interp, "can't normalize \"%#s\": %s", argv[0], strerror(errno));
368 return JIM_ERR;
370 #else
371 Jim_SetResultString(interp, "Not implemented", -1);
372 return JIM_ERR;
373 #endif
376 static int file_cmd_join(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
378 int i;
379 char *newname = Jim_Alloc(MAXPATHLEN + 1);
380 char *last = newname;
382 *newname = 0;
384 /* Simple implementation for now */
385 for (i = 0; i < argc; i++) {
386 int len;
387 const char *part = Jim_GetString(argv[i], &len);
389 if (*part == '/') {
390 /* Absolute component, so go back to the start */
391 last = newname;
393 else if (ISWINDOWS && strchr(part, ':')) {
394 /* Absolute component on mingw, so go back to the start */
395 last = newname;
397 else if (part[0] == '.') {
398 if (part[1] == '/') {
399 part += 2;
400 len -= 2;
402 else if (part[1] == 0 && last != newname) {
403 /* Adding '.' to an existing path does nothing */
404 continue;
408 /* Add a slash if needed */
409 if (last != newname && last[-1] != '/') {
410 *last++ = '/';
413 if (len) {
414 if (last + len - newname >= MAXPATHLEN) {
415 Jim_Free(newname);
416 Jim_SetResultString(interp, "Path too long", -1);
417 return JIM_ERR;
419 memcpy(last, part, len);
420 last += len;
423 /* Remove a slash if needed */
424 if (last > newname + 1 && last[-1] == '/') {
425 /* but on on Windows, leave the trailing slash on "c:/ " */
426 if (!ISWINDOWS || !(last > newname + 2 && last[-2] == ':')) {
427 *--last = 0;
432 *last = 0;
434 /* Probably need to handle some special cases ... */
436 Jim_SetResult(interp, Jim_NewStringObjNoAlloc(interp, newname, last - newname));
438 return JIM_OK;
441 static int file_access(Jim_Interp *interp, Jim_Obj *filename, int mode)
443 Jim_SetResultBool(interp, access(Jim_String(filename), mode) != -1);
445 return JIM_OK;
448 static int file_cmd_readable(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
450 return file_access(interp, argv[0], R_OK);
453 static int file_cmd_writable(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
455 return file_access(interp, argv[0], W_OK);
458 static int file_cmd_executable(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
460 #ifdef X_OK
461 return file_access(interp, argv[0], X_OK);
462 #else
463 /* If no X_OK, just assume true. */
464 Jim_SetResultBool(interp, 1);
465 return JIM_OK;
466 #endif
469 static int file_cmd_exists(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
471 return file_access(interp, argv[0], F_OK);
474 static int file_cmd_delete(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
476 int force = Jim_CompareStringImmediate(interp, argv[0], "-force");
478 if (force || Jim_CompareStringImmediate(interp, argv[0], "--")) {
479 argc++;
480 argv--;
483 while (argc--) {
484 const char *path = Jim_String(argv[0]);
486 if (unlink(path) == -1 && errno != ENOENT) {
487 if (rmdir(path) == -1) {
488 /* Maybe try using the script helper */
489 if (!force || Jim_EvalPrefix(interp, "file delete force", 1, argv) != JIM_OK) {
490 Jim_SetResultFormatted(interp, "couldn't delete file \"%s\": %s", path,
491 strerror(errno));
492 return JIM_ERR;
496 argv++;
498 return JIM_OK;
501 #ifdef HAVE_MKDIR_ONE_ARG
502 #define MKDIR_DEFAULT(PATHNAME) mkdir(PATHNAME)
503 #else
504 #define MKDIR_DEFAULT(PATHNAME) mkdir(PATHNAME, 0755)
505 #endif
508 * Create directory, creating all intermediate paths if necessary.
510 * Returns 0 if OK or -1 on failure (and sets errno)
512 * Note: The path may be modified.
514 static int mkdir_all(char *path)
516 int ok = 1;
518 /* First time just try to make the dir */
519 goto first;
521 while (ok--) {
522 /* Must have failed the first time, so recursively make the parent and try again */
524 char *slash = strrchr(path, '/');
526 if (slash && slash != path) {
527 *slash = 0;
528 if (mkdir_all(path) != 0) {
529 return -1;
531 *slash = '/';
534 first:
535 if (MKDIR_DEFAULT(path) == 0) {
536 return 0;
538 if (errno == ENOENT) {
539 /* Create the parent and try again */
540 continue;
542 /* Maybe it already exists as a directory */
543 if (errno == EEXIST) {
544 struct stat sb;
546 if (stat(path, &sb) == 0 && S_ISDIR(sb.st_mode)) {
547 return 0;
549 /* Restore errno */
550 errno = EEXIST;
552 /* Failed */
553 break;
555 return -1;
558 static int file_cmd_mkdir(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
560 while (argc--) {
561 char *path = Jim_StrDup(Jim_String(argv[0]));
562 int rc = mkdir_all(path);
564 Jim_Free(path);
565 if (rc != 0) {
566 Jim_SetResultFormatted(interp, "can't create directory \"%#s\": %s", argv[0],
567 strerror(errno));
568 return JIM_ERR;
570 argv++;
572 return JIM_OK;
575 static int file_cmd_tempfile(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
577 int fd = Jim_MakeTempFile(interp, (argc >= 1) ? Jim_String(argv[0]) : NULL, 0);
579 if (fd < 0) {
580 return JIM_ERR;
582 close(fd);
584 return JIM_OK;
587 static int file_cmd_rename(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
589 const char *source;
590 const char *dest;
591 int force = 0;
593 if (argc == 3) {
594 if (!Jim_CompareStringImmediate(interp, argv[0], "-force")) {
595 return -1;
597 force++;
598 argv++;
599 argc--;
602 source = Jim_String(argv[0]);
603 dest = Jim_String(argv[1]);
605 if (!force && access(dest, F_OK) == 0) {
606 Jim_SetResultFormatted(interp, "error renaming \"%#s\" to \"%#s\": target exists", argv[0],
607 argv[1]);
608 return JIM_ERR;
611 if (rename(source, dest) != 0) {
612 Jim_SetResultFormatted(interp, "error renaming \"%#s\" to \"%#s\": %s", argv[0], argv[1],
613 strerror(errno));
614 return JIM_ERR;
617 return JIM_OK;
620 #if defined(HAVE_LINK) && defined(HAVE_SYMLINK)
621 static int file_cmd_link(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
623 int ret;
624 const char *source;
625 const char *dest;
626 static const char * const options[] = { "-hard", "-symbolic", NULL };
627 enum { OPT_HARD, OPT_SYMBOLIC, };
628 int option = OPT_HARD;
630 if (argc == 3) {
631 if (Jim_GetEnum(interp, argv[0], options, &option, NULL, JIM_ENUM_ABBREV | JIM_ERRMSG) != JIM_OK) {
632 return JIM_ERR;
634 argv++;
635 argc--;
638 dest = Jim_String(argv[0]);
639 source = Jim_String(argv[1]);
641 if (option == OPT_HARD) {
642 ret = link(source, dest);
644 else {
645 ret = symlink(source, dest);
648 if (ret != 0) {
649 Jim_SetResultFormatted(interp, "error linking \"%#s\" to \"%#s\": %s", argv[0], argv[1],
650 strerror(errno));
651 return JIM_ERR;
654 return JIM_OK;
656 #endif
658 static int file_stat(Jim_Interp *interp, Jim_Obj *filename, struct stat *sb)
660 const char *path = Jim_String(filename);
662 if (stat(path, sb) == -1) {
663 Jim_SetResultFormatted(interp, "could not read \"%#s\": %s", filename, strerror(errno));
664 return JIM_ERR;
666 return JIM_OK;
669 #ifdef HAVE_LSTAT
670 static int file_lstat(Jim_Interp *interp, Jim_Obj *filename, struct stat *sb)
672 const char *path = Jim_String(filename);
674 if (lstat(path, sb) == -1) {
675 Jim_SetResultFormatted(interp, "could not read \"%#s\": %s", filename, strerror(errno));
676 return JIM_ERR;
678 return JIM_OK;
680 #else
681 #define file_lstat file_stat
682 #endif
684 static int file_cmd_atime(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
686 struct stat sb;
688 if (file_stat(interp, argv[0], &sb) != JIM_OK) {
689 return JIM_ERR;
691 Jim_SetResultInt(interp, sb.st_atime);
692 return JIM_OK;
696 * Set file atime/mtime to the given time in microseconds since the epoch.
698 static int JimSetFileTimes(Jim_Interp *interp, const char *filename, jim_wide us)
700 #ifdef HAVE_UTIMES
701 struct timeval times[2];
703 times[1].tv_sec = times[0].tv_sec = us / 1000000;
704 times[1].tv_usec = times[0].tv_usec = us % 1000000;
706 if (utimes(filename, times) != 0) {
707 Jim_SetResultFormatted(interp, "can't set time on \"%s\": %s", filename, strerror(errno));
708 return JIM_ERR;
710 return JIM_OK;
711 #else
712 Jim_SetResultString(interp, "Not implemented", -1);
713 return JIM_ERR;
714 #endif
717 static int file_cmd_mtime(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
719 struct stat sb;
721 if (argc == 2) {
722 jim_wide secs;
723 if (Jim_GetWide(interp, argv[1], &secs) != JIM_OK) {
724 return JIM_ERR;
726 return JimSetFileTimes(interp, Jim_String(argv[0]), secs * 1000000);
728 if (file_stat(interp, argv[0], &sb) != JIM_OK) {
729 return JIM_ERR;
731 Jim_SetResultInt(interp, sb.st_mtime);
732 return JIM_OK;
735 #ifdef STAT_MTIME_US
736 static int file_cmd_mtimeus(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
738 struct stat sb;
740 if (argc == 2) {
741 jim_wide us;
742 if (Jim_GetWide(interp, argv[1], &us) != JIM_OK) {
743 return JIM_ERR;
745 return JimSetFileTimes(interp, Jim_String(argv[0]), us);
747 if (file_stat(interp, argv[0], &sb) != JIM_OK) {
748 return JIM_ERR;
750 Jim_SetResultInt(interp, STAT_MTIME_US(sb));
751 return JIM_OK;
753 #endif
755 static int file_cmd_copy(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
757 return Jim_EvalPrefix(interp, "file copy", argc, argv);
760 static int file_cmd_size(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
762 struct stat sb;
764 if (file_stat(interp, argv[0], &sb) != JIM_OK) {
765 return JIM_ERR;
767 Jim_SetResultInt(interp, sb.st_size);
768 return JIM_OK;
771 static int file_cmd_isdirectory(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
773 struct stat sb;
774 int ret = 0;
776 if (file_stat(interp, argv[0], &sb) == JIM_OK) {
777 ret = S_ISDIR(sb.st_mode);
779 Jim_SetResultInt(interp, ret);
780 return JIM_OK;
783 static int file_cmd_isfile(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
785 struct stat sb;
786 int ret = 0;
788 if (file_stat(interp, argv[0], &sb) == JIM_OK) {
789 ret = S_ISREG(sb.st_mode);
791 Jim_SetResultInt(interp, ret);
792 return JIM_OK;
795 #ifdef HAVE_GETEUID
796 static int file_cmd_owned(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
798 struct stat sb;
799 int ret = 0;
801 if (file_stat(interp, argv[0], &sb) == JIM_OK) {
802 ret = (geteuid() == sb.st_uid);
804 Jim_SetResultInt(interp, ret);
805 return JIM_OK;
807 #endif
809 #if defined(HAVE_READLINK)
810 static int file_cmd_readlink(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
812 const char *path = Jim_String(argv[0]);
813 char *linkValue = Jim_Alloc(MAXPATHLEN + 1);
815 int linkLength = readlink(path, linkValue, MAXPATHLEN);
817 if (linkLength == -1) {
818 Jim_Free(linkValue);
819 Jim_SetResultFormatted(interp, "couldn't readlink \"%#s\": %s", argv[0], strerror(errno));
820 return JIM_ERR;
822 linkValue[linkLength] = 0;
823 Jim_SetResult(interp, Jim_NewStringObjNoAlloc(interp, linkValue, linkLength));
824 return JIM_OK;
826 #endif
828 static int file_cmd_type(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
830 struct stat sb;
832 if (file_lstat(interp, argv[0], &sb) != JIM_OK) {
833 return JIM_ERR;
835 Jim_SetResultString(interp, JimGetFileType((int)sb.st_mode), -1);
836 return JIM_OK;
839 #ifdef HAVE_LSTAT
840 static int file_cmd_lstat(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
842 struct stat sb;
844 if (file_lstat(interp, argv[0], &sb) != JIM_OK) {
845 return JIM_ERR;
847 return StoreStatData(interp, argc == 2 ? argv[1] : NULL, &sb);
849 #else
850 #define file_cmd_lstat file_cmd_stat
851 #endif
853 static int file_cmd_stat(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
855 struct stat sb;
857 if (file_stat(interp, argv[0], &sb) != JIM_OK) {
858 return JIM_ERR;
860 return StoreStatData(interp, argc == 2 ? argv[1] : NULL, &sb);
863 static const jim_subcmd_type file_command_table[] = {
864 { "atime",
865 "name",
866 file_cmd_atime,
869 /* Description: Last access time */
871 { "mtime",
872 "name ?time?",
873 file_cmd_mtime,
876 /* Description: Get or set last modification time */
878 #ifdef STAT_MTIME_US
879 { "mtimeus",
880 "name ?time?",
881 file_cmd_mtimeus,
884 /* Description: Get or set last modification time in microseconds */
886 #endif
887 { "copy",
888 "?-force? source dest",
889 file_cmd_copy,
892 /* Description: Copy source file to destination file */
894 { "dirname",
895 "name",
896 file_cmd_dirname,
899 /* Description: Directory part of the name */
901 { "rootname",
902 "name",
903 file_cmd_rootname,
906 /* Description: Name without any extension */
908 { "extension",
909 "name",
910 file_cmd_extension,
913 /* Description: Last extension including the dot */
915 { "tail",
916 "name",
917 file_cmd_tail,
920 /* Description: Last component of the name */
922 { "split",
923 "name",
924 file_cmd_split,
927 /* Description: Split path into components as a list */
929 { "normalize",
930 "name",
931 file_cmd_normalize,
934 /* Description: Normalized path of name */
936 { "join",
937 "name ?name ...?",
938 file_cmd_join,
941 /* Description: Join multiple path components */
943 { "readable",
944 "name",
945 file_cmd_readable,
948 /* Description: Is file readable */
950 { "writable",
951 "name",
952 file_cmd_writable,
955 /* Description: Is file writable */
957 { "executable",
958 "name",
959 file_cmd_executable,
962 /* Description: Is file executable */
964 { "exists",
965 "name",
966 file_cmd_exists,
969 /* Description: Does file exist */
971 { "delete",
972 "?-force|--? name ...",
973 file_cmd_delete,
976 /* Description: Deletes the files or directories (must be empty unless -force) */
978 { "mkdir",
979 "dir ...",
980 file_cmd_mkdir,
983 /* Description: Creates the directories */
985 { "tempfile",
986 "?template?",
987 file_cmd_tempfile,
990 /* Description: Creates a temporary filename */
992 { "rename",
993 "?-force? source dest",
994 file_cmd_rename,
997 /* Description: Renames a file */
999 #if defined(HAVE_LINK) && defined(HAVE_SYMLINK)
1000 { "link",
1001 "?-symbolic|-hard? newname target",
1002 file_cmd_link,
1005 /* Description: Creates a hard or soft link */
1007 #endif
1008 #if defined(HAVE_READLINK)
1009 { "readlink",
1010 "name",
1011 file_cmd_readlink,
1014 /* Description: Value of the symbolic link */
1016 #endif
1017 { "size",
1018 "name",
1019 file_cmd_size,
1022 /* Description: Size of file */
1024 { "stat",
1025 "name ?var?",
1026 file_cmd_stat,
1029 /* Description: Returns results of stat, and may store in var array */
1031 { "lstat",
1032 "name ?var?",
1033 file_cmd_lstat,
1036 /* Description: Returns results of lstat, and may store in var array */
1038 { "type",
1039 "name",
1040 file_cmd_type,
1043 /* Description: Returns type of the file */
1045 #ifdef HAVE_GETEUID
1046 { "owned",
1047 "name",
1048 file_cmd_owned,
1051 /* Description: Returns 1 if owned by the current owner */
1053 #endif
1054 { "isdirectory",
1055 "name",
1056 file_cmd_isdirectory,
1059 /* Description: Returns 1 if name is a directory */
1061 { "isfile",
1062 "name",
1063 file_cmd_isfile,
1066 /* Description: Returns 1 if name is a file */
1069 NULL
1073 static int Jim_CdCmd(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
1075 const char *path;
1077 if (argc != 2) {
1078 Jim_WrongNumArgs(interp, 1, argv, "dirname");
1079 return JIM_ERR;
1082 path = Jim_String(argv[1]);
1084 if (chdir(path) != 0) {
1085 Jim_SetResultFormatted(interp, "couldn't change working directory to \"%s\": %s", path,
1086 strerror(errno));
1087 return JIM_ERR;
1089 return JIM_OK;
1092 static int Jim_PwdCmd(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
1094 char *cwd = Jim_Alloc(MAXPATHLEN);
1096 if (getcwd(cwd, MAXPATHLEN) == NULL) {
1097 Jim_SetResultString(interp, "Failed to get pwd", -1);
1098 Jim_Free(cwd);
1099 return JIM_ERR;
1101 else if (ISWINDOWS) {
1102 /* Try to keep backslashes out of paths */
1103 char *p = cwd;
1104 while ((p = strchr(p, '\\')) != NULL) {
1105 *p++ = '/';
1109 Jim_SetResultString(interp, cwd, -1);
1111 Jim_Free(cwd);
1112 return JIM_OK;
1115 int Jim_fileInit(Jim_Interp *interp)
1117 if (Jim_PackageProvide(interp, "file", "1.0", JIM_ERRMSG))
1118 return JIM_ERR;
1120 Jim_CreateCommand(interp, "file", Jim_SubCmdProc, (void *)file_command_table, NULL);
1121 Jim_CreateCommand(interp, "pwd", Jim_PwdCmd, NULL, NULL);
1122 Jim_CreateCommand(interp, "cd", Jim_CdCmd, NULL, NULL);
1123 return JIM_OK;