NAME

toolhash - Generate and hash files to avoid installation of build tools

SYNOPSIS

toolhash --in foo.c --out foo.o --cmd gcc -c -o foo.o foo.c

DESCRIPTION

Toolhash is used to install Verilog-Perl and other tools. It stores a hash of generated files (aka the cons make utility) for distribution to avoid building those files from scratch.

The hash isn't stored as part of the filename, so that the MANIFEST can remain constant.

ARGUMENTS

--cmd command args...

Command and arguments to run. All further arguments are passed to the command.

--gen ARG

Specify location of generated file cache, defaults to "gen".

--in filenames...

Input filenames.

--name

Prefix for output files, or defaults to first --cmd argument.

--verbose

Print hit/miss messages.

--skip-cmd <num-args>

Disable hashing first num-arg components of the command. This is used to avoid commands like "/usr/bin/perl ...." from hash missing when the Perl version and thus the path changes.

--out filenames...

Output filenames.

--vercmd command

Command to run to get --version.

ENVIRONMENT

TOOLHASH_RECACHE

Write the cache, but do not read from it.

DISTRIBUTION

This is part of the https://www.veripool.org/ free Verilog EDA software tool suite. The latest version is available from CPAN and from https://www.veripool.org/.

Copyright 2010-2024 by Wilson Snyder. This package is free software; you can redistribute it and/or modify it under the terms of either the GNU Lesser General Public License Version 3 or the Perl Artistic License Version 2.0.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

AUTHORS

Wilson Snyder <wsnyder@wsnyder.org>

SEE ALSO

make