1 2021-03-18 Nick Alcock <nick.alcock@oracle.com>
3 * ctf-impl.h (ctf_dict_t): Fix comment.
5 2021-03-18 Nick Alcock <nick.alcock@oracle.com>
7 * ctf-create.c (symtypetab_delete_nonstatic_vars): Move
9 (ctf_symtab_skippable): Likewise.
10 (CTF_SYMTYPETAB_EMIT_FUNCTION): Likewise.
11 (CTF_SYMTYPETAB_EMIT_PAD): Likewise.
12 (CTF_SYMTYPETAB_FORCE_INDEXED): Likewise.
13 (symtypetab_density): Likewise.
14 (emit_symtypetab): Likewise.
15 (emit_symtypetab_index): Likewise.
16 (ctf_copy_smembers): Likewise.
17 (ctf_copy_lmembers): Likewise.
18 (ctf_copy_emembers): Likewise.
19 (ctf_sort_var): Likewise.
20 (ctf_serialize): Likewise.
21 (ctf_gzwrite): Likewise.
22 (ctf_compress_write): Likewise.
23 (ctf_write_mem): Likewise.
24 (ctf_write): Likewise.
25 * ctf-serialize.c: New file.
26 * Makefile.am (libctf_nobfd_la_SOURCES): Add it.
27 * Makefile.in: Regenerate.
29 2021-03-18 Nick Alcock <nick.alcock@oracle.com>
31 * ctf-link.c (ctf_link_lazy_open): Move up in the file, to near
33 * ctf-lookup.c (ctf_lookup_symbol_idx): Repair tabdamage.
34 (ctf_lookup_by_sym_or_name): Likewise.
35 * testsuite/libctf-lookup/struct-iteration.c: Likewise.
36 * testsuite/libctf-regression/type-add-unnamed-struct.c: Likewise.
38 2021-03-02 Nick Alcock <nick.alcock@oracle.com>
40 * ctf-create.c (symtypetab_density): Report the symbol name as
41 well as index in the name != object error; note the likely
43 * ctf-link.c (ctf_link_shuffle_syms): Report the symbol index
46 2021-03-02 Nick Alcock <nick.alcock@oracle.com>
48 * ctf-link.c (ctf_link_shuffle_syms): Free ctf_dynsyms properly.
50 2021-03-02 Nick Alcock <nick.alcock@oracle.com>
52 * ctf-dump.c (ctf_dump_format_type): Fix signed/unsigned confusion.
54 2021-03-02 Nick Alcock <nick.alcock@oracle.com>
56 * ctf-dedup.c (ctf_dedup): Pass on errors from ctf_dedup_hash_type.
57 Call ctf_dedup_fini properly on other errors.
58 (ctf_dedup_emit_type): Set the errno on dynhash insertion failure.
59 * ctf-link.c (ctf_link_deduplicating_per_cu): Close outputs beyond
60 output 0 when asserting because >1 output is found.
61 (ctf_link_deduplicating): Likewise, when asserting because the
62 shared output is not the same as the passed-in fp.
64 2021-03-02 Nick Alcock <nick.alcock@oracle.com>
66 * ctf-impl.h (ctf_dict_t) <ctf_link_type_mapping>: No longer used
67 by the nondeduplicating linker.
68 (ctf_add_type_mapping): Removed, now static.
69 (ctf_type_mapping): Likewise.
70 (ctf_dedup_type_mapping): New.
71 (ctf_dedup_t) <cd_input_nums>: New.
72 * ctf-dedup.c (ctf_dedup_init): Populate it.
73 (ctf_dedup_fini): Free it again. Emphasise that this has to be
74 the last thing called.
75 (ctf_dedup): Populate it.
76 (ctf_dedup_populate_type_mapping): Removed.
77 (ctf_dedup_populate_type_mappings): Likewise.
78 (ctf_dedup_emit): No longer call it. No longer call
79 ctf_dedup_fini either.
80 (ctf_dedup_type_mapping): New.
81 * ctf-link.c (ctf_unnamed_cuname): New.
82 (ctf_create_per_cu): Arguments must be non-null now.
83 (ctf_in_member_cb_arg): Removed.
84 (ctf_link): No longer populate it. No longer discard the
86 (ctf_link_deduplicating_one_symtypetab): Use
87 ctf_dedup_type_mapping, not ctf_type_mapping. Use
89 (ctf_link_one_variable): Likewise. Pass in args individually: no
90 longer a ctf_variable_iter callback.
91 (empty_link_type_mapping): Removed.
92 (ctf_link_deduplicating_variables): Use ctf_variable_next, not
93 ctf_variable_iter. No longer pack arguments to
94 ctf_link_one_variable into a struct.
95 (ctf_link_deduplicating_per_cu): Call ctf_dedup_fini once
96 all link phases are done.
97 (ctf_link_deduplicating): Likewise.
98 (ctf_link_intern_extern_string): Improve comment.
99 (ctf_add_type_mapping): Migrate...
100 (ctf_type_mapping): ... these functions...
101 * ctf-create.c (ctf_add_type_mapping): ... here...
102 (ctf_type_mapping): ... and make static, for the sole use of
105 2021-03-02 Nick Alcock <nick.alcock@oracle.com>
107 * ctf-link.c (ctf_link_one_variable): Remove reference to
108 "unconflicted link mode".
110 2021-03-02 Nick Alcock <nick.alcock@oracle.com>
112 * ctf-link.c (ctf_create_per_cu): Drop FILENAME now that it is
113 always identical to CUNAME.
114 (ctf_link_deduplicating_one_symtypetab): Adjust.
115 (ctf_link_one_type): Remove.
116 (ctf_link_one_input_archive_member): Likewise.
117 (ctf_link_close_one_input_archive): Likewise.
118 (ctf_link_one_input_archive): Likewise.
119 (ctf_link): No longer call it. Drop CTF_LINK_NONDEDUP path.
120 Improve header comment a bit (dicts, not files). Adjust
121 ctf_create_per_cu call.
122 (ctf_link_deduplicating_variables): Simplify.
123 (ctf_link_in_member_cb_arg_t) <cu_name>: Remove.
124 <in_input_cu_file>: Likewise.
125 <in_fp_parent>: Likewise.
126 <done_parent>: Likewise.
127 (ctf_link_one_variable): Turn uses of in_file_name to in_cuname.
129 2021-03-02 Nick Alcock <nick.alcock@oracle.com>
131 * ctf-types.c (ctf_member_iter): Move 'rc' to an inner scope.
132 (ctf_enum_iter): Reimplement in terms of ctf_enum_next.
133 (ctf_type_iter): Reimplement in terms of ctf_type_next.
134 (ctf_type_iter_all): Likewise.
135 (ctf_variable_iter): Reimplement in terms of ctf_variable_next.
136 * ctf-archive.c (ctf_archive_iter_internal): Remove.
137 (ctf_archive_iter): Reimplement in terms of ctf_archive_next.
139 2021-03-02 Nick Alcock <nick.alcock@oracle.com>
141 * ctf-archive.c (ctf_archive_next): Set the name of parents in
142 single-member archives.
144 2021-02-26 Alan Modra <amodra@gmail.com>
146 * Makefile.in: Regenerate.
148 2021-02-21 Alan Modra <amodra@gmail.com>
150 * configure.ac: Invoke AC_CANONICAL_TARGET, AC_CANONICAL_HOST
151 and AC_CANONICAL_BUILD.
152 * configure: Regenerate.
153 * Makefile.in: Regenerate.
155 2021-02-20 Nick Alcock <nick.alcock@oracle.com>
157 * ctf-impl.h (ctf_dict_t) <ctf_symhash>: New.
158 <ctf_symhash_latest>: Likewise.
159 (struct ctf_archive_internal) <ctfi_crossdict_cache>: New.
160 <ctfi_symnamedicts>: New.
162 (ctf_lookup_symbol_name): Remove.
163 * ctf-lookup.c (ctf_lookup_symbol_name): Propagate errors from
164 parent properly. Make static.
165 (ctf_lookup_symbol_idx): New, linear search for the symbol name,
166 cached in the crossdict cache's ctf_symhash (if available), or
167 this dict's (otherwise).
168 (ctf_try_lookup_indexed): Allow the symname to be passed in.
169 (ctf_lookup_by_symbol): Turn into a wrapper around...
170 (ctf_lookup_by_sym_or_name): ... this, supporting name lookup too,
171 using ctf_lookup_symbol_idx in non-writable dicts. Special-case
172 name lookup in dynamic dicts without reported symbols, which have
173 no symtab or dynsymidx but where name lookup should still work.
174 (ctf_lookup_by_symbol_name): New, another wrapper.
175 * ctf-archive.c (enosym): Note that this is present in
176 ctfi_symnamedicts too.
177 (ctf_arc_close): Adjust for removal of ctfi_syms. Free the
179 (ctf_arc_flush_caches): Likewise.
180 (ctf_dict_open_cached): Memoize the first cached dict in the
182 (ctf_arc_lookup_symbol): Turn into a wrapper around...
183 (ctf_arc_lookup_sym_or_name): ... this. No longer cache
184 ctf_id_t lookups: just call ctf_lookup_by_symbol as needed (but
185 still cache the dicts those lookups succeed in). Add
186 lookup-by-name support, with dicts of successful lookups cached in
187 ctfi_symnamedicts. Refactor the caching code a bit.
188 (ctf_arc_lookup_symbol_name): New, another wrapper.
189 * ctf-open.c (ctf_dict_close): Free the ctf_symhash.
190 * libctf.ver (LIBCTF_1.2): New version. Add
191 ctf_lookup_by_symbol_name, ctf_arc_lookup_symbol_name.
192 * testsuite/libctf-lookup/enum-symbol.c (main): Use
193 ctf_arc_lookup_symbol rather than looking up the name ourselves.
194 Fish it out repeatedly, to make sure that symbol caching isn't
198 * testsuite/libctf-lookup/enum-symbol-obj.lk: Test symbol lookup
199 in an unlinked object file (indexed symtypetab sections only).
200 * testsuite/libctf-writable/symtypetab-nonlinker-writeout.c
201 (try_maybe_reporting): Check symbol types via
202 ctf_lookup_by_symbol_name as well as ctf_symbol_next.
203 * testsuite/libctf-lookup/conflicting-type-syms.*: New test of
204 lookups in a multi-dict archive.
206 2021-02-20 Alan Modra <amodra@gmail.com>
208 * testsuite/config/default.exp (ld_L_opt): Define.
209 * testsuite/lib/ctf-lib.exp (load_common_lib): Delete. Instead load
211 (run_host_cmd, run_host_cmd_yesno, check_compiler_available): Delete.
212 (compile_one_cc, check_ctf_available): Delete.
214 2021-02-03 Nick Alcock <nick.alcock@oracle.com>
216 * configure.ac (ac_cv_libctf_bfd_elf): Include string.h.
217 * configure: Regenerated.
219 2021-02-03 Nick Alcock <nick.alcock@oracle.com>
221 * configure.ac (EXPECT): Check for, in order to define...
222 (TCL_TRY): ... this, if Tcl supports try/catch.
223 * Makefile.am (TCL_TRY): Run the testsuite only if set.
224 * configure: Regenerated.
225 * Makefile.in: Likewise.
227 2021-02-02 Nick Alcock <nick.alcock@oracle.com>
229 * configure.ac (CTF_LIBADD): Remove explicit -lintl population in
231 * Makefile.am (libctf_nobfd_la_LIBADD): No longer explicitly
233 (check-DEJAGNU): Pass down to tests as well.
234 * configure: Regenerated.
235 * Makefile.in: Likewise.
237 2021-01-27 Nick Alcock <nick.alcock@oracle.com>
239 * ctf-string.c (ctf_str_add): Treat adding a NULL as adding "".
240 (ctf_str_add_ref): Likewise.
241 (ctf_str_add_external): Likewise.
242 * ctf-types.c (ctf_type_name_raw): Always return "" for offset 0.
243 * ctf-dedup.c (ctf_dedup_multiple_input_dicts): Don't armour
245 (ctf_dedup_maybe_synthesize_forward): Likewise.
247 2021-01-27 Nick Alcock <nick.alcock@oracle.com>
249 * ctf-create.c (ctf_serialize): Fix shadowing.
251 2021-01-27 Nick Alcock <nick.alcock@oracle.com>
253 * ctf-create.c (ctf_add_encoded): Add check for non-empty name.
254 (ctf_add_forward): Likewise.
255 (ctf_add_typedef): Likewise.
257 2021-01-27 Nick Alcock <nick.alcock@oracle.com>
259 * ctf-open.c (init_types): Rip out code to check anonymous typedef
261 * ctf-create.c (ctf_add_reftype): Likewise.
262 * ctf-lookup.c (refresh_pptrtab): Likewise.
264 2021-01-27 Nick Alcock <nick.alcock@oracle.com>
266 * ctf-impl.c (_libctf_nonnull_): Add parameters.
267 (LCTF_LINKING): New flag.
268 (ctf_dict_t) <ctf_link_flags>: Mention it.
269 * ctf-link.c (ctf_link): Keep LCTF_LINKING set across call.
270 (ctf_write): Likewise, including in child dictionaries.
271 (ctf_link_shuffle_syms): Make sure ctf_dynsyms is NULL if there
272 are no reported symbols.
273 * ctf-create.c (symtypetab_delete_nonstatic_vars): Make sure
274 the variable has been reported as a symbol by the linker.
275 (symtypetab_skippable): Mention relationship between SYMFP and the
277 (symtypetab_density): Adjust nonnullity. Exit early if no symbols
278 were reported and force-indexing is off (i.e., we are doing a
280 (ctf_serialize): Handle the !LCTF_LINKING case by writing out an
281 indexed, sorted symtypetab (and allow SYMFP to be NULL in this
282 case). Turn sorting off if this is a non-final link. Only delete
283 nonstatic vars if we are filtering symbols and the linker has
285 * testsuite/libctf-regression/nonstatic-var-section-ld-r*:
286 New test of variable and symtypetab section population when
288 * testsuite/libctf-regression/nonstatic-var-section-ld-executable.lk:
289 Likewise, when ld of an executable is used.
290 * testsuite/libctf-regression/nonstatic-var-section-ld.lk:
291 Likewise, when ld -shared alone is used.
292 * testsuite/libctf-regression/nonstatic-var-section-ld*.c:
293 Lookup programs for the above.
294 * testsuite/libctf-writable/symtypetab-nonlinker-writeout.*: New
295 test, testing survival of symbols across ctf_write paths.
296 * testsuite/lib/ctf-lib.exp (run_lookup_test): New option,
297 nonshared, suppressing linking of the SOURCE with -shared.
299 2021-01-19 Nick Alcock <nick.alcock@oracle.com>
301 * ctf-create.c (membadd): Transform ""-named members into
303 * testsuite/libctf-regression/type-add-unnamed-struct*: New test.
305 2021-01-19 Nick Alcock <nick.alcock@oracle.com>
307 * ctf-lookup.c (ctf_lookup_by_name_internal): Do not return the
308 base type if looking up a nonexistent pointer type.
309 * testsuite/libctf-regression/pptrtab*: Test it.
311 2021-01-13 Alan Modra <amodra@gmail.com>
313 * Makefile.in: Regenerate.
315 2021-01-12 H.J. Lu <hongjiu.lu@intel.com>
318 * configure.ac: Use GNU_MAKE_JOBSERVER.
319 * aclocal.m4: Regenerated.
320 * configure: Likewise.
322 2021-01-11 H.J. Lu <hongjiu.lu@intel.com>
325 * configure: Regenerated.
327 2021-01-09 H.J. Lu <hongjiu.lu@intel.com>
329 * configure: Regenerated.
331 2021-01-09 Nick Clifton <nickc@redhat.com>
333 * 2.36 release branch crated.
335 2021-01-09 Alan Modra <amodra@gmail.com>
337 * configure: Regenerate.
339 2021-01-07 Samuel Thibault <samuel.thibault@gnu.org>
341 * configure: Regenerate.
343 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
345 * testsuite/libctf-lookup/struct-iteration.c (main):
346 ctf_member_count returns an int.
348 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
350 * Makefile.am (BASEDIR): New.
352 (check-DEJAGNU): Add development.exp to prerequisites.
353 (development.exp): New.
354 (CONFIG_STATUS_DEPENDENCIES): New.
355 (EXTRA_DEJAGNU_SITE_CONFIG): Likewise.
356 (DISTCLEANFILES): Likewise.
357 * Makefile.in: Regenerated.
358 * testsuite/lib/ctf-lib.exp (check_ctf_available): Return boolean.
359 * testsuite/libctf-lookup/lookup.exp: Call check_ctf_available.
360 * testsuite/libctf-regression/regression.exp: Likewise.
362 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
364 * ctf-types.c (ctf_type_aname): Print forwards to unions and enums
367 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
369 * ctf-impl.h (ctf_dict_t) <ctf_pptrtab>: New.
370 <ctf_pptrtab_len>: New.
371 <ctf_pptrtab_typemax>: New.
372 * ctf-create.c (ctf_serialize): Update accordingly.
373 (ctf_add_reftype): Note that we don't need to update pptrtab here,
374 despite updating ptrtab.
375 * ctf-open.c (ctf_dict_close): Destroy the pptrtab.
376 (ctf_import): Likewise.
377 (ctf_import_unref): Likewise.
378 * ctf-lookup.c (grow_pptrtab): New.
379 (refresh_pptrtab): New, update a pptrtab.
380 (ctf_lookup_by_name): Turn into a wrapper around (and rename to)...
381 (ctf_lookup_by_name_internal): ... this: construct the pptrtab, and
382 use it in addition to the parent's ptrtab when parent dicts are
384 * testsuite/libctf-regression/regression.exp: New testsuite for
386 * testsuite/libctf-regression/pptrtab*: New test.
387 * testsuite/libctf-writable/writable.exp: New testsuite for tests of
389 * testsuite/libctf-writable/pptrtab*: New test.
391 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
393 * ctf-archive.c (ctf_archive_iter): Remove outdated comment.
395 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
397 * ctf-impl.h (struct ctf_next) <u.ctn_next>: Move to...
398 <ctn_next>: ... here.
399 * ctf-util.c (ctf_next_destroy): Unconditionally destroy it.
400 * ctf-lookup.c (ctf_symbol_next): Adjust accordingly.
401 * ctf-types.c (ctf_member_iter): Reimplement in terms of...
402 (ctf_member_next): ... this. Support recursive unnamed member
403 iteration (off by default).
404 (ctf_member_info): Look up members in unnamed sub-structs.
405 * ctf-dedup.c (ctf_dedup_rhash_type): Adjust ctf_member_next call.
406 (ctf_dedup_emit_struct_members): Likewise.
407 * testsuite/libctf-lookup/struct-iteration-ctf.c: Test empty unnamed
408 members, and a normal member after the end.
409 * testsuite/libctf-lookup/struct-iteration.c: Verify that
410 ctf_member_count is consistent with the number of successful returns
411 from a non-recursive ctf_member_next.
412 * testsuite/libctf-lookup/struct-iteration-*: New, test iteration
414 * testsuite/libctf-lookup/struct-lookup.c: New test.
415 * testsuite/libctf-lookup/struct-lookup.lk: New test.
417 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
419 * ctf-link.c (ctf_link_warn_outdated_inputs): New.
420 (ctf_link_write): Call it.
422 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
424 * testsuite/libctf-lookup/enum-symbol.lk: New symbol-lookup test.
425 * testsuite/libctf-lookup/enum-symbol-ctf.c: New CTF input.
426 * testsuite/libctf-lookup/enum-symbol.c: New lookup test.
428 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
430 * Makefile.am (EXPECT): New.
432 (RUNTESTFLAGS): Likewise.
433 (CC_FOR_TARGET): Likewise.
434 (check-DEJAGNU): Likewise.
435 (AUTOMAKE_OPTIONS): Add dejagnu.
436 * Makefile.in: Regenerated.
437 * testsuite/config/default.exp: New.
438 * testsuite/lib/ctf-lib.exp: Likewise.
439 * testsuite/libctf-lookup/enum.lk: New test.
440 * testsuite/libctf-lookup/enum-ctf.c: New CTF input.
441 * testsuite/libctf-lookup/enum.c: New lookup test.
442 * testsuite/libctf-lookup/ambiguous-struct*.c: New test.
443 * testsuite/libctf-lookup/lookup.exp: New.
445 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
447 * configure.ac (BFD_LIBADD): Remove.
448 (BFD_DEPENDENCIES): Likewise. Remove associated cases.
449 (SHARED_LIBADD): Rename to...
450 (CTF_LIBADD): ... this. Stick in a suitable libiberty even when
452 * Makefile.am (libctf_nobfd_la_LIBADD): Adjust accordingly.
454 (libctf_la_LIBADD): Reference libbfd.la directly, not via
456 (libctf_la_DEPENDENCIES): Remove.
457 * Makefile.in: Regenerate.
458 * configure: Likewise.
460 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
462 * ctf-decl.c (ctf_decl_push): Exclude slices from the decl stack.
463 * ctf-types.c (ctf_type_aname): No longer deal with slices here.
464 * ctf-dump.c (ctf_dump_membstate_t) <cdm_toplevel_indent>: Constify.
466 (CTF_FT_BITFIELD): Likewise.
467 (CTF_FT_ID): Likewise.
468 (ctf_dump_member): Do not do indentation here. Migrate the
469 type-printing parts of this into...
470 (ctf_dump_format_type): ... here, to be shared by all type printers.
471 Get the errno value for non-representable types right. Do not print
472 bitfield info for non-bitfields. Improve the format and indentation
473 of other type output. Shuffle spacing around to make all indentation
474 either 'width of column' or 4 chars.
475 (ctf_dump_label): Pass CTF_FT_REFS to ctf_dump_format_type.
476 (ctf_dump_objts): Likewise. Spacing shuffle.
477 (ctf_dump_var): Likewise.
478 (type_hex_digits): Migrate down in the file, to above its new user.
479 (ctf_dump_type): Indent here instead. Pass CTF_FT_REFS to
480 ctf_dump_format_type. Don't trim off excess linefeeds now we no
481 longer generate them. Dump enumerated types.
483 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
485 * ctf-types.c (ctf_type_resolve): Improve comment.
486 (ctf_type_size): Yield ECTF_INCOMPLETE when applied to forwards.
487 Emit errors into the right dict.
488 (ctf_type_align): Likewise.
489 * ctf-create.c (ctf_add_member_offset): Yield ECTF_INCOMPLETE
490 when adding a member without explicit offset when this member, or
491 the previous member, is incomplete.
492 * ctf-dump.c (ctf_dump_format_type): Do not try to print the size of
494 (ctf_dump_member): Do not try to print their alignment.
496 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
498 * ctf-dump.c (ctf_dump_objts): Dump by calling ctf_dump_format_type.
499 (ctf_dump_format_type): Don't emit the size for function objects.
500 Dump the element type of arrays like we dump the pointed-to type of
503 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
505 * ctf-dump.c (ctf_dump_format_type): Add 0x to hex type IDs.
506 (ctf_dump_header): Add 0x to the hex magic number.
507 (ctf_dump_str): Add 0x to the hex string offsets.
508 (ctf_dump_membstate_t) <cdm_toplevel_indent>: New.
509 (ctf_dump_type): Adjust. Free it when we're done.
510 (type_hex_digits): New.
511 (ctf_dump_member): Align output depending on the width of the type
512 ID being generated. Use printf padding, not a loop, to generate
515 2021-01-05 Nick Alcock <nick.alcock@oracle.com>
517 * ctf-decl.c (ctf_decl_push): Don't print array decls backwards.
519 2021-01-04 Nicolas Boulenguez <nicolas@debian.org>
522 * configure.ac: Make AC_CONFIG_MACRO_DIR consistent with
523 ACLOCAL_AMFLAGS -I dirs.
524 * configure: Regenerate.
526 2021-01-01 Alan Modra <amodra@gmail.com>
528 Update year range in copyright notice of all files.
530 For older changes see ChangeLog-2020
532 Copyright (C) 2021 Free Software Foundation, Inc.
534 Copying and distribution of this file, with or without modification,
535 are permitted in any medium without royalty provided the copyright
536 notice and this notice are preserved.
542 version-control: never