From 53b478d5bb01ed55eec610c5bc7c0984911e72b7 Mon Sep 17 00:00:00 2001 From: Paul Cristian Sarbu Date: Wed, 12 Feb 2025 13:14:55 +0100 Subject: just(1): Document add-to-cas --resolve-special option --- share/man/just.1.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/share/man/just.1.md b/share/man/just.1.md index 6c5927f0..de59455f 100644 --- a/share/man/just.1.md +++ b/share/man/just.1.md @@ -756,6 +756,20 @@ Resolve the positional argument to not be a symbolic link by following symbolic links. The default is to add the link itself, i.e., the string obtained by **`readlink`**(2), as blob. +**`--resolve-special`** *`TEXT`* +When adding a directory to CAS, resolve any special filesystem entries based on +the strategy denoted by the string value specified. Special entries are all +those which are neither file, executables, or directories. If option is missing +or a non-supported value is provided, the default behavior is used, in which +only non-upwards symlinks are accepted and stored unresolved. +Currently accepted values: + - *`"ignore"`*: all special entries are ignored + - *`"tree-upwards"`*: accept only symlinks with a target path pointing inside + the location directory and resolve the ones that are upwards + - *`"tree-all"`*: accept only symlinks with a target path pointing inside the + location directory and resolve all of them + - *`"all"`*: unconditionally accept and resolve all symlinks + **`traverse`** specific options ------------------------------- -- cgit v1.2.3