File: partial-transfer.md

package info (click to toggle)
rsbackup 10.0-4
  • links: PTS
  • area: main
  • in suites: forky, sid
  • size: 1,908 kB
  • sloc: cpp: 10,859; sh: 2,566; makefile: 387; perl: 11
file content (45 lines) | stat: -rw-r--r-- 1,436 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
Partial Transfer
================

What is the ‘partial transfer’ warning about?

It corresponds to an error status of 24 from `rsync`, which documents
it as ‘Partial transfer due to vanished source files’.

Within `rsync`, this is:

    #define RERR_VANISHED   24      /* file(s) vanished on sender side */

...and:

    { RERR_VANISHED   , "some files vanished before they could be transferred" },

...and:

    /* VANISHED is not an error, only a warning */
    if (code == RERR_VANISHED) {
        rprintf(FWARNING, "rsync warning: %s (code %d) at %s(%d) [%s=%s]\n",
            name, code, file, line, who_am_i(), RSYNC_VERSION);
    } else {
        rprintf(FERROR, "rsync error: %s (code %d) at %s(%d) [%s=%s]\n",
            name, code, file, line, who_am_i(), RSYNC_VERSION);
    }

It is set during cleanup:

    if (exit_code == 0) {
        if (code)
            exit_code = code;
        if (io_error & IOERR_DEL_LIMIT)
            exit_code = RERR_DEL_LIMIT;
        if (io_error & IOERR_VANISHED)
            exit_code = RERR_VANISHED;
        if (io_error & IOERR_GENERAL || got_xfer_error)
            exit_code = RERR_PARTIAL;
    }

`IOERR_VANISHED` is set in three places. The general idea seems to be
that the file (or link or whatever) formerly existed (e.g. in a
directory listing) but has now gone away. So this reflects either a
backup target changing ‘underfoot’, or strange filesystem semantics.