From 7bda5f470c54d29b4d49b48ea5a15d025761efa6 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Mon, 10 Mar 2025 14:15:07 -0400 Subject: [PATCH] document output files must be regular files --- doc/design/compute_special_remote_interface.mdwn | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/doc/design/compute_special_remote_interface.mdwn b/doc/design/compute_special_remote_interface.mdwn index e6fad0f2b1..0ab7c45df4 100644 --- a/doc/design/compute_special_remote_interface.mdwn +++ b/doc/design/compute_special_remote_interface.mdwn @@ -65,8 +65,11 @@ dashed options. If there is a path traversal attack, the program's stdin will be closed without a path being written to it. The filename of the output file is both the filename in the program's -temporary directory, and also the filename that will be added to the -git-annex repository by `git-annex compute`. +temporary directory that it should write to, and also the filename that will +be added to the git-annex repository by `git-annex compute`. + +The program must write a regular file to the output file. Symlinks +or other special files will not be accepted as output files. If git-annex sees that an output file is growing, it will use its file size when displaying progress to the user. So if possible, the program should