-
Notifications
You must be signed in to change notification settings - Fork 7
copy_file_range(2)
copy_file_range - 한 파일에서 다른 파일로 데이터 구간 복사하기
#include _GNU_SOURCE
#include <unistd.h>
ssize_t copy_file_range(int fd_in, loff_t *off_in,
int fd_out, loff_t *off_out,
size_t len, unsigned int flags);copy_file_range() 시스템 호출은 커널에서 사용자 공간으로 데이터를 보내고 받는 추가 비용 없이 커널 내에서 두 파일 디스크립터 간에 복사를 수행한다. 파일 디스크립터 fd_in에서 파일 디스크립터 fd_out으로 최대 len 바이트까지 데이터를 복사하며, 대상 파일에서 요청 범위 내에 데이터가 존재하면 덮어 쓴다.
off_in에 다음 의미론이 적용되며, 비슷한 내용이 off_out에도 적용된다.
-
off_in이 NULL이면 파일 오프셋부터 시작해서fd_in에서 바이트를 읽어 들이며, 복사한 바이트 수만큼 파일 오프셋을 조정한다. -
off_in이 NULL이 아니면off_in은fd_in에서 바이트를 읽어 들이기 시작할 오프셋을 나타내는 버퍼를 가리켜야 한다.fd_in의 파일 오프셋을 바꾸지 않으며, 대신off_in을 적절히 조정한다.
flags 인자는 향후 확장을 위한 것이며 현재는 0이어야 한다.
성공 완료 시 copy_file_range()는 파일들 사이에서 복사한 바이트 수를 반환한다. 원래 요청한 길이보다 적을 수도 있다.
오류 시 copy_file_range()는 -1을 반환하며 오류를 나타내도록 errno를 설정한다.
EBADF- 한 개 이상의 파일 디스크립터가 유효하지 않다. 또는
fd_in이 읽기 가능하게 열려 있지 않다. 또는fd_out이 쓰기 가능하게 열려 있지 않다. 또는fd_out이 가리키는 열린 파일 기술 항목(open(2) 참고)에O_APPEND플래그가 설정되어 있다. EFBIG- 구현에서 정의하는 파일 최대 크기나 프로세스의 파일 크기 제한을 초과하도록 파일 쓰기 시도가 이뤄졌거나, 가능한 최대 오프셋을 넘는 위치에서 쓰기 시도가 이뤄졌다.
EINVAL- 요청 범위가 출발 파일의 끝을 벗어난다. 또는
flags인자가 0이 아니다. EIO- 복사 중에 저수준 I/O 오류가 발생했다.
EISDIR-
fd_in이나fd_out이 디렉터리를 가리키고 있다. ENOMEM- 메모리 부족.
ENOSPC- 대상 파일 시스템에 복사를 완료하기 위한 충분한 공간이 없다.
EXDEV-
file_in과file_out이 가리키는 파일이 같은 파일 시스템 상에 있지 않다.
리눅스 4.5에서 copy_file_range() 시스템 호출이 처음 등장했다. glibc 2.27에서는 사용 가능하지 않은 경우 사용자 공간 에뮬레이션을 제공한다.
copy_file_range() 시스템 호출은 비표준 리눅스 및 GNU 확장이다.
file_in이 희소 파일이면 요청 범위 내에 존재하는 구멍을 copy_file_range()가 채워 버릴 수 있다. 루프 안에서 copy_file_range()를 호출하면서 lseek(2) SEEK_DATA 및 SEEK_HOLE 동작으로 데이터 세그먼트의 위치를 알아내는 방식이 좋을 수 있다.
copy_file_range()는 파일 시스템에서 reflink(즉 여러 아이노드가 동일 copy-on-write 디스크 블록에 대한 포인터 공유)나 서버 측 복사(NFS인 경우) 사용 같은 "복사 가속" 기법을 적용할 기회를 준다.
#define _GNU_SOURCE
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
#include <sys/stat.h>
#include <sys/syscall.h>
#include <unistd.h>
/* glibc 2.27 전 버전에서는 syscall(2)로 copy_file_range()를
호출해야 한다. */
static loff_t
copy_file_range(int fd_in, loff_t *off_in, int fd_out,
loff_t *off_out, size_t len, unsigned int flags)
{
return syscall(__NR_copy_file_range, fd_in, off_in, fd_out,
off_out, len, flags);
}
int
main(int argc, char **argv)
{
int fd_in, fd_out;
struct stat stat;
loff_t len, ret;
if (argc != 3) {
fprintf(stderr, "Usage: %s <source> <destination>\n", argv[0]);
exit(EXIT_FAILURE);
}
fd_in = open(argv[1], O_RDONLY);
if (fd_in == -1) {
perror("open (argv[1])");
exit(EXIT_FAILURE);
}
if (fstat(fd_in, &stat) == -1) {
perror("fstat");
exit(EXIT_FAILURE);
}
len = stat.st_size;
fd_out = open(argv[2], O_CREAT | O_WRONLY | O_TRUNC, 0644);
if (fd_out == -1) {
perror("open (argv[2])");
exit(EXIT_FAILURE);
}
do {
ret = copy_file_range(fd_in, NULL, fd_out, NULL, len, 0);
if (ret == -1) {
perror("copy_file_range");
exit(EXIT_FAILURE);
}
len -= ret;
} while (len > 0);
close(fd_in);
close(fd_out);
exit(EXIT_SUCCESS);
}lseek(2), sendfile(2), splice(2)
2019-03-06