FreeBSD Manual Pages
REDO(1) redo package REDO(1) NAME redo -- rebuild utility SYNOPSIS redo [--silent] [--debug] [--keep-going] [--verbose] [--jobs number] [--di- rectory dirname] {filenames...} DESCRIPTION redo unconditionally attempts to rebuild the list of targets given as file- names. It does this by executing a "do" program, that is expected both to build each target, and at the same time record what dependencies should cause the target to be rebuilt if given as a target to redo-ifchange. "do" programs can invoke redo-ifchange, which may recursively cause depen- dencies to have their "do" programs invoked. PARALLEL PROCESSING redo uses the same jobserver mechanism as used by the GNU and BSD make pro- grams, whereby multiple parts of a build can run in parallel. If the --jobs command-line option is used, and if there is not already a jobserver set up by a parent process, it sets up a jobserver pipe with number job slots. It then attempts to execute as many "do" programs in parallel as it can procure job slots for. The distribution of jobs, down the build tree, is thus determined by whether "do" programs recursively invoke redo-ifchange with one dependency or many. If there is a jobserver already set up, redo assumes that a job slot has already been procured for it, given that it is running. Similarly, if there is no jobserver and it is not told to set up a jobserver, it acts as if there is a single, implicit, slot; behaving largely as if there were a 1-slot jobserver. It re-uses this implicit slot for the first "do" program that it spawns, only procuring slots for additional parallel child processes. Thus if no additional slots are actually available, it devolves from the parallel down to the serial case. Importantly, it does not release its own implicit job slot back to the jobserver, and never devolves beyond the serial case to not being able to run jobs at all. OPTIONS The --directory command-line option causes redo to change directory to dirname before doing anything. The --keep-going command-line option causes it to attempt to build all targets, even if building one of them fails. The --verbose command-line option causes it to print more information about its processing. The --debug command-line option causes it to print debug- ging information about its internal operation. And the --silent com- mand-line option causes it to print less information about its processing. FINDING "do" PROGRAMS redo has a two factor search for "do" programs. Firstly, it searches for "do" programs in a succession of directories, starting with the directory of the target and (if it does not have an ab- solute pathname) then checking each successively shorter path prefix until it ends with the current working directory. So if the target is a/b/c/d/e, it will check a/b/c/d/, then a/b/c/, then a/b/, then a/, and then finally . the current directory. For a target /a/b/c/d/e, on the other hand, it will only check /a/b/c/d/. Secondly, within each directory it searches for the "do" program by looking for successively shorter extension suffixes taken from the target. To these it prepends the word default and the suffix .do. It also, before do- ing that, checks for the full target filename with .do appended. So if the target is dir/base.a.b, it will look for dir/base.a.b.do, dir/de- fault.a.b.do, dir/default.b.do, dir/default.do, base.a.b.do, de- fault.a.b.do, default.b.do, and default.do. RUNNING "do" PROGRAMS A "do" program can be any kind of executable, although conventionally it is a script. (redo does not force a choice of shell, and the script must therefore begin with a "#!" line that names the shell that the script is written for.) redo invokes the program with a "REDOFLAGS" environment variable, which it uses to pass option and target information to recursively executed in- stances of redo (possibly invoked indirectly via redo-ifchange). "do" pro- grams should not alter, or inspect, the value of this variable. redo also invokes it with open file descriptors, indicating the jobserver pipe and where to record dependencies for the current target. "do" pro- grams should not close these file descriptors, and should not perform I/O on them other than with redo-ifchange and redo-ifcreate. It sets the "MAKELEVEL" environment variable, which is used in messages to indicate the recursion depth. It invokes the program with three arguments: * the directory prefix and base name of the target (e.g. dir/base.a) * the extension part of the target that matched the default file (e.g. .b) * the name of a temporary file where the target is to be built redo performs atomic builds of individual targets. A target is built to a temporary filename (in the same directory), and if and only if the "do" program exits with a success status is that temporary filename atomically renamed to the actual target. AUTHOR Jonathan de Boyne Pollard v1.0 2019-04-16 REDO(1)
NAME | SYNOPSIS | DESCRIPTION | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=redo&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>