Fri, 27 Feb 2009 13:27:09 -0800
6810672: Comment typos
Summary: I have collected some typos I have found while looking at the code.
Reviewed-by: kvn, never
1 /*
2 * Copyright 1999-2005 Sun Microsystems, Inc. All Rights Reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation.
8 *
9 * This code is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
12 * version 2 for more details (a copy is included in the LICENSE file that
13 * accompanied this code).
14 *
15 * You should have received a copy of the GNU General Public License version
16 * 2 along with this work; if not, write to the Free Software Foundation,
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18 *
19 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
20 * CA 95054 USA or visit www.sun.com if you need additional information or
21 * have any questions.
22 *
23 */
25 import java.io.*;
26 import java.util.*;
28 public class Database {
29 private MacroDefinitions macros;
30 // allFiles is kept in lexicographically sorted order. See get().
31 private FileList allFiles;
32 // files that have implicit dependency on platform files
33 // e.g. os.hpp: os_<os_family>.hpp os_<os_arch>.hpp but only
34 // recorded if the platform file was seen.
35 private FileList platformFiles;
36 private FileList outerFiles;
37 private FileList indivIncludes;
38 private FileList grandInclude; // the results for the grand include file
39 private HashMap<String,String> platformDepFiles;
40 private long threshold;
41 private int nOuterFiles;
42 private int nPrecompiledFiles;
43 private boolean missingOk;
44 private Platform plat;
45 /** These allow you to specify files not in the include database
46 which are prepended and appended to the file list, allowing
47 you to have well-known functions at the start and end of the
48 text segment (allows us to find out in a portable fashion
49 whether the current PC is in VM code or not upon a crash) */
50 private String firstFile;
51 private String lastFile;
53 public Database(Platform plat, long t) {
54 this.plat = plat;
55 macros = new MacroDefinitions();
56 allFiles = new FileList("allFiles", plat);
57 platformFiles = new FileList("platformFiles", plat);
58 outerFiles = new FileList("outerFiles", plat);
59 indivIncludes = new FileList("IndivIncludes", plat);
60 grandInclude = new FileList(plat.getGIFileTemplate().nameOfList(), plat);
61 platformDepFiles = new HashMap<String,String>();
63 threshold = t;
64 nOuterFiles = 0;
65 nPrecompiledFiles = 0;
66 missingOk = false;
67 firstFile = null;
68 lastFile = null;
69 };
71 public FileList getAllFiles() {
72 return allFiles;
73 }
75 public Iterator getMacros() {
76 return macros.getMacros();
77 }
79 public void canBeMissing() {
80 missingOk = true;
81 }
83 public boolean hfileIsInGrandInclude(FileList hfile, FileList cfile) {
84 return ((hfile.getCount() >= threshold) && (cfile.getUseGrandInclude()));
85 }
87 /** These allow you to specify files not in the include database
88 which are prepended and appended to the file list, allowing
89 you to have well-known functions at the start and end of the
90 text segment (allows us to find out in a portable fashion
91 whether the current PC is in VM code or not upon a crash) */
92 public void setFirstFile(String fileName) {
93 firstFile = fileName;
94 }
96 public void setLastFile(String fileName) {
97 lastFile = fileName;
98 }
100 public void get(String platFileName, String dbFileName)
101 throws FileFormatException, IOException, FileNotFoundException {
102 macros.readFrom(platFileName, missingOk);
104 BufferedReader reader = null;
105 try {
106 reader = new BufferedReader(new FileReader(dbFileName));
107 } catch (FileNotFoundException e) {
108 if (missingOk) {
109 return;
110 } else {
111 throw(e);
112 }
113 }
114 System.out.println("\treading database: " + dbFileName);
115 String line;
116 int lineNo = 0;
117 do {
118 line = reader.readLine();
119 lineNo++;
120 if (line != null) {
121 StreamTokenizer tokenizer =
122 new StreamTokenizer(new StringReader(line));
123 tokenizer.slashSlashComments(true);
124 tokenizer.wordChars('_', '_');
125 tokenizer.wordChars('<', '>');
126 // NOTE: if we didn't have to do this line by line,
127 // we could trivially recognize C-style comments as
128 // well.
129 // tokenizer.slashStarComments(true);
130 int numTok = 0;
131 int res;
132 String unexpandedIncluder = null;
133 String unexpandedIncludee = null;
134 do {
135 res = tokenizer.nextToken();
136 if (res != StreamTokenizer.TT_EOF) {
137 if (numTok == 0) {
138 unexpandedIncluder = tokenizer.sval;
139 } else if (numTok == 1) {
140 unexpandedIncludee = tokenizer.sval;
141 } else {
142 throw new FileFormatException(
143 "invalid line: \"" + line +
144 "\". Error position: line " + lineNo
145 );
146 }
147 numTok++;
148 }
149 } while (res != StreamTokenizer.TT_EOF);
151 if ((numTok != 0) && (numTok != 2)) {
152 throw new FileFormatException(
153 "invalid line: \"" + line +
154 "\". Error position: line " + lineNo
155 );
156 }
158 if (numTok == 2) {
159 // Non-empty line
160 String includer = macros.expand(unexpandedIncluder);
161 String includee = macros.expand(unexpandedIncludee);
163 if (includee.equals(plat.generatePlatformDependentInclude())) {
164 MacroDefinitions localExpander = macros.copy();
165 MacroDefinitions localExpander2 = macros.copy();
166 localExpander.setAllMacroBodiesTo("pd");
167 localExpander2.setAllMacroBodiesTo("");
169 // unexpanded_includer e.g. thread_<os_arch>.hpp
170 // thread_solaris_i486.hpp -> _thread_pd.hpp.incl
172 FileName pdName =
173 plat.getInclFileTemplate().copyStem(
174 localExpander.expand(unexpandedIncluder)
175 );
177 // derive generic name from platform specific name
178 // e.g. os_<arch_os>.hpp => os.hpp. We enforce the
179 // restriction (imperfectly) noted in includeDB_core
180 // that platform specific files will have an underscore
181 // preceding the macro invocation.
183 // First expand macro as null string.
185 String newIncluder_temp =
186 localExpander2.expand(unexpandedIncluder);
188 // Now find "_." and remove the underscore.
190 String newIncluder = "";
192 int len = newIncluder_temp.length();
193 int count = 0;
195 for ( int i = 0; i < len - 1 ; i++ ) {
196 if (newIncluder_temp.charAt(i) == '_' && newIncluder_temp.charAt(i+1) == '.') {
197 count++;
198 } else {
199 newIncluder += newIncluder_temp.charAt(i);
200 }
201 }
202 newIncluder += newIncluder_temp.charAt(len-1);
204 if (count != 1) {
205 throw new FileFormatException(
206 "Unexpected filename format for platform dependent file.\nline: \"" + line +
207 "\".\nError position: line " + lineNo
208 );
209 }
211 FileList p = allFiles.listForFile(includer);
212 p.setPlatformDependentInclude(pdName.dirPreStemSuff());
214 // Record the implicit include of this file so that the
215 // dependencies for precompiled headers can mention it.
216 platformDepFiles.put(newIncluder, includer);
218 // Add an implicit dependency on platform
219 // specific file for the generic file
221 p = platformFiles.listForFile(newIncluder);
223 // if this list is empty then this is 1st
224 // occurance of a platform dependent file and
225 // we need a new version of the include file.
226 // Otherwise we just append to the current
227 // file.
229 PrintWriter pdFile =
230 new PrintWriter(
231 new FileWriter(pdName.dirPreStemSuff(),
232 !p.isEmpty())
233 );
234 pdFile.println("# include \"" + includer + "\"");
235 pdFile.close();
237 // Add the platform specific file to the list
238 // for this generic file.
240 FileList q = allFiles.listForFile(includer);
241 p.addIfAbsent(q);
242 } else {
243 FileList p = allFiles.listForFile(includer);
244 if (isOuterFile(includer))
245 outerFiles.addIfAbsent(p);
247 if (includee.equals(plat.noGrandInclude())) {
248 p.setUseGrandInclude(false);
249 } else {
250 FileList q = allFiles.listForFile(includee);
251 p.addIfAbsent(q);
252 }
253 }
254 }
255 }
256 } while (line != null);
257 reader.close();
259 // Keep allFiles in well-known order so we can easily determine
260 // whether the known files are the same
261 allFiles.sortByName();
263 // Add first and last files differently to prevent a mistake
264 // in ordering in the include databases from breaking the
265 // error reporting in the VM.
266 if (firstFile != null) {
267 FileList p = allFiles.listForFile(firstFile);
268 allFiles.setFirstFile(p);
269 outerFiles.setFirstFile(p);
270 }
272 if (lastFile != null) {
273 FileList p = allFiles.listForFile(lastFile);
274 allFiles.setLastFile(p);
275 outerFiles.setLastFile(p);
276 }
277 }
279 public void compute() {
280 System.out.println("\tcomputing closures\n");
281 // build both indiv and grand results
282 for (Iterator iter = outerFiles.iterator(); iter.hasNext(); ) {
283 indivIncludes.add(((FileList) iter.next()).doCFile());
284 ++nOuterFiles;
285 }
287 if (!plat.haveGrandInclude())
288 return; // nothing in grand include
290 // count how many times each include is included & add em to grand
291 for (Iterator iter = indivIncludes.iterator(); iter.hasNext(); ) {
292 FileList indivInclude = (FileList) iter.next();
293 if (!indivInclude.getUseGrandInclude()) {
294 continue; // do not bump count if my files cannot be
295 // in grand include
296 }
297 indivInclude.doFiles(grandInclude); // put em on
298 // grand_include list
299 for (Iterator incListIter = indivInclude.iterator();
300 incListIter.hasNext(); ) {
301 ((FileList) incListIter.next()).incrementCount();
302 }
303 }
304 }
306 // Not sure this is necessary in Java
307 public void verify() {
308 for (Iterator iter = indivIncludes.iterator(); iter.hasNext(); ) {
309 if (iter.next() == null) {
310 plat.abort();
311 }
312 }
313 }
315 public void put() throws IOException {
316 writeIndividualIncludes();
318 if (plat.haveGrandInclude())
319 writeGrandInclude();
321 writeGrandUnixMakefile();
322 }
324 private void writeIndividualIncludes() throws IOException {
325 System.out.println("\twriting individual include files\n");
327 for (Iterator iter = indivIncludes.iterator(); iter.hasNext(); ) {
328 FileList list = (FileList) iter.next();
329 System.out.println("\tcreating " + list.getName());
330 list.putInclFile(this);
331 }
332 }
334 private void writeGrandInclude() throws IOException {
335 System.out.println("\twriting grand include file\n");
336 PrintWriter inclFile =
337 new PrintWriter(new FileWriter(plat.getGIFileTemplate().dirPreStemSuff()));
338 plat.writeGIPragma(inclFile);
339 for (Iterator iter = grandInclude.iterator(); iter.hasNext(); ) {
340 FileList list = (FileList) iter.next();
341 if (list.getCount() >= threshold) {
342 inclFile.println("# include \"" +
343 plat.getGIFileTemplate().getInvDir() +
344 list.getName() +
345 "\"");
346 nPrecompiledFiles += 1;
347 }
348 }
349 inclFile.println();
350 inclFile.close();
351 }
353 private void writeGrandUnixMakefile() throws IOException {
354 if (!plat.writeDeps())
355 return;
357 System.out.println("\twriting dependencies file\n");
358 PrintWriter gd =
359 new PrintWriter(new FileWriter(
360 plat.getGDFileTemplate().dirPreStemSuff())
361 );
362 gd.println("# generated by makeDeps");
363 gd.println();
366 // HACK ALERT. The compilation of ad_<arch> files is very slow.
367 // We want to start compiling them as early as possible. The compilation
368 // order on unix is dependent on the order we emit files here.
369 // By sorting the output before emitting it, we expect
370 // that ad_<arch> will be compiled early.
371 boolean shouldSortObjFiles = true;
373 if (shouldSortObjFiles) {
374 ArrayList sortList = new ArrayList();
376 // We need to preserve the ordering of the first and last items
377 // in outerFiles.
378 int size = outerFiles.size() - 1;
379 String firstName = removeSuffixFrom(((FileList)outerFiles.get(0)).getName());
380 String lastName = removeSuffixFrom(((FileList)outerFiles.get(size)).getName());
382 for (int i=1; i<size; i++) {
383 FileList anOuterFile = (FileList)outerFiles.get(i);
384 String stemName = removeSuffixFrom(anOuterFile.getName());
385 sortList.add(stemName);
386 }
387 Collections.sort(sortList);
389 // write Obj_Files = ...
390 gd.println("Obj_Files = \\");
391 gd.println(firstName + plat.objFileSuffix() + " \\");
392 for (Iterator iter = sortList.iterator(); iter.hasNext(); ) {
393 gd.println(iter.next() + plat.objFileSuffix() + " \\");
394 }
395 gd.println(lastName + plat.objFileSuffix() + " \\");
396 gd.println();
397 gd.println();
398 } else {
399 // write Obj_Files = ...
400 gd.println("Obj_Files = \\");
401 for (Iterator iter = outerFiles.iterator(); iter.hasNext(); ) {
402 FileList anOuterFile = (FileList) iter.next();
404 String stemName = removeSuffixFrom(anOuterFile.getName());
405 gd.println(stemName + plat.objFileSuffix() + " \\");
406 }
407 gd.println();
408 gd.println();
409 }
411 if (nPrecompiledFiles > 0) {
412 // write Precompiled_Files = ...
413 gd.println("Precompiled_Files = \\");
414 for (Iterator iter = grandInclude.iterator(); iter.hasNext(); ) {
415 FileList list = (FileList) iter.next();
416 gd.println(list.getName() + " \\");
417 String platformDep = platformDepFiles.get(list.getName());
418 if (platformDep != null) {
419 // make sure changes to the platform dependent file will
420 // cause regeneration of the pch file.
421 gd.println(platformDep + " \\");
422 }
423 }
424 gd.println();
425 gd.println();
426 }
428 gd.println("DTraced_Files = \\");
429 for (Iterator iter = outerFiles.iterator(); iter.hasNext(); ) {
430 FileList anOuterFile = (FileList) iter.next();
432 if (anOuterFile.hasListForFile("dtrace.hpp")) {
433 String stemName = removeSuffixFrom(anOuterFile.getName());
434 gd.println(stemName + plat.objFileSuffix() + " \\");
435 }
436 }
437 gd.println();
438 gd.println();
440 {
441 // write each dependency
443 for (Iterator iter = indivIncludes.iterator(); iter.hasNext(); ) {
445 FileList anII = (FileList) iter.next();
447 String stemName = removeSuffixFrom(anII.getName());
448 String inclFileName =
449 plat.getInclFileTemplate().copyStem(anII.getName()).
450 preStemSuff();
452 gd.println(stemName + plat.objFileSuffix() + " " +
453 stemName + plat.asmFileSuffix() + ": \\");
455 printDependentOn(gd, anII.getName());
456 // this gets the include file that includes all that
457 // this file needs (first level) since nested includes
458 // are skipped to avoid cycles.
459 printDependentOn(gd, inclFileName);
461 if ( plat.haveGrandInclude() ) {
462 printDependentOn(gd,
463 plat.getGIFileTemplate().preStemSuff());
464 }
466 for (Iterator iiIter = anII.iterator(); iiIter.hasNext(); ) {
467 FileList hfile = (FileList) iiIter.next();
468 if (!hfileIsInGrandInclude(hfile, anII) ||
469 plat.writeDependenciesOnHFilesFromGI()) {
470 printDependentOn(gd, hfile.getName());
471 }
472 if (platformFiles.hasListForFile(hfile.getName())) {
473 FileList p =
474 platformFiles.listForFile(hfile.getName());;
475 for (Iterator hiIter = p.iterator();
476 hiIter.hasNext(); ) {
477 FileList hi2 = (FileList) hiIter.next();
478 if (!hfileIsInGrandInclude(hi2, p)) {
479 printDependentOn(gd, hi2.getName());
480 }
481 }
482 }
483 }
485 if (plat.includeGIDependencies()
486 && nPrecompiledFiles > 0
487 && anII.getUseGrandInclude()) {
488 gd.println(" $(Precompiled_Files) \\");
489 }
490 gd.println();
491 gd.println();
492 }
493 }
495 gd.close();
496 }
498 public void putDiffs(Database previous) throws IOException {
499 System.out.println("\tupdating output files\n");
501 if (!indivIncludes.compareLists(previous.indivIncludes)
502 || !grandInclude.compareLists(previous.grandInclude)) {
503 System.out.println("The order of .c or .s has changed, or " +
504 "the grand include file has changed.");
505 put();
506 return;
507 }
509 Iterator curIter = indivIncludes.iterator();
510 Iterator prevIter = previous.indivIncludes.iterator();
512 try {
513 while (curIter.hasNext()) {
514 FileList newCFileList = (FileList) curIter.next();
515 FileList prevCFileList = (FileList) prevIter.next();
516 if (!newCFileList.compareLists(prevCFileList)) {
517 System.out.println("\tupdating " + newCFileList.getName());
518 newCFileList.putInclFile(this);
519 }
520 }
521 }
522 catch (Exception e) {
523 throw new InternalError("assertion failure: cur and prev " +
524 "database lists changed unexpectedly.");
525 }
527 writeGrandUnixMakefile();
528 }
530 private void printDependentOn(PrintWriter gd, String name) {
531 gd.print(" ");
532 gd.print(plat.dependentPrefix() + name);
533 }
535 private boolean isOuterFile(String s) {
536 int len = s.length();
537 String[] suffixes = plat.outerSuffixes();
538 for (int i = 0; i < suffixes.length; i++) {
539 String suffix = suffixes[i];
540 int suffLen = suffix.length();
541 if ((len >= suffLen) &&
542 (plat.fileNameStringEquality(s.substring(len - suffLen),
543 suffix))) {
544 return true;
545 }
546 }
547 return false;
548 }
550 private String removeSuffixFrom(String s) {
551 int idx = s.lastIndexOf('.');
552 if (idx <= 0)
553 plat.abort();
554 return s.substring(0, idx);
555 }
556 }