1 /* Part of CPP library. File handling.
2 Copyright (C) 1986, 1987, 1989, 1992, 1993, 1994, 1995, 1998,
3 1999, 2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
4 Written by Per Bothner, 1994.
5 Based on CCCP program by Paul Rubin, June 1986
6 Adapted to ANSI C, Richard Stallman, Jan 1987
7 Split out of cpplib.c, Zack Weinberg, Oct 1998
8 Reimplemented, Neil Booth, Jul 2003
10 This program is free software; you can redistribute it and/or modify it
11 under the terms of the GNU General Public License as published by the
12 Free Software Foundation; either version 2, or (at your option) any
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program; if not, write to the Free Software
22 Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
33 /* Variable length record files on VMS will have a stat size that includes
34 record control characters that won't be included in the read size. */
36 # define FAB_C_VAR 2 /* variable length records (see Starlet fabdef.h) */
37 # define STAT_SIZE_RELIABLE(ST) ((ST).st_fab_rfm != FAB_C_VAR)
39 # define STAT_SIZE_RELIABLE(ST) true
43 /* For DJGPP redirected input is opened in text mode. */
44 # define set_stdin_to_binary_mode() \
45 if (! isatty (0)) setmode (0, O_BINARY)
47 # define set_stdin_to_binary_mode() /* Nothing */
50 /* This structure represents a file searched for by CPP, whether it
51 exists or not. An instance may be pointed to by more than one
52 file_hash_entry; at present no reference count is kept. */
55 /* Filename as given to #include or command line switch. */
58 /* The full path used to find the file. */
61 /* The full path of the pch file. */
64 /* The file's path with the basename stripped. NULL if it hasn't
65 been calculated yet. */
68 /* Chain through all files. */
69 struct _cpp_file
*next_file
;
71 /* The contents of NAME after calling read_file(). */
74 /* The macro, if any, preventing re-inclusion. */
75 const cpp_hashnode
*cmacro
;
77 /* The directory in the search path where FILE was found. Used for
78 #include_next and determining whether a header is a system
82 /* As filled in by stat(2) for the file. */
85 /* File descriptor. Invalid if -1, otherwise open. */
88 /* Zero if this file was successfully opened and stat()-ed,
89 otherwise errno obtained from failure. */
92 /* Number of times the file has been stacked for preprocessing. */
93 unsigned short stack_count
;
95 /* If opened with #import or contains #pragma once. */
98 /* If read() failed before. */
101 /* If this file is the main file. */
104 /* If BUFFER above contains the true contents of the file. */
107 /* File is a PCH (on return from find_include_file). */
111 /* A singly-linked list for all searches for a given file name, with
112 its head pointed to by a slot in FILE_HASH. The file name is what
113 appeared between the quotes in a #include directive; it can be
114 determined implicitly from the hash table location or explicitly
117 FILE is a structure containing details about the file that was
118 found with that search, or details of how the search failed.
120 START_DIR is the starting location of the search in the include
121 chain. The current directories for "" includes are also hashed in
122 the hash table and therefore unique. Files that are looked up
123 without using a search path, such as absolute filenames and file
124 names from the command line share a special starting directory so
125 they don't cause cache hits with normal include-chain lookups.
127 If START_DIR is NULL then the entry is for a directory, not a file,
128 and the directory is in DIR. Since the starting point in a file
129 lookup chain is never NULL, this means that simple pointer
130 comparisons against START_DIR can be made to determine cache hits
133 If a cache lookup fails because of e.g. an extra "./" in the path,
134 then nothing will break. It is just less efficient as CPP will
135 have to do more work re-preprocessing the file, and/or comparing
136 its contents against earlier once-only files.
138 struct file_hash_entry
140 struct file_hash_entry
*next
;
149 static bool open_file (_cpp_file
*file
);
150 static bool pch_open_file (cpp_reader
*pfile
, _cpp_file
*file
,
152 static bool find_file_in_dir (cpp_reader
*pfile
, _cpp_file
*file
,
154 static bool read_file_guts (cpp_reader
*pfile
, _cpp_file
*file
);
155 static bool read_file (cpp_reader
*pfile
, _cpp_file
*file
);
156 static bool should_stack_file (cpp_reader
*, _cpp_file
*file
, bool import
);
157 static struct cpp_dir
*search_path_head (cpp_reader
*, const char *fname
,
158 int angle_brackets
, enum include_type
);
159 static const char *dir_name_of_file (_cpp_file
*file
);
160 static void open_file_failed (cpp_reader
*pfile
, _cpp_file
*file
);
161 static struct file_hash_entry
*search_cache (struct file_hash_entry
*head
,
162 const cpp_dir
*start_dir
);
163 static _cpp_file
*make_cpp_file (cpp_reader
*, cpp_dir
*, const char *fname
);
164 static void destroy_cpp_file (_cpp_file
*);
165 static cpp_dir
*make_cpp_dir (cpp_reader
*, const char *dir_name
, int sysp
);
166 static void allocate_file_hash_entries (cpp_reader
*pfile
);
167 static struct file_hash_entry
*new_file_hash_entry (cpp_reader
*pfile
);
168 static int report_missing_guard (void **slot
, void *b
);
169 static hashval_t
file_hash_hash (const void *p
);
170 static int file_hash_eq (const void *p
, const void *q
);
171 static char *read_filename_string (int ch
, FILE *f
);
172 static void read_name_map (cpp_dir
*dir
);
173 static char *remap_filename (cpp_reader
*pfile
, _cpp_file
*file
);
174 static char *append_file_to_dir (const char *fname
, cpp_dir
*dir
);
175 static bool validate_pch (cpp_reader
*, _cpp_file
*file
, const char *pchname
);
176 static int pchf_adder (void **slot
, void *data
);
177 static int pchf_save_compare (const void *e1
, const void *e2
);
178 static int pchf_compare (const void *d_p
, const void *e_p
);
179 static bool check_file_against_entries (cpp_reader
*, _cpp_file
*, bool);
181 /* Given a filename in FILE->PATH, with the empty string interpreted
184 On success FILE contains an open file descriptor and stat
185 information for the file. On failure the file descriptor is -1 and
186 the appropriate errno is also stored in FILE. Returns TRUE iff
189 We used to open files in nonblocking mode, but that caused more
190 problems than it solved. Do take care not to acquire a controlling
191 terminal by mistake (this can't happen on sane systems, but
192 paranoia is a virtue).
194 Use the three-argument form of open even though we aren't
195 specifying O_CREAT, to defend against broken system headers.
197 O_BINARY tells some runtime libraries (notably DJGPP) not to do
198 newline translation; we can handle DOS line breaks just fine
201 open_file (_cpp_file
*file
)
203 if (file
->path
[0] == '\0')
206 set_stdin_to_binary_mode ();
209 file
->fd
= open (file
->path
, O_RDONLY
| O_NOCTTY
| O_BINARY
, 0666);
213 if (fstat (file
->fd
, &file
->st
) == 0)
215 if (!S_ISDIR (file
->st
.st_mode
))
221 /* Ignore a directory and continue the search. The file we're
222 looking for may be elsewhere in the search path. */
229 else if (errno
== ENOTDIR
)
232 file
->err_no
= errno
;
237 /* Temporary PCH intercept of opening a file. Try to find a PCH file
238 based on FILE->name and FILE->dir, and test those found for
239 validity using PFILE->cb.valid_pch. Return true iff a valid file is
240 found. Set *INVALID_PCH if a PCH file is found but wasn't valid. */
243 pch_open_file (cpp_reader
*pfile
, _cpp_file
*file
, bool *invalid_pch
)
245 static const char extension
[] = ".gch";
246 const char *path
= file
->path
;
252 /* No PCH on <stdin> or if not requested. */
253 if (file
->name
[0] == '\0' || !pfile
->cb
.valid_pch
)
256 flen
= strlen (path
);
257 len
= flen
+ sizeof (extension
);
258 pchname
= xmalloc (len
);
259 memcpy (pchname
, path
, flen
);
260 memcpy (pchname
+ flen
, extension
, sizeof (extension
));
262 if (stat (pchname
, &st
) == 0)
266 size_t dlen
, plen
= len
;
268 if (!S_ISDIR (st
.st_mode
))
269 valid
= validate_pch (pfile
, file
, pchname
);
270 else if ((pchdir
= opendir (pchname
)) != NULL
)
272 pchname
[plen
- 1] = '/';
273 while ((d
= readdir (pchdir
)) != NULL
)
275 dlen
= strlen (d
->d_name
) + 1;
276 if ((strcmp (d
->d_name
, ".") == 0)
277 || (strcmp (d
->d_name
, "..") == 0))
279 if (dlen
+ plen
> len
)
282 pchname
= xrealloc (pchname
, len
);
284 memcpy (pchname
+ plen
, d
->d_name
, dlen
);
285 valid
= validate_pch (pfile
, file
, pchname
);
298 file
->pchname
= pchname
;
305 /* Try to open the path FILE->name appended to FILE->dir. This is
306 where remap and PCH intercept the file lookup process. Return true
307 if the file was found, whether or not the open was successful.
308 Set *INVALID_PCH to true if a PCH file is found but wasn't valid. */
311 find_file_in_dir (cpp_reader
*pfile
, _cpp_file
*file
, bool *invalid_pch
)
315 if (CPP_OPTION (pfile
, remap
) && (path
= remap_filename (pfile
, file
)))
318 if (file
->dir
->construct
)
319 path
= file
->dir
->construct (file
->name
, file
->dir
);
321 path
= append_file_to_dir (file
->name
, file
->dir
);
326 if (pch_open_file (pfile
, file
, invalid_pch
))
329 if (open_file (file
))
332 if (file
->err_no
!= ENOENT
)
334 open_file_failed (pfile
, file
);
339 file
->path
= file
->name
;
343 file
->err_no
= ENOENT
;
350 /* Return tue iff the missing_header callback found the given HEADER. */
352 search_path_exhausted (cpp_reader
*pfile
, const char *header
, _cpp_file
*file
)
354 missing_header_cb func
= pfile
->cb
.missing_header
;
356 /* When the regular search path doesn't work, try context dependent
357 headers search paths. */
359 && file
->dir
== NULL
)
361 if ((file
->path
= func (pfile
, header
, &file
->dir
)) != NULL
)
363 if (open_file (file
))
365 free ((void *)file
->path
);
367 file
->path
= file
->name
;
374 _cpp_find_failed (_cpp_file
*file
)
376 return file
->err_no
!= 0;
379 /* Given a filename FNAME search for such a file in the include path
380 starting from START_DIR. If FNAME is the empty string it is
381 interpreted as STDIN if START_DIR is PFILE->no_search_path.
383 If the file is not found in the file cache fall back to the O/S and
384 add the result to our cache.
386 If the file was not found in the filesystem, or there was an error
387 opening it, then ERR_NO is nonzero and FD is -1. If the file was
388 found, then ERR_NO is zero and FD could be -1 or an open file
389 descriptor. FD can be -1 if the file was found in the cache and
390 had previously been closed. To open it again pass the return value
394 _cpp_find_file (cpp_reader
*pfile
, const char *fname
, cpp_dir
*start_dir
, bool fake
)
396 struct file_hash_entry
*entry
, **hash_slot
;
398 bool invalid_pch
= false;
400 /* Ensure we get no confusion between cached files and directories. */
401 if (start_dir
== NULL
)
402 cpp_error (pfile
, CPP_DL_ICE
, "NULL directory in find_file");
404 hash_slot
= (struct file_hash_entry
**)
405 htab_find_slot_with_hash (pfile
->file_hash
, fname
,
406 htab_hash_string (fname
),
409 /* First check the cache before we resort to memory allocation. */
410 entry
= search_cache (*hash_slot
, start_dir
);
412 return entry
->u
.file
;
414 file
= make_cpp_file (pfile
, start_dir
, fname
);
416 /* Try each path in the include chain. */
419 if (file
->dir
== pfile
->quote_include
420 || file
->dir
== pfile
->bracket_include
)
422 entry
= search_cache (*hash_slot
, file
->dir
);
425 /* Found the same file again. Record it as reachable
426 from this position, too. */
427 free ((char *) file
->name
);
429 file
= entry
->u
.file
;
434 if (find_file_in_dir (pfile
, file
, &invalid_pch
))
437 file
->dir
= file
->dir
->next
;
438 if (file
->dir
== NULL
)
440 if (search_path_exhausted (pfile
, fname
, file
))
442 /* Although this file must not go in the cache, because
443 the file found might depend on things (like the current file)
444 that aren't represented in the cache, it still has to go in
445 the list of all files so that #import works. */
446 file
->next_file
= pfile
->all_files
;
447 pfile
->all_files
= file
;
451 open_file_failed (pfile
, file
);
454 cpp_error (pfile
, CPP_DL_ERROR
,
455 "one or more PCH files were found, but they were invalid");
456 if (!cpp_get_options (pfile
)->warn_invalid_pch
)
457 cpp_error (pfile
, CPP_DL_ERROR
,
458 "use -Winvalid-pch for more information");
464 /* This is a new file; put it in the list. */
465 file
->next_file
= pfile
->all_files
;
466 pfile
->all_files
= file
;
468 /* If this file was found in the directory-of-the-current-file,
469 check whether that directory is reachable via one of the normal
470 search paths. If so, we must record this entry as being
471 reachable that way, otherwise we will mistakenly reprocess this
472 file if it is included later from the normal search path. */
473 if (file
->dir
&& start_dir
->next
== pfile
->quote_include
)
476 cpp_dir
*proper_start_dir
= pfile
->quote_include
;
478 for (d
= proper_start_dir
;; d
= d
->next
)
480 if (d
== pfile
->bracket_include
)
481 proper_start_dir
= d
;
484 proper_start_dir
= 0;
487 /* file->dir->name will have a trailing slash. */
488 if (!strncmp (d
->name
, file
->dir
->name
, file
->dir
->len
- 1))
491 if (proper_start_dir
)
492 start_dir
= proper_start_dir
;
496 /* Store this new result in the hash table. */
497 entry
= new_file_hash_entry (pfile
);
498 entry
->next
= *hash_slot
;
499 entry
->start_dir
= start_dir
;
500 entry
->u
.file
= file
;
506 /* Read a file into FILE->buffer, returning true on success.
508 If FILE->fd is something weird, like a block device, we don't want
509 to read it at all. Don't even try to figure out what something is,
510 except for plain files and block devices, since there is no
511 reliable portable way of doing this.
513 FIXME: Flush file cache and try again if we run out of memory. */
515 read_file_guts (cpp_reader
*pfile
, _cpp_file
*file
)
517 ssize_t size
, total
, count
;
521 if (S_ISBLK (file
->st
.st_mode
))
523 cpp_error (pfile
, CPP_DL_ERROR
, "%s is a block device", file
->path
);
527 regular
= S_ISREG (file
->st
.st_mode
);
530 /* off_t might have a wider range than ssize_t - in other words,
531 the max size of a file might be bigger than the address
532 space. We can't handle a file that large. (Anyone with
533 a single source file bigger than 2GB needs to rethink
534 their coding style.) Some systems (e.g. AIX 4.1) define
535 SSIZE_MAX to be much smaller than the actual range of the
536 type. Use INTTYPE_MAXIMUM unconditionally to ensure this
538 if (file
->st
.st_size
> INTTYPE_MAXIMUM (ssize_t
))
540 cpp_error (pfile
, CPP_DL_ERROR
, "%s is too large", file
->path
);
544 size
= file
->st
.st_size
;
547 /* 8 kilobytes is a sensible starting size. It ought to be bigger
548 than the kernel pipe buffer, and it's definitely bigger than
549 the majority of C source files. */
552 buf
= xmalloc (size
+ 1);
554 while ((count
= read (file
->fd
, buf
+ total
, size
- total
)) > 0)
563 buf
= xrealloc (buf
, size
+ 1);
569 cpp_errno (pfile
, CPP_DL_ERROR
, file
->path
);
573 if (regular
&& total
!= size
&& STAT_SIZE_RELIABLE (file
->st
))
574 cpp_error (pfile
, CPP_DL_WARNING
,
575 "%s is shorter than expected", file
->path
);
577 file
->buffer
= _cpp_convert_input (pfile
, CPP_OPTION (pfile
, input_charset
),
578 buf
, size
, total
, &file
->st
.st_size
);
579 file
->buffer_valid
= true;
584 /* Convenience wrapper around read_file_guts that opens the file if
585 necessary and closes the file descriptor after reading. FILE must
586 have been passed through find_file() at some stage. */
588 read_file (cpp_reader
*pfile
, _cpp_file
*file
)
590 /* If we already have its contents in memory, succeed immediately. */
591 if (file
->buffer_valid
)
594 /* If an earlier read failed for some reason don't try again. */
595 if (file
->dont_read
|| file
->err_no
)
598 if (file
->fd
== -1 && !open_file (file
))
600 open_file_failed (pfile
, file
);
604 file
->dont_read
= !read_file_guts (pfile
, file
);
608 return !file
->dont_read
;
611 /* Returns TRUE if FILE's contents have been successfully placed in
612 FILE->buffer and the file should be stacked, otherwise false. */
614 should_stack_file (cpp_reader
*pfile
, _cpp_file
*file
, bool import
)
618 /* Skip once-only files. */
622 /* We must mark the file once-only if #import now, before header
623 guard checks. Otherwise, undefining the header guard might
624 cause the file to be re-stacked. */
627 _cpp_mark_file_once_only (pfile
, file
);
629 /* Don't stack files that have been stacked before. */
630 if (file
->stack_count
)
634 /* Skip if the file had a header guard and the macro is defined.
635 PCH relies on this appearing before the PCH handler below. */
636 if (file
->cmacro
&& file
->cmacro
->type
== NT_MACRO
)
639 /* Handle PCH files immediately; don't stack them. */
642 pfile
->cb
.read_pch (pfile
, file
->pchname
, file
->fd
, file
->path
);
648 if (!read_file (pfile
, file
))
651 /* Check the file against the PCH file. This is done before
652 checking against files we've already seen, since it may save on
654 if (check_file_against_entries (pfile
, file
, import
))
656 /* If this isn't a #import, but yet we can't include the file,
657 that means that it was #import-ed in the PCH file,
658 so we can never include it again. */
660 _cpp_mark_file_once_only (pfile
, file
);
664 /* Now we've read the file's contents, we can stack it if there
665 are no once-only files. */
666 if (!pfile
->seen_once_only
)
669 /* We may have read the file under a different name. Look
670 for likely candidates and compare file contents to be sure. */
671 for (f
= pfile
->all_files
; f
; f
= f
->next_file
)
676 if ((import
|| f
->once_only
)
678 && f
->st
.st_mtime
== file
->st
.st_mtime
679 && f
->st
.st_size
== file
->st
.st_size
)
682 bool same_file_p
= false;
684 if (f
->buffer
&& !f
->buffer_valid
)
686 /* We already have a buffer but it is not valid, because
687 the file is still stacked. Make a new one. */
688 ref_file
= make_cpp_file (pfile
, f
->dir
, f
->name
);
689 ref_file
->path
= f
->path
;
692 /* The file is not stacked anymore. We can reuse it. */
695 same_file_p
= read_file (pfile
, ref_file
)
696 /* Size might have changed in read_file(). */
697 && ref_file
->st
.st_size
== file
->st
.st_size
698 && !memcmp (ref_file
->buffer
,
702 if (f
->buffer
&& !f
->buffer_valid
)
705 destroy_cpp_file (ref_file
);
716 /* Place the file referenced by FILE into a new buffer on the buffer
717 stack if possible. IMPORT is true if this stacking attempt is
718 because of a #import directive. Returns true if a buffer is
721 _cpp_stack_file (cpp_reader
*pfile
, _cpp_file
*file
, bool import
)
726 if (!should_stack_file (pfile
, file
, import
))
729 if (pfile
->buffer
== NULL
|| file
->dir
== NULL
)
732 sysp
= MAX (pfile
->buffer
->sysp
, file
->dir
->sysp
);
734 /* Add the file to the dependencies on its first inclusion. */
735 if (CPP_OPTION (pfile
, deps
.style
) > !!sysp
&& !file
->stack_count
)
737 if (!file
->main_file
|| !CPP_OPTION (pfile
, deps
.ignore_main_file
))
738 deps_add_dep (pfile
->deps
, file
->path
);
741 /* Clear buffer_valid since _cpp_clean_line messes it up. */
742 file
->buffer_valid
= false;
745 /* Stack the buffer. */
746 buffer
= cpp_push_buffer (pfile
, file
->buffer
, file
->st
.st_size
,
747 CPP_OPTION (pfile
, preprocessed
));
751 /* Initialize controlling macro state. */
752 pfile
->mi_valid
= true;
753 pfile
->mi_cmacro
= 0;
755 /* Generate the call back. */
756 _cpp_do_file_change (pfile
, LC_ENTER
, file
->path
, 1, sysp
);
761 /* Mark FILE to be included once only. */
763 _cpp_mark_file_once_only (cpp_reader
*pfile
, _cpp_file
*file
)
765 pfile
->seen_once_only
= true;
766 file
->once_only
= true;
769 /* Return the directory from which searching for FNAME should start,
770 considering the directive TYPE and ANGLE_BRACKETS. If there is
771 nothing left in the path, returns NULL. */
772 static struct cpp_dir
*
773 search_path_head (cpp_reader
*pfile
, const char *fname
, int angle_brackets
,
774 enum include_type type
)
779 if (IS_ABSOLUTE_PATH (fname
))
780 return &pfile
->no_search_path
;
782 /* pfile->buffer is NULL when processing an -include command-line flag. */
783 file
= pfile
->buffer
== NULL
? pfile
->main_file
: pfile
->buffer
->file
;
785 /* For #include_next, skip in the search path past the dir in which
786 the current file was found, but if it was found via an absolute
787 path use the normal search logic. */
788 if (type
== IT_INCLUDE_NEXT
&& file
->dir
)
789 dir
= file
->dir
->next
;
790 else if (angle_brackets
)
791 dir
= pfile
->bracket_include
;
792 else if (type
== IT_CMDLINE
)
793 /* -include and -imacros use the #include "" chain with the
794 preprocessor's cwd prepended. */
795 return make_cpp_dir (pfile
, "./", false);
796 else if (pfile
->quote_ignores_source_dir
)
797 dir
= pfile
->quote_include
;
799 return make_cpp_dir (pfile
, dir_name_of_file (file
),
800 pfile
->buffer
? pfile
->buffer
->sysp
: 0);
803 cpp_error (pfile
, CPP_DL_ERROR
,
804 "no include path in which to search for %s", fname
);
809 /* Strip the basename from the file's path. It ends with a slash if
810 of nonzero length. Note that this procedure also works for
811 <stdin>, which is represented by the empty string. */
813 dir_name_of_file (_cpp_file
*file
)
817 size_t len
= lbasename (file
->path
) - file
->path
;
818 char *dir_name
= xmalloc (len
+ 1);
820 memcpy (dir_name
, file
->path
, len
);
821 dir_name
[len
] = '\0';
822 file
->dir_name
= dir_name
;
825 return file
->dir_name
;
828 /* Handles #include-family directives (distinguished by TYPE),
829 including HEADER, and the command line -imacros and -include.
830 Returns true if a buffer was stacked. */
832 _cpp_stack_include (cpp_reader
*pfile
, const char *fname
, int angle_brackets
,
833 enum include_type type
)
838 dir
= search_path_head (pfile
, fname
, angle_brackets
, type
);
842 file
= _cpp_find_file (pfile
, fname
, dir
, false);
844 /* Compensate for the increment in linemap_add. In the case of a
845 normal #include, we're currently at the start of the line
846 *following* the #include. A separate source_location for this
847 location makes no sense (until we do the LC_LEAVE), and
848 complicates LAST_SOURCE_LINE_LOCATION. This does not apply if we
849 found a PCH file (in which case linemap_add is not called) or we
850 were included from the command-line. */
851 if (! file
->pch
&& file
->err_no
== 0 && type
!= IT_CMDLINE
)
852 pfile
->line_table
->highest_location
--;
854 return _cpp_stack_file (pfile
, file
, type
== IT_IMPORT
);
857 /* Could not open FILE. The complication is dependency output. */
859 open_file_failed (cpp_reader
*pfile
, _cpp_file
*file
)
861 int sysp
= pfile
->line_table
->highest_line
> 1 && pfile
->buffer
? pfile
->buffer
->sysp
: 0;
862 bool print_dep
= CPP_OPTION (pfile
, deps
.style
) > !!sysp
;
864 errno
= file
->err_no
;
865 if (print_dep
&& CPP_OPTION (pfile
, deps
.missing_files
) && errno
== ENOENT
)
866 deps_add_dep (pfile
->deps
, file
->name
);
869 /* If we are outputting dependencies but not for this file then
870 don't error because we can still produce correct output. */
871 if (CPP_OPTION (pfile
, deps
.style
) && ! print_dep
)
872 cpp_errno (pfile
, CPP_DL_WARNING
, file
->path
);
874 cpp_errno (pfile
, CPP_DL_ERROR
, file
->path
);
878 /* Search in the chain beginning at HEAD for a file whose search path
879 started at START_DIR != NULL. */
880 static struct file_hash_entry
*
881 search_cache (struct file_hash_entry
*head
, const cpp_dir
*start_dir
)
883 struct file_hash_entry
*p
;
885 /* Look for a file that was found from a search starting at the
887 for (p
= head
; p
; p
= p
->next
)
888 if (p
->start_dir
== start_dir
)
893 /* Allocate a new _cpp_file structure. */
895 make_cpp_file (cpp_reader
*pfile
, cpp_dir
*dir
, const char *fname
)
899 file
= xcalloc (1, sizeof (_cpp_file
));
900 file
->main_file
= !pfile
->buffer
;
903 file
->name
= xstrdup (fname
);
908 /* Release a _cpp_file structure. */
910 destroy_cpp_file (_cpp_file
*file
)
913 free ((void *) file
->buffer
);
914 free ((void *) file
->name
);
918 /* A hash of directory names. The directory names are the path names
919 of files which contain a #include "", the included file name is
920 appended to this directories.
922 To avoid duplicate entries we follow the convention that all
923 non-empty directory names should end in a '/'. DIR_NAME must be
924 stored in permanently allocated memory. */
926 make_cpp_dir (cpp_reader
*pfile
, const char *dir_name
, int sysp
)
928 struct file_hash_entry
*entry
, **hash_slot
;
931 hash_slot
= (struct file_hash_entry
**)
932 htab_find_slot_with_hash (pfile
->dir_hash
, dir_name
,
933 htab_hash_string (dir_name
),
936 /* Have we already hashed this directory? */
937 for (entry
= *hash_slot
; entry
; entry
= entry
->next
)
938 if (entry
->start_dir
== NULL
)
941 dir
= xcalloc (1, sizeof (cpp_dir
));
942 dir
->next
= pfile
->quote_include
;
943 dir
->name
= (char *) dir_name
;
944 dir
->len
= strlen (dir_name
);
948 /* Store this new result in the hash table. */
949 entry
= new_file_hash_entry (pfile
);
950 entry
->next
= *hash_slot
;
951 entry
->start_dir
= NULL
;
958 /* Create a new block of memory for file hash entries. */
960 allocate_file_hash_entries (cpp_reader
*pfile
)
962 pfile
->file_hash_entries_used
= 0;
963 pfile
->file_hash_entries_allocated
= 127;
964 pfile
->file_hash_entries
= xmalloc
965 (pfile
->file_hash_entries_allocated
* sizeof (struct file_hash_entry
));
968 /* Return a new file hash entry. */
969 static struct file_hash_entry
*
970 new_file_hash_entry (cpp_reader
*pfile
)
972 if (pfile
->file_hash_entries_used
== pfile
->file_hash_entries_allocated
)
973 allocate_file_hash_entries (pfile
);
975 return &pfile
->file_hash_entries
[pfile
->file_hash_entries_used
++];
978 /* Returns TRUE if a file FNAME has ever been successfully opened.
979 This routine is not intended to correctly handle filenames aliased
980 by links or redundant . or .. traversals etc. */
982 cpp_included (cpp_reader
*pfile
, const char *fname
)
984 struct file_hash_entry
*entry
;
986 entry
= htab_find_with_hash (pfile
->file_hash
, fname
,
987 htab_hash_string (fname
));
989 while (entry
&& (entry
->start_dir
== NULL
|| entry
->u
.file
->err_no
))
992 return entry
!= NULL
;
995 /* Calculate the hash value of a file hash entry P. */
998 file_hash_hash (const void *p
)
1000 struct file_hash_entry
*entry
= (struct file_hash_entry
*) p
;
1002 if (entry
->start_dir
)
1003 hname
= entry
->u
.file
->name
;
1005 hname
= entry
->u
.dir
->name
;
1007 return htab_hash_string (hname
);
1010 /* Compare a string Q against a file hash entry P. */
1012 file_hash_eq (const void *p
, const void *q
)
1014 struct file_hash_entry
*entry
= (struct file_hash_entry
*) p
;
1015 const char *fname
= (const char *) q
;
1018 if (entry
->start_dir
)
1019 hname
= entry
->u
.file
->name
;
1021 hname
= entry
->u
.dir
->name
;
1023 return strcmp (hname
, fname
) == 0;
1026 /* Initialize everything in this source file. */
1028 _cpp_init_files (cpp_reader
*pfile
)
1030 pfile
->file_hash
= htab_create_alloc (127, file_hash_hash
, file_hash_eq
,
1031 NULL
, xcalloc
, free
);
1032 pfile
->dir_hash
= htab_create_alloc (127, file_hash_hash
, file_hash_eq
,
1033 NULL
, xcalloc
, free
);
1034 allocate_file_hash_entries (pfile
);
1037 /* Finalize everything in this source file. */
1039 _cpp_cleanup_files (cpp_reader
*pfile
)
1041 htab_delete (pfile
->file_hash
);
1042 htab_delete (pfile
->dir_hash
);
1045 /* Enter a file name in the hash for the sake of cpp_included. */
1047 _cpp_fake_include (cpp_reader
*pfile
, const char *fname
)
1049 _cpp_find_file (pfile
, fname
, pfile
->buffer
->file
->dir
, true);
1052 /* Not everyone who wants to set system-header-ness on a buffer can
1053 see the details of a buffer. This is an exported interface because
1054 fix-header needs it. */
1056 cpp_make_system_header (cpp_reader
*pfile
, int syshdr
, int externc
)
1059 const struct line_maps
*line_table
= pfile
->line_table
;
1060 const struct line_map
*map
= &line_table
->maps
[line_table
->used
-1];
1062 /* 1 = system header, 2 = system header to be treated as C. */
1064 flags
= 1 + (externc
!= 0);
1065 pfile
->buffer
->sysp
= flags
;
1066 _cpp_do_file_change (pfile
, LC_RENAME
, map
->to_file
,
1067 SOURCE_LINE (map
, pfile
->line_table
->highest_line
), flags
);
1070 /* Allow the client to change the current file. Used by the front end
1071 to achieve pseudo-file names like <built-in>.
1072 If REASON is LC_LEAVE, then NEW_NAME must be NULL. */
1074 cpp_change_file (cpp_reader
*pfile
, enum lc_reason reason
,
1075 const char *new_name
)
1077 _cpp_do_file_change (pfile
, reason
, new_name
, 1, 0);
1080 /* Callback function for htab_traverse. */
1082 report_missing_guard (void **slot
, void *b
)
1084 struct file_hash_entry
*entry
= (struct file_hash_entry
*) *slot
;
1085 int *bannerp
= (int *) b
;
1087 /* Skip directories. */
1088 if (entry
->start_dir
!= NULL
)
1090 _cpp_file
*file
= entry
->u
.file
;
1092 /* We don't want MI guard advice for the main file. */
1093 if (file
->cmacro
== NULL
&& file
->stack_count
== 1 && !file
->main_file
)
1097 fputs (_("Multiple include guards may be useful for:\n"),
1102 fputs (entry
->u
.file
->path
, stderr
);
1103 putc ('\n', stderr
);
1110 /* Report on all files that might benefit from a multiple include guard.
1113 _cpp_report_missing_guards (cpp_reader
*pfile
)
1117 htab_traverse (pfile
->file_hash
, report_missing_guard
, &banner
);
1120 /* Locate HEADER, and determine whether it is newer than the current
1121 file. If it cannot be located or dated, return -1, if it is
1122 newer, return 1, otherwise 0. */
1124 _cpp_compare_file_date (cpp_reader
*pfile
, const char *fname
,
1128 struct cpp_dir
*dir
;
1130 dir
= search_path_head (pfile
, fname
, angle_brackets
, IT_INCLUDE
);
1134 file
= _cpp_find_file (pfile
, fname
, dir
, false);
1144 return file
->st
.st_mtime
> pfile
->buffer
->file
->st
.st_mtime
;
1147 /* Pushes the given file onto the buffer stack. Returns nonzero if
1150 cpp_push_include (cpp_reader
*pfile
, const char *fname
)
1152 return _cpp_stack_include (pfile
, fname
, false, IT_CMDLINE
);
1155 /* Do appropriate cleanup when a file INC's buffer is popped off the
1158 _cpp_pop_file_buffer (cpp_reader
*pfile
, _cpp_file
*file
)
1160 /* Record the inclusion-preventing macro, which could be NULL
1161 meaning no controlling macro. */
1162 if (pfile
->mi_valid
&& file
->cmacro
== NULL
)
1163 file
->cmacro
= pfile
->mi_cmacro
;
1165 /* Invalidate control macros in the #including file. */
1166 pfile
->mi_valid
= false;
1170 free ((void *) file
->buffer
);
1171 file
->buffer
= NULL
;
1175 /* Set the include chain for "" to QUOTE, for <> to BRACKET. If
1176 QUOTE_IGNORES_SOURCE_DIR, then "" includes do not look in the
1177 directory of the including file.
1179 If BRACKET does not lie in the QUOTE chain, it is set to QUOTE. */
1181 cpp_set_include_chains (cpp_reader
*pfile
, cpp_dir
*quote
, cpp_dir
*bracket
,
1182 int quote_ignores_source_dir
)
1184 pfile
->quote_include
= quote
;
1185 pfile
->bracket_include
= quote
;
1186 pfile
->quote_ignores_source_dir
= quote_ignores_source_dir
;
1188 for (; quote
; quote
= quote
->next
)
1190 quote
->name_map
= NULL
;
1191 quote
->len
= strlen (quote
->name
);
1192 if (quote
== bracket
)
1193 pfile
->bracket_include
= bracket
;
1197 /* Append the file name to the directory to create the path, but don't
1198 turn / into // or // into ///; // may be a namespace escape. */
1200 append_file_to_dir (const char *fname
, cpp_dir
*dir
)
1206 flen
= strlen (fname
);
1207 path
= xmalloc (dlen
+ 1 + flen
+ 1);
1208 memcpy (path
, dir
->name
, dlen
);
1209 if (dlen
&& path
[dlen
- 1] != '/')
1211 memcpy (&path
[dlen
], fname
, flen
+ 1);
1216 /* Read a space delimited string of unlimited length from a stdio
1219 read_filename_string (int ch
, FILE *f
)
1225 set
= alloc
= xmalloc (len
+ 1);
1226 if (! is_space (ch
))
1229 while ((ch
= getc (f
)) != EOF
&& ! is_space (ch
))
1231 if (set
- alloc
== len
)
1234 alloc
= xrealloc (alloc
, len
+ 1);
1235 set
= alloc
+ len
/ 2;
1245 /* Read the file name map file for DIR. */
1247 read_name_map (cpp_dir
*dir
)
1249 static const char FILE_NAME_MAP_FILE
[] = "header.gcc";
1252 size_t len
, count
= 0, room
= 9;
1255 name
= alloca (len
+ sizeof (FILE_NAME_MAP_FILE
) + 1);
1256 memcpy (name
, dir
->name
, len
);
1257 if (len
&& name
[len
- 1] != '/')
1259 strcpy (name
+ len
, FILE_NAME_MAP_FILE
);
1260 f
= fopen (name
, "r");
1262 dir
->name_map
= xmalloc (room
* sizeof (char *));
1264 /* Silently return NULL if we cannot open. */
1269 while ((ch
= getc (f
)) != EOF
)
1276 if (count
+ 2 > room
)
1279 dir
->name_map
= xrealloc (dir
->name_map
, room
* sizeof (char *));
1282 dir
->name_map
[count
] = read_filename_string (ch
, f
);
1283 while ((ch
= getc (f
)) != EOF
&& is_hspace (ch
))
1286 to
= read_filename_string (ch
, f
);
1287 if (IS_ABSOLUTE_PATH (to
))
1288 dir
->name_map
[count
+ 1] = to
;
1291 dir
->name_map
[count
+ 1] = append_file_to_dir (to
, dir
);
1296 while ((ch
= getc (f
)) != '\n')
1304 /* Terminate the list of maps. */
1305 dir
->name_map
[count
] = NULL
;
1308 /* Remap a FILE's name based on the file_name_map, if any, for
1309 FILE->dir. If the file name has any directory separators,
1310 recursively check those directories too. */
1312 remap_filename (cpp_reader
*pfile
, _cpp_file
*file
)
1314 const char *fname
, *p
;
1325 read_name_map (dir
);
1327 for (index
= 0; dir
->name_map
[index
]; index
+= 2)
1328 if (!strcmp (dir
->name_map
[index
], fname
))
1329 return xstrdup (dir
->name_map
[index
+ 1]);
1331 p
= strchr (fname
, '/');
1332 if (!p
|| p
== fname
)
1335 len
= dir
->len
+ (p
- fname
+ 1);
1336 new_dir
= xmalloc (len
+ 1);
1337 memcpy (new_dir
, dir
->name
, dir
->len
);
1338 memcpy (new_dir
+ dir
->len
, fname
, p
- fname
+ 1);
1339 new_dir
[len
] = '\0';
1341 dir
= make_cpp_dir (pfile
, new_dir
, dir
->sysp
);
1346 /* Returns true if PCHNAME is a valid PCH file for FILE. */
1348 validate_pch (cpp_reader
*pfile
, _cpp_file
*file
, const char *pchname
)
1350 const char *saved_path
= file
->path
;
1353 file
->path
= pchname
;
1354 if (open_file (file
))
1356 valid
= 1 & pfile
->cb
.valid_pch (pfile
, pchname
, file
->fd
);
1364 if (CPP_OPTION (pfile
, print_include_names
))
1367 for (i
= 1; i
< pfile
->line_table
->depth
; i
++)
1369 fprintf (stderr
, "%c %s\n",
1370 valid
? '!' : 'x', pchname
);
1374 file
->path
= saved_path
;
1378 /* Get the path associated with the _cpp_file F. The path includes
1379 the base name from the include directive and the directory it was
1380 found in via the search path. */
1383 cpp_get_path (struct _cpp_file
*f
)
1388 /* Get the directory associated with the _cpp_file F. */
1391 cpp_get_dir (struct _cpp_file
*f
)
1396 /* Get the cpp_buffer currently associated with the cpp_reader
1400 cpp_get_buffer (cpp_reader
*pfile
)
1402 return pfile
->buffer
;
1405 /* Get the _cpp_file associated with the cpp_buffer B. */
1408 cpp_get_file (cpp_buffer
*b
)
1413 /* Get the previous cpp_buffer given a cpp_buffer B. The previous
1414 buffer is the buffer that included the given buffer. */
1417 cpp_get_prev (cpp_buffer
*b
)
1422 /* This data structure holds the list of header files that were seen
1423 while the PCH was being built. The 'entries' field is kept sorted
1424 in memcmp() order; yes, this means that on little-endian systems,
1425 it's sorted initially by the least-significant byte of 'size', but
1426 that's OK. The code does rely on having entries with the same size
1427 next to each other. */
1430 /* Number of pchf_entry structures. */
1433 /* Are there any values with once_only set?
1434 This is used as an optimisation, it means we don't have to search
1435 the structure if we're processing a regular #include. */
1436 bool have_once_only
;
1439 /* The size of this file. This is used to save running a MD5 checksum
1440 if the sizes don't match. */
1442 /* The MD5 checksum of this file. */
1443 unsigned char sum
[16];
1444 /* Is this file to be included only once? */
1449 static struct pchf_data
*pchf
;
1451 /* Data for pchf_addr. */
1452 struct pchf_adder_info
1455 struct pchf_data
*d
;
1458 /* A hash traversal function to add entries into DATA->D. */
1461 pchf_adder (void **slot
, void *data
)
1463 struct file_hash_entry
*h
= (struct file_hash_entry
*) *slot
;
1464 struct pchf_adder_info
*i
= (struct pchf_adder_info
*) data
;
1466 if (h
->start_dir
!= NULL
&& h
->u
.file
->stack_count
!= 0)
1468 struct pchf_data
*d
= i
->d
;
1469 _cpp_file
*f
= h
->u
.file
;
1470 size_t count
= d
->count
++;
1472 /* This should probably never happen, since if a read error occurred
1473 the PCH file shouldn't be written... */
1474 if (f
->dont_read
|| f
->err_no
)
1477 d
->entries
[count
].once_only
= f
->once_only
;
1478 /* |= is avoided in the next line because of an HP C compiler bug */
1479 d
->have_once_only
= d
->have_once_only
| f
->once_only
;
1480 if (f
->buffer_valid
)
1481 md5_buffer ((const char *)f
->buffer
,
1482 f
->st
.st_size
, d
->entries
[count
].sum
);
1490 open_file_failed (i
->pfile
, f
);
1493 ff
= fdopen (f
->fd
, "rb");
1494 md5_stream (ff
, d
->entries
[count
].sum
);
1498 d
->entries
[count
].size
= f
->st
.st_size
;
1503 /* A qsort ordering function for pchf_entry structures. */
1506 pchf_save_compare (const void *e1
, const void *e2
)
1508 return memcmp (e1
, e2
, sizeof (struct pchf_entry
));
1511 /* Create and write to F a pchf_data structure. */
1514 _cpp_save_file_entries (cpp_reader
*pfile
, FILE *f
)
1517 struct pchf_data
*result
;
1519 struct pchf_adder_info pai
;
1521 count
= htab_elements (pfile
->file_hash
);
1522 result_size
= (sizeof (struct pchf_data
)
1523 + sizeof (struct pchf_entry
) * (count
- 1));
1524 result
= xcalloc (result_size
, 1);
1527 result
->have_once_only
= false;
1531 htab_traverse (pfile
->file_hash
, pchf_adder
, &pai
);
1533 result_size
= (sizeof (struct pchf_data
)
1534 + sizeof (struct pchf_entry
) * (result
->count
- 1));
1536 qsort (result
->entries
, result
->count
, sizeof (struct pchf_entry
),
1539 return fwrite (result
, result_size
, 1, f
) == 1;
1542 /* Read the pchf_data structure from F. */
1545 _cpp_read_file_entries (cpp_reader
*pfile ATTRIBUTE_UNUSED
, FILE *f
)
1549 if (fread (&d
, sizeof (struct pchf_data
) - sizeof (struct pchf_entry
), 1, f
)
1553 pchf
= xmalloc (sizeof (struct pchf_data
)
1554 + sizeof (struct pchf_entry
) * (d
.count
- 1));
1555 memcpy (pchf
, &d
, sizeof (struct pchf_data
) - sizeof (struct pchf_entry
));
1556 if (fread (pchf
->entries
, sizeof (struct pchf_entry
), d
.count
, f
)
1562 /* The parameters for pchf_compare. */
1564 struct pchf_compare_data
1566 /* The size of the file we're looking for. */
1569 /* The MD5 checksum of the file, if it's been computed. */
1570 unsigned char sum
[16];
1575 /* Do we need to worry about entries that don't have ONCE_ONLY set? */
1576 bool check_included
;
1578 /* The file that we're searching for. */
1582 /* bsearch comparison function; look for D_P in E_P. */
1585 pchf_compare (const void *d_p
, const void *e_p
)
1587 const struct pchf_entry
*e
= (const struct pchf_entry
*)e_p
;
1588 struct pchf_compare_data
*d
= (struct pchf_compare_data
*)d_p
;
1591 result
= memcmp (&d
->size
, &e
->size
, sizeof (off_t
));
1595 if (! d
->sum_computed
)
1597 _cpp_file
*const f
= d
->f
;
1599 md5_buffer ((const char *)f
->buffer
, f
->st
.st_size
, d
->sum
);
1600 d
->sum_computed
= true;
1603 result
= memcmp (d
->sum
, e
->sum
, 16);
1607 if (d
->check_included
|| e
->once_only
)
1613 /* Check that F is not in a list read from a PCH file (if any).
1614 Assumes that f->buffer_valid is true. Return TRUE if the file
1615 should not be read. */
1618 check_file_against_entries (cpp_reader
*pfile ATTRIBUTE_UNUSED
,
1620 bool check_included
)
1622 struct pchf_compare_data d
;
1625 || (! check_included
&& ! pchf
->have_once_only
))
1628 d
.size
= f
->st
.st_size
;
1629 d
.sum_computed
= false;
1631 d
.check_included
= check_included
;
1632 return bsearch (&d
, pchf
->entries
, pchf
->count
, sizeof (struct pchf_entry
),
1633 pchf_compare
) != NULL
;