LTARGET

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
NOTES
SEE ALSO
COPYRIGHT

NAME

ltarget - report targets from a open-lmake job

SYNOPSIS

ltarget [OPTION]... [FILE]...

DESCRIPTION

ltarget may be used to pass flags to open-lmake. Unless specified otherwise, passed targets are allowed to be written to.

Note that :

Flags can be passed in (cf OPTIONS below). Flags accumulate and will apply even if the file is independently accessed.

Targets are reported even if the autodep method (the autodep rule attribute) is none. This is the way (or a call to lmake.target) of reporting targets in such a case (usually with --write).

Symlobic links are not followed when files are interpreted. Following symbolic links would inevitably lead to files being read (to check if they are symbolic links) before being a target, which would be an error.

OPTIONS

-W, --write

Report an actual write, not only target flags. Default is to only alter flags.

-X, --regexpr

Pass flags to all targets matching regexprs passed as argument. The ignore flag only applies to targets following this command.

-x, --no-exclude-star

Accept that flags are further processed according to regexpr-based requests, e.g. ltarget --regexpr, default is to exclude such processing.

-E, --essential

Show when generating user oriented graphs.

-i, --incremental

Targets are not unlinked before job execution and read accesses to them are ignored (including readdir(3)).

-w, --no-warning

No warning is emitted if targets are either uniquified or unlinked while generated by another job.

-I, --ignore

From now on, ignore all reads and writes to targets (including readdir(3)).

-a, --no-allow

Unless this option is passed, ltarget makes its arguments valid targets (cf @pxref{targets-deps}).

-s, --source-ok

Unless this option is passed, writing to a source is an error. In that case, being simultaneously a dep and a target is ok.

In case mentioned targets turn out to be deps, the dep flags are also available:
-c
, --critical

Create critical deps (cf. note (5)).

-D, --readdir-ok

Allow readdir(3) on passed deps even if not ignored nor incremental. Implies flag --no-required.

-e, --ignore-error

Ignore the error status of the passed deps.

-r, --no-required

Accept that deps be not buildable, as for a normal read access (in such a case, the read may fail, but open-lmake is ok).

NOTES

SEE ALSO

lautodep(1), lcheck_deps(1), ldebug(1), ldecode(1), ldepend(1), ldircache_repair(1), lencode(1), lforget(1), lmake(1), lmark(1), lrepair(1), lrun_cc(1), lshow(1), xxhsum(1)

The python module lmake.

The full open-lmake documentation in <open-lmake-installation-dir>/docs/index.html.

COPYRIGHT

Copyright © 2023-2025, Doliam. This file is part of open-lmake.

open-lmake is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3 of the License.

open-lmake 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.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.