lcache_repair - repair a open-lmake cache
lcache_repair [-n|--dry-run] [-f|--force] dir
lcache_repair is meant to repair a cache. Its argument specifies the dir to repair.
This may be usedful because you experience incoherent behaviors and this is less agressive than setting up a fresh dir.
Also, if for some management reason you want to dismiss some entries, you can remove any part of the cache and run this command to restore a coherent state. The structure of the cache dir is fairly simple: all the data linked to a job is under a dir named after the job name.
When running, lcache_repair first prints what it is about to do before actually proceeding with the actions.
lcache_repair exits with a status of zero if the cache was successfully repaired. Else it exits with a non-zero status:
|
2 |
internal error, should not occur | ||
|
7 |
adequate permissions were missing, typically write access | ||
|
10 |
some syscall failed | ||
|
11 |
bad usage : command line options and arguments coul not be parsed | ||
|
12 |
bad cache version, cache needs to be cleaned |
-n, --dry-run
Report actions to carry out but do not actually perform them.
-f, --force
Dont ask for user confirmation before performing the actions.
lcache_repair manages a fully coherent dir called a repo. When it starts, it first determines the root of the repo (cf. FILES below).
Arguments and reports are systematically localized to the current working dir. For example, if you launch lcache_repair b from dir a in your repo, the argument is file a/b from the root of the repo and reports containing filenames (initially seen from the root of the repo) will be shown relative the the current working dir.
lcache_repair /path/to/cache
The files Lmakefile.py or Lmakefile/__init__.py are searched in the current dir and in parent dirs. If a single one is found, this determines the root of the repo. If several are found, the existence of an LMAKE dir is checked. If a single one is found, this determines the root of the repo. In other cases, lcache_repair will not start.
lautodep(1), lcache_server(1), lcheck_deps(1), lcodec_repair(1), lcollect(1), ldebug(1), ldecode(1), ldepend(1), lencode(1), lforget(1), lmake(1), lmark(1), lmake_repair(1), lmake_server(1), lrun_cc(1), lshow(1), ltarget(1), xxhsum(1)
The python module lmake.
The full open-lmake documentation in <open-lmake-installation-dir>/docs/index.html.
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/.