From: Lennart Poettering <lennart@poettering.net>
Date: Fri, 9 Mar 2018 21:44:47 +0000 (+0100)
Subject: copy: add brief comment to copy_bytes() explaining its return values
X-Git-Tag: v239~416^2~6
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=78ba8cf77037b93df499a72ef4f888112573a15c;p=thirdparty%2Fsystemd.git

copy: add brief comment to copy_bytes() explaining its return values
---

diff --git a/src/basic/copy.c b/src/basic/copy.c
index b64966c7d1e..de71132f8dd 100644
--- a/src/basic/copy.c
+++ b/src/basic/copy.c
@@ -65,6 +65,10 @@ int copy_bytes(int fdf, int fdt, uint64_t max_bytes, CopyFlags copy_flags) {
         assert(fdf >= 0);
         assert(fdt >= 0);
 
+        /* Tries to copy bytes from the file descriptor 'fdf' to 'fdt' in the smartest possible way. Copies a maximum
+         * of 'max_bytes', which may be specified as UINT64_MAX, in which no maximum is applied. Returns negative on
+         * error, zero if EOF is hit before the bytes limit is hit and positive otherwise. */
+
         /* Try btrfs reflinks first. */
         if ((copy_flags & COPY_REFLINK) &&
             max_bytes == (uint64_t) -1 &&