annotate src/lib/file-copy.h @ 23007:36e01285b5b8

lib: buffer - Improve header comment for buffer_insert() and buffer_delete().
author Stephan Bosch <stephan.bosch@dovecot.fi>
date Mon, 18 Mar 2019 00:52:37 +0100
parents e4eb71ae8e96
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6410
e4eb71ae8e96 Changed .h ifdef/defines to use <NAME>_H format.
Timo Sirainen <tss@iki.fi>
parents: 4406
diff changeset
1 #ifndef FILE_COPY_H
e4eb71ae8e96 Changed .h ifdef/defines to use <NAME>_H format.
Timo Sirainen <tss@iki.fi>
parents: 4406
diff changeset
2 #define FILE_COPY_H
4406
18c7c5215b53 Added file_copy().
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
3
18c7c5215b53 Added file_copy().
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
4 /* Copy file atomically. First try hardlinking, then fallback to creating
18c7c5215b53 Added file_copy().
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
5 a temporary file (destpath.tmp) and rename()ing it over srcpath.
18c7c5215b53 Added file_copy().
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
6 If the destination file already exists, it may or may not be overwritten,
18c7c5215b53 Added file_copy().
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
7 so that shouldn't be relied on.
18c7c5215b53 Added file_copy().
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
8
18c7c5215b53 Added file_copy().
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
9 Returns -1 = error, 0 = source file not found, 1 = ok */
18c7c5215b53 Added file_copy().
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
10 int file_copy(const char *srcpath, const char *destpath, bool try_hardlink);
18c7c5215b53 Added file_copy().
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
11
18c7c5215b53 Added file_copy().
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
12 #endif