CVS log for src/usr.bin/crunch/crunchgen/crunchgen.1

Up to [cvs.NetBSD.org] / src / usr.bin / crunch / crunchgen

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

fix syntax error and typo in overwritten.

Merge changes from current as of 20200406

New sentence, new line. Fix typo.

Provide a migration guide from the old flags to -V.

1. Remove all the special handling of variables (-d -p -P -s -S) that
   were dealing with DBG (-d) LDSTATIC/NOPIE (-p), and the rest with
   disabling/enabling sanitizers.
2. Use emalloc/estrdup for all the allocators instead of only some cases.
3. Add -V varspec which passes variables on the command line (as DBG
   and LDSTATIC used to be passed before) instead of appending them
   to the on-the-fly Makefile using -v varspec.
4. Change the distrib and rescue Makefiles to use -V instead of the removed
   flags.

The motivation of this is to make variable handling consistent, less magical,
and remove the need for changing crunchgen each time we want to add disabling
an option by default.

(as proposed in tech-toolchain)

Also disable ssp and fortify by default.

Sync with HEAD

Sync with HEAD

Add -S to SYNOPSIS. Sort option descriptions.

Introduce a new option -S in crunchgen(1)

The -S argument enables sanitization with a sanitizer in libc.

Sync with HEAD

Add new option -s to crunchgen(1) -- enable sanitization

As of today typical sanitizers require dynamic executables, while
crunchgen(1) programs are produced with static properties.

Lack of specified -s will:
 - generate a Makefile file with NOSANITIZER=
 - build programs that are dependencies with NOSANITIZER=

In future there is an option to handle sanitization in statically linked
programs.

An idea with -s LGTM by <christos>

New sentence, new line. Remove superfluous Pps.

Handle static PIE

Rebase to HEAD as of a few days ago.

sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs.  ("Protocol error: too many arguments")

Merge riastradh-drm2 to HEAD.

sync with HEAD

Use Mt for email addresses.

resync from head

Document section stripping.

sync with head

Remove unnecessary Bk/Ek pairs from SYNOPSIS.
No effective change except where I used the opportunity to sort options
and/or option descriptions.

Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html

Use paragraph breaks before notes, not just line breaks.

Bump date for previous.

Treat multiple

  SPECIAL prog {objs,objpaths,keepsymbols} itemX

lines (where "prog" is fixed) in crunchgen configuration the same as

  SPECIAL prog {objs,objpaths,keepsymbols} item1 ... itemN

OK by David Laight

Pull up revision 1.25 (requested by riz in ticket #5513):
Sort options in SYNOPSIS and in description; use more mdoc macros.

Pull up revision 1.24 (requested by riz in ticket #5513):
Change the way crunchgen works when doing 'reachover' builds.
Instead of trying to identify all the .o files that make each target rely
on the targets own Makefile having a program.ro target that will compile
all the objects and link them into a single relocatable.
Rename each program's 'main' to '_crunched_<prog>_stub' instead of compiling
a small piece of C.
The old behaviour can be forced by specifying -O, and is also done if the
config file specifies 'objs' or 'objpaths'.
As well as simplifying the logic, this means you only get a single 'prog.ro
is up to date' message for each program during the build.

Pull up revision 1.23 (requested by riz in ticket #5513):
The conffile argument is not optional; also, move it behind all
the options. Bump date.

Pull up revision 1.22 (requested by riz in ticket #5513):
Add -v VARSPEC, so that we can pass variable assignments to make(1)

Sort options in SYNOPSIS and in description; use more mdoc macros.

Change the way crunchgen works when doing 'reachover' builds.
Instead of trying to identify all the .o files that make each target rely
on the targets own Makefile having a program.ro target that will compile
all the objects and link them into a single relocatable.
Rename each program's 'main' to '_crunched_<prog>_stub' instead of compiling
a small piece of C.
The old behaviour can be forced by specifying -O, and is also done if the
config file specifies 'objs' or 'objpaths'.
As well as simplifying the logic, this means you only get a single 'prog.ro
is up to date' message for each program during the build.

The conffile argument is not optional; also, move it behind all
the options. Bump date.

Add -v VARSPEC, so that we can pass variable assignments to make(1)

progams->programs (Igor Sobrado, PR misc/19700) + homegrown->home-grown

.Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.

Two typos. From Adrian Mrva. eg -> e.g.

add -o to synopsis

Note -d flag in SYNOPSIS.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Add special command "keepsymbols", allows the specified external symbols
not to be hidden. From Jens Nilsson, jens@rockstorm.se.

Use .Bd -literal.

Whitespace, punctuation, section header fixes, sort sections.

Add a -d option to set the DBG flag to whatever flags the builder wants. If
it's not set, default to -Os (so it's not hard coded into the binary.)

Generate a makefile by default that does all object file builds in local
subdirs by binary (i.e. bad144 gets built in $OBJDIR/bad144) via a reach over
make. (Sets .PATH and .CURDIR and does a make for the objects needed in that
dir).

Add a -o option that does the old behavior of searching for obj files by
querying the various object environment vars and searching. Without this
option none of the objdir special options, environment vars, etc will have
effect.

Document all the changes in the man page (and specificly note that without -o
none of the objdir functions take effect).

While I'm here.. document the rest of the environment variables I found in
this program.

Document the MAKE environment variable.

More and more .Os cleanups.  .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages.  Many more to
come.

Clean up SYNOPSIS formatting.

add another caveat entry.

macroize BSD, NetBSD, FreeBSD and misc cleanup

Fix type: srt-root -> src-root

1) RCSid police
2) Add __RCSIDs where apropriate.
3) WARNS=1, and clean up sources for WARNS=1 (including replacement of
   a mktemp with a mkstemp even though it was probably safe...)
4) Some other small cosmetic changes

clean up formatting glitches (bogus newlines in source)

add two flags:
	-D to specify a "root" from which relative source dir paths
		are assumed to begin, and
	-L to specify the library path for included libs.

crunch, from James da Silva at UMD

Initial revision