COPYFILERANGE(1) Polecenia użytkownika COPYFILERANGE(1)

copyfilerange - kopiuje zakres(y) z pliku źródłowego do docelowego

copyfilerange [opcje] źródło cel zakres...

Polecenie copyfilerange kopiuje przedział bajtów ze źródła do celu. Jest to opakowanie wywołania systemowego copy_file_range(2).

Polecenie można wykorzystać do tworzenia plików z nieprzydzielonymi dziurami (pliki rzadkie) i/lub blokami dzielonymi między wieloma plikami (reflinki).

Każdy zakres ma postać przesunięcie-źródła:przesunięcie-celu:długość, wszystkie wartości podane w bajtach. Jeśli długość wynosi 0, to kopiowane jest tyle danych, ile jest dostępne. Można podać wiele zakresów.

Gdy pominie się jedno lub oba przesunięcia, operacja użyje ostatnio użytego położenia pliku, zaczynając od 0.

-r, --ranges plik

Odczytuje zakres(y), rozdzielone znakami nowego wiersza, z tego pliku.

-v, --verbose

Szczegółowe wyjście dotyczące kopiowanych zakresów.

-h, --help

Wyświetla ten tekst i wychodzi.

-V, --version

Wyświetla wersję i wychodzi.

0

sukces

1

nieokreślony błąd

Wywołania systemowego copy_file_range(2) tyczą się pewne istotne zastrzeżenia: plik źródłowy i docelowy muszą korzystać z tego samego typu systemu plików, a niektóre wirtualne systemy plików (jak procfs) nie zadziałają. copy_file_range(2) użyje reflinków, jeśli system plików je obsługuje. Korzystanie z reflinków wymaga zwykle, aby zakres pliku był wyrównany do rozmiaru bloku systemu plików; dotyczy to pliku źródłowego i docelowego.

Dick Marinus <dick@mrns.nl>

copyfilerange plik-pierwotny reflink ::
copyfilerange plik-pierwotny pierwszy-blok ::4096
copyfilerange plik-pierwotny bloki-parzyste -r <(seq 0 8192 40960|awk '{print $1"::4096"}')
copyfilerange plik-pierwotny plik-rzadki 0:1M:1
copyfilerange plik-pierwotny wydzielony-pierwszy-mb ::1M
copyfilerange plik-pierwotny wydzielona-reszta 1M::
copyfilerange wydzielony-pierwszy-mb złączenie ::
copyfilerange split-remainder join :1M:

copy_file_range(2)

Problemy należy zgłaszać w systemie śledzenia błędów https://github.com/util-linux/util-linux/issues.

Polecenie copyfilerange jest częścią pakietu util-linux, który można pobrać ze strony Archiwum jądra Linux https://www.kernel.org/pub/linux/utils/util-linux/.

2026-09-02 util-linux 2.42.3