(holiday-julian): Use calendar-nongregorian-visible-p.
[emacs.git] / src / dired.c
blob36324519fff7badeaadfc1edaf424b101bc2b8c9
1 /* Lisp functions for making directory listings.
2 Copyright (C) 1985, 1986, 1993, 1994, 1999, 2000, 2001, 2002, 2003,
3 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
5 This file is part of GNU Emacs.
7 GNU Emacs is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3, or (at your option)
10 any later version.
12 GNU Emacs is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU Emacs; see the file COPYING. If not, write to
19 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 Boston, MA 02110-1301, USA. */
23 #include <config.h>
25 #include <stdio.h>
26 #include <sys/types.h>
27 #include <sys/stat.h>
29 #ifdef HAVE_PWD_H
30 #include <pwd.h>
31 #endif
32 #ifndef VMS
33 #include <grp.h>
34 #endif
36 #include <errno.h>
38 #ifdef VMS
39 #include <string.h>
40 #include <rms.h>
41 #include <rmsdef.h>
42 #endif
44 #ifdef HAVE_UNISTD_H
45 #include <unistd.h>
46 #endif
48 /* The d_nameln member of a struct dirent includes the '\0' character
49 on some systems, but not on others. What's worse, you can't tell
50 at compile-time which one it will be, since it really depends on
51 the sort of system providing the filesystem you're reading from,
52 not the system you are running on. Paul Eggert
53 <eggert@bi.twinsun.com> says this occurs when Emacs is running on a
54 SunOS 4.1.2 host, reading a directory that is remote-mounted from a
55 Solaris 2.1 host and is in a native Solaris 2.1 filesystem.
57 Since applying strlen to the name always works, we'll just do that. */
58 #define NAMLEN(p) strlen (p->d_name)
60 #ifdef SYSV_SYSTEM_DIR
62 #include <dirent.h>
63 #define DIRENTRY struct dirent
65 #else /* not SYSV_SYSTEM_DIR */
67 #ifdef NONSYSTEM_DIR_LIBRARY
68 #include "ndir.h"
69 #else /* not NONSYSTEM_DIR_LIBRARY */
70 #ifdef MSDOS
71 #include <dirent.h>
72 #else
73 #include <sys/dir.h>
74 #endif
75 #endif /* not NONSYSTEM_DIR_LIBRARY */
77 #include <sys/stat.h>
79 #ifndef MSDOS
80 #define DIRENTRY struct direct
82 extern DIR *opendir ();
83 extern struct direct *readdir ();
85 #endif /* not MSDOS */
86 #endif /* not SYSV_SYSTEM_DIR */
88 /* Some versions of Cygwin don't have d_ino in `struct dirent'. */
89 #if defined(MSDOS) || defined(__CYGWIN__)
90 #define DIRENTRY_NONEMPTY(p) ((p)->d_name[0] != 0)
91 #else
92 #define DIRENTRY_NONEMPTY(p) ((p)->d_ino)
93 #endif
95 #include "lisp.h"
96 #include "systime.h"
97 #include "buffer.h"
98 #include "commands.h"
99 #include "character.h"
100 #include "charset.h"
101 #include "coding.h"
102 #include "regex.h"
103 #include "blockinput.h"
105 /* Returns a search buffer, with a fastmap allocated and ready to go. */
106 extern struct re_pattern_buffer *compile_pattern ();
108 /* From filemode.c. Can't go in Lisp.h because of `stat'. */
109 extern void filemodestring P_ ((struct stat *, char *));
111 /* if system does not have symbolic links, it does not have lstat.
112 In that case, use ordinary stat instead. */
114 #ifndef S_IFLNK
115 #define lstat stat
116 #endif
118 extern int completion_ignore_case;
119 extern Lisp_Object Qcompletion_ignore_case;
120 extern Lisp_Object Vcompletion_regexp_list;
122 Lisp_Object Vcompletion_ignored_extensions;
123 Lisp_Object Qdirectory_files;
124 Lisp_Object Qdirectory_files_and_attributes;
125 Lisp_Object Qfile_name_completion;
126 Lisp_Object Qfile_name_all_completions;
127 Lisp_Object Qfile_attributes;
128 Lisp_Object Qfile_attributes_lessp;
130 static int scmp P_ ((unsigned char *, unsigned char *, int));
133 Lisp_Object
134 directory_files_internal_unwind (dh)
135 Lisp_Object dh;
137 DIR *d = (DIR *) XSAVE_VALUE (dh)->pointer;
138 BLOCK_INPUT;
139 closedir (d);
140 UNBLOCK_INPUT;
141 return Qnil;
144 /* Function shared by Fdirectory_files and Fdirectory_files_and_attributes.
145 When ATTRS is zero, return a list of directory filenames; when
146 non-zero, return a list of directory filenames and their attributes.
147 In the latter case, ID_FORMAT is passed to Ffile_attributes. */
149 Lisp_Object
150 directory_files_internal (directory, full, match, nosort, attrs, id_format)
151 Lisp_Object directory, full, match, nosort;
152 int attrs;
153 Lisp_Object id_format;
155 DIR *d;
156 int directory_nbytes;
157 Lisp_Object list, dirfilename, encoded_directory;
158 struct re_pattern_buffer *bufp = NULL;
159 int needsep = 0;
160 int count = SPECPDL_INDEX ();
161 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5;
162 DIRENTRY *dp;
164 /* Because of file name handlers, these functions might call
165 Ffuncall, and cause a GC. */
166 list = encoded_directory = dirfilename = Qnil;
167 GCPRO5 (match, directory, list, dirfilename, encoded_directory);
168 dirfilename = Fdirectory_file_name (directory);
170 if (!NILP (match))
172 CHECK_STRING (match);
174 /* MATCH might be a flawed regular expression. Rather than
175 catching and signaling our own errors, we just call
176 compile_pattern to do the work for us. */
177 /* Pass 1 for the MULTIBYTE arg
178 because we do make multibyte strings if the contents warrant. */
179 #ifdef VMS
180 bufp = compile_pattern (match, 0,
181 buffer_defaults.downcase_table, 0, 1);
182 #else /* !VMS */
183 # ifdef WINDOWSNT
184 /* Windows users want case-insensitive wildcards. */
185 bufp = compile_pattern (match, 0,
186 buffer_defaults.case_canon_table, 0, 1);
187 # else /* !WINDOWSNT */
188 bufp = compile_pattern (match, 0, Qnil, 0, 1);
189 # endif /* !WINDOWSNT */
190 #endif /* !VMS */
193 /* Note: ENCODE_FILE and DECODE_FILE can GC because they can run
194 run_pre_post_conversion_on_str which calls Lisp directly and
195 indirectly. */
196 dirfilename = ENCODE_FILE (dirfilename);
197 encoded_directory = ENCODE_FILE (directory);
199 /* Now *bufp is the compiled form of MATCH; don't call anything
200 which might compile a new regexp until we're done with the loop! */
202 BLOCK_INPUT;
203 d = opendir (SDATA (dirfilename));
204 UNBLOCK_INPUT;
205 if (d == NULL)
206 report_file_error ("Opening directory", Fcons (directory, Qnil));
208 /* Unfortunately, we can now invoke expand-file-name and
209 file-attributes on filenames, both of which can throw, so we must
210 do a proper unwind-protect. */
211 record_unwind_protect (directory_files_internal_unwind,
212 make_save_value (d, 0));
214 directory_nbytes = SBYTES (directory);
215 re_match_object = Qt;
217 /* Decide whether we need to add a directory separator. */
218 #ifndef VMS
219 if (directory_nbytes == 0
220 || !IS_ANY_SEP (SREF (directory, directory_nbytes - 1)))
221 needsep = 1;
222 #endif /* not VMS */
224 /* Loop reading blocks until EOF or error. */
225 for (;;)
227 errno = 0;
228 dp = readdir (d);
230 if (dp == NULL && (0
231 #ifdef EAGAIN
232 || errno == EAGAIN
233 #endif
234 #ifdef EINTR
235 || errno == EINTR
236 #endif
238 { QUIT; continue; }
240 if (dp == NULL)
241 break;
243 if (DIRENTRY_NONEMPTY (dp))
245 int len;
246 int wanted = 0;
247 Lisp_Object name, finalname;
248 struct gcpro gcpro1, gcpro2;
250 len = NAMLEN (dp);
251 name = finalname = make_unibyte_string (dp->d_name, len);
252 GCPRO2 (finalname, name);
254 /* Note: ENCODE_FILE can GC; it should protect its argument,
255 though. */
256 name = DECODE_FILE (name);
257 len = SBYTES (name);
259 /* Now that we have unwind_protect in place, we might as well
260 allow matching to be interrupted. */
261 immediate_quit = 1;
262 QUIT;
264 if (NILP (match)
265 || (0 <= re_search (bufp, SDATA (name), len, 0, len, 0)))
266 wanted = 1;
268 immediate_quit = 0;
270 if (wanted)
272 if (!NILP (full))
274 Lisp_Object fullname;
275 int nbytes = len + directory_nbytes + needsep;
276 int nchars;
278 fullname = make_uninit_multibyte_string (nbytes, nbytes);
279 bcopy (SDATA (directory), SDATA (fullname),
280 directory_nbytes);
282 if (needsep)
283 SSET (fullname, directory_nbytes, DIRECTORY_SEP);
285 bcopy (SDATA (name),
286 SDATA (fullname) + directory_nbytes + needsep,
287 len);
289 nchars = chars_in_text (SDATA (fullname), nbytes);
291 /* Some bug somewhere. */
292 if (nchars > nbytes)
293 abort ();
295 STRING_SET_CHARS (fullname, nchars);
296 if (nchars == nbytes)
297 STRING_SET_UNIBYTE (fullname);
299 finalname = fullname;
301 else
302 finalname = name;
304 if (attrs)
306 /* Construct an expanded filename for the directory entry.
307 Use the decoded names for input to Ffile_attributes. */
308 Lisp_Object decoded_fullname, fileattrs;
309 struct gcpro gcpro1, gcpro2;
311 decoded_fullname = fileattrs = Qnil;
312 GCPRO2 (decoded_fullname, fileattrs);
314 /* Both Fexpand_file_name and Ffile_attributes can GC. */
315 decoded_fullname = Fexpand_file_name (name, directory);
316 fileattrs = Ffile_attributes (decoded_fullname, id_format);
318 list = Fcons (Fcons (finalname, fileattrs), list);
319 UNGCPRO;
321 else
322 list = Fcons (finalname, list);
325 UNGCPRO;
329 BLOCK_INPUT;
330 closedir (d);
331 UNBLOCK_INPUT;
333 /* Discard the unwind protect. */
334 specpdl_ptr = specpdl + count;
336 if (NILP (nosort))
337 list = Fsort (Fnreverse (list),
338 attrs ? Qfile_attributes_lessp : Qstring_lessp);
340 RETURN_UNGCPRO (list);
344 DEFUN ("directory-files", Fdirectory_files, Sdirectory_files, 1, 4, 0,
345 doc: /* Return a list of names of files in DIRECTORY.
346 There are three optional arguments:
347 If FULL is non-nil, return absolute file names. Otherwise return names
348 that are relative to the specified directory.
349 If MATCH is non-nil, mention only file names that match the regexp MATCH.
350 If NOSORT is non-nil, the list is not sorted--its order is unpredictable.
351 NOSORT is useful if you plan to sort the result yourself. */)
352 (directory, full, match, nosort)
353 Lisp_Object directory, full, match, nosort;
355 Lisp_Object handler;
356 directory = Fexpand_file_name (directory, Qnil);
358 /* If the file name has special constructs in it,
359 call the corresponding file handler. */
360 handler = Ffind_file_name_handler (directory, Qdirectory_files);
361 if (!NILP (handler))
362 return call5 (handler, Qdirectory_files, directory,
363 full, match, nosort);
365 return directory_files_internal (directory, full, match, nosort, 0, Qnil);
368 DEFUN ("directory-files-and-attributes", Fdirectory_files_and_attributes,
369 Sdirectory_files_and_attributes, 1, 5, 0,
370 doc: /* Return a list of names of files and their attributes in DIRECTORY.
371 There are four optional arguments:
372 If FULL is non-nil, return absolute file names. Otherwise return names
373 that are relative to the specified directory.
374 If MATCH is non-nil, mention only file names that match the regexp MATCH.
375 If NOSORT is non-nil, the list is not sorted--its order is unpredictable.
376 NOSORT is useful if you plan to sort the result yourself.
377 ID-FORMAT specifies the preferred format of attributes uid and gid, see
378 `file-attributes' for further documentation. */)
379 (directory, full, match, nosort, id_format)
380 Lisp_Object directory, full, match, nosort, id_format;
382 Lisp_Object handler;
383 directory = Fexpand_file_name (directory, Qnil);
385 /* If the file name has special constructs in it,
386 call the corresponding file handler. */
387 handler = Ffind_file_name_handler (directory, Qdirectory_files_and_attributes);
388 if (!NILP (handler))
389 return call6 (handler, Qdirectory_files_and_attributes,
390 directory, full, match, nosort, id_format);
392 return directory_files_internal (directory, full, match, nosort, 1, id_format);
396 Lisp_Object file_name_completion ();
398 DEFUN ("file-name-completion", Ffile_name_completion, Sfile_name_completion,
399 2, 3, 0,
400 doc: /* Complete file name FILE in directory DIRECTORY.
401 Returns the longest string
402 common to all file names in DIRECTORY that start with FILE.
403 If there is only one and FILE matches it exactly, returns t.
404 Returns nil if DIRECTORY contains no name starting with FILE.
406 If PREDICATE is non-nil, call PREDICATE with each possible
407 completion (in absolute form) and ignore it if PREDICATE returns nil.
409 This function ignores some of the possible completions as
410 determined by the variable `completion-ignored-extensions', which see. */)
411 (file, directory, predicate)
412 Lisp_Object file, directory, predicate;
414 Lisp_Object handler;
416 /* If the directory name has special constructs in it,
417 call the corresponding file handler. */
418 handler = Ffind_file_name_handler (directory, Qfile_name_completion);
419 if (!NILP (handler))
420 return call4 (handler, Qfile_name_completion, file, directory, predicate);
422 /* If the file name has special constructs in it,
423 call the corresponding file handler. */
424 handler = Ffind_file_name_handler (file, Qfile_name_completion);
425 if (!NILP (handler))
426 return call4 (handler, Qfile_name_completion, file, directory, predicate);
428 return file_name_completion (file, directory, 0, 0, predicate);
431 DEFUN ("file-name-all-completions", Ffile_name_all_completions,
432 Sfile_name_all_completions, 2, 2, 0,
433 doc: /* Return a list of all completions of file name FILE in directory DIRECTORY.
434 These are all file names in directory DIRECTORY which begin with FILE. */)
435 (file, directory)
436 Lisp_Object file, directory;
438 Lisp_Object handler;
440 /* If the directory name has special constructs in it,
441 call the corresponding file handler. */
442 handler = Ffind_file_name_handler (directory, Qfile_name_all_completions);
443 if (!NILP (handler))
444 return call3 (handler, Qfile_name_all_completions, file, directory);
446 /* If the file name has special constructs in it,
447 call the corresponding file handler. */
448 handler = Ffind_file_name_handler (file, Qfile_name_all_completions);
449 if (!NILP (handler))
450 return call3 (handler, Qfile_name_all_completions, file, directory);
452 return file_name_completion (file, directory, 1, 0, Qnil);
455 static int file_name_completion_stat ();
457 Lisp_Object
458 file_name_completion (file, dirname, all_flag, ver_flag, predicate)
459 Lisp_Object file, dirname;
460 int all_flag, ver_flag;
461 Lisp_Object predicate;
463 DIR *d;
464 int bestmatchsize = 0, skip;
465 register int compare, matchsize;
466 unsigned char *p1, *p2;
467 int matchcount = 0;
468 /* If ALL_FLAG is 1, BESTMATCH is the list of all matches, decoded.
469 If ALL_FLAG is 0, BESTMATCH is either nil
470 or the best match so far, not decoded. */
471 Lisp_Object bestmatch, tem, elt, name;
472 Lisp_Object encoded_file;
473 Lisp_Object encoded_dir;
474 struct stat st;
475 int directoryp;
476 int passcount;
477 int count = SPECPDL_INDEX ();
478 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5;
480 elt = Qnil;
482 #ifdef VMS
483 extern DIRENTRY * readdirver ();
485 DIRENTRY *((* readfunc) ());
487 /* Filename completion on VMS ignores case, since VMS filesys does. */
488 specbind (Qcompletion_ignore_case, Qt);
490 readfunc = readdir;
491 if (ver_flag)
492 readfunc = readdirver;
493 file = Fupcase (file);
494 #else /* not VMS */
495 CHECK_STRING (file);
496 #endif /* not VMS */
498 #ifdef FILE_SYSTEM_CASE
499 file = FILE_SYSTEM_CASE (file);
500 #endif
501 bestmatch = Qnil;
502 encoded_file = encoded_dir = Qnil;
503 GCPRO5 (file, dirname, bestmatch, encoded_file, encoded_dir);
504 dirname = Fexpand_file_name (dirname, Qnil);
506 /* Do completion on the encoded file name
507 because the other names in the directory are (we presume)
508 encoded likewise. We decode the completed string at the end. */
509 encoded_file = ENCODE_FILE (file);
511 encoded_dir = ENCODE_FILE (dirname);
513 /* With passcount = 0, ignore files that end in an ignored extension.
514 If nothing found then try again with passcount = 1, don't ignore them.
515 If looking for all completions, start with passcount = 1,
516 so always take even the ignored ones.
518 ** It would not actually be helpful to the user to ignore any possible
519 completions when making a list of them.** */
521 for (passcount = !!all_flag; NILP (bestmatch) && passcount < 2; passcount++)
523 int inner_count = SPECPDL_INDEX ();
525 BLOCK_INPUT;
526 d = opendir (SDATA (Fdirectory_file_name (encoded_dir)));
527 UNBLOCK_INPUT;
528 if (!d)
529 report_file_error ("Opening directory", Fcons (dirname, Qnil));
531 record_unwind_protect (directory_files_internal_unwind,
532 make_save_value (d, 0));
534 /* Loop reading blocks */
535 /* (att3b compiler bug requires do a null comparison this way) */
536 while (1)
538 DIRENTRY *dp;
539 int len;
541 #ifdef VMS
542 dp = (*readfunc) (d);
543 #else
544 errno = 0;
545 dp = readdir (d);
546 if (dp == NULL && (0
547 # ifdef EAGAIN
548 || errno == EAGAIN
549 # endif
550 # ifdef EINTR
551 || errno == EINTR
552 # endif
554 { QUIT; continue; }
555 #endif
557 if (!dp) break;
559 len = NAMLEN (dp);
561 QUIT;
562 if (! DIRENTRY_NONEMPTY (dp)
563 || len < SCHARS (encoded_file)
564 || 0 <= scmp (dp->d_name, SDATA (encoded_file),
565 SCHARS (encoded_file)))
566 continue;
568 if (file_name_completion_stat (encoded_dir, dp, &st) < 0)
569 continue;
571 directoryp = ((st.st_mode & S_IFMT) == S_IFDIR);
572 tem = Qnil;
573 if (directoryp)
575 #ifndef TRIVIAL_DIRECTORY_ENTRY
576 #define TRIVIAL_DIRECTORY_ENTRY(n) (!strcmp (n, ".") || !strcmp (n, ".."))
577 #endif
578 /* "." and ".." are never interesting as completions, and are
579 actually in the way in a directory with only one file. */
580 if (!passcount && TRIVIAL_DIRECTORY_ENTRY (dp->d_name))
581 continue;
582 if (!passcount && len > SCHARS (encoded_file))
583 /* Ignore directories if they match an element of
584 completion-ignored-extensions which ends in a slash. */
585 for (tem = Vcompletion_ignored_extensions;
586 CONSP (tem); tem = XCDR (tem))
588 int elt_len;
590 elt = XCAR (tem);
591 if (!STRINGP (elt))
592 continue;
593 /* Need to encode ELT, since scmp compares unibyte
594 strings only. */
595 elt = ENCODE_FILE (elt);
596 elt_len = SCHARS (elt) - 1; /* -1 for trailing / */
597 if (elt_len <= 0)
598 continue;
599 p1 = SDATA (elt);
600 if (p1[elt_len] != '/')
601 continue;
602 skip = len - elt_len;
603 if (skip < 0)
604 continue;
606 if (0 <= scmp (dp->d_name + skip, p1, elt_len))
607 continue;
608 break;
611 else
613 /* Compare extensions-to-be-ignored against end of this file name */
614 /* if name is not an exact match against specified string */
615 if (!passcount && len > SCHARS (encoded_file))
616 /* and exit this for loop if a match is found */
617 for (tem = Vcompletion_ignored_extensions;
618 CONSP (tem); tem = XCDR (tem))
620 elt = XCAR (tem);
621 if (!STRINGP (elt)) continue;
622 /* Need to encode ELT, since scmp compares unibyte
623 strings only. */
624 elt = ENCODE_FILE (elt);
625 skip = len - SCHARS (elt);
626 if (skip < 0) continue;
628 if (0 <= scmp (dp->d_name + skip,
629 SDATA (elt),
630 SCHARS (elt)))
631 continue;
632 break;
636 /* If an ignored-extensions match was found,
637 don't process this name as a completion. */
638 if (!passcount && CONSP (tem))
639 continue;
641 if (!passcount)
643 Lisp_Object regexps;
644 Lisp_Object zero;
645 XSETFASTINT (zero, 0);
647 /* Ignore this element if it fails to match all the regexps. */
648 for (regexps = Vcompletion_regexp_list; CONSP (regexps);
649 regexps = XCDR (regexps))
651 tem = Fstring_match (XCAR (regexps),
652 make_string (dp->d_name, len), zero);
653 if (NILP (tem))
654 break;
656 if (CONSP (regexps))
657 continue;
660 /* This is a possible completion */
661 if (directoryp)
663 /* This completion is a directory; make it end with '/' */
664 name = Ffile_name_as_directory (make_string (dp->d_name, len));
666 else
667 name = make_string (dp->d_name, len);
669 /* Test the predicate, if any. */
671 if (!NILP (predicate))
673 Lisp_Object decoded;
674 Lisp_Object val;
675 struct gcpro gcpro1;
677 GCPRO1 (name);
678 decoded = Fexpand_file_name (DECODE_FILE (name), dirname);
679 val = call1 (predicate, decoded);
680 UNGCPRO;
682 if (NILP (val))
683 continue;
686 /* Suitably record this match. */
688 matchcount++;
690 if (all_flag)
692 name = DECODE_FILE (name);
693 bestmatch = Fcons (name, bestmatch);
695 else if (NILP (bestmatch))
697 bestmatch = name;
698 bestmatchsize = SCHARS (name);
700 else
702 compare = min (bestmatchsize, len);
703 p1 = SDATA (bestmatch);
704 p2 = (unsigned char *) dp->d_name;
705 matchsize = scmp (p1, p2, compare);
706 if (matchsize < 0)
707 matchsize = compare;
708 if (completion_ignore_case)
710 /* If this is an exact match except for case,
711 use it as the best match rather than one that is not
712 an exact match. This way, we get the case pattern
713 of the actual match. */
714 /* This tests that the current file is an exact match
715 but BESTMATCH is not (it is too long). */
716 if ((matchsize == len
717 && matchsize + !!directoryp
718 < SCHARS (bestmatch))
720 /* If there is no exact match ignoring case,
721 prefer a match that does not change the case
722 of the input. */
723 /* If there is more than one exact match aside from
724 case, and one of them is exact including case,
725 prefer that one. */
726 /* This == checks that, of current file and BESTMATCH,
727 either both or neither are exact. */
728 (((matchsize == len)
730 (matchsize + !!directoryp
731 == SCHARS (bestmatch)))
732 && !bcmp (p2, SDATA (encoded_file), SCHARS (encoded_file))
733 && bcmp (p1, SDATA (encoded_file), SCHARS (encoded_file))))
734 bestmatch = name;
737 /* If this dirname all matches, see if implicit following
738 slash does too. */
739 if (directoryp
740 && compare == matchsize
741 && bestmatchsize > matchsize
742 && IS_ANY_SEP (p1[matchsize]))
743 matchsize++;
744 bestmatchsize = matchsize;
747 /* This closes the directory. */
748 bestmatch = unbind_to (inner_count, bestmatch);
751 UNGCPRO;
752 bestmatch = unbind_to (count, bestmatch);
754 if (all_flag || NILP (bestmatch))
756 if (STRINGP (bestmatch))
757 bestmatch = DECODE_FILE (bestmatch);
758 return bestmatch;
760 if (matchcount == 1 && bestmatchsize == SCHARS (file))
761 return Qt;
762 bestmatch = Fsubstring (bestmatch, make_number (0),
763 make_number (bestmatchsize));
764 /* Now that we got the right initial segment of BESTMATCH,
765 decode it from the coding system in use. */
766 bestmatch = DECODE_FILE (bestmatch);
767 return bestmatch;
770 /* Compare exactly LEN chars of strings at S1 and S2,
771 ignoring case if appropriate.
772 Return -1 if strings match,
773 else number of chars that match at the beginning. */
775 static int
776 scmp (s1, s2, len)
777 register unsigned char *s1, *s2;
778 int len;
780 register int l = len;
782 if (completion_ignore_case)
784 while (l && DOWNCASE (*s1++) == DOWNCASE (*s2++))
785 l--;
787 else
789 while (l && *s1++ == *s2++)
790 l--;
792 if (l == 0)
793 return -1;
794 else
795 return len - l;
798 static int
799 file_name_completion_stat (dirname, dp, st_addr)
800 Lisp_Object dirname;
801 DIRENTRY *dp;
802 struct stat *st_addr;
804 int len = NAMLEN (dp);
805 int pos = SCHARS (dirname);
806 int value;
807 char *fullname = (char *) alloca (len + pos + 2);
809 #ifdef MSDOS
810 #if __DJGPP__ > 1
811 /* Some fields of struct stat are *very* expensive to compute on MS-DOS,
812 but aren't required here. Avoid computing the following fields:
813 st_inode, st_size and st_nlink for directories, and the execute bits
814 in st_mode for non-directory files with non-standard extensions. */
816 unsigned short save_djstat_flags = _djstat_flags;
818 _djstat_flags = _STAT_INODE | _STAT_EXEC_MAGIC | _STAT_DIRSIZE;
819 #endif /* __DJGPP__ > 1 */
820 #endif /* MSDOS */
822 bcopy (SDATA (dirname), fullname, pos);
823 #ifndef VMS
824 if (!IS_DIRECTORY_SEP (fullname[pos - 1]))
825 fullname[pos++] = DIRECTORY_SEP;
826 #endif
828 bcopy (dp->d_name, fullname + pos, len);
829 fullname[pos + len] = 0;
831 #ifdef S_IFLNK
832 /* We want to return success if a link points to a nonexistent file,
833 but we want to return the status for what the link points to,
834 in case it is a directory. */
835 value = lstat (fullname, st_addr);
836 stat (fullname, st_addr);
837 return value;
838 #else
839 value = stat (fullname, st_addr);
840 #ifdef MSDOS
841 #if __DJGPP__ > 1
842 _djstat_flags = save_djstat_flags;
843 #endif /* __DJGPP__ > 1 */
844 #endif /* MSDOS */
845 return value;
846 #endif /* S_IFLNK */
849 #ifdef VMS
851 DEFUN ("file-name-all-versions", Ffile_name_all_versions,
852 Sfile_name_all_versions, 2, 2, 0,
853 doc: /* Return a list of all versions of file name FILE in directory DIRECTORY. */)
854 (file, directory)
855 Lisp_Object file, directory;
857 return file_name_completion (file, directory, 1, 1, Qnil);
860 DEFUN ("file-version-limit", Ffile_version_limit, Sfile_version_limit, 1, 1, 0,
861 doc: /* Return the maximum number of versions allowed for FILE.
862 Returns nil if the file cannot be opened or if there is no version limit. */)
863 (filename)
864 Lisp_Object filename;
866 Lisp_Object retval;
867 struct FAB fab;
868 struct RAB rab;
869 struct XABFHC xabfhc;
870 int status;
872 filename = Fexpand_file_name (filename, Qnil);
873 fab = cc$rms_fab;
874 xabfhc = cc$rms_xabfhc;
875 fab.fab$l_fna = SDATA (filename);
876 fab.fab$b_fns = strlen (fab.fab$l_fna);
877 fab.fab$l_xab = (char *) &xabfhc;
878 status = sys$open (&fab, 0, 0);
879 if (status != RMS$_NORMAL) /* Probably non-existent file */
880 return Qnil;
881 sys$close (&fab, 0, 0);
882 if (xabfhc.xab$w_verlimit == 32767)
883 return Qnil; /* No version limit */
884 else
885 return make_number (xabfhc.xab$w_verlimit);
888 #endif /* VMS */
890 Lisp_Object
891 make_time (time)
892 time_t time;
894 return Fcons (make_number (time >> 16),
895 Fcons (make_number (time & 0177777), Qnil));
898 DEFUN ("file-attributes", Ffile_attributes, Sfile_attributes, 1, 2, 0,
899 doc: /* Return a list of attributes of file FILENAME.
900 Value is nil if specified file cannot be opened.
902 ID-FORMAT specifies the preferred format of attributes uid and gid (see
903 below) - valid values are 'string and 'integer. The latter is the default,
904 but we plan to change that, so you should specify a non-nil value for
905 ID-FORMAT if you use the returned uid or gid.
907 Elements of the attribute list are:
908 0. t for directory, string (name linked to) for symbolic link, or nil.
909 1. Number of links to file.
910 2. File uid as a string or an integer. If a string value cannot be
911 looked up, the integer value is returned.
912 3. File gid, likewise.
913 4. Last access time, as a list of two integers.
914 First integer has high-order 16 bits of time, second has low 16 bits.
915 5. Last modification time, likewise.
916 6. Last status change time, likewise.
917 7. Size in bytes.
918 This is a floating point number if the size is too large for an integer.
919 8. File modes, as a string of ten letters or dashes as in ls -l.
920 9. t if file's gid would change if file were deleted and recreated.
921 10. inode number. If inode number is larger than the Emacs integer,
922 this is a cons cell containing two integers: first the high part,
923 then the low 16 bits.
924 11. Device number. If it is larger than the Emacs integer, this is
925 a cons cell, similar to the inode number. */)
926 (filename, id_format)
927 Lisp_Object filename, id_format;
929 Lisp_Object values[12];
930 Lisp_Object encoded;
931 struct stat s;
932 struct passwd *pw;
933 struct group *gr;
934 #if defined (BSD4_2) || defined (BSD4_3)
935 Lisp_Object dirname;
936 struct stat sdir;
937 #endif
938 char modes[10];
939 Lisp_Object handler;
940 struct gcpro gcpro1;
941 EMACS_INT uid, gid, ino;
943 filename = Fexpand_file_name (filename, Qnil);
945 /* If the file name has special constructs in it,
946 call the corresponding file handler. */
947 handler = Ffind_file_name_handler (filename, Qfile_attributes);
948 if (!NILP (handler))
949 { /* Only pass the extra arg if it is used to help backward compatibility
950 with old file handlers which do not implement the new arg. --Stef */
951 if (NILP (id_format))
952 return call2 (handler, Qfile_attributes, filename);
953 else
954 return call3 (handler, Qfile_attributes, filename, id_format);
957 GCPRO1 (filename);
958 encoded = ENCODE_FILE (filename);
959 UNGCPRO;
961 if (lstat (SDATA (encoded), &s) < 0)
962 return Qnil;
964 switch (s.st_mode & S_IFMT)
966 default:
967 values[0] = Qnil; break;
968 case S_IFDIR:
969 values[0] = Qt; break;
970 #ifdef S_IFLNK
971 case S_IFLNK:
972 values[0] = Ffile_symlink_p (filename); break;
973 #endif
975 values[1] = make_number (s.st_nlink);
976 /* When make_fixnum_or_float is called below with types that are
977 shorter than an int (e.g., `short'), GCC whines about comparison
978 being always false due to limited range of data type. Fix by
979 copying s.st_uid and s.st_gid into int variables. */
980 uid = s.st_uid;
981 gid = s.st_gid;
982 if (NILP (id_format) || EQ (id_format, Qinteger))
984 values[2] = make_fixnum_or_float (uid);
985 values[3] = make_fixnum_or_float (gid);
987 else
989 BLOCK_INPUT;
990 pw = (struct passwd *) getpwuid (uid);
991 values[2] = (pw ? build_string (pw->pw_name)
992 : make_fixnum_or_float (uid));
993 gr = (struct group *) getgrgid (gid);
994 values[3] = (gr ? build_string (gr->gr_name)
995 : make_fixnum_or_float (gid));
996 UNBLOCK_INPUT;
998 values[4] = make_time (s.st_atime);
999 values[5] = make_time (s.st_mtime);
1000 values[6] = make_time (s.st_ctime);
1001 values[7] = make_number (s.st_size);
1002 /* If the size is out of range for an integer, return a float. */
1003 if (XINT (values[7]) != s.st_size)
1004 values[7] = make_float ((double)s.st_size);
1005 /* If the size is negative, and its type is long, convert it back to
1006 positive. */
1007 if (s.st_size < 0 && sizeof (s.st_size) == sizeof (long))
1008 values[7] = make_float ((double) ((unsigned long) s.st_size));
1010 filemodestring (&s, modes);
1011 values[8] = make_string (modes, 10);
1012 #if defined (BSD4_2) || defined (BSD4_3) /* file gid will be dir gid */
1013 dirname = Ffile_name_directory (filename);
1014 if (! NILP (dirname))
1015 encoded = ENCODE_FILE (dirname);
1016 if (! NILP (dirname) && stat (SDATA (encoded), &sdir) == 0)
1017 values[9] = (sdir.st_gid != gid) ? Qt : Qnil;
1018 else /* if we can't tell, assume worst */
1019 values[9] = Qt;
1020 #else /* file gid will be egid */
1021 values[9] = (gid != getegid ()) ? Qt : Qnil;
1022 #endif /* BSD4_2 (or BSD4_3) */
1023 /* Shut up GCC warnings in FIXNUM_OVERFLOW_P below. */
1024 #ifdef WINDOWSNT
1026 /* The bit-shuffling we do in w32.c:stat can turn on the MSB, which
1027 will produce negative inode numbers. People don't like that, so
1028 force a positive inode instead. */
1029 unsigned short tem = s.st_ino;
1030 ino = tem;
1032 #else
1033 ino = s.st_ino;
1034 #endif
1035 if (FIXNUM_OVERFLOW_P (ino))
1036 /* To allow inode numbers larger than VALBITS, separate the bottom
1037 16 bits. */
1038 values[10] = Fcons (make_number (ino >> 16),
1039 make_number (ino & 0xffff));
1040 else
1041 /* But keep the most common cases as integers. */
1042 values[10] = make_number (ino);
1044 /* Likewise for device. */
1045 if (FIXNUM_OVERFLOW_P (s.st_dev))
1046 values[11] = Fcons (make_number (s.st_dev >> 16),
1047 make_number (s.st_dev & 0xffff));
1048 else
1049 values[11] = make_number (s.st_dev);
1051 return Flist (sizeof(values) / sizeof(values[0]), values);
1054 DEFUN ("file-attributes-lessp", Ffile_attributes_lessp, Sfile_attributes_lessp, 2, 2, 0,
1055 doc: /* Return t if first arg file attributes list is less than second.
1056 Comparison is in lexicographic order and case is significant. */)
1057 (f1, f2)
1058 Lisp_Object f1, f2;
1060 return Fstring_lessp (Fcar (f1), Fcar (f2));
1063 void
1064 syms_of_dired ()
1066 Qdirectory_files = intern ("directory-files");
1067 Qdirectory_files_and_attributes = intern ("directory-files-and-attributes");
1068 Qfile_name_completion = intern ("file-name-completion");
1069 Qfile_name_all_completions = intern ("file-name-all-completions");
1070 Qfile_attributes = intern ("file-attributes");
1071 Qfile_attributes_lessp = intern ("file-attributes-lessp");
1073 staticpro (&Qdirectory_files);
1074 staticpro (&Qdirectory_files_and_attributes);
1075 staticpro (&Qfile_name_completion);
1076 staticpro (&Qfile_name_all_completions);
1077 staticpro (&Qfile_attributes);
1078 staticpro (&Qfile_attributes_lessp);
1080 defsubr (&Sdirectory_files);
1081 defsubr (&Sdirectory_files_and_attributes);
1082 defsubr (&Sfile_name_completion);
1083 #ifdef VMS
1084 defsubr (&Sfile_name_all_versions);
1085 defsubr (&Sfile_version_limit);
1086 #endif /* VMS */
1087 defsubr (&Sfile_name_all_completions);
1088 defsubr (&Sfile_attributes);
1089 defsubr (&Sfile_attributes_lessp);
1091 DEFVAR_LISP ("completion-ignored-extensions", &Vcompletion_ignored_extensions,
1092 doc: /* Completion ignores file names ending in any string in this list.
1093 It does not ignore them if all possible completions end in one of
1094 these strings or when displaying a list of completions.
1095 It ignores directory names if they match any string in this list which
1096 ends in a slash. */);
1097 Vcompletion_ignored_extensions = Qnil;
1100 /* arch-tag: 1ac8deca-4d8f-4d41-ade9-089154d98c03
1101 (do not change this comment) */