'\" t
.\"     Title: copyfilerange
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: User Commands
.\"    Source: util-linux 2.42.3
.\"  Language: Persian
.\"
.TH "COPYFILERANGE" "1" "2026-09-02" "util\-linux 2.42.3" "دستورهای کاربری"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
copyfilerange \- کپی برشی از یک فایل به فایل دیگر با استفاده از فراخوان copy_file_range
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBcopyfilerange\fP [options] \fIsource\fP \fIdestination\fP \fIrange\fP.\|.\|.
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBcopyfilerange\fP محدوده‌های بایتی را از پرونده مبدأ به پرونده مقصد کپی می‌کند.
این دستور یک پوسته برای فراخوان سیستمی \fBcopy_file_range\fP(2) است.
.sp
این دستور می‌تواند برای ایجاد پرونده‌هایی با شکاف‌های تخصیص‌نیافته (پرونده‌های پراکنده یا sparse)
و/یا با بلوک‌های اشتراکی میان چندین پرونده (reflinks) استفاده شود.
.sp
هر \fIrange\fP به صورت \fIsource_offset\fP\fB:\fP\fIdestination_offset\fP\fB:\fP\fIlength\fP است،
که تمامی مقادیر بر حسب بایت می‌باشند. اگر \fIlength\fP برابر 0 باشد، تا جایی که داده در دسترس باشد
کپی می‌شود. می‌توان چندین محدوده را مشخص کرد.
.sp
هنگامی که یک یا هر دو آفست حذف شوند، عملیات از آخرین مکان استفاده‌شده در پرونده، با شروع از 0، استفاده می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-r\fP, \fB\-\-ranges\fP \fIfile\fP
.RS 4
محدوده(ها)ی جداشده با خط جدید را از این \fIfile\fP می‌خواند.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
خروجی پرگو از محدوده‌های کپی‌شده.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.sp
\fB0\fP
.RS 4
موفقیت
.RE
.sp
\fB1\fP
.RS 4
شکست نامشخص
.RE
.SH "نکات (NOTES)"
.sp
فراخوان سیستمی \fBcopy_file_range\fP(2) نکات مهمی دارد: پرونده‌های مبدأ و مقصد باید از نوع سیستم پرونده یکسانی استفاده کنند، و برخی از سیستم پرونده‌های مجازی (مانند procfs) کار نخواهند کرد. \fBcopy_file_range\fP(2) در صورت پشتیبانی سیستم پرونده از reflinkها استفاده خواهد کرد. برای استفاده از reflinkها، در اغلب موارد محدوده پرونده باید با اندازه بلوک سیستم پرونده در هر دو پرونده مبدأ و مقصد هم‌تراز باشد.
.SH "نویسندگان (AUTHORS)"
.sp
.MTO "dick\(atmrns.nl" "Dick Marinus" ""
.SH "مثال‌ها (EXAMPLES)"
.sp
.if n .RS 4
.nf
.fam C
copyfilerange original\-file reflink ::

copyfilerange original\-file first\-block ::4096

copyfilerange original\-file even\-blocks \-r <(seq 0 8192 40960|awk \*(Aq{print $1"::4096"}\*(Aq)

copyfilerange original\-file sparse\-file 0:1M:1

copyfilerange original\-file split\-first\-mb ::1M

copyfilerange original\-file split\-remainder 1M::

copyfilerange split\-first\-mb join ::

copyfilerange split\-remainder join :1M:
.fam
.fi
.if n .RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBcopy_file_range\fP(2)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "ردیاب مشکلات" "."
.SH "دسترسی (AVAILABILITY)"
.sp
دستور \fBcopyfilerange\fP بخشی از بسته util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."