Merge from emacs--devo--0
[bpt/emacs.git] / src / dired.c
1 /* Lisp functions for making directory listings.
2 Copyright (C) 1985, 1986, 1993, 1994, 1999, 2000, 2001, 2002, 2003,
3 2004, 2005, 2006 Free Software Foundation, Inc.
4
5 This file is part of GNU Emacs.
6
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 2, or (at your option)
10 any later version.
11
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.
16
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. */
21
22
23 #include <config.h>
24
25 #include <stdio.h>
26 #include <sys/types.h>
27 #include <sys/stat.h>
28
29 #ifdef HAVE_PWD_H
30 #include <pwd.h>
31 #endif
32 #ifndef VMS
33 #include <grp.h>
34 #endif
35
36 #include <errno.h>
37
38 #ifdef VMS
39 #include <string.h>
40 #include <rms.h>
41 #include <rmsdef.h>
42 #endif
43
44 #ifdef HAVE_UNISTD_H
45 #include <unistd.h>
46 #endif
47
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.
56
57 Since applying strlen to the name always works, we'll just do that. */
58 #define NAMLEN(p) strlen (p->d_name)
59
60 #ifdef SYSV_SYSTEM_DIR
61
62 #include <dirent.h>
63 #define DIRENTRY struct dirent
64
65 #else /* not SYSV_SYSTEM_DIR */
66
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 */
76
77 #include <sys/stat.h>
78
79 #ifndef MSDOS
80 #define DIRENTRY struct direct
81
82 extern DIR *opendir ();
83 extern struct direct *readdir ();
84
85 #endif /* not MSDOS */
86 #endif /* not SYSV_SYSTEM_DIR */
87
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
94
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
104 /* Returns a search buffer, with a fastmap allocated and ready to go. */
105 extern struct re_pattern_buffer *compile_pattern ();
106
107 /* From filemode.c. Can't go in Lisp.h because of `stat'. */
108 extern void filemodestring P_ ((struct stat *, char *));
109
110 /* if system does not have symbolic links, it does not have lstat.
111 In that case, use ordinary stat instead. */
112
113 #ifndef S_IFLNK
114 #define lstat stat
115 #endif
116
117 extern int completion_ignore_case;
118 extern Lisp_Object Vcompletion_regexp_list;
119
120 Lisp_Object Vcompletion_ignored_extensions;
121 Lisp_Object Qcompletion_ignore_case;
122 Lisp_Object Qdirectory_files;
123 Lisp_Object Qdirectory_files_and_attributes;
124 Lisp_Object Qfile_name_completion;
125 Lisp_Object Qfile_name_all_completions;
126 Lisp_Object Qfile_attributes;
127 Lisp_Object Qfile_attributes_lessp;
128
129 static int scmp P_ ((unsigned char *, unsigned char *, int));
130 \f
131
132 Lisp_Object
133 directory_files_internal_unwind (dh)
134 Lisp_Object dh;
135 {
136 DIR *d = (DIR *) XSAVE_VALUE (dh)->pointer;
137 closedir (d);
138 return Qnil;
139 }
140
141 /* Function shared by Fdirectory_files and Fdirectory_files_and_attributes.
142 When ATTRS is zero, return a list of directory filenames; when
143 non-zero, return a list of directory filenames and their attributes.
144 In the latter case, ID_FORMAT is passed to Ffile_attributes. */
145
146 Lisp_Object
147 directory_files_internal (directory, full, match, nosort, attrs, id_format)
148 Lisp_Object directory, full, match, nosort;
149 int attrs;
150 Lisp_Object id_format;
151 {
152 DIR *d;
153 int directory_nbytes;
154 Lisp_Object list, dirfilename, encoded_directory;
155 struct re_pattern_buffer *bufp = NULL;
156 int needsep = 0;
157 int count = SPECPDL_INDEX ();
158 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5;
159 DIRENTRY *dp;
160
161 /* Because of file name handlers, these functions might call
162 Ffuncall, and cause a GC. */
163 list = encoded_directory = dirfilename = Qnil;
164 GCPRO5 (match, directory, list, dirfilename, encoded_directory);
165 dirfilename = Fdirectory_file_name (directory);
166
167 if (!NILP (match))
168 {
169 CHECK_STRING (match);
170
171 /* MATCH might be a flawed regular expression. Rather than
172 catching and signaling our own errors, we just call
173 compile_pattern to do the work for us. */
174 /* Pass 1 for the MULTIBYTE arg
175 because we do make multibyte strings if the contents warrant. */
176 #ifdef VMS
177 bufp = compile_pattern (match, 0,
178 buffer_defaults.downcase_table, 0, 1);
179 #else
180 bufp = compile_pattern (match, 0, Qnil, 0, 1);
181 #endif
182 }
183
184 /* Note: ENCODE_FILE and DECODE_FILE can GC because they can run
185 run_pre_post_conversion_on_str which calls Lisp directly and
186 indirectly. */
187 dirfilename = ENCODE_FILE (dirfilename);
188 encoded_directory = ENCODE_FILE (directory);
189
190 /* Now *bufp is the compiled form of MATCH; don't call anything
191 which might compile a new regexp until we're done with the loop! */
192
193 d = opendir (SDATA (dirfilename));
194 if (d == NULL)
195 report_file_error ("Opening directory", Fcons (directory, Qnil));
196
197 /* Unfortunately, we can now invoke expand-file-name and
198 file-attributes on filenames, both of which can throw, so we must
199 do a proper unwind-protect. */
200 record_unwind_protect (directory_files_internal_unwind,
201 make_save_value (d, 0));
202
203 directory_nbytes = SBYTES (directory);
204 re_match_object = Qt;
205
206 /* Decide whether we need to add a directory separator. */
207 #ifndef VMS
208 if (directory_nbytes == 0
209 || !IS_ANY_SEP (SREF (directory, directory_nbytes - 1)))
210 needsep = 1;
211 #endif /* not VMS */
212
213 /* Loop reading blocks until EOF or error. */
214 for (;;)
215 {
216 errno = 0;
217 dp = readdir (d);
218
219 if (dp == NULL && (0
220 #ifdef EAGAIN
221 || errno == EAGAIN
222 #endif
223 #ifdef EINTR
224 || errno == EINTR
225 #endif
226 ))
227 { QUIT; continue; }
228
229 if (dp == NULL)
230 break;
231
232 if (DIRENTRY_NONEMPTY (dp))
233 {
234 int len;
235 int wanted = 0;
236 Lisp_Object name, finalname;
237 struct gcpro gcpro1, gcpro2;
238
239 len = NAMLEN (dp);
240 name = finalname = make_unibyte_string (dp->d_name, len);
241 GCPRO2 (finalname, name);
242
243 /* Note: ENCODE_FILE can GC; it should protect its argument,
244 though. */
245 name = DECODE_FILE (name);
246 len = SBYTES (name);
247
248 /* Now that we have unwind_protect in place, we might as well
249 allow matching to be interrupted. */
250 immediate_quit = 1;
251 QUIT;
252
253 if (NILP (match)
254 || (0 <= re_search (bufp, SDATA (name), len, 0, len, 0)))
255 wanted = 1;
256
257 immediate_quit = 0;
258
259 if (wanted)
260 {
261 if (!NILP (full))
262 {
263 Lisp_Object fullname;
264 int nbytes = len + directory_nbytes + needsep;
265 int nchars;
266
267 fullname = make_uninit_multibyte_string (nbytes, nbytes);
268 bcopy (SDATA (directory), SDATA (fullname),
269 directory_nbytes);
270
271 if (needsep)
272 SSET (fullname, directory_nbytes, DIRECTORY_SEP);
273
274 bcopy (SDATA (name),
275 SDATA (fullname) + directory_nbytes + needsep,
276 len);
277
278 nchars = chars_in_text (SDATA (fullname), nbytes);
279
280 /* Some bug somewhere. */
281 if (nchars > nbytes)
282 abort ();
283
284 STRING_SET_CHARS (fullname, nchars);
285 if (nchars == nbytes)
286 STRING_SET_UNIBYTE (fullname);
287
288 finalname = fullname;
289 }
290 else
291 finalname = name;
292
293 if (attrs)
294 {
295 /* Construct an expanded filename for the directory entry.
296 Use the decoded names for input to Ffile_attributes. */
297 Lisp_Object decoded_fullname, fileattrs;
298 struct gcpro gcpro1, gcpro2;
299
300 decoded_fullname = fileattrs = Qnil;
301 GCPRO2 (decoded_fullname, fileattrs);
302
303 /* Both Fexpand_file_name and Ffile_attributes can GC. */
304 decoded_fullname = Fexpand_file_name (name, directory);
305 fileattrs = Ffile_attributes (decoded_fullname, id_format);
306
307 list = Fcons (Fcons (finalname, fileattrs), list);
308 UNGCPRO;
309 }
310 else
311 list = Fcons (finalname, list);
312 }
313
314 UNGCPRO;
315 }
316 }
317
318 closedir (d);
319
320 /* Discard the unwind protect. */
321 specpdl_ptr = specpdl + count;
322
323 if (NILP (nosort))
324 list = Fsort (Fnreverse (list),
325 attrs ? Qfile_attributes_lessp : Qstring_lessp);
326
327 RETURN_UNGCPRO (list);
328 }
329
330
331 DEFUN ("directory-files", Fdirectory_files, Sdirectory_files, 1, 4, 0,
332 doc: /* Return a list of names of files in DIRECTORY.
333 There are three optional arguments:
334 If FULL is non-nil, return absolute file names. Otherwise return names
335 that are relative to the specified directory.
336 If MATCH is non-nil, mention only file names that match the regexp MATCH.
337 If NOSORT is non-nil, the list is not sorted--its order is unpredictable.
338 NOSORT is useful if you plan to sort the result yourself. */)
339 (directory, full, match, nosort)
340 Lisp_Object directory, full, match, nosort;
341 {
342 Lisp_Object handler;
343 directory = Fexpand_file_name (directory, Qnil);
344
345 /* If the file name has special constructs in it,
346 call the corresponding file handler. */
347 handler = Ffind_file_name_handler (directory, Qdirectory_files);
348 if (!NILP (handler))
349 return call5 (handler, Qdirectory_files, directory,
350 full, match, nosort);
351
352 return directory_files_internal (directory, full, match, nosort, 0, Qnil);
353 }
354
355 DEFUN ("directory-files-and-attributes", Fdirectory_files_and_attributes,
356 Sdirectory_files_and_attributes, 1, 5, 0,
357 doc: /* Return a list of names of files and their attributes in DIRECTORY.
358 There are four optional arguments:
359 If FULL is non-nil, return absolute file names. Otherwise return names
360 that are relative to the specified directory.
361 If MATCH is non-nil, mention only file names that match the regexp MATCH.
362 If NOSORT is non-nil, the list is not sorted--its order is unpredictable.
363 NOSORT is useful if you plan to sort the result yourself.
364 ID-FORMAT specifies the preferred format of attributes uid and gid, see
365 `file-attributes' for further documentation. */)
366 (directory, full, match, nosort, id_format)
367 Lisp_Object directory, full, match, nosort, id_format;
368 {
369 Lisp_Object handler;
370 directory = Fexpand_file_name (directory, Qnil);
371
372 /* If the file name has special constructs in it,
373 call the corresponding file handler. */
374 handler = Ffind_file_name_handler (directory, Qdirectory_files_and_attributes);
375 if (!NILP (handler))
376 return call6 (handler, Qdirectory_files_and_attributes,
377 directory, full, match, nosort, id_format);
378
379 return directory_files_internal (directory, full, match, nosort, 1, id_format);
380 }
381
382 \f
383 Lisp_Object file_name_completion ();
384
385 DEFUN ("file-name-completion", Ffile_name_completion, Sfile_name_completion,
386 2, 2, 0,
387 doc: /* Complete file name FILE in directory DIRECTORY.
388 Returns the longest string
389 common to all file names in DIRECTORY that start with FILE.
390 If there is only one and FILE matches it exactly, returns t.
391 Returns nil if DIRECTORY contains no name starting with FILE.
392
393 This function ignores some of the possible completions as
394 determined by the variable `completion-ignored-extensions', which see. */)
395 (file, directory)
396 Lisp_Object file, directory;
397 {
398 Lisp_Object handler;
399
400 /* If the directory name has special constructs in it,
401 call the corresponding file handler. */
402 handler = Ffind_file_name_handler (directory, Qfile_name_completion);
403 if (!NILP (handler))
404 return call3 (handler, Qfile_name_completion, file, directory);
405
406 /* If the file name has special constructs in it,
407 call the corresponding file handler. */
408 handler = Ffind_file_name_handler (file, Qfile_name_completion);
409 if (!NILP (handler))
410 return call3 (handler, Qfile_name_completion, file, directory);
411
412 return file_name_completion (file, directory, 0, 0);
413 }
414
415 DEFUN ("file-name-all-completions", Ffile_name_all_completions,
416 Sfile_name_all_completions, 2, 2, 0,
417 doc: /* Return a list of all completions of file name FILE in directory DIRECTORY.
418 These are all file names in directory DIRECTORY which begin with FILE. */)
419 (file, directory)
420 Lisp_Object file, directory;
421 {
422 Lisp_Object handler;
423
424 /* If the directory name has special constructs in it,
425 call the corresponding file handler. */
426 handler = Ffind_file_name_handler (directory, Qfile_name_all_completions);
427 if (!NILP (handler))
428 return call3 (handler, Qfile_name_all_completions, file, directory);
429
430 /* If the file name has special constructs in it,
431 call the corresponding file handler. */
432 handler = Ffind_file_name_handler (file, Qfile_name_all_completions);
433 if (!NILP (handler))
434 return call3 (handler, Qfile_name_all_completions, file, directory);
435
436 return file_name_completion (file, directory, 1, 0);
437 }
438
439 static int file_name_completion_stat ();
440
441 Lisp_Object
442 file_name_completion (file, dirname, all_flag, ver_flag)
443 Lisp_Object file, dirname;
444 int all_flag, ver_flag;
445 {
446 DIR *d;
447 int bestmatchsize = 0, skip;
448 register int compare, matchsize;
449 unsigned char *p1, *p2;
450 int matchcount = 0;
451 Lisp_Object bestmatch, tem, elt, name;
452 Lisp_Object encoded_file;
453 Lisp_Object encoded_dir;
454 struct stat st;
455 int directoryp;
456 int passcount;
457 int count = SPECPDL_INDEX ();
458 struct gcpro gcpro1, gcpro2, gcpro3, gcpro4, gcpro5;
459
460 elt = Qnil;
461
462 #ifdef VMS
463 extern DIRENTRY * readdirver ();
464
465 DIRENTRY *((* readfunc) ());
466
467 /* Filename completion on VMS ignores case, since VMS filesys does. */
468 specbind (Qcompletion_ignore_case, Qt);
469
470 readfunc = readdir;
471 if (ver_flag)
472 readfunc = readdirver;
473 file = Fupcase (file);
474 #else /* not VMS */
475 CHECK_STRING (file);
476 #endif /* not VMS */
477
478 #ifdef FILE_SYSTEM_CASE
479 file = FILE_SYSTEM_CASE (file);
480 #endif
481 bestmatch = Qnil;
482 encoded_file = encoded_dir = Qnil;
483 GCPRO5 (file, dirname, bestmatch, encoded_file, encoded_dir);
484 dirname = Fexpand_file_name (dirname, Qnil);
485
486 /* Do completion on the encoded file name
487 because the other names in the directory are (we presume)
488 encoded likewise. We decode the completed string at the end. */
489 encoded_file = ENCODE_FILE (file);
490
491 encoded_dir = ENCODE_FILE (dirname);
492
493 /* With passcount = 0, ignore files that end in an ignored extension.
494 If nothing found then try again with passcount = 1, don't ignore them.
495 If looking for all completions, start with passcount = 1,
496 so always take even the ignored ones.
497
498 ** It would not actually be helpful to the user to ignore any possible
499 completions when making a list of them.** */
500
501 for (passcount = !!all_flag; NILP (bestmatch) && passcount < 2; passcount++)
502 {
503 int inner_count = SPECPDL_INDEX ();
504
505 d = opendir (SDATA (Fdirectory_file_name (encoded_dir)));
506 if (!d)
507 report_file_error ("Opening directory", Fcons (dirname, Qnil));
508
509 record_unwind_protect (directory_files_internal_unwind,
510 make_save_value (d, 0));
511
512 /* Loop reading blocks */
513 /* (att3b compiler bug requires do a null comparison this way) */
514 while (1)
515 {
516 DIRENTRY *dp;
517 int len;
518
519 #ifdef VMS
520 dp = (*readfunc) (d);
521 #else
522 errno = 0;
523 dp = readdir (d);
524 if (dp == NULL && (0
525 # ifdef EAGAIN
526 || errno == EAGAIN
527 # endif
528 # ifdef EINTR
529 || errno == EINTR
530 # endif
531 ))
532 { QUIT; continue; }
533 #endif
534
535 if (!dp) break;
536
537 len = NAMLEN (dp);
538
539 QUIT;
540 if (! DIRENTRY_NONEMPTY (dp)
541 || len < SCHARS (encoded_file)
542 || 0 <= scmp (dp->d_name, SDATA (encoded_file),
543 SCHARS (encoded_file)))
544 continue;
545
546 if (file_name_completion_stat (encoded_dir, dp, &st) < 0)
547 continue;
548
549 directoryp = ((st.st_mode & S_IFMT) == S_IFDIR);
550 tem = Qnil;
551 if (directoryp)
552 {
553 #ifndef TRIVIAL_DIRECTORY_ENTRY
554 #define TRIVIAL_DIRECTORY_ENTRY(n) (!strcmp (n, ".") || !strcmp (n, ".."))
555 #endif
556 /* "." and ".." are never interesting as completions, but are
557 actually in the way in a directory contains only one file. */
558 if (!passcount && TRIVIAL_DIRECTORY_ENTRY (dp->d_name))
559 continue;
560 if (!passcount && len > SCHARS (encoded_file))
561 /* Ignore directories if they match an element of
562 completion-ignored-extensions which ends in a slash. */
563 for (tem = Vcompletion_ignored_extensions;
564 CONSP (tem); tem = XCDR (tem))
565 {
566 int elt_len;
567
568 elt = XCAR (tem);
569 if (!STRINGP (elt))
570 continue;
571 /* Need to encode ELT, since scmp compares unibyte
572 strings only. */
573 elt = ENCODE_FILE (elt);
574 elt_len = SCHARS (elt) - 1; /* -1 for trailing / */
575 if (elt_len <= 0)
576 continue;
577 p1 = SDATA (elt);
578 if (p1[elt_len] != '/')
579 continue;
580 skip = len - elt_len;
581 if (skip < 0)
582 continue;
583
584 if (0 <= scmp (dp->d_name + skip, p1, elt_len))
585 continue;
586 break;
587 }
588 }
589 else
590 {
591 /* Compare extensions-to-be-ignored against end of this file name */
592 /* if name is not an exact match against specified string */
593 if (!passcount && len > SCHARS (encoded_file))
594 /* and exit this for loop if a match is found */
595 for (tem = Vcompletion_ignored_extensions;
596 CONSP (tem); tem = XCDR (tem))
597 {
598 elt = XCAR (tem);
599 if (!STRINGP (elt)) continue;
600 /* Need to encode ELT, since scmp compares unibyte
601 strings only. */
602 elt = ENCODE_FILE (elt);
603 skip = len - SCHARS (elt);
604 if (skip < 0) continue;
605
606 if (0 <= scmp (dp->d_name + skip,
607 SDATA (elt),
608 SCHARS (elt)))
609 continue;
610 break;
611 }
612 }
613
614 /* If an ignored-extensions match was found,
615 don't process this name as a completion. */
616 if (!passcount && CONSP (tem))
617 continue;
618
619 if (!passcount)
620 {
621 Lisp_Object regexps;
622 Lisp_Object zero;
623 XSETFASTINT (zero, 0);
624
625 /* Ignore this element if it fails to match all the regexps. */
626 for (regexps = Vcompletion_regexp_list; CONSP (regexps);
627 regexps = XCDR (regexps))
628 {
629 tem = Fstring_match (XCAR (regexps),
630 make_string (dp->d_name, len), zero);
631 if (NILP (tem))
632 break;
633 }
634 if (CONSP (regexps))
635 continue;
636 }
637
638 /* Update computation of how much all possible completions match */
639
640 matchcount++;
641
642 if (all_flag || NILP (bestmatch))
643 {
644 /* This is a possible completion */
645 if (directoryp)
646 {
647 /* This completion is a directory; make it end with '/' */
648 name = Ffile_name_as_directory (make_string (dp->d_name, len));
649 }
650 else
651 name = make_string (dp->d_name, len);
652 if (all_flag)
653 {
654 name = DECODE_FILE (name);
655 bestmatch = Fcons (name, bestmatch);
656 }
657 else
658 {
659 bestmatch = name;
660 bestmatchsize = SCHARS (name);
661 }
662 }
663 else
664 {
665 compare = min (bestmatchsize, len);
666 p1 = SDATA (bestmatch);
667 p2 = (unsigned char *) dp->d_name;
668 matchsize = scmp(p1, p2, compare);
669 if (matchsize < 0)
670 matchsize = compare;
671 if (completion_ignore_case)
672 {
673 /* If this is an exact match except for case,
674 use it as the best match rather than one that is not
675 an exact match. This way, we get the case pattern
676 of the actual match. */
677 /* This tests that the current file is an exact match
678 but BESTMATCH is not (it is too long). */
679 if ((matchsize == len
680 && matchsize + !!directoryp
681 < SCHARS (bestmatch))
682 ||
683 /* If there is no exact match ignoring case,
684 prefer a match that does not change the case
685 of the input. */
686 /* If there is more than one exact match aside from
687 case, and one of them is exact including case,
688 prefer that one. */
689 /* This == checks that, of current file and BESTMATCH,
690 either both or neither are exact. */
691 (((matchsize == len)
692 ==
693 (matchsize + !!directoryp
694 == SCHARS (bestmatch)))
695 && !bcmp (p2, SDATA (encoded_file), SCHARS (encoded_file))
696 && bcmp (p1, SDATA (encoded_file), SCHARS (encoded_file))))
697 {
698 bestmatch = make_string (dp->d_name, len);
699 if (directoryp)
700 bestmatch = Ffile_name_as_directory (bestmatch);
701 }
702 }
703
704 /* If this dirname all matches, see if implicit following
705 slash does too. */
706 if (directoryp
707 && compare == matchsize
708 && bestmatchsize > matchsize
709 && IS_ANY_SEP (p1[matchsize]))
710 matchsize++;
711 bestmatchsize = matchsize;
712 }
713 }
714 /* This closes the directory. */
715 bestmatch = unbind_to (inner_count, bestmatch);
716 }
717
718 UNGCPRO;
719 bestmatch = unbind_to (count, bestmatch);
720
721 if (all_flag || NILP (bestmatch))
722 {
723 if (STRINGP (bestmatch))
724 bestmatch = DECODE_FILE (bestmatch);
725 return bestmatch;
726 }
727 if (matchcount == 1 && bestmatchsize == SCHARS (file))
728 return Qt;
729 bestmatch = Fsubstring (bestmatch, make_number (0),
730 make_number (bestmatchsize));
731 /* Now that we got the right initial segment of BESTMATCH,
732 decode it from the coding system in use. */
733 bestmatch = DECODE_FILE (bestmatch);
734 return bestmatch;
735 }
736
737 /* Compare exactly LEN chars of strings at S1 and S2,
738 ignoring case if appropriate.
739 Return -1 if strings match,
740 else number of chars that match at the beginning. */
741
742 static int
743 scmp (s1, s2, len)
744 register unsigned char *s1, *s2;
745 int len;
746 {
747 register int l = len;
748
749 if (completion_ignore_case)
750 {
751 while (l && DOWNCASE (*s1++) == DOWNCASE (*s2++))
752 l--;
753 }
754 else
755 {
756 while (l && *s1++ == *s2++)
757 l--;
758 }
759 if (l == 0)
760 return -1;
761 else
762 return len - l;
763 }
764
765 static int
766 file_name_completion_stat (dirname, dp, st_addr)
767 Lisp_Object dirname;
768 DIRENTRY *dp;
769 struct stat *st_addr;
770 {
771 int len = NAMLEN (dp);
772 int pos = SCHARS (dirname);
773 int value;
774 char *fullname = (char *) alloca (len + pos + 2);
775
776 #ifdef MSDOS
777 #if __DJGPP__ > 1
778 /* Some fields of struct stat are *very* expensive to compute on MS-DOS,
779 but aren't required here. Avoid computing the following fields:
780 st_inode, st_size and st_nlink for directories, and the execute bits
781 in st_mode for non-directory files with non-standard extensions. */
782
783 unsigned short save_djstat_flags = _djstat_flags;
784
785 _djstat_flags = _STAT_INODE | _STAT_EXEC_MAGIC | _STAT_DIRSIZE;
786 #endif /* __DJGPP__ > 1 */
787 #endif /* MSDOS */
788
789 bcopy (SDATA (dirname), fullname, pos);
790 #ifndef VMS
791 if (!IS_DIRECTORY_SEP (fullname[pos - 1]))
792 fullname[pos++] = DIRECTORY_SEP;
793 #endif
794
795 bcopy (dp->d_name, fullname + pos, len);
796 fullname[pos + len] = 0;
797
798 #ifdef S_IFLNK
799 /* We want to return success if a link points to a nonexistent file,
800 but we want to return the status for what the link points to,
801 in case it is a directory. */
802 value = lstat (fullname, st_addr);
803 stat (fullname, st_addr);
804 return value;
805 #else
806 value = stat (fullname, st_addr);
807 #ifdef MSDOS
808 #if __DJGPP__ > 1
809 _djstat_flags = save_djstat_flags;
810 #endif /* __DJGPP__ > 1 */
811 #endif /* MSDOS */
812 return value;
813 #endif /* S_IFLNK */
814 }
815 \f
816 #ifdef VMS
817
818 DEFUN ("file-name-all-versions", Ffile_name_all_versions,
819 Sfile_name_all_versions, 2, 2, 0,
820 doc: /* Return a list of all versions of file name FILE in directory DIRECTORY. */)
821 (file, directory)
822 Lisp_Object file, directory;
823 {
824 return file_name_completion (file, directory, 1, 1);
825 }
826
827 DEFUN ("file-version-limit", Ffile_version_limit, Sfile_version_limit, 1, 1, 0,
828 doc: /* Return the maximum number of versions allowed for FILE.
829 Returns nil if the file cannot be opened or if there is no version limit. */)
830 (filename)
831 Lisp_Object filename;
832 {
833 Lisp_Object retval;
834 struct FAB fab;
835 struct RAB rab;
836 struct XABFHC xabfhc;
837 int status;
838
839 filename = Fexpand_file_name (filename, Qnil);
840 fab = cc$rms_fab;
841 xabfhc = cc$rms_xabfhc;
842 fab.fab$l_fna = SDATA (filename);
843 fab.fab$b_fns = strlen (fab.fab$l_fna);
844 fab.fab$l_xab = (char *) &xabfhc;
845 status = sys$open (&fab, 0, 0);
846 if (status != RMS$_NORMAL) /* Probably non-existent file */
847 return Qnil;
848 sys$close (&fab, 0, 0);
849 if (xabfhc.xab$w_verlimit == 32767)
850 return Qnil; /* No version limit */
851 else
852 return make_number (xabfhc.xab$w_verlimit);
853 }
854
855 #endif /* VMS */
856 \f
857 Lisp_Object
858 make_time (time)
859 time_t time;
860 {
861 return Fcons (make_number (time >> 16),
862 Fcons (make_number (time & 0177777), Qnil));
863 }
864
865 DEFUN ("file-attributes", Ffile_attributes, Sfile_attributes, 1, 2, 0,
866 doc: /* Return a list of attributes of file FILENAME.
867 Value is nil if specified file cannot be opened.
868
869 ID-FORMAT specifies the preferred format of attributes uid and gid (see
870 below) - valid values are 'string and 'integer. The latter is the default,
871 but we plan to change that, so you should specify a non-nil value for
872 ID-FORMAT if you use the returned uid or gid.
873
874 Elements of the attribute list are:
875 0. t for directory, string (name linked to) for symbolic link, or nil.
876 1. Number of links to file.
877 2. File uid as a string or an integer. If a string value cannot be
878 looked up, the integer value is returned.
879 3. File gid, likewise.
880 4. Last access time, as a list of two integers.
881 First integer has high-order 16 bits of time, second has low 16 bits.
882 5. Last modification time, likewise.
883 6. Last status change time, likewise.
884 7. Size in bytes.
885 This is a floating point number if the size is too large for an integer.
886 8. File modes, as a string of ten letters or dashes as in ls -l.
887 9. t iff file's gid would change if file were deleted and recreated.
888 10. inode number. If inode number is larger than the Emacs integer,
889 this is a cons cell containing two integers: first the high part,
890 then the low 16 bits.
891 11. Device number. If it is larger than the Emacs integer, this is
892 a cons cell, similar to the inode number. */)
893 (filename, id_format)
894 Lisp_Object filename, id_format;
895 {
896 Lisp_Object values[12];
897 Lisp_Object encoded;
898 struct stat s;
899 struct passwd *pw;
900 struct group *gr;
901 #if defined (BSD4_2) || defined (BSD4_3)
902 Lisp_Object dirname;
903 struct stat sdir;
904 #endif
905 char modes[10];
906 Lisp_Object handler;
907 struct gcpro gcpro1;
908
909 filename = Fexpand_file_name (filename, Qnil);
910
911 /* If the file name has special constructs in it,
912 call the corresponding file handler. */
913 handler = Ffind_file_name_handler (filename, Qfile_attributes);
914 if (!NILP (handler))
915 { /* Only pass the extra arg if it is used to help backward compatibility
916 with old file handlers which do not implement the new arg. --Stef */
917 if (NILP (id_format))
918 return call2 (handler, Qfile_attributes, filename);
919 else
920 return call3 (handler, Qfile_attributes, filename, id_format);
921 }
922
923 GCPRO1 (filename);
924 encoded = ENCODE_FILE (filename);
925 UNGCPRO;
926
927 if (lstat (SDATA (encoded), &s) < 0)
928 return Qnil;
929
930 switch (s.st_mode & S_IFMT)
931 {
932 default:
933 values[0] = Qnil; break;
934 case S_IFDIR:
935 values[0] = Qt; break;
936 #ifdef S_IFLNK
937 case S_IFLNK:
938 values[0] = Ffile_symlink_p (filename); break;
939 #endif
940 }
941 values[1] = make_number (s.st_nlink);
942 if (NILP (id_format) || EQ (id_format, Qinteger))
943 {
944 values[2] = make_number (s.st_uid);
945 values[3] = make_number (s.st_gid);
946 }
947 else
948 {
949 pw = (struct passwd *) getpwuid (s.st_uid);
950 values[2] = (pw ? build_string (pw->pw_name) : make_number (s.st_uid));
951 gr = (struct group *) getgrgid (s.st_gid);
952 values[3] = (gr ? build_string (gr->gr_name) : make_number (s.st_gid));
953 }
954 values[4] = make_time (s.st_atime);
955 values[5] = make_time (s.st_mtime);
956 values[6] = make_time (s.st_ctime);
957 values[7] = make_number (s.st_size);
958 /* If the size is out of range for an integer, return a float. */
959 if (XINT (values[7]) != s.st_size)
960 values[7] = make_float ((double)s.st_size);
961 /* If the size is negative, and its type is long, convert it back to
962 positive. */
963 if (s.st_size < 0 && sizeof (s.st_size) == sizeof (long))
964 values[7] = make_float ((double) ((unsigned long) s.st_size));
965
966 filemodestring (&s, modes);
967 values[8] = make_string (modes, 10);
968 #if defined (BSD4_2) || defined (BSD4_3) /* file gid will be dir gid */
969 dirname = Ffile_name_directory (filename);
970 if (! NILP (dirname))
971 encoded = ENCODE_FILE (dirname);
972 if (! NILP (dirname) && stat (SDATA (encoded), &sdir) == 0)
973 values[9] = (sdir.st_gid != s.st_gid) ? Qt : Qnil;
974 else /* if we can't tell, assume worst */
975 values[9] = Qt;
976 #else /* file gid will be egid */
977 values[9] = (s.st_gid != getegid ()) ? Qt : Qnil;
978 #endif /* BSD4_2 (or BSD4_3) */
979 if (FIXNUM_OVERFLOW_P (s.st_ino))
980 /* To allow inode numbers larger than VALBITS, separate the bottom
981 16 bits. */
982 values[10] = Fcons (make_number (s.st_ino >> 16),
983 make_number (s.st_ino & 0xffff));
984 else
985 /* But keep the most common cases as integers. */
986 values[10] = make_number (s.st_ino);
987
988 /* Likewise for device. */
989 if (FIXNUM_OVERFLOW_P (s.st_dev))
990 values[11] = Fcons (make_number (s.st_dev >> 16),
991 make_number (s.st_dev & 0xffff));
992 else
993 values[11] = make_number (s.st_dev);
994
995 return Flist (sizeof(values) / sizeof(values[0]), values);
996 }
997
998 DEFUN ("file-attributes-lessp", Ffile_attributes_lessp, Sfile_attributes_lessp, 2, 2, 0,
999 doc: /* Return t if first arg file attributes list is less than second.
1000 Comparison is in lexicographic order and case is significant. */)
1001 (f1, f2)
1002 Lisp_Object f1, f2;
1003 {
1004 return Fstring_lessp (Fcar (f1), Fcar (f2));
1005 }
1006 \f
1007 void
1008 syms_of_dired ()
1009 {
1010 Qdirectory_files = intern ("directory-files");
1011 Qdirectory_files_and_attributes = intern ("directory-files-and-attributes");
1012 Qfile_name_completion = intern ("file-name-completion");
1013 Qfile_name_all_completions = intern ("file-name-all-completions");
1014 Qfile_attributes = intern ("file-attributes");
1015 Qfile_attributes_lessp = intern ("file-attributes-lessp");
1016
1017 staticpro (&Qdirectory_files);
1018 staticpro (&Qdirectory_files_and_attributes);
1019 staticpro (&Qfile_name_completion);
1020 staticpro (&Qfile_name_all_completions);
1021 staticpro (&Qfile_attributes);
1022 staticpro (&Qfile_attributes_lessp);
1023
1024 defsubr (&Sdirectory_files);
1025 defsubr (&Sdirectory_files_and_attributes);
1026 defsubr (&Sfile_name_completion);
1027 #ifdef VMS
1028 defsubr (&Sfile_name_all_versions);
1029 defsubr (&Sfile_version_limit);
1030 #endif /* VMS */
1031 defsubr (&Sfile_name_all_completions);
1032 defsubr (&Sfile_attributes);
1033 defsubr (&Sfile_attributes_lessp);
1034
1035 #ifdef VMS
1036 Qcompletion_ignore_case = intern ("completion-ignore-case");
1037 staticpro (&Qcompletion_ignore_case);
1038 #endif /* VMS */
1039
1040 DEFVAR_LISP ("completion-ignored-extensions", &Vcompletion_ignored_extensions,
1041 doc: /* Completion ignores file names ending in any string in this list.
1042 It does not ignore them if all possible completions end in one of
1043 these strings or when displaying a list of completions.
1044 It ignores directory names if they match any string in this list which
1045 ends in a slash. */);
1046 Vcompletion_ignored_extensions = Qnil;
1047 }
1048
1049 /* arch-tag: 1ac8deca-4d8f-4d41-ade9-089154d98c03
1050 (do not change this comment) */