Scroll to navigation

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

NAZWA

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

SKŁADNIA

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

OPIS

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.

OPCJE

-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.

STATUS ZAKOŃCZENIA

0

sukces

1

nieokreślony błąd

UWAGI

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.

AUTORZY

Dick Marinus <dick@mrns.nl>

PRZYKŁADY

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:

ZOBACZ TAKŻE

copy_file_range(2)

ZGŁASZANIE BŁĘDÓW

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

DOSTĘPNOŚĆ

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-25 util-linux 2.42.4